跳到主要内容

快速开始

推荐方式

推荐使用 Docker Compose 一键部署，最快 5 分钟即可完成全部搭建。

方式一：Docker 一键部署（推荐）​

1. 配置并运行部署脚本​

# 复制配置模板（首次部署）
cp .env.production.example .env.production

# 添加执行权限
chmod +x scripts/deploy.sh

# 一键启动所有服务
./scripts/deploy.sh up

2. 服务列表​

生产环境统一使用 MySQL + Milvus 方案（docker-compose.prod.yml 已包含所有服务）：

服务端口说明
mgagent-frontend3000Chat 前端（Nginx）
mgagent-admin-frontend3001Admin 前端（Nginx）
mgagent-backend8000Chat API
mgagent-admin-backend8001Admin API
MySQL3306关系数据库
Milvus19530向量数据库
Attu8003Milvus 管理界面

3. 访问系统​

服务地址说明
Chat 前端http://localhost:3000智能对话助手
Admin 前端http://localhost:3001管理后台
Chat APIhttp://localhost:8000/docs后端 API 文档
Admin APIhttp://localhost:8001/docs管理 API 文档
Attuhttp://localhost:8003Milvus 管理界面

4. 部署脚本命令速查​

./scripts/deploy.sh up           # 启动所有服务
./scripts/deploy.sh down         # 停止所有服务
./scripts/deploy.sh restart      # 重启服务
./scripts/deploy.sh status       # 查看状态
./scripts/deploy.sh logs         # 查看日志
./scripts/deploy.sh build        # 重新构建镜像
./scripts/deploy.sh cleanup      # 清理所有数据

5. 默认账号​

管理员: admin / admin123

方式二：本地开发模式​

1. 初始化项目​

# 一键初始化（安装依赖、创建目录）
chmod +x scripts/init.sh
./scripts/init.sh

该脚本会自动完成：

  • 安装 mgagent-backend Python 依赖
  • 安装 mgagent-admin-backend Python 依赖
  • 安装 mgagent-frontend Node.js 依赖
  • 安装 mgagent-admin-frontend Node.js 依赖
  • 创建必要的数据目录

2. 启动服务​

# 启动 Docker 基础设施（MySQL + Milvus + MinIO）
./scripts/docker-services.sh start

# 启动本地开发服务
./scripts/start-all.sh

# 停止服务
./scripts/stop-all.sh

# 检查服务状态
./scripts/status.sh

3. 手动启动（可选）​

如需单独启动某个服务：

# Chat 后端 (端口: 8000)
cd mgagent-backend
# 使用 .env 配置
source .env
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

# Admin 后端 (端口: 8001)
cd mgagent-admin-backend
source .env
uvicorn app.main:app --host 0.0.0.0 --port 8001 --reload

# Chat 前端 (端口: 5173)
cd mgagent-frontend
npm run dev

# Admin 前端 (端口: 5174)
cd mgagent-admin-frontend
npm run dev

4. 本地开发访问地址​

服务地址
Chat 前端http://localhost:5173
Admin 前端http://localhost:5174
Chat APIhttp://localhost:8000
Admin APIhttp://localhost:8001

方式三：Docker Compose 直接部署​

# 首次配置
cp .env.production.example .env.production

# 一键启动（推荐）
./scripts/deploy.sh up

# 或手动 Docker Compose
docker compose -f docker-compose.prod.yml up -d --build

配置模型​

登录 Admin 后台后，在 模型管理 页面配置 LLM 模型：

  1. 点击 新增模型
  2. 填写模型名称、API Key、API Base URL
  3. 点击 测试连接 验证配置
  4. 点击 启用 使模型生效
重要

所有大模型配置统一在 Admin 后台管理和存储，不再使用本地静态配置文件。模型配置存储在数据库的 model_configs 表中，支持多套配置和动态切换。

下一步​