Docker容器网络问题：NodeJS可访问跨主机API，Python无法访问

核心问题 #

使用--net=host模式启动Docker容器时，NodeJS容器可正常访问局域网内其他机器的API，但Python容器无法访问，启动命令为：

docker run -d --name containername --net=host -p 502:80 image:0.0.8

可能原因及解决方法 #

1. API地址配置错误 #

• 确认Python代码中是否使用了局域网目标机器的正确IP/主机名，而非localhost或127.0.0.1（即使--net=host，若代码写死localhost，部分场景下可能指向容器自身，而NodeJS的网络处理逻辑可能规避了这个问题）
• 修正API请求URL为http://[局域网目标IP]:[端口]/[路径]格式，例如http://192.168.1.100:8080/api/v1

2. 容器内网络连通性问题 #

• 测试容器到目标机器的连通性：

  docker exec -it containername ping [局域网目标IP]
  

  若ping不通，需排查主机到目标机器的网络链路（如主机防火墙、目标机器防火墙）
• 测试DNS解析（若使用主机名访问API）：

  docker exec -it containername nslookup [目标主机名]
  

  若解析失败，需检查容器内DNS配置或主机DNS设置

3. 防火墙/访问控制限制 #

• 检查目标机器的防火墙/安全组规则，确认是否允许主机IP的访问（--net=host模式下容器使用主机IP，NodeJS能访问说明主机IP已被允许，但需确认API是否有其他限制）
• 查看目标API的访问日志，确认Python请求是否到达：
  • 若未到达：排查主机到目标机器的网络转发规则
  • 若到达但被拒绝：检查API的访问控制策略（如User-Agent校验、请求头限制）

4. Docker命令参数冲突 #

• --net=host与-p 502:80参数冲突：使用--net=host时，端口映射参数会被忽略，建议移除-p参数避免混淆：

  docker run -d --name containername --net=host image:0.0.8
  

5. Python请求库的特殊配置 #

• 检查是否存在错误的代理配置：

  import requests
  # 若存在不必要的代理配置，需移除或修正
  proxies = {"http": "http://invalid-proxy:8080"}
  response = requests.get("API地址", proxies=proxies)
  

• 调整请求超时时间，避免因超时导致请求失败：

  response = requests.get("API地址", timeout=15)
  

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