Migrar o Supabase Storage para o S3 sem quebrar imagens, permissões nem URLs
Publicado em 2026-11-14 por frfrand
Plano prático para migrar arquivos do Supabase Storage para o S3 com inventário, chaves, políticas, URLs, validação e reversão.

Mover os arquivos do Supabase Storage para um serviço compatível com S3 é mais do que copiar objetos. Se o seu aplicativo depende de URLs públicas, links assinados, permissões por usuário ou metadados de buckets, uma mudança apressada pode deixar imagens quebradas e arquivos privados acessíveis.
1. Antes de copiar, inventarie o uso real
Documente cada bucket, sua visibilidade, nomes de objetos, quantidade de arquivos, tamanho total e formatos. Busque onde os caminhos são armazenados: colunas SQL, respostas de API, modelos de e-mail e caches. Anote quais arquivos são baixados com URLs assinados, quais usuários podem enviá-los e quais fluxos precisam excluir ou substituir objetos.
2. Mapeie a segurança do Supabase para o S3
No Supabase Storage, as regras podem se basear nas políticas de autorização do projeto. No S3, você terá que definir permissões de bucket, políticas IAM, validação na API e eventualmente URLs pré-assinadas. Não copie simplesmente as permissões públicas: revise os casos de autenticação e separação entre organizações.
| Elemento | Antes | Depois |
|---|---|---|
| Bucket | Público ou privado | Política explícita do provedor S3 |
| Caminho | Chave de objeto Supabase | Chave de objeto S3 |
| URL | Domínio e API do Supabase | Domínio S3/CDN/proxy |
| Acesso temporário | Signed URL | URL pré-assinada com expiração |
| Auditoria | Logs do Supabase | Registros do provedor e do aplicativo |
3. Projete as chaves e a estratégia de URL
Evite usar URLs absolutas como identificadores permanentes no banco de dados. Em vez disso, guarde uma chave estável, por exemplo tenant_42/avatar/abc.webp, e gere a URL a partir da API de acordo com o provedor ativo. Se você já salvou URLs completas, prepare um mapeamento de substituição e uma compatibilidade temporária por meio de redirecionamentos ou proxy, respeitando a privacidade.
4. Copie e verifique
Utilize uma ferramenta ou script que possa listar objetos da origem de forma autorizada e enviá-los ao destino, preservando MIME, tamanho, metadados necessários e nomes válidos. Não presuma que o ETag é sempre um hash MD5: uploads multipartes e configurações do provedor podem gerar valores diferentes.
Verifique contagem de objetos, bytes totais, hashes calculados ao baixar amostras ou o conjunto completo quando viável, e acessibilidade. Verifique arquivos com espaços, caracteres especiais e caminhos profundos. Defina um relatório de exceções para cada objeto com falha.
5. Evite a perda de gravações durante a mudança
Opções: interromper temporariamente os uploads, habilitar gravação dupla com reconciliação ou manter um período de sincronização incremental. Escolha de acordo com o volume e a tolerância a downtime. Não altere as leituras até validar as novas URLs com uma versão de teste do frontend.
Após a mudança, monitore 403, 404, tamanho da resposta e taxa de erros de carregamento. Mantenha um plano para voltar à origem durante o período de transição.
6. Não se esqueça de custos e retenção
Inclua armazenamento, solicitações PUT/GET, saída de rede, CDN, backups, suporte e possível cobrança por transferência entre regiões. Confirme criptografia e retenção com seu provedor; S3 compatível não significa que todos implementem exatamente as mesmas características.
Consulte migrar dados e serviços desde Lovable Cloud, qué es Supabase y los servicios de ArduMaker.
Perguntas frequentes
### Posso copiar arquivos sem tocar no meu frontend? Só se mantiver uma camada de compatibilidade para URLs e permissões.
O S3 tem as mesmas políticas que o Supabase?
Não. Você deve reproduzir as regras relevantes com políticas e lógica de backend.
É seguro excluir o bucket original imediatamente?
Não antes de validar a migração, expiração de links, cópias e reversão.
Referências: Supabase Storage y Amazon S3.