github.com/HuLaSpark/HuLa-Server @v3.0.7

一款基于SpringCloud、SpringBoot3、Netty、MyBatis-Plus和RocketMQ构建的即时通讯系统服务端

gitee： github： gitcode：

微信:

🖥️ 客户端：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场景下实现事务消息保障、顺序消费

AI能力

• 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支持多租户分库分表。

🤖 AI与IM深度集成

🎨 多模态AI能力

luohuo-ai 模块提供强大的多模态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业务场景

🏗️系统架构

🚪 luohuo-gateway - 网关服务

🔐 API网关 | 🛡️ 安全防护 | 🔄 服务路由 - 路由转发： 智能路由到后端微服务 - 统一鉴权： JWT令牌验证与权限检查 - 服务发现： 集成nacos实现动态服务发现 - 流量控制： 限流、熔断、降级保护 - 安全过滤： XSS防护、SQL注入防护 - 日志记录： 请求日志、审计日志

🏗️ luohuo-base - 基础服务

🏢 租户管理 | 👥 组织架构 | 🔧 资源中心 - 多租户架构： 支持多租户数据隔离 - 组织管理： 部门、岗位、职级管理 - 角色权限： RBAC权限模型，细粒度控制 - 应用模块： 统一应用管理平台

🔐 luohuo-oauth - 认证服务

• 多方式登录： 账号密码、手机验证码、邮箱、扫码登录
• 动态二维码： 实时生成扫码登录二维码
• 令牌颁发： Token、RefreshToken生成
• 会话管理： 分布式会话存储与验证
• 权限控制： 基于角色的细粒度权限管理

💬 luohuo-im - IM业务服务

👥 即时通讯 | 🏘️ 群组管理 | 💾 消息存储 - 消息管理： 单聊/群聊消息存储与转发 - 群组管理： 创建群组、成员管理、权限控制 - 好友关系： 好友添加、删除、黑名单管理 - 会话管理： 会话列表、置顶、消息状态

📡 luohuo-presence - 在线状态服务

🟢 状态追踪 | 📊 实时统计 | 🔔 状态推送 - 用户状态： 实时追踪在线/离线状态 - 群组统计： 群成员在线情况统计

📶 luohuo-ws - websocket服务

🔗 长连接管理 | 🚀 实时推送 | 📞 音视频通话 - 连接管理： 建立与维护会话的指纹级映射，宕机自动重连机制 - WebFlux异步架构： 基础netty，提升并发性能 - 消息路由： 智能消息路由到目标客户端, 配合指纹机映射解决消息风暴 - P2P通话，SRS直连： WebRTC一对一音视频通话

⚙️ luohuo-system - 后台服务

🖥️ 系统管理 | 📈 数据统计 | 🔍 监控审计 - 系统配置： IM系统参数配置管理 - 用户管理： 用户信息维护、封禁解封 - 数据统计： 用户活跃度、消息量统计 - 系统监控： 服务健康状态监控 - 内容审计： 消息内容安全审计过滤

🤖 luohuo-ai - AI服务

🎨 多模态AI | 🧠 智能对话 | 🎬 内容生成 - 智能对话： 集成20+主流AI平台，支持流式对话、工具调用 - 文生图： 支持 Midjourney、Stable Diffusion、通义万相等多平台图片生成 - 文生音： TTS语音合成，支持多音色、多语速、多格式 - 文生视频： 文本描述生成视频，支持 Kimi、Gitee AI、硅基流动、OpenRouter等平台 - 模型管理： 统一的模型配置、额度管理、使用统计 [部分Ai模型] - 工作流引擎： TinyFlow 工作流支持，编排复杂AI业务场景

📊 消息执行流程步骤详解

1. 客户端发送消息到网关
2. 网关路由到对应的IM服务
3. IM服务进行消息持久化
4. 调用IM内部PushService进行消息分发
5. PushService查询路由表, 获取目标用户所在的WS节点
6. 获取节点-设备-用户映射关系
7. 直接分发到各WS节点的专属主题
8. 目标WS节点消费分发过来的主题消息
9. 查找本地会话映射表
10. 推送消息到具体客户端
11. 客户端返回ACK确认
12. 更新消息状态为已送达

