Nginx(二) 重新编译并添加模块

Eisen戴

已于 2023-11-24 23:29:44 修改

阅读量1.5k

点赞数

分类专栏： nginx 文章标签： nginx 服务器 linux

于 2023-11-05 22:43:38 首次发布

本文链接：https://blog.csdn.net/ShenDaiSun/article/details/134235740

版权

nginx 专栏收录该内容

20 篇文章 3 订阅

订阅专栏

本文详细指导如何查询Nginx配置参数，清理历史编译，添加和启用模块（如http_stub_status_module），以及编译、停止、备份和覆盖Nginx可执行程序的过程。

摘要由CSDN通过智能技术生成

1.查询Nginx配置参数

作用：一是检查所需模块是否已安装，二是将configure arguments: 后面的参数复制出来并保存，因为等会重新编译时还需将这些模块一同添加进去。

[root@reader ~]# nginx -V
nginx version: nginx/1.24.0
built by gcc 8.5.0 20210514 (Red Hat 8.5.0-4) (GCC) 
built with OpenSSL 1.1.1k  FIPS 25 Mar 2021
TLS SNI support enabled
configure arguments: --prefix=/usr/local/nginx --with-threads --with-http_ssl_module --with-http_gzip_static_module
[root@reader ~]#

2.清除历史编译

进入Nginx源码包目录下，执行make clean指令，清除历史编译。

[root@reader conf]# cd /usr/soft/nginx-1.24.0/
[root@reader nginx-1.24.0]# make clean
rm -rf Makefile objs
[root@reader nginx-1.24.0]#

3.添加所需模块

使用./configure --help指令查询需要配置的参数。

