IPFS 게이트웨이

기존 웹과 IPFS 네트워크 사이의 다리 역할입니다.

게이트웨이란 무엇인가요?

IPFS 게이트웨이는 표준 웹 요청을 IPFS 프로토콜 요청으로 변환하는 HTTP 서버입니다. 브라우저, 앱, 스크립트가 IPFS 노드를 실행하지 않고도 IPFS 콘텐츠에 접근할 수 있게 해줍니다 — 일반 URL만 사용하면 됩니다.

https://ipfs.ninja/ipfs/<CID>

이 URL을 요청하면, 게이트웨이가 IPFS 네트워크(또는 캐시)에서 콘텐츠를 가져와 표준 HTTP 응답으로 반환합니다.

퍼블릭 게이트웨이 vs. 전용 게이트웨이

특징	퍼블릭 게이트웨이	전용 게이트웨이
URL	ipfs.ninja/ipfs/...	<slug>.gw.ipfs.ninja/ipfs/...
제공 콘텐츠	네트워크의 모든 CID	피닝된 CID만
인증	없음	선택 사항 (토큰, IP 화이트리스트)
플랜	모든 플랜	모든 플랜 (제한 다름)

게이트웨이의 콘텐츠 해석 방법

1. ipfs.ninja/ipfs/QmXk7...를 요청합니다
2. 게이트웨이가 로컬 캐시를 확인합니다 — 파일이 캐시되어 있으면 즉시 반환합니다
3. 캐시에 없으면 게이트웨이가 IPFS DHT를 쿼리하여 CID를 가진 노드를 찾습니다
4. 게이트웨이가 가장 가까운 가용 노드에서 파일을 다운로드합니다
5. 파일을 로컬에 캐시하고 HTTP 응답으로 반환합니다

기타 퍼블릭 게이트웨이

IPFS는 퍼블릭 네트워크이므로, 파일은 우리의 게이트웨이뿐만 아니라 모든 IPFS 게이트웨이를 통해 접근할 수 있습니다. 일반적인 퍼블릭 게이트웨이는 다음과 같습니다:

• dweb.link/ipfs/<CID> — Protocol Labs
• w3s.link/ipfs/<CID> — Storacha (Web3.Storage)
• cloudflare-ipfs.com/ipfs/<CID> — Cloudflare