P2P 与分布式存储 / 系统课时
验证重启后 CID 仍然可取
验证重启后 CID 仍然可取
节点重启后文件可读,只有在确认仓库和来源一致时才有意义。本节以停机后的离线读取为核心,排除网络补齐和误用另一仓库,让“跨重启保留”成为一项有范围的验收结论。
学习目标
- 在同一练习仓库上核对停机前后的根与内容。
- 区分进程重启通过和硬盘故障恢复通过。
先固定节点和原件
前置环境是 Bash、Kubo 0.43.1,以及专用练习仓库;不要对业务 daemon 执行 shutdown。下面每次生成新仓库,把路径记录在练习目录。使用同一 Kubo 版本避免把仓库升级与普通重启混在一项测试里。
真实重启本节未执行。终端甲负责 daemon,终端乙负责命令;启动日志出现 ready 后才能调用 API。若本机默认端口被其他节点占用,应停止本练习并按 ipfs daemon --help 与配置安排专用端口,不能借用生产 API 冒充成功。
准备内容并启动节点
在终端乙运行下列准备命令。work 的实际路径需复制给终端甲,环境变量只在当前终端有效。
set -euo pipefail
work="$(mktemp -d)"
export IPFS_PATH="$work/repo"
ipfs init > /dev/null
printf 'restart-retention\n' > "$work/original.txt"
ipfs --offline add -Q "$work/original.txt" > "$work/root.cid"
printf '%s\n' "$work"预期输出:
<WORK_PATH>终端甲设置同一个路径并运行前台 daemon。下列为片段示例,必须把 REPLACE_WITH_WORK_PATH 换成刚记录的绝对路径。
export IPFS_PATH='REPLACE_WITH_WORK_PATH/repo'
ipfs daemon --offline预期结果:
daemon输出本地API地址与启动完成信息,实际日志随版本和配置变化停机期间完成读取核对
等 daemon 就绪后,在保留 work 的终端乙执行。停机后等待终端甲退出,再运行离线命令;不能让两个进程同时直接打开同一仓库。
cid="$(cat "$work/root.cid")"
ipfs pin ls --type=recursive "$cid"
ipfs shutdown
# 确认终端甲的daemon已退出,再继续下列三行。
ipfs --offline cat "$cid" > "$work/restored.txt"
cmp "$work/original.txt" "$work/restored.txt"
printf 'offline restore passed\n'预期结果:
<CID> recursive
offline restore passedshutdown 的具体提示不作为验收依据,进程退出才是关键。随后在终端甲用同一条命令再次启动;终端乙重复 pin ls 与完整恢复比对。这两轮分别证明停机磁盘可读和再次启动后可读,应分开记录时间及退出码。
如果采用系统服务启动 daemon,还应核对服务账户和工作目录中的环境设置。交互终端的变量不一定传入服务进程;正确路径应写在服务配置里,并以实际节点身份和仓库位置核对,而不是只看服务显示正在运行。
停机窗口内保留原件、根清单和启动日志,不做取消 Pin 或 GC。这样失败时可以比较两轮之间唯一改变的因素,避免把并行清理导致的缺块误归因于重启。
边界和失败定位
重启后清单为空,先查运行用户、IPFS_PATH 和服务启动配置。离线读取失败而在线成功,说明外部获取掩盖了本地缺口;Pin 类型正确也不能替代块完整性检查。遇到仓库锁,不应直接删除锁文件,要确认打开仓库的进程已正常退出。
正常重启不是断电或磁盘损坏演练,不证明独立备份有效。练习为报告追加“未执行硬件故障”范围,并规划另一仓库恢复验证。启动与停机命令依据见Kubo CLI,本课操作需由读者在真实环境完成验收。