phpEnv Nginx配置反向代理 phpEnv高级站点设置-php教程-PHP中文网

phpenv中nginx反向代理需配置vhost\your-site-name.user.conf文件，通过「高级设置」开启自定义配置开关后生效；proxy_pass末尾斜杠必须与后端路径语义对齐，且需添加websocket支持头及确保编码无bom、权限正确、开关全开。

phpenv nginx配置反向代理 phpenv高级站点设置

phpEnv 内置的 Nginx 不支持直接在图形界面里配反向代理，必须手动改配置文件；否则点“启动服务”后 proxy_pass 会被忽略，请求全 404 或 502。

phpEnv 的 Nginx 配置文件在哪

Windows 上 phpEnv 的 Nginx 配置文件路径固定为：phpEnv\nginx\conf\vhost\your-site-name.conf（不是 nginx.conf 主文件）。这个文件由 phpEnv 界面操作自动生成，每次你“新增站点”或“编辑站点”时都会覆盖重写——所以别直接改它，得用 phpEnv 提供的「高级设置」入口切入。

实际操作路径是：开始 → 软件设置 → 高级设置 → 打开「自定义 Nginx 配置」开关。开启后，phpEnv 会在站点配置目录下生成一个 vhost\your-site-name.user.conf 文件，这个文件不会被覆盖，专门用来加 location、proxy_pass 等自定义规则。

常见错误现象：502 Bad Gateway 或 404 Not Found，但后端服务明明在跑（比如 http://127.0.0.1:8000 curl 通），说明 Nginx 没转发过去，大概率是配置没落进生效的 conf 文件里。

proxy_pass 末尾斜杠必须和后端路径语义对齐

phpEnv 默认站点走的是 PHP-FPM（fastcgi），而反向代理要切到 HTTP 后端，proxy_pass 的结尾斜杠决定路径重写行为，这点极易出错。

后端地址是 http://127.0.0.1:3000/api，你想用 /api/ 访问 → proxy_pass http://127.0.0.1:3000/api/;（末尾带 /）
后端地址是 http://127.0.0.1:3000，根路径即 API 入口 → proxy_pass http://127.0.0.1:3000/;（末尾带 /，否则 /api/user 会变成 /api/user 原样发给后端）
千万别写成 proxy_pass http://127.0.0.1:3000;（末尾无 /），这会导致路径拼接错误，比如访问 /api/v1/users，实际发给后端的是 /api/v1/users，而不是你期望的 /v1/users

必须显式启用 WebSocket 和长连接支持

如果你代理的是 Vue Dev Server、Vite、或者任何带热更新/实时通信的前端服务，不加这两行，Upgrade 请求会被丢弃，控制台报 WebSocket connection to 'ws://...' failed。

Nginx Hosting

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

下载

在 vhost\your-site-name.user.conf 的 location 块里补上：

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

同时确保主配置中没有全局 proxy_buffering on;（phpEnv 默认关着，但若你动过 nginx.conf，需检查）。缓冲开启会导致 SSE、流式响应卡住，表现是接口一直 pending。

phpEnv 重启后 Nginx 不加载 user.conf 的原因

phpEnv 的“重启服务”按钮只 reload 主进程，但有时 .user.conf 文件权限不对、或文件编码含 BOM、或路径里有中文空格，会导致 Nginx 解析失败且静默跳过——nginx -t 不报错，但日志里会出现 no such file or directory 或 invalid number of arguments。

排查步骤：

打开命令行，cd 到 phpEnv\nginx\ 目录，执行：nginx -t -c conf/nginx.conf，看是否提示 .user.conf 加载异常
用记事本另存为 UTF-8 无 BOM 编码（推荐 VS Code 打开后右下角切换编码再保存）
确认 .user.conf 文件名和站点名完全一致，且扩展名是 .conf，不是 .conf.txt
修改后必须点 phpEnv 界面的「重启服务」，不能只点「重载配置」——后者不触发 vhost 重解析

最常被忽略的一点：phpEnv 的「高级设置」里有两个开关，「自动写入 hosts」和「自动重启服务」，必须都打开；否则改完 .user.conf 后，Nginx 进程根本没读新配置。