版本选择

生产环境版本选择

生产环境应使用 GitHub Releases 页面绿色 Latest 标记对应的最新正式发布版。

• 始终使用明确的稳定版 tag，不要依赖分支名称或手动猜测版本顺序。
• alpha、beta、rc 等预发布版本不应直接用于生产环境。
• OpenIMServer 与 ChatServer 一起部署时，应按 release note 选择相互对应的正式版 tag。
• OpenIMClientSDK 接入时，应同时核对目标服务端版本范围和 release note，避免跨版本能力差异。
• 为便于问题复现、灰度回滚和多环境统一，应把所有组件 tag 记录在部署清单和回滚方案中。

查询最新正式版本

GitHub 的 releases/latest 会重定向到当前正式发布版，可用下面的命令读取 tag：

SERVER_LATEST_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/open-im-server/releases/latest)")
echo "$SERVER_LATEST_TAG"

CHAT_LATEST_TAG=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/openimsdk/chat/releases/latest)")
echo "$CHAT_LATEST_TAG"

固定版本后，在部署记录中同时保存 tag 和对应 release note 链接。不要在本页硬编码“当前最新版本”，否则页面会在新版本发布后立即过期。

查看发布说明

• OpenIMServer：OpenIMServer Releases
• ChatServer：ChatServer Releases
• OpenIMClientSDK：所用平台 SDK 仓库的 Releases 页面和 release note