当前位置：首页 > 文章列表 > 文章 > php教程 > 宝塔面板开启MySQL8.0远程连接方法

宝塔面板开启MySQL8.0远程连接方法

2026-05-06 21:19:47 0浏览收藏

本文详细解析了在宝塔面板环境下开启MySQL 8.0远程访问的完整、可靠且避坑的操作路径：必须同步调整三大核心环节——用户权限配置（严格遵循CREATE/ALTER USER分步语法，禁用已废弃的GRANT一步授权）、认证插件切换（将默认不兼容的caching_sha2_password强制改为mysql_native_password，并注意同时更新'%'和'localhost'双host）、以及网络层放行（逐级排查云安全组、系统防火墙与MySQL绑定地址bind-address），并针对性解答Navicat连接卡顿、Python驱动报错、telnet不通、远程登录后数据库不可见等高频问题，彻底摒弃手动UPDATE user表等危险操作，为开发者提供一份精准、安全、开箱即用的MySQL 8.0远程连接实战指南。

如何在宝塔面板配置外链数据库_开启MySQL 8.0远程访问权限

MySQL 8.0 在宝塔面板默认禁止远程访问，直接填 IP 连不上是正常现象；必须同时改三处：MySQL 用户权限、认证插件、系统/云防火墙端口。

MySQL 8.0 用户权限和 host 设置不生效？检查 `GRANT` 语法是否写错

MySQL 8.0 废弃了 GRANT ... IDENTIFIED BY 一步授权密码的写法，强行用会报错 ERROR 1064。正确做法是分两步：

先执行 CREATE USER 'myuser'@'%' IDENTIFIED WITH mysql_native_password BY 'mypass';（注意指定插件）
再执行 GRANT ALL ON *.* TO 'myuser'@'%';
或者对已有用户（如 root）直接改： ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'yourpass';
最后一定补上 FLUSH PRIVILEGES;，否则修改只在内存里，重启就丢

别信网上“UPDATE user SET host='%' WHERE user='root'”这种野路子——MySQL 8.0 的 user 表结构受严格校验，手动 UPDATE 很可能被拒绝或导致后续登录失败。

Navicat 连接报 `ERROR 2059` 或卡在握手？大概率是 `caching_sha2_password` 插件问题

MySQL 8.0 默认用 caching_sha2_password，但 Navicat 15 以下、旧版 pymysql、部分 PHP PDO 驱动不支持。现象是输完密码后无响应，或直接报 Authentication plugin 'caching_sha2_password' cannot be loaded。

临时解法：进 MySQL 执行 ALTER USER 'myuser'@'%' IDENTIFIED WITH mysql_native_password BY 'mypass';
必须同步改 localhost 和 % 两个 host，否则本地命令行能登、远程连不上
Python 用户可在连接时显式指定：auth_plugin='mysql_native_password'（pymysql）或 plugin_dir 参数（mysql-connector-python）
不建议删掉 mysql_native_password 插件本身——它被系统账户依赖，删了可能导致 mysqld 启动失败

端口放行了还是连不上？查清是哪一层在拦：安全组 > 系统防火墙 > MySQL 绑定地址

宝塔面板只管自己的 8888 端口，3306 完全不管。常见拦截链是：

云厂商安全组没开 3306/TCP 入方向规则（最常漏）
服务器系统防火墙（firewalld 或 ufw）没放行，宝塔“安全 → 放行端口”只是它的界面入口，底层仍需确认实际生效
MySQL 自身没监听外网：netstat -tnlp | grep :3306 如果只看到 127.0.0.1:3306，说明 my.cnf 里还留着 bind-address = 127.0.0.1，得注释掉并重启 mysqld

测试顺序建议：先用 telnet your-server-ip 3306（客户端机器上运行），通了再试 Navicat；不通就按上面三层逐层排查。

远程能连上但 `SHOW DATABASES` 只有 `information_schema`？检查 SQL 模式和字符集

MySQL 8.0 默认 sql_mode 更严格，比如含 STRICT_TRANS_TABLES、NO_ENGINE_SUBSTITUTION，某些老应用建库时没显式指定字符集，远程连接后因默认行为差异导致库“不可见”。

连上后立刻执行 SELECT @@sql_mode; 和 SELECT @@character_set_database;，对比本地连接结果
若需兼容旧项目，可在 /www/server/mysql/etc/my.cnf 的 [mysqld] 下加一行：sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
改完必须重启 mysqld，且该设置影响全局，生产环境调整前务必验证其他业务

真正容易被忽略的是：MySQL 8.0 的 mysql.user 表里 host 字段值为 % 时，**不匹配 IPv6 的 ::1 回环地址**。如果客户端用 localhost 连，系统可能优先走 IPv6，结果匹配不到 % 而 fallback 到 127.0.0.1 或失败。测试时统一用服务器公网 IP，别用 localhost。

到这里，我们也就讲完了《宝塔面板开启MySQL8.0远程连接方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！