MinhBang1000/hsl-ctf-management
GitHub: MinhBang1000/hsl-ctf-management
一个本地优先的 Web 管理平台，用于追踪 CTF 团队成员在 Root Me 等平台上的训练进度，以 Google Drive Excel 工作簿作为数据唯一来源。
Stars: 0 | Forks: 0
# HSLab Root Me CTF 管理器
用于管理 HSLab Root Me 培训的本地 Web 应用程序，基于单一权威的
Google Drive `.xlsx` 工作簿。
此实现特意采用本地优先策略：
- 配置位于 `.env` 中。
- 默认禁用登录。
- 工作簿依然是业务数据的唯一真实来源。
- Web 请求会将写入任务加入队列；由 `python -m app.worker` 执行工作簿写入。
- 在设置 `GOOGLE_DRIVE_WRITE_ENABLED=true` 之前，Google Drive 的写入功能处于禁用状态。
## 快速开始
```
conda activate ctf
cp .env.example .env
python -m pip install -e ".[dev]"
python scripts/create_workbook_template.py --output data/work/HSLab_RootMe_Fall_2026.xlsx
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```
在另一个终端中：
```
conda activate ctf
python -m app.worker
```
打开 。
## Google Drive 模式
在 `.env` 中填写以下值：
```
WORKBOOK_STORAGE=google_drive
GOOGLE_DRIVE_FILE_ID=
GOOGLE_DRIVE_CREDENTIALS_FILE=secrets/google-service-account.json
GOOGLE_DRIVE_WRITE_ENABLED=false
```
首先进行验证：
```
python scripts/validate_drive_access.py
python scripts/validate_workbook.py
```
仅在备份和验证结果正确无误后，才启用写入功能：
```
GOOGLE_DRIVE_WRITE_ENABLED=true
```
## 常用命令
```
ruff check .
ruff format --check .
mypy app
pytest --cov=app --cov-report=term-missing
python scripts/smoke_test.py
```
标签：AV绕过, FastAPI, Python, 任务调度, 团队管理, 安全规则引擎, 数据同步, 无后门, 逆向工具