Alternativa ao Filebase: IPFS Pinning Simples Sem S3

Comparação Rápida: Filebase vs IPFS Ninja

Conclusão: se já está a configurar clientes AWS SDK de qualquer forma, o Filebase encaixa naturalmente. Se quer enviar um ficheiro para IPFS num único comando curl, o IPFS Ninja ganha em simplicidade.

Faça Upload de um Ficheiro para IPFS em 30 Segundos

Este é o fluxo de upload do IPFS Ninja. Sem SDK, sem XML, sem passo de criação de bucket:

curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from IPFS Ninja!",
    "description": "My first file"
  }'

Resposta:

{
  "cid": "bafkreib4mrow...",
  "sizeMB": 0.00002,
  "uris": {
    "ipfs": "ipfs://bafkreib4mrow...",
    "url": "https://ipfs.ninja/ipfs/bafkreib4mrow..."
  }
}

Feito. Esse CID está fixado (pinned), acessível via IPFS e disponível através do gateway público de imediato.

Agora veja o fluxo equivalente no Filebase:

1. Crie uma conta e um bucket na consola do Filebase.
2. Gere um par de chaves de acesso + chave secreta.
3. Configure um cliente S3 com o endpoint https://s3.filebase.com, região us-east-1 e as suas credenciais.
4. Chame putObject com o corpo do seu ficheiro.
5. Consulte os metadados do objeto para recuperar o CID IPFS (aparece como cabeçalho x-amz-meta-cid após o Filebase o fixar).

Não está errado — tem simplesmente mais peças em movimento do que a maioria dos projetos REST-nativos necessita.

Por Que os Developers Encontram Fricção com o S3 no Filebase

A compatibilidade S3 do Filebase é genuinamente útil quando:

• Tem infraestrutura existente que comunica via S3 (funções Lambda, módulos Terraform, agentes de backup).
• Armazena blobs grandes e quer a semântica de upload multipart que já conhece.
• A sua equipa domina AWS e o SDK S3 já é uma dependência.

Mas muitos developers que integram IPFS numa aplicação web, numa dApp ou num pipeline de CI não vêm desse mundo. Deparam-se com:

Respostas de erro em XML. O S3 devolve XML. A sua chamada JavaScript fetch recebe <?xml version="1.0" ...><Error><Code>InvalidAccessKeyId</Code> e tem de adicionar um parser XML para depurar.

Gestão de credenciais. A autenticação estilo S3 (chave de acesso + segredo + assinatura de pedido HMAC-SHA256) não é trivial de implementar de raiz num browser ou numa edge function. Os URLs pré-assinados ajudam, mas gerá-los do lado do servidor acrescenta uma viagem de ida e volta.

Obtenção do CID como afterthought. O CID é metadado no objeto S3, não a resposta primária. Tem de analisar cabeçalhos de resposta ou chamar um endpoint de metadados separado.

Sem tokens de upload assinados nativos. Se quiser que os utilizadores façam upload diretamente do browser sem expor credenciais do servidor, o Filebase exige que construa você mesmo um endpoint de geração de URLs pré-assinados.

Os tokens de upload assinados do IPFS Ninja tratam deste padrão nativamente: gere um token com limite de tempo do lado do servidor uma vez, incorpore-o no seu frontend e deixe os utilizadores fazer POST diretamente para api.ipfs.ninja até o token expirar ou o revogar.

Preços Lado a Lado

Para projetos pequenos a médios, a diferença entre o plano gratuito e o primeiro nível pago é de $5/mês no IPFS Ninja contra cerca de $20/mês no Filebase. Se está a construir um projeto pessoal ou um MVP de startup, essa diferença importa.

Comparação de Funcionalidades de Gateway

Ambos os serviços oferecem gateways IPFS dedicados (subdomínios que servem o seu conteúdo fixado via HTTPS). Onde diferem:

Filebase oferece um gateway dedicado nos planos pagos. Serve o conteúdo do seu bucket e integra-se com o namespace S3 deles.

Os gateways do IPFS Ninja em https://{slug}.gw.ipfs.ninja suportam:

• Modos de acesso: restrito (requer token), aberto (público) ou pasta (listagem de diretório).
• Whitelist de IPs: bloqueie um gateway a IPs de servidor conhecidos.
• Restrições de origem: restrinja a origens HTTP específicas, útil para cenários CORS apenas de browser.
• Otimização de imagens: o endpoint /image/{cid} permite redimensionar, cortar e converter formato em tempo real — sem necessidade de uma CDN de imagens separada.

