快速搭建属于自己的 AI 助手平台
快速启动
-
确认系统内已经安装好以下软件
docker
docker-compose
git
unzip -
克隆项目
git clone https://github.com/ageerle/ruoyi-ai cd ruoyi-ai/docker-deploy/one-step-script/ -
启动部署脚本
中文界面部署脚本：
./deploy-cn.sh
英文界面部署脚本：
./deploy-en.sh
-
如果在执行部署脚本过程中不需要在本地重新构建编译服务软件包以及重新封装容器镜像，则需要在脚本交互提出以下问题时选择D按键进行直接部署，否则就会执行全新的编译构建及容器封装之后再执行部署：
已将模板文件复制到部署目录。 正在使用您的配置更新 .env 文件... 已使用您的配置更新 .env 文件。 正在使用您的配置更新 docker-compose.yaml 文件... 已使用您的配置更新 docker-compose.yaml 文件。 === 构建或部署选项 === 您想构建新镜像 (B) 还是直接使用现有镜像部署 (D)？[B/d]: -
访问应用界面
- 用户界面：
http://your-server-ip:8081 - 管理员界面：
http://your-server-ip:8082
- 用户界面：
目录
系统体验
- 用户端：https://web.pandarobot.chat
- 管理端：https://admin.pandarobot.chat
- 用户名: admin 密码：admin123
源码地址
[1]github
- 前端服务-用户端: https://github.com/ageerle/ruoyi-web
- 前端服务-管理端: https://github.com/ageerle/ruoyi-admin
- 前端服务-小程序端: https://github.com/ageerle/ruoyi-uniapp
- 后端服务：https://github.com/ageerle/ruoyi-ai
[2]gitcode
- 前端服务-用户端：https://gitcode.com/ageerle/ruoyi-web
- 前端服务-管理端: https://gitcode.com/ageerle/ruoyi-admin
- 前端服务-小程序端: https://gitcode.com/ageerle/ruoyi-uniapp
- 后端服务：https://gitcode.com/ageerle/ruoyi-ai
1. 全栈式开源系统
- 全套开源系统：提供完整的前端应用、后台管理以及小程序应用，基于MIT协议，开箱即用。
2. 本地化 RAG 方案
- 基于 Langchain4j 框架，支持 Milvus/Weaviate/Qdrant 向量库，结合 BGE-large-zh-v1.5 本地向量化模型 实现高效文档检索与知识库构建。
- 支持 本地 LLM 接入，结合私有知识库实现安全可控的问答系统，避免依赖云端服务的隐私风险。
3. 多模态 AI 引擎与工具集成
- 智能对话：支持 OpenAI GPT-4、Azure、ChatGLM 等主流模型，内置 SSE/WebSocket 协议实现低延迟交互，兼容 扣子、DIFY 等平台 API 调用。
- Spring AI MCP 支持：通过注解快速定义本地工具，支持调用 MCP 广场 的海量 MCP Server 服务，扩展模型能力边界。
4. 企业级扩展与商业化支持
- 即时通讯集成：支持对接个人微信、企业微信及微信公众号，实现消息自动回复、用户管理与智能客服。
- 支付系统：集成易支付、微信支付、Stripe 国际信用卡支付，满足商业化场景需求。
5. 多媒体处理与创新功能
- AI 绘画：集成 DALL·E-3、MidJourney、Stable Diffusion，支持文生图、图生图及风格化创作，适用于营销素材生成与创意设计。
- PPT 制作：根据文本输入自动生成结构化幻灯片，支持自定义模板(需要使用三方平台 如：文多多)。
项目演示
mcp支持
管理端
用户端
小程序端
开发环境
- jdk 17
- mysql 5.7、8.0
- redis 版本必须 >= 5.X
- maven 3.8+
- nodejs 20+ & pnpm
项目结构
- RuoYi-AI
├─ ruoyi-admin // 管理模块
│ └─ RuoYiApplication // 启动类
│ └─ RuoYiServletInitializer // 容器部署初始化类
│ └─ resources // 资源文件
│ └─ i18n/messages.properties // 国际化配置文件
│ └─ application.yml // 框架总配置文件
│ └─ application-dev.yml // 开发环境配置文件
│ └─ application-prod.yml // 生产环境配置文件
│ └─ banner.txt // 框架启动图标
│ └─ logback-plus.xml // 日志配置文件
│ └─ ip2region.xdb // IP区域地址库
├─ ruoyi-common // 通用模块
│ └─ ruoyi-common-bom // common依赖包管理
└─ ruoyi-common-chat // 聊天模块
│ └─ ruoyi-common-core // 核心模块
│ └─ ruoyi-common-doc // 系统接口模块
│ └─ ruoyi-common-encrypt // 数据加解密模块
│ └─ ruoyi-common-excel // excel模块
│ └─ ruoyi-common-idempotent // 幂等功能模块
│ └─ ruoyi-common-json // 序列化模块
│ └─ ruoyi-common-log // 日志模块
│ └─ ruoyi-common-mail // 邮件模块
│ └─ ruoyi-common-mybatis // 数据库模块
│ └─ ruoyi-common-oss // oss服务模块
│ └─ ruoyi-common-pay // 支付模块
│ └─ ruoyi-common-ratelimiter // 限流功能模块
│ └─ ruoyi-common-redis // 缓存服务模块
│ └─ ruoyi-common-satoken // satoken模块
│ └─ ruoyi-common-security // 安全模块
│ └─ ruoyi-common-sensitive // 脱敏模块
│ └─ ruoyi-common-sms // 短信模块
│ └─ ruoyi-common-tenant // 租户模块
│ └─ ruoyi-common-translation // 通用翻译模块
│ └─ ruoyi-common-web // web模块
├─ ruoyi-modules // 模块组
│ └─ ruoyi-demo // 演示模块
│ └─ ruoyi-system // 业务模块
├─ .run // 执行脚本文件
├─ .editorconfig // 编辑器编码格式配置
├─ LICENSE // 开源协议
├─ pom.xml // 公共依赖
├─ README.md // 框架说明文件
注意事项
-
vben模板
Q：vben5 的模板默认是没有的吗？
A：vben模板是收费的 请联系vben-vue-plus作者获取。
版本控制
该项目使用Git进行版本管理。您可以在repository参看当前可用版本。
- 配套文档: https://doc.pandarobot.chat
项目部署文档：
项目环境
jdk 17
mysql 5.7、8.0
redis 版本必须 >= 5.X
maven 3.8+
nodejs 20+ & pnpm
安装后端
1、下载项目
https://gitee.com/ageerle/ruoyi-ai
2、idea 导入项目
3、配置maven 文件 - 设置 - 左上角搜索框输入maven - 选择maven安装目录
xml配置
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
<localRepository>D:/dev/apache-maven-3.9.9/repository</localRepository>
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
<profiles>
<profile>
<id>jdk-17</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>17</jdk>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
</properties>
</profile>
</profiles>
</settings>
4、初始化数据库
5、启动redis
安装管理端
1、下载项目
https://gitee.com/ageerle/ruoyi-admin
2、安装依赖
pnpm install
3、运行项目
pnpm dev
4、打包
pnpm build
5、修改配置项
- 后台接口：/apps/web-antd/vite.config.mts### 核心功能与技术亮点
- 其他配置：/apps/web-antd/.env.development
安装用户端
1、下载项目
https://gitee.com/ageerle/ruoyi-web
2、安装依赖
npm install
3、运行项目
npm run dev
4、打包
npm run build
nginx 部署
部署到 nginx后，可能会出现以下错误：
Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "application/octet-stream". Strict MIME type checking is enforced for module scripts per HTML spec.
解决方式一：
http {
#如果有此项配置需要注释掉
#include mime.types;
types {
application/javascript js mjs;
}
}
🔌 VS Code 插件推荐
| 插件名称 | 功能描述 | 适用场景 |
|---|---|---|
| Vue-Official | 🏆 Vue 官方插件，提供语法高亮、代码片段等 | Vue 2/3 开发 |
| Prettier | ✨ 自动格式化代码（支持 JS/TS/HTML/CSS） | 统一团队代码风格 |
| ESLint | 🔍 静态代码检查（错误提示、规范校验） | JavaScript/TypeScript |
| Code Spell Checker | 📝 英文拼写检查（变量名、注释等） | 避免拼写错误 |
| EditorConfig | 📁 统一项目代码风格（缩进/换行符等） | 多成员协作项目 |
| Iconify IntelliSense | 🎨 图标库（Unocss/Iconfont）智能提示 | 前端图标开发 |
| stylelint | 🎨 CSS/SCSS/Less 样式检查 | 样式代码规范 |
| Tailwind CSS IntelliSense | 🌈 Tailwind 类名自动补全与提示 | Tailwind CSS 开发 |
| json2ts | 🔄 JSON 转 TypeScript Interface | 接口数据快速生成 TS 类型 |
| DotENV | 🔑 .env 文件语法高亮 | 环境变量管理 |
| Color Highlight | 🎨 高亮颜色值并显示实际颜色（如 #FF0000→🔴） | CSS/设计相关开发 |
| One Dark Pro | 🌙 热门主题（优化组件高亮） | 暗色主题爱好者 |
5、每日资源 在这里
💯 👉【我的更新汇总】
关注我的CDDN博客
更多资源可以查看我的CSDN博客
扫一扫
1575
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
