IPFS图文教程 - IPFS图文教程：节点安装、上传与CID检索的全步骤截图说明

用清晰的图文步骤拆解IPFS节点安装、内容上传、CID检索与Gateway访问的完整流程，新人按截图操作即可在本机跑通去中心化存储。

图文教程是新手最容易吸收的形式，能随时停下来对照截图操作。本文按操作顺序，给出 IPFS 从安装到使用的完整图文流程。

第一步：选择部署平台与安装包

推荐在 Ubuntu 22.04 或 macOS 上部署 Kubo。访问官方仓库 ipfs/kubo 的 Releases 页面，下载对应平台的二进制压缩包。Windows 用户可以选择 WSL2 模式，避免一些路径问题。

配合 BNB链是什么中介绍的网络分层概念，可以提前理解 IPFS 节点在系统拓扑中的位置：它既不是「服务器」，也不是「客户端」，而是 P2P 节点。

解压后将 ipfs 二进制放到 /usr/local/bin，执行 ipfs init。终端会输出节点 PeerID 与一段欢迎信息。请把 PeerID 记录到自己的笔记里，未来在排查问题时会用到。

启动守护进程：ipfs daemon。如果一切顺利，终端会显示监听的 API 端口（5001）与 Gateway 端口（8080）。这一步如果报错，多半是端口冲突或权限问题，参考 Geth常见错误中提到的端口排查思路通常能解决。

在另一个终端窗口执行 ipfs add hello.txt，得到一串 CID。把这个 CID 复制到浏览器，访问 http://localhost:8080/ipfs/，就可以下载到刚才上传的文件。整个过程不到 10 秒。

如果你想把这个文件通过中心化交易所如 Binance 或币安的链上记录做存证，可以把 CID 当作字符串写进合约，未来根据 CID 还原内容。

默认情况下 Kubo 节点重启后非 Pin 内容可能被 GC 回收。要永久保留，执行 ipfs pin add 。配合 BNB链最佳实践中关于多副本的设计，建议至少同步到一个第三方 Pinning Service。

你可以注册 Pinata 账号，复制 API Key 后通过 curl 或 SDK 同步上传。完成后 CID 在两个不同服务下均可访问，可靠性显著提升。

生产场景下，通常会把自家 Gateway 暴露到公网，并加 TLS。可以使用 Caddy 或 Nginx 反向代理 8080 端口，加上自家域名。配合 Solana程序部署教程中提到的反向代理写法，可以把这一步标准化。

如果不希望搭建自家 Gateway，可以直接使用 ipfs.io、Cloudflare、dweb.link 等公共 Gateway。注意公共 Gateway 偶尔会限制速率，对生产场景不太合适。

常见问题包括：daemon 启动失败、CID 不通、上传超大文件卡死。每一类问题都对应固定的排查动作：检查日志、检查端口、检查磁盘、检查 peer。把这些步骤整理成自家 Runbook，遇到事故可以照搬。

按以上图文步骤操作，新人通常可以在一个小时内跑通 IPFS 的完整流程。后续就可以围绕业务场景做更深入的探索。