海狸IM 2.1 更新解读:技术栈与功能模块梳理
关键词:开源即时通讯、私有化部署、企业 IM、音视频通话、朋友圈、圈子、工作台、OAuth 授权登录
海狸IM 是一款基于 MIT 协议开源、支持私有化部署的即时通讯(IM)平台。根据官方更新公告,2.1 已完成多端联调并推送代码,覆盖桌面端、移动端、管理后台、开放平台、OAuth 授权页与服务端。本文基于官方公告与真实桌面端截图,梳理 2.1 的技术栈与主要功能。
一、海狸IM 是什么?
- 开源免费:MIT 协议,可商用、可私有化、可二开;
- 私有化部署:服务与数据全部跑在你自己的服务器,数据自主可控;
- 多端覆盖:桌面端(Windows / macOS / Linux)、移动端(Android / iOS)、管理后台,一套账号多端实时同步;
- 开放生态:独立开放平台(beaver-open)+ 统一 OAuth 授权页(beaver-oauth),支持机器人 / Webhook / 事件订阅;
- 消息可靠:官方文档提及 TCP + ACK 消息必达、端到端加密传输、消息永久存储、多端实时同步。
一句话总结:海狸IM 是一个能私有化部署、数据自主可控、不绑定商业厂商的全平台开源 IM。
二、技术栈(TECH STACK)
海狸IM 后端采用 Go + Go-Zero 微服务架构 ,按业务拆分为 user / auth / friend / chat / ws / group / file / emoji / gateway / moment / system / config / feedback / track / update 等十余个独立服务,每个服务预留独立端口,便于多实例水平扩展。完整技术选型如下:
| 层 | 技术 | 说明 |
|---|---|---|
| 语言 / 框架 | Go 1.24 + Go-Zero 1.7 | 微服务 API / RPC |
| 通信 | gRPC、WebSocket、RocketMQ | 服务间调用与实时消息推送 |
| 实时通信 | WebSocket | 长连接实时推送,消息不延迟 |
| 音视频 | LiveKit | 私聊 / 群聊音视频通话 |
| 存储 | MySQL 8.0、Redis 6.0 | 多库拆分 + 缓存会话 |
| 服务发现 | ETCD 3.5 | 服务注册与发现 |
| 消息队列 | RocketMQ | 异步解耦、消息投递 |
| 基础设施 | Docker | 一键编排部署 |
| 桌面端 | Electron + Vue 3 | 跨平台桌面客户端 |
| 移动端 | Flutter | Android / iOS 跨端 |
| 管理后台 | Vue 3 + Element Plus | 运营管理后台 |
| 开放平台 / OAuth | beaver-open / beaver-oauth | 应用配置、授权登录、Webhook |
技术栈均取自 beaver-server 官方 README 与
go.mod/docker-compose.yml。可私有化部署:一条docker-compose up即可拉起 MySQL / Redis / ETCD / LiveKit / RocketMQ 全套依赖,开箱即用。
三、2.1 版本速览(来自官方更新公告)
| 端 | 版本 | 仓库 |
|---|---|---|
| PC 桌面端(beaver-desktop) | v2.1.0 | github.com/wsrh8888/beaver-desktop |
| 移动端(beaver-flutter) | v2.1.1 | github.com/wsrh8888/beaver-flutter |
| 后台管理(beaver-manager) | v2.1.1 | github.com/wsrh8888/beaver-manager |
| 开放平台(beaver-open) | v2.1.1 | github.com/wsrh8888/beaver-open |
| OAuth 授权页(beaver-oauth) | v2.1.1 | github.com/wsrh8888/beaver-oauth |
| 服务端(beaver-server) | v2.1.1 | github.com/wsrh8888/beaver-server |
下面各节均配上真实桌面端界面截图。
四、登录体系:密码、扫码,以及 OAuth 授权码登录
2.1 重构了登录体系:桌面端接入 js-sdk,支持密码登录、扫码登录,以及 OAuth 授权码登录;移动端配合 PC 端与开放平台完成扫码确认;服务端补齐了多端登录的设备登记与管理、扫码登录、OAuth 登录。


