MacOS Silicon环境下Docker容器连接本地Python API失败的解决方法

问题根源 #

Docker容器内的127.0.0.1指向容器自身的回环接口，而非你的Mac主机。所以Node应用在容器里请求http://127.0.0.1:5000时，实际是在访问容器内部，而非主机上运行的Python API。

具体解决步骤 #

1. 修改Node应用的API目标地址

将Node应用中调用Python API的地址从http://127.0.0.1:5000改为http://host.docker.internal:5000。host.docker.internal是Docker Desktop提供的特殊DNS名称，专门用于容器访问主机上的服务。

2. 修正Docker运行命令中的卷挂载

你当前的卷挂载命令-v ./Config.toml不完整，会导致Docker在容器内创建一个目录而非挂载文件。需要指定容器内的目标路径，比如：

docker run --platform linux/amd64 -d -v $(pwd)/Config.toml:/app/Config.toml -p 8080:8080 myApp/app:v0.1.0

注意替换/app/Config.toml为你的Node应用期望读取配置文件的实际路径。

3. 确保Python API监听正确的地址（可选但推荐）

虽然host.docker.internal可以访问主机的127.0.0.1，但建议将Python应用的服务器绑定到0.0.0.0而非仅127.0.0.1，这样它能接收来自主机网络的请求。比如在Flask中：

app.run(host='0.0.0.0', port=5000)

为什么之前的尝试无效 #

• --network host：在Docker Desktop for Mac上，该参数不会让容器直接使用主机网络，反而会导致端口映射失效，因此无法解决问题。
• http.server --bind 0.0.0.0：这是Python的内置HTTP服务器命令，不属于docker run的参数，所以会被Docker当成镜像名处理，导致拉取失败。

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