# Infra Compose

## Gitea 真相源

- 本目录的最终代码与部署历史以 Gitea `slh/infra` 的 `main` 分支为唯一真相源。
- 生产部署只能来自 Gitea；GitHub 只能作为云端开发工作区，不能覆盖 Gitea Main。
- Git 仅跟踪 Compose、README、无凭据服务配置和幂等初始化脚本。数据库、OAuth、Secrets、日志、迁移快照及运行数据永不入库。
- Compose 的唯一入口是 `docker-compose.yaml`。

## Compose 真相源规范

- 每个项目唯一、最终的 Compose 真相文件必须命名为 `docker-compose.yaml`。
- `compose.yaml`、`docker-compose.yml`、服务分片和迁移候选只能临时存在；任务完成前必须合并回 `docker-compose.yaml`。
- 同一项目不得保留第二个可执行生产入口。历史材料只能进入明确的 `migration/` 或 `rollback/` 目录，并使用不会被 Docker Compose 自动识别的快照文件名。
- 收尾必须执行 `docker compose -f docker-compose.yaml config -q`，并核对 Compose project、service、容器名和运行归属。

共享基础设施的唯一 Compose 入口。迁移按服务逐个进行；尚未迁移的服务继续由原项目管理。

当前服务：

- `gitea`：NAS 内部唯一 Git 真相源，Web/SSH 继续只监听宿主机 `127.0.0.1:13000/2223`，状态固定在 `/volume2/docker/infra/gitea`。
- `litellm`：继续通过外部 `n8n_default` 网络向现有 Agent 提供 `http://litellm:4000`，迁移稳定后再统一共享网络。

唯一 Compose 入口是 `/volume2/docker/infra/compose.yaml`。所有单实例服务显式设置 `container_name`。

Infra 版 LiteLLM 只提供官方订阅 OAuth 路由：OpenAI ChatGPT OAuth 与 xAI OAuth，不包含 GitHub Copilot。旧 NewAPI、DeepSeek、Kuaipao、MINIMAX、Elysia 和其他 API Key 不迁移；`litellm-config.yaml` 不包含 secret。

2026-07-16 对当前 Plus 账号真实请求模型目录并逐一 smoke test 后，ChatGPT 路由只保留：`gpt-5.6-sol`、`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`、`codex-auto-review`。这些结论来自账号运行态，不来自静态文档目录。

`frpc` 是独立项目，不属于本 Compose。

Gitea 从 Codex Compose 迁移使用 `/volume2/docker/ops/migrate-gitea-to-infra.sh`。如果旧 `codex_local_git` 仍存在，脚本会停止并重命名它；如果容器已经不存在，则直接冷接管离线状态。脚本会复制 `/volume2/docker/codex/gitea` 到 `/volume2/docker/infra/gitea`；新容器健康后，它会从 Codex Compose 精确移除旧 Gitea 服务，并把原文件保存在新状态目录的 `migration/legacy-codex-compose.yaml`。旧数据始终保留为回滚点，确认仓库、登录、SSH 和数据完整前不得删除。

LiteLLM 迁移使用 `/volume2/docker/ops/migrate-litellm-to-infra.sh`。脚本只复制已有 ChatGPT/xAI OAuth 状态，不读取或生成 API Key 环境文件。成功前不得删除旧 `litellm` 容器和 `/volume2/docker/n8n/litellm`。

单实例服务必须显式设置 `container_name`。Infra LiteLLM 固定使用 `litellm`；首次按新命名重建前，如果旧回滚容器仍占用该名称，先将旧容器改名为 `litellm-legacy-rollback`，不得直接删除未确认的回滚状态。