填错 $cfg['Servers'][$i]['host'] 是连接失败最常见原因，需填穿透服务提供的域名（如 my-test-db.cpolar.io）而非 localhost 或带协议前缀的 URL，port 填映射后的整数端口（如 12345），必须删除或注释 socket 行，auth_type 必须设为 'cookie'。
填错 $cfg['Servers'][$i]['host'] 是连接失败最常见原因
内网 mysql 服务器本身不对外暴露，必须通过内网穿透服务（如 cpolar、frp）映射出一个公网可访问的地址。phpmyadmin 完全不感知穿透层，它只认你写在 config.inc.php 里的 host 和 port。
常见错误包括：
-
host写成'localhost'或'127.0.0.1'：这会让 phpMyAdmin 去连本机 MySQL，而不是穿透后的目标实例 -
host写成穿透服务分配的域名但没加协议前缀：比如填'mydb.cpolar.io'是对的，填'https://mydb.cpolar.io'就错——MySQL 连接不走 HTTP 协议 -
host是 IP 但被防火墙或 NAT 阻断：建议优先用穿透服务提供的二级域名，DNS 解析更稳定
$cfg['Servers'][$i]['port'] 必须是穿透后暴露的端口，不是原始 MySQL 端口
穿透服务会把远程 MySQL 的 3306 映射到一个公网端口（比如 12345），这个端口号才是你要填的。填错会导致静默连错端口，甚至误连到本机 3306（如果 PHP 把非法 port 字符串转成 0 后默认 fallback）。
注意以下细节：
- 值必须是整数，不要加引号：写
12345，别写'12345'（PHP 会转，但不保险）或'12345/tcp'（解析失败后归零） - 如果穿透服务用了固定域名+固定端口（如
db.example.com:12345），host填'db.example.com'，port填12345 - 若穿透链路不稳定，建议加超时设置：
$cfg['Servers'][$i]['connect_timeout'] = 30;
必须清理残留的 socket 字段，否则 host+port 不生效
如果你之前配过本地 socket 连接，配置里很可能还留着这一行：$cfg['Servers'][$i]['socket'] = '/var/run/mysqld/mysqld.sock';。只要这行存在且非空，phpMyAdmin 就会优先走 socket 连接，完全忽略你填的 host 和 port。
立即学习“PHP免费学习笔记（深入）”；
解决办法很简单：
- 找到对应服务器条目的
socket行 - 整行删掉，或者用
//注释掉 - 确认没有其他地方（比如
config.default.php）覆盖了该设置
auth_type = 'cookie' 是唯一可行选项，'http' 在穿透场景下必然失败
穿透服务无法透传 HTTP Auth 头，Web 服务器（Apache/Nginx）拿到的请求里根本没有你输入的用户名密码，auth_type = 'http' 会导致登录页直接跳过凭据校验，或返回 401。
正确做法是：
- 确保每个服务器条目都设为：
$cfg['Servers'][$i]['auth_type'] = 'cookie'; - 不要启用
$cfg['AllowArbitraryServer'] = true;：虽然能手动输 host，但切换服务器必须重新登录，体验差且不安全 - 靠登录页下拉框选服务器，凭据走 session，各实例独立认证
$i++; $cfg['Servers'][$i]['host'] = 'my-test-db.cpolar.io'; $cfg['Servers'][$i]['port'] = 12345; $cfg['Servers'][$i]['auth_type'] = 'cookie'; // $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock'; // ← 这行必须删或注释 $cfg['Servers'][$i]['connect_timeout'] = 30;复杂点在于：每台穿透 MySQL 都要单独配一个
$cfg['Servers'][$i] 条目，不能复用、不能动态发现，填错任意一项（尤其是 host、port、socket）都会导致 #2002 Cannot log in to the MySQL server —— 错误信息里不会告诉你哪错了。 
