IPFS Ninja

이미지, PDF, JSON 파일을 간편하게 IPFS에 업로드하고, 영구 콘텐츠 식별자(CID)를 받아 게이트웨이를 통해 즉시 접근하세요.

IPFS란 무엇인가요?

InterPlanetary File System (IPFS)은 탈중앙화된 피어투피어 저장 프로토콜입니다. IPFS는 파일을 작은 청크로 나누어 네트워크 전체에 분산하고, 파일 내용에 기반하여 각 파일에 고유한 **콘텐츠 식별자(CID)**를 부여합니다.

이는 다음을 의미합니다:

• 분산 저장 — 파일이 여러 노드에 저장되어 안정성이 향상됩니다.
• 콘텐츠 주소 지정 — CID는 파일 내용 자체에서 파생되어 불변성을 보장합니다.
• 네트워크 전체 접근 — CID를 가진 사람은 누구나 모든 IPFS 노드에서 파일을 가져올 수 있습니다.

IPFS Ninja가 하는 일

IPFS Ninja는 간단한 REST API를 통해 파일을 업로드하고 IPFS의 기존 콘텐츠를 피닝할 수 있는 관리형 서비스입니다. 자체 IPFS 노드를 운영할 필요가 없습니다.

• 새 파일 업로드 — POST /upload/new로 모든 파일을 전송하고 영구 CID를 받으세요
• 기존 CID 피닝 — IPFS에 이미 콘텐츠가 있으신가요? POST /pin으로 클러스터에 피닝하여 지속적인 가용성을 보장하세요
• 게이트웨이를 통한 접근 — 모든 피닝된 콘텐츠는 ipfs.ninja/ipfs/<CID>에서 접근 가능합니다
• 사용자 정의 메타데이터 — 업로드 및 피닝에 키-값 쌍을 첨부하여 정리 및 필터링에 활용하세요
• 서명된 업로드 토큰 — API 키를 노출하지 않고 클라이언트 측 업로드를 위한 시간 제한 토큰을 생성하세요
• IPNS 가변 이름 — IPNS API를 통해 변경되는 CID를 가리키는 안정적인 이름을 생성하세요 (계정당 최대 10개)
• 이미지 최적화 — 게이트웨이 URL 매개변수를 사용하여 이미지를 실시간으로 리사이즈, 변환, 압축하세요

대시보드

개인 대시보드에서 업로드, 저장 공간, 게이트웨이 대역폭을 추적하세요.

게이트웨이 접근

업로드된 모든 파일은 IPFS Ninja 게이트웨이를 통해 접근할 수 있습니다. 이 게이트웨이는 탈중앙화된 IPFS 네트워크와 기존 웹 브라우저 사이의 다리 역할을 합니다.

게이트웨이 URL은 다음 패턴을 따릅니다:

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

TIP

파일은 동일한 CID를 사용하여 모든 공개 IPFS 게이트웨이(예: dweb.link, w3s.link)에서도 접근할 수 있습니다 — IPFS 네트워크는 탈중앙화되어 있습니다.

Nirvana 플랜 사용자는 자체 서브도메인(<slug>.gw.ipfs.ninja)에 전용 게이트웨이를 받으며, 자신의 계정에 피닝된 파일만 제공합니다 — 선택적 토큰 기반 접근 제어 및 오리진 제한을 사용할 수 있습니다.

지원되는 파일 유형

유형	형식	입력
JSON	모든 유효한 JSON 객체 또는 배열	string / object
이미지	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	표준 PDF 문서	base64
HTML	HTML 문서	base64
모든 파일	모든 파일 (바이너리, 텍스트, 비디오 등)	base64

모든 파일 유형이 허용됩니다. 유형은 자동으로 감지되어 참조용으로 기록됩니다.

보안

게이트웨이 응답에는 보안 헤더(Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY)가 포함되어 브라우저가 제공된 콘텐츠 내의 스크립트를 실행하는 것을 방지합니다.

크기 제한

제한	값
요청당 최대 페이로드	6 MB (API Gateway 제한)
총 저장 공간 (Dharma)	1 GB
총 저장 공간 (Bodhi)	10 GB
총 저장 공간 (Nirvana)	100 GB

사용 사례

NFT 메타데이터 및 자산

영구적이고 불변인 CID로 NFT 메타데이터 JSON과 관련 이미지를 저장하세요.

정적 리소스 호스팅

웹 및 모바일 애플리케이션을 위한 이미지, 문서, 데이터 파일을 호스팅하세요.

검증 가능한 데이터 공유

콘텐츠 주소 지정 기반 출처 증명으로 데이터를 공유하세요 — 수신자는 데이터가 변조되지 않았음을 확인할 수 있습니다.