如何在Docker中配置phpMyAdmin多服务器连接-phpMyAdmin-PHP中文网

PMA_HOSTS环境变量仅影响登录页下拉列表显示，不自动配置认证或端口，需配合config.user.inc.php中连续索引的$cfg['Servers']数组、同一Docker网络及host可解析才生效。

为什么PMA_HOSTS环境变量不生效

直接写 pma_hosts=db,db2 通常没用——phpmyadmin官方镜像的 pma_hosts 只在特定启动模式下才被解析，且要求所有服务器必须在同一 docker 网络中、能通过容器名互相解析。更关键的是，它只影响登录页下拉列表的显示逻辑，不自动配置每个服务器的认证方式或端口。

真正起作用的是 config 文件里的 $cfg['Servers'] 数组。环境变量只是“快捷入口”，底层仍需完整定义。

PMA_HOSTS 仅适用于 cookie 认证 + 单 root 用户直连多个同构 MySQL 实例（比如全是 8.0、都用 root/rootpass）
一旦涉及不同端口、不同用户、不同认证方式（如 http / signon），必须手写 config.inc.php
官方镜像默认不挂载自定义 config，PMA_HOSTS 就成了摆设

怎么让多服务器在登录页正常显示下拉框

核心是确保 $cfg['Servers'] 数组索引从 1 开始、连续、无跳空，且每个元素都包含 host 和 auth_type。

不要手动写 $i=0; $i++; $cfg['Servers'][$i] = [...] —— 容易漏掉 $i++ 或重复使用同一索引。

用 foreach 循环最安全：

$servers = [
    ['name' => '开发库', 'host' => 'db-dev', 'port' => 3306, 'user' => 'devuser'],
    ['name' => '测试库', 'host' => 'db-test', 'port' => 3307, 'user' => 'testuser'],
];
$i = 0;
foreach ($servers as $s) {
    $i++;
    $cfg['Servers'][$i]['host'] = $s['host'];
    $cfg['Servers'][$i]['port'] = $s['port'] ?? '3306';
    $cfg['Servers'][$i]['verbose'] = $s['name'];
    $cfg['Servers'][$i]['auth_type'] = 'cookie';
    $cfg['Servers'][$i]['user'] = $s['user'] ?? '';
}

确认 $cfg['ServerDefault'] = 0;（不预选任何服务器），否则下拉框可能被强制隐藏
如果用了 config.user.inc.php，必须挂载到 /etc/phpmyadmin/config.user.inc.php，且文件末尾不能有 PHP closing tag ?>

容器里怎么挂载自定义 config 文件

Docker 启动时，/etc/phpmyadmin 下的 config 文件不会自动加载，除非显式挂载并确保路径和权限正确。

常见错误是把 config 放错位置，或者用了只读挂载但 phpMyAdmin 尝试写日志导致启动失败。

docker-container-rerun-all

顺序检查并可选更新所有已在长期记忆中记录了固定重建命令的 docker run 容器。使用场景：用户...

下载

挂载命令必须带完整路径：docker run -v $(pwd)/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php ...
文件权限要为 644，属主可以是 root，但不能是 600（php-fpm 进程读不了）

如果用 docker-compose，写法是：

volumes:
  - ./config.user.inc.php:/etc/phpmyadmin/config.user.inc.php:ro

注意加 :ro 明确只读

别忘了网络互通：所有目标 MySQL 容器必须和 phpMyAdmin 在同一个 docker network 里，否则 host 值（如 db-dev）根本无法解析

连接外部非容器 MySQL 时的坑

当 MySQL 是宝塔直装、或运行在宿主机、或跨机器时，host.docker.internal 并不可靠——它只在 Docker Desktop for Mac/Windows 有效，Linux 上默认不存在。

硬填 172.17.0.1 也不保险，因为 Docker bridge 网络网关地址可能随安装方式变化。

最稳的方式是用宿主机真实内网 IP（如 192.168.1.100），并确保 MySQL 的 bind-address 设为 0.0.0.0，且用户授权允许该 IP 连接
如果必须用 host.docker.internal，Linux 下要手动添加：--add-host=host.docker.internal:host-gateway
PMA_ARBITRARY=1 必须设，否则 phpMyAdmin 会拒绝连接非白名单 host（默认只认 localhost 和容器名）
别漏 MYSQL_ROOT_PASSWORD：即使连外部 MySQL，这个环境变量也得填（随便值），否则官方镜像卡在初始化检查