项目文件夹
您已经派生过 ageerle--ruoyi-ai
ageerle--ruoyi-ai
ageerleRuoYi AI
企业级AI助手平台
开箱即用的全栈AI平台，支持多智能体协同、Supervisor模式编排、多种决策模式、RAG技术和流程编排能力
🚀 演示地址
| 服务 | 访问地址 | 默认账号 |
|---|---|---|
| 管理端 | http://129.226.199.247:25666 | admin / admin123 |
| 用户端 | http://129.226.199.247:25137 | admin / admin123 |
| 商业版 | https://web.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 | 对象存储控制台 |
📚 使用文档
想要深入了解安装部署、功能配置和二次开发？
👉 完整使用文档
🤝 参与贡献
我们热烈欢迎社区贡献！无论您是资深开发者还是初学者，都可以为项目贡献力量 💪
贡献方式
- Fork 项目到您的账户
- 创建分支 (
git checkout -b feature/新功能名称) - 提交代码 (
git commit -m '添加某某功能') - 推送分支 (
git push origin feature/新功能名称) - 发起 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 开源社区维护