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> 访问（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 网关，如 ipfs.io 或 dweb.link。要通过我们的网关提供第三方 CID，请先免费注册，并先对您的账户执行 POST /pin。

TIP

您的文件也可以通过任何公共 IPFS 网关（例如 dweb.link、w3s.link）使用相同的 CID 访问 — 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），防止浏览器执行所提供内容中的脚本。