ubantu系统下平滑升级nginx版本

最新推荐文章于 2025-07-02 12:04:41 发布
原创 最新推荐文章于 2025-07-02 12:04:41 发布 · 1.2k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #运维 #linux

文章详细介绍了如何在Ubuntu系统下通过二进制文件替换方式升级Nginx，包括备份现有文件、下载新版本、配置编译参数、编译新版本、替换旧文件以及处理可能出现的依赖库版本问题。此外，还提到了使用apt更新源文件的另一种升级方法。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

ubantu系统下平滑升级nginx版本

首先关于nginx升级有两种方法：

1.直接更新ubantu系统的nginx源文件，再通过apt安装直接获取nginx最新版本，需要获取nginx官网公钥

2.通过上传nginx.tar包，解压之后通过替换nginx二进制文件，make编译之后替换安装，关于第二种方法比较麻烦，因为nginx版本升级可能会导致nginx依赖的依赖库版本也要对应升级

在这里选择的是第2种方法，因为我们的服务设置了禁止访问外网ip，所以我没有办法从nginx官网获取公钥升级

第一种方法 公钥升级

1.备份nginx程序
whereis nginx
cp /usr/sbin/nginx ./backup

2.备份/etc/nginx
sudo cp -r /etc/nginx ./nginx

3.卸载
$ sudo apt remove nginx nginx-common nginx-full nginx-core

4.更新apt源 要注意codename，ubantu版本不同codename不同
# 进入目录
$ cd /etc/apt
# 备份源文件
$ sudo cp sources.list sources.list.bak
# 编辑配置文件
$ sudo vim sources.list
# 文件末尾添加以下两行并保存
deb [arch=amd64] http://nginx.org/packages/mainline/ubuntu/ bionic nginx
deb-src http://nginx.org/packages/mainline/ubuntu/ bionic nginx

注: 18.04 “bionic” x86_64, aarch64/arm64
	20.04 “focal” x86_64, aarch64/arm64, s390x
	21.04 “hirsute” x86_64, aarch64/arm64
	21.10 “impish” x86_64, aarch64/arm64
	
5.导入nginx公钥
sudo wget http://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key

6.安装nginx最新版本
$ sudo apt-get update
$ sudo apt-get install nginx

7.还原备份的配置文件
sudo cp -f /backup/nginx/nginx.conf /etc/nginx

8.重启服务
$ sudo systemctl restart nginx

$ sudo systemctl status nginx  查看nginx状态
$ sudo systemctl start nginx   启动nginx
$ sudo systemctl stop nginx  停止nginx

这种方法基本上不会遇到什么问题，就是更新了ubantu自带的nginx下载源

第二种 二进制文件替换升级

1.下载nginx升级包也可以提前下载好tar包上传到服务器
sudo wget http://nginx.org/download/nginx-1.23.4.tar.gz

2.解压升级包
sudo tar zxvf nginx-1.23.4.tar.gz

3.进入解压后的新nginx文件夹
cd nginx-1.23.4/

4.查看当前版本得到编译参数(/usr/sbin/nginx是nginx的二进制执行文件)
  编译参数在后续升级中要保持一致
sudo /usr/sbin/nginx -V 不仅可以查看版本号，还可以查看nginx的编译参数
sudo nginx -v           只是查看nginx版本号

参数：--with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-YlUNvj/nginx-1.14.0=. -fstack-protector-strong -Wformat -Werror=format-security -fPIC -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-Bsymbolic-functions -Wl,-z,relro -Wl,-z,now -fPIC' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --modules-path=/usr/lib/nginx/modules --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_geoip_module=dynamic --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module=dynamic --with-http_sub_module --with-http_xslt_module=dynamic --with-stream=dynamic --with-stream_ssl_module --with-stream_ssl_preread_module --with-mail=dynamic --with-mail_ssl_module

5.用上面编译参数，参数中的版本需要修改
sudo ./configure --with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-YlUNvj/nginx-1.14.0=. -fstack-protector-strong -Wformat -Werror=format-security -fPIC -Wdate-time....

6.编译make，千万别make install
sudo make
make编译完后，在objs目录下就多了个nginx，这个就是新版本的二进制文件

7.备份原本的nginx可执行文件，有助于恢复操作
sudo mv /usr/sbin/nginx /usr/sbin/nginx.bak

8.将新生成nginx执行文件复制到/usr/sbin下
cp /objs/nginx /usr/sbin/nginx

9.检测配置文件是否正确
sudo /usr/sbin/nginx -t

