You need to enable JavaScript to run this app. Linux下.NET Core项目Docker连接报[::ffff:127.0.0.1]:105拒绝连接问题求解
优惠活动
大模型
产品
解决方案
定价
更多

Linux下.NET Core项目Docker连接报[::ffff:127.0.0.1]:105拒绝连接问题求解

核心根因

Windows下127.0.0.1可连通、Linux下连127.0.0.1:105报Connection refused,本质是两个平台的Docker网络实现逻辑差异:

  • Windows/macOS的Docker Desktop通过内置虚拟机做网络适配,默认打通容器与宿主机的回环网络,容器内填写127.0.0.1时,请求会被自动转发到宿主机对应映射端口的服务,因此可以正常连通。
  • Linux原生Docker的每个容器拥有独立网络命名空间,容器内部的127.0.0.1仅指向容器自身的进程,完全无法访问同网络下的其他容器、或是宿主机上的服务。报错中的[::ffff:127.0.0.1]:105,就是当前.NET Core容器在自身进程范围内查找105端口的监听服务,找不到才会返回连接拒绝。
  • 通过docker network inspect查询到的172.18.0.5这类容器内网IP是动态分配的,容器重建后大概率发生变化,绝对不能硬编码到业务配置中。
无跨环境适配问题的调整方案

方案1:同网络下的容器服务对接(优先推荐)

如果你的.NET Core项目和对接的其他服务都跑在同一个自定义Docker网络(也就是你配置的my_project_net)下,完全不需要记录动态IP,直接把配置里的连接地址中127.0.0.1替换为对端服务在docker-compose中定义的服务名即可。

  • 原理:同一个自定义bridge网络下,Docker内置了DNS解析服务,会自动把服务名映射到对端容器的实际内网IP,不受IP动态变化的影响,Windows、Linux环境的配置可以完全通用。
  • 举例:如果对接的服务在compose里配置的服务名是order-service,服务端口是105,那你的.NET Core项目里的连接地址直接写http://order-service:105即可,不需要做其他额外配置。

方案2:对接直接跑在Linux宿主机上的非容器化服务

如果对端的105端口服务是直接安装在Linux宿主机上、没有跑在容器里,不要硬写宿主机的内网IP,直接用Docker官方提供的通用主机名host.docker.internal:

  • 在你的.NET Core项目对应的docker-compose配置段,添加一行host映射配置,把通用主机名指向Docker网桥的宿主机网关地址:
    extra_hosts:
      - "host.docker.internal:host-gateway"
    
  • 之后把项目配置里的连接地址127.0.0.1替换为host.docker.internal,保持端口105不变即可。这个配置在Windows Docker Desktop下本身就默认生效,不需要改动,真正做到一份配置跨环境运行。
容易踩的坑排查
  • 确认你的.NET Core项目确实已经加入了my_project_net网络,没有网络名拼写错误、或是多挂了其他默认网络导致DNS解析不生效。
  • 确认对端服务的监听地址是0.0.0.0,没有只绑定在对端容器/宿主机的127.0.0.1上,否则即使网络通了,外部节点也无法建立连接。
  • 不要为了图方便把容器的网络模式改成host模式,这种模式会让容器和宿主机共享整个网络栈,破坏容器的网络隔离性,也丧失了docker-compose多服务网络编排的优势,属于不推荐的实现方式。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 07:15:04