在 docker-compose.yml 中配置 logging 使用 json-file 驱动并设置 max-size 和 max-file 参数,是最轻量有效的日志轮转方案;示例为 driver: "json-file",max-size: "50m",max-file: "3",修改后需 docker-compose up -d 重建容器生效。

直接在 docker-compose.yml 里配置日志轮转,是最有效、最轻量的解法。不用动宿主机系统,也不依赖额外组件,改完重启服务即可生效。
确认日志驱动并启用 json-file
Docker Compose 默认使用 json-file 驱动,它支持大小限制和自动轮转。只要不显式指定其他驱动(如 none 或 syslog),就可以直接配置轮转参数。
- 确保服务下有
logging区块,且driver明确设为"json-file" - 避免写成
driver: "local"或留空——部分旧版 Compose 可能 fallback 到无限制行为 - 若已有服务在运行,修改后需
docker-compose up -d重建容器才生效(仅up不会重载日志配置)
设置 max-size 和 max-file 参数
这两个参数是控制磁盘占用的核心。它们共同决定单个容器最多占多少空间、保留几份历史日志。
-
max-size:建议设为"10m"~"100m"。调试期可用小值(如 10m),稳定后可放宽到 50–100m -
max-file:推荐"3"。保留 3 个滚动文件,既够排查又不堆积 - 示例配置:
logging: driver: "json-file" options: max-size: "50m" max-file: "3"
检查并清理已膨胀的日志文件
配置生效前,旧容器可能已生成 GB 级日志。这些文件不会自动清理,需手动干预:
- 查出最大日志:
sudo du -sh /var/lib/docker/containers/*/*-json.log | sort -hr | head -5 - 清空运行中容器日志(不中断服务):
sudo truncate -s 0 /var/lib/docker/containers/<id>/<id>-json.log - 注意:不要用
rm删除正在写的日志文件,会导致 inode 占用不释放;truncate更安全
补充建议:统一 Daemon 级默认策略
如果集群中多数服务都用 Compose,建议在宿主机的 /etc/docker/daemon.json 中设全局默认值,防漏配:
- 添加如下内容后
sudo systemctl restart docker:{ "log-driver": "json-file", "log-opts": { "max-size": "50m", "max-file": "3" } } - 此后所有新启动容器(包括未在 Compose 中显式配置 logging 的)都会继承该策略
- Compose 中的配置优先级高于 daemon.json,可按需覆盖


