🌐 性能对比 （WS 服务）

🚀 系统扩展性 - 线性扩展能力

• 用户增长： 增加用户不会增加单个消息的复杂度
• 节点扩展： 增加节点不会增加单消息的推送成本
• 流量增长： 系统吞吐量随节点数线性增长

客户端预览

核心功能

• 即时通讯：支持单聊、群聊、消息推送等基础通讯功能
• 消息管理：支持消息存储、历史记录查询、消息撤回等功能
• 用户系统：提供用户注册、登录、个人信息管理等功能
• 群组管理：支持群组创建、成员管理、群公告等功能
• 好友系统：支持好友添加、删除、分组等功能
• 消息通知：支持离线消息、系统通知等功能
• 朋友圈：支持朋友圈发布、点赞、评论、转发等功能

持续开发中...

免责声明

1. 本项目是作为一款开源项目提供的，开发者在法律允许的范围内不对软件的功能性、安全性或适用性提供任何形式的明示或暗示的保证
2. 用户明确理解并同意，使用本软件的风险完全由用户自己承担，软件以"现状"和"现有"基础提供。开发者不提供任何形式的担保，无论是明示还是暗示的，包括但不限于适销性、特定用途的适用性和非侵权的担保
3. 在任何情况下，开发者或其供应商都不对任何直接的、间接的、偶然的、特殊的、惩罚性的或后果性的损害承担责任，包括但不限于使用本软件产生的利润损失、业务中断、个人信息泄露或其他商业损害或损失
4. 所有在本项目上进行二次开发的用户，都需承诺将本软件用于合法目的，并自行负责遵守当地的法律和法规
5. 开发者有权在任何时间修改软件的功能或特性，以及本免责声明的任何部分，并且这些修改可能会以软件更新的形式体现

本免责声明的最终解释权归开发者所有

赞助HuLa

如果您觉得HuLa对您有帮助，欢迎赞助HuLa，您的支持是我们不断前进的动力

💬 加入社区

🤝 HuLa 社区讨论群

与开发者和用户一起交流讨论，获取最新资讯和技术支持

<img src="https://github.com/HuLaSpark/HuLa-Server/raw/v3.0.7/preview/wx.png" width="260" height="340" alt="微信群二维码">
<img src="https://github.com/HuLaSpark/HuLa-Server/raw/v3.0.7/preview/qq.jpg" width="260" height="340" alt="QQ群二维码">

🙏 感谢赞助者

贡献者荣誉榜

感谢以下朋友对 HuLa 项目的慷慨支持！

💎 钻石赞助者 (￥1000+)

💝 日期	👤 赞助者	💰 金额	🏷️ 平台
2025-09-12	翟可	¥1688

🏆 金牌赞助者 (￥100+)

💝 日期	👤 赞助者	💰 金额	🏷️ 平台
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

🥈 银牌赞助者 (￥50-99)

💝 日期	👤 赞助者	💰 金额	🏷️ 平台
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

🥉 铜牌赞助者 (￥20-49)

💝 日期	👤 赞助者	💰 金额	🏷️ 平台
2025-08-12	*持	¥20
2025-06-03	洪流	¥20
2025-05-27	刘启成	¥20
2025-05-20	匿名赞助者	¥20

📝 温馨提示 该名单为手动更新，如果您已赞助但未在列表中，请联系我们： 🐛 GitHub Issue | 📧 邮箱: 2439646234@qq.com | 💬 微信: cy2439646234

📄 开源许可

⚖️ 许可证信息

<a href="https://app.fossa.com/projects/git%2Bgithub.com%2FHuLaSpark%2FHuLa?ref=badge_large">
  <img src="https://app.fossa.com/api/projects/git%2Bgithub.com%2FHuLaSpark%2FHuLa.svg?type=large" alt="FOSSA Status" style="max-width: 100%; border-radius: 8px;">
</a>

本项目遵循开源许可协议，详细信息请查看上方许可证报告

🌟 感谢您的关注

<em>如果您觉得 HuLa 有价值，请给我们一个 ⭐ Star，这是对我们最大的鼓励！</em>






<strong>让我们一起构建更好的即时通讯体验 🚀</strong>