Docker 服务重启失败怎么查？AI Agent 检查 compose、端口和环境变量

Docker 服务重启失败是 VPS 运维中最常见的噩梦，特别是在部署 AI Agent 或 n8n 这类自动化工作流时。主机选经常遇到用户反馈，明明 Docker compose 配置文件看着没问题，服务就是起不来。其实，90% 的重启失败都能通过日志、端口占用和环境变量这三点快速定位。与其盲目重装系统，不如先学会怎么查。

Docker 服务重启失败排查思路

服务起不来，第一反应别去改配置文件，先看状态。容器处于 `Exited` 状态并不代表它没运行过，而是启动过程中崩了。

查看所有容器状态，包括退出的：

docker ps -a

重点看 `STATUS` 列，如果是 `Exited (1) X seconds ago`，说明进程报错退出了；如果是 `Restarting (1) X seconds ago`，说明陷入了启动-崩溃的死循环。

拿到容器 ID 后，直接看日志，这是最真实的报错现场：

docker logs <容器ID或名称> –tail 50

`–tail 50` 只看最后 50 行，避免刷屏。如果日志里全是 Python 的 Traceback 或者 Node.js 的 Error，直接复制错误信息去 Google 或丢给 AI Agent 分析，比自己猜快得多。

AI Agent 检查 Docker Compose 配置

很多时候，肉眼很难发现 YAML 文件的缩进错误或者语法问题。现在很多开发者习惯用 Claude Code 或 Codex 这类 AI 工具来辅助审查 `docker-compose.yml`。

把你的 compose 文件内容直接贴给 AI，Prompt 可以写：“帮我检查这个 Docker Compose 配置有没有语法错误，特别是 volume 挂载路径和依赖关系。” 这类 AI Agent 对 YAML 语法非常敏感，能一眼看出你把 `volumes:` 缩进对齐到了 `services:` 同级这种低级错误。

如果 Docker Compose 报错 `invalid reference format`，通常是镜像名写错了，或者 `.env` 文件里的变量没有被正确读取。检查一下当前目录下是否有 `.env` 文件，并且变量名是否在 compose 文件里用 `${变量名}` 正确引用了。

端口冲突与环境变量校验

Docker 重启失败，很大一部分原因是端口被占用。比如你想把 n8n 部署在 `5678` 端口，结果系统里别的服务已经占了这个坑。

检查端口占用情况：

ss -tulnp | grep <端口号>
netstat -tulnp | grep <端口号>

如果发现有输出，说明端口被占。要么杀掉占用进程，要么修改 compose 文件里的端口映射，比如改成 `5679:5678`。

环境变量错误是另一大重灾区。部署 Ollama 或 Open WebUI 时，经常因为缺少 API Key 或者数据库连接字符串错误导致启动秒退。

检查环境变量是否加载：

docker compose config

这个命令会把最终生效的配置打印出来，包括替换后的环境变量。如果你发现某个关键变量（如 `POSTGRES_PASSWORD`）是空的，那就是 `.env` 文件没生效或者变量名写错了。

实战：查看 n8n 和 Ollama 的报错日志

以 n8n 为例，如果它一直重启，通常是因为连不上数据库。日志里大概率会报 `ECONNREFUSED`。这时候检查一下 Postgres 容器是不是先于 n8n 启动了。可以在 compose 文件里加 `depends_on`，并配置健康检查，确保数据库 Ready 了再起 n8n。

对于 Ollama，如果日志里提示 `out of memory` 或者 `CUDA out of memory`，说明你的 VPS 内存或显存不够跑这个模型。别硬撑，换个小点的模型（如 `llama3:8b` 而不是 `70b`），或者增加 Swap 分区。

老鸟叮嘱

1.不要用 Root 跑所有服务：在 Dockerfile 或者 compose 文件里指定 `USER`，能避免很多因为权限不足导致的文件读写错误。
2.日志轮转很重要：Docker 默认日志不限制大小，时间久了能把磁盘撑爆。在 `/etc/docker/daemon.json` 里配置 `log-driver` 和 `log-opts`，限制单个日志文件大小和数量。
3.区分容器重启和系统重启：`docker restart` 是重启容器，`systemctl restart docker` 是重启 Docker 服务。后者会导致所有容器停止，生产环境慎用。
4.善用 AI Agent 排障：遇到看不懂的报错，把日志脱敏后扔给 Claude 或 DeepSeek，让 AI 帮你分析原因，效率比自己翻文档高得多。

FAQ

Docker 容器一直重启怎么办？
先执行 `docker logs` 查看具体报错。如果是内存不足，尝试减小模型规模或增加 Swap；如果是配置错误，修正 `docker-compose.yml` 后重新构建。

为什么修改了 .env 文件重启不生效？
Docker Compose 读取的是容器启动时的环境变量。修改 `.env` 后，必须执行 `docker compose down` 然后再 `docker compose up -d`，单纯的重启容器不会更新环境变量。

怎么查看容器内部的文件结构？
使用 `docker exec -it <容器ID> /bin/sh`（或 `/bin/bash`）进入容器内部，用 `ls` 和 `cat` 命令排查文件路径是否挂载正确。

Docker 端口映射了，但外网访问不通？
检查防火墙和 VPS 商家的安全组，确保对应的端口已经放行。如果是云服务器，安全组策略往往比系统防火墙更先拦截流量。

掌握日志分析和配置检查，处理 Docker 故障就能从“玄学”变成“科学”。