Maas-Agent/启动说明.md

快速启动

完整文档请查看 README.md

服务端口

服务	端口	说明
Admin 管理端	3000	/admin/
Chat 访问端	3001	/chat/
Builder 构建端	3002	/builder/
Django Web	8080	REST API
PostgreSQL	5432	数据库
Redis	6379	缓存

启动步骤

# 1. 安装后端依赖
uv sync

# 2. 安装前端依赖（三端独立）
cd ui && npm run install:all

# 3. 配置数据库
cp config_example.yml config.yml
# 编辑 config.yml 填写数据库连接信息

# 4. 启动后端
python main.py dev celery    # 终端 1
python main.py dev web       # 终端 2

# 5. 启动前端（三端独立）
cd ui
npm run dev:admin      # 管理端 :3000
npm run dev:builder    # 构建端 :3002
npm run dev:chat       # 访问端 :3001

# 或同时启动三端
npm run dev:all

默认账号

• 用户名：admin@zhagent.com
• 密码：ZhAgent@980123

Windows 一键启动

startTools.bat
# 选择 1 启动全部服务

三端独立开发

每个端完全独立，位于 ui/ 下的独立目录：

• ui/admin/ — 管理端（系统管理）
• ui/builder/ — 构建端（智能体构建）
• ui/chat/ — 访问端（对话访问）

进入对应目录可独立开发：

cd ui/admin && npm run dev    # 仅启动管理端
cd ui/builder && npm run dev  # 仅启动构建端
cd ui/chat && npm run dev     # 仅启动访问端

Docker 部署

# 构建前端
bash build-frontend.sh

# 启动全部服务（PostgreSQL + Redis + Django + Celery + Nginx）
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose down

数据目录（挂载到本地磁盘）：

• ./data/postgresql — 数据库
• ./data/redis — 缓存
• ./data/uploads — 上传文件

访问地址：http://localhost（Nginx 端口 80）