Docker部署的APISIX无法连接本地非Docker上游服务求助

Docker容器默认处于独立的网络命名空间中，容器内的localhost指向容器自身，而非宿主机。你的APISIX运行在Docker容器里，当配置上游为localhost:XXXX时，它会尝试连接容器内部的XXXX端口，但你的dummy服务是运行在宿主机（非Docker环境），所以必然连接失败，出现Connection refused错误。

方法1：使用宿主机的实际IP地址 #

找到宿主机在本地局域网的IP（比如192.168.1.100），修改路由配置中的上游地址：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "1",
  "uri": "/api/v1/test_server/testing",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "192.168.1.100:XXXX": 1
    }
  }
}'

注意替换成你宿主机的真实IP，可通过ifconfig（Linux/macOS）或ipconfig（Windows）查询。

方法2：使用Docker的特殊DNS名称（推荐） #

Docker提供了host.docker.internal这个特殊DNS名称，用于容器访问宿主机服务，直接修改上游配置：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "1",
  "uri": "/api/v1/test_server/testing",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "host.docker.internal:XXXX": 1
    }
  }
}'

这个方法跨平台（Windows/macOS/Linux），无需手动查询IP，更便捷。

方法3：修改APISIX容器的网络模式为host #

启动APISIX容器时，添加--network host参数，让容器共享宿主机的网络命名空间。这样容器内的localhost就等同于宿主机的localhost，原路由配置无需修改。

注意：使用host网络模式会让容器失去网络隔离性，需根据实际场景评估是否适用。

修改配置后，重新执行：

curl "http://127.0.0.1:9080/api/v1/test_server/testing"

应该能正常返回{ success: true }的响应。

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