企业官网建设流程全解析

RuoYi AI部署完整手册：从空仓库到第一次对话

【免费下载链接】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 的回答逐字流式蹦出来；一套 RuoYi AI 管理后台，用户、模型、充值订单、聊天流水都在表格里管；后台还留好了支付回调链路，商业化随时能接。用户端侧边栏里，AI 绘画和音乐也有现成入口，不只是聊天。

跑起来之前：前置条件对照

这几样就绪，下面的操作就是照做。

从空仓库到第一次对话

拉代码，先建库

仓库是十几个 Maven 子模块的结构，启动入口只有ruoyi-admin一个。代码到手后先建库，初始化脚本就躺在仓库里，导进去用户、模型、会话这些表就都有了：

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

接着在 MySQL 客户端里执行：

CREATE DATABASE ruoyi_ai CHARACTER SET utf8mb4; USE ruoyi_ai; source script/sql/ry-vue.sql;

script/sql/ry-vue.sql 是唯一的初始化脚本，建库时字符集用 utf8mb4，后面存中文对话记录才不会出乱码。

一次配好三组连接信息

库建好了，让应用连上它。数据库、Redis、模型密钥这三组信息各写一次就够，别再东一榔头西一棒子：

• 数据源和 Redis：ruoyi-admin/src/main/resources/application-dev.yml（开发配置默认是${DB_URL}这类环境变量占位，直接写具体值即可）
• 模型密钥：根目录application.yml

spring: datasource: url: jdbc:mysql://localhost:3306/ruoyi_ai?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: 你的账号 password: 你的密码 data: redis: host: localhost port: 6379 chat: apiKey: 'sk-你的模型密钥' apiHost: 'https://api.openai.com/'

chat这两行决定应用调哪个大脑。OpenAI、Azure、ChatGLM、讯飞星火这类兼容 OpenAI 协议的供应商，都走 apiKey 和 apiHost 这两个字段，换供应商只改这两行。绘画用的mj配置块在文件更靠下，暂时不用就保持默认占位。

构建、启动，看看脑子装上了没

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

Maven 会把所有子模块一次编完，最终产物在ruoyi-admin/target下，这个 jar 单独就能跑。日志里滚出 "Started" 之后，后端就独立活着了：默认监听 6039 端口（application.yml里的server.port）。

打开后台，进「系统管理 → 系统模型」，能看到一张模型列表，每个模型的请求地址、密钥、计费类型都列得清清楚楚——以后给前端展示哪个模型、按 token 还是按次收费，就在这页调。

如果你还需要完整前端体验

用户端前端（ruoyi-web）是单独的仓库，没有它后端照样独立跑。拿到代码后两条命令：

pnpm install pnpm dev

启动后把请求指到 6039 端口的后端，刷新浏览器，完整的对话页就出来了。

跑通了吗？30秒验证与排错

最快的验证路径：浏览器打开http://localhost:6039，出现 RuoYi AI 的后台登录页，说明后端活着；用默认的 admin / admin123 登进工作台，管理端通了。再打开用户端新建聊天，问一句"你是谁"，AI 逐字流式回你，RuoYi AI部署就算全链路打通。

如果卡住了，高频的就这三种：

• 症状：启动即报端口占用，进程直接退出原因：6039 端口被别的服务占着解法：改application.yml里的server.port，重启即可

• 症状：日志刷 HikariPool 连接失败，起不来原因：MySQL 服务没启动，或初始化脚本导进了别的库解法：确认 MySQL 在跑，再核对url指向的库里有 ry-vue.sql 导出的表

• 症状：登录正常，发消息却长时间无响应原因：chat.apiHost地址不对，或密钥没有该模型的调用权限解法：先用 curl 拿密钥单独调一次模型接口验证，再确认 apiHost 结尾带/

往远了走

RuoYi AI部署只是起点线。往后可以走的路：再接入更多模型厂商和计费档位，挂上知识库做 RAG，接微信登录与小程序入口，把支付回调变成真实计费闭环。仓库是 MIT 协议，代码想怎么改就怎么改。现在轮到你了。

【免费下载链接】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