HANDOFF — Harbor 部署工程交接快照

2026-10-08 压缩（稳定层拆分到 docs/BASELINE.md）｜目标 ≤7 KB / 触发 11.5 KB / 上限 12 KB 路径一律相对本工程根（services/harbor/）；历次变更档案：upstream-direct-20261001/SOP.md、probe_batch_20261008/SOP.md

1. 这份文件怎么用

• 交接快照：由 SessionStart Hook 在会话开始时注入一次，回答「现在是什么状态、下一步做什么」；只写当前，不记历史（历史归各主题 SOP.md）。
• 档位：【已确认】有实测证据 / 【未验证】未经证实 / 【待决策】未定论。
• 环境事实、机制陷阱、命令速查、文档地图在 BASELINE.md（稳定层）。
• 本工程是工具工程，服务跑在远端；日常运维看 ../../k8s_ins/ghcr-slow-20261001/RUNBOOK.md。

2. 当前状态与在做什么

一句话：Harbor v2.15.2 已在 192.168.31.31 部署并接入 4 台 k8s 节点；上游出网走默认路由（旁路由 Clash），存量镜像预热 58 条中 57 条入库；接入写法失效问题已修复，A1~A7 验收全部通过。

• 【已确认】只读探测批量化（2026-10-08，C 类）：precheck.run_all 由「每台 harbor 主机 ~11 次独立往返」改为「每台一条 shell 一次取回」（复用共享库 precheck_module 的 static_probes 扩展点 + build_probe_shell）。实测命令数 20 → 5、墙钟 8.44 → 7.52 s、报告 34 条 INFO 逐条一致。档案：probe_batch_20261008/SOP.md；坑（探测命令须换行结尾）见 BASELINE §2。
• 【已确认】切回默认路由（2026-10-01，C 类）：隧道由「加速」变「瓶颈」（家宽直连香港丢包 13.3%），改走默认路由；代价是上游流量消耗机场订阅。依据、预热数据与 A1~A7 证据见 upstream-direct-20261001/SOP.md。

3. 未完成事项

#	事项	下一步	在哪能拾起
4	minio 镜像源侧不可得	已离线归档：/data/offline-images/minio-RELEASE.2025-04-22T22-12-26Z.tar（62 MB，含 README 台账与 sha256）；节点丢失时 ctr -n k8s.io images import 恢复	upstream-direct-20261001/SOP.md §6
5	Harbor 升级路径未演练	改 version/release_url/offline_sha256 后重跑 deploy-harbor；升级前手工备份数据库	../../k8s_ins/ghcr-slow-20261001/HARBOR-RESULT.md §9 遗留项 5
6	监控未接（R8）	按既有 textfile → node_exporter:9100 路线	同上，§9 遗留项 7
7	隧道代码保留未删【待决策】	是否长期保留该能力由用户决定；enabled: true + 重跑即可重建	upstream-direct-20261001/SOP.md §7.3

编号沿历史（#1–#3 为 A1~A7 验收 / A6 回滚实测 / A3 Pod 快照，均已完成，正文见 ../../k8s_ins/ghcr-slow-20261001/HARBOR-RESULT.md §6）。

4. 红线

• 凭据：Harbor admin 口令与 DB 口令在 192.168.31.31:/root/.secrets/（700，文件 600）；API 凭据走 harbor.netrc。不入工程目录、不入文档、不打终端。
• 节点侧接入仅新增文件：禁止改 /etc/containerd/config.toml、禁止重启 containerd。
• 机制类禁忌（hosts.toml 写法、接入判定证据、批量探测换行、容器重建与预热前置、勿手改远端文件、probe.sh 同步）见 BASELINE.md §2。

5. 指针

内容	路径
稳定层（环境事实 / 陷阱 / 命令速查 / 文档地图）	BASELINE.md
变更备份台账	docs/backup/README.md
本轮变更实施 / 验证 / 回滚	probe_batch_20261008/SOP.md、upstream-direct-20261001/SOP.md
结果回填 / 日常运行 / 需求规格	../../k8s_ins/ghcr-slow-20261001/{HARBOR-RESULT,RUNBOOK,HARBOR-HANDOFF}.md
项目级状态快照	../../k8s_ins/docs/HANDOFF.md

---

来源：/home/rain/Documents/services/harbor/docs/HANDOFF.md ｜ 最后更新：2026-10-08 13:28（由 build/sync.py 同步，请勿在站点侧修改）