关于授权登录:第三方网站或应用可跳转 beaver-oauth 统一授权页,通过扫码或密码登录完成授权并换取 Token;移动端 App 扫码确认即可完成登录。这一能力由 beaver-oauth 统一授权页与开放平台共同支撑。
五、私聊 & 群聊:把沟通效率拉满
2.1 的聊天能力完善了不少:富文本编辑、引用回复 、合并转发 、Markdown 消息、语音播放;群聊侧则是群详情重构、群通知机器人(Webhook)、安全设置,还支持群聊分享(链接 / 名片)。
桌面端消息主界面:

Markdown 消息(技术团队直接在聊天里贴代码、表格、待办):

语音消息与视频预览:


引用回复、合并转发、多选:



私聊 / 群聊详情:


群通知机器人(Webhook):给群添加自动化通知能力,对接你的业务系统事件。


群聊分享(链接 / 名片),方便把群扩散出去:


表情商店与收藏:


六、音视频通话:基于 LiveKit,私聊 / 群聊都能打
2.1 的音视频通话由 LiveKit 提供支撑,支持私聊与群聊通话;移动端还支持来电横幅,桌面与手机端互通。

七、朋友圈:独立窗口 + 实时互动
2.1 的朋友圈是独立窗口,支持发布互动、通知红点实时同步。





八、好友 & 群组:从添加到入群的全链路
好友侧支持加好友、好友列表、好友详情与申请;群组侧支持建群、群成员管理、入群申请。



创建群聊:

九、圈子:围绕兴趣 / 项目的社区
圈子是海狸IM 里围绕兴趣、项目或部门组成的社区模块,可发帖、评论,并通过二维码、链接或名片邀请成员------是团队知识沉淀与兴趣运营的载体。








十、工作台:把 Web 应用搬进 IM
桌面端内置工作台应用中心,可嵌入第三方 Web 应用(下图示例为嵌入"百度")。结合开放平台的 OAuth 应用配置,工作台里的应用可以走统一的授权登录,减少反复登录。


十一、管理后台与开放平台(后台能力一览)
除了桌面端,海狸IM 2.1 还配套了完整的运营与管理能力(以下为后台能力,本篇以桌面端截图为主,未展示后台界面):
- 运营工作台:数据概览、待办收件箱、趋势统计;
- 用户 360:用户全貌、封禁解封;
- 连接监控:在线用户汇总、PC / 移动端分布、登录设备详情;
- 消息审计:消息检索、会话审计、批量处置;
- 内容安全:举报工单、敏感词库、审核案件;
- 开放生态:开发者审核、应用审核、Webhook 日志;
- 版本发布:应用 / 架构 / 版本 / 灰度策略;
- 资源管理:文件存储、表情包管理。
开放平台(beaver-open)已上线开发者门户、应用配置(凭证 / OAuth 登录 / 权限 Scope)、机器人能力(智能机器人 + Incoming Webhook)、事件订阅(Webhook 回调)与安全设置(IP 白名单、可信域名)。beaver-oauth 提供统一 OAuth 授权登录页 与扫码引导页,与开放平台、PC 端、移动端三方联调打通。
十二、个人中心 & 设置
个人资料随手编辑;设置中心为独立窗口,支持设备管理(在线状态 / 踢下线)、快捷键自定义上云、检查更新,以及开源致谢页。






十三、总结:海狸IM 2.1 适合谁?
| 角色 | 能获得什么 |
|---|---|
| 开发者 | MIT 开源、Go 微服务、可私有化、可二开 |
| 中小企业 | 免费可用的企业 IM,数据自己掌控 |
| 社群 / 运营 | 朋友圈 + 圈子,做私域与兴趣社区 |
| 管理层 / 运维 | 管理后台:用户 360、消息审计、连接监控、内容安全 |
| 开放集成方 | 开放平台 + beaver-oauth,机器人 / Webhook / 事件订阅 |
相关资源
- 官方文档:https://wsrh8888.github.io/beaver-docs/
- 后端(beaver-server):https://github.com/wsrh8888/beaver-server
- 移动端(beaver-flutter):https://github.com/wsrh8888/beaver-flutter
- 桌面端(beaver-desktop):https://github.com/wsrh8888/beaver-desktop
- 管理后台(beaver-manager):https://github.com/wsrh8888/beaver-manager
- OAuth(beaver-oauth):https://github.com/wsrh8888/beaver-oauth
- 开放平台(beaver-open):https://github.com/wsrh8888/beaver-open
下一篇《深度体验海狸IM 2.1》会从真实使用视角聊聊它到底好不好用。