nginx编译安装upstream模块 nginx 编译配置

转载

mob64ca13faa4e6 2024-04-02 13:31:23

文章标签 nginx编译安装upstream模块运维操作系统 nginx Nginx 文章分类 运维

对于nginx我们在编译的时候，有些编译参数是不需要的，有的是必备编译参数，那么怎么样根据需求来选择nginx的编译参数呢，下面就来讲讲nginx的./configure编译参数相关说明

一 Nginx的./configure编译参数说明介绍

可以看出，configure命令至关重要，比如根据自己需要选择性的安装nginx是很有必要的，下文将详细介绍如何使用configure命令使用方法。

我们在解压了nginx的源码后，进入到nginx的源码目录使用“./configure --help”之后可以详细的查看到关于nginx的./confugure的参数介绍，相关参数如下：

1. 路径相关的参数

./confugure的参数	参数说明	默认值
--prefix=PATH	指定安装目录	/usr/local/nginx
--sbin-path=PATH	指定nginx命令路径<	<prefix>/sbin
--conf-path=PATH	指定nginx配置文件路径	<prefix>/conf
--error-log-path=PATH	指定错误日志存放路径	<prefix>/logs/error.log
--pid-path=PATH	指定nginx进程pid文件路径	<prefix>/logs/nginx.pid
--lock-path=PATH	指定nginx的lock文件路径	<prefix>/logs/nginx.lock
--builddir=DIR	指定编译文件存放的目录	<nginx source path>/objs
--with-perl_modules_path=PATH	指定Perl模块的的路径（只有使用了第三方的Perl模块时才可用到）	无
--with-perl=PATH	指定Perl binary路径，只有当nginx会使用Perl脚本时才用到	无

--http-log-path=PATH	指定访问日志文件路径	<prefix>/logs/access.log
--http-client-body-temp-path=PATH	指定客户端访问的缓存网页文件存放路径	<prefix>/client_body_temp
--http-proxy-temp-path=PATH	指定nginx用于代理时产生的缓存文件存放路径	<prefix>/proxy_temp
--http-fastcgi-temp-path=PATH	指定fastcgi的临时文件存放路径	<prefix>/fastcgi_temp
--http-uwsgi-temp-path=PATH	指定uwsgi的临时文件存放路径	<prefix>/uwsgi_temp
--http-scgi-temp-path=PATH	指定scgi的临时文件存放路径	<prefix>/scgi_temp

2. 编译相关的参数

如下列出了编译Nginx时与编译器相关的参数。

./confugure的参数	参数含义
--with-cc=PATH	指定C编译器的路径
--with-cpp=PATH	指定C预编译器的路径
--with-cc-opt=OPTIONS	设置C编译器参数（PCRE库,需要指定–with-cc-opt=”-I /usr/local/include”，如果使用select()函数则需要同时增加文件描述符数量，可以通过–with-cc-opt=”-D FD_SETSIZE=2048”指定。
--with-ld-opt=OPTIONS	设置连接文件参数。（PCRE库，需要指定–with-ld-opt=”-L /usr/local/lib”。）
--with-cpu-opt=CPU	指定编译的CPU，可用的值为: pentium, pentiumpro, pentium3,pentium4, athlon,opteron, amd64, sparc32, sparc64, ppc64

3. 依赖软件的相关参数

如下列出了Nginx依赖的常用软件支持的参数。

./confugure的参数	参数含义
--without-pcre	禁用pcre库
--without-pcre	启用pcre库
--with-pcre=DIR	指向pcre库文件目录
--with-pcre-opt=OPTIONS	在编译时为pcre库设置附加参数
--with-pcre-jit	建立pcre jit支持

4. OpenSSL相关参数

./confugure的参数	参数含义
--with-openssl=DIR	指定openssl安装目录
--with-openssl-opt=OPTIONS	在编译时为openssl设置附加参数

5. 原子库的相关参数

./confugure的参数	参数含义
--with-libatomic	为原子内存的更新操作的实现提供一个架构
--with-libatomic=DIR	指定libatomic的安装目录

6 .散列函数库相关参数

./confugure的参数	参数含义
--with-md5=DIR	指定md5库文件目录（消息摘要算法第五版，用以提供消息的完整性保护）
--with-md5-opt=OPTIONS	在编译时为md5库设置附加参
--with-md5-asm	使用md5汇编源
--with-sha1=DIR	指向sha1库目录（数字签名算法，主要用于数字签名）
--with-sha1-opt=OPTIONS	在编译时为sha1库设置附加参数
--with-sha1-asm	使用sha1汇编源

