Ruoyi-AI 从零跑通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-aiRuoyi-AI 是一套开箱即用的 AI 助手平台内置 SSE / WebSocket 流式推送可对接 OpenAI 等大语言模型提供 AI 聊天、文生图、语音克隆等能力。跟着本文操作你本地就能把这套 Spring Boot 3Spring 生态的脚手架省掉大量配置样板代码后端服务跑起来看到启动成功并打开登录接口。预计 30 分钟内跑通前提是你机器上有 Java 17、MySQL 和 Redis。环境依赖一次性配齐不用逐个装把下面这张表过一遍缺什么补什么依赖最低版本检查命令JDK17java -versionMaven3.8mvn -vMySQL5.7 / 8.0mysql --versionRedis5.xredis-cli --version一行命令快速自检java -version mvn -v mysql --version redis-cli --version四项输出都正常就可以往下走。拉取代码在任意空目录执行git clone https://gitcode.com/GitHub_Trending/ru/ruoyi-ai cd ruoyi-ai后续所有修改都发生在你本地 clone 下来的这份副本里仓库本身不需要也不应该动。配好数据库和 Redis 连接服务就能起来✅建库导表项目初始化脚本在 script/sql/ 目录ry-vue.sql对应 MySQL另有 oracle / postgres / sqlserver 版本。这条命令的目的是一次建库并导入全部表结构mysql -uroot -p -e CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4; mysql -uroot -p ry-vue script/sql/ry-vue.sql⚡改数据源配置打开 application.yml即ruoyi-admin/src/main/resources/application-dev.yml。数据源、Redis 地址都走环境变量占位符这是本步最容易被忽略的点——不填它们启动直接失败。必须改的只有 5 个值DB_URL、DB_USERNAME、DB_PASSWORD、REDIS_HOST、REDIS_PORT其余配置连接池、Hikari 参数保持默认即可。启动命令的目的在于注入这些变量并打整包mvn clean package -DskipTests -Pdev DB_URLjdbc:mysql://localhost:3306/ry-vue?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneGMT%2B8 \ DB_USERNAMEroot DB_PASSWORD你的密码 REDIS_HOSTlocalhost REDIS_PORT6379 \ java -jar ruoyi-admin/target/ruoyi-admin.jar项目默认激活dev环境服务端口 6039application.yml中server.port指定启动类为 PandaApplication看到控制台打印panda智能助手启动成功即代表服务就绪。启动后 30 秒验证是否跑通✅最小验证浏览器打开http://localhost:6039或命令行执行curl http://localhost:6039/captchaImage接口返回 JSON 而非连接拒绝说明服务已通。⚠️高频排错报错基本都在这几个原因里报错一行修复Communications link failure/ 找不到表库名没导对重新执行mysql ry-vue script/sql/ry-vue.sqlUnable to connect to Redis核对REDIS_HOST/REDIS_PORT指向本机 6379并确认 Redis 已启动登录报数据库异常控制台刷Access deniedDB_USERNAME/DB_PASSWORD与你 MySQL 实际账号不符改后重启跑起来之后往哪走配置application.yml里chat.apiKey和chat.apiHost当前是占位值sk-xxx接上你自己的模型密钥后就可以发起第一次 AI 对话了需要批量造 CRUD 的话代码生成模块在 ruoyi-generatorDocker 一键起全套环境可看 script/docker/docker-compose.yml。现在去把chat.apiKey换成你的密钥重启服务发出一条聊天消息验证 RAG 链路。【免费下载链接】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），仅供参考