转载自原文,备份便于以后使用
路径相关参数
参数 | 说明 |
---|---|
--prefix=PATH | Nginx安装部署后的根目录,默认为/usr/local/nginx。这个目标的设置会影响其他参数中的相对目录。例如:如果设置了--sbin-path=sbin/nginx,那么实际上可执行文件会被放到/usr/local/nginx/sbin/nginx中。 |
--sbin-path=PATH | 可执行文件的放置路径。默认为/sbin/nginx。 |
--conf-path=PATH | 配置文件的放置路径。默认为/conf/nginx.conf。 |
--error-log-path=PATH | error日志文件的放置路径,默认为/logs/error.log。 |
--pid-path=PATH | pid文件的存放路径。以ASCII码存放Nginx master的进程ID,在使用命令行式(例如nginx -s reload)通过读取master进程ID向master进程发送信号时,才能对运行中Nginx服务产生作用,默认为/logs/nginx.pid。 |
--lock-path=PATH | lock文件的放置路径,默认为/logs/nginx.lock。 |
--builddir=DIR | configure执行时与编译期间产生的临时文件放置的目录,包括产生的Makefile、C源文件、目标文件、可执行文件等。默认为/objs。 |
--with-http_perl_module | |
--with-http_perl_module=dynamic | |
--with-perl_modules_path=PATH | perl模块放置的路径,只有使用第三方perl模块才需要配置此路径。 |
--with-perl=PATH | perl二进制放置路径。如果配置的Nginx会执行Perl脚本,那么必须要设置此路径。 |
--http-log-path=PATH | access日志放置的位置。每一个HTTP请求在结束时都会记录的访问日志。默认为/logs/access.log。 |
--http-client-body-temp-path=PATH | 处理HTTP请求时如果请求的包体需要暂时存放到临时磁盘文件中,则把这样的临时文件放置到该路径下。默认为/client_body_temp。 |
--http-proxy-temp-path=PATH | Nginx作为HTTP反向代理服务器时,上游服务器产生的HTTP包体需要临时存放到磁盘文件的路径。默认为/proxy_temp。 |
--http-fastcgi-temp-path=PATH | Fastcgi所使用临时文件的放置目录,默认为/fastcgi_temp。 |
--http-uwsgi-temp-path=PATH | uWSGI所使用临时文件的放置目录,默认为/uwsgi_temp。 |
--http-scgi-temp-path=PATH | SCGI所使用临时文件的放置目录,默认为/scgi_temp。 |
编译相关参数
参数 | 说明 |
---|---|
--with-cc=PATH | C编译器的路径。 |
--with-cpp=PATH | C预编译器的路径。 |
--with-cc-opt=OPTIONS | 如果希望在Nginx编译期间指定加入一些编译选项,如指定宏或者使用-I加入某些需要包含的目录。 |
--with-ld-opt=OPTIONS | 执行链接操作时需要指定链接的参数。 |
--with-cpu-opt=CPU | 指定CPU处理器架构,只能取:pentium、pentiumpro、pentium3、pentium4、athlon、opteron、sparc32、sparc64、ppc64 |
依赖软件相关参数
pcre
参数 | 说明 |
---|---|
--without-pcre | 如果确认Nginx不用解析正则表达式,也就是nginx.conf配置文件不会出现正则表达式,那么可以使用这个参数。 |
--with-pcre | 强制使用PCRE库。 |
--with-pcre=DIR | 指定PCRE库的源码位置,在编译Nginx时会进入该目录编译PCRE源码。 |
--with-pcre-opt=OPTIONS | 编译PCRE源码时希望加入的编译选项。 |
--with-pcre-jit |
openssl
参数 | 说明 |
---|---|
--with-openssl=DIR | 指定openssl库的源码位置,在编译Nginx时会进入该目录编译openssl源码。注意:如果web服务器支持。 |
--with-openssl-opt=OPTIONS | 编译openssl源码时希望加入的编译选项。 |
atomic原子库
参数 | 说明 |
---|---|
--with-libatomic | 强制使用atomic库。 |
--with-libatomic=DIR | atomic库所在的位置。 |
散列函数库
参数 | 说明 |
---|---|
--with-MD5=DIR | 指定MD5源码位置,在编译Nginx时会进入该目录编译MD5源码。注意:Nginx已经有MD5算法的实现。 |
--with-MD5-opt=OPTIONS | 编译MD5源码时希望加入的编译选项。 |
--with-MD5-asm | 使用MD5的汇编源码 |
--with-SHA1=DIR | 指定SHA1源码位置,在编译Nginx时会进入该目录编译SHA1源码。注意:openssl中已经有SHA1算法 |
--with-SHA1-opt=OPTIONS | 编译SHA1源码时希望加入的编译选项。 |
--with-SHA1-asm | 使用SHA1的汇编源码。 |
ZLIB
参数 | 说明 |
---|---|
--with-zlib=DIR | 指定ZLIB源码位置。编译Nginx时会进入该目录编译zlib源码。如果使用了gzip压缩功能,就需要zlib库的支持。 |
--with-zlib-opt=OPTIONS | 编译zlib源码时希望加入的编译选项。 |
--with-zlib-asn=CPU | 指定对特定的CPU使用的zlib库的汇编优化功能,目前只支持两种架构:pentium和pentiumpro。 |
核心HTTP模块(默认安装),以下为去除指令
参数 | 说明 |
---|---|
--without-http_charset_module | 不安装http charset模块。这个模块可以将服务器发出的HTTP相应重编码。 |
--without-http_gzip_module | 不安装http gzip模块。在服务器发出的HTTP相应包中,这个模块可以按照配置文件指定的content-type对特定大小的HTTP相应包体执行gzip压缩。 |
--without-http_ssi_module | 不安装http ssi模块。该模块可以在向用户返回HTTP响应包体中加入特定的内容,如HTML文件中固定的页头和页尾。 |
--without-http_userid_module | 不安装http userid模块。这个模块可以通过HTTP请求头部信息里的一些字段认证用户信息,以确定请求是否合法。 |
--without-http_access_module | 不安装http access模块。这个模块可以根据IP地址限制能够访问服务器的客户端。 |
--without-http_auth_basic_module | 不安装http auth basic模块。这个模块可以提供最简单的用户名/密码认证。 |
--without-http_mirror_module | 不安装http mirror模块。 |
--without-http_autoindex_module | 不安装http autoindex模块。该模块提供简单的目录浏览功能。 |
--without-http_geo_module | 不安装http geo模块。该模块可以定义一些变量,这些变量的值将与客户端的IP地址关联,这样Nginx针对不同地区的客户端返回不一样的结果,例如不同地区显示不同语言的网页。 |
--without-http_map_module | 不安装http map模块。这个模块可以建立一个key/value映射表,不同的key得到相应的value,这样可以针对不同URL做特殊处理。例如返回302重定向相应时,可以期望URL不同时返回的Location字段也不一样。 |
--without-http_split_clients_module | 不安装http split client模块。该模块会根据客户端的信息,例如IP地址、header头、cookie等,来区分处理。 |
--without-http_referer_module | 不安装http referer模块。该模块可以根据请求中的referer字段来拒绝请求。 |
--without-http_rewrite_module | 不安装http rewrite模块,该模块提供HTTP请求在Nginx服务内部的重定向功能,依赖PCRE库。 |
--without-http_proxy_module | 不安装http proxy模块。该模块提供最基本的HTTP反向代理功能。 |
--without-http_fastcgi_module | 不安装http fastcgui模块。该模块提供FastCGUI功能。 |
--without-http_uwsgi_module | 不安装http uwsgi模块。该模块提供uWSGI功能。 |
--without-http_scgi_module | |
--without-http_grpc_module | |
--without-http_memcached_module | 不安装http memcached模块。该模块使得Nginx直接由上游的memcached服务读取数据,并简单地适配成HTTP响应返回给客户端。 |
--without-http_limit_conn_module | |
--without-http_limit_zone_module | 不安装http limit zone模块。该模块针对某个IP地址限制并发连接数。例如,使Nginx对一个IP地址仅允许一个链接。 |
--without-http_limit_req_module | 不安装http limit req模块。该模块针对某个IP地址限制并发请求数。 |
--without-http_empty_gif_module | 不安装http empty gif模块。该模块可以使得Nginx在收到无效请求时,立刻返回内存中的1 X 1像素的GIF图片。这种好处在于,对于明显的无效请求不会去试图浪费服务器资源。 |
--without-http_browser_module | 不安装http brower模块。该模块会根据HTTP请求中的user-agent字段来是被浏览器。 |
--without-http_upstream_hash_module | |
--without-http_upstream_ip_hash_module | 不安装http upstream ip hash模块。该模块提供当Nginx与后端server建立连接时,会根据IP做散列运算来决定与后端那台server通信,从而实现负载均衡 |
--without-http_upstream_least_conn_module | |
--without-http_upstream_random_module | |
--without-http_upstream_keepalive_module | |
--without-http_upstream_zone_module |
HTTP模块(默认不安装)
参数 | 说明 |
---|---|
--with-http_ssl_module | 安装http ssl模块。该模块使Nginx支持SSL协议,提供HTTPS服务。注意:该模块依赖openssl。 |
--with-http_v2_module | 安装http v2模块。 |
--with-http_realip_module | 安装http realip模块。该模块可以从客户端请求里的header信息(如X-Real-IP或者X-Forwarder-For)获取真正客户端的IP地址。 |
--with-http_addition_module | 安装http addition模块。该模块可以在返回客户端的HTTP包体头部或者尾部增加内容。 |
--with-http_xslt_module | 安装http xslt模块。这个模块可以使XML格式的数据在发给客户端前加入XSL渲染。注意:该模块依赖于libxml2和libxslt。 |
--with-http_xslt_module=dynamic | 开启动态http xslt模块。 |
--with-http_image_filter_module | 安装http image_filter模块。这个模块将符合配置的图片实时压缩为指定大小的缩略图再发送给用户,目前支持JPEG、PNG、GIF格式。注意:该模块依赖与libgd库。 |
--with-http_image_filter_module=dynamic | 开启动态http image filter模块。 |
--with-http_geoip_module | 安装http geoip模块。该模块可以一句MaxMind GeoIP的IP地址数据库对客户端的IP地址得到实际的地理位置。注意:该模块依赖于MaxMindGeoIP的库文件。 |
--with-http_geoip_module=dynamic | 开启动态http geoip模块。 |
--with-http_sub_module | 安装http sub模块。该模块可以在Nginx返回客户端的HTTP响应包中将指定字符串替换为自己需要的字符串。 |
--with-http_dav_module | 安装http dav模块。该模块可以让Nginx支持Webdav标准,如支持Webdav中的PUT、DELETE、COPY、MOVE、MKCOL等请求。 |
--with-http_flv_module | 安装http flv模块。该模块可以在向客户端返回响应时,对flv格式的视频文件在header头做一些处理,使得客户端可以观看、拖放FLV视频。 |
--with-http_MP4_module | 安装http MP4模块。该模块时客户端可以观看、拖动MP4视频。 |
--with-http_gunzip_module | 安装http gunzip模块。 |
--with-http_gzip_static_module | 安装http gzip_static模块。如果采用gzip把一些文档进行gzip格式压缩后再返回给客户端,那么对同一个文件每次都会重新压缩,这是比较消耗服务器CPU资源的。gzip static模块可以在做gzip压缩前,先查看相同位置是否有已经做过gzip压缩的.gz文件,如果有就直接返回。 |
--with-http_auth_request_module | 安装http auth request模块。 |
--with-http_random_index_module | 安装http random_index模块。该模块在客户端访问某个目录时,随机返回该目录下的任意文件。 |
--with-http_secure_link_module | 安装http secure link模块。该模块提供一种验证请求是否有效的机制。例如,它会验证URL中需要加入token参数是否属于特定客户端发来的,以及检查时间戳是否过期。 |
--with-http_degradation_module | 安装http dagradation模块。该模块针对一些特殊的系统调用(如sbrk)做优化,如直接返回HTTP响应码为204或者404.目前不支持Linux系统。 |
--with-http_slice_module | 安装http slice模块。 |
--with-http_stub_status_module | 安装http stub_status模块。该模块可以让运行中的Nginx提供性能统计页面,获取相关的并发链接。 |
--with-goole_perftools__module | 安装goole perftools模块。该模块提供Goole的性能测试工具。 |
邮箱模块
参数 | 说明 |
---|---|
--with-mail | 安装邮件服务器反向代理模块,使Nginx可以反向代理IMAP、POP3、SMTP等协议。 |
--with-mail_ssl_module | 安装mail ssl模块。该模块可以使IMAP、POP3、SMTP等协议基于SSL/TLS协议之上。 |
--without-mail_pop_module | 不安装mail pop3模块。在使用–with-mail后pop3模块是默认安装的,此选项取消安装。 |
--without-mail_imap_module | 不安装mail imap模块。在使用–with-mail后imap模块是默认安装的,此选项取消安装。 |
without-mail_smtp_module | 不安装mail smtp模块。在使用–with-mail后smtp模块是默认安装的,此选项取消安装。 |
Stream
参数 | 说明 |
---|---|
--with-stream | 开启TCP/IP代理模块。 |
--with-stream=dynamic | 开启动态TCP/IP代理模块。 |
--with-stream_ssl_module | |
--with-stream_realip_module | |
--with-stream_geoip_module | |
--with-stream_geoip_module=dynamic | |
--with-stream_ssl_preread_module | |
--without-stream_limit_conn_module | |
--without-stream_access_module | |
--without-stream_geo_module | |
--without-stream_map_module | |
--without-stream_split_clients_module | |
--without-stream_return_module | |
--without-stream_upstream_hash_module | |
--without-stream_upstream_least_conn_module | |
--without-stream_upstream_random_module | |
--without-stream_upstream_zone_module |
其他参数
<div style="width:290px">参数</div> | <center>说明 |
---|---|
--with-debug | 将Nginx需要打印debug调试级别日志的代码编译进Nginx。这样可以在Nginx运行时通过修改配置文件来使其打印调试日志,这对于研究、定位Nginx问题非常有帮助。 |
--add-module=PATH | 当在Nginx里加入第三方模块时,通过这个参数指定第三方模块的路径。 |
--add-dynamic-PATH | 启动动态外部模块。 |
--with-compat | 动态模块兼容。 |
--without-http | 禁用HTTP服务器。 |
--without-http-cache | 禁用HTTP服务器里的缓存cache特性。 |
--with-file-aio | 启用文件的异步I/O功能来处理磁盘文件,这需要linux内核支持原生的异步I/O。 |
--with-ipv6 | 使Nginx支持IPV6。 |
--user=USER | 指定Nginx woker进程运行时所属的用户。注意:不要将启动woker进程的用户设为root,在woker进程出问题时master进程要具备停止/启动woker进程的能力。 |
--group=GROUP | 指定Nginx worker进程运行时所属的组。 |
--with-cpp_test_module | 开启C++测试模块。 |
--with-threads | 启动线程池支持。 |
网友评论