怎么通过启动命令输出详细的容器调试日志-Docker-PHP中文网

要通过启动命令输出详细容器调试日志，需启用docker daemon debug模式、配置日志驱动、结合应用级调试参数（如环境变量或启动选项），并在entrypoint中启用shell调试（set -x）及stdout/stderr重定向。

要通过启动命令输出详细的容器调试日志，关键是在运行容器时启用调试模式并重定向日志输出，同时确保底层运行时（如 docker 或 containerd）和容器内应用本身都支持详细日志级别。

Docker 守护进程本身的调试日志需在宿主机配置，但容器启动过程和运行时行为可通过以下方式增强可见性：

添加 -D（debug）标志到 docker run 命令（仅适用于部分旧版 Docker CLI，现代版本已移除；实际应依赖守护进程级 debug）
更可靠的方式：启动前设置 Docker daemon 为 debug 模式（编辑 /etc/docker/daemon.json，加入 "debug": true，然后重启 dockerd），再运行容器
使用 --log-driver=local --log-opt max-size=10m --log-opt max-file=3 等参数显式控制日志驱动，便于后续用 docker logs -f --details 查看带元数据的原始日志

容器启动命令本身不直接控制应用日志级别，需结合应用启动参数或环境变量：

例如运行 Nginx 容器时加 -e NGINX_DEBUG=true 并挂载自定义 nginx.conf，开启 error_log /var/log/nginx/error.log debug;
运行 Python 应用镜像时，在 docker run 中传入 python -u app.py（-u 强制未缓冲输出），再配合 -e LOG_LEVEL=DEBUG
Java 应用常用 -e JAVA_OPTS="-Dlogging.level.root=DEBUG" 或挂载 logback-spring.xml

容器初始化阶段（如 entrypoint 脚本、健康检查、CMD 执行前）的日志容易丢失，可采取以下措施：

用 docker run --init 确保 PID 1 是 tini，避免信号丢失导致日志截断
在自定义 entrypoint 脚本开头添加 set -x，使 shell 执行每条命令前打印出来（适合调试启动逻辑）
将标准输出/错误重定向到文件并挂载卷，例如：docker run -v $(pwd)/logs:/app/logs myimg sh -c 'myapp 2>&1 | tee /app/logs/startup.log'

容器运行后，快速定位问题日志：

docker logs -f --timestamps --details <container-id></container-id>：显示带纳秒时间戳和容器元数据的日志流
docker inspect <container-id></container-id>：检查 LogPath、State.Status、Mounts、HostConfig.LogConfig 等字段是否符合预期
docker events --filter 'container=<name>' --since '2024-01-01'</name>：查看容器生命周期事件（创建、启动、死亡等）

不复杂但容易忽略的是：调试日志有效性高度依赖镜像是否以非守护模式运行、输出是否被缓冲、以及日志是否真正写入 stdout/stderr。只要确保这三点，启动命令就能成为排查容器问题的有力入口。