AI 测试平台部署调测文档
1. 文档基础信息
| 项目 | 内容 |
|---|---|
| 文档名称 | AI 测试平台部署调测文档 |
| 本地开发路径 | D:\机器学习资料\ai_test_platform_By_skill |
| 远程服务器 | ***.***.***.***(服务器EIP) |
| 远程账号 | root / (服务器root密码) |
| 远程部署目录 | /home/admin/ai_test_platform |
| 预制管理员账号 | admin / admin123 |
| AI 模型网关 | https://apihub.agnes-ai.com/v1 |
| 适配环境 | Windows10/11 本地开发、Linux CentOS7+/Ubuntu20.04 + 容器部署 |
2. 前置环境依赖清单
2.1 通用依赖（本地 + 服务器）
- Python 3.11
- Redis 7
- MySQL 8.0
- MinIO
- Docker & Docker Compose v2
2.2 Windows 本地额外依赖
- Node.js 18+（前端 Vue3 开发）
- Git
- Python pip
- Postman2Jmx 工具包
2.3 Linux 服务器额外配置
- 防火墙放行端口：80、8000、3306、6379、9000、9001
3. Windows 本地开发部署（单机调试）
3.1 Windows 环境安装
- Python 3.11 安装：安装时勾选 "Add Python to PATH"
- Redis Windows 版：启动本地 redis 服务，默认端口 6379 无密码
- MySQL 8.0 本地安装：root 密码自定义，创建空数据库 ai_test_platform
- MinIO Windows 二进制：本地启动
minio.exe server D:\minio_data --console-address ":9001" - Node.js 18 LTS 安装：用于前端 Vite 开发
- Postman2Jmx 工具包：拷贝至固定路径 D:\机器学习资料\Postman2Jmx，确保存在 P2JConvert_v2207.py
3.2 项目代码初始化
项目根目录：D:\机器学习资料\ai_test_platform_By_skill
后端依赖安装：
cd D:\机器学习资料\ai_test_platform_By_skill\backend pip install -r requirements.txt前端依赖安装：
cd ../frontend npm install3.3 本地环境变量配置（项目根目录 .env）
# MySQL DB_HOST=127.0.0.1 DB_PORT=3306 DB_USER=root DB_PASSWORD=本地mysql密码 DB_NAME=ai_test_platform DB_ECHO=True Redis REDIS_HOST=127.0.0.1 REDIS_PORT=6379 REDIS_PASSWORD= MinIO MINIO_ENDPOINT=127.0.0.1:9000 MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin MINIO_SECURE=False 邮件（测试可先不填） EMAIL_SMTP_SERVER=smtp.qq.com EMAIL_SMTP_PORT=587 EMAIL_SENDER=xxx@qq.com EMAIL_PASSWORD=邮箱授权码注：Agnes AI 密钥已固化在 core/config.py，无需在 .env 修改。
3.4 Postman2Jmx 本地校验
打开文件夹 D:\机器学习资料\Postman2Jmx，确认存在：
- P2JConvert_v2207.py
- README.txt
缺失则复制工具包到此目录，转换功能依赖该路径。
3.5 本地分步启动流程（多终端分开运行）
- 终端 1：FastAPI 后端主服务
<pre>cd D:\机器学习资料\ai_test_platform_By_skill\backend uvicorn main:app --reload --host 0.0.0.0 --port 8000<p>启动自动执行：创建全量数据表、初始化 admin 账号 admin/admin123。</p> </li> <li><strong>终端 2：Celery Worker 异步任务（导入、转换、自动化执行）</strong> <pre>cd D:\机器学习资料\ai_test_platform_By_skill\backend celery -A core.celery_app worker --loglevel=info - 终端 3：Celery Beat 定时任务（每日 8 点日报、凌晨 2 点自动化、每小时清理日志）
cd D:\机器学习资料\ai_test_platform_By_skill\backend celery -A core.celery_app beat --loglevel=info - 终端 4：Vue3 前端开发服务
cd D:\机器学习资料\ai_test_platform_By_skill\frontend npm run dev
3.6 本地访问地址与验证
- FastAPI 接口文档：High Performance Web Crawler API - Swagger UI
- 前端页面：http://127.0.0.1:5173
- MinIO 控制台：http://127.0.0.1:9001
登录校验：账号 admin，密码 admin123，登录成功返回 JWT Token 即代表基础环境正常。
4. 远程 Linux 服务器 Docker 部署（***.***.***.***）
4.1 服务器登录与前置依赖安装
SSH 登录服务器：
ssh root@***.***.***.*** # 密码：(服务器root密码)安装 Docker & Docker Compose：
# CentOS yum install docker -y systemctl start docker systemctl enable docker 安装 compose 插件 curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose放行防火墙端口：
firewall-cmd --add-port=80/tcp --permanent firewall-cmd --add-port=8000/tcp --permanent firewall-cmd --add-port=3306/tcp --permanent firewall-cmd --add-port=6379/tcp --permanent firewall-cmd --add-port=9000/tcp --permanent firewall-cmd --add-port=9001/tcp --permanent firewall-cmd --reload4.2 项目上传至远程目录
mkdir -p /home/admin/ai_test_platform cd /home/admin/ai_test_platformWindows 本地将完整项目压缩为 ai_test_platform.zip，上传至服务器解压；
拷贝 Postman2Jmx 工具至项目 tools/postman2jmx 目录，容器启动自动映射至 /app/tools/postman2jmx。
4.3 生产环境 .env 配置修改（项目根目录 .env）
# MySQL容器配置 DB_HOST=mysql DB_PORT=3306 DB_USER=root DB_PASSWORD=root123456 DB_NAME=ai_test_platform DB_ECHO=False Redis容器 REDIS_HOST=redis REDIS_PORT=6379 REDIS_PASSWORD= MinIO容器 MINIO_ENDPOINT=minio:9000 MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin MINIO_SECURE=False 生产邮件配置（必须填写才能发送日报） EMAIL_SMTP_SERVER=smtp.qq.com EMAIL_SMTP_PORT=587 EMAIL_SENDER=平台对外邮箱@qq.com EMAIL_PASSWORD=邮箱授权码4.4 Postman2Jmx 容器适配校验
项目内 tools/postman2jmx 必须存在转换脚本 P2JConvert_v2207.py，core/config.py 中 DOCKER_P2J_PATH="/app/tools/postman2jmx" 已固化无需修改。
4.5 Docker Compose 一键构建启动
cd /home/admin/ai_test_platform # 后台构建并启动全部服务 docker-compose up -d --build服务启动顺序：mysql → redis → minio → backend → celery-worker → celery-beat → frontend
4.6 容器服务启停、重启、日志查看命令
- 查看全部容器运行状态：
<pre>docker-compose ps - 停止所有服务：
docker-compose down 保留数据卷，仅停止容器；如需清空数据加 -v docker-compose down -v - 单独重启某一个服务（示例后端）：
docker-compose restart backend - 实时查看后端日志：
docker-compose logs -f backend - 查看 Celery 定时任务日志（排查日报、自动化定时）：
docker-compose logs -f celery-beat - 查看性能转换任务日志：
docker-compose logs -f celery-worker
4.7 初始化校验（容器启动完成后执行）
- 访问接口文档：问卷调查管理平台 - Swagger UI
- 登录校验：admin / admin123，登录无报错代表数据库初始化完成
- MinIO 校验：访问 MinIO Console，查看 5 个业务桶自动创建完成
- 数据库校验（进入 mysql 容器）：
docker exec -it ai_test_mysql mysql -uroot -proot123456 ai_test_platform # 查询预置角色、admin用户 select username, is_super_admin from sys_user; select role_name from sys_role;
5. 各模块访问地址汇总
5.1 Windows 本地开发
- FastAPI 接口文档：High Performance Web Crawler API - Swagger UI
- Vue 前端页面：http://127.0.0.1:5173
- MinIO 控制台：http://127
)
