完美使用宝塔面板的phpmyadmin管理docker数据库的方法

引言

好久没有更新文章了，今天来更新一篇吧。

最近通过宝塔面板的docker部署了SurverKing（卷王问卷考试）系统的开源版，部署SurverKing时，我选用用的是MySQL8.0版本容器的数据库，端口映射为 15806->3306。

一、在宝塔面板安装phpmyadmin

1.登录宝塔面板，左侧菜单点击「软件商店」；

2.在搜索框输入「phpMyAdmin」，找到官方版本（如phpMyAdmin 5.2），点击「安装」；

3.安装完成后，点击「设置」→ 选择「通过面板访问」（安全优先，需登录宝塔后才能进入 phpMyAdmin）。

二、修改 phpMyAdmin 配置文件

通过修改配置，让 phpMyAdmin 支持切换到 Docker MySQL：

1.宝塔左侧菜单点击「文件」，进入路径：/www/server/phpmyadmin（phpMyAdmin 安装目录）；

2.在右上角搜索框中输入config.inc.php，勾选包含子目录，点击搜索。找到文件 config.inc.php，点击“编辑”或右键单击选择“编辑”；

3.在文件中找到默认本地 MySQL 的配置段（通常是以下代码）：

$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['host'] = 'localhost';
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = false;

4.在这段代码下方，新增 Docker MySQL 的服务器配置（直接复制以下代码粘贴，根据你的实际映射端口修改端口号）：

// 新增：Docker MySQL（端口13306）
$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['host'] = '127.0.0.1';  // 服务器内部地址（Docker与phpMyAdmin同服务器）
$cfg['Servers'][$i]['port'] = '15806';      // Docker映射的宿主机端口
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = false;

5.点击「保存」，关闭文件编辑页面。

三、通过宝塔面板访问 phpMyAdmin 并切换到 Docker MySQL

1.回到宝塔面板，左侧菜单点击「数据库」→ 找到「phpMyAdmin」入口，点击进入；

2.在 phpMyAdmin 登录页，找到「服务器」下拉菜单，选择 127.0.0.1:15806（即我们新增的 Docker MySQL）；

3.输入登录信息：（若忘记管理员账号密码，请看文末）

用户名：root（Docker MySQL 的管理员账号）

密码：你的 Docker MySQL root密码

4.点击「登录」，即可进入 Docker MySQL 的管理界面，左侧会显示所有数据库。

四、常见问题排查

1.连接失败？

• 检查 Docker 容器mysql是否处于「运行中」；
• 确认端口映射是15806->3306（在宝塔「容器编排」页面查看）；
• 宝塔安全组无需额外开放 15806（属于服务器内部连接）。

2.忘记密码？

进入宝塔面板，点击左侧的docker，选择“容器编排”，点击容器surveyking中，可以看到应用用户的用户名和密码；点击容器mysql可以看到管理用户密码，管理用户名一般为root或者同数据库名。