homelab-wiki/guides/task-index.md

title, last_reviewed

title	last_reviewed
按任务查找文档	2026-09-16

按任务查找文档

先找任务，再读相关服务页；不必一次读取整个仓库。 需要环境清单时看服务总览，准备变更时先读架构约束。

要做什么	先读	需要时再读
发布新的 LAN Web 服务	发布新服务	DNS、Authelia
写 CI 或选择 Pod/VM runner	Gitea / Actions	Dynamic Runner、SPIFFE
拉取或发布容器镜像	zot	SPIFFE；S3 后端维护才读 SeaweedFS
使用 S3 对象存储	SeaweedFS	OpenBao
给应用分配数据库	共享 PostgreSQL	计划中的 DBaaS
给应用提供秘密或存储	External Secrets、OpenEBS	OpenBao
排查内存、日志或追踪	Grafana	对应服务源码 runbook
排查域名解析	LAN DNS或Pod DNS	Tailscale，如果请求来自远程客户端
排查登录或域权限	Authelia、Samba AD	具体应用的权限说明
为 workload 提供机器身份	SPIFFE	目标服务的 token 与权限规则；进度回到 #34
使用消息队列	NATS	consumer 项目自己的协议与队列文档
调用模型或处理文档	LiteLLM、Marker	OpenViking，如果需要检索
让应用发送邮件	SMTP relay	消费者的发信配置
远程访问或查看网络资产	Tailscale、NetBox	NetBox 的权威来源是 Git，不能代替运行状态
管理云主机或虚拟机	OCI、Proxmox	对应 IaC 和网络/HA runbook
使用 PS3 内容或 KMS 服务	ps3netsrv、vlmcsd	各自客户端配置

给 AI 接续一个任务

提供目标、目标服务、已经授权的操作范围，以及你掌握但尚未写入文档的变化。 一个简短的任务交接可以这样写：

目标：为某个新应用增加 LAN HTTPS 入口。
入口文档：guides/publish-service.md。
已有条件：应用 namespace、Service 名称与端口、计划域名。
本次范围：先准备配置与文档 PR；尚未授权现场部署。
动态背景：相关 ticket / PR，或维护者最新说明。
完成条件：配置可审阅，检查通过，说明来源与未执行的验证。

这个例子的范围仅用于演示，不能覆盖具体任务已经获得的授权。 Samba AD、OCI、Proxmox 已明确以 IaC 为准，可直接核对其代码；其他动态项目按既定规则对齐来源。 身份设计、配置声明、历史实施记录和本次现场证据应分别表达。

找到资料后如何判断是否足够

服务页中的 last_reviewed 表示文档审阅时间，last_verified 才表示对应现场验证时间。 查阅来源追溯可定位固定源码版本，并看到它与工作区是否一致。 索引中的“内容一致”只确认文件，不确认服务健康。

检索、转换或 AI 摘要用于定位原文；结论仍应关联到源码、维护者说明或 ticket。 工作完成后，将持久使用方法写入服务页，将一次变化留在 commit/PR，动态进度回到原项目 ticket。 原仓库 README 同步目前按维护者要求暂缓，不将其列为每次任务的前置条件。