Akka.NET集群从节点无法加入Docker部署的Lighthouse种子节点

故障由Akka.Remote集群地址校验不匹配+网络路由不可达共同导致：

• 本地业务节点配置的种子节点地址为akka.tcp://accountsystem@localhost:2551，但Docker容器内运行的Lighthouse实际对外宣告的集群合法地址是akka.tcp://accountsystem@accountsystem.lighthouse:2551，Akka集群通信会严格校验对端宣告的地址与请求目标地址是否一致，不匹配时会直接丢弃消息。
• 业务节点akka.remote.dot-netty.tcp.hostname配置为localhost，该地址仅对本地宿主机生效，Docker容器网络无法路由回这个地址，即使种子节点收到加入请求，响应包也无法传回业务节点。

1. 调整本地业务节点Akka配置 #

修正种子节点地址与节点自身宣告地址，保证两端网络可达、地址匹配：

akka {
  actor {
    provider = cluster
  }
  
  remote {
    log-remote-lifecycle-events = DEBUG
    dot-netty.tcp {
      # Docker Desktop环境直接用127.0.0.1，Linux环境替换为Docker网桥IP172.17.0.1
      hostname = "127.0.0.1"
      port = 0
      # 强制指定对外宣告的IP，避免被解析为容器无法访问的内网地址
      public-hostname = "127.0.0.1"
    }
  }

  cluster {
    # 种子节点地址必须和Lighthouse对外宣告的地址完全一致
    seed-nodes = [
      "akka.tcp://accountsystem@127.0.0.1:2551"]
  }
}

Linux部署Docker环境时，需将上述配置中所有127.0.0.1替换为172.17.0.1（Docker默认网桥地址），确保容器可路由回宿主机业务节点。

2. 调整Lighthouse的docker-compose配置 #

当前Lighthouse配置的CLUSTER_IP为容器内部主机名accountsystem.lighthouse，该地址仅能在docker-compose内部网络解析，本地宿主机无法识别，需调整环境变量让Lighthouse宣告宿主机可访问的地址：

version: '3'

services:
  accountsystem.lighthouse:
    image: petabridge/lighthouse:latest
    hostname: accountsystem.lighthouse
    ports:
      - '2551:2551'
    environment:
      ACTORSYSTEM: "accountsystem"
      CLUSTER_PORT: 2551
      # 监听所有网卡地址
      CLUSTER_IP: "0.0.0.0"
      # 对外宣告宿主机可访问的地址
      CLUSTER_PUBLIC_HOSTNAME: "127.0.0.1"
      CLUSTER_SEEDS: "akka.tcp://accountsystem@127.0.0.1:2551"

如果后续将业务节点也放入同一个docker-compose内部网络，只需将业务节点的seed-nodes改回akka.tcp://accountsystem@accountsystem.lighthouse:2551，同时将业务节点的CLUSTER_IP配置为自身服务名即可，无需走端口映射。

配置修改完成后重启Lighthouse与业务节点，Lighthouse日志中不再出现地址不匹配的丢包错误，业务节点侧会输出Node [akka.tcp://accountsystem@127.0.0.1:xxxxx] is JOINING日志，随后集群leader会将该节点标记为Up状态，集群加入流程完成。

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