#常见启动问题

这里先放 Docker Compose 部署最常见的问题。复杂的构建和集群问题放在“使用”里慢慢查。

#想验证指定镜像版本

默认 docker-compose.yaml 使用 nightly 镜像。验证 RC 或稳定版本时，在启动命令前设置 DEVOPS_IMAGE_TAG：

DEVOPS_IMAGE_TAG=v0.1.0-rc.1 docker compose up -d

如果你要从当前源码构建镜像，而不是拉取 DockerHub 镜像，使用源码构建 compose：

docker compose -f docker-compose-build.yaml up -d --build

#端口 8088 被占用

查看占用：

lsof -nP -iTCP:8088 -sTCP:LISTEN

你可以停止占用进程，或者修改 docker-compose.yaml 里的端口映射：

ports:
  - "8089:8080"

然后访问 http://localhost:8089。

#页面打开但接口失败

先查看 API 日志：

docker compose logs -f api

再确认数据库和 Redis 是健康状态：

docker compose ps

#worker 没有正常启动

查看 worker 日志：

docker compose logs -f worker

worker 负责构建、部署和状态同步。只浏览控制台时 API 可以先跑起来；要测试发布链路时，worker 必须正常运行。