Fixação

Como os arquivos persistem na rede IPFS e por que a fixação é importantimportante.

O problema da coleta de lixo

Os nós IPFS tem armazenamento limitado. Para gerenciar o espaço em disco, eles executam periodicamente a coleta de lixo — um processo que remove dados em cache que não foram explicitamente marcados como importantes. Sem intervenção, um arquivo que você enviou poderia ser removido da rede em questão de horas.

A fixação diz a um no IPFS: "mantenha este arquivo permanentemente — não o colete como lixo." Um arquivo fixado permanece no armazenamento do no indefinidamente, garantindo que permaneca disponível na rede.

Fixação local vs. fixação remota

A fixação local significa executar seu próprio no IPFS e fixar arquivos nele. Você e responsável pelo tempo de atividade, armazenamento e conectividade de rede. Se seu no ficar offline, seus arquivos se tornam indisponíveis.

A fixação remota (o que o IPFS.NINJA fornece) significa que um serviço gerenciado fixa seus arquivos em infraestrutura que está sempre online. Você obtem a permanência da fixação sem executar seu próprio no.

TIP

Cada arquivo enviado pelo IPFS.NINJA e automaticamente fixado no nosso cluster IPFS. Nenhum passo adicional é necessnecessário — seus arquivos são persistentes desde o momento do upload.

O que acontece quando você desfixa

Se você excluir um arquivo da sua conta IPFS.NINJA, nós o desfixamos dos nossos nós. O arquivo pode ainda ser acessível se:

• Outros nós IPFS armazenaram em cache ou fixaram o mesmo CID
• Um gateway IPFS tem o arquivo em seu cache
• Outro usuario enviou o mesmo conteúdo (mesmo CID = mesmo arquivo)

Com o tempo, sem nenhum no fixando o CID, o arquivo será coletado como lixo da rede por completo.

Melhores práticas de fixação

• Fixe cedo — Faça upload e fixe seu conteúdo antes de referenciar o CID em contratos inteligentes, metadados NFT ou sistemas externos.
• Não dependa do cache — Caches de gateways IPFS são temporários. Somente conteúdo fixado tem garantia de persistir.
• Mantenha sua conta ativa — Os arquivos permanecem fixados enquanto sua conta IPFS.NINJA estiver ativa, mesmo no nível gratuito.

Fixar conteúdo existente

Você não precisa fazer upload de um arquivo pelo IPFS.NINJA para fixa-lo. Se o conteúdo já existe na rede IPFS — enviado por outra pessoa, ou por você através de outro serviço — você pode fixa-lo na sua conta fornecendo seu CID.

Quando você fixa um CID existente, nosso cluster:

1. Procura na rede IPFS os nós que possuem o conteúdo
2. Baixa o conteúdo do no disponível mais próximo
3. Fixa-o localmente na nossa infraestrutura
4. Torna-o acessível pela sua conta e gateway

Isso é útil para:

• Preservar ativos NFT — fixar metadados e imagens de coleções existentes
• Fazer backup de conteúdo — garantir que CIDs importantes permanecam disponíveis mesmo se o fixador original ficar offline
• Migrar de outro serviço — fixar seus CIDs existentes sem refazer o upload dos arquivos

Consulte a documentação da API de Fixação para detalhes dos endpoints.