🌐 IPFS 静态网站部署指南

本指南详细介绍了如何像访问普通网页一样访问 IPFS 文件，以及如何利用 IPFS 建立自己的静态网站。

1. 如何像访问 HTML 页面一样访问 IPFS 文件？

要像访问普通网页一样访问 IPFS 上的 HTML 文件，核心在于使用网关（Gateway）。

什么是网关？

浏览器原生通常只支持 http(s):// 协议，不支持 ipfs:// 协议。网关充当了“翻译官”的角色，它去 IPFS 网络抓取内容，然后通过 HTTP 协议传输给浏览器。

访问格式

https://<网关地址>/ipfs/<你的文件CID>/index.html

常用公共网关

• 官方网关: https://ipfs.io/ipfs/<CID>
• Cloudflare 网关: https://cloudflare-ipfs.com/ipfs/<CID>
• 其他网关: https://dweb.link/ipfs/<CID>

2. 如何用 IPFS 建立静态网站？

建立 IPFS 静态网站主要分为三个步骤：准备文件、上传 Pin、以及解决更新问题。

第一步：准备网站文件

确保你的项目包含一个入口文件（通常是 index.html）。在 IPFS 中，如果访问的是一个目录，系统会自动寻找并加载 index.html。

第二步：上传并 Pin（固定）

你可以使用以下工具将文件上传到 IPFS 网络：

• Pinata: 知名的第三方 Pinning 服务，提供 API 和网页端上传。
• 本地节点: 使用命令行 ipfs add -r ./your-website-folder。
• 第三方工具: 如 Fleek、Netlify（支持 IPFS 部署）。

第三步：解决网站更新问题（IPNS）

痛点： IPFS 的地址（CID）是基于内容哈希生成的。内容一变（比如修改了网页标题），CID 就会变，你的链接就失效了。

解决方案： 使用 IPNS（星际命名系统）。

IPNS 就像一个“快捷方式”。你可以用一个不变的 IPNS 地址（公钥哈希）指向不断变化的 IPFS CID。

操作流程：

1. 生成密钥对（公钥和私钥）。
2. 使用命令 ipfs name publish <新内容的CID> 发布。
3. 以后更新网站，只需重新 publish，访问者通过固定的 IPNS 地址即可获取最新内容。