在 Docker 中可通过修改 /etc/docker/daemon.json(Linux)或 C:\ProgramData\docker\config\daemon.json(Windows)启用调试模式,添加 {"debug": true, "log-level": "debug"} 并重启服务,再用 journalctl 或 docker info 验证。
在 docker 中,可以通过修改 /etc/docker/daemon.json 文件启用调试模式,让 dockerd 输出更详细的日志信息,便于排查启动失败、容器异常、网络或存储问题。
确认 daemon.json 存在并格式正确
该文件默认可能不存在,需手动创建。确保它是合法的 JSON(无注释、末尾无逗号、引号用双引号):
- 路径必须是
/etc/docker/daemon.json(Linux)或C:\ProgramData\docker\config\daemon.json(Windows Server) - 若文件已存在,先备份再编辑:
sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak - 使用
jq或在线 JSON 校验器验证语法,避免因格式错误导致 Docker 启动失败
添加 debug 配置项
在 daemon.json 中加入 "debug": true(布尔值,不是字符串):
{
"debug": true,
"log-level": "debug"
}
说明:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
-
"debug": true是核心开关,启用调试日志级别和额外运行时信息 -
"log-level": "debug"可选但推荐,确保日志输出完整(默认为info) - 两者作用不同:
debug: true影响内部行为(如 API 调试头、pprof 端点),log-level控制控制台/日志文件输出粒度
重启 Docker 并验证效果
保存文件后,重载配置并重启服务:
- Linux:
sudo systemctl daemon-reload && sudo systemctl restart docker - 检查是否成功:
sudo systemctl status docker查看有无报错 - 实时查看调试日志:
sudo journalctl -u docker.service -f -o cat(systemd 系统) - 也可通过
docker info | grep -i debug确认输出中包含Debug Mode: true
注意事项与常见问题
调试模式会显著增加日志量,不建议长期开启:
- 日志可能快速占满磁盘,建议配合日志轮转(如
"log-driver": "json-file", "log-opts": {"max-size": "10m", "max-file": "3"}) - 若重启后 Docker 无法启动,大概率是 daemon.json 语法错误,用
sudo dockerd --config-file /etc/docker/daemon.json --test快速验证配置 - Docker Desktop 用户无需改此文件,可在 GUI 设置 → Daemon → Advanced 中勾选
Enable debug mode

















