关键在于同时配置 json-file 或 local 驱动与 max-size、max-file 参数;推荐按场景选择容器启动时配置、docker-compose.yml 声明或 daemon.json 全局设置,并优先使用支持压缩的 local 驱动。

关键在于用 json-file 或 local 驱动配合 max-size 与 max-file 两个参数协同控制——只设一个无效,必须同时配置。
容器启动时单独配置(推荐用于重点服务)
适合对关键容器做精细化日志管理,比如 API 服务、数据库代理等:
- 必须显式指定
--log-driver json-file(或local),否则--log-opt会被忽略 -
--log-opt max-size=10m:单个日志文件上限,单位支持 k/m/g,超出即触发轮转 -
--log-opt max-file=3:最多保留 3 个文件(含当前正在写的-json.log),旧的自动删除 - 示例命令:
docker run -d \<br> --log-driver json-file \<br> --log-opt max-size=20m \<br> --log-opt max-file=2 \<br> --name api-prod \<br> my-api:latest
在 docker-compose.yml 中声明(推荐用于编排部署)
配置可版本化、易复用,适合 CI/CD 流程:
- 在 service 下添加
logging区块,driver和options同级 -
max-size和max-file的值要用双引号包裹(YAML 要求) - 示例片段:
services:<br> backend:<br> image: myapp:v2<br> logging:<br> driver: "json-file"<br> options:<br> max-size: "15m"<br> max-file: "3"
全局统一配置(推荐用于整机治理)
一劳永逸,所有新创建容器自动继承,适合标准化运维:
- 编辑
/etc/docker/daemon.json(若不存在则新建) - 填入完整 JSON,注意格式合法(逗号、引号、括号):
{<br> "log-driver": "json-file",<br> "log-opts": {<br> "max-size": "50m",<br> "max-file": "5"<br> }<br> } - 保存后执行
sudo systemctl restart docker - ⚠️ 注意:该配置仅对重启 Docker 后新建的容器生效;已有容器需重建才生效
进阶建议:生产环境优先用 local 驱动
比 json-file 更轻量,还支持压缩,降低磁盘与 I/O 压力:
- 日志后缀为
.log(当前)和.log.zst(压缩归档) - 同样支持
max-size和max-file - 额外启用压缩:
"compress": "true" - daemon.json 示例:
{<br> "log-driver": "local",<br> "log-opts": {<br> "max-size": "10m",<br> "max-file": "3",<br> "compress": "true"<br> }<br> }
不复杂但容易忽略:一定要验证。运行 docker inspect 容器名 | grep -A 5 LogConfig 看参数是否加载;再进 /var/lib/docker/containers/xxx/ 目录,确认有 -json.log、-json.log.1 等文件,且大小基本不超 max-size。











