1. 通用配置项
--prefix=<path>
:Nginx 安装的根路径,所有其他的路径都要依赖于该选项。--sbin-path=<path>
:指定 Nginx 二进制文件的路径。如果没有指定,那么这个路径会依赖于 --prefix 选项。--conf-path=<path>
:如果在命令行没有指定配置文件,那么将会通过这里指定路径,Nginx 将会去那里查找它的配置文件。--error-log-path=<path>
:指定错误文件的路径,Nginx 将会往其中写入错误日志文件,除非有其他的配置。--pid-path=<path>
:指定的文件将会写入 Nginx master 进程的 pid,通常在 /var/run 下。--lock-path=<path>
:共享存储器互斥锁文件的路径。--user=<user>
:worker 进程运行的用户。--group=<group>
:worker 进程运行的组。--with-file-aio
:为 FreeBSD 4.3+ 和 Linux 2.6.22+ 系统启用异步 I/O。--with-debug
:这个选项用于启用调试日志。在生产环境的系统中不推荐使用该选项。
2. 优化编译
--with-cc=<path>
:如果想设置一个不在默认 PATH 下的 C 编译器。--with-cpp=<path>
:设置 C 预处理器的相应路径.--with-cc-opt=<options>
: 指定必要的 include 文件路径,可能 d(-I<path)指出,也可能是优化(-O4)和指定一个 64 位构建。--with-ld-opt=<options>
:包含连接器库的路径(-L)和运行路径(-R )。 --with-cpu-opt=<cpu>
:通过该选项为特定的 CPU 构建 Nginx。
3. mail 配置选项
--with-mail
:该选项用于启用 mail 模块,该模块默认没有激活。--with-mail_ssl_module
:为了代理任何一种类型的使用 SSL/TLS 的 mail,激活该模块。--without-mail_pop3_module
:在启用 mail 模块后,单独地禁用 POP3 模块。--without-mail_imap_module
:在启用 mail 模块后,单独地禁用 IMAP 模块。--without-mail_smtp_module
:在启用 mail 模块后,单独地禁用 SMTP 模块。--without-http
:该选项将完全禁用 http 模块,如果你只想支持 mail,那么可以使用它。
对于典型的 mail 代理,可配置为如下:
./configure -with-mail --with-mail_ssl_module --with-openssl=${BUILD_DIR}/openssl-1.0.1c
对于邮件服务器来说,现在几乎每一个邮件服务器的安装都需要安装 SSL/TLS,并没没有一个邮件代理启用了预期功能的用户。推荐静态编译 OpenSSL,以便对操作系统中的 OpenSSL 库没有依赖性。
4. http 配置选项
--without-http-cache
:在使用 upstream 模块时,Nginx 能够配置本地缓存内容。这个选项能够禁用缓存。--with-http_perl_module
:Nginx 配置能够扩展使用 Perl 代码。这个选项启用这个模块(然而使用这个模块会降低性能)。--with-perl_modules_path=<path>
:对于额外嵌入的 Perl 模块,使用该选项指定该 Perl 解析器的路径。也可以通过配置选项来指定 Perl 模块解析器的位置。--with-perl=<path>
:如果在默认的路径中没有找到 Perl,那么指定 Perl(5.6 版本以上)的路径。--http-client-body-temp-path=<path>
:从客户端收到请求后,该选项设置的目录用于作为请求体临时存放的目录。如果 WebDAV 模块启用,那么推荐设置该路径为同一个文件系统上的目录作为最终的目的地。--http-proxy-temp-path=<path>
:在使用代理后,通过该选项设置存放临时文件路径。--http-fastcgi-temp-path=<path>
:设置 FastCGI 临时文件的目录。--http-uwsgi-temp-path=<path>
:设置 uWSGI 临时文件的目录。--http-scgi-temp-path=<path>
:设置 SCGI 临时文件的目录。--with-http_ssl_module
:如果需要对流量进行加密,那么可以使用这个选项,在 URLs 中开始部分将会是 https(需要 OpenSSL)。--with-http_realip_module
:如果你的 Nginx 在七层负载均衡器或者是其他设备之后,它们将 Http 头中的客户端 IP 地址传递,那么你将会需要启用这个模块。在多个客户处于一个 IP 地址下使用。--with-http_addition_module
:这个模块作为一个输出过滤器,使你能够在请求经过一个 location 前或者后时在该 location 本身添加内容。--with-http_xslt_module
:该模块用于 XML 响应转换,基于一个或者多个 XSLT 格式(需要 libxml2 和 libxslt 库)。--with-http_image_filter_module
:该模块被作为图像过滤器使用,在将图像投递到客户之前进行处理(需要 libgd 库)。--with-http_geoip_module
:使用该模块,能够设置各种变量以便在配置文件中的区段使用,基于地理位置查找客户端 IP 地址(需要 MaxMfind GeoIP 库和相应的预编译数据库文件)。--with-http_sub_module
:该模块实现了替代过滤,在响应中用一个字符串替代另一个字符串。--with-http_dav_module
:启用这个模块将激活使用 WebDAV 的配置指令。请注意,这个模块也只在有需要使用的基础上启用,如果配置不正确,它可能带来安全问题。--with-http_flv_module
:如果需要提供 Flash 流媒体视频文件,那么该模块将会提供伪流媒体。--with-http_mp4_module
:这个模块支持 H.264/AAC 文件伪流媒体。--with-http_gzip_static_module
:当被调用的资源没有 .gz 结尾格式的文件时,如果想支持发送预压缩版本的静态文件,那么使用该模块。--with-http_gunzip_module
:对于不支持 gzip 编码的客户,该模块用于为客户解压缩预压缩内容。--with-http_random_index_module
:如果你想提供从一个目录中随机选择文件的索引文件,那么这个模块需要被激活。--with-http_secure_link_module
:该模块提供了一种机制,它会将一个哈希值链接到一个 URL 中,因此,只有那些使用正确的密码能够计算链接。--with-http_stub_status_module
:启用这个模块后会收集 Nginx 自身的状态信息。输出的状态信息可以使用 RRDtool 或类似的东西来绘制成图。
对于网络加速/代理,可如下配置:
./configure --with-http_ssl_module --with-http_realip_module --with-http_geoip_module --with-http_stub_status_module --with-openssl=${BUILD_DIR}/openssl-1.0.1c
对于 Web 服务器:
./configure --with-http_stub_status_module
这两个配置不同之处在于它们面对的客户,处于 Web 加速时,会考虑到 SSL 请求的终结,也包括处理代理客户和基于客户来源决策。处于 Web 服务时,则仅需要提供默认文件访问能力。
5. 禁用的配置选项
--without-http_charset_module
:该字符集模块负责设置 Content-Type 响应头,以及从一个字符集转换到另一个字符集。--without-http_gzip_module
:gzip 模块作为一个输出过滤器,在将内容投递到客户时对内容进行压缩。--without-http_ssi_module
:该模块是一个过滤器,用于处理 SSI 包含。如果启用 Perl 模块,那么额外的 SSI 指令(perl)可用。--without-http_userid_module
:userid 模块能够使得 Nginx 设置 cookies,用于客户标识。变量 $uid_set 和 $uid_got 可以记录用户跟踪。--without-http_access_module
:access 模块基于 IP 控制访问 location。--without-http_auth-basic_module
:该模块通过 Http 基本身份验证限制访问。--without-http_autoindex_module
:如果一个目录中没有 index 文件,那么 autoindex 模块收集这个目录列出文件。--without-http_geo_module
:该模块能够让你基于客户端 IP 地址设置配置变量,然后根据这些变量的值采取行动。--without-http_map_module
:map 模块能够让你映射一个变量到另一个变量。--without-http_split_clients_module
:该模块创建用于 A/B 测试的变量。--without-http_referer_module
:该模块能够让 Nginx 阻止基于 Referer Http 头的请求。--without-http_rewrite_module
:通过 rewrite 模块能够让你基于变量条件改变 URI。--without-http_proxy_module
:使用 proxy 模块允许 Nginx 将请求传递到其他服务器或者服务器组。--without-http_fastcgi_module
:FastCGI 模块能够让 Nginx 将请求传递到 FastCGI 服务器。--without-http_uwsgi_module
:这个模块能够使得 Nginx 将请求传递到 uWSGI 服务器。--without-http_scgi_module
:SCGI 模块能够让 Nginx 将请求传递到 SCGI 服务器。--without-http_memcached_module
:该模块能够使得 Nginx 与一个 memcached 服务器进行交互,将响应放置到变量查询中。--without-http_limit_conn_module
:该模块能够使得 Nginx 基于某些键,通常是 IP 地址,设置连接限制。--without-http_limit_req_module
:通过该模块,Nginx 能够限制每个用户的请求率。--without-http_empty_gif_module
:在内存中产生一个 1 像素 * 1 像素的透明 GIF 图像。--without-http_browser_module
:browser 模块允许基于 User-Agent Http 请求头配置,变量的设置基于在该头中发现的版本。--without-http_upstream_ip_hash_module
:该模块定义了一组可以与不同的代理模块结合使用的服务器。