问题背景

最近在 Windows 上使用 Docker 部署了 Chat2DB（一款数据库管理工具），但发现它无法连接本地的 MySQL 服务。具体表现如下：

• 在 Chat2DB 中填写 localhost:3306 配置后，提示 “Connection refused” 或 “Access denied”。
• 本地 MySQL 服务已确认正常运行，且账号密码无误。

问题根源分析

经过排查，问题核心在于 Docker 容器与宿主机（Windows）的网络隔离：

1. Docker 网络隔离
   Docker 容器默认运行在虚拟网络中，容器内的 localhost 指向容器自身，而非宿主机。

   # 容器内访问 localhost:3306 → 指向容器自己的网络（无MySQL服务）
   

2. MySQL 默认配置限制
   MySQL 默认绑定 127.0.0.1，只允许本机访问，拒绝外部连接（包括 Docker 容器）。
3. 防火墙干扰
   Windows 防火墙可能拦截了 Docker 容器对宿主机 3306 端口的访问。

解决方案

方法 1：使用 Docker 专用 DNS 访问宿主机

Docker 为容器提供了一个特殊 DNS host.docker.internal，直接指向宿主机的网络接口。
操作步骤：

1. 修改 Chat2DB 的连接配置：
   • 主机名：将 localhost 替换为 host.docker.internal
   • 端口：保持 3306
   • 用户名/密码：填写本地 MySQL 的账号密码

   原始配置 → localhost:3306
   修改后 → host.docker.internal:3306
   

2. 测试连接，此时应能成功访问宿主机 MySQL！

方法 2：配置 MySQL 允许远程连接（备用方案）

若方法 1 不生效，可能是 MySQL 限制了外部访问。需修改 MySQL 配置：

1. 登录 MySQL 并授权远程用户

   -- 创建允许任意IP访问的用户（开发环境临时使用）
   CREATE USER 'your_user'@'%' IDENTIFIED BY 'your_password';
   GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'%';
   FLUSH PRIVILEGES;
   

2. 修改 MySQL 绑定地址
   编辑 MySQL 配置文件 my.ini（Windows 默认路径：C:\ProgramData\MySQL\MySQL Server 8.0\my.ini）：

   [mysqld]
   bind-address = 0.0.0.0  # 允许所有IP访问
   

3. 重启 MySQL 服务：

   net stop mysql80 && net start mysql80
   

方法 3：检查 Windows 防火墙（极端情况）

如果仍失败，可能是防火墙拦截：

1. 打开 Windows Defender 防火墙 → 高级设置。
2. 添加入站规则，允许 3306 端口。

总结

1. 核心思路
   Docker 容器与宿主机网络隔离是常见问题，优先使用 host.docker.internal 直接穿透网络隔离。
2. 安全提醒
   • 生产环境中避免使用 % 开放 MySQL 远程权限，建议限制 IP 范围。
   • 若仅本地开发，方法 1 足够安全且无需修改 MySQL 配置。
3. 扩展场景
   如果 MySQL 部署在另一个 Docker 容器中，推荐使用 Docker 自定义网络或 docker-compose 实现容器间通信。

附录：相关命令和配置

• 查看 Docker 容器 IP（仅供调试）：

  docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <容器ID>
  

• Docker 官方文档：
  Docker Desktop 网络配置

如果遇到其他问题，欢迎在评论区留言！ 👍