Què és l’IPFS Pinning? Tot el que Necessiteu Saber el 2026

Si heu passat temps explorant l’emmagatzematge descentralitzat, probablement heu sentit parlar d’IPFS --- l’InterPlanetary File System. Promet una web on els fitxers s’adrecen pel seu contingut en lloc de la seva ubicació, fent les dades portàtils, verificables i resistents a la censura. Però hi ha un parany que enganya gairebé tots els nouvinguts: si ningú manté explícitament el vostre fitxer, aquest desapareix.

Aquí és on entra el pinning. Aquesta guia explica què és l’IPFS pinning, per què importa, com funciona per sota i com fixar el vostre primer fitxer avui.

Una Introducció Ràpida a IPFS

IPFS és un protocol peer-to-peer per emmagatzemar i compartir fitxers. En lloc de descarregar un fitxer d’un servidor específic (com https://example.com/photo.jpg), el sol·liciteu pel seu Content Identifier (CID) --- un hash criptogràfic del contingut del fitxer. Qualsevol node de la xarxa que tingui una còpia el pot servir.

Aquest model té propietats potents:

• Deduplicació --- els fitxers idèntics comparteixen el mateix CID, de manera que la xarxa mai emmagatzema dues còpies del mateix contingut.
• Integritat --- el hash garanteix que el fitxer no ha estat manipulat.
• Descentralització --- cap servidor individual controla l’accés.

Però els nodes IPFS tenen espai de disc finit, i necessiten una manera de decidir quines dades conservar i quines descartar. Aquest mecanisme s’anomena garbage collection, i és la raó per la qual els vostres fitxers poden desaparèixer.

El Problema de la Garbage Collection

Cada node IPFS manté un magatzem de blocs local. Quan el node obté contingut en nom vostre --- per exemple, visualitzeu una imatge a través d’una gateway pública --- els blocs es guarden en memòria cau temporalment. Amb el temps, el node executa la garbage collection per alliberar espai, i qualsevol bloc que no estigui explícitament marcat com a important s’elimina.

Aquí el punt crític: afegir un fitxer a IPFS no garanteix que hi romangui. Si l’únic node que tenia el vostre fitxer es desconnecta, o si aquell node fa garbage-collect dels blocs, el contingut esdevé irrecuperable. El CID encara existeix com a adreça, però no hi ha ningú a casa.

Això és per disseny. IPFS és un protocol d’adreçament de contingut, no una garantia d’emmagatzematge permanent. La permanència requereix una decisió explícita de retenir les dades. Aquesta decisió s’anomena pinning.

Què és el Pinning?

El pinning indica a un node IPFS: “Conserva aquest contingut. No el facis garbage-collect, passi el que passi.” Penseu-hi com marcar una pàgina en un llibre físic --- el llibre no perdrà aquella pàgina perquè la prestatgeria es reorganitzi.

Quan fixeu un CID, el node marca cada bloc associat amb aquell contingut com a protegit. La garbage collection omet totalment aquells blocs.

Hi ha dues variants de pinning:

Local Pinning

Executeu el vostre propi node IPFS (utilitzant Kubo, per exemple) i fixeu fitxers directament:

ipfs pin add QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG

El contingut roman a la vostra màquina mentre el vostre node estigui en funcionament i el pin estigui en vigor.

Remote Pinning

Envieu una sol·licitud de pin a un servei de tercers que opera infraestructura IPFS en nom vostre. Els nodes del servei fixen el contingut i el mantenen disponible 24/7, fins i tot quan la vostra pròpia màquina està apagada.

Per què Existeixen els Serveis de Remote Pinning

El local pinning funciona, però comporta una sobrecàrrega operativa que la majoria de desenvolupadors i equips no volen gestionar:

• Disponibilitat --- El vostre portàtil no està en línia les 24 hores del dia. Si el vostre node es desconnecta, ningú pot recuperar els vostres fitxers fixats de vosaltres. Altres nodes que hagin guardat en memòria cau el contingut poden acabar fent garbage-collect.
• Ample de banda --- Servir fitxers populars des d’una connexió residencial ràpidament esdevé un coll d’ampolla.
• Manteniment --- Executar un node IPFS significa mantenir el programari actualitzat, monitorar l’ús de disc, gestionar connexions de peers i manejar la configuració de xarxa.
• Redundància --- Un sol node és un punt únic de fallada. Els serveis de pinning professionals normalment repliquen les dades a múltiples nodes en diferents regions.

Els serveis de remote pinning resolen tots aquests problemes. Pugeu o fixeu el vostre contingut a través d’una API, i el servei gestiona la infraestructura, la replicació i la disponibilitat. Vosaltres us centreu en construir la vostra aplicació.

Com Funciona l’IPFS Pinning per Dins

Entendre la mecànica tècnica us ajuda a prendre millors decisions sobre la vostra arquitectura d’emmagatzematge.

1. El Contingut es Divideix en Blocs

Quan afegiu un fitxer a IPFS, el node el divideix en fragments (típicament 256 KB cadascun). Cada fragment es hash individualment, produint un CID per a cada bloc.

2. Es Construeix un DAG

Els blocs s’organitzen en un Directed Acyclic Graph (DAG) utilitzant una estructura de dades anomenada Merkle DAG. Per a un fitxer individual, el CID arrel apunta a nodes intermedis, que apunten als blocs de dades en brut. Per a directoris, el DAG inclou enllaços al sub-DAG de cada fitxer.

3. El Pin Protegeix Tot el DAG

Quan fixeu un CID arrel, el node marca recursivament el bloc arrel i cada bloc que referencia com a fixat. Això s’anomena recursive pin i és el comportament per defecte. També hi ha direct pin (protegeix només el bloc arrel) i indirect pin (blocs protegits perquè un avantpassat està fixat), però els recursive pin són el que utilitzareu el 99% del temps.

4. El Node Anuncia Disponibilitat

El node de pinning publica registres de proveïdor a la IPFS Distributed Hash Table (DHT), anunciant que té el contingut. Quan un altre peer sol·licita el CID, el DHT els dirigeix al vostre node (o al node del servei de pinning), i els blocs es transfereixen.

5. La Garbage Collection Omet els Blocs Fixats

Durant la garbage collection, el node verifica cada bloc contra el conjunt de pins. Els blocs fixats i els seus descendents es preserven. Tot la resta és elegible per a l’eliminació.

Pinning vs. Hosting

Aquests dos conceptes estan relacionats però són diferents, i confondre’ls porta a confusió.

Pinning significa que un node IPFS reté els blocs i participa a la xarxa peer-to-peer per servir-los a altres nodes IPFS. Si algú sol·licita el CID a través d’un client compatible amb IPFS o un altre node, el node de pinning el lliura.

Hosting (a través d’una gateway) significa proporcionar un punt final HTTP que tradueix un CID en una URL web estàndard. Per exemple:

https://your-gateway.example.com/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco

Les gateways fan de pont entre la xarxa peer-to-peer IPFS i la web tradicional. La majoria d’usuaris i aplicacions accedeixen al contingut IPFS a través de gateways, no a través de clients IPFS natius.

Molts serveis de pinning inclouen una gateway com a part de la seva oferta --- alguns proporcionen una gateway pública compartida, d’altres us donen un subdomini dedicat. Quan avalueu serveis, considereu si necessiteu només pinning (redundància de backend) o pinning més una gateway (lliurament de frontend).

Opcions de Serveis de Pinning el 2026

L’ecosistema de pinning ha madurat considerablement. Aquí teniu una comparació justa de les opcions populars:

Cada servei té els seus punts forts. Pinata i IPFS Ninja ofereixen gateways dedicades, que proporcionen un lliurament HTTP més ràpid i fiable. Web3.Storage ofereix arxiu Filecoin per a persistència a llarg termini. Filebase atrau equips que ja utilitzen eines compatibles amb S3. L’elecció correcta depèn del vostre cas d’ús, escala i preferències d’integració. Per a una comparació detallada de tots els proveïdors principals, consulteu Millors Serveis de Pinning IPFS 2026.

Com Fixar un Fitxer

Repassem com fixar un fitxer utilitzant una REST API. Els exemples següents utilitzen ipfs.ninja, però els conceptes s’apliquen a qualsevol servei.

Pujar i Fixar amb curl

# Upload a JSON file --- the service pins it automatically
curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": {"name": "Alice", "score": 42}}'

La resposta inclou el CID del vostre contingut fixat. Aquell CID ara és recuperable de la xarxa IPFS mentre el pin estigui en vigor.

Pujar amb JavaScript

const response = await fetch("https://api.ipfs.ninja/upload/new", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: { name: "Alice", score: 42 },
  }),
});

