不应在 Docker 容器中使用传统 Nginx 日志切割,因日志应作为标准流由 Docker 统一管理;需关闭文件日志、启用 /dev/stdout/stderr 输出并禁用守护进程,或通过软链接重定向,日志滚动由 Docker 日志驱动(如 json-file)配置 max-size 和 max-file 实现。

在 Docker 容器化环境中,不应使用传统 Nginx 日志切割(logrotate 或内部轮转)。容器日志管理的核心原则是:日志即流,由 Docker 统一采集和分发。强行切割文件不仅无效,还容易导致日志丢失、权限错误或容器启动失败。
为什么不能在容器里做日志切割
Nginx 写入 /dev/stdout 时,本质是向一个字符设备写数据,不是普通文件——它不支持 mv、gzip、rename 等操作。任何试图对 /dev/stdout 执行轮转的脚本都会失败。Docker 的日志驱动(如 json-file、loki、syslog)已内置滚动与保留策略,无需 Nginx 干预。
正确做法:关闭文件日志,直连标准流
确保 Nginx 不写任何日志文件,全部交由 Docker 处理:
- 在
nginx.conf的http块中设置:access_log /dev/stdout main;error_log /dev/stderr warn; - 必须禁用守护进程模式:
在nginx.conf全局块添加daemon off;,或启动时加参数-g "daemon off;" - 删除或注释掉所有
access_log /var/log/...;和error_log /var/log/...;行,避免冲突
替代方案:软链接方式(适合无法改配置的场景)
若你无法修改 Nginx 配置(例如使用第三方镜像),可在 Dockerfile 中建立符号链接:
RUN ln -sf /dev/stdout /var/log/nginx/access.logRUN ln -sf /dev/stderr /var/log/nginx/error.log
这样即使配置仍指向 /var/log/nginx/access.log,实际写入的仍是标准输出流。
日志滚动与保留交给 Docker 驱动
通过 docker run 或 docker-compose.yml 设置日志驱动选项,实现按大小、时间或数量滚动:
- 限制单个日志文件最大 10MB,最多保留 3 个:
--log-opt max-size=10m --log-opt max-file=3 - 在
docker-compose.yml中:logging:<br> driver: "json-file"<br> options:<br> max-size: "10m"<br> max-file: "3"
这些策略由 Docker 守护进程执行,稳定可靠,且与 docker logs 命令完全兼容。


















