Como usar o PhotoPrism como uma galeria privada com inteligência artificial em seu computador local.

¿Como usar o PhotoPrism como uma galeria privada com inteligência artificial localmente? Como manter sua biblioteca de fotos organizadaSem depender da nuvem pública, isso deixou de ser um sonho: com o PhotoPrism, você pode criar uma galeria de fotos privada, com inteligência artificial, no seu próprio computador ou servidor e navegar por anos de memórias sem comprometer sua privacidade. Aqui está uma explicação detalhada e prática de como funciona, o que você precisa e como configurá-lo localmente com o Docker.

Para muitos, o Google Fotos é extremamente conveniente, mas em troca dessa conveniência surgem dúvidas razoáveis ​​sobre o uso dos dados. Se você se preocupa com a privacidade Ou, se você precisa cumprir regulamentações como o GDPR em contextos profissionais, o PhotoPrism é uma alternativa poderosa: organização automática, tags com inteligência artificial, busca avançada e um fluxo de trabalho projetado para grandes coleções, tudo dentro da sua infraestrutura existente.

O que é o PhotoPrism e por que usá-lo localmente?

PhotoPrism é um aplicativo web. Gerenciamento de fotos com inteligência artificial (com Google TensorFlow para classificação) que reconhece pessoas, objetos, cores e cenas para etiquetar e organizar sua biblioteca. Foi criado como uma solução auto-hospedada para que você possa armazenar suas fotos e vídeos em casa ou em seu próprio servidor, preservando a privacidade sem abrir mão de recursos modernos.

Existem várias pistas em seu DNA: Compatibilidade com formatos RAW e clássicos. como JPEG ou PNG; indexação inteligente com detecção de duplicados; navegação por linha do tempo, locais e tags; e um mecanismo de busca que permite combinar filtros por câmera, cor, data, país e até mesmo marcar itens como favoritos. Tudo roda na sua máquina, com caches locais e sem depender de terceiros para análise.

A interface é um PWA (Progressive Web App), portanto, é instalada na tela inicial de computadores e dispositivos móveis. Ele funciona especialmente bem no Chrome, Chromium, Safari, Firefox e Edge.Observe que a reprodução de determinados codecs de vídeo e áudio (por exemplo, AAC em H.264) pode variar de acordo com o navegador, o que é normal na web moderna.

Outro fator diferenciador é a sua integração com WebDAV e serviços externos: Você pode sincronizar a partir de dispositivos móveis com aplicativos como o PhotoSync.Além disso, a galeria também pode ser exibida com links protegidos por senha que expiram. Adicionalmente, se você deseja mapas e dados de localização, o PhotoPrism utiliza um serviço de geocodificação reversa e mapas de alta privacidade fornecidos pelo MapTiler; esses recursos são projetados para minimizar a exposição e melhorar o desempenho do cache. Para saber mais, incluímos este guia sobre como... Organize suas fotos com IA sem armazenamento em nuvem: PhotoPrism e alternativas locais..

Requisitos, hardware e desempenho

Para uso local sem problemas Recomenda-se um mínimo de dois núcleos de CPU, 3 GB de RAM e um sistema de 64 bits. Além dos requisitos mínimos, é aconselhável que a quantidade de RAM seja compatível com o número de núcleos e, para bibliotecas grandes, utilize um SSD local para o banco de dados e caches. A indexação é um processo que exige muito processamento; com um SSD e uma boa memória de troca (swap), o desempenho melhora significativamente.

Se o seu servidor tiver menos de 4 GB de swap, ou se você definir limites de memória/swap muito agressivos, Você pode experimentar reinicializações inesperadas. Quando o indexador precisar de mais recursos (isso é comum com arquivos RAW grandes, panoramas de 360 ​​graus ou vídeos 4K), habilite ou aumente o espaço de troca e tenha paciência: com muitas fotos, a indexação inicial pode levar dias.

Com relação ao banco de dados, O PhotoPrism é compatível com SQLite 3 e MariaDB 10.5.12 e versões posteriores.O SQLite é fácil de usar para iniciantes, mas se você busca desempenho e escalabilidade, o MariaDB é uma escolha melhor. O suporte para MySQL 8 foi descontinuado devido à baixa demanda e à falta de recursos em comparação com o MariaDB. Dica importante: evite usar a tag "latest" na imagem do MariaDB; use versões estáveis ​​que foram exaustivamente testadas.

Em relação às plataformas, o aplicativo é implantado onde o Docker estiver disponível: Linux, macOS e Windows com Docker DesktopAlém do FreeBSD, Raspberry Pi e muitos dispositivos NAS, existem opções em nuvem como PikaPods ou DigitalOcean, embora aqui nos concentremos em soluções locais para maior privacidade e controle.

Instalação do Docker passo a passo