const result = await response.json();
console.log("CID:", result.cid);

Fixar un CID Existent

Si el vostre contingut ja és a la xarxa IPFS i voleu que un altre node el fixi per redundància:

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cid": "QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG", "description": "Project metadata"}'

El servei obté el contingut de la xarxa, emmagatzema els blocs i els fixa. Les vostres dades ara tenen un punt de disponibilitat addicional.

Quan Utilitzar IPFS Pinning

El pinning no és l’eina adequada per a cada problema d’emmagatzematge. Aquí és on destaca:

Metadades i Mitjans NFT

Els mercats NFT i els creadors necessiten que les metadades dels tokens i les obres d’art siguin accessibles indefinidament. Si el JSON de metadades o la imatge desapareix, l’NFT perd efectivament el seu contingut. El pinning assegura que el CID referenciat al smart contract sempre es resol.

Actius d’Aplicacions Descentralitzades (dApp)

Les dApp que serveixen frontends, fitxers de configuració o contingut generat per l’usuari a través d’IPFS necessiten que aquells actius estiguin disponibles de forma fiable. El pinning proporciona aquesta fiabilitat sense dependre d’un CDN centralitzat.

Documentació Permanent

Registres reguladors, documents legals, articles acadèmics i pistes d’auditoria es beneficien de l’emmagatzematge adreçat per contingut. El CID serveix com a prova que el document no ha estat alterat, i el pinning assegura que es mantingui recuperable.

