如何解决宝塔面板数据库无法远程连接?在安全选项中放行3306端口与授权

小涛姑娘_4273

小涛姑娘_4273

2026-05-01

893人浏览

原创

必须同步配置云安全组、系统防火墙、mysql绑定地址和用户权限四层:宝塔放行3306仅是第一步;需在云平台安全组添加tcp 3306入向规则;用firewall-cmd或ufw放行端口;修改my.cnf中bind-address为0.0.0.0并重启mysql;执行grant授权及flush privileges;mysql 8+需指定mysql_native_password插件。

如何解决宝塔面板数据库无法远程连接?在安全选项中放行3306端口与授权

宝塔面板里放行3306端口只是第一步,不是全部

只在宝塔「安全」页面添加3306端口规则,大概率连不上。宝塔自带防火墙只是其中一环,系统级防火墙(firewalld 或 ufw)和云厂商安全组是另外两道独立关卡。

实操建议:

  • 先确认宝塔防火墙已启用且 3306 规则存在:进「安全」→ 查看「系统防火墙」状态是否为「运行中」,规则列表里有 3306 且协议为 TCP
  • 再查系统防火墙:sudo firewall-cmd --state(CentOS/Rocky)或 sudo ufw status(Ubuntu/Debian),若启用,必须额外执行:sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload 或 sudo ufw allow 3306
  • 云服务器(阿里云/腾讯云等)必须去控制台「安全组」手动加一条入方向规则:协议选 TCP,端口填 3306/3306,授权对象填你客户端的公网 IP(别填 0.0.0.0/0,尤其生产环境)

改完 phpMyAdmin 里的 host 字段 ≠ 远程权限生效

在宝塔数据库页点「管理」进 phpMyAdmin,把用户「主机」从 localhost 改成 %,这只是改了界面显示值,不触发 MySQL 权限重载——实际权限没变。

真正起效的操作必须走命令行:

  • 登录 MySQL:mysql -u root -p
  • 执行授权(以用户 myuser 为例):GRANT ALL ON *.* TO 'myuser'@'%' IDENTIFIED BY 'mypass';
  • 强制刷新权限缓存:FLUSH PRIVILEGES; —— 这一步漏掉,前面全白干
  • 验证是否生效:SELECT user, host FROM mysql.user WHERE user = 'myuser';,结果中 host 列必须是 %,不是 localhost

bind-address = 127.0.0.1 是静默拦截器,根本收不到请求

即使权限开了、防火墙通了,MySQL 进程如果只绑在 127.0.0.1,它压根不会接收任何来自外部的 TCP 包。这不是报错,是直接丢弃,所以你会看到 Connection refused。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

检查并修改配置文件:

  • 配置路径通常是 /www/server/mysql/etc/my.cnf 或 /etc/my.cnf
  • 找到 bind-address 行,改成:bind-address = 0.0.0.0(监听所有 IPv4 地址)或注释掉整行(# 开头)
  • 确认没有 skip-networking 这一行,有就删掉或注释
  • 改完必须重启服务:systemctl restart mysqld(CentOS)或 systemctl restart mysql(Ubuntu/Debian)
  • 验证监听状态:netstat -tlnp | grep :3306,看到 0.0.0.0:3306 才算成功

MySQL 8+ 的 caching_sha2_password 插件会导致“密码正确却连不上”

MySQL 8.0 默认用 caching_sha2_password 认证插件,但旧版 Navicat、某些 PHP 版本、Python 的 pymysql 默认不支持,表现就是 Access denied,哪怕账号密码完全正确。

解决方法是显式指定兼容插件:

  • 创建用户时直接指定:CREATE USER 'myuser'@'%' IDENTIFIED WITH mysql_native_password BY 'mypass';
  • 或对已有用户修改:ALTER USER 'myuser'@'%' IDENTIFIED WITH mysql_native_password BY 'mypass';
  • 执行后仍需 FLUSH PRIVILEGES;
  • 如果用的是 root 用户远程连接,注意它默认是 'root'@'localhost',得先 DROP USER 'root'@'localhost'; 再重建 @'%' 版本,否则新权限不覆盖旧记录

真正的难点不在步骤多,而在于四层隔离:云安全组 → 系统防火墙 → MySQL 绑定地址 → 用户 host 权限。任意一层卡住,现象都是“连不上”,但原因完全不同。验证时别跳步,telnet your-db-ip 3306 能通,才说明前两层没问题;netstat 看到监听,才说明第三层过了;最后才是 SQL 权限和认证插件的事。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

宝塔面板

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
常用的mysql管理工具
常用的mysql管理工具

常用的mysql管理工具有:1、MySQL Workbench、phpMyAdmin、MySQL Shell、Navicat、DBeaver和DataGrip。更多关于mysql管理工具的问题,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

2023.11.03

6010

11

phpmyadmin导入sql文件失败怎么办
phpmyadmin导入sql文件失败怎么办

在phpmyadmin导入sql文件失败时,可以尝试以下解决方案:1、检查文件权限和格式;2、确保文件字符集与数据库兼容;3、确认表结构兼容;4、检查外键约束和禁用外键检查;5、增加最大上传文件大小;6、分批导入或使用命令行导入;7、联系托管提供商寻求帮助。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

3744

7

phpmyadmin怎么改成中文
phpmyadmin怎么改成中文

通过安装中文语言包、将其上传到 phpmyadmin 目录、修改配置文件和重启 phpmyadmin,可以将 phpmyadmin 的界面改为中文。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

821

5

phpmyadmin访问不了怎么回事
phpmyadmin访问不了怎么回事

phpmyadmin 无法访问可能是以下原因造成:1、服务器问题:mysql 服务未运行或防火墙阻止访问;2、配置问题:安装/配置错误、错误的配置文件设置或缺少必要的 php 扩展;3、浏览器问题:浏览器缓存、扩展干扰或浏览器不兼容;4、其他原因:dns 问题、恶意软件或网络连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

939

6

phpMyAdmin安装教程大全
phpMyAdmin安装教程大全

本专题整合了phpMyAdmin程序安装相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.31

925

23

PHPMyadmin配置
PHPMyadmin配置

本专题整合了phpmyadmin配置相关教程,阅读专题下面的文章了解更多详细步骤。

2025.12.04

549

19

XAMPP 与 phpMyAdmin 数据库管理实操
XAMPP 与 phpMyAdmin 数据库管理实操

专注于 XAMPP 内置的 phpMyAdmin 数据库管理工具,系统讲解数据库和数据表的创建与设计、SQL 语句执行、CSV/SQL 格式数据的导入导出、定时备份与一键还原、多数据库批量管理等日常操作,帮助开发者高效管理本地 MySQL 数据。

2026.04.08

355

26

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

20

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

20

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
宝塔入门指引手册
宝塔入门指引手册

共0课时 | 0人学习

宝塔官方实践教程
宝塔官方实践教程

共0课时 | 0人学习