alangrainger/immich-public-proxy

어떤 프로젝트인가요?

핵심 기능

• 01명시적으로 공유한 Immich 사진과 앨범만 외부에 공개합니다.
• 02Immich API 키나 권한 있는 접근이 필요하지 않습니다.
• 03무상태 방식으로 동작하며 데이터베이스나 저장된 공유 키가 없습니다.
• 04Docker Compose 또는 Kubernetes로 배포할 수 있습니다.
• 05방문자 업로드 기능을 선택하면 게스트가 공유 앨범에 사진과 동영상을 추가할 수 있습니다.

활용 사례

• Immich 서버를 인터넷에 공개하지 않고 가족이나 친구에게 사진 앨범 링크를 보내는 경우.
• 결혼식이나 행사에 참석한 게스트의 사진을 공유 앨범에 모으는 경우.
• 셀프 호스팅 Immich 라이브러리의 사진 갤러리를 공개하는 경우.

빠른 시작

1. 1

   docker-compose.yml 파일을 다운로드합니다

2. 2

   IMMICH_URL을 로컬 Immich URL로, PUBLIC_BASE_URL을 공개 IPP URL로 설정합니다

3. 3

   Docker Compose로 프록시를 시작합니다

   docker-compose up -d
4. 4

   Immich 서버 설정에서 외부 도메인을 IPP URL로 설정합니다

사용 전 알아둘 점

• !셀프 호스팅 Immich 서버와 별도로 배포한 프록시가 필요합니다.
• !Cloudflare를 사용하는 경우 동영상이 재생되지 않을 수 있으므로 동영상 경로를 캐시 우회로 설정해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

immich-public-proxy은(는) 무엇인가요?

Immich 서버를 외부에 노출하지 않고 사진과 앨범을 공개 공유할 수 있게 해주는 무상태 프록시입니다. Immich Public Proxy (IPP)는 공개 인터넷과 Immich 서버 사이에서 동작합니다. Immich에서 이미 공유한 링크에 대한 요청만 전달하므로 나머지 인스턴스는 계속 보호됩니다. API 키나 Immich에 대한 권한 있는 접근이 필요하지 않으며, 자체적으로 데이터를 저장하지 않습니다.

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

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

immich-public-proxy은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. immich-public-proxy의 마지막 커밋은 2026년 10월 29일입니다.

immich-public-proxy은(는) 어디에 사용할 수 있나요?

Immich 서버를 인터넷에 공개하지 않고 가족이나 친구에게 사진 앨범 링크를 보내는 경우. 결혼식이나 행사에 참석한 게스트의 사진을 공유 앨범에 모으는 경우. 셀프 호스팅 Immich 라이브러리의 사진 갤러리를 공개하는 경우.

immich-public-proxy는 어떻게 설치하나요?

docker-compose.yml 파일을 다운로드합니다 IMMICH_URL을 로컬 Immich URL로, PUBLIC_BASE_URL을 공개 IPP URL로 설정합니다 Docker Compose로 프록시를 시작합니다: docker-compose up -d Immich 서버 설정에서 외부 도메인을 IPP URL로 설정합니다

immich-public-proxy은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/alangrainger/immich-public-proxy