二进制平滑升级Nginx是用新版本可执行文件替换旧版并保持连接不中断，核心是通过USR2、WINCH、QUIT信号实现主进程优雅切换，老进程处理完长连接后退出。
二进制平滑升级 Nginx，本质是用新版本可执行文件替换旧版，同时保持所有已有连接持续工作。关键不在于“重启服务”，而在于让主进程优雅交出控制权，由新主进程接管监听端口和后续请求，老进程只处理尚未完成的长连接（如 WebSocket、HTTP/2 流、大文件下载等），直至自然退出。
确认当前运行状态与版本信息
先查清正在跑的是哪个二进制、配置在哪、PID 是多少，避免误操作：
- nginx -V：显示编译参数，尤其注意 --prefix 路径，后续新二进制要放对位置
- ps aux | grep nginx：确认 master 进程 PID 和 worker 进程状态（通常一个 master + 多个 worker）
- ls -l $(which nginx)：看当前 nginx 可执行文件路径及权限，新文件需同用户、同权限
- nginx -t：验证新配置是否兼容（如果配置有变更，务必提前测试）
编译并部署新版本二进制文件
不要直接覆盖原文件——系统可能正通过 inode 加载旧二进制，覆盖会破坏运行中进程。正确做法是：把新二进制放到同一目录下，重命名为 nginx.new 或直接替换但保留原名，再发信号触发升级。
- 下载源码后，用 和旧版完全一致的 ./configure 参数（特别是 --prefix、--modules-path、--with-xxx 等），否则模块加载或路径会出错
-
make 编译完成后，不要 make install；直接复制 objs/nginx 到目标路径，例如：
cp objs/nginx /usr/sbin/nginx.new - 校验新旧二进制功能一致性：
/usr/sbin/nginx.new -V对比输出，/usr/sbin/nginx.new -t确保能加载当前配置 - 赋予相同权限：
chown root:root /usr/sbin/nginx.new && chmod 755 /usr/sbin/nginx.new
触发平滑升级（USR2 + WINCH + QUIT 流程）
这是核心步骤，Nginx 内置信号机制支持原子切换：
-
发送 USR2 到旧 master 进程：
kill -USR2 $(cat /var/run/nginx.pid)
→ 旧 master 启动新 master（使用新二进制），两个 master 并存；新 master 启动 worker，开始监听相同端口（内核支持 SO_REUSEPORT 或 fork+bind 共享 socket） -
发送 WINCH 到旧 master：
kill -WINCH $(cat /var/run/nginx.pid)
→ 旧 master 指令其所有 worker 优雅退出（不再接受新连接，处理完已有请求后关闭） -
确认旧 worker 全部退出后，发送 QUIT 到旧 master：
kill -QUIT $(cat /var/run/nginx.pid.oldbin)
→ 旧 master 进程终止；此时只剩新 master 及其 worker 在运行 - 过程中可用
ps aux | grep nginx观察进程变化：
初始：master(old) + workers(old)
USR2 后：master(old) + workers(old) + master(new) + workers(new)
WINCH 后：master(old) + master(new) + workers(new)，workers(old) 逐个消失
QUIT 后：仅剩 master(new) + workers(new)
回滚与验证要点
升级不是终点，验证和兜底能力同样重要：
-
验证新进程实际运行版本：
ps aux | grep nginx看启动命令路径，或访问curl -I http://localhost查 Server 头（若开启 server_tokens） - 检查日志是否有异常：关注 error.log 中 “starting new master process”、“gracefully shutting down”、“exit” 等关键词
-
回滚方法明确且快速：若发现问题，立刻
kill -QUIT $(cat /var/run/nginx.pid.oldbin)终止新 master，旧 master 仍在内存中（只要没发过 QUIT），会自动恢复接管；或者直接kill -HUP $(cat /var/run/nginx.pid)让旧 master 重载配置并继续服务 -
注意 pid 文件变化：升级后
/var/run/nginx.pid指向新 master，/var/run/nginx.pid.oldbin指向旧 master；别删错文件
