Docker 无法连接本机服务的解决方案

当 Docker 容器无法连接到主机上的服务时，可能是由于网络配置问题导致的。以下是几种常见情况及解决方案：

1. 使用 host.docker.internal (推荐)

在 Docker 18.03 及以上版本中，可以使用特殊 DNS 名称 host.docker.internal 来访问主机服务：

ping host.docker.internal

2. 使用主机网络模式

启动容器时使用主机网络模式，容器将共享主机的网络命名空间：

docker run --network host your_image

3. 使用主机 IP 地址

在 Linux 上

# 获取主机在 Docker 网络中的 IP
ip addr show docker0
# 或者
hostname -I | awk '{print $1}'

在 macOS/Windows 上

使用特殊 IP host.docker.internal 或 gateway.docker.internal

4. 检查防火墙设置

确保主机防火墙没有阻止 Docker 容器的访问：

# Linux 检查防火墙状态
sudo ufw status

5. 检查服务绑定地址

确保主机上的服务绑定到了 0.0.0.0 而不是 127.0.0.1，例如：

# 错误示例 - 只能在本地访问
python -m http.server 8000 --bind 127.0.0.1

# 正确示例 - 允许外部访问
python -m http.server 8000 --bind 0.0.0.0

6. 端口映射问题

如果服务运行在容器中，确保正确映射了端口：

docker run -p 主机端口:容器端口 your_image

7. 跨平台注意事项

• macOS/Windows: 使用 Docker Desktop 时，host.docker.internal 是推荐方式
• Linux: 可能需要手动设置 --add-host=host.docker.internal:host-gateway

测试连接

在容器内测试连接主机服务：

docker exec -it your_container curl http://host.docker.internal:你的服务端口

希望这些解决方案能帮助你解决 Docker 连接主机服务的问题！