파일/디렉터리를 CID(CIDv1 권장)로 식별. 동일 콘텐츠는 전 세계 어디서든 동일 CID.
IPFS (InterPlanetary File System)
콘텐츠 주소형(CID) 분산 파일 스토리지. 게이트웨이로 HTTP 접근, 핀닝(Pinning)으로 영속 보관, IPNS/DNSLink로 버전화 도메인 연결, 프라이빗 네트워크로 폐쇄망 운영까지 지원합니다. 요금은 별도문의로 안내합니다.
사설/공용 게이트웨이 제공. /ipfs/<CID>, /ipns/<name> 경로로 접근.
핀셋(Pinset) 관리, 보존 정책/삭제 보호, 핀 상태 모니터링 및 알림.
스웜 키(Swarm key)로 폐쇄망 구성, VPC/Subnet과 연동, 감사 로그(옵션).
주요 기능
| 영역 | 설명 | 비고 |
|---|---|---|
| CID / CAR | CIDv1(멀티베이스/멀티코덱) 및 CAR(콘텐츠 아카이브) 파일 업/다운로드 | 대용량 배포에 유리 |
| 게이트웨이 | 전용 도메인 바인딩, 캐시 TTL, Range 요청, 헤더 커스터마이즈 | 이미지/정적자산 배포 |
| IPNS / DNSLink | 가변 콘텐츠를 고정 이름으로 노출(IPNS), 도메인과 매핑(DNSLink) | 릴리스 롤링에 적합 |
| Pin 정책 | 보존 기간/버전 수/쿼터, 핀 실패 재시도, 가비지 컬렉션 스케줄 | 감사/알림 연동 |
| 클러스터 | IPFS Cluster로 수평 확장, 가중치/리플리카 카운트 | 멀티 AZ 권장 |
| 보안 | 프라이빗 스웜, API 토큰/서명 URL, 게이트웨이 ACL | 엔터프라이즈 옵션 |
참고 아키텍처(요약)
클라이언트 — 웹/모바일/서버가 HTTP API 또는 게이트웨이로 접근.
IPFS 노드 — add/pin/GC 처리, CID 인덱스, 블록스토어.
IPFS Cluster — 핀 복제/분산, 다중 노드 조정.
게이트웨이 — HTTP 변환, 캐싱, 헤더/도메인 커스터마이즈.
프라이빗 네트워크 — 스웜 키로 격리된 피어링, VPC/Subnet에 배치.
옵션 — 백업/스냅샷, 로그/감사, 모니터링/알림, Filecoin 연동(장기 저장).
예시: cURL
# 파일 업로드 → CID 반환 curl -X POST \ -H "Authorization: Bearer <API_TOKEN>" \ -F file=@logo.png \ https://ipfs.example.com/api/v0/add # CID 고정(Pin) curl -X POST \ -H "Authorization: Bearer <API_TOKEN>" \ "https://ipfs.example.com/api/v0/pin/add?arg=<CID>" # 게이트웨이로 다운로드 curl -L https://gw.example.com/ipfs/<CID> -o out.bin
예시: JavaScript (ipfs-http-client)
import { create } from 'ipfs-http-client';
const ipfs = create({ url: 'https://ipfs.example.com/api/v0', headers:{ Authorization:'Bearer <API_TOKEN>' } });
const { cid } = await ipfs.add(new Blob(['hello ipfs']));
await ipfs.pin.add(cid);
const text = await (await fetch(`https://gw.example.com/ipfs/${cid}`)).text();
console.log(cid.toString(), text);
게이트웨이 / URL 규칙
| 형식 | 예시 | 설명 |
|---|---|---|
| 패스 기반 | https://gw.example.com/ipfs/<CID>/path | 가장 일반적인 접근 방식 |
| 서브도메인 기반 | https://<CID>.ipfs.gw.example.com | 브라우저 캐시/쿠키 분리 유리 |
| IPNS | https://gw.example.com/ipns/<NAME> | 가변 콘텐츠에 사용 |
| DNSLink | _dnslink.example.com → dnslink=/ipfs/<CID> | 사용자 도메인 연결 |
운영/보안 정책(요약)
| 영역 | 정책 | 비고 |
|---|---|---|
| 핀 보존 | 기본 무기한, 버전 수 제한/보존기간 정책 구성 | 초과분 GC |
| 액세스 | 프로젝트 토큰, 게이트웨이 ACL, 서명 URL(옵션) | IP 허용목록 지원 |
| 프라이빗 | 스웜 키로 격리, 사내망/VPN 전용 | VPC/Subnet 연동 |
| 모니터링 | 핀 상태/복제도/게이트웨이 RPS, 지연 p95, 오류율 | 알림 연동 |
| 로깅 | API/게이트웨이 접근 로그, 감사 로그(옵션) | 보관기간 선택 |
요금 안내
요금: 별도문의
게이트웨이 트래픽/요청 수, 핀 용량/복제본, 프라이빗 네트워크/클러스터 옵션, 로그/보관 기간에 따라 산정됩니다.
IPFS로 콘텐츠 배포와 보존을 단순하게
요건(CID/게이트웨이/핀 정책)을 알려주시면 최적 구성을 제안드려요.