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)输出目录

各个目录用途:

  1. SPECS:写 nginx.spec,定义版本、编译参数、依赖、要安装哪些文件、% post 脚本
  2. SOURCES:放 nginx-1.30.7.tar.gz、补丁、自定义 logrotate 配置、service 文件
  3. BUILD:rpmbuild 自动把源码解压到这里,执行 configure/make 编译
  4. RPMS:编译成功,生成 nginx-1.30.7-1.el7.ngx.x86_64.rpm
  5. 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 关掉的话全程不用考虑,干净利落。