Nginx源码编译需按需定制模块、路径与安全参数：一启用HTTP/SSL模块并禁用冗余功能；二指定OpenSSL路径及TLS1.3/弱加密套件控制；三通过--add-module集成第三方模块并注意版本兼容性；四重定义配置与日志路径，启用线程池与AIO；五添加栈保护、禁用危险调用及调试符号。
如果您需要根据实际需求定制Nginx功能，例如启用特定HTTP处理能力或集成SSL/TLS支持，则必须在源码编译阶段精确指定模块开关与依赖路径。以下是针对HTTP核心行为与SSL协议栈的编译参数配置说明：
一、启用基础HTTP模块控制
Nginx默认不启用全部HTTP功能模块，需通过--with-http_*系列参数显式开启。禁用则使用--without-http_*，避免引入冗余代码。
1、添加标准HTTP功能：使用--with-http_ssl_module启用HTTPS支持，--with-http_v2_module启用HTTP/2协议栈。
2、启用静态资源服务：添加--with-http_realip_module用于获取真实客户端IP，--with-http_gzip_static_module支持预压缩文件直接响应。
3、禁用默认启用但非必需的模块：如无需WebDAV功能，添加--without-http_dav_module；若不使用SSI（服务器端包含），加入--without-http_ssi_module。
二、SSL/TLS模块深度定制
SSL模块依赖外部密码库，其编译行为直接受OpenSSL或BoringSSL版本及路径影响。参数不仅决定是否启用，还控制底层加密实现细节。
1、指定OpenSSL安装路径：使用--with-openssl=/path/to/openssl-source指向源码目录，使Nginx静态链接该版本。
2、启用TLS 1.3支持：确保OpenSSL版本≥1.1.1，并添加--with-openssl-opt="enable-tls1_3"传递编译选项。
3、禁用弱加密套件：通过--with-openssl-opt="no-des no-rc4 no-ssl3"在构建时排除已淘汰算法，此操作将彻底移除对应密码套件的编译定义。
三、第三方HTTP模块集成方法
官方未内置的扩展功能（如Lua脚本支持、WAF规则引擎）需通过--add-module引入独立源码目录，且依赖关系须提前满足。
1、集成lua-nginx-module：下载模块源码后，在configure命令中追加--add-module=/path/to/lua-nginx-module。
2、绑定OpenResty生态组件：若同时使用echo-nginx-module与headers-more-nginx-module，需按顺序列出所有--add-module参数，模块声明顺序影响运行时加载优先级。
3、验证第三方模块兼容性：检查模块文档中标注的Nginx版本范围，使用不匹配的主版本号可能导致configure阶段报错或运行时段错误。
四、路径与运行时行为定制
编译参数可覆盖默认文件系统布局与进程模型，直接影响部署后的配置结构与资源占用特征。
1、重定义配置文件位置：使用--conf-path=/etc/nginx/nginx.conf指定主配置路径，避免与系统包管理器冲突。
2、分离日志存储路径：通过--error-log-path=/var/log/nginx/error.log和--http-log-path=/var/log/nginx/access.log将日志定向至独立分区。
3、限制工作进程模型：添加--with-threads启用线程池支持，配合--with-file-aio激活异步I/O，二者需同时启用才能触发AIO在线程池中调度执行。
五、调试与安全加固参数
生产环境编译需平衡性能与可观测性，部分参数仅在调试阶段启用，而另一些则直接增强运行时防护能力。
1、开启地址随机化支持：添加--with-cc-opt="-fPIE -fstack-protector-strong"启用编译期栈保护机制。
2、禁用危险系统调用：通过--with-cc-opt="-DNGX_HAVE_CAPABILITY=0"关闭Linux capabilities检测逻辑，防止因内核权限模型变更引发初始化失败。
3、嵌入调试符号：在开发验证阶段使用--with-debug参数，生成带完整调试信息的二进制文件，该选项会显著增大二进制体积且降低运行效率，严禁用于生产部署。