[root@reader nginx-1.24.0]# ./configure --help

  --help                             print this message

  --prefix=PATH                      set installation prefix
  --sbin-path=PATH                   set nginx binary pathname
  --modules-path=PATH                set modules path
  --conf-path=PATH                   set nginx.conf pathname
  --error-log-path=PATH              set error log pathname
  --pid-path=PATH                    set nginx.pid pathname
  --lock-path=PATH                   set nginx.lock pathname

  --user=USER                        set non-privileged user for
                                     worker processes
  --group=GROUP                      set non-privileged group for
                                     worker processes

  --build=NAME                       set build name
  --builddir=DIR                     set build directory

  --with-select_module               enable select module
  --without-select_module            disable select module
  --with-poll_module                 enable poll module
  --without-poll_module              disable poll module

  --with-threads                     enable thread pool support

  --with-file-aio                    enable file AIO support

  --with-http_ssl_module             enable ngx_http_ssl_module
  --with-http_v2_module              enable ngx_http_v2_module
  --with-http_realip_module          enable ngx_http_realip_module
  --with-http_addition_module        enable ngx_http_addition_module
  --with-http_xslt_module            enable ngx_http_xslt_module
  --with-http_xslt_module=dynamic    enable dynamic ngx_http_xslt_module
  --with-http_image_filter_module    enable ngx_http_image_filter_module
  --with-http_image_filter_module=dynamic
                                     enable dynamic ngx_http_image_filter_module
  --with-http_geoip_module           enable ngx_http_geoip_module
  --with-http_geoip_module=dynamic   enable dynamic ngx_http_geoip_module
  --with-http_sub_module             enable ngx_http_sub_module
  --with-http_dav_module             enable ngx_http_dav_module
  --with-http_flv_module             enable ngx_http_flv_module
  --with-http_mp4_module             enable ngx_http_mp4_module
  --with-http_gunzip_module          enable ngx_http_gunzip_module
  --with-http_gzip_static_module     enable ngx_http_gzip_static_module
  --with-http_auth_request_module    enable ngx_http_auth_request_module
  --with-http_random_index_module    enable ngx_http_random_index_module
  --with-http_secure_link_module     enable ngx_http_secure_link_module
  --with-http_degradation_module     enable ngx_http_degradation_module
  --with-http_slice_module           enable ngx_http_slice_module
  --with-http_stub_status_module     enable ngx_http_stub_status_module

  --without-http_charset_module      disable ngx_http_charset_module
  --without-http_gzip_module         disable ngx_http_gzip_module
  --without-http_ssi_module          disable ngx_http_ssi_module
  --without-http_userid_module       disable ngx_http_userid_module
  --without-http_access_module       disable ngx_http_access_module
  --without-http_auth_basic_module   disable ngx_http_auth_basic_module
  --without-http_mirror_module       disable ngx_http_mirror_module
  --without-http_autoindex_module    disable ngx_http_autoindex_module
  --without-http_geo_module          disable ngx_http_geo_module
  --without-http_map_module          disable ngx_http_map_module
  --without-http_split_clients_module disable ngx_http_split_clients_module
  --without-http_referer_module      disable ngx_http_referer_module
  --without-http_rewrite_module      disable ngx_http_rewrite_module
  --without-http_proxy_module        disable ngx_http_proxy_module
  --without-http_fastcgi_module      disable ngx_http_fastcgi_module
  --without-http_uwsgi_module        disable ngx_http_uwsgi_module
  --without-http_scgi_module         disable ngx_http_scgi_module
  --without-http_grpc_module         disable ngx_http_grpc_module
  --without-http_memcached_module    disable ngx_http_memcached_module
  --without-http_limit_conn_module   disable ngx_http_limit_conn_module
  --without-http_limit_req_module    disable ngx_http_limit_req_module
  --without-http_empty_gif_module    disable ngx_http_empty_gif_module
  --without-http_browser_module      disable ngx_http_browser_module
  --without-http_upstream_hash_module
                                     disable ngx_http_upstream_hash_module
  --without-http_upstream_ip_hash_module
                                     disable ngx_http_upstream_ip_hash_module
  --without-http_upstream_least_conn_module
                                     disable ngx_http_upstream_least_conn_module
  --without-http_upstream_random_module
                                     disable ngx_http_upstream_random_module
  --without-http_upstream_keepalive_module
                                     disable ngx_http_upstream_keepalive_module
  --without-http_upstream_zone_module
                                     disable ngx_http_upstream_zone_module

  --with-http_perl_module            enable ngx_http_perl_module
  --with-http_perl_module=dynamic    enable dynamic ngx_http_perl_module
  --with-perl_modules_path=PATH      set Perl modules path
  --with-perl=PATH                   set perl binary pathname

  --http-log-path=PATH               set http access log pathname
  --http-client-body-temp-path=PATH  set path to store
                                     http client request body temporary files
  --http-proxy-temp-path=PATH        set path to store
                                     http proxy temporary files
  --http-fastcgi-temp-path=PATH      set path to store
                                     http fastcgi temporary files
  --http-uwsgi-temp-path=PATH        set path to store
                                     http uwsgi temporary files
  --http-scgi-temp-path=PATH         set path to store
                                     http scgi temporary files

  --without-http                     disable HTTP server
  --without-http-cache               disable HTTP cache

  --with-mail                        enable POP3/IMAP4/SMTP proxy module
  --with-mail=dynamic                enable dynamic POP3/IMAP4/SMTP proxy module
  --with-mail_ssl_module             enable ngx_mail_ssl_module
  --without-mail_pop3_module         disable ngx_mail_pop3_module
  --without-mail_imap_module         disable ngx_mail_imap_module
  --without-mail_smtp_module         disable ngx_mail_smtp_module

  --with-stream                      enable TCP/UDP proxy module
  --with-stream=dynamic              enable dynamic TCP/UDP proxy module
  --with-stream_ssl_module           enable ngx_stream_ssl_module
  --with-stream_realip_module        enable ngx_stream_realip_module
  --with-stream_geoip_module         enable ngx_stream_geoip_module
  --with-stream_geoip_module=dynamic enable dynamic ngx_stream_geoip_module
  --with-stream_ssl_preread_module   enable ngx_stream_ssl_preread_module
  --without-stream_limit_conn_module disable ngx_stream_limit_conn_module
  --without-stream_access_module     disable ngx_stream_access_module
  --without-stream_geo_module        disable ngx_stream_geo_module
  --without-stream_map_module        disable ngx_stream_map_module
  --without-stream_split_clients_module
                                     disable ngx_stream_split_clients_module
  --without-stream_return_module     disable ngx_stream_return_module
  --without-stream_set_module        disable ngx_stream_set_module
  --without-stream_upstream_hash_module
                                     disable ngx_stream_upstream_hash_module
  --without-stream_upstream_least_conn_module
                                     disable ngx_stream_upstream_least_conn_module
  --without-stream_upstream_random_module
                                     disable ngx_stream_upstream_random_module
  --without-stream_upstream_zone_module
                                     disable ngx_stream_upstream_zone_module

  --with-google_perftools_module     enable ngx_google_perftools_module
  --with-cpp_test_module             enable ngx_cpp_test_module

  --add-module=PATH                  enable external module
  --add-dynamic-module=PATH          enable dynamic external module

  --with-compat                      dynamic modules compatibility

  --with-cc=PATH                     set C compiler pathname
  --with-cpp=PATH                    set C preprocessor pathname
  --with-cc-opt=OPTIONS              set additional C compiler options
  --with-ld-opt=OPTIONS              set additional linker options
  --with-cpu-opt=CPU                 build for the specified CPU, valid values:
                                     pentium, pentiumpro, pentium3, pentium4,
                                     athlon, opteron, sparc32, sparc64, ppc64

  --without-pcre                     disable PCRE library usage
  --with-pcre                        force PCRE library usage
  --with-pcre=DIR                    set path to PCRE library sources
  --with-pcre-opt=OPTIONS            set additional build options for PCRE
  --with-pcre-jit                    build PCRE with JIT compilation support
  --without-pcre2                    do not use PCRE2 library

  --with-zlib=DIR                    set path to zlib library sources
  --with-zlib-opt=OPTIONS            set additional build options for zlib
  --with-zlib-asm=CPU                use zlib assembler sources optimized
                                     for the specified CPU, valid values:
                                     pentium, pentiumpro

  --with-libatomic                   force libatomic_ops library usage
  --with-libatomic=DIR               set path to libatomic_ops library sources

  --with-openssl=DIR                 set path to OpenSSL library sources
  --with-openssl-opt=OPTIONS         set additional build options for OpenSSL

  --with-debug                       enable debug logging