10.重新加载配置文件
sudo nginx -s reload

11.执行升级(通过拷贝替换的方式可以不执行这一步了)
make upgrade

12.查看nginx版本号和编译参数
sudo /usr/sbin/nginx -V

第二种方法会存在很多报错情况，在这里重点记录一下

1.当./configure --with-cc-opt='-g -O2 -fdebug-prefix-map...报错，这种错误都是nginx版本和原来的依赖库版本不对应，要升级依赖库版本

./configure: error: the HTTP rewrite module requires the PCRE library.
./configure: error: the HTTP XSLT module requires the libxml2/libxslt libraries.
./configure: error: the HTTP image filter module requires the GD library.
./configure: error: the HTTP rewrite module requires the PCRE library.
./configure: error: the HTTP cache module requires md5 functions from OpenSSL library.
./configure: error: the GeoIP module requires the GeoIP library.

解决：基本上大差不大，都是重新安装依赖库就可以了
	（当你打 libpcre时按tab看会出现什么东西，因为软件可能和你的不一样）
	 apt-get install libpcre3 libpcre3-dev
	 apt-get install libxslt1-dev
	 apt-get install libgd2-xpm libgd2-xpm-dev
	 apt-get install libpcre3 libpcre3-dev
	 apt-get install libssl-dev openssl
	 apt-get install libgeoip-dev	
2.当编译完成之后，nginx -t检查配置文件时，报其他错误module.so的版本问题
nginx: [emerg] module "/usr/share/nginx/modules/ngx_http_xslt_filter_module.so" version 1014000 instead of 1021004 in /etc/nginx/modules-enabled/50-mod-http-xslt-filter.conf:1
nginx: configuration file /etc/nginx/nginx.conf test failed

# 备份旧的module
sudo mv /usr/share/nginx/modules/ngx_http_xslt_filter_module.so /usr/share/nginx/modules/ngx_http_xslt_filter_module.so.old
# 拷贝新的module
sudo cp objs/ngx_http_xslt_filter_module.so  /usr/share/nginx/modules/ngx_http_xslt_filter_module.so
其他类似的so文件报错也是大差不差，因为我们./configure modules-path=/usr/lib/nginx/modules编译时候指定了moudules模块，所以直接把老版的so文件备份，从objs目录下拷贝新的so文件到modules目录下即可

