Photoview란?
Photoview는 사진가를 위해 만든 셀프 호스팅 웹 갤러리로, 스캐너가 서버의 폴더를 읽어 디렉터리를 앨범으로 바꿉니다. 프로젝트는 스스로를 "셀프 호스팅 개인 서버를 위한 사진 갤러리"라고 소개하며, 코드는 AGPL-3.0으로 GitHub에 공개되어 있습니다.
각 사용자는 서버의 경로와 함께 만들어지며, 그 아래에 있는 미디어만 볼 수 있습니다. README에는 공개 데모 사이트 링크가 있습니다.
입수 방법
Photoview는 직접 설치하는 서버이며, 문서화된 방법은 Docker Compose입니다. 데스크톱용이나 휴대전화용 설치 프로그램은 없습니다.
옵션 | 입수 방법 |
|---|---|
| Docker Compose | Compose 예시: .env, compose 파일, Makefile을 복사해 수정한 뒤 make all을 실행합니다 |
| 기타 플랫폼 | README에는 Arch Linux AUR, NixOS, Unraid, YunoHost, TrueNAS, EmbassyOS가 나와 있으며 프로젝트의 지원은 제한적입니다 |
| 가격 | 무료, AGPL-3.0, 셀프 호스팅 |
| 웹사이트 | photoview.github.io |
| 개인정보 처리방침 | 웹사이트와 README에서 개인정보 처리방침 페이지를 찾지 못했습니다 |
| 소스 코드 | github.com/photoview/photoview |
| 공개 데모 | photos.qpqp.dk (로그인 정보는 README에 있음) |
확인한 버전: 2024년 6월 23일에 공개된 릴리스 2.4.0이며, 태그가 붙은 가장 최근 릴리스입니다. GitHub에는 내려받을 파일이 나와 있지 않습니다. master 브랜치에는 2026년 10월 29일까지 커밋이 있었고, Docker Hub의 latest와 2.4.0 태그도 그날 마지막으로 푸시되었습니다. 터미널과 Docker가 필요합니다.
요구 사항
README에는 RAM이나 CPU 최소 사양이 없으며, 지원 플랫폼과 데이터베이스, Docker 버전 범위만 나와 있습니다.
실행 환경
- 출처의 설명:
- 최근 1년 이내에 출시된 Docker Engine, Debian 12 또는 13, Ubuntu LTS 및 최신 단기 지원 릴리스
데이터베이스
- 출처의 설명:
- SQLite, MariaDB 또는 PostgreSQL 17, 18
미디어 처리
- 출처의 설명:
- RAW 처리와 동영상 처리는 환경 설정으로 각각 끌 수 있습니다
동영상 가속
- 출처의 설명:
- 선택 사항으로 qsv, vaapi, nvenc가 있으며, 프로젝트가 검증한 것은 Intel 칩의 qsv뿐입니다
README에 나와 있는 내용이며, PromptQuorum은 메모리, CPU, 인덱싱 시간을 측정하지 않았습니다.
시작하는 방법
아래 단계는 README의 Docker 가이드를 따른 것이며, PromptQuorum이 직접 실행해 보지는 않았습니다.
- 1Docker 설치
Why it matters: 사진이 있는 서버에 Docker와 Docker Compose를 설치합니다. - 2예시 파일 복사
Why it matters: Compose 예시 폴더의 파일을 내려받아 .env, docker-compose.yml, Makefile로 이름을 바꾸고, 경로와 데이터베이스에 맞게 수정합니다. - 3미디어를 읽을 수 있게 하고 시작
Why it matters: 컨테이너가 미디어 폴더를 읽을 수 있도록 make readable을 실행한 뒤 make all을 실행합니다. - 4관리자 생성 및 스캔
Why it matters: 8000번 포트를 열고, 설정 마법사에서 사용자 이름, 비밀번호, 사진 경로(기본값 /photos)를 입력한 다음 설정의 Scan All을 사용합니다.
주요 기능
아래 항목은 모두 프로젝트의 웹사이트 또는 README에서 가져온 것이며, PromptQuorum은 어느 것도 테스트하지 않았습니다.
- 공유. 앨범과 개별 미디어를 공개 링크로 공유할 수 있으며, 비밀번호 보호도 선택할 수 있습니다.
- 지도. EXIF 데이터에 GPS 좌표가 있는 사진은 지도에 표시할 수 있으며, 예시 설정에 따르면 직접 발급하는 무료 Mapbox 액세스 토큰이 필요합니다.
- 접근 제어. README에 따르면 미디어 파일은 쿠키 토큰으로 보호되고, 비밀번호는 해시 처리되며, API는 엄격한 CORS 정책을 사용합니다.
AI 기능과 실행 위치
프로젝트가 밝히는 AI 기능은 얼굴 인식뿐이며, go-face 라이브러리를 사용해 Photoview 서버 안에서 실행됩니다.
- 감지와 그룹화. README에 따르면 스캐너는 사진에서 얼굴을 찾아 같은 사람의 사진을 묶습니다. 코드는 dlib용 오픈소스 Go 래퍼인 go-face를 기반으로 합니다.
- 모델 파일. 얼굴 감지, 랜드마크, 인식을 위한 dlib 모델 파일 세 개가 저장소의 data/models 폴더에 있으며, 경로는 설정할 수 있습니다.
- 실행 위치. 얼굴 감지 코드는 로컬 라이브러리를 직접 호출하며, 읽어 본 파일에는 네트워크 요청이 없었습니다.
- 끄기. PHOTOVIEW_DISABLE_FACE_RECOGNITION을 1로 설정하면 이 기능을 건너뜁니다.
데이터 흐름과 개인정보
Photoview는 셀프 호스팅이므로, 사진을 공유하거나 지도를 켜지 않는 한 사진은 직접 운영하는 서버에 남습니다. README는 기본적인 사용자 인증만으로는 인터넷의 악의적인 공격자로부터 비공개 미디어를 보호하기에 충분하지 않다고 경고하며, 외부에 노출하기 전에 방화벽, VPN, 리버스 프록시 등의 보호 계층을 두라고 권합니다.
지도 화면은 사용자가 제공한 토큰으로 브라우저에서 Mapbox 라이브러리를 불러옵니다. Mapbox가 무엇을 받는지는 확인하지 못했습니다.
📌참고: 프로젝트 측의 설명이며 감사 결과가 아닙니다. PromptQuorum은 네트워크 트래픽을 검사하지 않았고, 이 글에서 언급한 파일 외의 코드는 검토하지 않았습니다.
이런 분께 적합합니다
- 집 서버에 RAW 라이브러리를 둔 사진가로, 파일을 옮기지 않고 폴더를 둘러보고 공유하려는 분.
- 가족 사진을 NAS에 보관하는 가정으로, 사용자마다 별도 폴더가 있는 갤러리 하나를 원하는 분.
- AI 검색과 라벨이 있는 플랫폼보다 폴더 기반 갤러리를 선호하는 셀프 호스팅 사용자.
확인하지 못한 사항
- 얼굴 인식 품질. 정확도, 그룹화 동작, 속도는 테스트하지 않았습니다.
- 릴리스와의 격차. 태그가 붙은 최신 릴리스는 2024년 6월 것이고 master는 그 뒤로 진행되었습니다. 2.4.0과 얼마나 다른지는 비교하지 않았으며, README는 다음 릴리스에서 PostgreSQL 18을 권장 버전으로 삼는다고 밝히고 있습니다.
- Mapbox로 가는 데이터. 지도 기능이 Mapbox에 무엇을 보내는지, 무료 토큰에 대한 Mapbox의 약관은 확인하지 못했습니다.
- 리소스 사용량. RAM이나 CPU 수치는 공개되어 있지 않으며, 실제 사용량은 측정하지 않았습니다.
- 휴대전화 사용 경험. 모바일 앱은 나와 있지 않으며, 브라우저 인터페이스가 휴대전화에서 어떻게 동작하는지는 테스트하지 않았습니다.
경쟁 제품과 대안
디렉터리에는 얼굴 인식을 갖춘 사진 라이브러리 도구가 세 가지 더 있으며, 그 밖에 무엇을 더하는지가 서로 다릅니다.
PhotoPrism
- 플랫폼:
- Linux, macOS, Windows(Docker), 웹
- 가격 / 라이선스:
- 무료 + 유료 / AGPL-3.0
- 핵심 차이점:
- AI 라벨과 검색을 추가하며 유료 멤버십이 있음
PhotoPrism 관련 문서 (1개)
- PhotoPrism Review: Self-Hosted AI Photo Library for Your Server업데이트 2026년 10월 24일
Immich
- 플랫폼:
- Linux 서버, iOS, Android, 웹
- 가격 / 라이선스:
- 무료 / AGPL-3.0
- 핵심 차이점:
- 휴대전화 백업 앱과 스마트 검색을 추가
Immich 관련 문서 (1개)
- Immich Review: Self-Hosted Photo Library with Smart Search업데이트 2026년 10월 26일
기타 언급:
- Facet Review: Local Photo Scoring, Culling and Gallery업데이트 2026년 10월 28일
Facet
- 플랫폼:
- Linux, macOS, Windows, 웹
- 가격 / 라이선스:
- 무료 / MIT
- 핵심 차이점:
- 사진 점수 매기기와 선별을 추가하며 기본 모델 가중치 일부는 상업적 이용 불가
Facet 관련 문서 (1개)
- Facet Review: Local Photo Scoring, Culling and Gallery업데이트 2026년 10월 28일
각 앱의 현재 가격, 라이선스, 플랫폼은 해당 앱의 공식 페이지에서 확인하십시오.
자주 묻는 질문
Photoview가 내 사진 파일을 변경하나요?
README는 이 갤러리를 미디어에 대한 읽기 전용 접근으로 설명하며, 생성된 썸네일은 PHOTOVIEW_MEDIA_CACHE로 지정하는 별도의 캐시 폴더에 저장됩니다.
어떤 데이터베이스를 써야 하나요?
SQLite는 추가 서비스가 필요 없지만 성능이 가장 낮고 확장이 되지 않습니다. README는 MariaDB를 기본 선택으로, PostgreSQL을 일반적으로 가장 빠른 선택으로 소개합니다.
Photoview는 어떻게 업데이트하나요?
새 이미지를 받아 컨테이너를 다시 시작합니다. README는 업그레이드 전에 데이터베이스를 백업하라고 안내하며, 이미지가 Docker Hub의 photoview/photoview 레지스트리로 옮겨졌으므로 오래된 compose 파일은 새 이미지 이름으로 바꿔야 한다고 알립니다.
도움은 어디서 받을 수 있나요?
README는 설치와 개발 관련 질문을 Discord 서버로 안내하며, 프로젝트는 Portainer 등 Docker Compose 위에 얹는 도구는 지원하지 않습니다.
결론
Photoview는 자기 서버의 폴더에 사진을 두고, 클라우드 서비스 없이 둘러보고 공유하며 얼굴별로 정리하려는 사람에게 맞는, 자리 잡은 공개 개발 갤러리입니다. 반면 태그가 붙은 최신 릴리스는 2024년 6월 것이고, 설치에는 Docker와 데이터베이스가 필요하며, AI 기능은 얼굴 인식뿐이고, 지도는 Mapbox 토큰에 의존하며, 이 중 어느 것도 이번에는 테스트하지 못했습니다. 이미 Docker를 운영하는 폴더 중심의 셀프 호스팅 사용자에게 적합하며, AI 검색이나 휴대전화 백업이 필요하다면 위의 대안을 비교해 보십시오.
출처
- Photoview 웹사이트 — 기능 개요, 2026년 10월 30일 확인.
- Photoview README — 기능, 플랫폼, 데이터베이스, 설치 및 보안 참고 사항, 2026년 10월 30일 확인.
- Photoview 릴리스 — 릴리스 2.4.0, 2024년 6월 23일 공개.
- Photoview 얼굴 감지 코드 — 인식 라이브러리와 환경 설정, 2026년 10월 30일 확인.
- Docker Hub의 Photoview — 이미지 태그, 2026년 10월 30일 확인.