--prefix 是编译 Nginx 最核心参数，指定根安装路径（如 /opt/nginx），决定 conf、sbin、logs、html 等子目录默认位置；显式设置 --conf-path 等参数可覆盖对应路径，且启动时仅认该路径；安装前须确保依赖和权限正确。
在不同 Linux 发行版上编译 Nginx 源码，核心不是改参数本身，而是让参数与系统实际的依赖路径、用户权限模型和默认服务约定保持一致。同一套 ./configure 命令，在 Ubuntu 和 CentOS 上可能一个成功、一个报错，问题往往出在底层库位置或命名差异，而非 Nginx 配置逻辑。
依赖库名称与安装命令要按发行版区分
PCRE、zlib、OpenSSL 这三类库在编译时必须存在，但包名和安装方式不同：
-
Ubuntu/Debian：用
apt install libpcre3-dev zlib1g-dev libssl-dev；libpcre3-dev提供头文件和静态链接支持，缺它会报the HTTP rewrite module requires the PCRE library -
CentOS/RHEL 8+：用
dnf groupinstall "Development Tools" && dnf install pcre-devel zlib-devel openssl-devel；注意pcre-devel不是pcre，后者只含运行时库，不满足编译需要 -
Alpine（Docker 场景）：用
apk add pcre-dev pcre-static zlib-dev zlib-static openssl-dev openssl-libs-static；加-static是为后续做全静态链接打基础
用户、路径与 systemd 兼容性需对齐发行版习惯
编译参数中涉及运行身份和文件路径的部分，要匹配系统默认约定，否则启动失败或日志写不进指定位置：
- 用户设置：
--user=www-data --group=www-data适配 Debian/Ubuntu；--user=nginx --group=nginx适配 RHEL/CentOS；若用--user=nobody，多数发行版都认，但权限太宽，不推荐用于生产 - 日志与 PID 路径：
--error-log-path=/var/log/nginx/error.log和--pid-path=/var/run/nginx.pid在所有主流发行版中都有效，且与 systemd 的StandardError=journal或日志轮转工具兼容 - 避免硬编码
/usr/sbin类路径：比如--sbin-path=/usr/sbin/nginx在某些发行版（如 openEuler）可能被 SELinux 或策略限制写入，建议保留默认--prefix=/usr/local/nginx，再通过软链或 systemdExecStart显式调用
模块启用要检查 OpenSSL 版本与系统能力
HTTP/2、TLS 1.3、ALPN 等特性是否可用，取决于系统 OpenSSL 是否达标，不能只看 configure 参数是否写上：
-
--with-http_v2_module在 CentOS 7（OpenSSL 1.0.2k）上可启用，但不支持 TLS 1.3；在 Ubuntu 22.04+（OpenSSL 3.0+）上才能完整支持 ALPN 协商 - 若系统 OpenSSL 太旧（如 CentOS 7 默认版本），又必须用新特性，不要全局升级 OpenSSL（易崩系统），改用
--with-openssl=/path/to/openssl-3.2.1指向自编译 OpenSSL 源码目录，configure 会自动静态链接 -
--with-http_ssl_module必须和libssl-dev或openssl-devel同时存在，否则 configure 会静默跳过，导致配置里写ssl on启动时报unknown directive "ssl"
动态模块路径与加载方式需匹配发行版 init 体系
添加第三方模块（如 geoip2、sticky）后，模块文件位置和 nginx.conf 中的加载写法，受发行版默认布局影响：
- 编译时用
--add-dynamic-module=/path/to/module，生成的.so文件默认放在$prefix/modules/下；但 Ubuntu 的 systemd service 文件常设WorkingDirectory=/var/www，若没配绝对路径，load_module modules/ngx_http_geoip2_module.so可能找不到 - RHEL/CentOS 的
/usr/lib64/nginx/modules是传统模块存放点，若想复用，可在 configure 时加--modules-path=/usr/lib64/nginx/modules，再配合load_module /usr/lib64/nginx/modules/xxx.so - Alpine 构建的静态二进制不依赖系统模块路径，适合打包分发，但无法热加载动态模块——这是取舍，不是 bug
