Flare IM

客户端接入

接入点

生产客户端经 signaling access-gateway 建立长连接：

ws://<gateway-host>:60051

本地默认与 flare-im-core-sdk 的 default_ws_url() 一致：

  1. SdkConfigOverlay.ws_url
  2. 环境变量 FLARE_IM_SERVER_URL
  3. ws://localhost:60051

SdkConfig 示例

SdkConfig::builder()
    .endpoint("ws://localhost:60051")
    .http_endpoint("http://localhost:50050")
    .capability_endpoint("http://localhost:50110")
    .online_endpoint("http://localhost:50061")
    .tenant_id("0")
    .build()

鉴权

  • 登录携带 JWT（或业务 Token），由网关与 route 校验
  • 开发环境可用 IMClient::generate_test_token
  • 生产应由业务鉴权服务签发，SDK 仅透传

传输

  • WebSocket：默认、兼容性最好
  • QUIC：低延迟场景，配置 quic_url 并与 flare-core 协议竞速

与 core-gateway 的区别

组件面向
signaling/gatewayIM 客户端长连接
flare-api-gateway业务后端 HTTP/gRPC 聚合

管理后台、Server-to-Server 调用走 core-gateway；聊天客户端连 signaling-gateway。

联调步骤

  1. deploy 起基础设施
  2. start_server.sh 起 access-gateway（60051）
  3. SDK login + sync_messages 验证 seq 递增

下一步