Docker 启动与部署说明

固定入口

本项目固定使用 Docker Compose 项目名 hot-comments-tool，服务入口固定为：

http://localhost:8000

启动或重建：

docker compose up -d --build
curl -f http://localhost:8000/health

查看容器：

docker compose ps

正常情况下只需要看到一个应用容器：hot-comments-tool-app-1。

如果 8000 被占用，先确认是不是本项目容器：

lsof -nP -iTCP:8000 -sTCP:LISTEN
docker compose ps

如果是旧的同项目容器，执行：

docker compose down
docker compose up -d --build

不要临时改到 8001，否则浏览器验收和文档记录会混乱。

Docker Compose 读取 .env，不要把真实 .env 提交到 Git。

首次启动前可以从示例文件复制：

cp .env.example .env

必须配置：

TIKHUB_API_KEY=
AI_BASE_URL=
AI_API_KEY=
AI_MODEL=

SQLite 数据固定挂载整个目录：

./data:/app/data

不要只挂载单个 app.db 文件。SQLite WAL 模式会生成：

data/app.db
data/app.db-wal
data/app.db-shm

这三个文件必须在同一个挂载目录内。

仅在确认不需要保留历史任务后执行：

docker compose down
rm -f data/app.db data/app.db-wal data/app.db-shm
docker compose up -d --build
curl -f http://localhost:8000/health

重置后历史任务会消失，首页任务列表会从空状态开始。

.venv/bin/python -m pytest tests/unit tests/integration -q
docker compose up -d --build
curl -f http://localhost:8000/health