RuoYi-AI 用户端

企业级AI助手平台 - 用户前端

RuoYi-AI 的用户前端，提供 AI 对话、智能体交互、知识库问答等功能

在线体验 | 后端服务 | 管理后台

技术栈

• 框架: Vue 3 + TypeScript
• UI组件: Ant Design Vue
• 状态管理: Pinia
• 构建工具: Vite

Docker 部署

本用户端支持两种 Docker 部署方式：

方式一：一键启动所有服务（推荐）

使用 docker-compose-all.yaml 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：

# 克隆后端仓库
git clone https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# 启动所有服务（从镜像仓库拉取预构建镜像）
docker-compose -f docker-compose-all.yaml up -d

# 访问用户端
# 地址: http://localhost:25137
# 账号: admin / admin123

方式二：分步部署（源码编译）

如果您需要从源码构建，请按照以下步骤操作：

第一步：部署后端服务

# 进入后端项目目录
cd ruoyi-ai

# 启动后端服务（源码编译构建）
docker-compose up -d --build

# 等待后端服务启动完成
docker-compose logs -f backend

第二步：部署用户端

# 进入用户端项目目录
cd ruoyi-web

# 构建并启动用户端
docker-compose up -d --build

# 访问用户端
# 地址: http://localhost:5137

第三步：部署管理端（可选）

# 进入管理端项目目录
cd ruoyi-admin

# 构建并启动管理端
docker-compose up -d --build

# 访问管理端
# 地址: http://localhost:5666

服务端口说明

镜像仓库

所有镜像托管在阿里云容器镜像服务：

crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai

可用镜像：

• mysql:v3 - MySQL 数据库（包含初始化 SQL）
• redis:6.2 - Redis 缓存
• weaviate:1.30.0 - 向量数据库
• minio:latest - 对象存储
• ruoyi-ai-backend:latest - 后端服务
• ruoyi-ai-admin:latest - 管理端前端
• ruoyi-ai-web:latest - 用户端前端

本地开发

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

常见问题

Q: 用户端无法连接后端服务？

A: 请确保后端服务已启动，并检查环境变量 UPSTREAM_URL 配置是否正确。

Q: 一键启动和分步部署有什么区别？

A: 一键启动使用预构建的镜像，部署速度快；分步部署从源码编译，适合需要自定义修改的场景。

开源协议

本项目采用 MIT 开源协议，详情请查看 license 文件。