Nginx 版本升级

本文适用于按 Nginx 部署文档 安装的环境，安装目录为 /usr/local/nginx/，使用 systemd 管理服务。请使用 root 用户执行以下操作。

提示

升级需要短暂停止 Nginx 服务，请在维护窗口操作。仅替换 Nginx 程序，保留现有代理配置、证书及日志切割配置；自定义安装路径或模块的环境需单独确认兼容性。

升级步骤

1. 检查当前版本与配置，并备份安装目录

   /usr/local/nginx/sbin/nginx -v
   /usr/local/nginx/sbin/nginx -t
   cp -a /usr/local/nginx /usr/local/nginx.bak

   若 /usr/local/nginx.bak 已存在，请在执行备份命令前将旧备份移至其他位置。确认配置检查通过、备份成功后继续。

2. 下载并解压目标版本安装包

   Linux amd64

   wget https://pdpublic.mingdao.com/private-deployment/offline/common/nginx-1.30.6-glibc2.17-amd64.tar.gz
   tar -zxvf nginx-1.30.6-glibc2.17-amd64.tar.gz

   Linux arm64

   wget https://pdpublic.mingdao.com/private-deployment/offline/common/arm64/nginx-1.30.6-glibc2.17-arm64.tar.gz
   tar -zxvf nginx-1.30.6-glibc2.17-arm64.tar.gz

3. 使用新版本检查现有配置

   ./nginx/sbin/nginx -v
   ./nginx/sbin/nginx -p /usr/local/nginx/ -c /usr/local/nginx/conf/nginx.conf -t

   确认版本符合预期，且输出 syntax is ok 和 test is successful 后继续。如提示缺少依赖或配置不兼容，请先处理，不要停止现有服务。

4. 停止服务并替换 Nginx 程序

   systemctl stop nginx

   确认服务已停止后执行：

   cp -a ./nginx/sbin/nginx /usr/local/nginx/sbin/nginx
   /usr/local/nginx/sbin/nginx -t

   不要将安装包直接解压到 /usr/local/，以免覆盖现有配置。

5. 启动 Nginx 服务

   确认配置检查通过后执行：

   systemctl start nginx

6. 验证升级结果

   /usr/local/nginx/sbin/nginx -v
   systemctl status nginx --no-pager

   确认版本已更新、服务状态为 active (running)，并访问 HAP 系统，检查页面访问、登录及文件上传下载是否正常。

版本回退

如新版本无法启动或业务访问异常，使用 /usr/local/nginx.bak/ 中的备份恢复程序。

1. 停止 Nginx 服务

   systemctl stop nginx

2. 恢复升级前的 Nginx 程序

   确认服务已停止后执行：

   cp -a /usr/local/nginx.bak/sbin/nginx /usr/local/nginx/sbin/nginx
   /usr/local/nginx/sbin/nginx -t

3. 启动 Nginx 服务

   确认配置检查通过后执行：

   systemctl start nginx

4. 验证回退结果

   /usr/local/nginx/sbin/nginx -v
   systemctl status nginx --no-pager

   确认版本已恢复、服务状态为 active (running)，并重新检查 HAP 系统访问及业务功能是否正常。