命令
nginx -V
查看当前已安装版本的编译参数
nginx version: nginx/1.21.6 built by clang 13.0.0 (clang-1300.0.29.30) built with OpenSSL 1.1.1m 14 Dec 2021 (running with OpenSSL 1.1.1o 3 May 2022) TLS SNI support enabled configure arguments: …
配置参数
参数名称 | 备注 |
---|---|
--prefix=value |
指向安装目录 |
--sbin-path |
指向(执行)程序文件(nginx ) |
--conf-path= |
指向配置文件(nginx.conf ) |
--error-log-path= |
指向错误日志目录 |
--pid-path= |
指向 pid 文件(nginx.pid ) |
--lock-path= |
指向 lock 文件(nginx.lock )(安装文件锁定,防止安装文件被别人利用,或自己误操作。)进程 ID 文件 |
--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 支持 |
--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 |
启用 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 支持(该模块用来处理用来确定客户端后续请求的 cookie ) |
--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 支持(该模块用于自动生成目录列表,只在 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 |
禁用 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 |
禁用 ngx_http_empty_gif_module 支持(该模块在内存中常驻了一个 1*1 的透明 GIF 图像,可以被非常快速的调用) |
--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 支持 |
部分摘自:http://www.ttlsa.com/nginx/nginx-configure-descriptions/