homelab-wiki/verification.md

待核实与文档缺口

审阅日期：2026-09-16；初版依据工作区，SPIFFE/SPIRE 已按维护者指定补读 #34 与 runbook，未查询现场。 下面的检查方法只是候选步骤，执行前先问维护者当前进度及查询范围。 以下路径相对于 homelab-infra。优先修复影响恢复、认证、DNS 和首次使用的问题。

已对齐的动态工作

SPIFFE/SPIRE 按维护者指定，以 #34 记录为主要依据：基础设施与最小 OpenBao PoC 已完成，issue 保持 open 跟踪后续集成。 已合并的 runbook 也包含新 workload 接入和运维说明，不能再标记为“缺接入指南”。 原工作区集群总览的“首次上线待验证”不作为当前阶段判断。 详见 SPIFFE/SPIRE 使用入口与阶段状态；源码工作区本轮未修改。

待向维护者确认的记录差异

项目	两边的记录	核实与收敛方式
LAN DNS	apps/blocky/README.md 说已是主 DNS；infrastructure/dns/README.md 仍说未成为正式 resolver	读取 NEC DHCP 配置、客户端 DNS 和 Blocky 查询结果，再同步两份说明
Authelia	README 仍描述 OIDC 为后续阶段、旧 Contour/Traefik 路径；退役记录和 Envoy 文档已描述 Authelia 替代旧 IdP	核对 OIDC discovery、登录及 forward-auth，重写过时段落；迁移旧文档前检查其中的敏感示例
microVM runner	infrastructure/microvm-runner/README.md 说 PoC 完成但正式启用仍有前提；远端已有独立 runner 仓库	查清两个仓库的职责、controller/worker 部署和一次 job 生命周期，不能把仓库存在当作服务已启用
NATS durable 名称	NATS 文档示例为 kind-microvm-pve2；microVM 文档配置为 kind-microvm，要求同类 worker 共享 durable	查运行配置和 consumer；统一文档，避免多 worker 队列语义不一致
旧 VictoriaMetrics Compose	platform/observability/README.md 说已替代；apps/victoriametrics/ 仍留配置	只读检查 Docker 与采集目标，确认是否仍承担职责，再标记退役或迁移

优先补充的使用说明

1. Gitea / Actions：登录、创建仓库、选择 runner，以及可信任务限制。
2. Grafana：登录、找到内存与 Swap 看板、查询指标和日志的一个完整例子。
3. zot / SeaweedFS：拉取、发布授权、S3 客户端接入，以及数据备份边界。
4. OpenBao：日常登录、按权限取用秘密、申请权限；与灾难恢复分开说明。
5. NetBox：查看拓扑与 IPAM 的路径，强调目前是评估镜像，改动入口在 Git。
6. codex-proxy、LiteLLM gateway、shared PostgreSQL、Tailscale、ps3netsrv、vlmcsd、k3s：补用途和当前状态；这些目录缺少根 README。

盘点盲区

• docs/cicd.md 提及 e5renew、rustfs，但无独立组件目录；需要确认现状与归属。
• infrastructure/docker/README.md 提及仓库外 research-auto，不能在本轮算作已盘点服务。
• 本轮发现远端仓库 gitea-microvm-runner， 尚未审阅内容或运行状态。后续将跨仓库服务纳入总览。
• PostgreSQL Tenant Operator 已按维护者说明及项目 README/架构文档收录为 计划中的 DBaaS 中间层。共享 PostgreSQL 已在使用， operator 仍按项目记录标为 API 骨架阶段；本轮未查询运行环境。
• workload-sts 已按维护者提供的信息查阅：仓库已归档，停止开发、不部署 PoC， 作为早期设计与替代决策的历史来源保留，不列为待接入服务。
• 新增 NATS、zot、microVM 等来源含未提交文件；合并后补可访问的 commit/PR 链接。
• Backstage 仍作为计划入口记录；本轮没有证明已有部署。

完成核实后，将结果写回对应权威文档，并更新服务总览的证据等级和验证日期。