Skip to content

Nginx 编译选项

通过查看 nginx 编译参数可以知道当前 nginx 支持的模块, 从而知道支持那些功能

命令

以下示例来自于 RockyLinux 源, 不同系统版本可能有所不同

使用 nginx -V 查看当前已安装版本的编译参数

$ nginx -V
nginx version: nginx/1.23.1
built by gcc 8.5.0 20210514 (Red Hat 8.5.0-10) (GCC)
built with OpenSSL 3.0.1 14 Dec 2021 (running with OpenSSL 3.0.7 1 Nov 2022)
TLS SNI support enabled
configure arguments: --prefix=/usr/share/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --http-client-body-temp-path=/var/lib/nginx/tmp/client_body --http-proxy-temp-path=/var/lib/nginx/tmp/proxy --http-fastcgi-temp-path=/var/lib/nginx/tmp/fastcgi --http-uwsgi-temp-path=/var/lib/nginx/tmp/uwsgi --http-scgi-temp-path=/var/lib/nginx/tmp/scgi --pid-path=/run/nginx.pid --lock-path=/run/lock/subsys/nginx --user=nginx --group=nginx --with-compat --with-debug --with-file-aio --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_degradation_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module=dynamic --with-http_mp4_module --with-http_perl_module=dynamic --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-http_xslt_module=dynamic --with-mail=dynamic --with-mail_ssl_module --with-openssl-opt=enable-ktls --with-pcre --with-pcre-jit --with-stream=dynamic --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-threads --with-cc-opt='-O2 -g -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -fexceptions -fstack-protector-strong -grecord-gcc-switches -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection' --with-ld-opt='-Wl,-z,relro -Wl,-z,now -specs=/usr/lib/rpm/redhat/redhat-hardened-ld -Wl,-E'

配置参数

参数名称备注
--prefix=value指向安装目录
--sbin-path指向(执行)程序文件(
--conf-path=指向配置文件(
--error-log-path=指向错误日志目录
--pid-path=指向
--lock-path=指向
--user=指定程序运行时的用户名
--group=指定程序运行时的用户组名
--builddir=指向编译目录
--with-rtsig_module启用 rtsig 模块支持(实时信号)
--with-select_module启用 select 模块支持(一种轮询模式,不推荐在高载环境下使用)禁用:
--with-poll_module启用 poll 模块支持(功能与 select 相同,与 select 特性相同,为一种轮询模式,不推荐在高载环境下使用)
--with-file-aio启用 file aio 支持(一种 APL 文件传输格式)
--with-ipv6启用 ipv6 支持
--add-module=启用外部模块支持
--with-cc=指向 C 编译器路径
--with-cpp=指向 C 预处理路径
--with-cc-opt=设置 C 编译器参数
--with-ld-opt=设置连接文件参数
--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-perl=设定 perl 库文件路径
--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 日志
--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启用
--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 支持(该模块同
--without-http_ssi_module禁用 ngx_http_ssi_module 支持(该模块提供了一个在输入端处理处理服务器包含文件(SSI)的过滤器,目前支持 SSI 命令的列表是不完整的)
--without-http_userid_module禁用 ngx_http_userid_module 支持(该模块用来处理用来确定客户端后续请求的
--without-http_access_module禁用 ngx_http_access_module 支持(该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于 IP 地址)
--without-http_auth_basic_module禁用 ngx_http_auth_basic_module(该模块是可以使用用户名和密码基于 HTTP 基本认证方法来保护你的站点或其部分内容)
--without-http_autoindex_module禁用 ngx_http_autoindex_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禁用 ngx_http_referer_module 支持(该模块用来过滤请求,拒绝报头中 Referer 值不正确的请求)
--without-http_rewrite_module禁用 ngx_http_rewrite_module ,链接重写
--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 支持
--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禁用
--without-http_browser_module禁用 ngx_http_browser_module 支持
--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 模块路径
--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 协议
--without-mail_imap_module禁用 IMAP 协议
--without-mail_smtp_module禁用 SMTP 协议
--with-google_perftools_module启用 ngx_google_perftools_module 支持(调试用,剖析程序性能瓶颈)
--with-cpp_test_module启用 ngx_cpp_test_module

参考