Repolode
alangrainger

alangrainger/immich-public-proxy

Proxy sin estado que permite compartir fotos y álbumes de Immich públicamente sin exponer el servidor de Immich.

Estrellas
2,419
Forks
94
Issues abiertos
13
Último commit
hace 8 días

¿Qué es?

Immich Public Proxy (IPP) se sitúa entre internet y tu servidor de Immich. Solo reenvía las solicitudes de enlaces que ya compartiste desde Immich, de modo que el resto de la instancia permanece protegido. No necesita una clave de API ni acceso privilegiado a Immich, y no almacena datos propios.

Para configurarlo, ejecuta un contenedor de Docker (también hay documentación para Kubernetes), indícale la URL local de Immich y una URL pública, y establece el dominio externo de Immich para que apunte al proxy. A partir de entonces, los enlaces que genera Immich apuntan al proxy, y la gestión de los recursos compartidos sigue haciéndose desde Immich.

Los visitantes pueden subir opcionalmente sus propias fotos y videos a un álbum compartido; por ejemplo, los invitados pueden añadir fotos a un álbum de boda. El visor de galerías es PhotoSwipe, que ofrece zoom y navegación mediante gestos de deslizamiento o el teclado.

Funciones clave

  • 01Solo expone al público las fotos y los álbumes de Immich compartidos explícitamente.
  • 02No requiere una clave de API de Immich ni acceso privilegiado.
  • 03No tiene estado, base de datos ni claves de álbumes compartidos almacenadas.
  • 04Se implementa con Docker Compose o Kubernetes.
  • 05La opción de permitir subidas a los visitantes permite que los invitados añadan fotos y videos a un álbum compartido.

Casos de uso

  • Enviar a familiares o amigos un enlace a un álbum de fotos sin exponer el servidor de Immich a internet.
  • Recopilar fotos de invitados a bodas o eventos en un álbum compartido.
  • Publicar una galería de fotos desde una biblioteca de Immich alojada en un servidor propio.

Inicio rápido

  1. 1

    Descarga el archivo docker-compose.yml

  2. 2

    Configura IMMICH_URL con la URL local de Immich y PUBLIC_BASE_URL con la URL pública de IPP

  3. 3

    Inicia el proxy con Docker Compose

    docker-compose up -d
  4. 4

    En la configuración del servidor de Immich, establece el dominio externo como tu URL de IPP

Antes de usarlo

  • Se necesita un servidor de Immich autohospedado y una implementación independiente del proxy.
  • Si usas Cloudflare, debes configurar las rutas de video para omitir la caché; de lo contrario, es posible que los videos no se reproduzcan.

En colecciones

Temas

Preguntas frecuentes

¿Qué es immich-public-proxy?
Proxy sin estado que permite compartir fotos y álbumes de Immich públicamente sin exponer el servidor de Immich. Immich Public Proxy (IPP) se sitúa entre internet y tu servidor de Immich. Solo reenvía las solicitudes de enlaces que ya compartiste desde Immich, de modo que el resto de la instancia permanece protegido. No necesita una clave de API ni acceso privilegiado a Immich, y no almacena datos propios.
¿immich-public-proxy es gratuito? ¿Qué licencia tiene?
immich-public-proxy es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿immich-public-proxy sigue mantenido?
Mantenimiento activo. El último commit de immich-public-proxy fue el 29 oct 2026.
¿Para qué puedo usar immich-public-proxy?
Enviar a familiares o amigos un enlace a un álbum de fotos sin exponer el servidor de Immich a internet. Recopilar fotos de invitados a bodas o eventos en un álbum compartido. Publicar una galería de fotos desde una biblioteca de Immich alojada en un servidor propio.
¿Cómo se instala immich-public-proxy?
Descarga el archivo docker-compose.yml Configura IMMICH_URL con la URL local de Immich y PUBLIC_BASE_URL con la URL pública de IPP Inicia el proxy con Docker Compose: docker-compose up -d En la configuración del servidor de Immich, establece el dominio externo como tu URL de IPP
¿Dónde consigo immich-public-proxy?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/alangrainger/immich-public-proxy

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados