Photoview
간결하고 사용하기 쉬운 셀프 호스팅 사진 갤러리로, 디렉터리를 자동으로 인덱싱하고 썸네일을 생성하며, RAW 형식과 EXIF를 지원하고 얼굴 인식 기능을 내장하고 있습니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
사진작가를 위해 특별히 제작된 셀프 호스팅 사진 앨범으로, 원클릭 Docker 배포를 통해 수만 장의 고화질 사진을 관리할 수 있습니다.
주요 기능
- 파일 시스템과 긴밀하게 연동: 디렉터리 구조가 웹 앨범으로 직접 매핑
- 사용자 관리: 각 사용자는 독립적인 미디어 경로를 바인딩 가능
- 공유 기능: 앨범 또는 개별 미디어를 링크로 공유 가능, 선택적 비밀번호 보호
- RAW 형식 및 EXIF 파싱 지원
- 비디오 지원: 일반적인 형식을 web 최적화 형식으로 자동 트랜스코딩
할 수 없는 것
- •참고: Docker 이미지 레지스트리가 new registry로 마이그레이션되었으므로, 기존 compose 파일의 이미지 주소를 업데이트해야 합니다. PostgreSQL 버전이 master 브랜치에서 18로 전환되었으므로, 업그레이드 전에 반드시 데이터베이스를 백업하세요. Portainer와 같은 래퍼 계층은 지원되지 않습니다. 문제가 발생하면 네이티브 Docker Compose 환경에서 재현해 주세요.
사용 사례
- 사진작가가 자신의 고해상도 포트폴리오를 한곳에서 관리하고 선보이는 경우
- 가정 사용자가 프라이빗 클라우드 사진 앨범을 직접 구축하여 Google Photos를 대체하는 경우
- 미디어 애호가가 폴더 구조에 따라 대량의 사진과 동영상을 정리하고 공유하는 경우
상세 설명
Photoview는 사진작가를 위해 만들어진, 간결하고 사용하기 쉬운 인터페이스를 갖춘 셀프 호스팅 사진 및 동영상 앨범입니다. 파일 시스템에서 지정된 디렉터리를 스캔하고, 폴더 구조를 기반으로 콘텐츠를 웹페이지에 표시합니다. 주요 특징으로는 RAW 형식(CR2, NEF, ARW 등) 및 EXIF 메타데이터 추출 지원, 자동 썸네일 생성으로 매우 빠른 탐색, 비디오 트랜스코딩 후 브라우저에서 바로 재생 가능, 내장 얼굴 인식 기능으로 동일 인물의 사진을 자동으로 분류하는 기능 등이 있습니다. 사용자 관리 측면에서는 각 사용자가 서로 다른 미디어 디렉터리를 연결할 수 있으며, 앨범 전체 또는 개별 사진을 외부에 공유할 수 있고 비밀번호 보호를 지원합니다. Photoview는 Docker, Debian/Ubuntu, Arch Linux, NixOS, Unraid, YunoHost, TrueNAS 등 다양한 방식으로 배포할 수 있으며, 데이터베이스는 SQLite, MariaDB, PostgreSQL 중에서 선택할 수 있습니다. 이 프로젝트는 활발하게 유지 관리되고 있으며, Discord 커뮤니티의 응답도 빠릅니다.
문제 해결 & FAQ (2)
문제 해결Photoview에 CR3 파일을 추가할 때 'unsupported media type' 오류를 해결하는 방법
Photoview는 현재 CR3 파일을 표시하지 않습니다. 해결 방법으로 exiftool을 사용하여 포함된 전체 크기 JPEG를 추출하십시오: exiftool -b -JpgFromRaw IMAGE.CR3 > IMAGE.JPG. 그런 다음 결과 JPG를 라이브러리에 추가하십시오. 향후 업데이트에서 이 추출 과정을 기본적으로 자동화할 예정입니다.
문제 해결Photoview에서 관리자가 아닌 사용자에게 Albums 페이지가 비어 있는 문제를 어떻게 해결하나요?
이것은 Photoview 2.4.0의 알려진 권한 버그입니다: 관리자가 아닌 사용자는 Timeline에서 사진을 볼 수 있지만 Albums API는 빈 결과를 반환합니다. 수정 사항은 이미 master Docker 이미지에 포함되어 있습니다. 배포를 photoview/photoview:2.4.0에서 photoview/photoview:master로 업데이트하고, 컨테이너를 다시 생성한 후, 영향을 받는 사용자에 대해 스캔을 실행하세요. Docker Compose의 경우 이미지를 photoview/photoview:master로 변경한 다음 docker compose pull && docker compose up -d를 실행하세요. 버전을 전환하기 전에 SQLite 데이터베이스를 백업하세요.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: Docker와 Docker Compose가 설치되어 있는지 확인
2단계: 공식 docker-compose.example.yml 파일을 다운로드하여 docker-compose.yml로 저장
3단계: 환경 변수를 수정하여 관리자 비밀번호와 미디어 디렉터리 경로 설정
- 1단계: Docker와 Docker Compose가 설치되어 있는지 확인
- 2단계: 공식 docker-compose.example.yml 파일을 다운로드하여 docker-compose.yml로 저장
- 3단계: 환경 변수를 수정하여 관리자 비밀번호와 미디어 디렉터리 경로 설정
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
docker-compose.yml이 있는 디렉터리로 이동하여 `docker compose down -v`를 실행해 컨테이너와 볼륨을 삭제하세요. 데이터베이스와 구성 파일을 완전히 제거하려면 영구 저장 디렉터리를 수동으로 삭제하세요.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs