nginx版本升级步骤

nginx版本升级步骤

版本升级是保障 Web 服务安全性与稳定性的常规运维操作。Nginx 软件更新通常包含安全漏洞修复、性能优化与新功能支持，长期不升级可能带来隐患。本文介绍一套可执行的升级流程，适用于主流 Linux 发行版及源码编译安装的 Nginx 服务。请根据您的实际环境选择对应方案。

一、升级前准备

升级前务必确认以下信息，避免因环境差异造成服务异常：

• 当前 Nginx 版本：执行 `nginx -v` 查看。
• 操作系统版本：使用 `cat /etc/os-release` 获取。
• Nginx 安装方式：通过系统包管理器（如 apt、yum）安装，还是源码编译安装。
• 现网配置备份：复制 `/etc/nginx/` 或编译安装时指定的配置目录。
• 业务可中断窗口：尽管 Nginx 支持 `-s reload` 平滑重载，但升级过程仍需避免业务高峰。

二、备份现有环境

无论采用哪种方式升级，备份都不可省略。推荐将配置、日志及可执行文件完整备份。 bash

备份配置目录（包含主配置、站点配置、证书等）

cp -a /etc/nginx /etc/nginx.bak.$(date +%Y%m%d)

备份当前二进制文件（便于回滚）

cp /usr/sbin/nginx /usr/sbin/nginx.bak.$(date +%Y%m%d)

如使用源码编译安装，需记录编译参数

nginx -V 2>&1 | tee /tmp/nginx_build_args.txt

三、升级步骤

1. 通过系统包管理器升级（适用于 yum/apt 安装）

此方式操作简单，会同步更新相关依赖，推荐大多数生产环境使用。 bash

CentOS / RHEL / Rocky / Fedora 等

sudo yum clean all sudo yum update nginx

Debian / Ubuntu 等

sudo apt update sudo apt upgrade nginx 若 Nginx 来自官方源或第三方源（如 nginx.org），需先确认源配置正确。升级完成后，可跳过源码编译方式的步骤，直接进入第四步验证与重载。

2. 通过源码编译升级（适用于自定义编译安装）

源码编译升级步骤稍复杂，但适合开启了第三方模块或自定义编译参数的环境。 首先备份旧版本并下载新版本源码： bash

建议前往官网 https://nginx.org/en/download.html 获取最新稳定版

cd /usr/local/src wget https://nginx.org/download/nginx-1.26.2.tar.gz # 示例版本，请替换 tar -xzf nginx-1.26.2.tar.gz cd nginx-1.26.2

查看旧版本编译参数，自动补充完整

./configure --prefix=/usr/local/nginx \ --with-http_ssl_module \ --with-http_v2_module \ --with-stream \ --with-http_realip_module 此处请对照先前保存的 `nginx -V` 输出，将缺失的模块参数完整填写。如果不确定，可先执行 `nginx -V` 查看原参数，原样复制到 configure 中。 然后编译安装： bash make -j$(nproc)

先停止服务再替换二进制（平滑升级另有方法，此处介绍稳妥方式）

sudo kill $(cat /usr/local/nginx/logs/nginx.pid) sudo make install

如未修改安装路径，make install 会覆盖旧的二进制

注意：`make install` 会覆盖安装目录下的文件，若您需要保留旧二进制，请提前备份。同时，源码升级不会覆盖原有配置文件，但建议升级前再次确认配置兼容性。

四、验证与重载

升级后不要立即结束，需确认新版本正常工作。 bash

1. 检查配置语法

sudo nginx -t

2. 若使用源码安装，且 nginx 不在 PATH 中，请指定路径

sudo /usr/local/nginx/sbin/nginx -t

3. 启动（若已停止）或平滑重载配置

sudo nginx # 首次启动使用 sudo nginx -s reload # 服务已在运行时，使用 reload 使新版本生效 如果之前已停止服务，启动命令因安装方式不同而不同：系统包管理器安装的可使用 `systemctl start nginx`；源码安装的则执行上述 `nginx` 命令。 最后再确认版本： bash nginx -v 观察业务请求是否正常，并检查错误日志： bash tail -f /var/log/nginx/error.log 若没有异常，升级顺利完成。

五、回滚措施

升级后若出现兼容性问题，可按如下方式回滚至旧版本：

• 系统包管理器安装：使用包管理器的降级功能。例如 yum 下安装指定版本：`sudo yum install nginx-1.24.0`，然后重启服务。
• 源码编译安装：将之前备份的旧二进制放到原路径，并重启服务。

bash

源码安装回滚示例

sudo cp /usr/sbin/nginx.bak.20250101 /usr/local/nginx/sbin/nginx sudo nginx

六、注意事项

• 升级前务必阅读 Nginx 的官方 `CHANGES` 文件，确认是否有影响现有配置的重大调整。
• 第三方模块（如 Lua、PageSpeed）可能无法兼容新版本内核，请提前在测试环境验证。
• 配置文件在新版本中可能产生新的 warning，但这些提示通常不影响服务，建议尝试优化。
• 不要在生产环境中直接升级，先在预发布环境完整演练一遍。
• 升级期间若改动原始编译参数导致功能缺失，后续排查将费时费力，务必谨慎比对。

按以上流程操作，可以显著降低 Nginx 升级过程中的风险。建议将升级操作纳入自动化运维工具，并保留完整的升级记录。如有进一步需求，随时告诉我。