Current maintenance release: v1.9.1 maintenance release after v1.9.0, documenting GitHub Actions Node 24 compatibility workflow maintenance.
FedGuardLab 是一个面向联邦学习安全实验的轻量级交互式平台。
它的目标不是构建一个“大而全”的联邦学习 benchmark，而是提供一个易启动、可视化、可复现的实验环境，帮助学生、研究者和开发者直观理解联邦学习中的攻击、防御、训练过程和实验对比。
- 可视化联邦学习安全实验 Dashboard
- 默认中文界面，支持 English 切换
- FastAPI 后端 + Vue / Vite 前端
- YAML 实验配置与 Pydantic 校验
- 后台任务执行与实时指标查看
- 支持 Simulated trainer 快速演示
- 支持真实 MNIST + FedAvg 联邦学习训练
- 支持 IID / Dirichlet Non-IID 数据划分
- 支持 Label Flipping 攻击与 ASR 评估
- 支持 Backdoor 攻击与 Backdoor ASR 评估
- 支持 Median / Trimmed Mean / Krum 鲁棒聚合防御
- 支持单实验 HTML / CSV / Markdown 报告
- 支持多实验对比报告
- 支持 Docker Compose 一键启动
- 支持 GitHub Actions CI 与 Docker Smoke 验证
git clone https://github.com/Calvin1989/FedGuardLab.git
cd FedGuardLabconda create -n fedguardlab python=3.11 -y
conda activate fedguardlabpython -m pip install -r requirements-cpu.txtrequirements-cpu.txt 使用 CPU 版 PyTorch，适合本地开发、演示和 CI 环境。
uvicorn api.main:app --reload后端默认地址：
http://127.0.0.1:8000
API 文档：
http://127.0.0.1:8000/docs
打开另一个终端：
cd web
npm install
npm run dev前端默认地址：
http://localhost:3000
如果 3000 端口被占用，Vite 会自动切换到其他可用端口。
确保已经安装 Docker Desktop。
docker compose up --build访问地址：
前端：http://localhost:3000
后端：http://localhost:8000/docs
停止服务：
docker compose downruff check .
python quick_test.pycd web
npm run build
cd ..后端启动后运行：
python api_smoke_test.py等待实验任务完整结束并生成 finished job id：
python api_smoke_test.py --wait-finished --write-finished-job-id smoke_finished_job_id.txtdocker compose config
docker compose build
docker compose up -d
python api_smoke_test.py --wait-finished --write-finished-job-id smoke_finished_job_id.txt
type smoke_finished_job_id.txt
$jobId = Get-Content smoke_finished_job_id.txt
docker compose restart backend
Start-Sleep -Seconds 10
python api_smoke_test.py --check-recovery $jobId
docker compose down
Remove-Item smoke_finished_job_id.txtFedGuardLab 当前支持：
- Simulated Label Flipping Demo
- MNIST FedAvg Demo
- MNIST FedAvg + Label Flipping
- MNIST FedAvg + Backdoor Attack
- Label Flipping + Median Defense
- Label Flipping + Trimmed Mean Defense
- Label Flipping + Krum Defense
- Backdoor + Median Defense
- Backdoor + Trimmed Mean Defense
- Backdoor + Krum Defense
- 多实验指标对比与报告导出
更多说明见：
单实验输出目录：
reports/jobs/<job_id>/
├── config.json
├── metrics.json
├── metrics.csv
├── report.html
└── report.md
多实验对比输出目录：
reports/comparisons/<comparison_id>/
├── comparison.html
├── comparison.json
└── comparison.csv
这些运行产物默认不会提交到 GitHub。
当前维护版本：v1.9.1
版本状态：
v1.9.0：Experiment Result Management final release，完成历史实验管理、归档 / 恢复、对比历史、统一 report/artifact 入口，以及安全的 reports cleanup workflow。v1.9.1：maintenance release，记录 GitHub Actions Node 24 compatibility workflow maintenance，并确认 Docker Smoke manual workflow 通过。
兼容性说明：
- 不新增运行时依赖。
- 不改变已有 API 路径。
- 不改变训练核心算法。
- 不改变已有 report/artifact URL。
- 不改变 Docker runtime 行为。
- 不改变测试数据结构。
- 继续保持中文 / English 双语支持。
历史版本详情请查看：
MIT