Skip to content

Pinning

Paano nananatili ang mga file sa IPFS network at bakit mahalaga ang pinning.

Ang garbage collection problem

May limitadong storage ang mga IPFS node. Para pamahalaan ang disk space, pana-panahon silang nagpapatakbo ng garbage collection — proseso na nag-aalis ng naka-cache na data na hindi malinaw na na-mark bilang mahalaga.

Ang pinning ay nagsasabi sa IPFS node: "panatilihin mo ang file na ito nang permanente."

Local pinning vs. remote pinning

Local pinning — nagpapatakbo ka ng sarili mong IPFS node. Ikaw ang responsable sa uptime, storage, at connectivity.

Remote pinning (ibinibigay ng IPFS.NINJA) — isang managed service ang nag-pi-pin ng iyong mga file sa infrastructure na palaging online.

TIP

Bawat file na na-upload sa pamamagitan ng IPFS.NINJA ay awtomatikong napi-pin sa aming IPFS cluster. Walang karagdagang hakbang na kinakailangan.

Ano ang nangyayari kapag nag-unpin

Kung mag-delete ka ng file, ia-unpin namin mula sa aming mga node. Maaaring accessible pa rin ang file kung:

  • Iba pang IPFS node ang nag-cache o nag-pin ng parehong CID
  • May file ang IPFS gateway sa cache nito
  • Nag-upload ng parehong nilalaman ang ibang user

Mga pinakamahusay na kasanayan

  • Mag-pin nang maaga — Mag-upload at mag-pin bago i-reference ang CID sa mga smart contract o NFT metadata.
  • Huwag umasa sa caching — Pansamantala lang ang mga IPFS gateway cache. Tanging naka-pin na nilalaman lang ang garantisadong mananatili.
  • Panatilihing aktibo ang iyong account — Nananatiling naka-pin ang mga file habang aktibo ang IPFS.NINJA account mo.

Pag-pin ng umiiral na nilalaman

Hindi mo kailangang mag-upload ng file sa pamamagitan ng IPFS.NINJA para i-pin ito. Kung may nilalaman na umiiral na sa IPFS network, maaari mo itong i-pin sa iyong account sa pamamagitan ng pagbibigay ng CID nito.

Tingnan ang Pinning API docs para sa mga detalye ng endpoint.