nginx 1.6.1 离线平滑升级至 nginx 1.24.0

前言：生产环境中遇到的问题，需要升级nginx版本，编译nginx时需要加上pcre和openssl参数，随即开始了踩坑之路，开源至上，开启正文。

make编译nginx报错：

/bin/sh: line 2: ./config: No such file or directory
make[1]: *** [/usr/local/openssl//.openssl/include/openssl/ssl.h] Error 127
make[1]: Leaving directory `/root/nginx/nginx-1.24.0'
make: *** [build] Error 2

一：准备工作

1. 准备这三个软件包 nginx-1.24.0.tar.gz openssl-1.0.2k.tar.gz pcre-8.32.zip

下载地址：

nginx：nginx: download

openssl：OpenSSL官方下载 - 码客

pcre：https://www.pcre.org/

自己整理的这三个包：开源至上.zip - 蓝奏云

二：开始升级

1.检查当前nginx版本

[root@docker ~]# /usr/local/nginx/sbin/nginx -V
nginx version: nginx/1.16.1
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-39) (GCC) 
configure arguments:

2.备份旧版本nginx

[root@docker ~]# cp /usr/local/nginx/ /home/docker/backup/nginx.bak -R

3.上传更新文件到服务器中

[root@docker nginx]# ls
nginx-1.24.0.tar.gz  openssl-1.0.2k.tar.gz  pcre-8.32.zip

4.编译安装openssl（因为是离线环境，也模拟一下编译安装openssl并指定路径。采用yum的安装方式会导致openssl的文件乱飞，在指定编译文件的时候路径特别麻烦，如果有这方面需求的建议重新指定安装openssl）

# 解压openssl
[root@docker nginx]# tar -zxvf openssl-1.0.2k.tar.gz
[root@docker nginx]# cd openssl-1.0.2k

# 准备安装到这个目录，建议提前创建一下
[root@docker openssl-1.0.2k]# mkdir /usr/local/openssl

# 编译配置检查指定预安装路径
[root@docker openssl-1.0.2k]# ./config --prefix=/usr/local/openssl
补充知识：config脚本检查系统环境并调用Configure完成配置，因此配置选项是通过
config脚本向 Configure 传递的，所以看自己想用哪个。

# 开始编译安装 不建议采用 make && make install 以免出问题难以补救
[root@docker openssl-1.0.2k]# make
[root@docker openssl-1.0.2k]# make install

# 检查安装是否成功
[root@docker openssl-1.0.2k]# openssl version
OpenSSL 1.0.2k-fips  26 Jan 2017

# 要确认这个四个文件夹存在，这块在nginx编译时要被引用
[root@docker openssl-1.0.2k]# ls /usr/local/openssl/
bin  include  lib  ssl

5.编译安装nginx 1.24.0

# 1.解压nginx
[root@docker nginx]# tar -zxvf nginx-1.24.0.tar.gz

# 2.解压pcre源码目录（--with-pcre= 指定是源码目录，不是安装位置！）
[root@docker nginx]# unzip pcre-8.32.zip

# 3.进入nginx 准备编译
[root@docker nginx]# cd nginx-1.24.0

6.修改 nginx 1.24.0中 auto/lib/openssl/conf 的预设openssl 路径参数（因为预置的openssl路径不对需要调整，如果不修改这一步会报错，报错如下可自行对照）

# 不修改auto/lib/openssl/conf 的预设openssl 路径参数的报错
cd /usr/local/openssl/ \
&& if [ -f Makefile ]; then make clean; fi \
&& ./config --prefix=/usr/local/openssl//.openssl no-shared no-threads  \
&& make \
&& make install_sw LIBDIR=lib
/bin/sh: line 2: ./config: No such file or directory
make[1]: *** [/usr/local/openssl//.openssl/include/openssl/ssl.h] Error 127
make[1]: Leaving directory `/root/nginx/nginx-1.24.0'
make: *** [build] Error 2

# 下面提示了找不到文件，所以我们进入编译脚本查看openssl路径

auto/lib/openssl/conf 中的openssl路径为 /.openssl 与我们安装的openssl路径不符，需要进行修改。且我们编译nginx指定参数时要写openssl安装的绝对路径。

修改前原图：vim auto/lib/openssl/conf 修改并保存

修改后新图： 按照我这个修改就可以了。

7.开始编译安装nginx 1.24.0

# 配置文件编译检查
[root@docker nginx-1.24.0]# ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-stream --with-pcre=/root/nginx/pcre-8.32  --with-openssl=/usr/local/openssl/

# --with-pcre= 指定是pcre源码目录
--with-pcre=/root/nginx/pcre-8.32
 
# --with-openssl= 指定是openssl安装位置
--with-openssl=/usr/local/openssl/

# --prefix= 指定的是旧版本、需要升级的nginx安装位置
--prefix=/usr/local/nginx

# 编译 千万不要make install
[root@docker nginx-1.24.0]# make

./configure编译配置检查如图，自行参照。

make编译成功如图，自行参照。

8.编译成功后nginx目录会出现objs目录，需要将其中的nginx拷贝到旧版本的nginx中。

# 可以再次备份一下旧版本nginx
[root@docker nginx-1.24.0]# mv /usr/local/nginx/sbin/nginx   /usr/local/nginx/sbin/nginx.old

# 停止nginx拷贝，否则文件会被占用
[root@docker nginx-1.24.0]# systemctl stop nginx

# 拷贝objs中nginx到 旧版本nginx位置，并检查nginx文件更新时间
[root@docker nginx-1.24.0]#  cp /root/nginx/nginx-1.24.0/objs/nginx   /usr/local/nginx/sbin/nginx
cp: overwrite ‘/usr/local/nginx/sbin/nginx’? y
[root@docker nginx-1.24.0]# ll /usr/local/nginx/sbin/nginx
-rwxr-xr-x 1 root root 10079632 Apr 20 13:40 /usr/local/nginx/sbin/nginx

# 开启nginx，检查nginx状态。
[root@docker nginx-1.24.0]# systemctl start nginx 
[root@docker nginx-1.24.0]# systemctl staus nginx

# 使用 make upgrade 平滑更新
[root@docker nginx-1.24.0]# make upgrade

make upgrade 更新成功如图所示：

# 重启nginx并查看状态
[root@docker nginx-1.24.0]# systemctl restart nginx && systemctl status nginx

# 查看版本是否更新成功
[root@docker nginx-1.24.0]# /usr/local/nginx/sbin/nginx  -V

nginx更新成功如图所示：

补充知识：出现报错的原因是我们对nginx编译参数不熟悉造成的，以下内容是摘抄nginx编译参数供大家学习参考。

nginx参数：

--prefix= 指向安装目录

--sbin-path 指向（执行）程序文件（nginx）

--conf-path= 指向配置文件（nginx.conf）

--error-log-path= 指向错误日志目录

--pid-path= 指向pid文件（nginx.pid）

--lock-path= 指向lock文件（nginx.lock）（安装文件锁定，防止安装文件被别人利用，或自己误操作。）

--user= 指定程序运行时的非特权用户

--group= 指定程序运行时的非特权用户组

--builddir= 指向编译目录

--with-rtsig_module 启用rtsig模块支持（实时信号）

--with-select_module 启用select模块支持（一种轮询模式,不推荐在高载环境下使用）禁用：--without-select_module

--with-poll_module 启用poll模块支持（功能与select相同，与select特性相同，为一种轮询模式,不推荐在高载环境下使用）

--with-file-aio 启用file aio支持（一种APL文件传输格式）

--with-ipv6 启用ipv6支持

--with-http_ssl_module 启用ngx_http_ssl_module支持（使支持https请求，需已安装openssl）

--with-http_realip_module 启用ngx_http_realip_module支持（这个模块允许从请求标头更改客户端的IP地址值，默认为关）

--with-http_addition_module 启用ngx_http_addition_module支持（作为一个输出过滤器，支持不完全缓冲，分部分响应请求）

--with-http_xslt_module 启用ngx_http_xslt_module支持（过滤转换XML请求）

--with-http_image_filter_module 启用ngx_http_image_filter_module支持（传输JPEG/GIF/PNG 图片的一个过滤器）（默认为不启用。gd库要用到）

--with-http_geoip_module 启用ngx_http_geoip_module支持（该模块创建基于与MaxMind GeoIP二进制文件相配的客户端IP地址的ngx_http_geoip_module变量）

--with-http_sub_module 启用ngx_http_sub_module支持（允许用一些其他文本替换nginx响应中的一些文本）

--with-http_dav_module 启用ngx_http_dav_module支持（增加PUT,DELETE,MKCOL：创建集合,COPY和MOVE方法）默认情况下为关闭，需编译开启

--with-http_flv_module 启用ngx_http_flv_module支持（提供寻求内存使用基于时间的偏移量文件）

--with-http_gzip_static_module 启用ngx_http_gzip_static_module支持（在线实时压缩输出数据流）

--with-http_random_index_module 启用ngx_http_random_index_module支持（从目录中随机挑选一个目录索引）

--with-http_secure_link_module 启用ngx_http_secure_link_module支持（计算和检查要求所需的安全链接网址）

--with-http_degradation_module 启用ngx_http_degradation_module支持（允许在内存不足的情况下返回204或444码）

--with-http_stub_status_module 启用ngx_http_stub_status_module支持（获取nginx自上次启动以来的工作状态）

--without-http_charset_module 禁用ngx_http_charset_module支持（重新编码web页面，但只能是一个方向--服务器端到客户端，并且只有一个字节的编码可以被重新编码）

--without-http_gzip_module 禁用ngx_http_gzip_module支持（该模块同-with-http_gzip_static_module功能一样）

--without-http_ssi_module 禁用ngx_http_ssi_module支持（该模块提供了一个在输入端处理处理服务器包含文件（SSI）的过滤器，目前支持SSI命令的列表是不完整的）

--without-http_userid_module 禁用ngx_http_userid_module支持（该模块用来处理用来确定客户端后续请求的cookies）

--without-http_access_module 禁用ngx_http_access_module支持（该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于ip地址）

--without-http_auth_basic_module禁用ngx_http_auth_basic_module（该模块是可以使用用户名和密码基于http基本认证方法来保护你的站点或其部分内容）

--without-http_autoindex_module 禁用disable ngx_http_autoindex_module支持（该模块用于自动生成目录列表，只在ngx_http_index_module模块未找到索引文件时发出请求。）

--without-http_geo_module 禁用ngx_http_geo_module支持（创建一些变量，其值依赖于客户端的IP地址）

--without-http_map_module 禁用ngx_http_map_module支持（使用任意的键/值对设置配置变量）

--without-http_split_clients_module 禁用ngx_http_split_clients_module支持（该模块用来基于某些条件划分用户。条件如：ip地址、报头、cookies等等）

--without-http_referer_module 禁用disable ngx_http_referer_module支持（该模块用来过滤请求，拒绝报头中Referer值不正确的请求）

--without-http_rewrite_module 禁用ngx_http_rewrite_module支持（该模块允许使用正则表达式改变URI，并且根据变量来转向以及选择配置。如果在server级别设置该选项，那么他们将在 location之前生效。如果在location还有更进一步的重写规则，location部分的规则依然会被执行。如果这个URI重写是因为location部分的规则造成的，那么 location部分会再次被执行作为新的URI。 这个循环会执行10次，然后Nginx会返回一个500错误。）

--without-http_proxy_module 禁用ngx_http_proxy_module支持（有关代理服务器）

--without-http_fastcgi_module 禁用ngx_http_fastcgi_module支持（该模块允许Nginx 与FastCGI 进程交互，并通过传递参数来控制FastCGI 进程工作。 ）FastCGI一个常驻型的公共网关接口。

--without-http_uwsgi_module 禁用ngx_http_uwsgi_module支持（该模块用来医用uwsgi协议，uWSGI服务器相关）

--without-http_scgi_module 禁用ngx_http_scgi_module支持（该模块用来启用SCGI协议支持，SCGI协议是CGI协议的替代。它是一种应用程序与HTTP服务接口标准。它有些像FastCGI但他的设计 更容易实现。）

--without-http_memcached_module 禁用ngx_http_memcached_module支持（该模块用来提供简单的缓存，以提高系统效率）

-without-http_limit_zone_module 禁用ngx_http_limit_zone_module支持（该模块可以针对条件，进行会话的并发连接数控制）

--without-http_limit_req_module 禁用ngx_http_limit_req_module支持（该模块允许你对于一个地址进行请求数量的限制用一个给定的session或一个特定的事件）

--without-http_empty_gif_module 禁用ngx_http_empty_gif_module支持（该模块在内存中常驻了一个1*1的透明GIF图像，可以被非常快速的调用）

--without-http_browser_module 禁用ngx_http_browser_module支持（该模块用来创建依赖于请求报头的值。如果浏览器为modern ，则$modern_browser等于modern_browser_value指令分配的值；如 果浏览器为old，则$ancient_browser等于 ancient_browser_value指令分配的值；如果浏览器为 MSIE中的任意版本，则 $msie等于1）

--without-http_upstream_ip_hash_module 禁用ngx_http_upstream_ip_hash_module支持（该模块用于简单的负载均衡）

--with-http_perl_module 启用ngx_http_perl_module支持（该模块使nginx可以直接使用perl或通过ssi调用perl）

--with-perl_modules_path= 设定perl模块路径

--with-perl= 设定perl库文件路径

--http-log-path= 设定access log路径

--http-client-body-temp-path= 设定http客户端请求临时文件路径

--http-proxy-temp-path= 设定http代理临时文件路径

--http-fastcgi-temp-path= 设定http fastcgi临时文件路径

--http-uwsgi-temp-path= 设定http uwsgi临时文件路径

--http-scgi-temp-path= 设定http scgi临时文件路径

-without-http 禁用http server功能

--without-http-cache 禁用http cache功能

--with-mail 启用POP3/IMAP4/SMTP代理模块支持

--with-mail_ssl_module 启用ngx_mail_ssl_module支持

--without-mail_pop3_module 禁用pop3协议（POP3即邮局协议的第3个版本,它是规定个人计算机如何连接到互联网上的邮件服务器进行收发邮件的协议。是因特网电子邮件的第一个离线协议标 准,POP3协议允许用户从服务器上把邮件存储到本地主机上,同时根据客户端的操作删除或保存在邮件服务器上的邮件。POP3协议是TCP/IP协议族中的一员，主要用于 支持使用客户端远程管理在服务器上的电子邮件）

--without-mail_imap_module 禁用imap协议（一种邮件获取协议。它的主要作用是邮件客户端可以通过这种协议从邮件服务器上获取邮件的信息，下载邮件等。IMAP协议运行在TCP/IP协议之上， 使用的端口是143。它与POP3协议的主要区别是用户可以不用把所有的邮件全部下载，可以通过客户端直接对服务器上的邮件进行操作。）

--without-mail_smtp_module 禁用smtp协议（SMTP即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则，由它来控制信件的中转方式。SMTP协议属于TCP/IP协议族，它帮助每台计算机在发送或中转信件时找到下一个目的地。）

--with-google_perftools_module 启用ngx_google_perftools_module支持（调试用，剖析程序性能瓶颈）

--with-cpp_test_module 启用ngx_cpp_test_module支持

--add-module= 启用外部模块支持

--with-cc= 指向C编译器路径

--with-cpp= 指向C预处理路径

--with-cc-opt= 设置C编译器参数（PCRE库，需要指定–with-cc-opt=”-I /usr/local/include”，如果使用select()函数则需要同时增加文件描述符数量，可以通过–with-cc- opt=”-D FD_SETSIZE=2048”指定。）

--with-ld-opt= 设置连接文件参数。（PCRE库，需要指定–with-ld-opt=”-L /usr/local/lib”。）

--with-cpu-opt= 指定编译的CPU，可用的值为: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64

--without-pcre 禁用pcre库

--with-pcre 启用pcre库

--with-pcre= 指向pcre库文件目录

--with-pcre-opt= 在编译时为pcre库设置附加参数

--with-md5= 指向md5库文件目录（消息摘要算法第五版，用以提供消息的完整性保护）

--with-md5-opt= 在编译时为md5库设置附加参数

--with-md5-asm 使用md5汇编源

--with-sha1= 指向sha1库目录（数字签名算法，主要用于数字签名）

--with-sha1-opt= 在编译时为sha1库设置附加参数

--with-sha1-asm 使用sha1汇编源

--with-zlib= 指向zlib库目录

--with-zlib-opt= 在编译时为zlib设置附加参数

--with-zlib-asm= 为指定的CPU使用zlib汇编源进行优化，CPU类型为pentium, pentiumpro

--with-libatomic 为原子内存的更新操作的实现提供一个架构

--with-libatomic= 指向libatomic_ops安装目录

--with-openssl= 指向openssl安装目录

--with-openssl-opt 在编译时为openssl设置附加参数

--with-debug 启用debug日志