平滑升级Nginx是在不中断服务前提下替换二进制文件，核心依赖master-worker模型与USR2/WINCH/QUIT信号流程；需严格复用旧版configure参数编译新版，确保模块兼容，并做好验证与nginx.old回滚准备。
平滑升级 Nginx 指的是在不中断服务、不丢请求的前提下，将正在运行的旧版 Nginx 替换为新版二进制文件。核心原理是利用 Nginx 的 master-worker 进程模型 和 信号机制，先用新版本二进制替换旧文件，再通过 HUP 或 USR2 + WINCH + QUIT 流程完成热切换。
确认当前运行版本和安装方式
升级前必须明确两点：当前 Nginx 是如何安装的（源码编译？包管理器？）、是否启用了关键模块（如 ngx_http_v2_module、openssl、zlib 等）。否则新版本可能缺失功能或无法启动。
- 执行
nginx -V（大写 V），查看完整编译参数（--configure arguments）、模块列表、OpenSSL 版本等 - 检查 Nginx 启动用户、配置路径（
-c）、pid 文件位置（pid /run/nginx.pid;） - 若用 systemd 管理，确认 service 文件中未硬编码二进制路径（如
ExecStart=/usr/sbin/nginx）
下载并编译新版 Nginx 源码
新版本必须使用与旧版**完全一致的 configure 参数**（除需升级的模块外），否则 worker 进程可能因模块 ABI 不兼容而崩溃。
- 从 nginx.org 下载目标版本源码包（如
nginx-1.24.0.tar.gz），解压后进入目录 - 复制旧版
nginx -V输出中的--configure arguments，粘贴并修改必要项（例如升级 OpenSSL 路径、启用新模块） - 执行
./configure ...→make（不要 make install） - 编译完成后，新二进制在
objs/nginx，备份旧二进制：cp /usr/sbin/nginx /usr/sbin/nginx.old
执行平滑热升级流程
确保新二进制可执行且配置无误后，按标准信号顺序操作：
- 用新二进制覆盖旧文件：
cp objs/nginx /usr/sbin/nginx - 测试新二进制语法和配置：
/usr/sbin/nginx -t（必须成功） - 发送
USR2信号启动新 master 进程：kill -USR2 $(cat /run/nginx.pid)（此时新旧 master、worker 并存） - 发送
WINCH信号优雅关闭旧 worker：kill -WINCH $(cat /run/nginx.pid.oldbin) - 确认旧 worker 全部退出（
ps aux | grep nginx只剩新 master + 新 worker）后，发送QUIT终止旧 master：kill -QUIT $(cat /run/nginx.pid.oldbin)
验证与回滚准备
升级不是终点，验证和兜底同样关键：
- 检查进程：新 master 的 PID 应已写入
/run/nginx.pid，旧 pid 文件（.oldbin）应消失 - 访问业务接口、查看 access.log 和 error.log，确认无 502/503、连接重置等异常
- 执行
nginx -V确认版本号和模块已更新 - 保留
nginx.old文件至少 24 小时；若出问题，立即执行：kill $(cat /run/nginx.pid) && cp /usr/sbin/nginx.old /usr/sbin/nginx && nginx
整个过程通常在秒级完成，对客户端透明。难点不在操作步骤，而在编译参数一致性、配置兼容性判断和异常响应速度。只要做好前置确认和回滚准备，风险可控。