[root@reader nginx-1.24.0]#

安装http_stub_status_module 模块，预编译

[root@reader nginx-1.24.0]# ./configure --prefix=/usr/local/nginx --with-threads --with-http_ssl_module --with-http_gzip_static_module --with-http_stub_status_module

4.执行make命令进行编译

因为我们已经安装过nginx，所有这里只需make，不需要make install。如果是首次安装，请查看另一篇博文。

5.停止Nginx并备份可执行程序

[root@reader nginx-1.24.0]# nginx -s stop
[root@reader nginx-1.24.0]# ps -ef | grep nginx
root     13343 10455  0 22:22 pts/0    00:00:00 grep --color=auto nginx
[root@reader nginx-1.24.0]# cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx_20231105.bak
[root@reader nginx-1.24.0]# cd /usr/local/nginx/sbin/
[root@reader sbin]# ll
total 11664
-rwxr-xr-x 1 root root 5971720 Nov  3 23:35 nginx
-rwxr-xr-x 1 root root 5971720 Nov  5 22:22 nginx_20231105.bak

6.覆盖可执行程序

用第4步重新编译后的可执行程序覆盖旧的可执行程序

[root@reader sbin]# cd /usr/soft/nginx-1.24.0/objs/ && ll
total 6028
-rw-r--r-- 1 root root   19235 Nov  5 22:14 autoconf.err
-rw-r--r-- 1 root root   43108 Nov  5 22:14 Makefile
-rwxr-xr-x 1 root root 6018504 Nov  5 22:20 nginx
-rw-r--r-- 1 root root    5537 Nov  5 22:20 nginx.8
-rw-r--r-- 1 root root    7435 Nov  5 22:14 ngx_auto_config.h
-rw-r--r-- 1 root root     657 Nov  5 22:14 ngx_auto_headers.h
-rw-r--r-- 1 root root    6385 Nov  5 22:14 ngx_modules.c
-rw-r--r-- 1 root root   53304 Nov  5 22:20 ngx_modules.o
drwxr-xr-x 9 root root      91 Nov  3 23:23 src
[root@reader objs]# cp /usr/soft/nginx-1.24.0/objs/nginx /usr/local/nginx/sbin/
cp: overwrite '/usr/local/nginx/sbin/nginx'? yes
[root@reader objs]# cd /usr/local/nginx/sbin/ && ll
total 11712
-rwxr-xr-x 1 root root 6018504 Nov  5 22:25 nginx
-rwxr-xr-x 1 root root 5971720 Nov  5 22:22 nginx_20231105.bak
[root@reader sbin]#

7.查询Nginx配置参数并启动

http_stub_status_module模块安装成功。

[root@reader sbin]# nginx -V
nginx version: nginx/1.24.0
built by gcc 8.5.0 20210514 (Red Hat 8.5.0-4) (GCC) 
built with OpenSSL 1.1.1k  FIPS 25 Mar 2021
TLS SNI support enabled
configure arguments: --prefix=/usr/local/nginx --with-threads --with-http_ssl_module --with-http_gzip_static_module --with-http_stub_status_module
[root@reader sbin]# nginx
[root@reader sbin]# ps -ef | grep nginx
root     13417     1  0 22:26 ?        00:00:00 nginx: master process nginx
nobody   13418 13417  0 22:26 ?        00:00:00 nginx: worker process
nobody   13419 13417  0 22:26 ?        00:00:00 nginx: worker process
root     13518 10455  0 22:37 pts/0    00:00:00 grep --color=auto nginx
[root@reader sbin]#