ruoyi-ai/README_ZH.md

RuoYi AI

企业级AI助手平台

开箱即用的全栈AI平台，支持多智能体协同、Supervisor模式编排、多种决策模式、RAG技术和流程编排能力

English | 📖 使用文档 | 🚀 在线体验 | 🐛 问题反馈 | 💡 功能建议

🚀 演示地址

服务	访问地址	默认账号
管理端	http://129.226.199.247:25666	admin / admin123
用户端	http://129.226.199.247:25137	admin / admin123
商业版	https://web.ruoyiai.chat	微信扫码登录
新版演示	code.ruoyiai.chat	—

✨ 核心亮点

模块	现有能力
模型管理	多模型接入(DeepSeek/智谱/MIMO/百炼/OpenAI)、多模态理解、Coze/DIFY/FastGPT/RAGFlow平台集成
知识管理	本地RAG + 向量库(Milvus/Weaviate/Qdrant) + 文档解析
工具管理	Mcp协议集成、Skills能力 + 可扩展工具生态
流程编排	可视化工作流设计器、节点拖拽编排、SSE流式执行,目前已经支持模型调用,邮件发送,人工审核等节点
智能体管理	基于Langchain4j的Agent框架、Supervisor模式编排,支持多种决策模型,可以灵活搭配工具,skills

项目源码

项目模块	GitHub 仓库	Gitee 仓库	GitCode 仓库
🔧 后端服务	ruoyi-ai	ruoyi-ai	ruoyi-ai
🎨 用户前端	ruoyi-web	ruoyi-web	ruoyi-web
🛠️ 管理后台	ruoyi-admin	ruoyi-admin	ruoyi-admin
🎬 短剧平台	ruoyi-drama	ruoyi-drama	ruoyi-drama
🤖 编程助手	ruoyi-copilot	ruoyi-copilot	ruoyi-copilot
📱 小程序端	ruoyi-uniapp	ruoyi-uniapp	ruoyi-uniapp

合作项目

项目名称	GitHub 仓库	Gitee 仓库
element-plus-x	element-plus-x	element-plus-x

🛠️ 技术架构

核心框架

• 后端架构：Spring Boot 3.5.8 + Langchain4j
• 数据存储：MySQL 8.0 + Redis + 向量数据库（Milvus/Weaviate/Qdrant）
• 前端技术：Vue 3 + Vben Admin + element-plus-x
• 安全认证：Sa-Token + JWT 双重保障
• 文档处理：PDF、Word、Excel 解析，图像智能分析
• 实时通信：WebSocket 实时通信，SSE 流式响应
• 系统监控：完善的日志体系、性能监控、服务健康检查

🐳 Docker 部署

本项目提供两种 Docker 部署方式：

方式一：一键启动所有服务（推荐）

使用 docker-compose-all.yaml 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：

环境要求

• Docker Engine（Linux/macOS）或 Docker Desktop（Windows）
• Docker Compose V2

Linux / macOS

# 克隆 v3.1.0 版本
git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# 固定镜像版本。GHCR 镜像已公开，无需 docker login
cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env
sed -i 's/^RUIYI_VERSION=.*/RUIYI_VERSION=v3.1.0/' docs/docker/ruoyi-ai/.env

# 从 GHCR 拉取预构建镜像并启动全部服务
docker compose --env-file docs/docker/ruoyi-ai/.env \
  -f docs/docker/ruoyi-ai/docker-compose-all.yaml pull
docker compose --env-file docs/docker/ruoyi-ai/.env \
  -f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d

# 查看服务状态
docker compose --env-file docs/docker/ruoyi-ai/.env \
  -f docs/docker/ruoyi-ai/docker-compose-all.yaml ps

# 访问服务（将 SERVER_IP 替换为服务器地址）
# 管理端: http://SERVER_IP:25666 (admin / admin123)
# 用户端: http://SERVER_IP:25137
# 后端API: http://SERVER_IP:26039

Windows PowerShell

如果您使用 Windows + Docker Desktop，可以使用 PowerShell 执行以下命令：

# 克隆 v3.1.0 版本
git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# 创建环境配置文件
Copy-Item docs\docker\ruoyi-ai\.env.example docs\docker\ruoyi-ai\.env

