客户端连不上服务端的排查清单
按顺序过一遍，绝大多数连接问题都能定位到具体一环。
最后更新：2026-10-06
按顺序排查这六项
遇到连不上，先不要怀疑客户端，按下面顺序检查服务端与网络：
- 服务端窗口或 Docker 容器还在运行吗？直接运行时关闭窗口即停止服务
- 手机、电脑和服务器在同一个局域网（同一 Wi-Fi）吗？
- 服务器地址填对了吗？必须完整、包含 :9009 端口，这是最容易填错的一项
- 服务器防火墙是否放行了 9009 端口？
- 改过对外端口的话，客户端地址里的端口同步改了吗？
- 跨网络（不同局域网或严格防火墙）通话、传文件失败：确认已用 docker-compose-coturn.yaml 部署，并在后台启用 TURN 中继，同时放行 3478、49152-51199 等端口
注册时的常见填错项
注册流程是：打开 App → 点「没有账号？去注册」→ 填昵称、手机号、邮箱、密码 → 服务器地址填服务端显示的地址 → 同意协议 → 注册。
- 服务器地址必须完整填写并包含端口，示例 192.168.3.20:9009
- 服务端显示的「本机机器码」在需要设备绑定的场景会用到
- 注册完成后再加好友：右上角「+」→ 添加好友 → 输入对方手机号或邮箱 → 通过后即可聊天
常见问题
服务器地址为什么要带 :9009？
9009 是服务端监听的端口，地址不带端口时客户端不知道连哪里。这是注册时最容易填错的一项，必须完整填写。
局域网内能连上，外网访问不了怎么办？
检查宿主机防火墙与云安全组是否放行了 9009 端口，并确认使用的是服务器对外的地址而不是内网 IP。若涉及跨网络的通话与文件传输，还需要部署并启用 TURN 中继。