适用范围与准备
适用于 Docker Desktop 默认隔离网络中的 Linux 容器,宿主机上服务可用,容器访问 127.0.0.1 却失败。先核对当前 Docker context、容器及端口。原生 Linux Engine、远端 Docker 主机和已启用 host networking 的环境不能直接套用这组判断。
先区分原因
默认隔离网络下,容器里的 localhost 指容器自己。Docker Desktop 提供 host.docker.internal 来访问运行 Desktop 的宿主服务;发布端口 -p 主要处理宿主访问容器的反向路径,不能把它当成容器访问宿主的开关。
按顺序操作
- 先用 docker context show 确认操作的是本机 Docker Desktop,而不是远端 daemon。记录目标服务实际运行位置、协议和监听端口;宿主浏览器能访问某地址,不代表容器会访问同一个网络端点。
- 从原服务的配置和日志确认其确实运行,并记录监听条件与防火墙范围。不要为排障立即把代理或管理接口改为对所有网卡开放;先用受控只读服务验证路径。
- 若已有一个允许执行命令、且内置 curl 的测试容器,可用下方命令访问宿主测试服务。替换 TEST_CONTAINER 和 8769 为实际值;没有 curl 时改用该镜像已有的工具,不现场修改业务容器安装软件。
- 先看 host.docker.internal 是否能解析,再区分连接被拒、超时和 HTTP 状态。若原 URL 是 HTTPS,域名必须符合证书及服务设计,不能把地址随意改成这个特殊主机名后用 -k 忽略证书错误。
- 容器能访问测试服务后,再按原应用的运行时代理或目标地址设置作单项修改。应用是否读取代理变量、代理是否要求认证,是下一层问题;不要把本例的直连 HTTP 探测写成业务代理已经配置成功。
docker context show
docker exec TEST_CONTAINER curl -q --noproxy "*" --connect-timeout 5 --max-time 10 --dump-header - "http://host.docker.internal:8769/health"| 方向 | 核对对象 |
|---|---|
| 容器 → 宿主 | host.docker.internal、服务监听、权限 |
| 宿主 → 容器 | 发布端口与容器内服务 |
| 容器 → 容器 | 所用网络及服务名,不照搬宿主地址 |
怎样确认有效
确认返回的是宿主预期服务的健康响应,并用服务端请求记录核对到达情况。--noproxy "*" 只用于这次排除测试容器已有代理设置,不是全局配置;它成功也不证明另一个容器、另一个 context 或真实应用的路径相同。
无效时恢复与下一步
未改善时恢复本次更改的应用地址,保留容器、context、错误阶段和测试时间。不要改为特权容器、关闭全部防火墙或开启 host networking 作为默认修复。需要调整监听时由服务负责人限定网络和认证,测试结束关闭临时服务。