sunflowermm 权威文档与入口
- 文档：
docs/docker.md - 配置：
docker-compose.yml、Dockerfile - 子服务端目录：
subserver/pyserver/
你要掌握的要点
- Compose 全栈：
xrk-agt+xrk-subserver（Python）+ 五语言子服 +redis（见docker-compose.yml）。 - 命令：
pnpm docker:build→pnpm docker:up→pnpm docker:status；从零重来pnpm docker:fresh；停止pnpm docker:down（src/utils/docker-stack.mjs）。 - Python 子服：与主服同镜像
xrk-agt:latest，command: subserver（无独立 pyserver Dockerfile）。 - 代理：本机
config/docker.env或根.env；构建阶段用host.docker.internal。 - 挂载：
./data、./logs、./config、./resources、./core。
Node 26
- 镜像基线：
Dockerfile使用node:26-slim；容器内node -v应 ≥ 26.0。 package.jsonengines 与app.js启动校验一致；勿在文档或示例中写 Node 24 /node-fetch。- 可选：
NODE_COMPILE_CACHE缩短冷启动（见docs/node-26-runtime.md§2.2）。
故障排查关键路径
- 查看服务状态：
docker-compose ps。 - 查看日志：
docker-compose logs -f xrk-agt/xrk-subserver。 - 健康检查：
curl http://localhost:8080/health、http://localhost:8000/health。 - 子服务连不上主服务：检查 Compose 网络与
MAIN_SERVER等环境变量（见docs/docker.md）。