PMA_ARBITRARY=1是必需环境变量，启用后登录页才显示“服务器”下拉框并支持手动输入任意MySQL地址；不设则仅能连接预配置的单实例，且该变量必须通过Deployment的env字段注入，不可写入config.inc.php。
phpMyAdmin Deployment 必须设 PMA_ARBITRARY=1
不设这个环境变量，phpmyadmin 就不会显示“服务器”下拉框，也无法手动输入任意 mysql 地址——你连调试都做不到。它不是可选项，是连接多个 mysql 的前提开关。
常见错误：只配了 MYSQL_HOST 指向某一个实例，以为能自动切换。实际效果是只能连那一个，其他全不可见。
-
PMA_ARBITRARY=1启用后，登录页顶部会出现“服务器”输入框，支持填mydb.cpolar.io:3307、mysql-test.default.svc.cluster.local:3306等任意地址 - 如果同时设了
PMA_USER和PMA_PASSWORD，会强制要求每次登录都输这两项，反而锁死多实例能力；建议只留空，靠登录页填凭据 - 在 Kubernetes 中，该变量必须通过 Deployment 的
env字段注入，不能写在 config.inc.php 里（镜像启动后配置文件已固化）
跨 namespace 连 MySQL 必须用全限定域名
比如你的 MySQL Service 在 db-prod namespace，而 phpMyAdmin 在 tools namespace，直接写 MYSQL_HOST: mysql-prod 会解析失败——Kubernetes DNS 只在本 namespace 内默认解析短名。
正确写法只有两种：
- 同 namespace：直接用 Service 名，如
mysql-prod - 跨 namespace：必须用全限定域名
mysql-prod.db-prod.svc.cluster.local（格式固定：{service}.{namespace}.svc.cluster.local） - 别信
hostNetwork: true或dnsPolicy: Default——它们绕过集群 DNS，反而让 Service 名失效
内网穿透后的 MySQL 实例要手动填公网地址，不能靠 DNS 自动发现
phpMyAdmin 不感知穿透层，config.inc.php 里的 $cfg['Servers'][$i] 条目在容器镜像里是静态的，进不了 Deployment 的 runtime 配置。所以穿透场景下，唯一可行路径是走 PMA_ARBITRARY=1 + 登录页手动输。
立即学习“PHP免费学习笔记（深入）”；
容易错的点：
- 填
localhost或127.0.0.1——这连的是 phpMyAdmin 容器自己，不是穿透目标 - 端口写成
"3307/tcp"或带空格的字符串 ——PHP 解析失败后静默归零，连到默认 3306，但可能根本没开 - 误以为 HTTPS 穿透就自动启用 MySQL SSL ——SSL 是 MySQL 层协议，和穿透链路无关；若远程 MySQL 要求 SSL，得在登录页勾选 “Use SSL”，否则报
#1045
连接超时或 DNS 延迟时，connect_timeout 必须显式设
穿透链路或跨 region Service 访问常有 5–10 秒 DNS 解析延迟，phpMyAdmin 默认 connect_timeout 是 0（依赖 PHP 默认值，通常 60 秒），但中间件（如 Nginx/Ingress）可能先超时返回 504，用户看到的是空白页或 502，而不是明确的连接错误。
解决方法不是调大 PHP timeout，而是让 phpMyAdmin 主动快 Fail：
- 在登录页填完地址后，点击“Go”前，URL 会跳转到
/index.php?server=1&lang=en——此时若卡住，大概率是 DNS 或网络层问题 - 加
PHPMYADMIN_ABSOLUTE_URI=https://your-domain.com/phpmyadmin/（结尾斜杠不能少），否则 cookie path 错误会导致反复重定向，掩盖真实连接问题 - 真要调超时，只能改 phpMyAdmin 容器内的
/etc/php/*/cli/php.ini中default_socket_timeout = 30，但这影响所有 PHP 进程，不推荐
PMA_ARBITRARY=1 + 全限定域名或穿透地址 + 登录页手动输凭据 + PHPMYADMIN_ABSOLUTE_URI 正确设置。任何试图把多实例逻辑塞进 config.inc.php 的做法，在 Kubernetes 场景下都会因镜像不可变而失效。 