7. zlib库的设置参数

./confugure的参数	参数含义
--with-zlib=DIR	指向zlib库目录
--with-zlib-opt=OPTIONS	在编译时为zlib设置附加参
--with-zlib-asm=CPU	为指定的CPU使用zlib汇编源进行优化，CPU类型为pentium, pentiumpro

8.模块相关的参数

除了少量核心代码外，Nginx完全是由各种功能模块组成的。这些模块会根据配置参数决定自己的行为，因此，正确地使用各个模块非常关键。在configure的参数中，我们把它们分为五大类。

事件模块。（nginx的处理请求的方式）
默认即编译进入Nginx的HTTP模块。
默认不会编译进入Nginx的HTTP模块。
邮件代理服务器相关的mail 模块。
其他模块。

* 事件模块

./confugure的参数	参数含义
--with-rtsig_module	启用rtsig模块支持（实时信号）
--with-select_module	启用select模块支持（一种轮询模式,不推荐在高载环境下使用）
--without-select_module	禁用select模块支持（一种轮询模式,不推荐在高载环境下使用
--with-poll_module	启用poll模块支持（功能与select相同，与select特性相同，一种轮询模式,不推荐在高载环境下使用）
--without-poll_module	禁用poll模块支持（功能与select相同，与select特性相同，一种轮询模式,不推荐在高载环境下使用）
--with-aio-module	使用AI的方式处理事件驱动，仅限于FreeBSD系统上使用，Linux默认不支持。

* 默认即编译进入Nginx的HTTP模块

注意下列模块在编译安装nginx时，是默认安装到nginx中，即nginx默认支持相关功能。如不需要，禁用即可！

./confugure的参数	参数含义
--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错误。依赖pcre库）即重定向功能
--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_conn_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支持（该模块用于简单的负载均衡）nginx负载均衡的一种算法
--without-http_upstream_least_conn_module
--without-http_upstream_keepalive_module	不启用用高可用支持模块

* 默认即编译不进入Nginx的HTTP模块

注意下列模块在编译安装nginx时，是默认不安装到nginx中，即需要nginx支持相关功能，必须添加相关./configure参数启动该功能。

./confugure的参数	参数含义
--with-http_ssl_module	启用ngx_http_ssl_module支持（使nginx支持https请求，需已安装openssl）
--with-http_spdy_module
--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请求）该模块依赖于libxml2和libxslt，启动前需要安装相关依赖包
--with-http_p_w_picpath_filter_module	启用ngx_http_p_w_picpath_filter_module支持（传输JPEG/GIF/PNG图片的一个过滤器）（默认为不启用。依赖于libgd库）
--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支持（提供寻求内存使用基于时间的偏移量文件,使客户端可以观看，拖动flv视频）

--with-http_mp4_module	启动MP4模块，使客户端可以观看，拖动MP4视频
--with-http_gunzip_module
--with-http_gzip_static_module	启用ngx_http_gzip_static_module支持（在线实时压缩输出数据流）
--with-http_auth_request_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自上次启动以来的工作状态，并发连接数情况）

--with-google_perftools_module	启用ngx_google_perftools_module支持（提供谷歌性能测试）
--with-cpp_test_module	启用ngx_cpp_test_module支持

* 邮件代理服务器相关的mail模块

./confugure的参数	参数含义
--with-mail	安装邮件反向代理模块，nginx可以反向代理IMAP,pop3,smtp等常见的邮件协议，默认不安装
--with-mail_ssl_module	启用ngx_mail_ssl_module支持，以支持邮件协议对ssl的支持，默认不安装并依赖openssl
--without-mail_pop3_module	禁用pop3邮件协议模块，启用--with-mail参数时，会自动安装，以使nginx支持pop3
--without-mail_imap_module	禁用IAMP邮件协议模块，启用--with-mail参数时，会自动安装,以使nginx支持IMAP
--without-mail_smtp_module	禁用smtp邮件协议模块，启用--with-mail参数时，会自动安装,以使nginx支持SMTP

* 其他参数模块

./confugure的参数	参数含义
--with-debug	开启debug日志调试功能，以利于nginx问题排查
--add-module=PATH	启用外部模块（第三方模块）
--without-http	禁用http服务
--without-http-cache	禁用http缓存功能
--with-file-aio	启动文件异步I/O功能来处理磁盘文件，这需要系统原生支持异步I/O
--with-ipv6	启动ipv6功能
--user=USER	指定nginx work进程的运行用户（推介使用nginx）
--group=GROUP	指定nginx work进程的运行用户组（推介使用nginx）