phpMyAdmin不支持SSH隧道,必须提前在服务器端手动建立并长期维持SSH隧道,再通过本地回环地址、严格端口映射及config.inc.php中强制配置host为'127.0.0.1'(禁用localhost)、动态循环生成多服务器数组、使用autossh或systemd守护隧道进程,并确保SSH→跳板机→MySQL的完整权限链畅通。

不能直接在 phpMyAdmin 界面里填 SSH 隧道参数——它压根不支持 SSH 层,所有隧道必须提前在服务器端手动建立并长期维持,再通过本地回环 + 端口映射 + 严格配置三者协同才能连上多台内网 MySQL。
ssh -L 命令必须显式绑定 127.0.0.1,不能用 localhost 或 0.0.0.0
很多人写 ssh -L 8888:localhost:3306 jump.example.com,结果 phpMyAdmin 死活连不上。问题出在:localhost 在不同系统下可能触发 Unix socket、IPv4、IPv6 任意一种解析,导致隧道监听地址不稳定;而 0.0.0.0:8888 会暴露端口,还可能被 phpMyAdmin 的 host 头校验拦截。
正确写法是两端都锁定 IPv4 回环:
-
ssh -fN -L 127.0.0.1:8888:127.0.0.1:3306 jump.example.com(跳板机连自己本机的 MySQL) -
ssh -fN -L 127.0.0.1:8889:10.0.0.5:3306 jump.example.com(跳板机连内网数据库 IP) -
-fN让进程后台运行,-o ServerAliveInterval=60可加在末尾防断连
config.inc.php 中每台服务器的 host 必须写 '127.0.0.1',绝不能写 'localhost'
PHP 的 mysqli 扩展对 'localhost' 有特殊处理:它会跳过 TCP,直连 Unix socket——这等于绕开你辛辛苦苦建的 SSH 隧道,直接报错 #2002 Cannot log in to the MySQL server。
立即学习“PHP免费学习笔记(深入)”;
哪怕你映射的是本地 8888 端口,对应配置也必须这样写:
$cfg['Servers'][1]['host'] = '127.0.0.1'; $cfg['Servers'][1]['port'] = '8888'; $cfg['Servers'][1]['auth_type'] = 'cookie'; $cfg['Servers'][1]['verbose'] = 'Prod DB via SSH';
同理,第二台:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
$cfg['Servers'][2]['host'] = '127.0.0.1'$cfg['Servers'][2]['port'] = '8889'-
$cfg['Servers'][2]['auth_type'] = 'cookie'(http在多服务器下不可用)
多服务器必须用循环动态生成 $cfg['Servers'],索引从 1 开始连续
硬编码 $cfg['Servers'][1] 和 $cfg['Servers'][3],中间漏掉 [2],phpMyAdmin 就会在遍历到空值时直接中止加载——你只看到一个服务器出现在登录页下拉框里,后面全没了。
推荐做法是定义干净的配置数组,再统一循环注入:
$hosts = [
1 => ['host' => '127.0.0.1', 'port' => '8888', 'verbose' => 'Production'],
2 => ['host' => '127.0.0.1', 'port' => '8889', 'verbose' => 'Staging'],
3 => ['host' => '127.0.0.1', 'port' => '8890', 'verbose' => 'Test'],
];
foreach ($hosts as $i => $h) {
$cfg['Servers'][$i]['host'] = $h['host'];
$cfg['Servers'][$i]['port'] = $h['port'];
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['verbose'] = $h['verbose'];
}
$cfg['ServerDefault'] = 0;
注意三点:
- 索引必须是整数且从 1 开始,不能是 0 或字符串
- 每个子数组必须含
'host'和'auth_type',缺一不可 - 别在 foreach 块里混写 PHP 注释(如
// Prod),注释会被当字符串拼进数组,导致解析失败
隧道存活比配置更重要,断了 phpMyAdmin 完全不报错
phpMyAdmin 不检查 SSH 进程是否存在,它只管发请求。一旦隧道挂了,页面就卡住或报模糊的 #2002 错误,根本不会提示“SSH 连接已断”。
每次重启服务器后,ssh -L 进程都会消失,必须用守护方案:
- 用
autossh -fN -L 127.0.0.1:8888:10.0.0.5:3306 user@jump.example.com - 或写 systemd user service,避免依赖前台终端
- 检查是否活着:
ps aux | grep 'ssh.*-L.*8888',能 grep 到才算有效
最容易被忽略的是权限链:SSH 能连跳板机 → 跳板机能连目标 MySQL(查 mysql.user 表的 Host 字段是否匹配跳板机内网 IP)→ phpMyAdmin 所在机器的防火墙没拦本地回环流量。三者缺一不可。


















