Mac OS下Docker PhpMyAdmin无法连接MySQL Server，错误#2002

我刚帮好几个开发者搞定过这个问题，核心原因其实很直白：Docker容器里的localhost指的是容器自身的网络环境，不是你的Mac宿主机，所以你用localhost连接自然会报127.0.0.1相关的错误。下面是一步步的实操解决方案：

1. 用Docker专属宿主机地址连接 #

Docker在Mac（和Windows）上内置了一个特殊地址host.docker.internal，专门用来让容器访问宿主机的服务。你可以直接用这个地址启动PhpMyAdmin容器：

docker run -d -p 8080:80 \
  -e PMA_HOST=host.docker.internal \
  -e PMA_PORT=3306 \
  phpmyadmin/phpmyadmin

参数说明：

• -p 8080:80：把容器的80端口映射到Mac的8080端口，之后访问http://localhost:8080就能打开PhpMyAdmin
• -e PMA_HOST=host.docker.internal：告诉PhpMyAdmin要连接的MySQL主机地址
• -e PMA_PORT=3306：指定MySQL的端口（如果你的MySQL不是3306就改这里）

2. 确保MySQL允许外部连接 #

如果上面的方法还是失败，大概率是你的MySQL默认只绑定了127.0.0.1，拒绝了来自容器的请求：

步骤1：修改MySQL绑定地址 #

找到你的MySQL配置文件（通常在/usr/local/mysql/my.cnf或/etc/my.cnf），找到bind-address行，修改为：

bind-address = 0.0.0.0

这会让MySQL监听所有网络接口，允许容器的连接请求。

步骤2：给root用户授权远程访问 #

默认root可能只允许本地登录，你需要在终端登录MySQL后执行以下命令，授权root可以从任意地址连接（也可以限定为host.docker.internal提升安全性）：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'o_oGLZDI<1-t' WITH GRANT OPTION;
FLUSH PRIVILEGES;

执行完后重启MySQL服务生效。

3. 测试连接 #

启动PhpMyAdmin容器后，打开浏览器访问http://localhost:8080，输入用户名root和你的密码o_oGLZDI<1-t，应该就能正常登录了。

额外注意事项 #

• 如果Mac开了防火墙，确保3306端口没有被拦截
• 密码里的特殊字符（比如<）在Docker命令中记得用引号包裹，避免解析错误
• 如果你用Docker Compose，只需在配置里把PMA_HOST设为host.docker.internal即可，示例：

version: '3'
services:
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    ports:
      - "8080:80"
    environment:
      PMA_HOST: host.docker.internal
      PMA_PORT: 3306

内容的提问来源于stack exchange，提问作者kemicofa