Ruoyi-AI 手把手安装教程3 步本地部署免费 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想在本地搭一个能聊天、能绘画、还能接微信的 AI 助手平台Ruoyi-AI 基于 Spring Boot 3 Java 17 构建MIT 协议完全免费内置 SSE / WebSocket 流式推送支持对接 OpenAI、Azure、ChatGLM、讯飞星火等大模型自带完整的后台管理端和用户端。这篇 Ruoyi-AI 安装教程会带你走完「下载代码 → 环境准备 → 安装配置 → 首次运行」全流程全程不需要任何付费组件。本地部署前的准备工作清单4 个命令确认环境动手前先把四样东西备齐照着敲一遍输出对得上才算过关java -version # 需要 17.x mvn -v # 需要 3.8 mysql --version # 5.7 或 8.0 redis-cli --version # 5.x 及以上低了会起不来整理成一张清单方便对照组件版本要求说明JDK17项目按 Java 17 编译Maven3.8构建用MySQL5.7 / 8.0存业务数据Redis≥ 5.x缓存与登录态版本必须达标Node.js pnpm20 / 建议 8部署前端用户端、管理端时用本地没装 MySQL 和 Redis 也没关系script/docker/docker-compose.yml 里已经写好了开箱即用的编排执行docker compose -f script/docker/docker-compose.yml up -d即可拉起一套测试环境——注意容器里 MySQL 映射到宿主机的3307端口别直接按 3306 连。获取 Ruoyi-AI 代码并认识目录克隆后端仓库到本地git clone https://gitcode.com/GitHub_Trending/ru/ruoyi-ai拿到代码后建议花一分钟认清四个关键位置后面配置全靠它们ruoyi-admin/启动模块PandaApplication.java 就是入口配置在 src/main/resources/ 下ruoyi-modules/ruoyi-system/聊天、计费、模型管理等核心业务代码ruoyi-common/ruoyi-common-chat/OpenAI 兼容调用与 SSE 流式推送实现script/sql/ry-vue.sql建库脚本下一步要用的。前端管理端、用户端、小程序端是独立仓库本文聚焦后端本地部署前端拉下来后按各自说明启动即可。配置数据库与连接参数导入 SQL 3 个环境变量先在 MySQL 里建库并导入初始化脚本这一步漏了启动时必然报「表不存在」# 建库字符集用 utf8mb4 mysql -uroot -p -e CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 导入表结构和初始数据 mysql -uroot -p ry-vue script/sql/ry-vue.sql再配置连接参数。数据源写在 application-dev.ymlMaven 默认激活dev环境它引用的是环境变量所以启动前导出即可不用改代码export DB_URLjdbc:mysql://localhost:3306/ry-vue?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLtrueserverTimezoneGMT%2B8autoReconnecttruerewriteBatchedStatementstrue export DB_USERNAMEroot export DB_PASSWORD你的密码 export REDIS_HOSTlocalhost export REDIS_PORT6379三个高频坑位提前说Redis 若设了密码要同时给REDIS_PASSWORD赋值DB_URL里的库名必须和你建的库一致Docker 方案下 MySQL 地址改成localhost:3307。首次运行打包启动并验证服务先构建整个项目-DskipTests跳过测试首次构建会拉不少依赖耐心等mvn clean package -DskipTests打包完成后运行主模块的 jar 启动服务java -jar ruoyi-admin/target/*.jar看到 Spring Boot 启动日志里没有Exception端口占用 6039见 application.yml 的server.port就说明后端起来了。用一条命令做连通性验证curl -I http://localhost:6039/只要响应头能回来401、404 都算正常就说明服务在监听Connection refused则回到上一节查数据库和 Redis 连接。最后把前端跑起来完成闭环分别克隆管理端和用户端仓库用 pnpm 安装依赖并启动开发服务两个项目默认各自监听 8082、8081与 docker 编排中的端口一致浏览器打开对应地址用admin / admin123登录后台管理端看到工作台的「待办 / 项目 / 团队」卡片即安装成功 ✅打开用户端能进入对话页和绘画页就算链路通了登录后去后台「模型管理」里把模型 API 的 Key 和地址配上再发起一句对话能收到流式回复本地部署就算彻底跑通了。启动失败的常见坑位排查现象大概率原因处理办法mvn报无效的目标发行版 17本地 Java 版本低于 17换 JDK 17或export JAVA_HOME指过去启动即Table ry-vue.xxx doesnt existSQL 脚本没导入或导错库重新执行上面两条 MySQL 命令核对库名Redis 相关报错Redis 版本 5.x 或密码未配升级 Redis补REDIS_PASSWORDPort 6039 was already in use端口被占改 application.yml 的server.port或关掉旧进程登录正常但对话没反应模型中转地址 / Key 未配置后台配置模型后重试这部分不属于环境安装问题走到这里本地已经有一套可管理的 Ruoyi-AI 聊天绘画平台了。想换成 Docker 一键部署或想加多租户、接支付再看 README.md 里的目录说明和各模块源码就行。【免费下载链接】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），仅供参考