市面上的 IPFS 教程多以零散文章形式出现，但生产场景下需要的是体系化能力。本文按主题排布，给出一份「完整教程」的章节目录与学习要点。
第一章：协议原理
这一章重点理解 IPFS 的三大核心机制：内容寻址、Merkle DAG、DHT。内容寻址解决了「同样内容同一 CID」的特性；Merkle DAG 把任意数据结构化成树状哈希；DHT 则负责在 P2P 网络中查找内容。
配合 BNB链是什么 中对去中心化网络的讨论，可以把这些概念串联起来，建立完整心智模型。这一章重点是理解，不需要写代码。
第二章：Kubo 节点运维
第二章进入实操：Kubo 的安装、初始化、守护进程、参数调优。重点理解 ipfs config 中常用的字段：Datastore、Swarm、Gateway、Reprovider。
参考 Geth实战教程 中关于 systemd 与日志聚合的写法，把 Kubo 也部署成生产级服务。注意监控指标的采集：peer 数、bandwidth、pin 数、Gateway 响应时间。
第三章：Pinning 与持久化
第三章介绍持久化方案。重点掌握：本地 pin、IPFS Cluster、第三方 Pinning Service。建议至少为关键 CID 准备三份副本：自家 Cluster、Pinata/Web3.Storage、团队成员本地。
配合 BNB链最佳实践 中的多源备份建议，把 CID 的可用性当作系统级关键指标。如果业务还需要与中心化交易所如 Binance 或 币安 的链上数据对账，建议把 CID 与交易 hash 做对应表。
第四章：网络与安全
第四章覆盖端口隔离、TLS、ACL、密钥管理。Kubo 默认监听 4001/5001/8080，生产环境必须收紧并加 ACL。配合 Solana程序安全审计 中的密钥保护建议，让节点的安全水位达到企业级。
这一章还要建立 Runbook：遇到攻击或异常时的响应流程、断网、取证、对外公告。提前演练比事后慌乱更有效。
第五章：应用层落地
第五章把 IPFS 与业务结合。常见场景：NFT 元数据、白皮书与法律文件、社区论坛去中心化、跨链消息存证。每个场景都要做权衡：是否需要加密、是否需要审核、是否需要赎回。
配合 BNB链最佳实践 中关于业务可观测性的设计，让应用层与基础层共享同一套监控体系。
第六章：源码阅读与社区贡献
最后一章鼓励团队读源码、贡献社区。重点仓库包括 ipfs/kubo、ipfs/helia、libp2p。每周读一个 PR、每月写一篇内部分享，能让团队的技术深度持续提升。
参考 Solana程序GitHub 中关于「按主题打 tag」的思路，把 IPFS 的开源阅读也做成长期计划。
教程使用建议
这份目录不是一周能消化完的，建议团队按月推进。每完成一章做一次内部复盘，把疑问与坑点写进 wiki。三到六个月后，团队就能在 IPFS 领域形成完整的能力体系，足以应对各类去中心化存储需求。