Repolode
提交项目
alangrainger

alangrainger/immich-public-proxy

一个无状态代理，让你无需暴露 Immich 服务器即可公开分享照片和相册。

在 GitHub 查看官网
Star
2,419
Fork
94
未关闭 Issue
13
最近提交
9天前

这是什么？

Immich Public Proxy（IPP）位于公网和 Immich 服务器之间，只放行你已在 Immich 中公开分享的请求，其余部分保持锁定。它不需要 API Key，也不需要 Immich 的特权访问权限，自身不存储任何数据。

部署方式是运行一个 Docker 容器（也提供 Kubernetes 配置），填入 Immich 的本地地址和对外访问地址，再把 Immich 的外部域名设为代理地址。之后 Immich 生成的分享链接都会指向代理，分享仍然在 Immich 内部管理。

访客还可以选择向分享相册上传自己的照片和视频，例如婚礼宾客补充现场照片。图库查看器基于 PhotoSwipe，支持缩放、滑动和键盘操作。

核心功能

  • 01只向公网开放在 Immich 中明确分享的照片和相册。
  • 02无需 Immich API Key 或特权访问。
  • 03无状态设计，不使用数据库，也不保存分享密钥。
  • 04支持通过 Docker Compose 或 Kubernetes 部署。
  • 05可选的访客上传功能，允许访客向分享中添加照片和视频。

适用场景

  • 向家人或朋友发送相册链接，同时无需把 Immich 服务器暴露在互联网上。
  • 收集婚礼或活动宾客的照片，汇入同一个共享相册。
  • 将自托管 Immich 图库中的内容发布为公开图集。

快速上手

  1. 1

    下载 docker-compose.yml 文件

  2. 2

    将 IMMICH_URL 设为本地 Immich 地址，将 PUBLIC_BASE_URL 设为 IPP 的公网地址

  3. 3

    使用 Docker Compose 启动代理

    docker-compose up -d
  4. 4

    在 Immich 的服务器设置中，将外部域名设为 IPP 地址

使用前须知

  • 需要自行部署 Immich 服务器，并额外部署此代理。
  • 如果使用 Cloudflare，需将 /share/video/* 路径设为绕过缓存，否则视频可能无法播放。

收录于专题

自托管相册自托管应用隐私与本地优先工具安全扫描、审计与威胁情报工具

标签

#photo-sharing#immich#self-hosted#privacy#reverse-proxy#docker#gallery#security

常见问题

immich-public-proxy 是什么？
一个无状态代理，让你无需暴露 Immich 服务器即可公开分享照片和相册。 Immich Public Proxy（IPP）位于公网和 Immich 服务器之间，只放行你已在 Immich 中公开分享的请求，其余部分保持锁定。它不需要 API Key，也不需要 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 地址，将 PUBLIC_BASE_URL 设为 IPP 的公网地址 使用 Docker Compose 启动代理: docker-compose up -d 在 Immich 的服务器设置中，将外部域名设为 IPP 地址
在哪里获取 immich-public-proxy？
源代码和安装说明在 GitHub 上：https://github.com/alangrainger/immich-public-proxy

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目