---
## 为什么选择 JuggleChat？
大多数 IM 引擎解决的是消息收发问题，但一个真正可用的聊天产品还需要账号、好友、群组、登录和第三方服务等大量业务逻辑。JuggleChat 提供了客户端与 JuggleIM 之间开箱即用的业务层，帮助你更快交付完整的即时通讯产品，同时自主掌控基础设施和业务数据。
- **完整社交体验** — 账号、个人资料、好友申请、联系人、黑名单、群组、邀请、管理员、禁言和群公告。
- **多种登录方式** — 提供密码、短信、邮箱和二维码登录 API。
- **消息业务能力** — 消息撤回与删除、会话设置、业务通知和服务配置同步。
- **丰富扩展集成** — 兼容 S3 对象存储、MinIO、阿里云 OSS、七牛云、短信/邮件服务、翻译引擎、Telegram Bot 和 AI 助手回调。
- **全平台客户端** — 官方提供 Web、桌面、Android 和 iOS 客户端。
- **私有部署友好** — 基于 Go 与 MySQL，架构直观，并与开源 JuggleIM 服务无缝配合。
## 系统架构
```mermaid
flowchart LR
C[Web · Desktop · Android · iOS] -->|业务 API| A[JuggleChat Server]
C <-->|消息与实时事件| I[JuggleIM Server]
A -->|用户 · 群组 · 消息操作| I
A --> D[(MySQL)]
A -.-> S[对象存储 · 短信 · 邮件 · 翻译 · 机器人]
```
> 本仓库包含 **JuggleChat 业务服务**及内置 Web 客户端；实时消息投递由 [JuggleIM Server](https://github.com/juggleim/im-server) 提供。
## 快速开始
### 环境要求
- Go 1.23 或更高版本
- MySQL 8.0 或更高版本
- 已运行的 [JuggleIM Server](https://github.com/juggleim/im-server) 实例
需要快速搭建 JuggleIM 时，请参考[官方部署文档](https://www.juggle.im/docs/guide/deploy/quickdeploy/)。
### 1. 克隆项目
国内开发者推荐使用 Gitee：
```bash
git clone https://gitee.com/juggleim/jugglechat-server.git
cd jugglechat-server
```
也可以从 GitHub 获取：
```bash
git clone https://github.com/juggleim/jugglechat-server.git
cd jugglechat-server
```
### 2. 创建数据库
```sql
CREATE DATABASE app_db CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
```
服务首次启动时会自动执行内置的数据库迁移。如需手动初始化当前表结构，可执行：
```bash
mysql -u
