必须同时修改MySQL监听地址、用户host字段和防火墙规则,缺一不可;需将bind-address设为内网IP(如192.168.1.10)、创建'user'@'192.168.1.%'用户并授权、防火墙精确放行该网段3306端口。

必须同时改三处:MySQL监听地址、用户host字段、防火墙规则,缺一不可。只改用户权限或只开防火墙,连接仍会失败——常见错误是以为ERROR 1130只是权限问题,实际可能是网络层或认证插件不匹配。
修改 bind-address 允许内网网卡监听
MySQL默认bind-address = 127.0.0.1,远程请求根本到不了服务进程。必须改成服务器实际内网IP(推荐)或0.0.0.0:
- 查服务器内网IP:
ip -4 addr show | grep inet,找到类似192.168.1.10的地址 - 编辑配置文件(常见路径:
/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/my.cnf) - 在
[mysqld]下设置:bind-address = 192.168.1.10(比0.0.0.0更安全) - 确认
skip-networking被注释或删除 - 重启服务:
sudo systemctl restart mysql
创建用户时必须显式指定 'user'@'192.168.1.%'
MySQL账号是'user'@'host'组合,host不匹配就直接拒绝,不会 fallback。用%或漏写引号都会出错:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 错误写法:
CREATE USER 'app' IDENTIFIED BY 'pwd';→ 默认建的是'app'@'%' - 正确写法:
CREATE USER 'app'@'192.168.1.%' IDENTIFIED BY 'StrongPass!2026';(注意单引号和%) - 授权必须完全一致:
GRANT SELECT, INSERT ON app_db.* TO 'app'@'192.168.1.%'; - 验证:
SELECT Host, User FROM mysql.user WHERE User = 'app';——Host列必须是192.168.1.% - 执行
FLUSH PRIVILEGES;(MySQL 8.0+多数情况可省,但建议保留)
防火墙规则要精确匹配 IP 段,不能只开端口
即使MySQL配置全对,Linux防火墙或云平台安全组也会拦截。开放3306端口 ≠ 允许所有来源访问:
- Ubuntu/Debian(ufw):
sudo ufw allow from 192.168.1.0/24 to any port 3306 - CentOS/RHEL(firewalld):
sudo firewall-cmd --add-rich-rule='rule family="ipv4" source address="192.168.1.0/24" port port="3306" protocol="tcp" accept' --permanent - 阿里云/腾讯云:安全组入方向规则,源 CIDR 填
192.168.1.0/24,协议端口填TCP:3306 - 切勿用
ufw allow 3306或0.0.0.0/0,违背“指定IP段”初衷
最容易被忽略的是NAT环境下的真实客户端IP:如果客户端经过多层内网转发,192.168.1.%可能匹配不到实际出口IP,此时需确认中间设备是否做了SNAT,或改用更宽泛的网段(如192.168.%)并收紧防火墙粒度。










