IPFS Ninja

轻松将图片、PDF 和 JSON 文件上传到 IPFS，获取永久内容标识符 (CID)，并即时通过网关访问。

什么是 IPFS？

星际文件系统 (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

您的文件也可以通过任何公共 IPFS 网关（例如 dweb.link、w3s.link）使用相同的 CID 访问 — 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 和相关图片。

静态资源托管

为 Web 和移动应用托管图片、文档和数据文件。

可验证的数据共享

通过内容寻址的来源证明分享数据 — 接收者可以验证数据未被篡改。