localhost在容器内指向自身而非宿主机，因容器拥有独立网络命名空间；正确访问宿主机MySQL需改用host.docker.internal（Docker Desktop）或宿主机局域网IP，并同步配置MySQL的bind-address为0.0.0.0及对应用户授权。
localhost 在容器里不是宿主机，这是最直接的原因。
localhost 和 127.0.0.1 在容器内都指向自己
- 容器启动后拥有独立的网络命名空间，
localhost解析为容器自身的 loopback 接口（127.0.0.1），而该地址上没有 MySQL 服务。 - 即使宿主机 MySQL 正在监听
127.0.0.1:3306，容器也无法穿透网络隔离访问它。 - 常见错误配置：在 phpMyAdmin 的
config.inc.php或环境变量中写PMA_HOST=localhost或PMA_HOST=127.0.0.1—— 这俩在容器里等价，且都错。
宿主机 MySQL 配置默认拒绝外部连接
- 大多数发行版的 MySQL 默认配置是：
[mysqld] bind-address = 127.0.0.1 skip-networking = OFF
- 这意味着它只接受来自本机（即宿主机进程）的 TCP 连接，不接受来自 Docker 容器的 IP 请求。
- 即使你改用宿主机真实 IP（如
192.168.1.100）去连，也会被拒绝，除非：-
bind-address改为0.0.0.0（或明确列出宿主机网卡 IP） - 用户权限允许从容器所在子网登录（例如
root@'172.17.0.%'或root@'%'） - 防火墙放行 3306 端口（尤其在云服务器或 Windows 上）
-
host.docker.internal 并非 Linux 默认可用
- macOS 和 Windows Docker Desktop 内置支持
host.docker.internal，容器内解析即得宿主机 IP。 -
Linux 默认不提供该 DNS 名，直接使用会报
getaddrinfo failed。 - 若必须用，需手动添加：
docker run --add-host=host.docker.internal:host-gateway ...
或在docker-compose.yml中：extra_hosts: - "host.docker.internal:host-gateway"
容器连宿主机 MySQL 的正确 host 值取决于部署方式
- ✅ Docker Compose（推荐）：用
host-gateway别名（需 Compose v2.3+），并在环境变量中设：- PMA_HOST=host.docker.internal
- ✅
docker run启动：加--add-host=host.docker.internal:host-gateway，然后填host.docker.internal - ✅ 宿主机有固定局域网 IP（如
192.168.1.100）：直接填这个 IP，但要确保 MySQL 允许该网段、防火墙放行、用户授权包含该 IP 段 - ❌ 不要用
127.0.0.1、localhost、docker0网桥 IP（如172.17.0.1）——后者不稳定且依赖宿主机网络结构
真正容易被忽略的是：MySQL 用户权限和 bind-address 必须同步改，光调通网络层还不够；很多问题表面是“连不上”，实际是“连上了但被拒了”，日志里却只显示超时或空响应。
