系列01-BrickCore 开源 AI 自动化测试平台 — 在线体验与 Docker 自建指南

绝惘

372人浏览 · 2026-06-05 10:08:52

绝惘 · 2026-06-05 10:08:52 发布

为什么做这个平台

很多团队的测试工具是「拼」出来的：

痛点	常见做法	问题
接口联调	Postman / 脚本	用例散落，步骤间传参靠手写
UI 回归	Playwright 脚本	维护成本高，定位器一改就挂
压测	单独起 Locust	和接口/UI 数据不互通
功能用例	Excel / 禅道	从 PRD 到用例耗时长
报告	人工整理	执行完还要拷日志、写总结

BrickCore 的目标，是把 Web UI / 接口 / 性能 / AI 测试 放到同一套项目、权限、看板里，覆盖「用例设计 → 执行调度 → 报告分析」的主链路，并支持 Docker 自建，社区版已开源。

技术栈：FastAPI + Vue3 + Playwright（执行器）+ httpx + Locust
源码：https://gitee.com/BanZhuanKeOrz/BrickCore
觉得有帮助，欢迎 ⭐ Star

在线体验（免部署）

项	内容
演示地址	http://43.142.83.156/
登录账号	`admin`
登录密码	`BrickCore123456`

演示环境密码公开，请勿存放真实业务数据；自行部署后请修改密码。

建议 15 分钟体验路径：

数据看板 — 看 UI / 接口 / 性能三域执行趋势
接口自动化 — 浏览接口定义、用例断言、测试计划
AI 测试 — 打开需求测试中心（配置 LLM Key 后可试 AI 生成）
性能测试 — 查看压测场景与历史报告
UI 自动化 → 设备管理 — UI 执行需安装执行器（见下文）

高清录屏与操作文档（无需登录）：

产品演示：http://43.142.83.156/showcase/
使用说明：http://43.142.83.156/showcase/docs/

四大模块能做什么

模块	核心能力
接口自动化	Swagger / Postman / cURL 导入；用例 / 套件 / 计划；变量传递；Token 授权；Mock；数据工厂；定时任务
Web UI 自动化	步骤编排、条件分支、录制回放、计划执行、截图/视频报告；需本机执行器
性能测试	场景压测、梯度加压、CSV 参数化、分布式 Worker、报告对比
AI 测试	PRD 生成功能用例、Swagger 生成接口用例、失败分析、报告摘要、定位器自愈、平台助手

AI 全链路（差异化）

需求文档 ──► AI 功能用例 ──► 导出禅道 XLSX
     │                           │
     ▼                           ▼
Swagger ──► AI 接口用例     UI 录制 + 步骤优化
     │                           │
     ▼                           ▼
测试计划执行 ──────────► 失败 AI 分析 / 报告摘要
                              │
                         UI 定位器自愈

亮点	说明
AI 需求 → 功能用例	上传 PRD，按章节批量生成，支持禅道导出
接口用例 AI 生成	基于 Swagger 结构自动补断言
UI MCP 录制	MCP / 平台助手驱动浏览器录制步骤
UI 定位器自愈	页面小改后自动尝试修复定位器
平台助手「小测」	网页右下角自然语言查项目、查失败、触发执行
MCP Server	Kimi / Cursor 等 AI 客户端可连接平台

平台截图

数据看板
接口自动化
AI 测试

UI 自动化
性能测试
Docker 部署

执行器下载与安装

UI 自动化、浏览器录制、分布式压测 Worker 需要安装 BrickCoreRunner（Playwright 引擎以安装包形式分发，平台菜单与能力齐全）。

下载方式

方式	链接
Gitee Release	https://gitee.com/BanZhuanKeOrz/BrickCore/releases
百度网盘	https://pan.baidu.com/s/1pObFpG-Mt7-Pxo58hklOlg?pwd=9gbi · 提取码 `9gbi`
演示平台内	登录演示站 → UI 自动化 → 设备管理 → 网盘下载

系统	安装包
Windows	`BrickCoreRunner.zip`（约 800MB）
macOS · M 芯片	`BrickCoreRunner-mac-arm64.zip`
macOS · Intel	`BrickCoreRunner-mac-intel.zip`

Windows 安装

下载解压 BrickCoreRunner.zip（路径勿含中文和空格）
运行 BrickCoreRunner.exe，服务器地址填 http://43.142.83.156（自建填你的平台地址）
用平台账号登录，点击上线，在 设备管理 确认在线

macOS 安装

按芯片下载对应 zip，在 Mac 上解压
终端执行：chmod +x connect-mac.sh start-mac.sh → ./connect-mac.sh → ./start-mac.sh
在 设备管理 确认在线

Linux Docker 自建

适合有云服务器的团队：一条 docker-compose.yml 拉起全栈（MySQL、Redis、RabbitMQ、MinIO、后端、Nginx 前端）。

第一次部署请跟完整文档（步骤 0～9）：

https://gitee.com/BanZhuanKeOrz/BrickCore/blob/main/docs-site/guide/docker-deploy.md
（腾讯云 CVM + OpenCloudOS 9 示例，其它 Linux 也可参考）

⚠️ 服务器上只用 docker-compose.yml，不要再跑 docker-services.yml（端口冲突）。

环境要求

项	建议
系统	OpenCloudOS 9 / 其它 64 位 Linux
规格	2 核+，8GB+ 内存，50GB+ 磁盘
安全组	放行 TCP 80（必开）
Node.js	18+（用于 `npm run build` 前端）

OpenCloudOS 安装 Node：dnf install nodejs npm（不要用 dnf module nodejs 和 NodeSource 一键脚本，易踩坑）。

速查命令

git clone https://gitee.com/BanZhuanKeOrz/BrickCore.git
cd BrickCore
cd frontend && npm install && npm run build && cd ..

# 建议改 docker-compose.yml 中 MINIO_PUBLIC_ENDPOINT 为你的公网 IP:9200

docker compose up -d --build
docker compose logs -f backend    # 出现「启动后端服务」后 Ctrl+C

docker exec -i fastapi_mysql mysql --default-character-set=utf8mb4 \
  -uadmin -pBrickCore123456 fastapi < database.sql

浏览器访问 http://你的公网IP/，登录 admin / BrickCore123456（部署后务必改密码）。

默认账号

用途	账号	密码
平台	admin	BrickCore123456
MySQL	admin	BrickCore123456（库名 `fastapi`）

常见部署问题

现象	处理
页面打不开	检查安全组是否放行 80
`docker compose build` 很慢	首次构建正常，可配 Docker 镜像加速
UI 任务一直排队	需安装执行器并上线；检查 RabbitMQ 端口是否对 Runner 机器开放
MinIO 截图上传失败	确认 `MINIO_PUBLIC_ENDPOINT` 已改为公网 IP

开源说明

项	说明
平台源码	Apache-2.0，含 frontend、backend、AI 模块，可自由学习二次开发
执行器	UI/性能执行引擎闭源，通过 Release / 网盘免费下载安装包
社区版功能	菜单与能力与完整版一致；差别在于拿不到 `runner/` 引擎源码

文档与支持

资源	链接
源码 / Star	https://gitee.com/BanZhuanKeOrz/BrickCore
问题反馈	https://gitee.com/BanZhuanKeOrz/BrickCore/issues
Docker 完整教程	https://gitee.com/BanZhuanKeOrz/BrickCore/blob/main/docs-site/guide/docker-deploy.md
在线文档	http://43.142.83.156/showcase/docs/
本机开发	见部署文档附录 B