Nginx如何更新与升级

Nginx 更新与升级实战指南

一 升级前准备

• 备份关键资产：打包配置与站点数据，备份旧二进制以便回滚。示例：tar -zcvf /data/backup/nginx-conf-$(date +%F).tar.gz /usr/local/nginx/conf/；cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.old-$(nginx -v 2>&1 | awk ‘{print $3}’ | cut -d’/’ -f2)；必要时备份日志与静态资源。
• 核查当前环境：获取版本与编译参数（nginx -v、nginx -V），确保第三方模块与目标版本兼容；查阅变更日志确认指令/行为变更。
• 安装编译依赖：CentOS/RHEL 执行 yum install -y gcc pcre pcre-devel zlib zlib-devel openssl openssl-devel；Ubuntu/Debian 执行 apt install -y build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev openssl libssl-dev。
• 选择策略：无自定义模块优先用包管理器升级；有自定义模块或需新增模块采用源码编译升级；对可用性要求高的场景执行平滑升级。

二 升级方案总览

三 操作步骤

• 包管理器升级（无自定义模块）

  • CentOS/RHEL：yum clean all && yum makecache；yum update -y nginx；nginx -t && systemctl reload nginx。
  • Ubuntu/Debian：apt update；apt install --only-upgrade nginx -y；nginx -t && systemctl reload nginx。
  • 升级后核对：nginx -V 与 systemctl status nginx。

• 源码编译升级（普通，允许短时中断）

  • 下载并解压目标版本：wget https://nginx.org/download/nginx-.tar.gz && tar zxvf nginx-.tar.gz && cd nginx-。
  • 复用旧编译参数：复制旧版 nginx -V 输出的参数，必要时仅追加新模块，例如：./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module --with-http_stub_status_module --with-http_v2_module。
  • 编译与替换：make（不要 make install）；先备份旧二进制 cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak-$(date +%F)；再 cp objs/nginx /usr/local/nginx/sbin/nginx；nginx -t && 启动新进程（systemctl start nginx 或 nginx）。
  • 验证：访问业务、观察 error.log，确认新版本与模块生效（nginx -V）。

• 平滑升级（信号，零停机）

  • 准备新二进制：按上节完成 make，得到 objs/nginx；不停止旧进程。
  • 启动新 master：OLD_PID=$(cat /usr/local/nginx/logs/nginx.pid)；kill -USR2 $OLD_PID。此时会出现新旧两个 master，旧 pid 文件被重命名为 nginx.pid.oldbin。
  • 切换流量：kill -WINCH $OLD_PID 逐步关闭旧 worker；观察新 worker 是否正常接管。
  • 完成切换与回滚点：确认新版本稳定后，kill -QUIT $OLD_PID 结束旧 master；如需回滚，向旧 master 发送 HUP 让其重新拉起 worker，或 kill -USR2 切回旧 master 后再 WINCH/QUIT 新 master。

四 升级后验证与回滚

• 快速验证：nginx -t 检查语法；nginx -V 核对版本与模块；访问关键接口与健康检查页；tail -f /var/log/nginx/error.log 观察异常；必要时 systemctl status nginx。
• 失败回滚：
  • 普通升级：用备份二进制快速还原（cp nginx.bak- /usr/local/nginx/sbin/nginx），nginx -t && systemctl restart nginx。
  • 平滑升级：向旧 master 发送 HUP 重建 worker，或 kill -USR2 切回旧 master 后依次 WINCH/QUIT 新 master；回滚后再次 nginx -t 与业务验证。

五 常见问题与注意事项

• 编译参数一致性：升级时务必复用旧版 nginx -V 的完整参数，避免遗漏模块或路径变化导致启动失败。
• 第三方模块兼容：新增或升级模块（如 Brotli、GeoIP、Lua 等）需确认与目标 Nginx 版本匹配，变更后先离线验证再上线。
• 优雅退出：旧 worker 处理完现有连接再退出，避免强杀导致请求中断；必要时延长连接超时与长连接场景的等待时间。
• 配置与证书：升级后执行 nginx -t；若证书或路径变更需同步更新配置并 reload。
• 版本选择：优先选择稳定版与安全修复充分的版本；跨大版本升级前建议在测试环境验证指令与行为变更。