Se você nunca usou o DockerNão se preocupe: a implantação com o Docker Compose é simples. O arquivo YAML pode ser colocado em qualquer pasta de sua preferência; primeiro, crie um diretório para o PhotoPrism e salve o arquivo docker-compose.yml dentro dele. O importante é definir claramente os volumes para originais, armazenamento e, se desejar, importação.

Estas são as três configurações típicas: originais (somente leitura ou leitura/gravação), armazenamento (cache, banco de dados e arquivos auxiliares) e importação. (Opcional). Você pode direcionar os arquivos originais para a pasta onde suas fotos já estão armazenadas. Minha recomendação: mantenha o armazenamento separado das suas fotos, para não misturar o banco de dados e o cache com os arquivos originais.

Exemplo básico de docker-compose Com MariaDB e PhotoPrism (você pode adaptá-lo ao seu ambiente):

version: '3.5'
services:
  mariadb:
    image: 'mariadb:11'
    restart: unless-stopped
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    command: >-
      --innodb-buffer-pool-size=512M
      --transaction-isolation=READ-COMMITTED
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
      --max-connections=512
      --innodb-rollback-on-timeout=OFF
      --innodb-lock-wait-timeout=120
    environment:
      MARIADB_AUTO_UPGRADE: '1'
      MARIADB_INITDB_SKIP_TZINFO: '1'
      MARIADB_DATABASE: 'photoprism'
      MARIADB_USER: 'photoprism'
      MARIADB_PASSWORD: 'cambia-esto'
      MARIADB_ROOT_PASSWORD: 'cambia-esto'
    volumes:
      - './database:/var/lib/mysql'

  photoprism:
    image: 'photoprism/photoprism:latest'
    depends_on:
      - mariadb
    stop_grace_period: 10s
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    ports:
      - '2342:2342'
    environment:
      PHOTOPRISM_ADMIN_USER: 'admin'
      PHOTOPRISM_ADMIN_PASSWORD: 'cambia-esto'
      PHOTOPRISM_AUTH_MODE: 'password'
      PHOTOPRISM_SITE_URL: 'http://localhost:2342/'
      PHOTOPRISM_DEFAULT_TLS: 'true'
      PHOTOPRISM_DATABASE_DRIVER: 'mysql'
      PHOTOPRISM_DATABASE_SERVER: 'mariadb:3306'
      PHOTOPRISM_DATABASE_NAME: 'photoprism'
      PHOTOPRISM_DATABASE_USER: 'photoprism'
      PHOTOPRISM_DATABASE_PASSWORD: 'cambia-esto'
      PHOTOPRISM_ORIGINALS_LIMIT: 5000
      PHOTOPRISM_JPEG_QUALITY: 85
      PHOTOPRISM_DISABLE_WEBDAV: 'false'
      PHOTOPRISM_DISABLE_TENSORFLOW: 'false'
      PHOTOPRISM_DETECT_NSFW: 'false'
      PHOTOPRISM_SIDECAR_JSON: 'true'
      PHOTOPRISM_SIDECAR_YAML: 'true'
    working_dir: '/photoprism'
    volumes:
      - '~/Pictures:/photoprism/originals'
      - './storage:/photoprism/storage'
      - './import:/photoprism/import'

Com o arquivo pronto, abra um terminal nessa pasta e execute o seguinte comando: docker-compose up -dA primeira inicialização baixa as imagens e cria o banco de dados; aguarde alguns minutos. Em seguida, inicia a indexação com docker compose exec photoprism photoprism indexA ser atualizado no futuro: docker compose pull photoprism, docker compose parar photoprism y docker compose up -d --no-deps photoprism.

Credenciais padrão: nome de usuário "admin" e a senha definida nas variáveis ​​de ambiente. Lembre-se de trocar senhas fracas. Assim que você fizer login pela primeira vez. Se você for importar muito material, vale a pena desativar as funções de aprendizado de máquina durante a indexação inicial e ativá-las posteriormente.

Acesso seguro, domínios locais e proxy reverso.

Se você pretende expor o serviço fora da sua rede, Sempre coloque-o depois de HTTPS. Com um proxy reverso como o Traefik ou o Caddy. Sem TLS, tudo trafega em texto simples e pode ser interceptado. Manter a privacidade faz parte do plano: usar certificados válidos e redirecionar HTTP para HTTPS.

Para acessar localmente com um domínio como photoprism.localhost sem especificar uma porta, você tem duas opções: mapear um porto padrão no host (por exemplo, 80:2342, para uso local apenas) ou configure o Traefik para escutar na porta 80 e rotear para o serviço na porta 2342. Certifique-se de que os rótulos do contêiner incluam o roteador, o ponto de entrada e a porta interna do serviço. Um padrão típico com o Traefik seria definir a regra do host, o ponto de entrada da web e apontar a porta do serviço para 2342.

