1. 构建Nginx 1.30.7 RPM包
1.1 背景
由于Nginx存在安全漏洞需要升级至新版本,目前最新的稳定版本为1.30.7。但是主机老旧,操作系统版本还是Centos7.9,而官网提供的RPM包基于Centos 7最高版本为1.26,不能满足要求。考虑到需要升级的Nginx数量较多,决定基于Centos 7.9自行构建一个1.30.7版本的Nginx RPM包。
1.2 准备工作
- 下载SRPM文件
官网仓库中提供的基于Centos 7的srpm包,最高版本只到1.26,我们选择相对比较接近的基于Centos 8的的srpm文件,
在https://nginx.org/packages/centos/8/SRPMS/下载nginx-1.30.7-1.el8.ngx.src.rpm文件。
mkdir -pv /data/pkgs/
cd /data/pkgs/
wget https://nginx.org/packages/centos/8/SRPMS/nginx-1.30.7-1.el8.ngx.src.rpm
- 依赖安装
# 构建依赖安装
yum install -y rpm-build rpmdevtools
# 安装依赖安装
yum -y install openssl-devel zlib-devel pcre2-devel
- SRC RPM安装
# 一键在当前用户家目录生成标准rpmbuild打包目录树
rpmdev-setuptree
执行后自动生成 ~/rpmbuild 下面 5 个标准目录
~/rpmbuild/
├── BUILD # 源码解压、编译临时目录(编译过程在这里)
├── RPMS # 编译完成后,输出二进制rpm包
├── SOURCES # 放源码tar包、补丁patch、额外配置文件(nginx.conf、logrotate模板等)
├── SPECS # 存放 spec 打包脚本(核心,定义怎么编译、安装、文件清单)
└── SRPMS # 源码rpm包(src.rpm)输出目录
各个目录用途:
- SPECS:写
nginx.spec,定义版本、编译参数、依赖、要安装哪些文件、% post 脚本 - SOURCES:放
nginx-1.30.7.tar.gz、补丁、自定义 logrotate 配置、service 文件 - BUILD:rpmbuild 自动把源码解压到这里,执行 configure/make 编译
- RPMS:编译成功,生成
nginx-1.30.7-1.el7.ngx.x86_64.rpm - SRPMS:源码包,用于分发、二次重新编译
安装SRC RPM包:
cd /data/pkgs/
rpm -ivh nginx-1.30.7-1.el8.ngx.src.rpm
此时在 /root/rpmbuild目录下,SOURCES目录下会产生源代码 压缩包、脚本、文件等,SPECS目录会产生spec文件。
1.3 构建
Centos 8的spec文件通用性很好,可以直接在Centos 7上进行构建无需修改。
使用rpmbuild -bb nginx.spec命令进行构建,如果缺少依赖包,按照提示补全。
rpmbuild -bb ~/rpmbuild/SPECS/nginx.spec
例如我的环境下缺少openssl-devel zlib-devel pcre2-devel使用对应Yum命令安装即可。
完成后在 ~/rpmbuild/RPMS/x86_64目录下对应架构就会生成编译好的rpm包:
# ls -l ~/rpmbuild/RPMS/x86_64/nginx-1.30.7-1.el7.ngx.x86_64.rpm
-rw-r--r-- 1 root root 888024 Nov 20 15:25 /root/rpmbuild/RPMS/x86_64/nginx-1.30.7-1.el7.ngx.x86_64.rpm
2. 平滑升级
2.1 说明
如果直接rpm -Uvh 只做了一件事情:把 1.30.7 的文件写进磁盘 。Nginx进程根本不知道磁盘上的二进制变了 ---> 进程存活时,内核不会替换它已经加载进内存的text段(只读代码段)。所以走完这步之后系统里是「磁盘上 1.30.7、跑的还是 1.30.6」的混合态,漏洞没修。
为什么 rpm 装完还需要动进程
rpm -Uvh --noscripts ...
↓
磁盘上 /usr/sbin/nginx 变成 1.30.7 ✅
但内存里运行的 nginx worker 还跑着 1.30.6 的代码 ❌
漏洞修复 = 磁盘文件 + 运行进程 都是 1.30.7,缺一不可
rpm只做了上半段,下半段必须你用 nginx 原生的 USR2 / WINCH / QUIT 信号控制,这就是"平滑升级"的本质—— 让新二进制接管流量的同时,旧二进制优雅退场,存量连接不中断 。
平滑升级有2条路径:USR2 热升级(零停机) 和 直接 restart(秒级中断)
| 说明 | USR2 热升级(零停机) | 直接 restart(秒级中断) |
|---|---|---|
| 存量连接 | 优雅 drain,不中断 | 主动切断,客户端有感知 |
| 复杂度 | 多 5 步信号控制 | 1 条 systemctl 命令 |
| 系统状态 | rpm DB 已是 1.30.7,进程也已是 1.30.7 | 同上 |
| 适用场景 | 严格零停机要求 | 业务低峰期可以接受 |
看你情况选一条走, 两条只走其一,下面是一份完整可复制的USR2热升级路径操作过程。
2.2 USR2热升级完整步骤
2.2.1 前置确认
前置确认需要确认5条内容,每一条都要确认。
# 0.1 当前版本 二进制路径
nginx -v # 必须是 nginx/1.30.6
which nginx # 通常 /usr/sbin/nginx,记下这个路径
# 0.2 备份(回滚生命线)
cp /usr/sbin/nginx /usr/sbin/nginx.1.30.6.bak
cp -r /etc/nginx /etc/nginx.bak.$(date +%Y%m%d%H%M)
# 0.3 拿到 master PID(nginx 的 PID 文件位置二选一)PID根据自己环境来
OLDPID=$(cat /etc/nginx/pid/nginx.pid)
echo '当前 master PID = $OLDPID'
# 2422705
# 0.4 确认 SELinux 确实 disabled
getenforce # 期望输出 'Disabled'
# 0.5 新二进制先用你的配置跑通(失败就别往下走)
mkdir -pv /data/pkgs/nginxnew
cd /data/pkgs/nginxnew
rpm2cpio ~/rpmbuild/RPMS/x86_64/nginx-1.30.7-1.el7.ngx.x86_64.rpm | cpio -idmv
[root@webserver1 nginxnew]# ./usr/sbin/nginx -v # 期望:1.30.7
nginx version: nginx/1.30.7
[root@webserver1 nginxnew]# ./usr/sbin/nginx -t -c /etc/nginx/nginx.conf # 用你现有配置测新二进制,必须通过
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
2.2.2 安装包
前置检查全部通过,开始可以正式升级,装包(磁盘文件变成 1.30.7,不碰进程)。
rpm -Uvh --noscripts \
--excludepath /etc/nginx \
--excludepath /usr/lib/systemd/system \
~/rpmbuild/RPMS/x86_64/nginx-1.30.7-1.el7.ngx.x86_64.rpm
参数说明:
--noscripts: 跳过 rpm 包内置的所有脚本:%pre %post %preun %postun
--excludepath: 不覆盖 /etc/nginx 配置目录、不覆盖 systemd 服务单元文件
到这里磁盘上已经是 1.30.7,但进程还是 1.30.6。
如果还改过 /etc/sysconfig/nginx(CentOS 7 常见),再补一条:
# 没有就忽略
rpm -Uvh --noscripts ... --excludepath /etc/sysconfig/nginx xxx.rpm
验证:rpm DB 已是 1.30.7,但 ps 还全是 1.30.6 进程:
# rpm -q nginx 期望:nginx-1.30.7-1.el7.ngx
nginx-1.30.7-1.el7.ngx.x86_64
# ps -ef | grep '[n]ginx:' ← 还是旧进程,正常
root 2422705 1 0 11:17 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
www-data 2422706 2422705 0 11:17 ? 00:00:24 nginx: worker process
www-data 2422707 2422705 0 11:17 ? 00:02:29 nginx: worker process
www-data 2422708 2422705 0 11:17 ? 00:00:30 nginx: worker process
www-data 2422709 2422705 0 11:17 ? 00:01:21 nginx: worker process
www-data 2422710 2422705 0 11:17 ? 00:00:00 nginx: cache manager process
2.2.3 USR2 拉起新 master(修复漏洞的第一步)
nginx收到USR2信号会fork一个新 master,加载磁盘上的新二进制, 旧master继续服务,旧连接不中断;新请求会被新master接住。
执行命令:
kill -USR2 $OLDPID
sleep 2
验证:PID 文件被新 master 改写,旧 PID 被挪到 .oldbin
# ls /etc/nginx/pid/*
/etc/nginx/pid/nginx.pid /etc/nginx/pid/nginx.pid.oldbin
NEWPID=$(cat /etc/nginx/pid/nginx.pid)
if [ '$NEWPID' != '$OLDPID' ]; then
echo '✅ 新 master 起来了,PID=$NEWPID (旧=$OLDPID)'
else
echo '❌ 失败:USR2 后 PID 没变,查 nginx error.log 尾部'
tail -30 /data/logs/nginx/error.log
fi
此时 ps 应该有 2 个 master + 各自的 worker
# ps -ef |grep nginx
root 2422705 1 0 11:17 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
www-data 2422706 2422705 0 11:17 ? 00:00:25 nginx: worker process
www-data 2422707 2422705 0 11:17 ? 00:02:33 nginx: worker process
www-data 2422708 2422705 0 11:17 ? 00:00:31 nginx: worker process
www-data 2422709 2422705 0 11:17 ? 00:01:24 nginx: worker process
www-data 2422710 2422705 0 11:17 ? 00:00:00 nginx: cache manager process
root 2779215 2422705 0 20:36 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
www-data 2779216 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779217 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779218 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779219 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779220 2779215 0 20:36 ? 00:00:00 nginx: cache manager process
www-data 2779221 2779215 0 20:36 ? 00:00:00 nginx: cache loader process
root 2779292 2778305 0 20:36 pts/3 00:00:00 grep --color=auto nginx
业务探活:
# curl -sI http://127.0.0.1/ | head -1
HTTP/1.1 200 OK
2.2.4 WINCH 优雅关闭旧 worker(存量请求 drain)
给旧 master 发 WINCH:让它 fork 出来的 worker 标记为 "shutting down" , 这些 worker 继续处理手上的连接,但不再接新请求,处理完自然退出。
kill -WINCH $OLDPID
echo '⏳ 等待旧 worker 全部退出(循环最多 60 次,每次等 2 秒)'
# 循环等旧 worker 退出
for i in $(seq 1 60); do
LEFT=$(ps -ef | grep 'worker process is shutting down' | grep -v grep | wc -l)
if [ $LEFT -eq 0 ]; then
echo '✅ 第 $i 次检查:旧 worker 已全部退出'
break
fi
echo '还有 $LEFT 个旧 worker 在 drain,第 $i 次检查...'
sleep 2
done
echo '✅ 旧 worker 优雅退出完毕'
# ps -ef |grep nginx
root 2422705 1 0 11:17 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
root 2779215 2422705 0 20:36 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
www-data 2779216 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779217 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779218 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779219 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779220 2779215 0 20:36 ? 00:00:00 nginx: cache manager process
root 2779974 2778305 0 20:37 pts/3 00:00:00 grep --color=auto nginx
2.2.5 QUIT 让旧 master退出(彻底清掉旧进程)
kill -QUIT $OLDPID
sleep 2
最终进程状态:只剩 1 个 master + 它的 worker
# ps -ef | grep '[n]ginx:'
root 2779215 1 0 20:36 ? 00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
www-data 2779216 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779217 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779218 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779219 2779215 0 20:36 ? 00:00:00 nginx: worker process
www-data 2779220 2779215 0 20:36 ? 00:00:00 nginx: cache manager process
验证:
# nginx -v # 确认进程里是 1.30.7
nginx version: nginx/1.30.7
# curl -sI http://127.0.0.1/ | head -1 # 业务正常
HTTP/1.1 200 OK
# pgrep -a nginx # 确认没有残留旧 PID
2779215 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
2779216 nginx: worker process
2779217 nginx: worker process
2779218 nginx: worker process
2779219 nginx: worker process
2779220 nginx: cache manager process
2.2.6 收尾操作
systemctl视角的PIDFile已经是新master,status 会显示 running, 如果想让 systemd 日志干净,低峰期可以:
systemctl restart nginx
确认一切正常后清理备份:
rm -f /usr/sbin/nginx.1.30.6.bak
rm -rf /etc/nginx.bak.YYYYMMDDHHMM
3. 三个信号到底在做什么
| 信号 | 发给谁 | 做了什么 | 对流量的影响 |
|---|---|---|---|
| USR2 | 旧master | fork出新master,加载新二进制 | 无影响,旧master继续服务 |
| WINCH | 旧master | 旧 worker 标记为 shutting down,不再接新请求 | 无影响 ,新请求被新 master 接走 |
| QUIT | 旧master | 旧 master 等全部旧 worker 退出后自己退出 | 无影响 ,旧 worker 已 drain 完 |
整个过程中 没有任何时刻服务中断 ,这就是"平滑"的含义。NGINX2Root 公告里强调的"不能只 reload,必须让旧 worker 退出"——USR2+WINCH+QUIT 这一套恰恰满足了这个要求。
4. 出问题时怎么回滚
情况 A:新 master 起不来(USR2 后 PID 没变,或者 curl 探活失败)
磁盘上已是 1.30.7 但新进程起不来,旧 master 还在跑 1.30.6,业务没断。直接让 rpm DB 和磁盘恢复:
# 方法 1:如果 1.30.6 的 rpm 还在
rpm -Uvh --noscripts \
--excludepath /etc/nginx \
--excludepath /usr/lib/systemd/system \
~/rpmbuild/RPMS/x86_64/nginx-1.30.6-*.rpm
# 方法 2:用备份覆盖
cp /usr/sbin/nginx.1.30.6.bak /usr/sbin/nginx
# 然后 USR2/WINCH/QUIT 把 1.30.6 替换回来,流程同上
情况 B:新旧 master 并存期间业务有异常
# 让旧 master 重新拉起 worker 接管流量
kill -HUP $OLDPID
# 退出新 master
kill -QUIT $(cat /etc/nginx/pid/nginx.pid)
# 业务恢复到 1.30.6,再排查问题
情况 C:旧 master 已经 QUIT 了(只能靠备份还原)
cp /usr/sbin/nginx.1.30.6.bak /usr/sbin/nginx
systemctl restart nginx
# 此时 rpm DB 和实际版本不一致,业务先恢复,后续用 rpm -Uvh 修正 DB
5. 关于 systemd
--noscripts 跳过了 rpm %post 里的systemctl daemon-reload 和try-restart ,这是我们故意要的——让 rpm 别自作主张重启打断热升级节奏。rpm DB 虽已是 1.30.7,但 systemd 通过PIDFile 跟踪的是运行中的 master PID,systemctl status nginx 会显示 running,systemctl reload nginx 也能正常工作。唯一的小瑕疵是systemctl 视角不知道磁盘版本变了,但这不影响任何功能,低峰期跑一次systemctl restart nginx 就彻底一致了。
一句话总结 :rpm -Uvh 换磁盘 →USR2 起新进程 →WINCH 清旧 worker →QUIT 清旧 master,四步走完漏洞真正消失。SELinux 关掉的话全程不用考虑,干净利落。