如何利用 Docker 架构中的本地日志驱动 Logging Driver 精细调优日志文件的轮转大小与上限

必须同时设置max-size和max-file参数才能触发json-file日志轮转，支持单位b/k/m/g，max-file包含当前文件；可通过docker run或daemon.json全局配置，Docker 20.10+起可启用compress自动压缩旧日志。

核心是用好 json-file 日志驱动的 max-size 和 max-file 两个参数，二者必须同时设置才生效。单独设一个，轮转不会触发。

容器启动时按需定制日志轮转

适合对不同服务有差异化日志策略的场景，比如前端容器日志量小、可设宽松些；后端或批处理容器输出密集，需更激进控制。

• 直接在 docker run 命令中指定：
  docker run -d --log-driver json-file --log-opt max-size=20m --log-opt max-file=4 nginx
• max-size 支持单位：b（字节）、k（KB）、m（MB）、g（GB），例如 50m 表示单个日志文件最大 50MB
• max-file 是保留的总文件数，含当前正在写的那个。设为 4 表示最多存在 xxx-json.log、xxx-json.log.1、xxx-json.log.2、xxx-json.log.3

全局统一配置所有新容器

适用于运维规范统一、不想每次启动都重复加参数的环境。修改后只影响新创建的容器，已有容器需重建才生效。

• 编辑 /etc/docker/daemon.json，加入以下内容（若文件不存在，新建即可）：
  

  { "log-driver": "json-file", "log-opts": { "max-size": "30m", "max-file": "3" } }

• 保存后执行：
  sudo systemctl restart docker
• 验证是否生效：
  docker info | grep LoggingDriver 确认驱动类型，再用 docker inspect 容器名 | jq '.HostConfig.LogConfig' 查看具体参数

配合压缩进一步节省空间

从 Docker 20.10+ 开始，json-file 驱动支持自动压缩旧日志文件，减少磁盘占用，尤其适合长期运行的服务。

• 在 daemon.json 或启动参数中增加：
  "compress": "true"
• 启用后，轮转出的 .1、.2 等文件会自动变为 .1.gz、.2.gz
• 注意：压缩仅作用于轮转后的旧文件，当前写入的 -json.log 不压缩

验证与日常检查建议

配置不是一劳永逸，定期确认实际效果能避免“以为设了，其实没生效”的情况。

• 查日志路径：
  docker inspect 容器名 --format='{{.LogPath}}'
• 进宿主机查看文件列表：
  ls -lh $(docker inspect 容器名 --format='{{.LogPath}}' | sed 's/-json.log//')*-json.log*
• 正常应看到多个带编号的文件，且每个大小接近但不超过 max-size 设置值
• 如果只看到一个巨大文件，大概率是 max-file 和 max-size 没配全，或容器启动时未继承 daemon.json 配置（比如用了 --log-driver none 覆盖）