# HuLa-Server
**Repository Path**: mmoapg/HuLa-Server
## Basic Information
- **Project Name**: HuLa-Server
- **Description**: ☕️ HuLa 服务端，基于Spring AI、SpringCloud Alibaba、SpringBoot3、Netty、MyBatis-Plus 和 RocketMQ 构建的高性能即时通讯系统服务
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://hulaspark.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 179
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-17
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
一款基于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 服务）
| 指标 | 广播模式 | 精准路由模式 | 提升倍数 | 性能指标 | 说明 |
|:--- |:---:|:------------------:|---:|-------------------:|--------------------------:|
| **网络消息数** | O(N) | O(k) | 10-100倍 | - | |
| **CPU消耗** | 高 | 低 | 5-20倍 | 高并发下CPU<70% | |
| **内存占用** | 全节点缓存 | 仅目标节点 | 3-10倍 | 单连接<50KB | |
| **延迟时间** | 不稳定 | 稳定低延迟 | 2-5倍 | 平均<50ms | |
## 🚀 系统扩展性 - 线性扩展能力
- **用户增长：** 增加用户不会增加单个消息的复杂度
- **节点扩展：** 增加节点不会增加单消息的推送成本
- **流量增长：** 系统吞吐量随节点数线性增长
## 客户端预览
## 核心功能
- 即时通讯：支持单聊、群聊、消息推送等基础通讯功能
- 消息管理：支持消息存储、历史记录查询、消息撤回等功能
- 用户系统：提供用户注册、登录、个人信息管理等功能
- 群组管理：支持群组创建、成员管理、群公告等功能
- 好友系统：支持好友添加、删除、分组等功能
- 消息通知：支持离线消息、系统通知等功能
- 朋友圈：支持朋友圈发布、点赞、评论、转发等功能
持续开发中...
## 免责声明
1. 本项目是作为一款开源项目提供的，开发者在法律允许的范围内不对软件的功能性、安全性或适用性提供任何形式的明示或暗示的保证
2. 用户明确理解并同意，使用本软件的风险完全由用户自己承担，软件以"现状"和"现有"基础提供。开发者不提供任何形式的担保，无论是明示还是暗示的，包括但不限于适销性、特定用途的适用性和非侵权的担保
3. 在任何情况下，开发者或其供应商都不对任何直接的、间接的、偶然的、特殊的、惩罚性的或后果性的损害承担责任，包括但不限于使用本软件产生的利润损失、业务中断、个人信息泄露或其他商业损害或损失
4. 所有在本项目上进行二次开发的用户，都需承诺将本软件用于合法目的，并自行负责遵守当地的法律和法规
5. 开发者有权在任何时间修改软件的功能或特性，以及本免责声明的任何部分，并且这些修改可能会以软件更新的形式体现
**本免责声明的最终解释权归开发者所有**
## 赞助HuLa
如果您觉得HuLa对您有帮助，欢迎赞助HuLa，您的支持是我们不断前进的动力
## 💬 加入社区
🤝 HuLa 社区讨论群
与开发者和用户一起交流讨论，获取最新资讯和技术支持
## 🙏 感谢赞助者
贡献者荣誉榜
感谢以下朋友对 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](https://github.com/HuLaSpark/HuLa-Server/issues) | 📧 邮箱: `2439646234@qq.com` | 💬 微信: `cy2439646234`
---
## 📄 开源许可
⚖️ 许可证信息
本项目遵循开源许可协议，详细信息请查看上方许可证报告
---
🌟 感谢您的关注
如果您觉得 HuLa 有价值，请给我们一个 ⭐ Star，这是对我们最大的鼓励！
让我们一起构建更好的即时通讯体验 🚀
