phpEnv不提供图形化IP控制界面，黑白名单须手动修改Nginx（allow/deny）或Apache（.htaccess+Require）配置文件，且需确认服务器类型、HTTPS单独配置、代理环境下修正真实IP获取。
phpEnv 本身不提供图形化 IP 访问控制界面，所有黑白名单必须通过直接修改 Nginx 或 Apache 的站点配置文件实现 —— 这和宝塔、LNMP 等环境逻辑一致，但 phpEnv 默认不封装这些功能，需手动操作。
确认 Web 服务器类型再动手
phpEnv 支持切换 Nginx 和 Apache，黑白名单写法完全不同，不能混用：
- 运行
phpenv list或查看 phpEnv 控制台顶部状态栏，确认当前启用的是nginx还是apache - Nginx 模式下：黑白名单只能写在
server块或location块内，用allow/deny指令 - Apache 模式下：必须用
.htaccess（需确保AllowOverride All已启用），规则为Require ip 192.168.1.100或Require not ip 203.0.113.5 - 切勿在 Nginx 配置里写 Apache 语法，或反过来；否则重载会失败，
nginx -t报错提示类似unknown directive "Require"
nginx 模式：在 phpEnv 站点配置中加 allow/deny
phpEnv 的 Nginx 配置文件路径通常为：/phpenv/nginx/vhost/your-site.conf（Windows 下是 C:\phpEnv\nginx\vhost\your-site.conf）
- 编辑该文件，在
server { ... }块内、任意location外的位置插入规则（推荐放在root指令下方） - 白名单示例（仅允许两个 IP，其余全拒）：
allow 127.0.0.1;<br>allow 203.0.113.25;<br>deny all;
- 黑名单示例（禁止特定 IP，其余放行）：
deny 192.168.100.50;<br>deny 203.0.113.0/24;
- 改完后必须执行
phpenv nginx reload（Windows 下点 phpEnv 控制台的「重载 Nginx」按钮），否则不生效 - 注意：HTTPS 站点要单独在
listen 443 ssl对应的server块里重复写一遍，HTTP 和 HTTPS 是两个独立上下文
apache 模式：用 .htaccess 实现，但需先检查 AllowOverride
phpEnv 的 Apache 配置默认可能禁用 .htaccess 覆盖，必须先确认：
立即学习“PHP免费学习笔记（深入）”；
- 打开
/phpenv/apache/conf/extra/httpd-vhosts.conf，找到对应站点的<Directory>块 - 确保里面有
AllowOverride All（不是None），否则.htaccess规则完全被忽略 - 在站点根目录（如
/phpenv/www/your-site/）新建或编辑.htaccess文件 - 白名单写法：
Require ip 127.0.0.1<br>Require ip 192.168.5.0/24
- 黑名单写法：
Require all granted<br>Require not ip 203.0.113.100
- 保存后执行
phpenv apache restart（Windows 下点「重启 Apache」）
真实 IP 获取失效？你大概率被代理了
如果规则写了却总不生效（比如本地测试显示拒绝，但实际从公司网络访问却被放行），极可能是 phpEnv 前面套了反向代理、NAT 或开发工具（如 Charles、Fiddler），导致 $remote_addr 或 $_SERVER['REMOTE_ADDR'] 变成代理 IP：
- Nginx 下：检查是否用了
proxy_pass，若有，必须配set_real_ip_from+real_ip_header X-Forwarded-For，否则allow/deny判的是代理地址 - PHP 层判断时：不要只读
$_SERVER['REMOTE_ADDR']，应优先用$_SERVER['HTTP_X_FORWARDED_FOR']或$_SERVER['HTTP_X_REAL_IP']（需代理明确设置了这些头） - 简单验证方式：在 PHP 文件里输出
print_r($_SERVER);，看哪些HTTP_*头存在且值合理
规则越靠近请求入口（Nginx 层）越可靠，PHP 层校验只是兜底；但只要代理链没正确透传真实 IP，两者都会误判。