Publicació Resistent a la Censura

Periodistes, activistes i organitzacions que operen en entorns restrictius utilitzen IPFS per publicar contingut que no es pot eliminar dirigint-se a un sol servidor. El pinning a múltiples serveis i regions afegeix resiliència.

Pipelines de Dades Verificables

Dades de cadena de subministrament, conjunts de dades científiques i registres financers es poden hash i fixar per crear una pista d’auditoria immutable. Els consumidors aigües avall verifiquen la integritat comprovant el CID.

Errors Comuns a Evitar

Assumir que IPFS Significa Permanent

Aquesta és la confusió número u. Afegir un fitxer a IPFS el fa adreçable, no permanent. Sense pinning, el vostre fitxer està a un cicle de garbage collection de desaparèixer. Fixeu sempre el contingut que us importa.

Pensar que el Pinning Equival a Encriptació

El pinning manté les vostres dades disponibles --- no les fa privades. Qualsevol que conegui el CID pot recuperar el contingut. Si necessiteu confidencialitat, encripteu els vostres fitxers abans de pujar-los a IPFS. El CID apuntarà llavors a text xifrat, que és inútil sense la clau de desencriptació.

Ignorar la Immutabilitat del CID

Un CID és un hash del contingut. Si canvieu fins i tot un byte, obteniu un CID completament diferent. Això significa que no podeu “actualitzar” un fitxer fixat al seu lloc. En canvi, pugeu la nova versió (que obté un nou CID), la fixeu i opcionalment desfixeu l’antiga. Per a referències mutables, consulteu IPNS (InterPlanetary Name System), que mapeja un nom estable a un CID canviant. Alguns serveis de pinning, com IPFS Ninja, inclouen suport IPNS integrat perquè pugueu crear i publicar noms mutables directament a través de l’API.

Dependre d’un Únic Pin

Si el vostre servei de pinning té una interrupció, el vostre contingut pot quedar temporalment inaccessible. Per a dades crítiques, considereu fixar amb múltiples serveis o mantenir un pin local com a còpia de seguretat. La redundància en el pinning reflecteix la redundància en la infraestructura tradicional.

Oblidar el Rendiment amb Fitxers Grans

IPFS funciona millor amb fitxers de menys d’uns quants centenars de megabytes. Els fitxers molt grans (de diversos gigabytes) poden ser lents de transferir i cars de fixar. Si treballeu amb grans conjunts de dades, considereu dividir-los en fragments més petits o utilitzar un servei optimitzat per a objectes grans.

Conclusió

L’IPFS pinning és el mecanisme que converteix l’adreçament de contingut d’una idea interessant en una estratègia d’emmagatzematge fiable. Sense ell, els vostres fitxers viuen de temps prestat. Amb ell, obteniu disponibilitat de dades verificable, descentralitzada i persistent.

L’ecosistema ofereix múltiples serveis de pinning madurs amb nivells gratuïts generosos, de manera que no hi ha cap barrera per començar. Si voleu provar-ho, ipfs.ninja us permet fixar fins a 500 fitxers i 1 GB de dades gratuïtament amb una gateway dedicada --- no cal targeta de crèdit.

A punt per fixar el vostre primer fitxer? Consulteu la nostra guia de pujada pas a pas per passar de zero a un CID fixat en menys de dos minuts.

Sigui quin sigui el servei que trieu, el més important és fixar el vostre contingut. Els vostres CID us ho agrairan.