MokaTest

快速开始 ​

本页面将指导你通过 Docker Compose 快速部署和运行 MokaTest 平台。

环境要求 ​

  • Docker Engine 20.10+
  • Docker Compose plugin（docker compose 命令可用）
  • Git

建议预留至少 2 核 CPU、2 GB 内存、40 GB 磁盘空间。首次构建会下载 Maven 依赖和 Playwright 浏览器镜像，需要较好的网络环境。

步骤一：克隆代码仓库 ​

路径：任意本地目录

  1. 打开终端，执行以下命令克隆仓库：
bash
git clone https://github.com/Jinglong233/MokaTest.git
cd MokaTest
  1. 确认项目根目录包含 docker-compose.yml 和 .env.example 文件。

步骤二：配置环境变量 ​

路径：项目根目录

  1. 复制环境变量模板：

    bash
    cp .env.example .env

  2. 编辑 .env，重点修改以下配置项：

    字段说明默认值
    HOST_HTTP_PORT前端对外访问端口8080
    BACKEND_PORT后端对外访问端口7529
    MYSQL_ROOT_PASSWORDMySQL root 密码密码

  3. 若宿主机已有 MySQL 占用 3306 端口，可修改 .env 中的 MYSQL_PORT 为其他端口，例如 3307。

步骤三：启动服务 ​

路径：项目根目录

  1. 执行以下命令构建并启动服务：

    bash
    docker compose up -d

    首次构建需要较长时间，请耐心等待。构建完成后，服务会自动在后台运行。

  2. 查看启动状态：

    bash
    docker compose ps
docker compose logs -f backend

  3. 当 backend 服务状态变为 healthy 时，表示启动成功。

步骤四：访问系统 ​

路径：浏览器

  1. 浏览器打开平台地址：

    http://localhost:5173

  2. 输入默认账号和密码：

    字段值
    账号admin
    密码abc123

  3. 登录后进入主界面，顶部导航可切换团队。

步骤五：创建第一个团队/项目 ​

路径：顶部导航 → 团队/项目

  1. 点击顶部导航栏的团队下拉框，创建团队。
  2. 进入团队工作台后，创建项目。
  3. 切换到新建项目，开始使用 QA、接口测试、UI 自动化等功能。