出海与全球化

本页给出 NI PaaS 即时通讯在海外部署与全球化接入时的关键设计点：接入域名、时区与时间戳、多语言、数据驻留与合规、弱网与就近接入。

与参照站的关系

栏目位置对标参照站「出海指南」，内容为本项目自有实现约束。

接入与域名​

  • 客户端通过 baseUrl 连接；海外环境使用独立域名并配置 TLS 证书（见 域名）。
  • Web 端需允许跨域：服务端返回 Access-Control-Allow-Origin，凭据请求使用 credentials: include；
  • 就近接入：多地域部署时按用户所在地解析到最近网关，消息仍按会话维度保序（见 协议）。

时间与时区​

字段 / 场景约定说明
timestamp / sentTimeUnix 毫秒（int64，UTC）客户端按本地时区格式化展示
服务端日志UTC 存储，控制台按浏览器时区展示排障时以 UTC 对齐
定时任务（免打扰时段）客户端本地时区 + 服务端 UTC 换算跨时区用户以设备时区为准

多语言与文案​

  • 服务端错误码返回稳定的 code 与英文 message，客户端按 code 本地化；
  • view-model 文案通过 MsgKey 目录统一管理，按 code 与 MsgKey 做本地化；
  • IMKit 组件文案支持多语言覆盖，见 IMKit 多语言。

数据驻留与合规​

弱网与长连接​

跨境链路需关注 RTT 与丢包：SDK 内置指数退避重连、心跳与消息补发；建议按 弱网与重连 的参数调优，并用 性能与容量 的压测方法验证。