You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

为什么Docker容器连接宿主机时需用host.docker.internal替代localhost

问题解答

要理解这个差异的核心原因,要从Docker的网络隔离逻辑说起:

  • 每个Docker容器默认都有独立的网络命名空间,拥有专属的网络栈、回环接口(127.0.0.1,也就是localhost对应的地址)。所以容器内访问localhost,实际指向的是容器自身的内部环境,和宿主机的网络是完全隔离的。你要访问宿主机上的MySQL服务,用localhost实际是在容器内部找对应的服务,自然无法连通。
  • host.docker.internal是Docker官方预置的特殊DNS域名,专门用于容器访问宿主机场景,Docker会自动将该域名解析到宿主机的可用网络地址,不需要开发者手动查询宿主机IP,也适配Windows、Mac、Linux不同环境的网络差异(目前Windows、Mac、新版Docker Desktop for Linux都默认支持该域名)。

补充注意:如果你使用的是Linux原生Docker(非Docker Desktop)的旧版本,默认不会自动解析host.docker.internal,需要在容器启动时添加参数手动绑定:

docker run --add-host=host.docker.internal:host-gateway <你的镜像名>

内容的提问来源于stack exchange,提问作者chai

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 08:06:04