根本原因是容器与宿主机网络隔离且MySQL默认拒绝外部连接；容器内localhost指向自身，需改用host.docker.internal（Win/macOS）或配置bind-address=0.0.0.0、授权远程用户并开放防火墙。
直接用 localhost 或 127.0.0.1 肯定连不上——容器里的 localhost 指的是它自己，不是你的宿主机。
为什么 localhost 在容器里连不到宿主机 MySQL
容器有独立的网络命名空间，localhost 解析为容器自身的 127.0.0.1，而宿主机 MySQL 并不在那里监听。即使宿主机 MySQL 正在跑，容器也完全感知不到。
-
docker run启动时没加--network=host，默认是 bridge 模式，网络隔离严格 - 宝塔、Docker Desktop、Linux 上的
host.docker.internal行为不一致：macOS/Windows 默认可用；Linux 默认不可解析，会报getaddrinfo failed - 直接填
172.17.0.1（旧版docker0网桥 IP）看似可行，但新版 Docker 已弃用该接口，IP 不稳定，重启后可能变
正确填写 PMA_HOST 的三种可靠方式
关键不是“怎么写”，而是“写什么才真正可达”。优先级从高到低：
- 如果用
docker-compose.yml（推荐），且 Compose 版本 ≥ v2.3：设PMA_HOST=host.docker.internal，并在phpmyadmin服务下加extra_hosts: ["host.docker.internal:host-gateway"] - 如果宿主机有固定局域网 IP（如
192.168.1.100），直接填这个 IP——前提是 MySQL 配置了bind-address = 0.0.0.0，且用户授权包含该网段（例如'root'@'192.168.1.%'） - 如果 MySQL 是宝塔直装，且你确认宝塔已放行远程访问：填
172.17.0.1有时能临时通，但别依赖它；更稳的是查宿主机真实内网 IP（ip route | awk '/default/ {print $3}'），再用那个 IP
宿主机 MySQL 必须同步做的三件事
光改 PMA_HOST 不够，宿主机 MySQL 侧不放开，照样拒绝连接。
- 修改
/etc/mysql/mysql.conf.d/mysqld.cnf，把bind-address = 127.0.0.1改成bind-address = 0.0.0.0（或明确列出宿主机网卡 IP） - 登录 MySQL 执行：
GRANT ALL ON *.* TO 'root'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES;—— 注意'%'是通配，生产环境应限定具体 IP 段 - 检查防火墙：Ubuntu 用
ufw allow 3306，CentOS 用firewall-cmd --permanent --add-port=3306/tcp，云服务器还要进安全组放行 3306
宝塔 Docker 管理器里最容易漏掉的两个变量
宝塔界面填环境变量时，只填 PMA_HOST 不够，这两个必须显式设置：
立即学习“PHP免费学习笔记（深入）”；
-
PHPMYADMIN_HOST（注意不是PMA_HOST）：宝塔模板里实际读取的是这个变量名，填法同上（如host.docker.internal或宿主机 IP） -
PHPMYADMIN_ARBITRARY=1：不设这个，phpMyAdmin 会忽略你填的PHPMYADMIN_HOST，只认默认的mysql容器名 - 顺手加上
MYSQL_ROOT_PASSWORD（随便设个值，比如dummy）：官方镜像启动逻辑会校验这个变量，缺了会卡住不动
最常被忽略的其实是 MySQL 用户授权那一步——很多人改了配置、填对了 host，却忘了执行 FLUSH PRIVILEGES，导致权限不生效；还有人以为 'root'@'localhost' 能自动覆盖远程访问，其实不能。
