Pular para o conteúdo

IPFS

O IPFS distribui conteúdo por meio de identificadores CID verificáveis. A integridade do conteúdo, sua persistência e seu acesso são propriedades distintas: exigem provedores, pinning e uma estratégia de recuperação. O CID permite verificar uma representação do arquivo, enquanto a aplicação conserva cópias e decide qual conteúdo pode publicar.

Escrito por Isaac GonzálezAtualizado em 30 de outubro de 2026

Pontos-chave

  • O IPFS (InterPlanetary File System) localiza arquivos pelo seu conteúdo, não pela sua localização.
  • Um CID permite identificar e verificar uma representação de conteúdo.
  • A persistência depende de provedores que conservem e sirvam os arquivos.
  • O IPFS não criptografa automaticamente o conteúdo nem garante disponibilidade eterna.

O que é IPFS?

IPFS (InterPlanetary File System) é um protocolo peer-to-peer para publicar, localizar e recuperar arquivos pelo seu conteúdo, e não pela sua localização. Cada arquivo ou diretório recebe um identificador derivado dos seus dados, o CID, e quem faz o download pode verificar que recebeu exatamente o que pediu, independentemente do nó de origem. O CID verifica os dados, mas não comprova quem os publicou nem que seu conteúdo seja verdadeiro.

A ideia é de Juan Benet, que propôs combinar a estrutura de dados encadeados do Git com a troca entre pares do BitTorrent. Ele fundou a Protocol Labs em maio de 2014 para impulsionar o projeto, publicou o whitepaper em julho daquele ano, e a primeira versão alfa da implementação de referência, hoje chamada Kubo, saiu em 2015. A Protocol Labs também desenvolveu a Filecoin como camada de incentivos complementar: o IPFS funciona sem token e a Filecoin adiciona um mercado de armazenamento remunerado.

É usado sobretudo para metadados e imagens de NFT, documentos referenciados a partir de contratos inteligentes, frontends de aplicações descentralizadas e distribuição de dados públicos. Como diferentes opções de fragmentação e codificação podem produzir CIDs diferentes para um mesmo arquivo, a preparação do conteúdo deve ser reproduzível quando o identificador faz parte de um processo de negócio.

Como funciona

O IPFS divide o trabalho em três funções: representar e endereçar os dados, descobrir quais nós os possuem e transferi-los. Para endereçar, o CID combina o hash dos dados com o seu codec. Arquivos grandes são divididos em blocos com UnixFS e encadeados em um grafo acíclico dirigido do tipo Merkle (Merkle DAG), de modo que qualquer alteração em um bloco produz um novo CID para o conjunto.

Para localizar o conteúdo, os nós consultam uma tabela hash distribuída Kademlia (DHT), que funciona sobre libp2p e indica quais pares armazenam cada CID. Uma implementação também pode delegar essa busca a outro serviço por meio de uma API HTTP. A transferência entre pares é feita com Bitswap, e os gateways HTTP permitem que navegadores e aplicações que não implementam IPFS façam o download do conteúdo.

Adicionar um arquivo a um nó não obriga os outros a conservá-lo. As cópias em cache são temporárias e a coleta de lixo local as elimina, a menos que estejam fixadas com pinning. A disponibilidade depende da existência de provedores acessíveis que mantenham e sirvam esses dados; por isso o produto distingue integridade do conteúdo, persistência do armazenamento e disponibilidade da via de acesso.

O que o IPFS oferece

Sua principal contribuição é uma referência verificável que não depende de um servidor específico. Em uma coleção NFT ou na documentação de um ativo tokenizado, prepara-se o diretório de imagens, metadados ou documentos, obtém-se o CID e registra-se a referência no contrato. A documentação do IPFS recomenda guardar nos metadados URIs ipfs:// e não URLs de um gateway: a referência não fica presa a um provedor e a aplicação gera o link HTTP na sua camada de apresentação.

O mesmo vale para uma aplicação descentralizada: seu build estático é publicado no IPFS e resolvido por meio de um gateway ou de um nome ENS. Alterar o conteúdo implica uma nova referência, a menos que a aplicação use um mecanismo de nome mutável. Antes de emitir, verificam-se links internos, tipos de arquivo e acesso a partir das interfaces previstas.

A operação conserva cópias recuperáveis, verifica periodicamente os pins e testa o acesso a partir de mais de uma infraestrutura, sejam nós próprios com IPFS Cluster ou um serviço de pinning remoto. Essas verificações detectam conteúdo incompleto ou um provedor inacessível. Armazenar uma referência on-chain não dispensa manter os arquivos que lhe dão significado.

Limitações e critérios de escolha

O IPFS não criptografa arquivos automaticamente. Publicar documentos pessoais ou confidenciais exige decidir se eles devem ser expostos e como criptografia, chaves e acesso serão gerenciados. Tampouco existe uma garantia geral de exclusão de todas as cópias depois que terceiros obtiveram o conteúdo.

Os gateways públicos, como os oferecidos pela IPFS Foundation, são um serviço de utilidade pública que consome muitos recursos dos seus operadores, e a própria documentação sugere que uma aplicação com uso contínuo execute seu próprio gateway. Os gateways do tipo path não isolam a origem e não devem ser usados para hospedar aplicações web.

A escolha em relação a um armazenamento convencional depende de o produto precisar de endereçamento verificável e distribuição entre provedores. A Filecoin e outros sistemas adicionam incentivos ou contratos de armazenamento, mas não transformam qualquer referência em disponibilidade eterna garantida. O orçamento inclui armazenamento, replicação, gateways e testes de recuperação durante o prazo de que o produto precisa.

Também conhecido como

  • InterPlanetary File System
  • IPFS Protocol
  • CID storage
Aplicação na Metlabs

Como conduzimos um projeto com IPFS

Capacidades de desenvolvimento e casos de uso para avaliar como IPFS se encaixa no seu produto.

O que construímos com IPFS na Metlabs

  • Metadados verificáveis

    Preparação de arquivos e metadados, pinning e verificações de integridade e acesso.

  • Frontends descentralizados

    Build estático da dApp publicado no IPFS, acessível via gateway ou ENS.

  • Caso de uso

    Coleção NFT com metadata imutável

    Diretório de imagens e metadados com CID registrado, cópias recuperáveis e monitoramento de disponibilidade.

  • Caso de uso

    Documentos de um ativo tokenizado

    Referências verificáveis de documentos públicos; a exposição de dados sensíveis é avaliada separadamente.

FAQ

Perguntas frequentes

Um gateway de IPFS é uma API HTTP padronizada que obtém conteúdo endereçado por CID a partir de nós e provedores de IPFS e o serve a navegadores e aplicações sem suporte nativo. Facilita o acesso, mas adiciona sua própria disponibilidade e suas políticas, por isso a referência canônica deve ser a URI ipfs:// e não a URL do gateway.

O pinning marca um conteúdo para que a coleta de lixo de um nó não o elimine; sem ele, as cópias em cache são temporárias. É feito com nós próprios, por exemplo com IPFS Cluster, ou com um serviço de pinning remoto. Convém fixar o mesmo CID em mais de um provedor e verificá-lo periodicamente.

Precisa integrar IPFS?

Analisamos o seu caso, escolhemos o stack adequado e entregamos uma solução pronta para produção.

Conte-nos sobre o seu projeto

Falam de nós

CointelegraphInvesting.comEl EspañolEmprendedoresEl ObservadorCriptoNoticias