Skip to content

Fixare

Cum persistă fișierele în rețeaua IPFS și de ce contează fixarea.

Problema colectării gunoiului

Nodurile IPFS au stocare limitată. Pentru a gestiona spațiul pe disc, rulează periodic colectarea gunoiului -- un proces care elimină datele din cache care nu au fost marcate explicit ca importante. Fără intervenție, un fișier pe care l-ați încărcat ar putea fi șters din rețea în câteva ore.

Fixarea spune unui nod IPFS: "păstrează acest fișier permanent -- nu-l colecta." Un fișier fixat rămâne în stocarea nodului pe termen nedefinit, asigurând disponibilitatea sa în rețea.

Fixare locală vs. fixare la distanță

Fixarea locală înseamnă rularea propriului nod IPFS și fixarea fișierelor pe acesta. Sunteți responsabil pentru uptime, stocare și conectivitate de rețea. Dacă nodul dvs. intră offline, fișierele dvs. devin indisponibile.

Fixarea la distanță (ceea ce oferă IPFS.NINJA) înseamnă că un serviciu gestionat fixează fișierele dvs. pe o infrastructură mereu online. Obțineți permanența fixării fără a rula propriul nod.

TIP

Fiecare fișier încărcat prin IPFS.NINJA este automat fixat în clusterul nostru IPFS. Nu sunt necesari pași suplimentari -- fișierele dvs. sunt persistente din momentul încărcării.

Ce se întâmplă când defixați

Dacă ștergeți un fișier din contul IPFS.NINJA, îl defixăm de pe nodurile noastre. Fișierul poate fi în continuare accesibil dacă:

  • Alte noduri IPFS au în cache sau au fixat același CID
  • Un gateway IPFS are fișierul în cache
  • Un alt utilizator a încărcat același conținut (același CID = același fișier)

În timp, fără niciun nod care fixează CID-ul, fișierul va fi complet eliminat din rețea prin colectarea gunoiului.

Cele mai bune practici de fixare

  • Fixați devreme -- Încărcați și fixați conținutul înainte de a referenția CID-ul în contracte inteligente, metadate NFT sau sisteme externe.
  • Nu vă bazați pe cache -- Cache-urile gateway IPFS sunt temporare. Doar conținutul fixat are persistența garantată.
  • Păstrați contul activ -- Fișierele rămân fixate atât timp cât contul IPFS.NINJA este activ, chiar și pe nivelul gratuit.

Fixarea conținutului existent

Nu trebuie să încărcați un fișier prin IPFS.NINJA pentru a-l fixa. Dacă conținutul există deja în rețeaua IPFS -- încărcat de altcineva sau de dvs. prin alt serviciu -- îl puteți fixa în contul dvs. furnizând CID-ul.

Când fixați un CID existent, clusterul nostru:

  1. Caută în rețeaua IPFS noduri care au conținutul
  2. Descarcă conținutul de la cel mai apropiat nod disponibil
  3. Îl fixează local pe infrastructura noastră
  4. Îl face accesibil prin contul și gateway-ul dvs.

Aceasta este utilă pentru:

  • Păstrarea activelor NFT -- fixați metadate și imagini din colecții existente
  • Backup conținut -- asigurați-vă că CID-urile importante rămân disponibile chiar dacă fixatorul original intră offline
  • Migrare de la alt serviciu -- fixați CID-urile existente fără a reîncărca fișierele

Consultați documentația Pinning API pentru detalii endpoint.