Java场景下跨机器连接Docker内Server Socket的实现方法

先核对最容易踩坑的几个配置点 #

• Docker端口映射规则要写对：按照给出的端口对应关系，容器启动时必须配置宿主机171.18.1.4:9090到容器内部3333的映射，对应的docker run启动参数为-p 171.18.1.4:9090:3333。如果是用docker-compose部署，端口映射段要和这个规则保持一致，别搞反容器端口和宿主机端口的顺序，也别把宿主机绑定IP写错。
• 容器内Java服务的监听地址别绑错：不少人写Java ServerSocket的时候习惯性绑了127.0.0.1，这种情况下哪怕端口映射规则全对，外部请求也进不来。正确的监听逻辑是绑定0.0.0.0（代表所有可用网卡），示例代码为：

  // 服务端ServerSocket初始化正确写法
  ServerSocket serverSocket = new ServerSocket(3333, 100, InetAddress.getByName("0.0.0.0"));
  

• 宿主机网络策略要放行：检查宿主机的本地防火墙、云平台安全组规则，确保171.18.1.4:9090的入站流量允许客户端所在主机的IP访问，别因为默认规则拦截了9090端口的连接请求。

客户端侧的Java连接写法 #

完全不需要去关心容器内部的3333端口——这个端口是容器内部网络栈的端口，外部网络根本无法直接触达。客户端直接连接宿主机对外暴露的171.18.1.4:9090即可，示例代码：

// Java客户端连接示例
Socket client = new Socket();
// 配置5秒连接超时，避免无限等待
client.connect(new InetSocketAddress("171.18.1.4", 9090), 5000);

快速排障顺序 #

顺着链路从内到外查，能省掉很多无效排查：

1. 先进容器内部，执行telnet localhost 3333，确认Java ServerSocket本身正常启动、能接收本地连接
2. 回到宿主机，执行telnet 171.18.1.4 9090，确认Docker的端口映射链路通畅
3. 到客户端所在的独立主机上，执行同样的telnet 171.18.1.4 9090测试，确认跨主机的网络策略没有拦截流量

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