Fijación

Como los archivos persisten en la red IPFS y por que la fijación importa.

El problema de la recolección de basura

Los nodos IPFS tienen almacenamiento limitado. Para gestionar el espacio en disco, ejecutan periódicamente la recolección de basura — un proceso que elimina datos en cache que no han sido marcados explícitamente como importantes. Sin intervención, un archivo que subiste podria ser eliminado de la red en cuestion de horas.

La fijación le dice a un nodo IPFS: "mantiene este archivo permanentemente — no lo recolectes como basura." Un archivo fijado permanece en el almacenamiento del nodo indefinidamente, asegurando que permanezca disponible en la red.

Fijación local vs. fijación remota

La fijación local significa ejecutar tu propio nodo IPFS y fijar archivos en el. Tu eres responsable del tiempo de actividad, almacenamiento y conectividad de red. Si tu nodo se desconecta, tus archivos se vuelven inaccesibles.

La fijación remota (lo que IPFS.NINJA proporciona) significa que un servicio gestionado fija tus archivos en infraestructura que está siempre en línea. Obtienes la permanencia de la fijación sin ejecutar tu propio nodo.

TIP

Cada archivo subido a través de IPFS.NINJA se fija automáticamente en nuestro cluster IPFS. No se necesitan pasos adicionales — tus archivos son persistentes desde el momento de la subida.

¿Qué sucede cuando desfijas

Si eliminas un archivo de tu cuenta de IPFS.NINJA, lo desfijamos de nuestros nodos. El archivo puede seguir siendo accesible si:

• Otros nodos IPFS han almacenado en cache o fijado el mismo CID
• Un gateway IPFS tiene el archivo en su cache
• Otro usuario subio el mismo contenido (mismo CID = mismo archivo)

Con el tiempo, sin ningún nodo fijando el CID, el archivo será recolectado como basura de la red por completo.

Mejores practicas de fijación

• Fija temprano — Sube y fija tu contenido antes de referenciar el CID en contratos inteligentes, metadatos NFT o sistemas externos.
• No dependas del cache — Los caches de gateways IPFS son temporales. Solo el contenido fijado tiene garantia de persistir.
• Mantiene tu cuenta activa — Los archivos permanecen fijados mientras tu cuenta de IPFS.NINJA este activa, incluso en el nivel gratuito.

Fijar contenido existente

No tienes que subir un archivo a través de IPFS.NINJA para fijarlo. Si el contenido ya existe en la red IPFS — subido por otra persona, o por ti a través de otro servicio — puedes fijarlo a tu cuenta proporcionando su CID.

Cuando fijas un CID existente, nuestro cluster:

1. Busca en la red IPFS los nodos que tienen el contenido
2. Descarga el contenido del nodo disponible más cercano
3. Lo fija localmente en nuestra infraestructura
4. Lo hace accesible a través de tu cuenta y gateway

Esto es util para:

• Preservar activos NFT — fijar metadatos e imágenes de colecciones existentes
• Respaldar contenido — asegurar que CIDs importantes permanezcan disponibles incluso si el fijador original se desconecta
• Migrar desde otro servicio — fijar tus CIDs existentes sin volver a subir los archivos

Consulta la documentación de la API de Fijación para detalles de los endpoints.