MySQL 允许外部连接访问的设置与排错指南

问题现象与排查原理

在进行远程数据库连接时，常见的报错代码为 1130（Host 'xxx.xxx.xxx.xxx' is not allowed to connect to this MySQL server）。这通常意味着 MySQL 的用户表中，当前用户的 host 字段未被设置为允许该 IP 或所有 IP 访问。默认情况下，许多安装将 root 用户限制为仅允许本地访问。'%' 在 MySQL 中代表任意主机。

准备工作与环境登录

第 1 步：连接到 MySQL 服务器并进入 mysql 库

目的：获取数据库内部的最高操作权限，以便修改用户配置信息。

操作方法：

1. 打开命令行终端，使用以下命令登录 root 用户：

mysql -u root -p

图注：输入密码后成功进入命令行界面。

2. 切换至系统自带的权限控制数据库 mysql：

use mysql;

图注：进入 mysql 数据库。

3. 查看当前状态（可选但推荐），查询现有的用户及对应的可访问主机：

select Host, User from user;

图注：检查现有用户配置，观察 root 用户当前的 host 是否受限。

方法一：使用授权语句配置权限（推荐）

目的：不直接触及底层结构，而是通过标准的 SQL 授权机制开放访问权限。这种方法更安全且不易出错。

操作入口：在已登录的 mysql> 提示符下执行。

具体步骤与参数：

若要让 任意 IP 都能以 root 身份连接（测试环境可用，生产环境建议指定 IP）：

grant all privileges on *.* to root@'%' identified by '你的密码' with grant option;

图注：授权 root 用户可从任何主机连接。

若需要指定具体的 IP 地址进行连接（安全策略更高）：

grant all privileges on *.* to root@'192.168.1.100' identified by '你的密码' with grant option;

图注：将 % 替换为实际的外部客户端 IP 地址。

注意：部分版本的 MySQL 在使用 IDENTIFIED BY 时会更新密码。如果只想改权限不改密码，或者密码已经存在，可能需要先确认账户是否存在。

方法二：修改 user 表中的 Host 字段

目的：直接将当前用户的允许访问地址修改为全局允许。

风险提示：这是直接操作系统表的底层行为。在 MySQL 8.0 及更新版本中，用户信息存储在 mysql.user 或其他视图中，语法可能有所不同。在执行前务必备份数据库。

具体动作：

执行以下更新语句，将所有名为 root 的用户的主机匹配规则修改为通配符 %：

update user set Host='%' where User='root';

图注：更新 user 表，将特定主机的 root 改为通配符。

第三步：刷新权限使配置生效

目的：MySQL 的权限变更默认会实时写入缓存，但为了确保刚才的操作立即生效且不依赖于重启服务，必须手动触发权限重载。

入口与动作：

无论采用上述哪种方法，最后都必须运行以下命令：

flush privileges;

图注：刷新权限缓存。

完成判断与验证

1. **本地验证**：退出 MySQL，再次尝试登录，或使用 Navicat、DBeaver 等可视化工具尝试连接远程 IP。

2. **成功标志**：如果工具显示连接成功，且能正常列出数据库文件，即表示外部访问设置完成。

3. **失败排查**：如果遇到 1130 报错，检查防火墙是否放行了 3306 端口，并确认执行的 SQL 语句是否正确。

图注：错误 1130 报错示例（连接被拒绝时的截图参考）。

图注：配置成功后成功连接的界面展示。

图注：如果在 Navicat 等图形化工具中操作，可直接在数据库中执行上述 Grant 和 Flush 语句。

以上就是如何设置 MySQL 允许外部连接访问的详细内容，更多关于 MySQL 权限管理与远程配置的资料请关注本站其它相关文章！