# 固定镜像版本
(Get-Content docs\docker\ruoyi-ai\.env) `
  -replace '^RUIYI_VERSION=.*', 'RUIYI_VERSION=v3.1.0' |
  Set-Content docs\docker\ruoyi-ai\.env

# 查看环境配置
Get-Content docs\docker\ruoyi-ai\.env

# 从 GHCR 拉取预构建镜像并启动全部服务
docker compose --env-file docs\docker\ruoyi-ai\.env `
  -f docs\docker\ruoyi-ai\docker-compose-all.yaml pull
docker compose --env-file docs\docker\ruoyi-ai\.env `
  -f docs\docker\ruoyi-ai\docker-compose-all.yaml up -d

# 查看服务状态
docker compose --env-file docs\docker\ruoyi-ai\.env `
  -f docs\docker\ruoyi-ai\docker-compose-all.yaml ps

默认 Compose 还会发布 MySQL（23306）、Redis（26379）、Weaviate（28080）和 MinIO（29000/29090）端口。生产环境请修改 MySQL 和 MinIO 默认密码，并通过防火墙或反向代理只开放应用端口。

升级到其他已发布版本时，修改 docs/docker/ruoyi-ai/.env 中的 RUIYI_VERSION，然后使用相同的 --env-file 和 -f 参数执行 docker compose pull、docker compose up -d。除非确定要删除持久化数据卷， 不要执行 docker compose down -v。

方式二：分步部署（源码编译）

如果您需要从源码构建后端服务，请按照以下步骤操作：

第一步：部署后端服务

# 进入后端项目目录
cd ruoyi-ai

# 启动后端服务（源码编译构建）
docker-compose up -d --build

# 等待后端服务启动完成
docker-compose logs -f backend

第二步：部署管理端

# 进入管理端项目目录
cd ruoyi-admin

# 构建并启动管理端
docker-compose up -d --build

# 访问管理端
# 地址: http://localhost:5666

第三步：部署用户端（可选）

# 进入用户端项目目录
cd ruoyi-web

# 构建并启动用户端
docker-compose up -d --build

# 访问用户端
# 地址: http://localhost:5137

服务端口说明

服务	一键启动端口	分步部署端口	说明
管理端	25666	5666	管理后台访问地址
用户端	25137	5137	用户前端访问地址
后端服务	26039	6039	后端 API 服务
MySQL	23306	23306	数据库服务
Redis	26379	6379	缓存服务
Weaviate	28080	28080	向量数据库
MinIO API	29000	9000	对象存储 API
MinIO Console	29090	9090	对象存储控制台

📚 使用文档

想要深入了解安装部署、功能配置和二次开发？

👉 完整使用文档

• 在 ruoyi-admin 中配置模型和 API Key
• 本地开发接入 Dify 官方云服务

🤝 参与贡献

我们热烈欢迎社区贡献！无论您是资深开发者还是初学者，都可以为项目贡献力量 💪

贡献方式

1. Fork 项目到您的账户
2. 创建分支 (git checkout -b feature/新功能名称)
3. 提交代码 (git commit -m '添加某某功能')
4. 推送分支 (git push origin feature/新功能名称)
5. 发起 Pull Request

💡 小贴士：建议将 PR 提交到 GitHub，我们会自动同步到其他代码托管平台

📄 开源协议

本项目采用 MIT 开源协议，详情请查看 LICENSE 文件。

🙏 特别鸣谢

感谢以下优秀的开源项目为本项目提供支持：

• Langchain4j - 强大的 Java LLM 开发框架
• RuoYi-Vue-Plus - 成熟的企业级快速开发框架
• Vben Admin - 现代化的 Vue 后台管理模板

💎 赞助商

感谢以下赞助商对本项目的支持：

访问Atlas Cloud官网 · 编程计划优惠 全模态 AI 推理平台，为开发者提供统一的 AI API，支持视频生成、图像生成和大语言模型。一次接入，即可访问 300+ 精选模型。

注册即领2500万Tokens，立即前往 享字节自研豆包模型+满血版开源 SOTA模型，覆盖文本、VLM、图像生成，全模态一站配齐：Seed-2.1、Seedream-5.0、GLM-5.2、DeepSeek等。不止编程、更能解决 Agent 复杂长程任务！

💬 社区交流

扫码添加作者微信 邀请进群学习

抖音视频教程 打开抖音扫一扫，关注查看视频教程

QQ技术交流群 技术讨论

---

⭐ 点个Star支持一下 • Fork 开始贡献 • 📚 English • 📖 查看完整文档

用 ❤️ 打造，由 RuoYi AI 开源社区维护