PHPEnv配置MySQL白名单步骤详解

本文深入解析了在 phpEnv 环境下为 MySQL 实现真正可控的 IP 白名单访问的完整路径：明确指出 phpEnv 本身不参与访问控制，MySQL 的“白名单”本质是通过 `CREATE USER 'user'@'host'` 中的 host 字段精确限定来源 IP（如 `'app'@'192.168.1.100'`），需配合修改 `my.ini` 中 `bind_address = 0.0.0.0` 以启用外部监听，并严格配置 Windows 防火墙仅放行指定 IP 的 3306 端口——三者缺一不可；同时特别提醒，该方案仅适用于本地部署的 phpEnv 内置 MySQL，面对阿里云 RDS 等云数据库时，必须转向云平台的安全组或控制台白名单配置，切勿混淆本地与云端截然不同的权限模型。

phpEnv 本身不提供 MySQL 白名单配置能力——它只是 Windows 下的本地 PHP + MySQL + Apache 集成环境，MySQL 的访问控制仍完全由其自身机制决定，和 phpEnv 无关。

CREATE USER 的 host 字段就是白名单

MySQL 没有独立的“白名单开关”，所谓白名单，就是创建用户时指定的 host 值。你在 phpEnv 自带的 MySQL（通常是 5.7 或 8.0）里执行：

CREATE USER 'app'@'192.168.1.100' IDENTIFIED BY 'pwd';

就等于声明：这个账号只接受来自 192.168.1.100 的 TCP 连接。其他 IP 即使密码正确，也会在认证前被拒绝。

• 'app'@'localhost' 只能通过本机 socket 连接，和 127.0.0.1 是两个不同 host 条目
• 'app'@'192.168.1.%' 看似像 CIDR，但 MySQL 不解析子网，它只是字面匹配 DNS 名称——对 IP 地址无效，实际等同于拒绝所有 IP
• 想放开整个内网段，必须用防火墙（如 Windows Defender 防火墙规则）或改 bind_address 配合系统级限制

phpEnv 中 MySQL 的 bind_address 影响监听范围

phpEnv 安装后，MySQL 配置文件通常在 phpEnv\mysql\my.ini。检查 [mysqld] 段里的 bind_address：

• 默认可能是 127.0.0.1，只监听本地回环，外部机器根本连不上 3306 端口
• 改成 0.0.0.0 后，MySQL 会监听所有接口，此时才轮到 host 字段起作用
• 改完必须重启 phpEnv 的 MySQL 服务（不是 Apache），否则不生效

注意：bind_address = 0.0.0.0 不等于开放给所有人——它只是让 MySQL 接收连接请求，后续是否放行，仍取决于用户 host 和系统防火墙。

Windows 防火墙是最后一道防线

即使 MySQL 用户设对了 host，且 bind_address 放开了，Windows 防火墙也可能拦截入站 3306 请求。

• 打开「高级安全 Windows 防火墙」→「入站规则」→ 新建规则 → 端口 → TCP 3306 → 仅允许特定 IP（如 192.168.1.100）
• 不要依赖“仅限私有网络”这类模糊设置，它不等价于 IP 白名单
• 测试时用 telnet 192.168.1.10 3306（从客户端机器执行），能通说明网络层已放行；如果 telnet 不通但 mysql -h 192.168.1.10 -u app -p 报 Host 'x.x.x.x' is not allowed to connect，才是 MySQL 层的 host 拒绝

云服务或远程场景下，phpEnv 的配置不适用

如果你试图用 phpEnv 连接阿里云 RDS、腾讯云 CDB 等托管数据库，它的 my.ini 修改完全无效——这些服务的白名单由控制台「安全组」或「IP 白名单」单独管理，MySQL 实例根本不允许你登录修改 mysql.user 表。

此时你要做的是：登录云厂商控制台，把你的公网 IP（不是 192.168.x.x）加进白名单，并确保连接时用的是云服务提供的外网地址（如 xxx.mysql.rds.aliyuncs.com），而不是 localhost。

容易被忽略的一点：phpEnv 自带的 MySQL 默认没开远程访问，而云数据库默认不开本地 socket 访问——两边的信任模型是反着的，不能套用同一套配置逻辑。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~