Outro ponto fundamental é o firewall: permite conexões de entrada para as portas que você usa (web e https) e para a API de geocodificação e o Docker, quando necessário. Se você bloquear essas conexões de saída, os mapas e locais não funcionarão corretamente.

Organização, IA e funcionalidades que fazem a diferença

O PhotoPrism funciona com um catálogo poderoso e recursos adicionais; Você pode escrever metadados em JSON e YAML. Além dos seus arquivos originais, o processo não depende exclusivamente do banco de dados. A classificação com TensorFlow (rostos, objetos, cenas e conteúdo adulto) acelera as buscas, e decidir se fotos sensíveis devem ser marcadas como privadas é tão fácil quanto ativar uma configuração.

Para manter o desempenho, você pode ajustar a qualidade e o tamanho das miniaturas, os codecs de vídeo, os limites de taxa de bits e o redimensionamento. O FFmpeg é configurado por variáveis. E, se o seu hardware for compatível, você pode delegar a transcodificação acelerada para Intel QSV, Nvidia, Apple ou VAAPI. Com apenas alguns cliques, você pode passar de um fluxo de trabalho básico para um personalizado para o seu sistema.

A navegação é ágil: linha do tempo, álbuns, etiquetas, favoritos e locais. O painel de pesquisa avançada Permite filtrar por câmera, datas, países, cores ou pessoas. Se você vem de bibliotecas desorganizadas, a detecção de duplicados e a normalização de metadados ajudam a organizar tudo sem esforço.

Em dispositivos móveis, não existe um aplicativo oficial, mas você pode usar o PWA ou sincronizar com WebDAV usando aplicativos como o PhotoSync. O PWA é muito prático.A instalação é como a de um aplicativo nativo, evitando que você precise usar um navegador toda vez. No entanto, a experiência no Android TV ou Google TV é limitada, como acontece com a maioria das soluções desse segmento; a opção mais confiável continua sendo usar um navegador em um laptop conectado à TV se você quiser visualizar fotos com sua família confortavelmente.

Quem se beneficia mais com o PhotoPrism?

Fotógrafos profissionais Com milhares de arquivos RAW, você encontrará um poderoso aliado: indexação, busca por lente ou câmera, detecção de duplicatas e arquivos auxiliares para evitar alterações no original. Ter sua coleção controlada, etiquetada e consolidada economiza horas de trabalho a médio prazo.

Pára designers gráficos e criativosEtiquetas com código de cores e marcadores de objetos ajudam você a localizar rapidamente inspirações visuais. A visualização por momentos e o uso de uma linha do tempo ajudam você a recuperar ideias e materiais sem se perder.

No setor imobiliário, agentes imobiliários Eles podem categorizar propriedades por localização, data ou tags, e compartilhar álbuns com links protegidos que expiram. A privacidade é fundamental aqui, e ter controle do servidor é uma vantagem.

Equipes de marketing digital Eles apreciam uma biblioteca de recursos organizada, com filtros para campanhas, datas e países. O suporte a múltiplos usuários e o uso de arquivos auxiliares facilitam a preservação dos arquivos originais e o compartilhamento de coleções internas sem expô-las externamente.

Pára viajantes, arquivistas digitais e desenvolvedoresAs vantagens variam desde mapas interativos até a capacidade de integrar a galeria com outros serviços via WebDAV. Se a conformidade também for uma preocupação, manter os dados em sua própria infraestrutura ajuda a atender ao GDPR e às políticas internas.

Alternativas populares e como elas se encaixam.

Immich está batendo forte.Lembra muito o Google Fotos, com uma linha do tempo integrada, favoritos organizados por palavras-chave, sincronização com dispositivos móveis e busca semântica por conceitos ou cores. Importar conteúdo do Google Takeout é incrivelmente fácil com ferramentas como o Immich-Go. Como ponto negativo, o aplicativo para Android TV é limitado; para assistir na TV, é preferível usar um navegador em um laptop.

No campo dos pacotes de produtividade, Nextcloud Photos e o plugin Memories Eles oferecem uma opção sólida se você já usa o Nextcloud. O aplicativo Recognize oferece reconhecimento facial, e o Imaginary e o Preview Generator aceleram as pré-visualizações. A interface é funcional, embora ações rápidas como marcar favoritos não sejam tão imediatas quanto em outras opções.

Fotoestrutura Oferece uma abordagem diferente, com uma tela inicial que exibe uma seleção aleatória de fotos para ajudar você a redescobrir seu arquivo. É rápido e moderno, mas seu modo Plus desbloqueia recursos como favoritos e reconhecimento facial, o que pode afastar aqueles que buscam algo totalmente gratuito e local.

