MySQL的'192.168.1.%'是字符串前缀匹配而非子网匹配,仅当客户端host声明或DNS解析结果以该字符串开头时才生效;它不解析IP结构,无法精确控制/24网段,且易受DNS反解、代理透传、权限语句host不一致等因素干扰。

MySQL的'192.168.1.%'不是子网匹配,而是字符串前缀匹配
写'192.168.1.%'看起来像在授权/24网段,但MySQL根本不解析IP结构——它只做字符串比对。只要客户端发起连接时声明的host字段(或反解出的主机名)以'192.168.1.'开头,就匹配成功。这意味着:'192.168.1.100abc'、'192.168.1.'(末尾带点)、甚至DNS返回的'db-server-192.168.1.5.internal'都可能被放行。反过来,'192.168.10.5'不匹配,因为'10'≠'1';'192.168.1.255'能匹配,但'192.168.1.2550'也能(%匹配任意长度),这不是网段控制,是字符串通配失控。
skip_name_resolve=OFF时,IP会被强行反向DNS解析,导致匹配失败
默认情况下MySQL会把客户端IP做反向DNS查询(比如把192.168.1.10查成app01.internal),再正向查一次确认一致性。如果失败,连接直接拒绝——哪怕你授权的是'192.168.1.%'。此时SHOW VARIABLES LIKE 'skip_name_resolve';返回OFF,就是隐患源头。解决方法很简单:
- 在
[mysqld]段配置文件中添加skip_name_resolve = ON - 重启MySQL(
systemctl restart mysql) - 验证:执行
SELECT User, Host FROM mysql.user WHERE User = 'xxx';,确认登录时用的IP确实落在你写的Host字符串范围内
GRANT和CREATE USER的host值必须完全一致,否则权限挂在错误记录上
这是最隐蔽也最高频的失效原因。例如你运行了:
CREATE USER 'api'@'192.168.1.%' IDENTIFIED BY 'pwd'; GRANT SELECT ON mydb.* TO 'api';
第二句没写@'192.168.1.%',MySQL就默认当成'api'@'%'去授权——结果权限加到了一条根本不存在或不用于该场景的记录上。后续从192.168.1.50连进来,查的是'api'@'192.168.1.%'这条,发现空权限。务必做到:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
CREATE USER和GRANT语句中的host部分字符级一致(包括引号、大小写、点号位置) - 执行完立刻
FLUSH PRIVILEGES;,否则内存权限缓存不更新 - 用
SELECT User, Host FROM mysql.user WHERE User = 'api';确认目标记录真实存在
云环境或NAT后,客户端真实IP被代理覆盖,host匹配对象错位
如果你在Nginx、HAProxy或云LB后面跑MySQL,且代理没透传真实源IP(比如没配proxy_protocol或X-Real-IP),MySQL看到的永远是代理机器的IP(如127.0.0.1或10.0.10.20)。这时无论你怎么写'192.168.1.%'都没用——它匹配的是代理IP,不是用户真实出口IP。验证方式:
- 在MySQL里执行
SELECT SUBSTRING_INDEX(USER(), '@', -1);,看返回的是什么host - 如果返回
127.0.0.1或内网地址,说明流量经过了未透传IP的中间层 - 解决方案不在MySQL侧:要么改代理配置透传IP,要么在代理后加一层TCP层IP白名单(如iptables),MySQL账号改用
'api'@'10.0.10.%'这类代理网段
真正要靠MySQL原生机制做网段控制,'192.168.1.%'是唯一可行写法,但它本质是字符串前缀,不是子网逻辑——所有“失效”,几乎都源于对这个前提的误判。










