一款基于SpringCloud、SpringBoot3、Netty、MyBatis-Plus和RocketMQ构建的即时通讯系统服务端
gitee：
微信: 
🖥️ 客户端：github HuLa-Server | gitee HuLa-Server
English | 中文
HuLa-Server 是一款基于 SpringCloud、SpringBoot3、Netty、MyBatis-Plus 和 RocketMQ 构建的高性能即时通讯系统服务端。它采用了微服务架构设计，提供高性能的实时通信能力，支持单聊、群聊、消息推送等核心功能。系统具有高可扩展性和可靠性，适用于各类即时通讯场景。
-
模块化与高内聚: 服务按功能拆分为独立模块（网关、认证、IM、AI、ws、base、system、presence等），通过清晰隔离，降低耦合度，提升开发与维护效率。
-
弹性扩展能力: webflux异步架构，基于Spring Cloud 2024 & Spring Boot 3.x构建，支持动态扩缩容。如luohuo-gateway可通过增加节点应对高并发流量。
-
技术栈统一管理: luohuo-dependencies-parent集中管控依赖版本，避免冲突，提升协作效率。
-
Redis: 高性能的内存数据库，用于存储用户会话信息、消息缓存等数据，提供了高速的数据访问能力。
-
MySQL: 可靠的关系型数据库，用于存储用户信息、消息记录等持久化数据。
-
Netty: Reactor 线程模型，高并发连接管理，零拷贝优化，支持实时消息推送。
-
RocketMQ: 高性能消息中间件，各项服务之间解耦的关键，im场景下实现事务消息保障、顺序消费
- Spring AI: 统一的AI接口抽象层，支持多平台切换
- Gitee AI: 魔力方舟AI平台，支持对话、图片、音频、视频生成
- 硅基流动: 国产AI平台，提供多模态AI能力
- OpenAI/DeepSeek/Kimi: 主流AI大模型集成
-
网关层：luohuo-gateway实现路由鉴权，支持OAuth2.0安全认证，SA-Token权限框架 + XSS过滤（luohuo-xss-starter）保障系统安全。
-
通信层：WebFlux + Netty 异步模型，基于Reactor响应式编程模型，用户在线状态指纹级别映射，实时消息推送低延迟。
-
数据层：MyBatis-Plus + Dynamic Datasource支持多租户分库分表。
luohuo-ai 模块提供强大的多模态AI能力，支持文生图、文生音、文生视频等功能，深度集成多个国内外主流AI平台
🇨🇳 国内平台
- Gitee AI (魔力方舟) - 支持对话、图片生成、音频生成、视频生成
- 硅基流动 (SiliconFlow) - 支持对话、图片生成、音频生成、视频生成
- Kimi (月之暗面) - 支持对话
- DeepSeek - 支持对话
- 通义千问 (阿里) - 支持对话、图片生成
- 文心一言 (百度) - 支持对话、图片生成
- 智谱 AI - 支持对话、图片生成
- 讯飞星火 - 支持对话
- 豆包 (字节) - 支持对话
- 混元 (腾讯) - 支持对话
- MiniMax (稀宇科技) - 支持对话
- 百川智能 - 支持对话
🌍 国外平台
- OpenAI - 支持对话、图片生成
- OpenRouter - 支持对话
- Ollama - 支持对话
- Stable Diffusion - 支持图片生成
- Midjourney - 支持图片生成
- Suno AI - 支持音乐生成
💬 智能对话
- 多平台对话模型统一接口
- 支持流式响应和普通响应
- 工具调用能力 (Function Calling)
- 对话历史管理
- 上下文记忆
🎨 文生图 (Text-to-Image)
- 支持多种图片生成模型
- 自定义图片尺寸、风格
- 异步任务处理
- 图片存储管理
🎵 文生音 (Text-to-Speech)
- 多音色选择
- 语速调节
- 多种音频格式输出 (MP3、WAV等)
- 异步音频生成
- 音频文件存储
🎬 文生视频 (Text-to-Video)
- 文本描述生成视频
- 异步任务提交
- 视频生成状态轮询
- 视频存储管理
- 支持 OpenRouter、Kimi、GiteeAI、硅基流动等平台
🎼 AI音乐生成
- Suno AI 音乐创作
- 描述模式和歌词模式
- 自定义音乐风格
- 音乐任务管理
- 统一抽象接口: 通过
ChatModel、ImageModel、AudioModel、VideoModel等接口统一不同平台的调用方式 - 工厂模式:
AiModelFactory动态创建和管理不同平台的模型实例 - 异步处理: 图片、音频、视频生成采用异步任务处理，提升用户体验
- 状态管理: 完善的任务状态追踪机制
- 资源管理: 统一的文件存储和管理
- 工作流支持: 集成 TinyFlow 工作流引擎，支持复杂AI业务场景
🔐 API网关 | 🛡️ 安全防护 | 🔄 服务路由
- 路由转发： 智能路由到后端微服务
- 统一鉴权： JWT令牌验证与权限检查
- 服务发现： 集成nacos实现动态服务发现
- 流量控制： 限流、熔断、降级保护
- 安全过滤： XSS防护、SQL注入防护
- 日志记录： 请求日志、审计日志
🏢 租户管理 | 👥 组织架构 | 🔧 资源中心
- 多租户架构： 支持多租户数据隔离
- 组织管理： 部门、岗位、职级管理
- 角色权限： RBAC权限模型，细粒度控制
- 应用模块： 统一应用管理平台
- 多方式登录： 账号密码、手机验证码、邮箱、扫码登录
- 动态二维码： 实时生成扫码登录二维码
- 令牌颁发： Token、RefreshToken生成
- 会话管理： 分布式会话存储与验证
- 权限控制： 基于角色的细粒度权限管理
👥 即时通讯 | 🏘️ 群组管理 | 💾 消息存储
- 消息管理： 单聊/群聊消息存储与转发
- 群组管理： 创建群组、成员管理、权限控制
- 好友关系： 好友添加、删除、黑名单管理
- 会话管理： 会话列表、置顶、消息状态
🟢 状态追踪 | 📊 实时统计 | 🔔 状态推送
- 用户状态： 实时追踪在线/离线状态
- 群组统计： 群成员在线情况统计
🔗 长连接管理 | 🚀 实时推送 | 📞 音视频通话
- 连接管理： 建立与维护会话的指纹级映射，宕机自动重连机制
- WebFlux异步架构： 基础netty，提升并发性能
- 消息路由： 智能消息路由到目标客户端, 配合指纹机映射解决消息风暴
- P2P通话，SRS直连： WebRTC一对一音视频通话
🖥️ 系统管理 | 📈 数据统计 | 🔍 监控审计
- 系统配置： IM系统参数配置管理
- 用户管理： 用户信息维护、封禁解封
- 数据统计： 用户活跃度、消息量统计
- 系统监控： 服务健康状态监控
- 内容审计： 消息内容安全审计过滤
🎨 多模态AI | 🧠 智能对话 | 🎬 内容生成
- 智能对话： 集成20+主流AI平台，支持流式对话、工具调用
- 文生图： 支持 Midjourney、Stable Diffusion、通义万相等多平台图片生成
- 文生音： TTS语音合成，支持多音色、多语速、多格式
- 文生视频： 文本描述生成视频，支持 Kimi、Gitee AI、硅基流动、OpenRouter等平台
- 模型管理： 统一的模型配置、额度管理、使用统计 [部分Ai模型]
- 工作流引擎： TinyFlow 工作流支持，编排复杂AI业务场景
- 客户端发送消息到网关
- 网关路由到对应的IM服务
- IM服务进行消息持久化
- 调用IM内部PushService进行消息分发
- PushService查询路由表, 获取目标用户所在的WS节点
- 获取节点-设备-用户映射关系
- 直接分发到各WS节点的专属主题
- 目标WS节点消费分发过来的主题消息
- 查找本地会话映射表
- 推送消息到具体客户端
- 客户端返回ACK确认
- 更新消息状态为已送达
| 指标 | 广播模式 | 精准路由模式 | 提升倍数 | 性能指标 | 说明 |
|---|---|---|---|---|---|
| 网络消息数 | O(N) | O(k) | 10-100倍 | - | |
| CPU消耗 | 高 | 低 | 5-20倍 | 高并发下CPU<70% | |
| 内存占用 | 全节点缓存 | 仅目标节点 | 3-10倍 | 单连接<50KB | |
| 延迟时间 | 不稳定 | 稳定低延迟 | 2-5倍 | 平均<50ms |
- 用户增长： 增加用户不会增加单个消息的复杂度
- 节点扩展： 增加节点不会增加单消息的推送成本
- 流量增长： 系统吞吐量随节点数线性增长
- 即时通讯：支持单聊、群聊、消息推送等基础通讯功能
- 消息管理：支持消息存储、历史记录查询、消息撤回等功能
- 用户系统：提供用户注册、登录、个人信息管理等功能
- 群组管理：支持群组创建、成员管理、群公告等功能
- 好友系统：支持好友添加、删除、分组等功能
- 消息通知：支持离线消息、系统通知等功能
- 朋友圈：支持朋友圈发布、点赞、评论、转发等功能
持续开发中...
- 本项目是作为一款开源项目提供的，开发者在法律允许的范围内不对软件的功能性、安全性或适用性提供任何形式的明示或暗示的保证
- 用户明确理解并同意，使用本软件的风险完全由用户自己承担，软件以"现状"和"现有"基础提供。开发者不提供任何形式的担保，无论是明示还是暗示的，包括但不限于适销性、特定用途的适用性和非侵权的担保
- 在任何情况下，开发者或其供应商都不对任何直接的、间接的、偶然的、特殊的、惩罚性的或后果性的损害承担责任，包括但不限于使用本软件产生的利润损失、业务中断、个人信息泄露或其他商业损害或损失
- 所有在本项目上进行二次开发的用户，都需承诺将本软件用于合法目的，并自行负责遵守当地的法律和法规
- 开发者有权在任何时间修改软件的功能或特性，以及本免责声明的任何部分，并且这些修改可能会以软件更新的形式体现
本免责声明的最终解释权归开发者所有
如果您觉得HuLa对您有帮助，欢迎赞助HuLa，您的支持是我们不断前进的动力
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---|---|---|---|
| 2025-09-12 | 翟可 | ¥1688 |
 |
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---|---|---|---|
| 2025-09-03 | 烛火 | ¥500 |
|
| 2025-09-05 | Orion | ¥200 |
|
| 2025-08-26 | 唐勇 | ¥200 |
|
| 2025-04-25 | 上官俊斌 | ¥200 |
|
| 2025-05-27 | 临安居士 | ¥188 |
|
| 2025-04-20 | 姜兴(Simon) | ¥188 |
|
| 2025-02-17 | 禾硕 | ¥168 |
 |
| 2025-08-13 | zhongjing | ¥100 |
|
| 2025-07-15 | 粉兔 | ¥100 |
|
| 2025-02-8 | Boom.... | ¥100 |
|
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---|---|---|---|
| 2025-06-26 | m udDy🐖 | ¥88 |
|
| 2025-05-09 | 犹豫，就会败北。 | ¥88 |
|
| 2025-04-01 | 墨 | ¥88.88 |
|
| 2025-02-8 | 邓伟 | ¥88 |
|
| 2025-02-7 | dennis | ¥80 |
 |
| 2025-02-6 | 小二 | ¥62 |
|
| 2025-05-15 | 孤鸿影 | ¥56 |
|
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---|---|---|---|
| 2025-08-12 | *持 | ¥20 |
|
| 2025-06-03 | 洪流 | ¥20 |
|
| 2025-05-27 | 刘启成 | ¥20 |
|
| 2025-05-20 | 匿名赞助者 | ¥20 |
|
