RuoYi-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

服务端口说明

服务	端口	说明
用户端	5137	用户前端访问地址
管理端	5666	管理后台访问地址
后端服务	6039	后端 API 服务
MySQL	23306	数据库服务
Redis	6379	缓存服务
Weaviate	28080	向量数据库
MinIO	9000/9090	对象存储

本地开发

请使用 package.json 中声明的 Node.js 22.13.0 及以上版本和 pnpm 11.0.9。本项目统一使用 pnpm 进行本地开发和 Docker 构建，pnpm-lock.yaml 是唯一维护的依赖锁文件，不支持使用 npm 或 Yarn 安装项目依赖。

# 安装指定版本的 pnpm（npm 仅用于安装此工具）
npm install --global [email protected]

# 按锁文件安装依赖
pnpm install --frozen-lockfile

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

需要新增、移除或升级依赖时，请使用 pnpm add、pnpm remove 或 pnpm update，并同时提交 package.json 和 pnpm-lock.yaml，不要提交其他包管理器生成的锁文件。如果之前使用 npm 或 Yarn 安装过依赖，请先删除已有的 node_modules 目录，再使用 pnpm 安装。

常见问题

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

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

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

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

开源协议

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

---