RuoYi AI 部署只要 10 分钟？这份完整上手指南把每一步验证点都写清楚了-二趣网

RuoYi AI 部署只要 10 分钟？这份完整上手指南把每一步验证点都写清楚了

【免费下载链接】ruoyi-aiEnterprise-grade AI agent framework with multi-provider LLM management, secure knowledge bases and high-precision RAG, visual workflow orchestration, and multi-agent coordination.项目地址: https://gitcode.com/GitHub_Trending/ru/ruoyi-ai

想做一个能对话的智能助手，但不打算从零搭后端、前端和支付链路？RuoYi AI 是一个基于 Java 17 与 SpringBoot 3.X 的 AI 聊天机器人平台，内置多模型接入、SSE / WebSocket 实时通信，以及 AI 绘画和支付模块，目标是让你把精力花在业务上，而不是造轮子。

这篇 RuoYi AI 部署指南按"克隆仓库、建库导入、改配置、填模型密钥、打包启动"五步走，每一步都给了验证点；前端属于可选项，跑通后端后随时可以补上。

一分钟看懂 RuoYi AI 是什么

一句话：RuoYi AI 是一个开箱即用的 Java 系 AI 聊天机器人平台，接得上 OpenAI、Azure、ChatGLM、讯飞星火等模型，聊天、绘画、收款这些常见模块都在仓库里。

能力	说明
多模型接入	支持 OpenAI、Azure、ChatGLM、讯飞星火等大语言模型，配置密钥即可切换
实时通信	内置 SSE 与 WebSocket 两种协议，对话按流式输出
AI 绘画	集成 Midjourney，提供绘图、换脸、混图等玩法
支付	微信支付、Stripe 等国际信用卡等收款通道
多端覆盖	Web 用户端、后台管理端与小程序端都提供现成应用

动手前：环境检查单

依赖	版本要求	用途
JDK	17	运行与编译后端
MySQL	5.7 或 8.0	业务数据
Redis	5.X 及以上	缓存与登录态
Maven	3.8+	打包后端工程
Node.js	20+	前端构建（可选步骤）
pnpm	随 Node 安装	前端依赖管理（可选步骤）

两个最常见的版本坑：JDK 停留在 8 或 11 时编译会直接失败，项目要求 17；Node.js 低于 20 时前端依赖装不上。另外如果你的 Redis 设了密码，配置文件里必须同步写上，不然启动即断连。

五步跑起来

第一步：克隆仓库

把代码拉到本地：

git clone https://gitcode.com/GitHub_Trending/ru/ruoyi-ai cd ruoyi-ai

怎么算成功：目录里有ruoyi-admin、ruoyi-common、ruoyi-modules和根目录的application.yml。

第二步：建库并导入初始化 SQL

创建一个 UTF8MB4 的数据库，再导入初始化脚本（脚本内已带建表语句，不同数据库的版本在script/sql/下按目录区分）：

mysql -u root -p -e "CREATE DATABASE ruoyi_ai DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -u root -p ruoyi_ai < script/sql/ry-vue.sql

怎么算成功：show tables能看到sys_user、sys_config等一批表，且后台相关的聊天表也在其中。

第三步：改配置文件里的数据源和 Redis

需要改两处文件：根目录的application.yml（项目主配置）和ruoyi-admin/src/main/resources/下的环境配置文件。环境配置中，spring.datasource.dynamic.datasource.master是数据库连接，spring.data.redis是 Redis 地址与端口，密码没配置就去掉注释再填写。

spring: datasource: dynamic: datasource: master: url: jdbc:mysql://localhost:3306/ruoyi_ai?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: 你的账号 password: 你的密码 data: redis: host: localhost port: 6379 password: 你的Redis密码

怎么算成功：下一步启动后，日志里能看到数据源与 Redis 连接建立，且没有Connection refused字样。

第四步：填写模型密钥和接入地址

模型接入信息放在根目录application.yml的chat节点，换成你自己服务商的密钥与地址：

chat: apiKey: 'sk-你的密钥' apiHost: 'https://api.openai.com/'

怎么算成功：密钥与地址没有多余空格和换行；启动后发一句对话能收到回复，说明接入生效。

第五步：打包启动后端，前端可后补

先打包再启动，产物在ruoyi-admin/target/下：

mvn clean package -DskipTests java -jar ruoyi-admin/target/ruoyi-admin.jar

怎么算成功：日志出现 Tomcat started 并监听server.port指定的端口（根配置里默认 6039），浏览器打开http://localhost:端口能进后台登录页，用默认账号admin/ 密码admin123登录成功。

前端是独立仓库，地址写在根目录 README.md 的源码地址一节里；本地跑起来就是：

pnpm install pnpm dev

打开控制台地址，能看到对话输入框与历史记录侧栏，说明前端也通了。

跑通之后，先验收这三件事

在用户端发起一次真实对话，AI 有正常回复
观察流式输出：回答逐字或逐段出现，而不是长时间等待后一次性刷出
打开后台管理页能登录，模型、订单等菜单可正常进入

启动报错先查这 3 处

现象	可能原因	处理办法
端口冲突，启动即退出	`server.port`被占用	在`application.yml`里改`server.port`，或释放原端口
数据库连接失败	MySQL 没启动、账号密码错、库名不存在	用客户端手动连一次；核对`url`与库名、字符集
Redis 连接异常	服务未启动、端口错、密码不一致	确认 Redis 运行状态；`spring.data.redis`与`redisson`两处配置保持一致
对话发出后无回复	密钥失效、`apiHost`不通	用密钥单独调一次模型接口验证，再检查网络

往深里玩

接入企业微信 / 个人微信机器人，让对话从网页延伸到企微会话：ruoyi-common/ruoyi-common-wechat/
基于 i18n 配置做多语言支持，界面与提示文案按语言切换：ruoyi-admin/src/main/resources/
在后台查看对话量、Token 消耗与订单，做数据统计分析：ruoyi-admin/
配置 SSL 证书启用 HTTPS，为生产环境做准备：ruoyi-admin/src/main/resources/

从克隆、建库、配置到打包启动，全程五步；源码按ruoyi-common与ruoyi-modules分层，方便按模块二次开发。适合第一次做 AI 应用、想快速拿到可运行系统的读者，也适合作为团队二次开发的起点；更多模块说明见根目录 README.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析