SmilyOrg/photofield

어떤 프로젝트인가요?

핵심 기능

• 01점진적 다중 해상도 로딩을 지원하는 확대·축소 가능 인터페이스
• 02타임라인 보기를 포함한 다양한 레이아웃
• 03photofield-ai를 통한 선택적 시맨틱 검색, 얼굴 감지, 태그 지정
• 04원본 파일을 읽기 전용으로 다루며 수정하지 않음
• 05빠른 파일 인덱싱 후 EXIF와 주요 색상 추출
• 06단일 바이너리 또는 Docker 이미지로 배포 가능

활용 사례

• NAS나 홈 서버에 저장된 대규모 개인 사진 라이브러리 둘러보기
• 기존 사진 디렉터리를 다른 도구와 함께 읽기 전용 갤러리로 제공하기
• 한 가정에서 사용할 셀프 호스팅 대안으로 클라우드 타임라인 보기 교체하기

빠른 시작

1. 1

   사진을 읽기 전용으로 마운트한 상태에서 Docker 컨테이너를 실행하세요

   docker run -p 8080:8080 -v "$PWD/data:/app/data" -v "$PWD/photos:/app/photos:ro" ghcr.io/smilyorg/photofield
2. 2

   브라우저에서 http://localhost:8080을 열어 사진 컬렉션을 확인하세요

사용 전 알아둘 점

• !동시에 많은 클라이언트가 이용하도록 최적화되어 있지 않습니다. 상태가 서버에 저장되므로 사용자가 몇 명을 넘으면 CPU와 메모리에 부담이 될 수 있습니다.
• !사용자 계정, 인증 또는 권한 부여를 지원하지 않습니다.
• !CPU 성능이 낮거나 디스크 캐시가 비어 있으면 컬렉션의 초기 레이아웃을 만드는 데 시간이 걸릴 수 있습니다.
• !태그 지정과 얼굴 감지는 아직 알파 단계입니다.

포함된 컬렉션

토픽

자주 묻는 질문

photofield은(는) 무엇인가요?

원본 파일을 건드리지 않으면서 한 번에 많은 사진을 보여주는 Go와 Vue 기반 셀프 호스팅 단일 바이너리 사진 갤러리입니다. Photofield는 화면에 가능한 한 많은 사진을 한꺼번에 빠르게 보여주도록 만든 사진 뷰어입니다. 단일 정적 Go 바이너리 또는 Docker 이미지로 실행되며, 파일 시스템을 단일 정보 원천으로 삼습니다. 원본 파일은 수정하지 않고, 썸네일과 메타데이터는 SQLite 캐시에 저장합니다. 디렉터리에서 컬렉션을 만들 수 있으며, Google Photos와 비슷한 선택형 타임라인 레이아웃도 제공합니다.

photofield은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

photofield은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

photofield은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. photofield의 마지막 커밋은 2026년 10월 12일입니다.

photofield은(는) 어디에 사용할 수 있나요?

NAS나 홈 서버에 저장된 대규모 개인 사진 라이브러리 둘러보기 기존 사진 디렉터리를 다른 도구와 함께 읽기 전용 갤러리로 제공하기 한 가정에서 사용할 셀프 호스팅 대안으로 클라우드 타임라인 보기 교체하기

photofield는 어떻게 설치하나요?

사진을 읽기 전용으로 마운트한 상태에서 Docker 컨테이너를 실행하세요: docker run -p 8080:8080 -v "$PWD/data:/app/data" -v "$PWD/photos:/app/photos:ro" ghcr.io/smilyorg/photofield 브라우저에서 http://localhost:8080을 열어 사진 컬렉션을 확인하세요

photofield은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/SmilyOrg/photofield