--prefix是Nginx编译安装最核心参数，指定运行时根目录（如/opt/nginx），决定conf、logs等默认路径；必须显式设置，不可安装后修改，且需配合--conf-path等参数覆盖以符合FHS规范。

用 --prefix 参数指定安装目录前缀，这是编译 Nginx 时最基础也最关键的配置项。

一、--prefix 的作用和基本用法

--prefix 不是“把文件复制到哪”，而是定义整个安装结构的根路径。Nginx 启动后默认会从这个路径下找 conf、sbin、logs、html 等子目录。不设置时默认为 /usr/local/nginx；生产环境建议显式指定，比如：

• --prefix=/opt/nginx → 配置文件在 /opt/nginx/conf/nginx.conf
• --prefix=/usr/local/nginx-1.24.0 → 支持多版本并存，避免覆盖

注意：该路径在 configure 阶段固化，安装完成后无法通过命令行或配置文件更改，换路径必须重编译。

二、常见错误路径选择

有些路径看似合理，但实际违反 Linux 文件系统层次标准（FHS）或运行逻辑，应避免：

• 不要设 --prefix=/etc/nginx：/etc 只应存放配置，不能写入 pid、日志等运行时文件
• 不要设 --prefix=/var/nginx：虽然 /var 存运行数据，但 Nginx 默认会在 prefix 下建 logs 目录，导致日志路径变成 /var/nginx/logs，而非标准的 /var/log/nginx

若需日志、pid、锁文件等落进标准位置，应单独用对应参数覆盖，而不是靠 prefix 推导。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

三、配合其他路径参数灵活布局

仅靠 --prefix 往往不够，通常要叠加指定关键路径，确保各组件按规范分离：

• --conf-path=/etc/nginx/nginx.conf：让配置集中管理，启动时只认这个路径
• --error-log-path=/var/log/nginx/error.log 和 --http-log-path=/var/log/nginx/access.log
• --pid-path=/var/run/nginx.pid、--lock-path=/var/run/nginx.lock
• --sbin-path=/usr/sbin/nginx：方便全局调用，无需加路径

⚠️ 一旦显式设置了 --conf-path，Nginx 就不再从 --prefix/conf 下加载配置，哪怕该目录存在也不会被读取。

四、验证是否生效

安装完成后，用以下命令确认路径是否按预期设置：

• nginx -V 2>&1 | grep "configure arguments"：查看原始 configure 命令，确认 --prefix 和其他路径参数是否写入
• nginx -t：检查配置语法，同时隐式验证 conf-path 是否可读
• nginx -p /xxx：临时指定 prefix 启动（仅测试用），但不能绕过编译时固定的 conf-path 等显式路径