host网络模式下无法通过127.0.0.1:3306连接Docker MySQL容器怎么办

问题根因 #

你的docker-compose.yml配置本身没有错误，连接失败是Docker Desktop for Mac/Windows的固有限制导致的，该限制截至2024年仍未完全解决：
Docker Desktop在Mac和Windows环境下实际运行在一个轻量Linux虚拟机中，host网络模式共享的是该虚拟机的网络栈，而非你物理主机的网络栈。因此容器监听的3306端口绑定的是虚拟机的回环地址，而非物理Mac/Windows主机的127.0.0.1，自然无法通过本地地址直接访问。
而Linux环境下Docker直接运行在宿主机内核上，host模式可以直接共享物理机网络栈，你的配置在Linux环境下可以正常运行，直接访问127.0.0.1:3306即可连通MySQL。

适配Mac/Windows的解决方案 #

如果必须使用host模式，或者需要模拟host模式的访问效果，可以参考以下方案：

• 如果只是需要端口直接对外暴露，可改回bridge网络模式，添加端口绑定即可实现和host模式一致的访问效果：

  ports:
    - "127.0.0.1:3306:3306" # 仅绑定本地回环，避免端口对外暴露
  

• 如果必须启用host模式，可通过Docker虚拟机IP访问容器服务：执行docker run -it --rm --network host alpine ip addr show eth0拿到虚拟机的IP地址，使用[虚拟机IP]:3306即可连接MySQL。
• Windows下如果使用WSL2后端的Docker Desktop，在WSL2发行版内部可以正常使用host模式访问服务，Windows主机侧访问可使用WSL2虚拟机的IP。

内容的提问来源于stack exchange，提问作者afraid.jpg