Repolode
Enviar
alangrainger

alangrainger/immich-public-proxy

Um proxy sem estado que permite compartilhar fotos e álbuns do Immich publicamente sem expor seu servidor Immich.

Ver no GitHubSite
Estrelas
2,419
Forks
94
Issues abertas
13
Último commit
há 8 dias

O que é?

O Immich Public Proxy (IPP) fica entre a internet pública e seu servidor Immich. Ele encaminha apenas as requisições de links que você já compartilhou pelo Immich, mantendo o restante da instância protegido. Não precisa de chave de API nem de acesso privilegiado ao Immich, e não armazena nenhum dado próprio.

A configuração consiste em executar um contêiner Docker (a documentação também cobre Kubernetes), apontá-lo para a URL local do Immich e para uma URL pública, e definir o domínio externo do Immich como o proxy. Depois disso, os links gerados pelo Immich apontam para o proxy, e o compartilhamento continua sendo gerenciado dentro do Immich.

Opcionalmente, os visitantes podem enviar as próprias fotos e vídeos para um compartilhamento — por exemplo, convidados podem adicionar fotos a um álbum de casamento. O visualizador da galeria é o PhotoSwipe, que oferece zoom e navegação por gestos e pelo teclado.

Recursos principais

  • 01Expõe ao público apenas fotos e álbuns do Immich compartilhados explicitamente.
  • 02Não exige chave de API do Immich nem acesso privilegiado.
  • 03Não mantém estado: não usa banco de dados nem armazena chaves de compartilhamento.
  • 04Pode ser implantado com Docker Compose ou Kubernetes.
  • 05O envio opcional de arquivos pelos visitantes permite que convidados adicionem fotos e vídeos a um compartilhamento.

Casos de uso

  • Enviar à família ou aos amigos um link para um álbum de fotos sem deixar seu servidor Immich exposto à internet.
  • Reunir fotos dos convidados de um casamento ou evento em um álbum compartilhado.
  • Publicar uma galeria pública de fotos a partir de uma biblioteca Immich auto-hospedada.

Início rápido

  1. 1

    Baixe o arquivo docker-compose.yml

  2. 2

    Defina IMMICH_URL como a URL local do Immich e PUBLIC_BASE_URL como a URL pública do IPP

  3. 3

    Inicie o proxy com Docker Compose

    docker-compose up -d
  4. 4

    Nas configurações do servidor Immich, defina o domínio externo como sua URL do IPP

Antes de usar

  • É necessário ter um servidor Immich auto-hospedado e implantar o proxy separadamente.
  • Se você usa Cloudflare, configure os caminhos de vídeo para ignorar o cache; caso contrário, os vídeos podem não ser reproduzidos.

Em coleções

Bibliotecas de fotos auto-hospedadasApps auto-hospedadosFerramentas de privacidade e local-firstFerramentas de varredura, auditoria e inteligência de ameaças

Tópicos

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

Perguntas frequentes

O que é immich-public-proxy?
Um proxy sem estado que permite compartilhar fotos e álbuns do Immich publicamente sem expor seu servidor Immich. O Immich Public Proxy (IPP) fica entre a internet pública e seu servidor Immich. Ele encaminha apenas as requisições de links que você já compartilhou pelo Immich, mantendo o restante da instância protegido. Não precisa de chave de API nem de acesso privilegiado ao Immich, e não armazena nenhum dado próprio.
immich-public-proxy é gratuito? Qual é a licença?
immich-public-proxy é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
immich-public-proxy ainda é mantido?
Manutenção ativa. O último commit de immich-public-proxy foi em 29 de out. de 2026.
Para que posso usar immich-public-proxy?
Enviar à família ou aos amigos um link para um álbum de fotos sem deixar seu servidor Immich exposto à internet. Reunir fotos dos convidados de um casamento ou evento em um álbum compartilhado. Publicar uma galeria pública de fotos a partir de uma biblioteca Immich auto-hospedada.
Como instalar immich-public-proxy?
Baixe o arquivo docker-compose.yml Defina IMMICH_URL como a URL local do Immich e PUBLIC_BASE_URL como a URL pública do IPP Inicie o proxy com Docker Compose: docker-compose up -d Nas configurações do servidor Immich, defina o domínio externo como sua URL do IPP
Onde consigo immich-public-proxy?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alangrainger/immich-public-proxy

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados