phpMyAdmin不支持直接配置SSH隧道,必须由用户手动执行ssh -L命令建立本地端口映射,再在config.inc.php中将host设为'127.0.0.1'、port设为映射的本地端口,且MySQL用户需授权'@127.0.0.1'。

不能直接在 phpMyAdmin 里填 SSH 端口 —— 它压根不处理 SSH 隧道,只管 MySQL 连接。 所有“SSH 端口”必须由你本地或跳板机上手动建立的 ssh -L 命令完成,phpMyAdmin 只连你本地映射出来的那个 TCP 端口。
为什么 config.inc.php 里找不到 SSH 端口配置项
phpMyAdmin 是纯 PHP Web 应用,运行在 Web 服务器(如 Apache/Nginx)进程里,它不具备启动 SSH 进程、读取 SSH 密钥或管理隧道生命周期的能力。所谓“带非标 SSH 端口”,实际是指:远程 MySQL 主机位于防火墙后,只能通过一个非标准 SSH 端口(比如 2222)跳入,再从跳板机连 MySQL。
常见错误现象:
- 在
config.inc.php中给$cfg['Servers'][$i]['host']填"user@host:2222"或类似字符串 —— 直接报错或静默忽略 - 以为改了
port就能走 SSH,结果连的是裸 MySQL 端口,被防火墙拦截
正确做法:分两层建立连接链路
你需要两个独立动作:先建 SSH 隧道(含自定义端口),再让 phpMyAdmin 连隧道出口。关键在于确保隧道绑定地址和 phpMyAdmin 的 host/port 严格对齐。
假设目标是连接一台内网 MySQL(10.0.1.5:3306),需经跳板机 jump.example.com:2222 中转:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 在运行 phpMyAdmin 的那台机器(通常是你的开发机或 Web 服务器)上执行:
ssh -L 127.0.0.1:3308:10.0.1.5:3306 -p 2222 user@jump.example.com - 验证隧道是否生效:
mysql -h 127.0.0.1 -P 3308 -u dbuser -p—— 必须用127.0.0.1,不用localhost - 在
config.inc.php中添加服务器条目:$cfg['Servers'][2]['host'] = '127.0.0.1';$cfg['Servers'][2]['port'] = '3308';$cfg['Servers'][2]['user'] = 'dbuser';$cfg['Servers'][2]['password'] = '...';
多主机时如何避免端口冲突与隧道混乱
每个远程 MySQL 实例必须映射到本地**唯一端口**,且每个隧道命令要显式指定 127.0.0.1: 绑定前缀,否则可能监听在 ::1 或随机接口,导致 phpMyAdmin 连不上。
例如同时管理三台 MySQL:
- 主机 A:
ssh -L 127.0.0.1:3308:10.0.1.5:3306 -p 2222 user@jump1.example.com - 主机 B:
ssh -L 127.0.0.1:3309:10.0.2.7:3306 -p 2223 user@jump2.example.com - 主机 C(同一跳板但不同目标):
ssh -L 127.0.0.1:3310:10.0.3.12:3307 -p 2222 user@jump1.example.com
对应 config.inc.php 中三个 $cfg['Servers'][$i] 条目,port 分别为 '3308'、'3309'、'3310'。务必检查 ps aux | grep ssh 确认三条隧道进程都在运行,且没有重复端口占用。
容易被忽略的权限与稳定性细节
SSH 隧道不是“设一次就永远在线”。它依赖于 SSH 连接存活,一旦网络抖动、跳板机重启或 SSH 超时断开,隧道即失效,但 phpMyAdmin 不会报错,只会卡在连接超时或返回 #2002 Cannot log in to the MySQL server。
- 用
autossh替代原生ssh启动隧道(如:autossh -M 0 -N -L 127.0.0.1:3308:... -p 2222 ...) - MySQL 用户必须授权给
'dbuser'@'127.0.0.1'(不是'dbuser'@'jump.example.com'),因为从隧道看,连接来源永远是本地回环 - 如果 phpMyAdmin 和隧道在同一台机器(比如 Docker 容器),
host写'127.0.0.1'是唯一可靠选项;写'localhost'会让 PHP MySQL 扩展尝试 Unix socket,彻底绕过隧道
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










