# ADR-0008：部署仅支持 Docker Compose v2 + Engine ≥ 25

- **状态**：Accepted
- **触发背景**：服务器上旧版 docker-compose v1（Python 实现）在 Docker Engine 25+ 上因读取 `ContainerConfig` 字段崩溃（`KeyError: 'ContainerConfig'`）。

## 决策
仅支持 **Docker Compose v2**（`docker compose` 子命令）部署；弃用 v1。`deploy.sh` 中 `get_compose_cmd` 优先探测 v2，回退 v1 仅作兼容提示。

## 后果
- 升级路径：安装 `docker-compose-plugin`（v2）并卸载 v1 后即可用 `./deploy.sh upgrade` 或 `docker compose up -d --build`。
- `docker-compose.yml` 顶部 `version:` 仅产生弃用警告，不影响功能。

## 关联
NFR-6, OI-2；部署细节见 `DEPLOY.md`、`README_DOCKER.md`。