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으로 클러스터에 피닝하여 지속적인 가용성을 보장하세요 (swarm-connect 힌트 지원)
• 게이트웨이를 통한 접근 — 모든 피닝된 콘텐츠는 ipfs.ninja/ipfs/<CID>에서 접근 가능합니다 (apex 게이트웨이는 귀하의 계정이나 다른 IPFS Ninja 계정의 CID만 제공합니다 — 아래 게이트웨이 액세스 참조)
• 사용자 정의 메타데이터 — 업로드 및 피닝에 키-값 쌍을 첨부하여 정리 및 필터링에 활용하세요
• 서명된 업로드 토큰 — API 키를 노출하지 않고 클라이언트 측 업로드를 위한 시간 제한 토큰을 생성하세요
• IPNS 가변 이름 — IPNS API를 통해 변경되는 CID를 가리키는 안정적인 이름을 생성하세요 (계정당 최대 10개)
• 이미지 최적화 — 게이트웨이 URL 매개변수를 사용하여 이미지를 실시간으로 리사이즈, 변환, 압축하세요

대시보드

개인 대시보드에서 업로드, 저장 공간, 게이트웨이 대역폭을 추적하세요. 대시보드를 사용하면 코드 작성 없이도 API 대부분을 활용할 수 있습니다:

• 드래그 앤 드롭 업로드 — 파일, 폴더(브라우저에서 UnixFS 디렉터리로 패키징됨), 또는 .car 아카이브
• 업로드 후 파일 이름 변경; 선택 시 파일 이름에서 설명이 자동으로 채워짐
• 폴더를 스냅샷하여 내부 전체에 대한 단일 디렉터리 CID 얻기
• 폼 편집기를 통해 버킷별 S3 CORS 구성 (브라우저 SDK 통합용)
• API 키, 게이트웨이 토큰, IPNS 이름, 전용 게이트웨이 설정 관리

게이트웨이 접근

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

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

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

apex 게이트웨이 범위

https://ipfs.ninja/ipfs/<CID>의 apex 게이트웨이는 등록된 IPFS Ninja 사용자가 업로드하거나 고정한 CID만 제공합니다. 다른 CID에 대한 요청은 HTTP 410 Gone을 반환하고 ipfs.io 또는 dweb.link 같은 공개 IPFS 게이트웨이에 대한 포인터를 제공합니다. 타사 CID를 당사 게이트웨이를 통해 제공하려면 무료로 가입하고 먼저 계정에 POST /pin을 수행하세요.

TIP

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

모든 유료 플랜은 자체 서브도메인(<slug>.gw.ipfs.ninja)에서 계정에 피닝된 파일만 제공하는 전용 게이트웨이를 받으며, 선택적 토큰 기반 접근 제어 및 오리진 제한을 사용할 수 있습니다. 프로덕션 임베딩(동영상, NFT 뷰어, 웹사이트)에는 전용 게이트웨이 URL을 사용하는 것이 좋습니다.

지원되는 파일 유형

유형	형식	입력
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)가 포함되어 브라우저가 제공된 콘텐츠 내의 스크립트를 실행하는 것을 방지합니다.