跳到主要内容

🧩 平台及组件要求

一、名词约定

  • OpenIMSDK:项目统称,包含 OpenIMClientSDK 与 OpenIMServer。
  • OpenIMClientSDK:客户端 SDK。
  • OpenIMServer:IM 基础服务端。
  • ChatServer:业务扩展服务端,文档中不再使用 Chat 作为独立产品名称。
  • APP 管理员:调用管理类接口(如 10009)的后台管理角色。

二、版本与分支策略

  • main:开发版分支,用于持续集成未发布变更,不建议直接用于生产环境。
  • vX.Y.Z...:稳定版发布版本命名。
  • 生产环境建议优先使用 GitHub Releases 页面绿色 Latest 对应的最新正式发布版
  • 如需问题复现、灰度回滚或多环境统一,请固定到明确的稳定版本 tag。

三、环境要求

注意事项详细说明补充说明
操作系统Linux官方使用 ubuntu 22.04,实测 Debian 13 也可运行
硬件资源8核16G,10M带宽,1T磁盘按 10 万注册用户、10% 日常在线、5 万大群、每秒 600 条消息估算;需有外网 IP
CPU 架构x86_64arm 架构需自行测试
Golangv1.22.7 或更高版本安装参考
Dockerv24.0.5 或更高版本自带 compose 功能
Gitv2.17.1 或更高版本安装参考

四、外部组件要求

组件建议版本支持模式支持云服务 / 备注
MongoDBv7.0standalonereplicaSetsharded支持;如接副本集或分片集群,建议优先使用 uri
Redisv7.0.0standaloneclustersentinel支持
Etcdv3.5.13单机、多节点集群不支持云服务
Kafkav3.5.1单机、分布式集群支持;需按文档预建 topic
MinIORELEASE.2024-01-11T07-46-16Z单机可替换为 S3 兼容存储(COSOSSKodo(社区维护)、AWS S3