11notes/immich-share-proxy

🏔️ Alpine - Immich Share Proxyhttps://github.com/11notes/docker-immich-share-proxy/tree/1.4.2 !size !version !pulls在不暴露Immich本身的情况下公开您的Immich共享内容，且全部在同一域名下！!https://github.com/11notes/docker-immich-share-proxy/blob/main/img/immich.share.proxy.index.png?raw=true!https://github.com/11notes/docker-immich-share-proxy/blob/main/img/immich.share.proxy.gallery.png?raw=true## 概述与主要用途该镜像作为反向代理和Immich之间的中间层，可安全公开Immich共享相册，同时防止对Immich本身的未授权访问。它支持在同一域名下运行，无需为共享功能单独配置备用域名。通过代理仅暴露共享所需的内容，结合反向代理（如Traefik、Nginx）可实现安全的外部访问。## 核心功能与特性-** 安全隔离 ：仅暴露共享相册内容，不泄露Immich整体访问权限- 同一域名 ：无需额外域名，通过路径前缀（如/share）区分共享内容- 密码支持 ：兼容Immich共享链接的密码保护功能- 批量下载 ：配置Immich API密钥后支持"全部下载"功能- 自定义配置 ：可通过环境变量调整lightGallery画廊参数## 使用场景与适用范围- 家庭或个人用户需要分享Immich相册给他人，但不想公开整个Immich实例- 小型团队内部共享照片资源，需控制访问范围- 希望通过单一域名管理Immich主服务与共享功能的场景## 使用方法与配置说明### Docker Compose配置示例yamlname: "immich"services: share-proxy: image: "11notes/immich-share-proxy:1.4.2" container_name: "immich.share-proxy" environment: TZ: "Europe/Zurich" IMMICH_URL: "http://server:2283" IMMICH_API_KEY: "dse53b342dst4552c345235v345v2345v23b2345b3253" LIGHT_GALLERY_CONFIG: |- { "ipp": { "responseHeaders": { "Cache-Control": "public, max-age=2592000" }, "singleImageGallery": false, "singleItemAutoOpen": true, "downloadOriginalPhoto": true }, "lightGallery": { "controls": true, "download": true, "mobileSettings": { "controls": false, "showCloseIcon": true, "download": true } } } ports: - "3000:3000/tcp" # 与Immich使用相同的FQDN（photos.domain.com），但仅在/share路径下 labels: - "traefik/http/routers/photos.domain.com-share/entrypoints=https" - "traefik/http/routers/photos.domain.com-share/tls=true" - "traefik/http/routers/photos.domain.com-share/rule=(Host(`photos.domain.com`)&&PathPrefix(`/share`))" - "traefik/http/routers/photos.domain.com-share/service=photos.domain.com-share" - "traefik/http/services/photos.domain.com-share/loadbalancer/servers/0/url=http://share-proxy:3000" networks: frontend: restart: "always" server: image: "ghcr.io/immich-app/immich-server:v1.118.2" container_name: "immich" ports: - "2283:2283/tcp" labels: - "traefik/http/routers/photos.domain.com/entrypoints=https" - "traefik/http/routers/photos.domain.com/tls=true" - "traefik/http/routers/photos.domain.com/rule=(Host(`photos.domain.com`))" - "traefik/http/routers/photos.domain.com/service=photos.domain.com" - "traefik/http/services/photos.domain.com/loadbalancer/servers/0/url=http://server:2283" networks: frontend: restart: "always"networks: frontend:### 配置步骤1. 设置Immich外部域名 ：在Immich实例中配置外部域名，使其与反向代理中使用的域名一致。2. 创建共享链接 ：在Immich中创建共享相册，可选择添加密码保护（下载限制功能不生效）。3. 配置API密钥（可选）：若需"全部下载"功能，在Immich账户设置中创建API密钥，并通过IMMICH_API_KEY环境变量传入。4. 配置反向代理**：设置反向代理规则，将/share路径路由至该代理服务，主域名路由至Immich服务。### 默认设置| 参数 | 值 | 描述 || --- | --- | --- || user | docker | 运行用户 || uid | 1000 | 用户ID || gid | 1000 | 组ID || home | /node | 用户主目录 |### 环境变量| 参数 | 说明 | 默认值 || --- | --- | --- || TZ | 时区（参考时区数据库列表） | 无 || DEBUG | 启用调试信息输出 | 无 || HEALTHCHECK_URL | 健康检查URL | http://localhost:3000/healthcheck || IMMICH_URL | Immich内部访问URL | [**] || IMMICH_API_KEY | "全部下载"功能所需的Immich API密钥 | 无 || LIGHT_GALLERY_CONFIG | https://github.com/sachinchoolur/lightGallery%E5%86%85%E8%81%94%E9%85%8D%E7%BD%AE | 无 |## 来源 https://github.com/11notes/docker-immich-share-proxy/tree/1.4.2## 父镜像* https://hub.docker.com/r/11notes/node## 构建依赖* https://github.com/sachinchoolur/lightGallery%EF%BC%88%E6%84%9F%E8%B0%A2Ujjwal%E6%8F%90%E4%BE%9B%E7%9A%84%E5%85%8D%E8%B4%B9%E8%AE%B8%E5%8F%AF%EF%BC%89* nodejs* alpine* https://github.com/alangrainger/immich-public-proxy%EF%BC%88%E7%81%B5%E6%84%9F%E6%9D%A5%E6%BA%90%EF%BC%89## 提示* 使用Traefik、Nginx等反向代理终止TLS连接，并配置有效证书* 使用Let’s Encrypt证书保护SSL端点## ElevenNotes^™️本镜像仅供参考，使用风险自负。更新镜像前请务必备份数据。重大更新请查看变更日志。所有仓库可在https://github.com/11notes%E6%9F%A5%E7%9C%8B%E3%80%82