P2P 与分布式存储 / 系统课时
跨节点复制内容并校验可取回
跨节点复制内容并校验可取回
本课使用三个独立 Kubo 节点完成一次副本可用性实验:节点 A 导入文件,节点 B 获取并固定相同内容,随后停止节点 A,由节点 C 从节点 B 重新取回文件。通过逐步验证 CID、固定状态、提供者发现与文件字节,判断副本是否真正具备独立服务能力。
学习目标
- 在不同 Kubo 节点间复制内容,区分下载成功与持久保留。
- 停止原始提供节点后,验证另一个节点是否能独立提供内容。
- 根据提供者记录、网络连通性和仓库状态定位取回失败原因。
准备三个独立的 Kubo 节点
实验使用 Kubo CLI,适用于支持 ipfs init、ipfs daemon、ipfs add、ipfs get 和 ipfs pin 的 Kubo 0.3x 系列。三个节点分别命名为 A、B、C,建议运行在三台能够相互访问的测试主机上,每台使用独立仓库和 Peer ID。
| 节点 | 职责 | 实验要求 |
|---|---|---|
| A | 初始内容提供者 | 导入文件,随后停止守护进程 |
| B | 独立副本提供者 | 下载、固定并继续在线 |
| C | 验证客户端 | 不预先保存目标内容,重新从网络获取 |
每台主机安装 Kubo 后,在各自终端执行:
ipfs init
ipfs daemon预期结果:首次初始化创建本地仓库,随后守护进程启动并显示类似信息:
Daemon is readyipfs init 只需在空仓库上执行一次。已初始化的节点不要重复初始化。守护进程保持运行,后续命令在同一主机的另一个终端执行。
在 A、B、C 上分别运行:
ipfs id -f='<id>\n'预期输出:每台主机显示自己的 Peer ID,实际值不同。
<ID>实验应确保三个 Peer ID 不同。若使用同一台机器模拟多个节点,必须设置不同的 IPFS_PATH、API 监听地址和 Swarm 监听端口,不能让多个进程共用一个仓库。为验证真正的网络副本,优先使用独立主机,并确认 B 与 C 能连接同一个 IPFS 网络。
从初始节点复制内容到副本节点
先在节点 A 创建确定的测试文件。使用 printf 避免不同编辑器自动添加换行造成 CID 差异。
printf 'ipfs replica test\n' > replica.txt
ipfs add --cid-version=1 replica.txt预期输出格式如下,CID 以实际结果为准:
added <CID> replica.txt记录这个 CID。默认情况下,ipfs add 会固定导入的内容,使 A 的仓库保留对应数据。CID 标识内容及其编码结构,不表示内容当前存放在哪台机器上。
在节点 B 上,先确认能够发现或连接 A,再使用 A 产生的真实 CID 执行下载。以下 <CID> 是需要替换的占位符。
ipfs get <CID> -o replica-copy.txt
ipfs pin add <CID>
ipfs pin ls <CID> --type=recursive预期结果:B 生成 replica-copy.txt,固定命令成功,最后一条命令显示对应 CID 的递归固定记录,格式类似:
<CID> recursive如果内容尚未通过公共路由发现,可在 B 上使用 A 的实际可达多地址主动连接:
ipfs swarm connect /ip4/<IP>/tcp/<PORT>/p2p/<PEER_ID>预期输出格式:
connect <PEER_ID> success其中 <IP>、<PORT>、<PEER_ID> 分别替换为 A 的真实监听地址、端口和 Peer ID;这些值因部署环境而异。连接成功不代表已经下载内容,仍需完成 ipfs get 和固定验证。
这里有两个不同的保存动作:ipfs get 将内容导出为普通文件;ipfs pin add 则让 Kubo 仓库保留 CID 对应的块及其可达子块。普通文件即使存在于 B 的文件系统,也不会自动成为 B 可通过 IPFS 提供的仓库内容。

停止节点 A 并让 B 独立提供内容
确认 B 已成功固定内容后,在 A 的守护进程终端按 Ctrl+C,等待进程退出。不要删除 A 的仓库,因为本实验只验证原始节点离线后的服务能力,而非数据销毁。
在 B 上检查固定记录与在线状态:
ipfs pin ls <CID> --type=recursive
ipfs id -f='<id>\n'预期结果:第一条命令仍能显示 <CID> recursive,第二条命令显示 B 自己的 Peer ID,而不是 A 的 Peer ID。
B 持有内容并不意味着 C 一定能发现 B。Kubo 需要通过内容提供者记录或其他路由机制让检索节点找到可用提供者。新下载的内容可能需要一定时间才能被其他节点通过路由发现;提供者记录的发布、传播和重新发布不是瞬时完成的。
在 B 上执行以下命令,主动请求向路由系统提供该 CID:
ipfs routing provide <CID>预期结果:命令成功结束;具体是否打印信息以及路由传播时间取决于 Kubo 版本和路由配置。此操作不替代固定,B 仍必须保存对应块并保持可连接。
从全新节点 C 验证内容可取回
节点 C 不应预先导入、固定或下载目标 CID。先确认 A 已离线、B 仍在线,再从 C 查询提供者:
ipfs routing findprovs <CID>预期结果:当路由发现成功时,结果包含可用提供者信息,其中应能识别 B 的 Peer ID。不同版本的输出格式可能不同;没有返回结果并不直接证明 B 未保存内容,也可能是路由尚未传播或当前路由模式不支持该查询。
接着在 C 上执行真正的内容获取:
ipfs get <CID> -o recovered.txt
cat recovered.txt预期输出:下载成功后,cat 打印 A 最初写入的完整文本。
ipfs replica test仅看到提供者 Peer ID 还不够。findprovs 验证路由层的发现能力,ipfs get 才会触发块获取、CID 对应的内容验证及文件重建。若 C 下载成功且 A 确认离线,就证明本次实验存在一条不依赖 A 在线的数据获取路径。
为避免把内容相同误判为文件相同,可在 A 恢复可用后与 C 分别计算文件的 SHA-256;也可以事先记录 A 的校验值,再与 C 比较。
sha256sum replica.txt在 C 上执行:
sha256sum recovered.txt预期结果:两条命令输出的 64 位十六进制摘要一致,后面的文件名分别为 replica.txt 和 recovered.txt。实际摘要由文件字节决定,不需要预先硬编码。
失败时区分副本、路由与连接问题
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| B 无法列出递归固定 | 内容未成功固定或 CID 错误 | 重新获取正确 CID 并执行 ipfs pin add |
| C 查不到 B | 提供者记录尚未传播或路由不可用 | 检查 B 在线状态,重新发布提供者记录并等待传播 |
| C 找到 B 但无法下载 | B 的连接地址、NAT、防火墙或块可用性 | 检查 Swarm 连接和 B 的本地块读取 |
| C 下载成功但文件内容不符 | 使用了错误 CID 或比较了不同文件 | 重新核对 CID 和 SHA-256 摘要 |
当路由发现失败时,可在 C 上尝试直接连接 B 的已知可达多地址,再重新执行 ipfs get。如果直连成功而普通检索失败,优先调查提供者发现或地址发布,而不是立即认定副本损坏。
在 B 上还可以执行:
ipfs cat <CID>预期输出:
ipfs replica test如果 B 本地读取也失败,说明应先修复本地内容保存问题;如果 B 本地读取成功而 C 无法获取,则应优先检查节点连接和路由。
实验通过的验收条件是:A 已停止、B 保留递归固定且在线、C 之前没有目标内容、C 成功获取原始 CID 并重建出 SHA-256 一致的文件。只有同时满足这些条件,才能把结果视为一次有效的独立副本可用性验证。