基于桥接网络的Docker容器中Vert.x+Hazelcast集群连接问询

结合你描述的Docker部署场景，我来拆解下确保外部客户端能正常连接到Vert.x+Hazelcast集群的核心步骤——这些都是实际生产部署中验证过的方案：

Docker容器内的Hazelcast节点默认会用桥接内网地址172.17.0.2对外广播自身地址，但外部客户端根本无法访问这个内网网段。你必须强制Hazelcast节点告诉外部客户端：用主机的局域网IP（192.168.107.105）和映射的端口来连接我。

• 如果你用XML配置文件（hazelcast.xml），添加以下配置：

<hazelcast>
  <network>
    <!-- 指定节点暴露给外部的地址和端口 -->
    <public-address>192.168.107.105:5702</public-address>
    <port>5702</port> <!-- 容器内的监听端口，要和映射的内部端口一致 -->
    <port-count>100</port-count>
    <!-- 保持其他网络配置（比如join配置）不变 -->
  </network>
</hazelcast>

• 如果你用Java代码配置Hazelcast：

Config hazelcastConfig = new Config();
hazelcastConfig.getNetworkConfig()
    .setPublicAddress("192.168.107.105:5702")
    .setPort(5702);

Vert.x依赖Hazelcast实现集群通信，所以必须把上述自定义的Hazelcast配置传给Vertx：

• 方式一：将hazelcast.xml放到容器的类路径下（比如src/main/resources），Vert.x会自动加载它。
• 方式二：在代码中直接传入配置：

VertxOptions vertxOpts = new VertxOptions();
// 初始化自定义Hazelcast配置
Config hazelcastConfig = new Config();
hazelcastConfig.getNetworkConfig().setPublicAddress("192.168.107.105:5702");
// 绑定集群管理器
vertxOpts.setClusterManager(new HazelcastClusterManager(hazelcastConfig));

// 启动集群模式的Vert.x
Vertx.clusteredVertx(vertxOpts, res -> {
  if (res.succeeded()) {
    Vertx vertx = res.result();
    // 部署你的Vert.x应用实例
  } else {
    System.err.println("集群启动失败：" + res.cause().getMessage());
  }
});

客户端不管是Vert.x集群客户端还是原生Hazelcast客户端，都必须使用主机的IP（192.168.107.105）和映射的端口，绝对不能用容器的内网地址172.17.0.2。

• Vert.x客户端连接示例：

VertxOptions clientOpts = new VertxOptions();
// 指定集群主机和端口
clientOpts.addClusterHost("192.168.107.105");
clientOpts.addClusterPort(5702);

Vertx.clusteredVertx(clientOpts, res -> {
  if (res.succeeded()) {
    Vertx vertxClient = res.result();
    // 执行客户端业务逻辑，比如调用集群中的Verticle
  } else {
    System.err.println("客户端连接集群失败：" + res.cause().getMessage());
  }
});

• 原生Hazelcast客户端连接示例：

ClientConfig clientConfig = new ClientConfig();
clientConfig.getNetworkConfig().addAddress("192.168.107.105:5702");
HazelcastInstance hazelcastClient = HazelcastClient.newHazelcastClient(clientConfig);

完成配置后，一定要做以下验证：

• 端口连通性测试：在客户端机器上执行nc -zv 192.168.107.105 5702或telnet 192.168.107.105 5702，确认端口能正常访问（如果不通，检查主机防火墙、Docker端口映射是否正确）。
• 查看Hazelcast日志：检查容器内的Hazelcast日志，是否有类似Members {size:1, ver:1} [Member [192.168.107.105]:5702 - abc123]的输出，这说明节点已经正确注册了公共地址。
• 多节点集群验证：如果是多节点部署，确保每个节点的public-address都配置正确，且节点之间能互相通信（日志中会显示节点加入集群的信息）。

• Docker启动时，确保端口映射明确绑定到主机IP（而不是默认的0.0.0.0），比如：

docker run -d \
  -p 192.168.107.105:5702:5702 \
  -p 192.168.107.105:1199:1199 \
  your-vertx-hazelcast-image

• 如果用Docker Compose，在docker-compose.yml中配置：

services:
  vertx-hazelcast-node:
    image: your-vertx-hazelcast-image
    ports:
      - "192.168.107.105:5702:5702"
      - "192.168.107.105:1199:1199"
    environment:
      # 可以通过环境变量传递公共地址，避免硬编码
      - HAZELCAST_PUBLIC_ADDRESS=192.168.107.105:5702

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