怎样在宝塔面板的phpMyAdmin中扩展添加外部远程服务器？-phpMyAdmin-PHP中文网

宝塔面板phpMyAdmin默认禁用多服务器支持，无“新增服务器”按钮；需手动追加服务器配置并执行chattr +i锁定config.inc.php文件以防覆盖。

怎样在宝塔面板的phpmyadmin中扩展添加外部远程服务器？

宝塔面板的 phpMyAdmin 默认只允许管理本机 MySQL，无法直接添加外部远程服务器——这是由宝塔对 phpMyAdmin 的硬性限制决定的，不是配置没调好。

为什么 phpMyAdmin 界面里没有“新增服务器”按钮？

宝塔在安装 phpMyAdmin 时会自动修改 config.inc.php，禁用多服务器支持：

删掉了 $cfg['Servers'][$i]['host'] 的手动输入逻辑
强制设置 $cfg['AllowArbitraryServer'] = false
隐藏了顶部“服务器”下拉菜单和“+ 新建”入口

即使你手动改回 true，宝塔后续更新或重启面板服务时大概率会覆盖还原。

绕过限制的唯一可行方式：手动编辑 config.inc.php 并锁定文件

必须同时满足两个条件才能稳定生效：

在 /www/server/phpmyadmin/版本号/config.inc.php 末尾追加一个新服务器配置块（注意 $i 自增）
用 chattr +i 锁定该文件，防止宝塔自动重写

示例追加内容（替换为你的远程地址）：

btpanel phpsite 宝塔面板PHP网站

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

下载

$i++;
$cfg['Servers'][$i]['host'] = '192.168.10.100';
$cfg['Servers'][$i]['port'] = '3306';
$cfg['Servers'][$i]['verbose'] = '生产库-MySQL8';
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['ssl'] = false;

执行锁定命令：chattr +i /www/server/phpmyadmin/*/config.inc.php（通配符匹配实际版本目录）

连接失败的常见原因和验证步骤

即使配置正确，仍可能因以下问题无法登录：

远程 MySQL 未开启远程访问：GRANT ALL ON *.* TO 'user'@'%' IDENTIFIED BY 'pwd'; FLUSH PRIVILEGES;
远程服务器防火墙（如 ufw 或云厂商安全组）未放行 3306 端口
MySQL 8 默认使用 caching_sha2_password 插件，phpMyAdmin 4.x/5.x 不兼容，需改用 mysql_native_password
宝塔所在服务器 DNS 解析不到远程主机名（建议始终用 IP）

调试时先在宝塔服务器上执行：mysql -h 192.168.10.100 -u user -p，能连通再进 phpMyAdmin。

最易被忽略的是 chattr +i 这一步——不锁文件，下次宝塔更新 phpMyAdmin 或重启面板，配置就清空了。另外，MySQL 8 的认证插件问题在报错信息里不明显，错误显示常为“#1045 Cannot log in to the MySQL server”，实际是握手失败。