Épinglage

Comment les fichiers persistent sur le réseau IPFS et pourquoi l'épinglage est important.

Le problème du ramasse-miettes

Les nœuds IPFS ont un stockage limite. Pour gérer l'espace disque, ils exécutent periodiquement le ramasse-miettes — un processus qui supprime les données en cache qui n'ont pas ete explicitement marquees comme importantes. Sans intervention, un fichier que vous avez téléchargé pourrait etre supprime du réseau en quelques heures.

L'épinglage dit à un nœud IPFS : "garde ce fichier en permanence — ne le supprime pas par le ramasse-miettes." Un fichier épinglé reste dans le stockage du nœud indéfiniment, garantissant qu'il reste disponible sur le réseau.

Épinglage local vs. épinglage distant

L'épinglage local signifie exécuter votre propre nœud IPFS et y épingler des fichiers. Vous etes responsable du temps de disponibilité, du stockage et de la connectivite réseau. Si votre nœud se deconnecte, vos fichiers deviennent inaccessibles.

L'épinglage distant (ce que fournit IPFS.NINJA) signifie qu'un service géré épinglé vos fichiers sur une infrastructure toujours en ligne. Vous obtenez la permanence de l'épinglage sans exécuter votre propre nœud.

TIP

Chaque fichier téléversé via IPFS.NINJA est automatiquement épinglé sur notre cluster IPFS. Aucune etape supplémentaire n'est nécessaire — vos fichiers sont persistants des le moment du téléversement.

Ce qui se passe lorsque vous désépinglez

Si vous supprimez un fichier de votre compte IPFS.NINJA, nous le désépinglons de nos nœuds. Le fichier peut encore etre accessible si :

• D'autres nœuds IPFS ont mis en cache ou épinglé le même CID
• Un gateway IPFS à le fichier dans son cache
• Un autre utilisateur a téléversé le même contenu (même CID = même fichier)

Avec le temps, sans aucun nœud epinglant le CID, le fichier sera supprime du réseau par le ramasse-miettes.

Bonnes pratiques d'épinglage

• Épinglez tot — Téléchargez et épinglez votre contenu avant de referencer le CID dans des contrats intelligents, des métadonnées NFT ou des systemes externes.
• Ne comptez pas sur le cache — Les caches des gateways IPFS sont temporaires. Seul le contenu épinglé est garanti de persister.
• Gardez votre compte actif — Les fichiers restent épinglés tant que votre compte IPFS.NINJA est actif, même sur le niveau gratuit.

Épingler du contenu existant

Vous n'avez pas besoin de téléverser un fichier via IPFS.NINJA pour l'épingler. Si du contenu existe deja sur le réseau IPFS — téléversé par quelqu'un d'autre, ou par vous via un autre service — vous pouvez l'épingler sur votre compte en fournissant son CID.

Lorsque vous épinglez un CID existant, notre cluster :

1. Recherche sur le réseau IPFS les nœuds qui ont le contenu
2. Téléchargé le contenu depuis le nœud disponible le plus proche
3. L'épinglé localement sur notre infrastructure
4. Le rend accessible via votre compte et votre gateway

C'est utile pour :

• Préserver des actifs NFT — épingler des métadonnées et images de collections existantes
• Sauvegarder du contenu — garantir que des CIDs importants restent disponibles même si l'épingleur original se deconnecte
• Migrer depuis un autre service — épingler vos CIDs existants sans retélécharger les fichiers

Consultez la documentation de l'API d'Épinglage pour les details des endpoints.