Docker中Nginx以daemon off启动时如何触发重载？

核心问题拆解 #

• 采用nginx -g 'daemon off;'启动时未生成/var/run/nginx.pid，导致nginx -s reload、service nginx reload及logrotate功能失效
• 需要在不重启Nginx容器的前提下，刷新DNS缓存以适配后端容器IP变更
• 临时方案docker compose kill -s HUP <nginx_service_name>仅能重载配置，无法解决依赖PID文件的logrotate等问题

一、修复PID文件生成问题 #

原因分析 #

官方nginx:1.25镜像用nginx -g 'daemon off;'启动时，即便nginx.conf中配置了pid /var/run/nginx.pid;，默认也不会自动写入PID文件到指定路径，需在启动命令中显式声明。

解决方案 #

修改Docker Compose中Nginx服务的启动命令，强制指定PID文件路径：

services:
  nginx:
    image: nginx:1.25
    command: ["nginx", "-g", "daemon off; pid /var/run/nginx.pid;"]

启动后验证：进入容器执行cat /var/run/nginx.pid，若能看到PID号，说明配置生效，此时nginx -s reload、nginx -s usr1均可正常执行。

二、验证DNS缓存刷新：重载是否足够？ #

Nginx的DNS缓存逻辑：

• 若proxy_pass等指令使用域名，默认会在启动时解析并缓存IP，直至重启或重载配置
• 若要让Nginx定期自动刷新DNS，需在server或location块中配置resolver并设置缓存有效期，示例：

location / {
    proxy_pass http://backend-service;
    resolver 127.0.0.11 valid=30s; # 调用Docker内置DNS服务器，每30秒刷新一次解析
}

配置完成后，执行nginx -s reload会强制Nginx重新加载配置并触发DNS解析，无需重启容器。若未配置resolver，仅重载配置无法刷新DNS缓存，此时才需要重启Nginx。

三、修复Logrotate问题 #

当PID文件正常生成后，挂载自定义logrotate配置到容器（替代默认配置），确保配置指向正确的PID路径：

/var/log/nginx/*.log {
    daily
    missingok
    rotate 52
    compress
    delaycompress
    notifempty
    create 0640 nginx nginx
    sharedscripts
    postrotate
        [ -f /var/run/nginx.pid ] && kill -USR1 `cat /var/run/nginx.pid`
    endscript
}

在Docker Compose中添加挂载配置：

volumes:
  - ./custom-logrotate-nginx:/etc/logrotate.d/nginx

四、CI/CD流程中的重载触发 #

在CI/CD脚本中，直接进入容器执行重载命令即可：

docker compose exec nginx nginx -s reload

若需发送HUP信号（PID文件存在时可靠）：

docker compose kill -s HUP nginx

总结 #

1. 调整Nginx启动命令强制生成PID文件，解决重载和logrotate的依赖问题
2. 配置resolver参数让Nginx自动刷新DNS缓存，此时重载即可生效，无需重启容器
3. 同步修复logrotate配置，确保能通过PID文件发送USR1信号刷新日志

内容的提问来源于stack exchange，提问作者Kevin Day