Nginx 版本升级
本文适用于按 Nginx 部署文档 安装的环境,安装目录为 /usr/local/nginx/,使用 systemd 管理服务。请使用 root 用户执行以下操作。
提示
升级需要短暂停止 Nginx 服务,请在维护窗口操作。仅替换 Nginx 程序,保留现有代理配置、证书及日志切割配置;自定义安装路径或模块的环境需单独确认兼容性。
升级步骤
-
检查当前版本与配置,并备份安装目录
/usr/local/nginx/sbin/nginx -v/usr/local/nginx/sbin/nginx -tcp -a /usr/local/nginx /usr/local/nginx.bak若
/usr/local/nginx.bak已存在,请在执行备份命令前将旧备份移至其他位置。确认配置检查通过、备份成功后继续。 -
下载并解压目标版本安装包
- Linux amd64
- Linux arm64
wget https://pdpublic.mingdao.com/private-deployment/offline/common/nginx-1.30.6-glibc2.17-amd64.tar.gztar -zxvf nginx-1.30.6-glibc2.17-amd64.tar.gzwget https://pdpublic.mingdao.com/private-deployment/offline/common/arm64/nginx-1.30.6-glibc2.17-arm64.tar.gztar -zxvf nginx-1.30.6-glibc2.17-arm64.tar.gz -
使用新版本检查现有配置
./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后继续。如提示缺少依赖或配置不兼容,请先处理,不要停止现有服务。 -
停止服务并替换 Nginx 程序
systemctl stop nginx确认服务已停止后执行:
cp -a ./nginx/sbin/nginx /usr/local/nginx/sbin/nginx/usr/local/nginx/sbin/nginx -t不要将安装包直接解压到
/usr/local/,以免覆盖现有配置。 -
启动 Nginx 服务
确认配置检查通过后执行:
systemctl start nginx -
验证升级结果
/usr/local/nginx/sbin/nginx -vsystemctl status nginx --no-pager确认版本已更新、服务状态为
active (running),并访问 HAP 系统,检查页面访问、登录及文件上传下载是否正常。
版本回退
如新版本无法启动或业务访问异常,使用 /usr/local/nginx.bak/ 中的备份恢复程序。
-
停止 Nginx 服务
systemctl stop nginx -
恢复升级前的 Nginx 程序
确认服务已停止后执行:
cp -a /usr/local/nginx.bak/sbin/nginx /usr/local/nginx/sbin/nginx/usr/local/nginx/sbin/nginx -t -
启动 Nginx 服务
确认配置检查通过后执行:
systemctl start nginx -
验证回退结果
/usr/local/nginx/sbin/nginx -vsystemctl status nginx --no-pager确认版本已恢复、服务状态为
active (running),并重新检查 HAP 系统访问及业务功能是否正常。