Turms即时通讯系统多端登录策略配置指南

多端登录策略概述

Turms即时通讯系统提供了灵活的多端登录策略配置，允许开发者根据业务需求设置不同的设备登录规则。系统默认支持多种策略模式，包括但不限于：

• 允许每种设备类型各有一个在线
• 仅允许单一设备在线
• 允许多设备同时在线

配置实现原理

Turms采用分布式配置管理机制，其配置分为全局属性和本地属性两个层级。对于turms.gateway.simultaneous-login.strategy这类关键参数，系统优先采用存储在MongoDB中的全局配置，本地配置仅在没有全局配置时生效。

配置方法详解

方法一：初始化配置

1. 删除MongoDB中的SharedClusterProperties集合
2. 重启turms-gateway服务
3. 系统会自动使用本地配置初始化全局配置

方法二：动态更新配置

1. 直接修改MongoDB中SharedClusterProperties集合的对应字段
2. 运行中的turms-gateway节点会自动检测并应用变更
3. 无需重启服务即可生效

方法三：使用管理API

通过调用PUT /cluster/settings管理接口，可以实时更新集群配置参数。这种方式适合需要自动化管理的生产环境。

典型应用场景

以"允许每种设备类型各有一个在线"策略为例：

1. 用户可以在桌面端和移动端同时登录
2. 同类型设备登录会触发前一个会话下线
3. 会话管理更加灵活，兼顾安全性和用户体验

注意事项

1. 配置变更后建议验证策略是否生效
2. 生产环境建议使用管理API进行配置变更
3. 不同策略可能影响会话管理和消息同步机制
4. 配置变更后需要关注系统日志确认变更已生效

通过合理配置多端登录策略，开发者可以在安全性和用户体验之间取得平衡，满足不同场景下的业务需求。