日志驱动配置了 max-size 但未生效,通常是因为 docker 守护进程的全局默认值被覆盖、容器启动时未正确传递参数,或者日志轮转机制存在延迟。要解决这个问题,需要检查 /etc/docker/daemon.json 中的全局配置是否包含 log-driver 和 log-opts,并确保在创建或更新容器时显式指定了 --log-opt max-size 和 --log-opt max-file。修改全局配置后必须重启 docker 服务才能生效,而针对单个容器的配置则需要在重新创建容器时应用。

如何验证并修复全局 Docker 守护进程的日志轮转配置
如果希望所有新创建的容器都自动应用日志大小限制,应直接修改 Docker 守护进程的配置文件。首先,检查 /etc/docker/daemon.json 是否存在且语法正确。该文件必须明确声明 log-driver 为 json-file(这是默认驱动,但显式声明更稳妥),并在 log-opts 中设置 max-size 和 max-file。例如,设置每个日志文件最大 100MB,保留 5 个备份文件。修改完成后,必须执行 systemctl restart docker 重启服务,否则配置不会加载。对于已存在的容器,此操作无效,它们会沿用创建时的配置或旧的全局配置快照。
{
"log-driver": "json-file",
"log-opts": {
"max-size": "100m",
"max-file": "3"
}
}
上述 JSON 配置是全局生效的关键。当 Docker 守护进程重启后,任何新启动的容器若未指定自定义日志选项,将继承这些值。可以通过运行一个测试容器并查看其配置来验证:使用 docker inspect 并查找 "LogConfig" 字段。如果 "Type" 是 json-file 且 "Config" 中包含 max-size 和 max-file,则说明全局配置已成功应用。如果未生效,请检查 daemon.json 的 JSON 格式是否有误,如缺少逗号或引号,这会导致 Docker 启动失败或忽略配置。
为什么单个容器启动时指定的 max-size 参数会被忽略
即使全局配置正确,如果在启动容器时通过命令行或 Compose 文件指定了 max-size 却未生效,往往是因为参数传递方式错误或与全局配置冲突处理不当。在使用 docker run 命令时,必须同时使用 --log-opt max-size= 和 --log-opt max-file=。仅设置 max-size 而不设置 max-file 可能导致行为不符合预期,因为 Docker 默认可能只保留一个文件。此外,如果使用 Docker Compose,必须在 logging 部分正确嵌套 options。另一个常见陷阱是:如果容器已经存在,直接 docker start 不会应用新的日志选项,必须删除旧容器并使用相同名称重新创建,或者使用 docker update(注意:docker update 对日志驱动的更改在某些版本中可能不立即生效或需要重启容器)。
docker run -d \ --name test-logger \ --log-opt max-size=50m \ --log-opt max-file=2 \ nginx
运行上述命令后,应立即检查容器状态。使用 docker inspect test-logger | grep -A 5 LogConfig 可以确认配置是否被正确写入。如果输出显示 max-size 和 max-file 存在,但日志文件仍然无限增长,需检查磁盘权限和 Docker 用户组权限。确保运行 Docker 守护进程的用户(通常是 root 或 docker 组用户)有权限写入日志目录(默认为 /var/lib/docker/containers/)。如果权限不足,Docker 可能无法创建新的轮转日志文件,导致旧文件不被清理。此外,检查 dmesg 或 /var/log/syslog 中是否有 Docker 相关的错误信息,如 permission denied 或 no space left on device。
基于容器中实际生成的日志文件路径和命名规则排查未轮转原因
当配置看似正确但日志仍未轮转时,最直接的方法是检查宿主机上容器日志文件的实际存在情况和命名模式。Docker 默认将 JSON 格式的日志存储在 /var/lib/docker/containers/。如果启用了轮转,还会生成 , 等备份文件。进入该目录,使用 ls -lh 查看文件大小和数量。如果只有一个巨大的 -json.log 文件,且没有 .1, .2 等文件,说明轮转机制未触发。这可能由于容器尚未产生足够多的日志达到 max-size 阈值,或者 Docker 守护进程在处理日志轮转时遇到 I/O 错误。
# 假设容器 ID 为 abc123def456 cd /var/lib/docker/containers/abc123def456/ ls -lh *.log
观察输出结果:如果 abc123def456-json.log 的大小远小于设定的 max-size(例如设为 100m,但文件只有 10m),则说明日志量不足,轮转尚未触发,这是正常现象。如果文件大小已超过阈值但仍无轮转文件,尝试手动触发一次日志轮转以测试机制:发送 SIGHUP 信号给 Docker 守护进程(kill -HUP $(pidof dockerd))或重启 Docker 服务。如果重启后轮转正常工作,则可能是临时性的守护进程状态问题。如果依然无效,检查 SELinux 或 AppArmor 策略是否阻止了 Docker 访问或修改日志文件。可以使用 auditctl -w /var/lib/docker/containers/ -p wa 监控日志目录的写和属性变更事件,定位被拦截的操作。确保日志目录的所有者和权限正确,通常为 root:root 或 docker:docker,权限为 750 或 700。











