# lmtester-deploy

**Repository Path**: zonasw/lmtester-deploy

## Basic Information

- **Project Name**: lmtester-deploy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-14
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LMTester 一键部署 (Deployment)

<div align="center">

**LMTester** 自动化测试平台的统一部署仓库

[![Docker](https://img.shields.io/badge/Docker-20.10%2B-blue)](https://www.docker.com/)
[![Docker Compose](https://img.shields.io/badge/Docker%20Compose-2.0%2B-blue)](https://docs.docker.com/compose/)

</div>

---

## 架构说明

本项目使用 **Docker Compose** 将各组件编排在一起，支持一键启动和数据持久化。

| 组件 | 说明 | 访问路径 |
|------|------|----------|
| **前端** | React/Vue 应用运行在 Nginx 容器中 | `/lmtester/` |
| **后端** | FastAPI 应用运行在 Python 容器中 | `/lmtester/api/` |
| **数据存储** | 持久化存储在宿主机 | `./data` 目录 |

---

## 前置要求

- **Git**
- **Docker** (建议版本 20.10+)
- **Docker Compose** (建议版本 2.0+)

---

## 快速开始

### 1. 克隆仓库

> ⚠️ **重要**：必须使用 `--recursive` 参数以同时拉取子模块代码

```bash
git clone --recursive https://gitee.com/zonasw/lmtester-deploy.git
cd lmtester-deploy
```

如果克隆时忘记加 `--recursive`，导致子模块目录为空，请运行：
```bash
git submodule update --init --recursive
```

### 2. 配置环境变量

1. 复制示例配置文件：
```bash
cp .env.example .env
```

2. 编辑 `.env` 文件，填入您的 LLM API 密钥（**必须**）：
```env
OPENAI_API_KEY=sk-or-v1-121******
OPENAI_BASE_URL=https://openrouter.ai/api/v1
MIDSCENE_MODEL_NAME=google/gemini-3-flash-preview
MIDSCENE_MODEL_FAMILY=gemini

PLANNER_OPENAI_API_KEY=sk-or-v1-121******
PLANNER_OPENAI_BASE_URL=https://openrouter.ai/api/v1
PLANNER_LLM_MODEL=google/gemini-3-flash-preview
```

### 3. 启动服务

执行构建并启动容器：
```bash
docker-compose up -d --build
```

---

## 访问应用

启动成功后，请通过浏览器访问：

| 服务 | 地址 | 说明 |
|------|------|------|
| **前端页面** | http://localhost:8080/lmtester/ | 主入口（注意末尾斜杠） |
| **后端 API 文档** | http://localhost:8080/lmtester/docs | Swagger UI |

> 💡 **提示**：如果部署在远程服务器，请将 `localhost` 替换为服务器 IP

---

## 维护与更新

### 更新代码

当开发仓库有更新时，无需重新 Clone：

```bash
# 拉取最新代码 (前端+后端)
git submodule update --remote --merge

# 重新构建镜像并重启
docker-compose up -d --build --remove-orphans
```

### 查看日志

如果遇到问题，首先查看日志：

```bash
# 查看所有日志
docker-compose logs -f

# 只查看后端日志
docker-compose logs -f backend
```

### 修改配置

如需修改后端配置（如日志级别、并发数等）：

1. 修改本地文件 `data/config/settings.yaml`
2. 重启后端服务：
```bash
docker-compose restart backend
```

---

## License

请查看项目根目录的 LICENSE 文件了解详细信息。