Se o seu caso de uso é servir assets para um frontend web, a restrição de origem CORS e os endpoints de otimização de imagens integrados poupam-lhe uma integração de serviço separada.

Fixar um CID Existente

Já tem um CID de outro nó ou serviço? Ambas as plataformas permitem fixá-lo sem fazer novo upload. No IPFS Ninja:

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "cid": "bafkreib4mrow...",
    "description": "Pinned from external source"
  }'

No Filebase, fixa via PUT para o seu bucket com o CID como cabeçalho de metadados personalizado, e depois o Filebase vai buscar e fixa-o. O fluxo centrado no CID do IPFS Ninja é mais direto se vem de uma mentalidade IPFS-nativa em vez de S3-nativa.

Veja o que é IPFS pinning para uma explicação mais aprofundada sobre por que o pinning importa e o que acontece quando o conteúdo não está fixado.

Uploads do Lado do Cliente Sem Expor Credenciais

Esta é uma questão de arquitetura comum: como permitir que um browser faça upload para IPFS sem enviar a sua chave de API para o cliente?

Abordagem Filebase: gere um URL S3 PUT pré-assinado no seu servidor, devolva-o ao cliente, o cliente faz PUT diretamente. Padrão S3 pré-assinado standard, funciona bem, mas tem de implementar o endpoint de assinatura do lado do servidor.

Abordagem IPFS Ninja: chame /token/upload/new (ou gere via dashboard) para criar um token de upload assinado. Incorpore esse token no seu frontend. O cliente faz POST para api.ipfs.ninja usando Authorization: Signed {token}. O token pode ser configurado para expirar após um período definido ou revogado instantaneamente a partir do dashboard.

// Frontend code — token was fetched from your server
const token = 'your-signed-upload-token';

const response = await fetch('https://api.ipfs.ninja/upload/new', {
  method: 'POST',
  headers: {
    'Authorization': `Signed ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    content: btoa(fileContentAsArrayBuffer), // base64 for binary
    description: 'User uploaded file',
  }),
});

const { cid, uris } = await response.json();
console.log('Pinned at:', uris.url);

Para uma explicação mais detalhada dos padrões de upload, veja como fazer upload de ficheiros para IPFS.

Quando Ainda Deve Escolher o Filebase

Este artigo pretende ser honesto, não uma argumentação unilateral.

Escolha o Filebase se:

• O seu código já usa AWS SDK v3 ou Boto3 e quer zero dependências adicionais.
• Está a migrar de S3 para IPFS e quer trocar endpoints em vez de reescrever a lógica de upload.
• Armazena ficheiros muito grandes e precisa de upload multipart fiável com semântica S3 (embora o IPFS Ninja também tenha uma API de upload de ficheiros grandes).
• A sua equipa tem experiência profunda em AWS e considera a autenticação S3 mais familiar do que cabeçalhos REST.

Escolha o IPFS Ninja se:

• Quer um único POST /upload/new para obter um CID de volta sem passos intermédios.
• Está a construir uma aplicação frontend-first e precisa de tokens de upload seguros para o cliente sem construir infraestrutura de pré-assinatura.
• Quer otimização de imagens e gateways com controlo de acesso sem adicionar outro serviço.
• É sensível ao preço e o ponto de entrada de $5/mês importa para a fase do seu projeto.

Resumo

O Filebase é um produto sólido para equipas que já vivem no ecossistema AWS. A sua compatibilidade com S3 é uma vantagem real quando esse é o seu contexto. Mas para developers que simplesmente querem fixar ficheiros em IPFS através de uma REST API limpa — e obter um CID de volta imediatamente — a camada S3 acrescenta cerimónia sem benefício.

O IPFS Ninja mantém a superfície da API mínima: upload, pin, fetch. As funcionalidades de gateway, otimização de imagens e tokens de upload estão disponíveis quando precisar delas, sem serem obrigatórias à partida.

Para uma visão mais abrangente de como o IPFS Ninja se compara a outros serviços, veja melhores serviços de IPFS pinning.

Pronto para começar a fixar? Crie uma conta gratuita — 500 ficheiros, 1 GB de armazenamento, sem cartão de crédito necessário.

Sobre este artigo: Este artigo foi redigido por um assistente de IA utilizando o fluxo de geração de conteúdo do IPFS.NINJA, depois revisto e aprovado por Nacho Coll. Todos os exemplos de código foram verificados contra a API IPFS.NINJA em produção. Se detetar uma imprecisão, por favor abra uma issue em https://github.com/ipfs-ninja/feedback. Leia mais sobre como usamos IA no nosso conteúdo e conheça as pessoas por detrás do IPFS.NINJA.