homelab-wiki/documentation-backlog.md

文档完善清单

本轮待核实事项已于 2026-09-16 收尾。以下是后续写作工作，不是未解决的状态核实任务， 也不代表所有相关项目都已部署或经过现场验收。需要补充事实时仍先向维护者对齐范围。

已补充使用指南

• Gitea / Actions：登录、建仓库、最小 CI、runner 选择和常见问题。

• Grafana：内存看板、指标查询、日志搜索和数据源用途。

• zot：拉取、发布授权、workflow 身份职责与后端数据恢复边界。

• SeaweedFS：S3 入口、专用凭据、列举与上传下载示例。

• OpenBao：人的登录、按权限取密及机器身份边界。

• NetBox：浏览设备与 IPAM，明确 Git 来源与评估用途。

• 共享 PostgreSQL：应用接入、连接检查与共享实例维护边界。

• LiteLLM：模型请求、认证边界与独立数据库依赖。

• Tailscale：客户端接入、子网路由和 operator Service 的区别。

• ps3netsrv、vlmcsd：客户端使用与配置入口。

• External Secrets、OpenEBS：应用秘密与 PVC 消费示例。

• k3s DNS：Pod 解析路径、配置意图与排障入口。

• Marker、OpenViking：转换与导入、等待、检索、读取示例。

• SMTP relay：应用配置、测试邮件与投递边界。

以上依据源码文档和上游说明整理，示例未在本轮执行，不作为现场验收记录。

后续使用说明

1. cert-manager、Envoy Gateway：补新服务的证书与 HTTP 入口接入路径。
2. Samba AD、OCI、Proxmox：按已有来源补日常管理入口，涉及动态状态前先对齐维护者。

codex-proxy 已按维护者“应该是退役的”的说明移至归档范围，不再补新接入指南。 LiteLLM、Tailscale、ps3netsrv、vlmcsd 与 k3s 的 wiki 指南已补；源码目录仍缺根 README，配置入口已在各页列出。

文档同步与来源链接

• 源码仓库中 Authelia OIDC、LAN DNS、SPIRE 的旧说明后续与知识库结论同步。
• 未提交工作区来源合并后，补充正式 commit/PR 链接。