Nginx Configuration 常用参数及含义

参数	含义
--prefix=<path>	指定 Nginx 的安装路径。此项如果没有指定默认为 /usr/local/nginx/ 目录。
--sbin-path=<path>	指定 Nginx 可执行文件安装路径。此项只能在安装时指定。如果没有指定，则默认为 /sbin/nginx/ 目录。
--conf-path=<path>	在未给定 -c 选项下，指定默认的 nginx.conf 路径。如果未指定，默认为 /conf/ 目录。
--pid-path=<path>	在 nginx.conf 中未指定 pid 指令的情况下，指定默认的 nginx.pid 路径。如果未指定，默认为 /logs/nginx.pid。nginx.pid 保存了当前运行的 Nginx 服务的进程号。
--lock-path=<path>	指定 nginx.lock 文件的路径。nginx.lock 是 Nginx 服务器的锁文件，如果未指定，默认为 /var/lock/ 目录。
--error-log-path=<path>	在 nginx.conf 中未指定 error_log 指令的情况下，指定默认的错误日志路径。如果未指定，默认为 /logs/error.log
--http-log-path=<path>	在 nginx.conf 中未指定 access_log 指令的情况下，指定默认的访问日志路径。如果未指定，默认为 /logs/access.log
--user=<user>	在 nginx.conf 中未指定 user 指令的情况下，指定默认的 Nginx 服务器进程的属主用户，即 Nginx 进程运行的用户。可以理解为指定哪个用户启动 Nginx。如果未指定，默认为 nobody，表示不限制
--group=<group>	在 nginx.conf 中未指定 group 指令的情况下,指定默认的 Nginx 服务器进程的属主用户组，即 Nginx 进程运行的用户组。可以理解为指定哪个用户组的用户启动 Nginx。如果未指定，默认为 nobody，表示不限制
--builddir=<dir>	指定编译时的目录
--with-debug	声明启用 Niginx 的调试日志
--add-module=<path>	指定第三方模块的路径，用以编译到 Nginx 服务器中
--with-poll_module	声明启用 poll 模块。poll 模块是信号处理的一种方法，和下面提到的 select 模式类似，都是采用轮询方法处理信号
--without-poll_module	声明禁止 poll 模块
--with-select_module	声明启用 select 信号处理模式。弱 configure 未找到指定其他的信号处理模式（如 SUN 系统中的 kqueue、Linux2.6+ 内核的 epoll、实时信号 rtsig 以及和 select 类似的 /dev/poll 等），则默认使用 select 模式
--without-select_module	声明禁止 select 信号处理模式
--with-http_ssl_module	声明启用 HTTP 的 ssl 模块，这样 Nginx 服务器就可以支持 HTTPS 请求了。这个模块的正常运行需要安装 openssl 库（在 DEBIN 上为 libssl）
--with-http_realip_module	声明启用 HTTP 的 realip 模块。默认不启用
--with-http_addition_module	声明启用 HTTP 的 addition 模块。默认不启用
--with-http_sub_module	声明启用 HTTP 的 sub 模块。默认不启用
--with-http_dav_module	声明启用 HTTP 的 dav 模块。默认不启用
--with-http_flv_module	声明启用 HTTP 的 flv 模块。默认不启用。flv 模块使得 Nginx 服务器支持 flv 媒体流的传输
--with-http_stub_status_module	声明启用 Server Status 页。默认不启用
--with-http_perl_module	声明启用 HTTP 的 perl 模块。默认不启用。perl 模块使得 Nginx 服务器支持 perl 脚本的运行
--with-perl_modules_path=<path>	指定 perl 模块的路径
--with-perl=<path>	指定 perl 执行文件的路径
--without-http_charset_module	声明禁用 HTTP 的 charset 模块。默认启用
--without-http_gzip_module	声明禁用 HTTP 的 gzip 模块。使用 gzip 模块，需要安装 zlib 库
--without-http_ssi_module	声明禁用 HTTP 的 ssi 模块。默认启用
--without-http_userid_module	声明禁用 HTTP 的 userid 模块。默认启用
--without-http_access_module	声明急用 HTTP 的 access 模块。默认启用
--without-http_auth_basic_module	声明急用 HTTP 的 auth basic 模块。默认启用
--without-http_autoindex_module	声明禁用 HTTP 的 autoindex 模块。默认启用
--without-http_geo_module	声明禁用 HTTP 的 geo 模块。默认启用
--without-http_map_module	声明禁用 HTTP 的 map 模块。默认启用
--without-http_referer_module	声明禁用 HTTP 的 referer 模块。默认启用
--without-http_rewrite_module	声明禁用 HTTP 的 rewrite 模块。默认启用。使用 rewrite 模块，需要安装 pcre 库
--without-http_proxy_module	声明禁用 HTTP 的 proxy 模块。默认启用
--without-http_fastcgi_module	声明急用 HTTP 的 fastcgi 模块。默认启用
--without-http_memcached_module	声明禁用 HTTP 的 memcached 模块。默认启用
--without-http_limit_zone_module	声明禁用 HTTP 的 limit zone 模块。Limit zone 模块主要负责 Nginx 服务器共享内存的管理
--without-http_empty_gif_module	声明禁用 HTTP 的 empty gif 模块。默认启用
--without-http_browser_module	声明禁用 HTTP 的 browser 模块。默认启用
--without-http_upstream_ip_hash_module	声明禁用 HTTP 的 upstream hash 模块。默认启用
--http_client-body-temp-path=<path>	指定存放 HTTP 访问客户端请求报文的临时文件的路径
--http-proxy-temp-path=<path>	启用 HTTP 的 proxy 模块后，指定存放 HTTP 代理临时文件的路径
--http-fastcgi-temp-path=<path>	启用 HTTP 的 fastcgi 模块后，指定存放 fastcgi 模块临时文件的路径
--without-http	声明禁用 HTTP Server
--with-mail	声明启用 IMAP4/POP3/SMTP 代理模块。该模块负责 Mail 代理服务的处理
--with-mail_ssl_module	声明启用 ngx_mail_ssl_module
--with-cc=<path>	指定 C 编译器的路径
--with-cpp=<path>	指定 C 预处理器的路径
--with-cc-opt=<options>	为 CFLGS 变量添加额外的参数，保证 Nginx 源代码及其模块能够正确编译。比如在 FreeBSD 系统中，为了在编译 Nginx 源代码的同时正确编译 pcre 库，必须使用 --with-cc-opt="-I /usr/local/include"声明；再比如，为了使用 select 模块，必须增加系统允许打开的文件描述符的数量，其中一种方法就是使用 --with-cc-opt="-D FD_SETSIZE=2048" 声明
--with-ld-opt=<path>	为部分 Nginx 软件的模块编译指定链接库目录。比如在 FreeBSD 系统中，为了在编译 Nginx 源代码的同时编译 pcre 库，必须使用 --with-ld-opt="-L /usr/local/lib" 声明
--without-cpu-opt=<cpu>	为特定的 CPU 编译 Nginx 源代码。官方文档中指定的有效值包括：pentium、pentium pro、pentium 3、pentium 4、athlon、opteron、amd 64、sparc 32、sparc 64、ppc 64 等
--with-pcre=<dir>	指定 pcre 库源代码的路径。这样可以再编译 Nginx 源代码的同时编译 pcre 库，而不需要提前安装 pcre 库
--without-pcre	禁止 Nginx 服务器使用 pcre 库。此设置同时也会禁止 HTTP rewrite 模块，因为 rewrite 模块的正常运行必须由 pcre 库支持。在解析配置文件的 location 指令中的正则表达式时，也需要使用 pcre 库。因此，强烈建议用户不要使用此选项
--with-pcre-opt=<option>	为 pcre 库的 building 指定额外的指令
--with-md5=<dir>	指定 md5 库源代码的路径。这样可以在编译 Nginx 源代码的同时编译 md5 库，而不需要提前安装 md5 库
--with-md5-opt=<options>	为 md5 库的 building 指定额外的指令
--with-md5-asm	声明使用 md5 库的汇编源代码
--with-sha1=<dir>	指定 sha1 库源代码的路径。这样可以在编译 Nginx 源代码的同时编译 sha1 库，而不需要提前安装 sha1 夸
--with-sha1-opt=<option>	为 sha1 库的 building 指定额外的指令
--with-sha1-asm	声明使用 sha1 库的汇编源代码
--with-zlib=<dir>	指定 zlib 库源代码的路径。这样可以在编译 Nginx 源代码的同时编译 zlib 库，可以不提前安装 zlib 库。zlib 库支持 gzip 模块
--with-zlib-opt=<option>	为 zlib 库的 building 指定额外的指令
--with-zlib-asm	声明使用 zlib 库的汇编源代码
--with-openssl=<dir>	指定 OpenSSL 库源代码的路径。这样可以在编译 Nginx 源代码的同时编译 OpenSSL 库，而不需要提前安装 OpenSSL 库
--with-openssl-opt=<option>	为 OpenSSL 库的 building 指定额外的指令