基础配置选项
--prefix=path
- 作用：设置 Nginx 安装目录。
- 使用场景：适用于需要自定义安装路径的情况。
- 示例 ：
--prefix=/opt/nginx - 注意事项：确保目标目录存在并且有写权限。
--sbin-path=path
- 作用：指定 Nginx 可执行文件的安装路径。
- 使用场景：适用于需要自定义可执行文件位置的情况。
- 示例 ：
--sbin-path=/usr/local/bin/nginx - 注意事项：确保路径有效且有执行权限。
--conf-path=path
- 作用：指定 Nginx 配置文件的路径。
- 使用场景：适用于需要自定义配置文件位置的情况。
- 示例 ：
--conf-path=/etc/nginx/nginx.conf - 注意事项：确保路径有效且配置文件格式正确。
--error-log-path=path
- 作用：指定 Nginx 错误日志文件的路径。
- 使用场景：适用于需要自定义错误日志位置的情况。
- 示例 ：
--error-log-path=/var/log/nginx/error.log - 注意事项：确保路径有效且有写权限。
--pid-path=path
- 作用：指定 Nginx PID 文件的位置。
- 使用场景：适用于需要自定义 PID 文件位置的情况。
- 示例 ：
--pid-path=/var/run/nginx.pid - 注意事项：确保路径有效且有写权限。
--lock-path=path
- 作用：指定 Nginx 锁文件的位置。
- 使用场景：适用于需要自定义锁文件位置的情况。
- 示例 ：
--lock-path=/var/lock/nginx.lock - 注意事项：确保路径有效且有写权限。
性能相关配置
--user=name
- 作用：设置 Nginx 工作进程的用户名。
- 使用场景：适用于需要指定工作进程运行用户的情况。
- 示例 ：
--user=nginx - 注意事项：确保该用户存在且有足够权限。
--group=name
- 作用：设置 Nginx 工作进程的组名。
- 使用场景：适用于需要指定工作进程运行组的情况。
- 示例 ：
--group=nginx - 注意事项：确保该组存在且有足够权限。
--with-debug
- 作用：启用调试日志。
- 使用场景：适用于开发和调试阶段。
- 示例 ：
--with-debug - 注意事项：调试日志会占用大量磁盘空间，不建议在生产环境中使用。
--with-pcre=path
- 作用：指定 PCRE 库的源代码路径，用于正则表达式支持。
- 使用场景：适用于需要正则表达式支持的情况。
- 示例 ：
--with-pcre=/path/to/pcre - 注意事项：确保 PCRE 库版本兼容。
--with-pcre-jit
- 作用：编译 PCRE 以支持 JIT（Just-In-Time）编译优化。
- 使用场景：适用于需要高性能正则表达式匹配的情况。
- 示例 ：
--with-pcre-jit - 注意事项：确保 CPU 支持 JIT 编译所需的指令集。
--with-zlib=path
- 作用：指定 zlib 库的源代码路径，用于 gzip 压缩功能。
- 使用场景：适用于需要压缩响应内容的情况。
- 示例 ：
--with-zlib=/path/to/zlib - 注意事项：确保 zlib 库版本兼容。
--with-openssl=path
- 作用：指定 OpenSSL 库的源代码路径，用于 HTTPS 支持。
- 使用场景：适用于需要 SSL/TLS 加密的情况。
- 示例 ：
--with-openssl=/path/to/openssl - 注意事项：确保 OpenSSL 库版本兼容。
--with-threads
- 作用：启用线程池支持。
- 使用场景：适用于需要高并发处理的情况。
- 示例 ：
--with-threads - 注意事项：线程池会增加内存占用。
--with-file-aio
- 作用：启用异步文件 I/O 支持。
- 使用场景：适用于需要高效处理大文件的情况。
- 示例 ：
--with-file-aio - 注意事项：异步 I/O 会增加复杂性。
--with-http_ssl_module
- 作用：启用 SSL/TLS 支持模块。
- 使用场景：适用于需要 HTTPS 支持的情况。
- 示例 ：
--with-http_ssl_module - 注意事项：确保 OpenSSL 库已安装。
--with-http_v2_module
- 作用：启用 HTTP/2 协议支持。
- 使用场景：适用于需要高性能 HTTP 服务的情况。
- 示例 ：
--with-http_v2_module - 注意事项：HTTP/2 要求 SSL/TLS 支持。
--with-http_gzip_static_module
- 作用：启用预压缩文件的处理支持。
- 使用场景：适用于需要压缩静态内容的情况。
- 示例 ：
--with-http_gzip_static_module - 注意事项：预压缩文件可以减少带宽使用。
--with-http_realip_module
- 作用：启用获取客户端真实 IP 地址的支持。
- 使用场景：适用于使用 Nginx 作为反向代理的情况。
- 示例 ：
--with-http_realip_module - 注意事项 ：确保配置文件中正确设置
real_ip_header。
--with-http_addition_module
- 作用：启用在响应中添加或修改响应头的能力。
- 使用场景：适用于需要动态修改响应头的情况。
- 示例 ：
--with-http_addition_module - 注意事项：谨慎使用，避免影响性能。
--with-http_sub_module
- 作用：启用在响应体中替换字符串的能力。
- 使用场景：适用于需要动态修改响应内容的情况。
- 示例 ：
--with-http_sub_module - 注意事项：谨慎使用，避免影响性能。
--with-http_dav_module
- 作用：启用 WebDAV 支持。
- 使用场景：适用于需要 WebDAV 功能的情况。
- 示例 ：
--with-http_dav_module - 注意事项：WebDAV 可能带来安全风险。
--with-http_flv_module
- 作用：启用 FLV 流媒体支持。
- 使用场景：适用于需要 FLV 流媒体服务的情况。
- 示例 ：
--with-http_flv_module - 注意事项：FLV 流媒体可能需要额外配置。
--with-http_mp4_module
- 作用：启用 MP4 流媒体支持。
- 使用场景：适用于需要 MP4 流媒体服务的情况。
- 示例 ：
--with-http_mp4_module - 注意事项：MP4 流媒体可能需要额外配置。
--with-http_gunzip_module
- 作用：启用解压响应的能力。
- 使用场景：适用于需要解压响应内容的情况。
- 示例 ：
--with-http_gunzip_module - 注意事项：解压操作会增加 CPU 负载。
--with-http_random_index_module
- 作用：启用随机索引页面支持。
- 使用场景：适用于需要随机索引页面的情况。
- 示例 ：
--with-http_random_index_module - 注意事项：随机索引页面可能影响用户体验。
--with-http_secure_link_module
- 作用：启用安全链接模块。
- 使用场景：适用于需要保护链接安全的情况。
- 示例 ：
--with-http_secure_link_module - 注意事项：安全链接模块需要正确配置。
--with-http_degradation_module
- 作用：启用当内存不足时降级服务的能力。
- 使用场景：适用于需要在资源紧张时保持服务的情况。
- 示例 ：
--with-http_degradation_module - 注意事项：降级服务可能影响用户体验。
--with-http_slice_module
- 作用：启用切片传输编码支持。
- 使用场景：适用于需要分段传输大文件的情况。
- 示例 ：
--with-http_slice_module - 注意事项：切片传输可能增加复杂性。
--with-http_stub_status_module
- 作用：启用状态页面支持，显示基本的性能统计信息。
- 使用场景：适用于需要监控 Nginx 性能的情况。
- 示例 ：
--with-http_stub_status_module - 注意事项：状态页面需要正确配置。
第三方模块
--add-module=path
- 作用：添加第三方模块的路径。
- 使用场景：适用于需要扩展 Nginx 功能的情况。
- 示例 ：
--add-module=/path/to/third_party_module - 注意事项：确保第三方模块与 Nginx 兼容。
其他配置
--without-http
- 作用：完全禁用 HTTP 服务器功能。
- 使用场景：适用于不需要 HTTP 服务的情况。
- 示例 ：
--without-http - 注意事项：禁用 HTTP 服务后，Nginx 将无法处理 HTTP 请求。
--without-http-cache
- 作用：禁用 HTTP 缓存。
- 使用场景：适用于不需要缓存功能的情况。
- 示例 ：
--without-http-cache - 注意事项：禁用缓存可能影响性能。
--without-mail_pop3_module
- 作用：禁用 POP3 邮件协议支持。
- 使用场景：适用于不需要 POP3 支持的情况。
- 示例 ：
--without-mail_pop3_module - 注意事项：禁用 POP3 支持后，Nginx 将无法处理 POP3 请求。
--without-mail_imap_module
- 作用：禁用 IMAP 邮件协议支持。
- 使用场景：适用于不需要 IMAP 支持的情况。
- 示例 ：
--without-mail_imap_module - 注意事项：禁用 IMAP 支持后，Nginx 将无法处理 IMAP 请求。
--without-mail_smtp_module
- 作用：禁用 SMTP 邮件协议支持。
- 使用场景：适用于不需要 SMTP 支持的情况。
- 示例 ：
--without-mail_smtp_module - 注意事项：禁用 SMTP 支持后，Nginx 将无法处理 SMTP 请求。
--without-stream
- 作用：禁用流媒体模块。
- 使用场景：适用于不需要流媒体服务的情况。
- 示例 ：
--without-stream - 注意事项：禁用流媒体模块后，Nginx 将无法处理流媒体请求。
--without-stream_limit_conn_module
- 作用：禁用流媒体连接限制模块。
- 使用场景：适用于不需要流媒体连接限制的情况。
- 示例 ：
--without-stream_limit_conn_module - 注意事项：禁用连接限制可能影响性能。
--without-stream_access_module
- 作用：禁用流媒体访问控制模块。
- 使用场景：适用于不需要流媒体访问控制的情况。
- 示例 ：
--without-stream_access_module - 注意事项：禁用访问控制可能影响安全性。
--without-stream_geo_module
- 作用：禁用流媒体地理定位模块。
- 使用场景：适用于不需要流媒体地理定位的情况。
- 示例 ：
--without-stream_geo_module - 注意事项：禁用地理定位可能影响功能。
--without-stream_map_module
- 作用：禁用流媒体变量映射模块。
- 使用场景：适用于不需要流媒体变量映射的情况。
- 示例 ：
--without-stream_map_module - 注意事项：禁用变量映射可能影响功能。
--without-stream_return_module
- 作用：禁用流媒体返回值模块。
- 使用场景：适用于不需要流媒体返回值的情况。
- 示例 ：
--without-stream_return_module - 注意事项：禁用返回值模块可能影响功能。
--without-stream_upstream_hash_module
- 作用：禁用流媒体哈希负载均衡模块。
- 使用场景：适用于不需要流媒体哈希负载均衡的情况。
- 示例 ：
--without-stream_upstream_hash_module - 注意事项：禁用哈希负载均衡可能影响性能。
--without-stream_upstream_least_conn_module
- 作用：禁用流媒体最少连接数负载均衡模块。
- 使用场景：适用于不需要流媒体最少连接数负载均衡的情况。
- 示例 ：
--without-stream_upstream_least_conn_module - 注意事项：禁用最少连接数负载均衡可能影响性能。
--without-stream_upstream_zone_hash_module
- 作用：禁用流媒体区域哈希负载均衡模块。
- 使用场景：适用于不需要流媒体区域哈希负载均衡的情况。
- 示例 ：
--without-stream_upstream_zone_hash_module - 注意事项：禁用区域哈希负载均衡可能影响性能。
--with-cc-opt=parameters
- 作用：传递额外的 C 编译器参数。
- 使用场景：适用于需要自定义编译选项的情况。
- 示例 ：
--with-cc-opt="-O2 -g" - 注意事项：确保参数有效且不会导致编译失败。
--with-ld-opt=parameters
- 作用：传递额外的链接器参数。
- 使用场景：适用于需要自定义链接选项的情况。
- 示例 ：
--with-ld-opt="-L/path/to/lib -lmylib" - 注意事项：确保参数有效且不会导致链接失败。
重点配置
--prefix=path：设置安装目录，确保路径有效且有写权限。--with-http_ssl_module：启用 SSL/TLS 支持，适用于需要 HTTPS 服务的情况。--with-http_v2_module：启用 HTTP/2 协议支持，提高性能。--with-http_gzip_static_module：启用预压缩文件的处理支持，减少带宽使用。--with-http_realip_module：启用获取客户端真实 IP 地址的支持，适用于反向代理场景。--with-http_stub_status_module：启用状态页面支持，便于监控 Nginx 性能。--with-threads：启用线程池支持，提高高并发处理能力。--with-file-aio：启用异步文件 I/O 支持，提高大文件处理效率。
使用场景与示例
假设我们需要编译一个支持 HTTPS、HTTP/2、GZIP 静态内容压缩、获取客户端真实 IP、状态页面监控、线程池和异步 I/O 的 Nginx，同时指定安装路径为 /opt/nginx，可以这样配置：
./configure --prefix=/opt/nginx \
--with-http_ssl_module \
--with-http_v2_module \
--with-http_gzip_static_module \
--with-http_realip_module \
--with-http_stub_status_module \
--with-threads \
--with-file-aio
make && make install注意事项
- OpenSSL 兼容性 ：在使用
--with-openssl=path时，请确保 OpenSSL 版本与你的 Nginx 版本兼容。 - JIT 编译 ：如果你启用了
--with-pcre-jit，请确保你的 CPU 支持 JIT 编译所需的指令集。 - 模块选择：启用过多的模块可能会增加 Nginx 的内存占用，因此只启用你需要的功能。
- 调试日志 ：在生产环境中，尽量避免使用
--with-debug，因为调试日志会占用大量磁盘空间并影响性能。 - 第三方模块：确保第三方模块与 Nginx 兼容，并且正确配置。
其余参见nginx官网