Piwigo, Photoview, Lychee ou Photonix Eles abrangem diversos cenários: galerias simples, reconhecimento básico ou organização por tags. Se sua prioridade é a linha do tempo e atalhos rápidos, eles podem não ser suficientes. O LibrePhotos parece muito promissor no papel, mas sua implementação pode ser mais manual e nem sempre funciona sem problemas em computadores com configurações mais modestas.

Acima A Plex lançou o Plex Photos. Atualmente em versão beta para iOS, Android e web, o Plex é uma opção interessante para quem já utiliza o serviço, embora ainda não possua um aplicativo nativo para Android TV bem desenvolvido. O Ente, por outro lado, disponibilizou seu código aberto e oferece criptografia de ponta a ponta; parece bastante promissor, mesmo com clientes para desktop, embora sua hospedagem própria exija algum conhecimento técnico.

Perguntas frequentes para iniciantes em Docker

Onde devo colocar o arquivo YAML?Em qualquer pasta que você desejar. O importante é executar os comandos do Docker Compose a partir desse diretório para que ele leia o YAML correto. Mantenha o arquivo docker-compose.yml e subpastas como storage, database e import juntas para que você tenha tudo facilmente acessível.

Devo montar minha pasta de fotos atual? Sim, mapeie sua pasta de fotos para /photoprism/originals. Se preferir não conceder permissões de gravação, você pode montá-la como somente leitura, mas perderá os recursos de edição de metadados no local; o PhotoPrism também evita modificar os arquivos originais com arquivos auxiliares.

Onde ficam o banco de dados e o cache? É melhor armazená-los fora da sua pasta de fotos, em um caminho separado que você mapeia para /photoprism/storage (e, se estiver usando o MariaDB, para ./database no contêiner do SGBD). Dessa forma, você não mistura caches e bancos de dados com seus arquivos originais.

Como montar uma pasta no DockerNa chave de volumes, use o formato caminho_do_host:caminho_do_container. Por exemplo, ~/Pictures:/photoprism/originals. Verifique as permissões do usuário que executa o container; se necessário, use as variáveis ​​PHOTOPRISM_UID e PHOTOPRISM_GID ou a diretiva user para ajustar as permissões.

Precisamos do Traefik ou do Caddy? Faça isso apenas se desejar TLS automático, domínios e caminhos limpos ou se estiver expondo o serviço à internet. Localmente, mapear a porta 2342 é suficiente. Se estiver usando o Traefik, defina o host, o ponto de entrada web e a porta interna 2342 para o serviço; dessa forma, você poderá acessá-lo com photoprism.localhost sem adicionar :2342.

Suporte, atualizações e comunidade

O projeto tem como objetivo ser a opção que melhor respeita a privacidade E possui um roteiro dinâmico. Eles visam uma política de zero defeitos e, portanto, não definem datas fixas para novos recursos: o ritmo também depende de financiamento e apoio da comunidade. Se for uma boa opção para você, tornar-se membro acelera o desenvolvimento daquilo que mais lhe interessa.

Para esclarecer quaisquer dúvidas, você tem Discussões no GitHub e bate-papo da comunidadeMembros Prata, Ouro e Platina também podem entrar em contato com o suporte técnico. Antes de abrir um relatório de erro, verifique as listas de verificação de solução de problemas; muitas vezes, o problema é uma questão de configuração local e pode ser resolvido rapidamente.

Nas atualizações, você pode automatizar com Torre de vigia Se você se sentir confortável com isso, ótimo; caso contrário, é melhor usar um processo de "pull", "stop" e "up" quando uma versão estável for lançada. Em ambientes críticos, use versões fixas e evite usar a versão mais recente, tanto no PhotoPrism quanto no MariaDB, para garantir atualizações controladas.

Se você se preocupa com mapas e geocodificação reversa, PhotoPrism e MapTiler Esses serviços oferecem um nível muito alto de privacidade. Seu uso é coberto pelo projeto, com armazenamento em cache para melhorar o desempenho e evitar que suas consultas sejam superexpostas.

Por fim, lembre-se do óbvio, mas essencial: Fazer backups não é opcional.Se você gerencia memórias familiares ou materiais de clientes, a responsabilidade é sua. Faça backup do seu banco de dados, armazenamento e, principalmente, dos seus arquivos originais em pelo menos dois locais diferentes. Evite pen drives baratos ou pastas de rede lentas para o seu banco de dados.

A estas alturas, FotoPrisma Ele conquistou a posição. Como uma solução robusta para ter seu próprio Google Fotos local: IA para classificação, velocidade SSD, arquivos auxiliares para preservar os originais e um PWA refinado. Se você prioriza a diversão em vez da catalogação, pode se interessar por alternativas como o Immich devido à sua interface; se a organização meticulosa é o que você busca, o PhotoPrism se destaca. Quaisquer que sejam suas necessidades, com uma boa configuração do Docker Compose, espaço de swap suficiente, HTTPS para acesso à internet e backups, você terá um sistema sólido configurado para os próximos anos.