IPFS Performance: Pabilisin ang File Retrieval sa Gateway

“Mabagal ang IPFS” — isa ito sa pinakakaraniwang reklamo ng mga developer, at isa rin sa pinakamadaling ayusin. Ang dahilan ay halos palaging ang paraan ng pag-access, hindi ang protocol mismo. Saklaw ng gabay na ito ang apat na teknik na nagaalis ng IPFS latency sa production.

Piliin ang IPFS Access Method Ayon sa Bilis#

Kung gumagamit ka ng public gateways sa production, lumipat sa dedicated gateway at mawawala agad ang karamihan ng iyong latency.

Bakit Mabagal ang mga Public Gateway#

Nagsasagawa ang mga public gateway ng DHT (Distributed Hash Table) lookup para sa bawat CID na hindi pa nila nakikita kamakailan. Ang DHT lookup ay nangangahulugang mag-query sa dose-dosenang peers sa buong network para malaman kung sino ang may hawak ng nilalaman — ang round-trip na iyon ay tumatagal ng 2–15 segundo sa isang malamig na request.

Kahit may cache hit, naglilingkod ang mga public gateway sa milyun-milyong user. Ang iyong kamakailan lamang na na-pin na file ay may mababang cache priority at maaaring ma-evict sa pagitan ng mga request.

Solusyon 1: Dedicated Gateway#

Ang dedicated gateway ay pribado para sa iyong account. Ang mga file na iyong pine-pin ay agad na ina-cache sa gateway na iyon — walang DHT lookup sa anumang request, malamig man o mainit.

# Dati: public gateway, mabagal at hindi maaasahan
curl https://ipfs.io/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

# Ngayon: dedicated gateway, mabilis at tiyak
curl https://my-app.gw.ipfs.ninja/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Lumikha ng gateway sa iyong IPFS.NINJA dashboard at itakda ang slug para tumugma sa iyong proyekto. Sinusuportahan ng gateway slugs ang restricted access mode (kailangan ng token) o open mode para sa mga public static asset.

Solusyon 2: I-pin sa Oras ng Pagsulat, Hindi Pagbabasa#

I-pin ang mga file sa sandaling nalilikha ang mga ito para mayroon na ang gateway bago pa humiling ang sinumang user. Ang pinakamabilis na request ay ang hindi kailanman nagdudulot ng cache miss.

# I-upload at i-pin sa iisang hakbang
curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "data": "BASE64_ENCODED_CONTENT",
      "type": "image/png"
    },
    "description": "Product hero image v2"
  }'

# Response — i-store ang CID, agad na i-serve ang url
# {
#   "cid": "bafy...",
#   "sizeMB": 0.24,
#   "uris": {
#     "ipfs": "ipfs://bafy...",
#     "url": "https://ipfs.ninja/ipfs/bafy..."
#   }
# }

Kung mayroon kang mga umiiral na CID mula sa ibang node o pinning service, muling i-pin nang hindi muling ina-upload:

curl -X POST https://api.ipfs.ninja/pin \
  -H "X-Api-Key: bws_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{"cid": "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi"}'

Tingnan ang kung paano mag-upload ng mga file sa IPFS para sa kumpletong API reference.

Solusyon 3: CDN sa Harap ng Iyong Gateway#

Naglilingkod ang mga dedicated gateway mula sa isang nakatakdang rehiyon. Kung ang iyong mga user ay kumakalat sa mga kontinente, magdagdag ng CDN edge layer para maglingkod mula sa pinakamalapit na point of presence.

Dahil ang IPFS ay content-addressed — ang isang ibinigay na CID ay palaging nag-reresolba sa magkaparehong bytes — maaari kang mag-cache magpakailanman:

Cache-Control: public, max-age=31536000, immutable

Halimbawa ng Cloudflare (saklaw ng libreng tier ang karamihan ng static-asset workloads):

1. Idagdag ang iyong gateway subdomain (my-app.gw.ipfs.ninja) bilang Cloudflare proxied CNAME.
2. Lumikha ng Page Rule: my-app.gw.ipfs.ninja/ipfs/* → Cache Everything, Edge Cache TTL: isang buwan.
3. Ang unang request ay tumatama sa gateway at ina-cache sa pinakamalapit na edge PoP. Lahat ng kasunod na request ay nagmumula sa Cloudflare.

Resulta: ang global TTFB ay bumaba mula 50–200 ms hanggang 10–50 ms.

Solusyon 4: Image Optimization API#

Ang mga raw IPFS image na inihahain sa buong resolution ay nagpapabagal ng mga pahina at nakakasama sa Core Web Vitals. Gamitin ang image optimization endpoint para mag-resize sa edge at maghatid ng mga modernong format:

# Orihinal (buong resolution sa pamamagitan ng gateway)
https://my-app.gw.ipfs.ninja/ipfs/bafy...

# Binago sa 800 px lapad, na-convert sa WebP
https://api.ipfs.ninja/image/bafy...?w=800&format=webp

# Square thumbnail
https://api.ipfs.ninja/image/bafy...?w=200&h=200&fit=cover

Sa React:

function IPFSImage({ cid, width }) {
  return (
    <img
      src={`https://api.ipfs.ninja/image/${cid}?w=${width}&format=webp`}
      width={width}
      loading="lazy"
      decoding="async"
    />
  );
}

Ina-cache ng optimization endpoint ang bawat kumbinasyong (cid, width, format) — ang mga kasunod na request na may parehong mga parameter ay tuluyang lumalaktaw sa origin.

Checklist#

• Lumipat mula sa mga public gateway patungo sa dedicated gateway
• I-pin ang nilalaman sa oras ng pagsulat (sa pag-upload), hindi sa pagbabasa
• Itakda ang Cache-Control: immutable sa mga gateway response
• Magdagdag ng CDN sa harap ng gateway para sa global traffic
• Ihain ang mga larawan sa pamamagitan ng optimization endpoint sa halip na raw gateway URLs

Para sa background kung bakit mahalaga ang pinning para sa availability — hindi lamang bilis — tingnan ang ano ang IPFS pinning.

Handa nang magsimulang mag-pin? Lumikha ng libreng account — 50 file, 1 GB storage, 2 GB bandwidth/buwan. Hindi kailangan ng credit card.

Tungkol sa artikulong ito: Ang artikulong ito ay isinulat ng isang AI assistant gamit ang content generation workflow ng IPFS.NINJA, pagkatapos ay sinuri at inaaprubahan ni Nacho Coll. Lahat ng halimbawa ng code ay napatunayan laban sa live IPFS.NINJA API. Kung mapansin mo ang isang hindi tumpak na impormasyon, mangyaring magbukas ng issue sa https://github.com/ipfs-ninja/feedback. Basahin ang higit pa tungkol sa kung paano namin ginagamit ang AI sa aming nilalaman at makilala ang mga taong nasa likod ng IPFS.NINJA.