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.

Migrar o Supabase Storage para o S3 sem quebrar imagens, permissões nem URLs

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.

ElementoAntesDepois
BucketPúblico ou privadoPolítica explícita do provedor S3
CaminhoChave de objeto SupabaseChave de objeto S3
URLDomínio e API do SupabaseDomínio S3/CDN/proxy
Acesso temporárioSigned URLURL pré-assinada com expiração
AuditoriaLogs do SupabaseRegistros 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.

  • Supabase
  • S3
  • migración
  • storage
  • seguridad

Continuar lendo

Todos os artigos · Planos VPS