AWS EC2上Apache Ignite服务器与Docker客户端心跳连接异常问题

我之前在AWS上部署Ignite集群搭配Docker微服务时，刚好碰到过一模一样的问题——容器私有IP导致服务器心跳失败的坑确实挺头疼的，给你几个经过验证的解决思路：

1. 强制客户端绑定可访问的主机IP #

Ignite客户端默认会自动绑定容器内部的私有IP，这个IP是Docker网桥的内部地址，EC2上的Ignite服务器根本访问不到。你需要在客户端的Ignite配置里手动指定对外暴露的IP，也就是容器所在EC2主机的内网IP（如果服务器和客户端在同一个VPC，优先用内网IP，延迟更低更安全）或者公网IP：

如果是Java代码配置：

IgniteConfiguration cfg = new IgniteConfiguration();
// 替换成容器所在EC2实例的内网IP
cfg.setLocalHost("172.31.XX.XX");

如果是XML配置：

<bean class="org.apache.ignite.configuration.IgniteConfiguration">
    <property name="localHost" value="172.31.XX.XX"/>
    <!-- 其他配置项 -->
</bean>

这样客户端向服务器注册时就会用这个可被访问的IP，服务器的心跳检测就能正常连通了。

2. 使用Docker Host网络模式 #

如果你的微服务不需要隔离网络，或者可以接受端口直接映射到EC2主机，那启动容器时用host网络模式是最简单的方案——容器会直接复用EC2主机的网络栈，此时Ignite客户端的IP就是EC2主机的IP，完全避免容器私有IP的问题：

docker run --network host your-microservice-image:latest

注意：这种模式下容器的端口会直接占用主机的对应端口，要提前确认没有端口冲突。

3. 确认客户端连接服务器的地址配置 #

既然你用S3做服务发现，还要确保客户端连接服务器时指定的是服务器的可访问IP，而不是localhost或者容器内部地址。在客户端的连接配置里明确指定Ignite服务器的EC2 IP：

ClientConfiguration clientCfg = new ClientConfiguration();
// 替换成Ignite服务器的EC2内网/公网IP，默认客户端端口是10800
clientCfg.setAddresses("172.31.YY.YY:10800");

4. 检查AWS网络权限配置 #

别漏掉AWS的安全组和网络ACL配置，这是很多人容易忽略的点：

• Ignite服务器的安全组要允许来自容器所在EC2主机IP段的入站流量，开放Ignite常用端口：11211（缓存端口）、47100（节点通信）、47500（节点发现）、10800（客户端连接）
• 容器所在EC2主机的安全组要允许出站访问上述端口
• 如果用了VPC，对应的网络ACL要双向放行这些端口的流量

5. 验证客户端注册的IP是否正确 #

最后可以在Ignite服务器上用自带的control.sh工具检查已注册的客户端节点，确认IP是否是你配置的可访问地址：

# 进入Ignite安装目录执行
./control.sh --clients

如果输出里还是容器的私有IP，说明客户端的配置没有生效，要检查配置文件是否被正确加载，或者有没有代码层面的配置覆盖。

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