Unity中Nakama客户端无法连接OCI Linux VM实例的问题排查

1. Nakama服务绑定地址限制 #

• 问题：默认情况下Nakama可能仅绑定localhost（127.0.0.1），导致服务只能在虚拟机内部访问，外网请求无法到达。
• 解决：
  • 编辑Nakama配置文件（通常为nakama/config.yml），将server.http_address设为0.0.0.0:7350、server.socket_address设为0.0.0.0:7351（或直接绑定虚拟机公网IP）；也可以通过启动参数指定：nakama --server.http_address 0.0.0.0:7350 --server.socket_address 0.0.0.0:7351
  • 重启Nakama服务：如果用systemd管理，执行systemctl restart nakama；否则直接重启启动进程。

2. OCI网络配置遗漏 #

• 问题：仅开放安全列表端口不足以让公网流量到达虚拟机，需确认子网路由、公网IP配置是否完整。
• 解决：
  • 登录OCI控制台，进入虚拟机所在子网，检查路由表是否包含指向互联网网关的规则（目标0.0.0.0/0，下一跳为互联网网关）。
  • 确认虚拟机实例已分配公网IP：在实例详情的「资源」→「IP地址」中查看是否有公网IP条目。

3. 虚拟机本地防火墙拦截 #

• 问题：Linux虚拟机默认开启的firewalld/iptables可能阻挡端口，即使OCI安全列表已放行。
• 解决：
  • 临时关闭防火墙测试：CentOS/RHEL执行systemctl stop firewalld，Ubuntu执行ufw disable。若能连接，再永久开放端口：
    • CentOS/RHEL：firewall-cmd --add-port=7350/tcp --permanent、firewall-cmd --add-port=7351/tcp --permanent，然后firewall-cmd --reload
    • Ubuntu：ufw allow 7350/tcp、ufw allow 7351/tcp，再执行ufw reload

4. Unity客户端连接参数错误 #

• 问题：客户端可能误用内网IP、错误端口或协议不匹配。
• 解决：
  • 确保客户端连接地址填写虚拟机公网IP，端口对应正确：Nakama默认7350为REST/gRPC端口，7351为WebSocket端口，Unity客户端需根据使用的协议选择对应端口。
  • 示例正确的Unity连接代码片段：

    // REST API连接示例
    var client = new Nakama.Client("http://<你的公网IP>:7350");
    // WebSocket连接示例
    var socket = client.NewSocket();
    await socket.ConnectAsync("ws://<你的公网IP>:7351");
    

5. Nakama服务未正常启动或数据库连接失败 #

• 问题：若Nakama无法连接CockroachDB，服务会处于异常状态，无法响应客户端请求。
• 解决：
  • 查看Nakama日志：用systemd管理时执行journalctl -u nakama，或直接查看nakama/logs目录下的日志文件。
  • 检查日志中是否有数据库连接错误，确认CockroachDB服务正常运行，且Nakama配置中的数据库连接字符串（地址、端口、账号密码）正确。
  • 测试虚拟机内部连通性：执行curl http://localhost:7350/healthcheck，若返回{"status":"ok"}则服务本地正常；否则先修复服务启动问题。

6. 客户端网络或运营商限制 #

• 问题：客户端所在网络可能封禁7350/7351端口，或运营商限制公网访问。
• 解决：
  • 切换网络（如手机热点）测试Unity客户端连接，排除本地网络问题。
  • 在虚拟机上执行nc -lvp 7350监听端口，本地用telnet <公网IP> 7350测试连通性：若telnet失败，回到前面的网络配置排查；若成功，问题出在客户端或Nakama服务的协议配置。

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