最后 
nginx -t               检查配置文件
nginx -s reload        重新加载配置文件
systemctl status nginx 查看nginx运行状态
systemctl start nginx  运行nginx
systemctl stop nginx   通知nginx
搬砖大户
关注
ubuntu20 apt 升级nginx 1.23.1
DarcyZ_SSM的博客
11-30 1753
ubuntu20 apt 升级nginx 1.23.1
WP+Nginx+Ubuntu平滑升级PHP版本
Stand Alone Complex
05-24 327
无障碍升级/切换PHP版本，适用于Ubuntu环境
ubuntu系统nginx升级版本
weixin_45314962的博客
05-24 1408
第三步：更新ubuntu源文件/etc/apt/sources.list。因为我使用的是16.04版本的ubuntu所以，此处换成。至此，ubuntu下升级nginx到最新版本的操作完成。16.04对应的是xenial 我们是这个。第五步 将配置文件等拷贝到新安装的程序目录下。使用nginx -v命令查看安装后的版本。14.04 对应的是 trusty。17.10对应的是artful。18.04对应的是bionic。导入nginx需要的key文件。第二步：卸载原有的nginx。
buntu 20.04系统Nginx 1.18平滑升级至1.26完整指南
piikee的专栏-萍客小居
07-02 278
在Ubuntu20.04系统中安全升级Nginx1.18至1.26版本的完整指南：1)备份配置并检查当前版本；2)添加Nginx官方源并导入GPG密钥；3)执行apt更新及安装；4)平滑重启服务；5)验证升级结果。文中还提供了依赖问题解决方案和配置优化建议（如HTTP3支持），确保生产环境平稳过渡。升级过程保留原有配置，适用于服务器持续运行需求。
[linux]ubantu系统下平滑升级nginx版本
深度的博客
06-12 1952
2.通过上传nginx.tar包，解压之后通过替换nginx二进制文件，make编译之后替换安装，关于第二种方法比较麻烦，因为nginx版本升级可能会导致nginx依赖的依赖库版本也要对应升级。1.直接更新ubantu系统的nginx源文件，再通过apt安装直接获取nginx最新版本，需要获取nginx官网。
Ubuntu升级nginx最新版本
迪八戈的博客
02-18 2572
旧版本nginx存在安全漏洞，需要升级到1.20.0版本以上
ubuntu下nginx升级（通过仓库，参考官方）
weixin_51910506的博客
01-19 5375
升级过程： ubuntu 18.04 ubuntu 20.04 ubuntu 21.04 ubuntu 21.10 参考官网文档，同样步骤。 为稳定的 nginx 包设置 apt 存储库 使用主线 nginx 包 备份 1.备份nginx程序 whereis nginx cp /usr/sbin/nginx ./backup 2.备份/etc/nginx sudo cp -r /etc/nginx ./nginx 卸载 $ sudo apt remove nginx nginx-common ngi
Red Hat.系统nginx平滑升级版本
Qx_cd的博客
07-29 387
向原老的Nginx主进程发送WINCH信号，它会平滑关闭老的工作进程（主进程不退出），这时所有新请求都会 由新版Nginx处理。最后关闭新版的master和worker，如果不执行上面的HUP信号，此步QUIT信号也可以重新拉起旧版本的 worker进程。上次发布的文章是使用编译方式安装的nginx-1.24.0版本，本章节记录了平滑升级到nginx-1.25.1版本。可以看到两个master,新的master是旧版master的子进程,并生成新版的worker进程。如果有新请求，由新版本提供服务。
Nginx：安装部署和升级（平滑升级）
二次源的博客
01-03 1157
Nginx是一个高性能的HTTP和反向代理web服务器，是运维中十分常用的中间件，本篇文章将介绍Nginx的安装部署和升级（平滑升级）
nginx的平滑升级及版本回滚
ouqisheng的博客
08-15 1679
conf：保存nginx所有的配置文件，其中nginx.conf是nginx服务器的最核心最主要的配置文件，其他 的.conf则是用来配置nginx相关的功能的，例如fastcgi功能使用的是fastcgi.conf和fastcgi_params 两个文件，配置文件一般都有一个样板配置文件，是以.default为后缀，使用时可将其复制并将default后缀 去掉即可。USR2 平滑升级可执行程序,将存储有旧版本主进程PID的文件重命名为nginx.pid.oldbin，并启动新的 nginx。
Ubuntu下Nginx版本升级
m0_37294522的博客
06-16 1482
今天把服务器的Nginx版本给升级到最新的稳定版本1.6.2了，Linux服务器操作系统为64 位的Ubuntu12.04，写一下升级过程，首先下载Nginx，本次升级直接用ssh 远程升级的，所以所有操作都是在shell下面进行，所有操作都用命令，其实除了注视，真正需要的命令也就那么几个 ...
[每周一更]-(第6期)：Ubuntu 16.04 升级nginx 1.10到nginx1.22历程
hmx224_2014的专栏
08-05 1921
您原系统盘的用户快照会保留，自动快照则根据您该系统盘属性值“自动快照是否随云盘释放”的选项来判断是否保留或随云盘删除；ECS实例更换操作系统后，云盘ID会变更，原系统盘会被释放，数据会丢失且无法找回。3、禁用 --without-http_rewrite_module。看到这个错误，说明第一个错误已解决，这个错误缺少GD库就继续指定；您在操作前可通过创建快照做好相关备份，以免数据丢失给你造成损失。4、下载新的pcre，重新configure。自动快照策略将失效，需要重新设置。本地找不到，接着换方案。...
Ubuntu: 安装最新版本的 Nginx
yuntaoren的博客
04-17 3956
Ubuntu 默认 apt 源中的 Nginx 版本比较旧，今天介绍下如何在 Ubuntu 中安装最新版本的 Nginx。 要安装较新版本的 Nginx, 可以使用 Nginx 的 APT 源。执行如下脚本来添加 Nginx APT 源： #!/bin/bash release=$(lsb_release -cs) cat <<EOF > /etc/apt/sources.list.d/nginx.list deb https://nginx.org/packages/ubunt
ubuntu 阿里云 nginx php升级
jaqin的专栏
10-02 381
搭了个hustoj，一直想再搭个moodle，趁着国庆放假，把php升级成7.2，moodle要求7.0以上   php -v     //查看版本 sudo apt-get --purge remove php5.5*      //删除旧版本 sudo add-apt-repository ppa:ondrej/php    //添加源 sudo apt-get update       ...
ubuntu20如何升级nginx到最新版本（其它版本大概率也可以）
weixin_43441262的博客
03-20 511
Nginx非常常用，所以在网络安全方面备受“关注”。其漏洞非常多，要经常保持软件更新版本才能更好的保证安全。但是Ubuntu官网适配nginx非常慢，所以nginx官方也会推出针对主流Linux操作系统的包管理工具安装方式。
Ubuntu升级或安装Nginx最新稳定版（包安装）
AI悦创·编程私教1v1
02-22 1007
说明 1）如果你之前安装过 Nginx，你可以输入 sudo apt-get --purge remove nginx 将 Ngxin 的配置文件和程序全都卸载，然后按照下面的方式安装即可。 2）如果你不想卸载之前的，仍然可以按照下面的方式进行安装升级，但是 /etc/nginx 目录下可能会有你之前版本的一些配置文件，比如 sites-enabled 文件夹和 sites-available 文件夹等等，但1.14.0稳定版本不需要这些文件夹了，所以最好是卸载了重新安装。 Nginx 版本介绍 Ngin
ubuntu 下 升级 nginx
weixin_30786617的博客
01-07 169
我的是一开始用 apt-get install nginx 安装的,所以下面是 在已经安装的情况下升级 下载 stable版本的nginx : http://nginx.org/en/download.html 这里 我下载的 1.6.2 stable 版本 进入到要保存文件的目录 我的是 cd /home wget http://nginx.org/downl...
Ubuntu 20.04 升级 nginx 1.18 到 1.20.1
认知 行动 坚持
11-23 3545
因为低于 1.20.1 的版本受到 CVE-2021-23017 漏洞的影响，所以决定升级一下nginx。 添加源 echo "deb http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \ | sudo tee /etc/apt/sources.list.d/nginx.list curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.k
nginx版本平滑升级
最新发布
08-14
<think>首先，用户的问题是关于Nginx平滑升级版本的，具体是“如何在不停止服务的情况下升级Nginx到新版本”。我需要参考提供的引用内容来构建回答。 引用内容总结： - [^1]：介绍了Nginx平滑升级的意义，包括新功能、性能优化和安全修复的重要性。 - [^2]：解释了Nginx平滑升级的原理：启动新进程而不停老进程，老进程处理完剩余请求后停止。 - [^3]：提供了Red Hat系统上的Nginx平滑升级步骤，包括命令示例。 - [^4]：描述了结束工作进程的步骤，完成升级。 用户的问题核心是操作步骤，所以我应该提供一个清晰的、逐步的指南，基于这些引用。 系统级指令： - 所有行内数学表达式必须用$...$格式。但在这个问题中，没有数学表达式，所以可能不需要。 - 独立公式必须用$$...$$格式并单独成段。同样，这里没有公式。 - LaTeX语法正确：确保任何数学表达正确。 - 使用中文回答：整个回答要用中文。 - 生成相关问题：在回答后，添加相关问题。 - 回答中引用的段落末尾自然地添加引用标识：如[^1]，[^2]等。 - 回答结构清晰：帮助用户逐步解决问题，保证真实可靠。 用户可见层： - 回答结构清晰：逐步解决问题。 - 参考站内引用：使用提供的引用内容。 我的回答结构： 1. **引言**：简要解释Nginx平滑升级的意义，基于[^1]。 2. **原理概述**：解释平滑升级的工作原理，基于[^2]。 3. **详细操作步骤**：提供逐步指南，整合[^3]和[^4]的命令。 4. **注意事项**：提醒用户注意事项，如备份、测试等。 5. **相关问题**：生成相关问题。 操作步骤需要详细： - 从[^3]：包括下载新版本、编译、启动新进程等。 - 从[^4]：结束旧进程的命令。 确保回答真实可靠：基于提供的引用，避免添加外部知识。 生成相关问题：基于主题，如升级失败处理、优化等。 最终回答用中文。</think>### Nginx平滑升级版本操作指南 在Web服务运维中，Nginx的平滑升级允许您在不中断服务的情况下升级到新版本，这对于生产环境至关重要。平滑升级的原理是：启动新Nginx进程处理新请求，同时旧进程继续处理现有请求直至完成，然后优雅退出[^2]。这确保了服务的连续性和稳定性。本文将基于Linux系统（如Red Hat或类似发行版），提供详细的逐步操作指南。操作前，请务必备份配置文件和数据，并在测试环境中验证，以避免潜在风险。 #### 一、平滑升级的意义 Nginx平滑升级能引入新功能、性能优化和安全修复，同时避免服务中断。这在处理高流量网站时尤为关键，因为任何停机都可能导致用户体验下降或业务损失[^1]。 #### 二、平滑升级原理 - **核心机制**：在不停掉旧进程的情况下，启动新进程。旧进程负责处理剩余请求，但不再接受新请求；新进程接管新请求；旧进程处理完毕后自动停止[^2]。 - **信号控制**：使用Linux信号（如`USR2`、`QUIT`）管理进程切换，确保无缝过渡。 #### 三、详细操作步骤（以升级到Nginx 1.25.1为例） 以下步骤假设您已具备root权限，且Nginx安装在`/apps/nginx`目录（路径可能因环境而异，请根据实际调整）。操作前，确保系统已安装编译工具（如gcc、make）。全程服务不中断，用户请求不受影响。 1. **准备工作** - **备份配置和数据**： ```bash cp -r /apps/nginx/conf /apps/nginx/conf_backup # 备份配置文件 cp -r /apps/nginx/html /apps/nginx/html_backup # 备份网站数据 ``` - **下载新版本Nginx**： 访问[Nginx官网](https://nginx.org/en/download.html)下载最新稳定版源码，例如： ```bash wget https://nginx.org/download/nginx-1.25.1.tar.gz tar -zxvf nginx-1.25.1.tar.gz cd nginx-1.25.1 ``` - **编译新版本（添加所需模块）**： 使用旧配置参数（通过`nginx -V`查看），避免配置丢失。例如： ```bash ./configure --prefix=/apps/nginx --with-http_ssl_module # 添加旧版模块，如SSL make # 编译但不安装 ``` 注意：如果升级仅需添加新模块，可复用旧二进制；否则，编译新版本[^2]。 2. **启动新进程并平滑切换** - **替换旧二进制并发送信号**： ```bash mv /apps/nginx/sbin/nginx /apps/nginx/sbin/nginx.old # 备份旧二进制 cp objs/nginx /apps/nginx/sbin/nginx # 复制新二进制 kill -USR2 `cat /apps/nginx/logs/nginx.pid` # 发送USR2信号，启动新主进程[^3] ``` 执行后，系统会并行运行新旧进程： ```bash ps aux | grep nginx # 查看进程，应显示新旧master进程及worker进程[^3] ``` 输出示例： ``` root 8814 0.0 0.2 42460 3760 ? Ss 16:58 0:00 nginx: master process (old) nginx 8957 0.0 0.2 77172 4724 ? S 17:23 0:00 \_ nginx: worker process root 12014 0.0 0.3 42448 5512 ? S 17:32 0:00 nginx: master process (new) nginx 12015 0.0 0.2 77192 4904 ? S 17:32 0:00 \_ nginx: worker process ``` - **验证新进程运行**： 发送测试请求或检查日志： ```bash curl -I http://localhost # 确认服务正常 tail -f /apps/nginx/logs/error.log # 监控错误 ``` 如果新进程未启动（如[^3]所述），重启服务： ```bash systemctl restart nginx # 或 service nginx restart ``` 3. **停止旧进程完成升级** - **优雅退出旧进程**： 等待旧worker处理完所有请求（可通过监控日志或连接数确认），然后发送QUIT信号： ```bash kill -QUIT `cat /apps/nginx/logs/nginx.pid.oldbin` # 停止旧master进程[^4] ``` 再次检查进程： ```bash ps aux | grep nginx # 应仅剩新进程[^4] ``` 输出示例： ``` root 104103 0.0 0.1 48640 3884 ? S 22:15 0:00 nginx: master process (new) nobody 104104 0.0 0.0 49088 2016 ? S 22:15 0:00 \_ nginx: worker process ``` 4. **清理和验证** - **删除备份**： ```bash rm /apps/nginx/sbin/nginx.old # 可选，清理旧二进制 ``` - **检查版本**： ```bash nginx -v # 应显示新版本号 ``` #### 四、注意事项 - **兼容性问题**：新版本可能引入配置变更，升级前测试`nginx -t`验证配置。 - **回滚方案**：如果升级失败，用备份二进制替换新文件，并重启旧进程。 - **信号说明**：`USR2`用于启动新进程，`WINCH`可让旧worker优雅退出（但非必须），`QUIT`完全停止旧进程[^2][^4]。 - **性能监控**：升级后观察CPU/内存使用，确保无资源泄漏。 - **系统要求**：适用于Linux（如Red Hat、CentOS、Ubuntu），Windows不支持平滑升级。 通过以上步骤，您可以在服务不中断的情况下完成Nginx升级。如果遇到问题，参考Nginx官方文档或社区资源。此方法已在生产环境中广泛应用[^1][^3]。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值