讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

SoundView
SoundView

字幕擦除翻译、配音口型同步

Nginx 平滑重载怎么避免连接丢失

轻磊同学_3660

轻磊同学_3660

发布时间:2026-11-20 09:10:01

|

523人浏览过

|

来源于php中文网

原创

nginx 平滑重载避免连接丢失的核心做法是:先启动一个配置更新后的新 nginx 进程,再向旧主进程发送 usr2 信号触发升级,随后向旧主进程发送 winch 信号优雅关闭其工作进程,最后确认无残留后终止旧主进程。该流程利用操作系统对已建立连接的 socket 文件描述符继承机制,确保在旧进程退出前,新进程已接管所有活跃连接的处理。

Nginx 平滑重载怎么避免连接丢失

如何安全地替换二进制文件并启动新进程

实现平滑重载的第一步是替换可执行文件并启动新实例。操作时,需将编译好的新版 nginx 二进制文件覆盖旧文件(或指向新路径),然后使用 -t 参数验证新配置的正确性,接着通过 -c 指定配置文件启动新的主进程。此时系统中会同时存在两个 Nginx 主进程:旧的(PID 为原 PID)和新的(PID 为新分配的 PID)。新进程启动后会尝试绑定相同的端口,若绑定成功,说明资源未被旧进程独占阻塞,或者旧进程已释放监听套接字(通常由信号触发)。在实际操作中,更常见的平滑升级流程是先不直接启动新进程,而是通过信号机制协调。

cp /path/to/new/nginx /usr/sbin/nginx
/usr/sbin/nginx -t
/usr/sbin/nginx -s reload

上述命令中,nginx -s reload 实际上是向当前运行的主进程发送 HUP 信号。但为了实现真正的“零停机”且完全替换二进制文件,推荐采用手动步骤或使用脚本自动化。手动步骤如下:首先备份旧的二进制文件,放入新的二进制文件,然后启动一个新的 Nginx 实例(此时旧实例仍在运行并持有监听端口,新实例启动会失败,除非旧实例先释放端口)。因此,标准的平滑升级(Binary Upgrade)流程是使用 USR2 信号。具体操作是:先编译好新的 Nginx,替换掉旧的 nginx 二进制文件。然后向旧的主进程发送 USR2 信号。旧主进程收到信号后,会重新打开日志文件,并启动一个新的主进程(即新版本的主进程)。新主进程启动成功后,旧主进程会进入一种“等待”状态,不再处理新请求,但会继续处理已有的连接。接下来,需要向旧主进程发送 WINCH 信号,使其工作进程逐个优雅退出。当所有旧工作进程都退出后,旧主进程自身也会退出。此时,新版本的主进程和工作进程正在处理所有流量,连接不会丢失。

预期结果:系统中有两个 Nginx 主进程短暂共存,随后旧进程退出,新进程接管所有连接,客户端无感知。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

为什么 USR2 和 WINCH 信号能实现无缝切换

理解 USR2 和 WINCH 信号的作用机制是掌握平滑重载的关键。USR2 信号的作用是触发“二进制升级”。当旧的主进程收到 USR2 信号时,它不会立即停止,而是会执行以下操作:1. 重新解析配置文件;2. 启动一组新的工作进程(这些工作进程使用的是新的二进制代码);3. 旧的主进程将自己重命名为带有 .oldbin 后缀的状态,并进入“降级”模式,不再接受新的 HUP 或 QUIT 信号,但会继续处理现有的连接。新启动的工作进程会继承旧主进程的监听套接字(socket),因为 Linux 内核中,文件描述符在进程间是可以继承的。这意味着新工作进程可以直接使用已经绑定的端口,无需经历 TIME_WAIT 等状态,从而实现无缝接管。WINCH 信号的作用是“优雅关闭工作进程”。当旧主进程收到 WINCH 信号时,它会通知其下属的所有旧工作进程开始优雅退出。工作进程在收到此信号后,会停止接受新的连接,但会继续处理完当前正在处理的请求。只有当所有当前请求都处理完毕后,工作进程才会关闭自己的连接并退出。这个过程确保了没有正在传输的数据被中断。当所有旧工作进程都退出后,旧主进程自身也会退出,因为它已经没有子进程需要管理了。

# 假设旧 Nginx 主进程 PID 为 12345
kill -USR2 12345
# 此时新 Nginx 主进程已启动,PID 可能为 12346
# 等待一段时间,让新进程稳定
sleep 5
# 向旧主进程发送 WINCH 信号,优雅关闭其工作进程
kill -WINCH 12345
# 等待所有旧工作进程退出
wait
# 确认旧主进程已退出,可选:强制终止(如果未自动退出)
kill -TERM 12345

预期结果:USR2 后,新旧主进程共存,新进程处理新请求,旧进程处理剩余旧请求。WINCH 后,旧工作进程逐个退出,连接无丢失。最终只剩新 Nginx 进程。

如果在重载过程中新进程启动失败怎么办

在平滑重载过程中,最担心的情况是新 Nginx 进程启动失败,例如由于配置文件语法错误、端口冲突或权限问题。如果新进程未能成功启动,旧进程仍然在正常运行,服务不会中断。为了应对这种情况,Nginx 提供了一套回滚机制。当向旧主进程发送 USR2 信号后,如果新主进程启动失败,旧主进程会保持原状,继续提供服务。此时,可以通过向旧主进程发送 HUP) 信号来重新加载配置(如果之前是因为配置错误导致新进程启动失败,修正配置后再次发送 <code>USR2 即可)。另一种情况是,如果新进程启动成功,但后续发现严重问题,可以向旧主进程发送 HUP 信号,这会使得旧主进程重新加载配置并启动新的工作进程(这些新工作进程仍然是旧版本的代码),从而回退到旧版本的服务状态。此外,还可以向新主进程发送 QUIT 信号,直接终止新进程,让旧主进程继续接管所有连接。这种设计确保了在任何阶段,至少有一个健康的 Nginx 实例在运行,保障了服务的连续性。

# 场景:新进程启动失败,需要回滚
# 1. 检查新进程是否启动
ps aux | grep nginx
# 2. 如果新进程未启动,修复配置后重试
nginx -t
nginx -s reload # 或者再次发送 USR2

# 场景:新进程启动成功,但发现严重 bug,需要回退到旧版本
# 1. 向新主进程发送 QUIT 信号,终止新进程
kill -QUIT <new_master_pid>
# 2. 旧主进程会自动接管所有连接,服务恢复

# 场景:想强制回退到旧版本,即使新进程已在运行
# 1. 向旧主进程发送 HUP 信号,它会重新加载配置并启动新的旧版工作进程
kill -HUP <old_master_pid>

预期结果:通过灵活使用 USR2、HUP、QUIT 和 WINCH 信号组合,可以在任何阶段实现升级、回滚或故障恢复,确保服务高可用。

Nginx 平滑重载怎么避免连接丢失Nginx 平滑重载怎么避免连接丢失

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4387

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

7365

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

4018

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn