Tutoriais de VPS
Hospedar imagens: R2, galerias, cache e backups para VPS
Escolha objetos, Chevereto, Lychee ou uma biblioteca de fotos conforme o uso. Configure bucket R2, domínio e credencial restrita; entenda preços Standard e hotlink, otimize imagens e migre com backups independentes e restauração testada.

Em um blog, loja ou documentação, onde você guarda as imagens afeta a velocidade, o custo de tráfego e a possibilidade de recuperar arquivos se o serviço mudar. Escolha primeiro a estratégia de armazenamento e de URLs.
Este guia distingue hospedar suas próprias imagens, operar um serviço de uploads e fazer backup da biblioteca do celular. Também explica R2, controle de acesso, otimização e migração, sem prometer que uma CDN torne qualquer localização rápida.
| Necessidade | Ponto inicial |
|---|---|
| Algumas centenas de imagens de blog por ano | Armazenamento de objetos com ferramenta de upload |
| Usuários, uploads e galerias compartilhadas | Chevereto ou Lychee, conforme os recursos reais |
| Backup automático de fotos do celular | Aplicação de biblioteca, como Immich |
Seus arquivos precisam de entrega estável e backup. Um serviço para outras pessoas acrescenta contas, cotas, moderação, validação de arquivos e manutenção. Assuma esses custos quando precisar dos recursos.
Quando storage/CDN entrega as imagens, esse tráfego não usa da mesma maneira a franquia da VPS que serve o HTML. Dez imagens podem representar 2–5 MB por visita, contra dezenas de KB de HTML; depende dos arquivos. Compare também operações e serviços adicionais da CDN.
A modalidade Standard da Cloudflare oferece esta referência; confira os termos atuais da conta antes de contratar:
| Item | Franquia gratuita mensal | Tarifa Standard adicional |
|---|---|---|
| Armazenamento | 10 GB-mês | $0.015 por GB-mês |
| Operações classe A | 1 milhão | $4.50 por milhão |
| Operações classe B | 10 milhões | $0.36 por milhão |
| Saída do R2 | Sem cobrança de egress R2 | Sem cobrança de egress R2 |
As classes incluem mais operações que apenas escrita e leitura. Infrequent Access tem outros custos e condições; a franquia não se aplica da mesma forma. Workers, transformações e serviços adicionais podem cobrar. O egress gratuito ajuda em imagens muito acessadas, mas não torna toda a arquitetura gratuita.
A 200 KB por imagem, 10 GB correspondem aproximadamente a 50.000 arquivos antes de variantes e diferenças de unidades. Isso é uma conta de capacidade, não uma garantia de que qualquer blog ficará na franquia.
- Crie um bucket R2.
- Conecte um domínio como
img.example.com. - Envie arquivos com uma ferramenta autenticada.
- Use as URLs públicas nas páginas.
r2.dev é um endpoint de desenvolvimento com limites. Escolha o fluxo de upload:
- PicGo facilita a interface com uma integração S3/R2 compatível e confiável.
- rclone atende lotes e transferências automatizadas.
- Um cliente da API S3 integra uploads à aplicação. O R2 implementa um subconjunto; confira os recursos necessários.
Automatic permite selecionar a localização automaticamente. Isso não significa que o próprio bucket seja replicado em todas as regiões. Uma indicação de localização também não equivale a um compromisso de jurisdição. Para requisitos de residência de dados, escolha a opção suportada apropriada.
Adicione img.example.com nas configurações de domínio do bucket. O domínio precisa estar na conta Cloudflare adequada; siga o fluxo de DNS gerenciado, em vez de criar um registro arbitrário para o endpoint S3. Desative r2.dev em produção se não precisar desse caminho público independente.
Gere um token Object Read & Write limitado ao bucket. Guarde:
- Access Key ID.
- Secret Access Key.
- O endpoint, com formato como
https://<accountid>.r2.cloudflarestorage.com.
Salve o segredo em um gerenciador de senhas quando for exibido. Não coloque essa credencial no site público nem no código do navegador.
| Campo | Valor |
|---|---|
| Endpoint | Endpoint S3 do R2 da sua conta |
| Bucket | Nome do bucket escolhido |
| Access key/secret | Credencial restrita de upload |
| Domínio público | https://img.example.com |
| Caminho | Organização previsível, como {year}/{month}/ |
Use nomes únicos para evitar sobrescritas. Proteja a configuração local e confira se a URL gerada usa o domínio público, não a API privada.
# 拿到 URL 后测试能否访问,以及响应头里的缓存设置
curl -I https://img.example.com/2026/09/test.png
Confira 200, o content-type esperado, o conteúdo real e os cabeçalhos de cache. Uma resposta bem-sucedida não comprova que seja a imagem pretendida.
Configure regras adequadas para img.example.com. Um TTL de um mês pode atender URLs públicas e imutáveis. Não use Cache Everything em respostas privadas nem substitua imagens sob o mesmo nome sem purga ou versionamento. Defina também metadados do objeto e cache do navegador.
- Use um domínio de produção sob seu controle e meça a entrega nas localidades dos leitores. O guia Cloudflare não garante latência ou acesso universais, inclusive na China continental.
- Preserve URLs e caminhos. Um domínio próprio facilita trocar de provedor, mas origem, redirecionamentos e configuração ainda podem mudar.
- Planeje crescimento, operações e variantes. Exclua apenas arquivos sem referências confirmadas e mantenha backup independente.
O MinIO oferece armazenamento compatível com S3 na sua infraestrutura, sujeito à licença, suporte e recursos da versão. Mudar o endpoint do cliente não transfere sozinho dados, permissões ou metadados.
| Aspecto | R2 | MinIO próprio |
|---|---|---|
| Armazenamento | Franquia Standard e cobranças por uso | Capacidade e custo dos discos |
| Tráfego | Sem egress R2 | Franquia e custos de rede da VPS |
| Operação | Storage gerenciado; você cuida de acesso e backups | Servidor, atualizações, acesso e backups |
| Controle | Sua conta Cloudflare | Seu sistema, com confiança no provedor de hospedagem ainda relevante |
| Recuperação | Durabilidade do provedor e cópias independentes | Você projeta recuperação fora da máquina |
Veja quando usar objetos e implantação do MinIO. Um servidor existente com disco grande, vários TB de tráfego ou uma referência de dezenas de dólares anuais pode atender alguns usos; não é uma oferta atual nem garantia de economia. Dados sensíveis também exigem acesso, criptografia e residência adequados.
Confira os recursos exatos da edição para uploads, galerias, usuários e moderação.
Projeto PHP/banco de dados iniciado em 2007. A edição gratuita usa AGPL; as comerciais têm outros termos e recursos. O repositório gratuito consultado em 16 de novembro de 2026 tem a versão 4.5.9, de 2 de novembro; 4.5.7 é anterior. Confirme em qual edição estão API, armazenamento externo e autenticação.
Uma máquina de 1 GB pode ficar apertada com uploads, miniaturas e banco de dados. O projeto pode atender comunidades e equipes, com mais administração que poucas imagens públicas.
Galeria MIT focada em fotos, álbuns, originais e metadados. A versão consultada é v7.13.0, de 9 de novembro de 2026; v7.10.0 é anterior. Confira bancos e processamento de imagens suportados. SQLite pode atender pequenas instalações compatíveis, sem provar que todo uso seja mais leve que Chevereto.
Avalie os recursos atuais de usuários e compartilhamento para galeria pessoal, portfólio ou equipe; não presuma ausência total de funções multiusuário.
Tem origem no ecossistema chinês de hospedagem de imagens e integrações de armazenamento, algumas voltadas àquele mercado. Confira edição, idioma de suporte e backend necessário. Uma referência a último commit em fevereiro de 2026 é uma observação histórica, não prova de abandono atual. Examine versões, correções e compatibilidade PHP.
É uma opção PHP leve. Confira a licença GPL-2.0 e os requisitos do repositório/versão escolhidos; leve não significa necessariamente um único arquivo. Uma interface mínima de upload ainda precisa de validação e manutenção.
- Manter runtime, banco quando necessário, proxy e certificados.
- Validar tipo, decodificação, tamanho e permissões; impedir execução de uploads.
- Aplicar cotas, controle de acesso e prevenção de abuso conforme os usuários.
- Fazer backup de imagens e metadados e testar restauração.
Números como 4.3k estrelas do Lychee, 3.8k do EasyImages ou 115k do Immich são retratos de popularidade, não evidência de segurança ou suporte atual.
O Immich sincroniza fotos e oferece linha do tempo e busca facial. Ele permite compartilhar, mas esses links não devem ser presumidos permanentes e portáveis para os recursos de um site público. Use o guia do Immich quando o objetivo for a biblioteca pessoal.
Separar as necessidades evita um fluxo trabalhoso de extrair manualmente links para cada imagem de artigo.
Uma coleção grande aumenta o tempo de backup e migração e usa o tráfego da mesma máquina. Separe implantação de código e backups de mídia, preserve caminhos e documente a recuperação. A separação pode ser lógica, sem obrigar outra VPS.
Guardar localmente pode ser razoável com pouco tráfego e menos de cerca de 1 GB de imagens, ou com recursos suficientes e custos de migração aceitos. Monitore o crescimento, sem tratar o limite como regra universal.
Para imagens servidas pelo seu Nginx:
location ~* \.(jpg|jpeg|png|gif|webp|avif)$ {
valid_referers none blocked server_names
*.your-site.com your-site.com;
if ($invalid_referer) {
return 403;
}
expires 30d;
add_header Cache-Control "public, immutable";
}
Adapte os domínios permitidos. none blocked aceita Referer ausente ou oculto, incluindo algumas visitas diretas, e permite passar pela verificação. Referer pode ser falsificado: ajuda na gestão de tráfego, mas não autentica o usuário. immutable só é apropriado para URLs versionadas cujo conteúdo não mudará.
O R2 não oferece uma lista universal de Referer no bucket equivalente ao Nginx. Use regras suportadas no domínio, um Worker ou acesso autenticado/assinado para material privado. As políticas e capacidades do S3 são diferentes. Evite um endpoint público alternativo que contorne a proteção. Acrescente alertas de tráfego e custos, pois cabeçalhos não limitam a conta sozinhos.
| Método | Consideração prática |
|---|---|
| WebP ou AVIF | Frequentemente menores; redução de 25–50% é ilustrativa |
| Dimensões adequadas | Cerca de 1200 px pode atender artigos; considere densidade e zoom |
| Qualidade com perdas perto de 80 | Compare detalhes; não garante aparência idêntica nem metade do tamanho |
| Carregamento sob demanda | Adia imagens fora da tela sem atrasar as principais |
Um PNG de 2 MB pode virar WebP de 150 KB, levando dez imagens de 20 MB a aproximadamente 1.5 MB. O resultado depende do conteúdo e dos ajustes. Preserve originais e confira texto pequeno, transparência e cores.
Use Squoosh para trabalhos ocasionais, ImageMagick/cwebp para lotes ou a integração suportada de Astro/Next.js. Capturas PNG não são necessariamente incomprimíveis; compare opções sem presumir que JPEG preserve melhor o texto. Confirme onde ferramentas processam imagens sensíveis.
| Uso | Opção inicial |
|---|---|
| Blog público pequeno | R2 com ferramenta compatível, como PicGo |
| Muitos recursos públicos | Objetos e entrega CDN medida |
| Controle da infraestrutura | Storage próprio com suporte adequado |
| Comunidade de imagens | Edição apropriada do Chevereto |
| Galeria ou portfólio | Lychee |
| Backup do celular | Immich |
| Upload mínimo | EasyImages com proteções verificadas |
Para ilustrações públicas comuns, objetos geralmente exigem menos administração. É uma recomendação para esse uso, não a única arquitetura possível.
O serviço pode desaparecer? Sim. Bucket exportável e domínio próprio ajudam na portabilidade, mas o provedor pode mudar termos ou suspender a conta. Mantenha cópias independentes; um serviço gratuito sem exportação é especialmente difícil de abandonar.
As URLs duram? Dependem de domínio renovado, acesso à conta, caminhos e configuração. Domínio próprio dá controle, sem garantir links eternos.
Precisa de CDN? Pode ajudar em leituras repetidas. Meça acertos de cache, acessos à origem e locais dos leitores. O plano gratuito atender depende de recursos e uso.
Um serviço de imagens se paga com anúncios? Calcule tráfego, processamento, armazenamento, moderação e manutenção antes de contar com receita.
Imagens em outro país serão rápidas? Meça os caminhos reais do público. A China continental tem condições específicas de rede/CDN que não se generalizam a todos; uma CDN não garante acesso nem elimina filtragem.
Como migrar? Comece com uma cópia e valide arquivos e metadados:
# 用 rclone 批量同步
rclone copy /srv/app/uploads/ r2:mybucket/uploads/ --progress
Preserve caminhos quando possível. Se as URLs mudarem, atualize referências e mantenha redirecionamentos 301 adequados. Não remova a origem antiga antes de verificar entrega e reversão.
Como fazer backup? Objetos não são uma cópia independente. O espelhamento abaixo apaga no destino o que não existe na origem: use --dry-run antes e não o trate como única recuperação.
rclone sync r2:mybucket /backup/r2-mirror/ --progress
Guarde versões ou cópias datadas independentes, outra localização e um processo de restauração testado. Uma exclusão da origem não deve apagar silenciosamente todas as cópias.
Qual formato? Compare os arquivos reais:
- WebP ou AVIF atendem muitas fotos.
- PNG ou alternativas testadas atendem capturas, ícones e transparência.
- WebP animado ou vídeo podem substituir um GIF grande.
WebP tem suporte amplo em navegadores modernos, mas teste seus clientes e alternativas quando necessário.
Domínio ou caminho? img.example.com costuma facilitar trocar a origem em comparação com example.com/img/. Um caminho servido por proxy também pode ser portável. DNS sozinho não adapta caminhos diferentes nem configura TLS e acesso do novo provedor.