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

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 绘画和音乐也有现成入口不只是聊天。跑起来之前前置条件对照依赖项最低版本用途JDK17后端运行时MySQL5.78.0 亦可存用户、模型、订单数据Redis5.X会话与缓存Maven3.8构建打包Node.js pnpm20仅用户端前端需要这几样就绪下面的操作就是照做。从空仓库到第一次对话拉代码先建库仓库是十几个 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、模型密钥这三组信息各写一次就够别再东一榔头西一棒子数据源和 Redisruoyi-admin/src/main/resources/application-dev.yml开发配置默认是${DB_URL}这类环境变量占位直接写具体值即可模型密钥根目录application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/ruoyi_ai?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/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.jarMaven 会把所有子模块一次编完最终产物在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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考