Akka Cluster配置bind-port/bind-hostname及Nginx转发异常求助

错误原因分析 #

错误日志显示Akka收到发往akka.tcp://cliActorSystem@127.0.0.1:9990的消息，但自身仅识别绑定的akka.tcp://cliActorSystem@127.0.0.1:9998作为入站地址，导致消息被判定为非本地接收方而丢弃。核心问题是Akka的外部暴露地址配置与Nginx代理端口不匹配，且客户端调用地址未同步更新。

修正配置步骤 #

1. 调整Akka远程配置 #

将Akka的外部逻辑地址（客户端访问的地址）与Nginx监听端口对齐，确保Akka能识别外部代理后的地址：

akka {
  log-dead-letters = on
  jvm-exit-on-fatal-error = on
  actor {
    provider = "akka.cluster.ClusterActorRefProvider"
  }
  remote {
    log-remote-lifecycle-events = on
    netty.tcp {
      hostname = akka.hostname.com      # 外部访问的域名
      port = 9990                      # Nginx监听的端口
      bind-hostname = 172.24.0.162     # Akka实际绑定的内部IP
      bind-port = 9998                 # Akka实际绑定的内部端口
    }
  }
}

2. 修正Nginx Stream配置 #

确保Nginx转发到Akka实际绑定的内部IP和端口（而非127.0.0.1，除非Akka绑定了本地回环）：

stream {
upstream akka_proxy {
hash $remote_addr consistent;
server 172.24.0.162:9998 ;  # 指向Akka实际绑定的地址
}
server {
listen 9990;  # 外部访问的端口
proxy_connect_timeout 5s;
proxy_timeout 20s;
proxy_pass akka_proxy;
}
}

3. 更新客户端调用路径 #

客户端需使用外部域名和Nginx端口发起远程调用：

val path = s"akka.tcp://cliActorSystem@akka.hostname.com:9990/user/"  
actorSystem.actorSelection(path)

验证要点 #

• 确保客户端能解析akka.hostname.com到Nginx所在服务器的IP
• 检查Nginx和Akka服务重启后端口监听正常
• 查看Akka日志，确认入站地址包含akka.tcp://cliActorSystem@akka.hostname.com:9990

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