不能直接在Nginx容器中运行logrotate,因其依赖cron和持久化状态,而Nginx容器单进程前台运行、无cron服务,且重启后logrotate状态丢失,易致重复或漏切;sidecar模式通过独立容器共享日志卷并发送reopen信号实现可靠切割。

在 Docker 容器中,Nginx 默认将日志写入 stdout/stderr 或挂载的文件(如 /var/log/nginx/access.log),但容器本身不支持传统 cron 或 logrotate 的长期运行,因此需借助 sidecar 模式实现可靠、可维护的日志切割。
为什么不能直接在 Nginx 容器里跑 logrotate?
logrotate 依赖定时任务(cron)和文件系统持久性。而 Nginx 容器通常以单进程前台方式运行(PID 1),不带 cron 服务;若强行安装 cron 并启动,会破坏容器设计原则,增加攻击面与维护成本。更关键的是:容器重启后未持久化的 logrotate 状态(如 last rotated 时间、轮转计数)会丢失,导致重复切割或漏切。
Sidecar 方案的核心思路
用一个轻量、专用的 sidecar 容器(如 alpine:latest + logrotate)与 Nginx 容器共享日志卷,并由它定期执行切割。Nginx 主动重载日志(nginx -s reopen)是关键——sidecar 切割后必须通知 Nginx 关闭并重新打开日志文件,否则新日志仍会写入旧文件句柄。
- 两个容器共用同一
volume(如./logs:/var/log/nginx:rw) - sidecar 容器内安装
logrotate,配置按天/大小切割access.log和error.log - logrotate 的
postrotate脚本通过docker exec或 Unix socket(推荐)向 Nginx 发送reopen信号 - sidecar 使用
crond或sleep循环 +logrotate实现定时触发(避免依赖宿主机 cron)
具体实现示例(Docker Compose)
以下是一个最小可行的 docker-compose.yml 片段:
services:
nginx:
image: nginx:alpine
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
- nginx-logs:/var/log/nginx
# 不暴露 80 给宿主机,仅供 sidecar 访问
expose:
- "80"
<p>logrotator:
image: alpine:latest
volumes:</p><ul><li>nginx-logs:/var/log/nginx:rw<h1>若需 exec 进 nginx 容器,挂载 docker.sock(生产慎用)</h1><h1>- /var/run/docker.sock:/var/run/docker.sock:ro</h1><p>entrypoint: ["/bin/sh", "-c"]
command: |
apk add --no-cache logrotate &&
echo "/var/log/nginx/*.log {
daily
missingok
rotate 30
compress
delaycompress
notifempty
create 0644 nginx nginx
sharedscripts
postrotate</p><h1>方式一:通过 docker exec(需挂载 docker.sock,开发可用)</h1><h1>docker exec nginx-nginx-1 nginx -s reopen 2>/dev/null || true</h1><h1>方式二:更安全——向 Nginx 的 80 端口发 reload 请求(需 nginx 配置 stub_status 或自定义 endpoint)</h1><h1>curl -s <a href="https://www.php.cn/link/520153c8d5554c183aec530ebcd35a85">https://www.php.cn/link/520153c8d5554c183aec530ebcd35a85</a> > /dev/null 2>&1 || true</h1><h1>方式三(推荐):使用命名管道或共享内存?不现实。最稳妥是让 Nginx 容器监听本地 socket 并响应 reopen</h1><h1>所以实际常用:sidecar 直接向 Nginx 容器的 PID 1 发信号 —— 需要共享 PID namespace</h1><p>}" > /etc/logrotate.d/nginx &&
while true; do
logrotate /etc/logrotate.d/nginx
sleep 86400 # 每天一次
done
volumes:
nginx-logs:
⚠️ 注意:
docker exec 方式,logrotator 必须能访问 Docker daemon(挂载 docker.sock),存在安全风险,不建议生产环境使用。pid_mode: container:nginx,使 logrotator 与 nginx 共享 PID namespace,然后用 kill -USR1 1(Nginx 的 USR1 信号即 reopen)——前提是 Nginx 容器以 --pid=host 或明确指定 pid_mode 启动。init: true(使用 tini)和 pid_mode: "container:nginx",再在 logrotator 中执行 kill -USR1 1 即可安全 reopen。替代方案:用 Fluentd / Filebeat + 外部日志系统
如果目标是归档与分析而非本地文件管理,可跳过切割,直接让 Nginx 输出到 stdout,再用 Fluentd/Filebeat sidecar 收集、打标、按时间切片转发至 Elasticsearch/S3。这种方式更云原生,规避了文件切割的所有边界问题(权限、inode 复用、reopen 时序等),也便于统一治理。
不复杂但容易忽略:Nginx 容器输出到 stdout 时,access log 格式需适配结构化(如 JSON),且务必关闭 buffer(access_log /dev/stdout json; open_log_file_cache off;),避免日志延迟或丢失。


















