Docker容器访问本地gRPC服务时端口冲突的解决方法

错误原因 #

你添加的-p 50051:50051是将容器的50051端口映射到本地主机的50051端口，但本地该端口已被gRPC服务占用，导致Docker尝试绑定端口时失败。而你实际需要的是容器访问本地主机的50051服务，并非对外暴露容器的50051端口，这个映射参数完全多余。

解决方案 #

1. 修改启动命令，移除冲突的端口映射

删除命令中的-p 50051:50051，修改后的启动命令如下：

sudo docker run -ti -p 8888:8888 -v $(pwd):<folder> -e <aws-credentials> <directory> jupyter

2. 在容器内访问本地gRPC服务

容器内可通过以下方式访问本地主机的50051端口服务：

• 通用方式：使用host.docker.internal域名，gRPC客户端在容器内直接连接host.docker.internal:50051即可。
• 兼容老版本Docker：如果host.docker.internal无法解析，启动容器时添加--add-host=host.docker.internal:host-gateway参数，强制容器将该域名指向本地主机：

  sudo docker run -ti -p 8888:8888 --add-host=host.docker.internal:host-gateway -v $(pwd):<folder> -e <aws-credentials> <directory> jupyter
  

为什么不用network="host" #

启用host网络会让容器直接使用主机的网络栈，不仅可能导致容器内的8888服务与主机上的端口冲突，还会过度开放网络权限，不符合你仅需访问本地50051服务的需求。

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