phpEnv配置站点密码访问 phpEnv Nginx auth

需手动修改phpenv的nginx站点vhost配置，添加auth_basic指令并用htpasswd生成密码文件，路径须确保nginx进程可读，配置后需nginx -t测试并reload生效。

phpenv配置站点密码访问 phpenv nginx auth_basic

phpEnv 本身不提供 auth_basic 配置界面，必须手动改 Nginx 配置文件并配合 htpasswd 生成密码文件，否则无论怎么点面板都无效。

phpEnv 默认集成的是 Nginx（不是 Apache），所以不能指望 .htaccess 生效；auth_basic 是 Nginx 原生模块 ngx_http_auth_basic_module 的指令，只在 Nginx 配置中起作用。

phpEnv 通常以普通用户（如当前登录用户）身份运行，Nginx worker 进程也需有读取权限，所以密码文件不能放在 /root 或需要 root 权限的路径下。

Nginx Hosting

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

下载

推荐路径：/home/yourname/nginx-auth/ 或 /usr/local/phpenv/nginx-auth/（确保目录存在且可读）
生成命令示例：htpasswd -c /home/yourname/nginx-auth/myapp.passwd admin（输入两次密码）
验证内容：cat /home/yourname/nginx-auth/myapp.passwd 应看到类似 admin:$apr1$...
常见错误：open() "/xxx/passwd" failed (13: Permission denied) —— 说明 Nginx 进程无权读该文件，改路径或加 chmod 644

不要改 nginx.conf 全局配置，直接编辑对应站点的 vhost 文件（如 /usr/local/phpenv/nginx/conf/vhost/www.myapp.com.conf），在 location / { ... } 块内插入两行：

auth_basic "Restricted Area";
auth_basic_user_file /home/yourname/nginx-auth/myapp.passwd;

必须放在 location / 内，或更细粒度的 location /admin/ 中才生效
如果站点用了反向代理（如 proxy_pass），auth_basic 仍有效，但认证发生在 Nginx 层，后端 PHP 不感知
避免重复写：同一个 location 块里写两遍 auth_basic 会导致 Nginx 启动失败（报 directive is duplicate）
改完务必执行：/usr/local/phpenv/nginx/sbin/nginx -t 测试语法，再 /usr/local/phpenv/nginx/sbin/nginx -s reload

HTTP Basic Auth 弹窗没出来，90% 是以下原因导致，而不是配置“没生效”：

auth_basic_user_file 路径写错，或文件实际不存在 —— 检查 Nginx error log（通常在 /usr/local/phpenv/nginx/logs/error.log），搜 auth_basic_user_file 相关报错
浏览器已缓存了上一次的 401 响应，或保存了错误凭据 —— 用隐身窗口测试，或清空浏览器 HTTP 认证缓存（Chrome 地址栏输 chrome://settings/clearBrowserData → 勾选“密码和表单数据”）
HTTPS 站点混用了 HTTP 资源（比如页面里加载了 http:// 的 JS/CSS），触发浏览器降级拦截 —— 此时可能静默失败，不弹窗也不放行

复杂点在于：auth_basic 是协议层拦截，一旦触发，请求根本不会到达 PHP；所以别在 PHP 里查日志找原因，所有线索都在 Nginx 的 access.log 和 error.log 里。