AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它将 Web 界面的简洁性与异步 Python 的强大功能相结合，可实时显示吞吐量统计和 HTTP 状态分布，使负载测试变得直观且易于使用。

适合谁使用

需要快速检查 API 性能的开发者
进行容量规划的 DevOps 工程师
学习异步基准测试的学生
在负载下测试服务可靠性的 QA 工程师

典型使用场景

开发过程中对 REST API 端点进行基准测试
比较不同后端配置的性能
对个人或授权服务器进行压力测试以进行容量规划
在教育环境中演示异步 Python 性能概念

项目优势

响应式 Web 界面中实时显示每秒请求数 (RPS) 和 HTTP 状态统计
轻量级且易于部署，依赖项少（纯 Python、FastAPI、aiohttp）
可配置并发，支持 GET/POST 请求及自定义头信息
清晰的示例输出显示吞吐量和错误分布

使用前须知

仅支持 GET 和 POST 两种 HTTP 方法（不支持 PUT、DELETE 等）
Web 界面可能不适合无人值守或自动化 CI/CD 流程
与编译型工具相比，Python 异步运行时的性能上限限制了极高压力的场景

README 快速开始

⚡ Guevara Benchmark

High-performance asynchronous HTTP load testing & benchmarking tool

Built with FastAPI, aiohttp, and asyncio for developers who need fast, lightweight, and modern API benchmarking.

✨ Features

⚡ High-performance asynchronous requests
🚀 Configurable concurrency
📊 Live Requests Per Second (RPS)
📈 HTTP status statistics
🖥️ Modern responsive Web UI
📝 Custom HTTP headers
📦 GET & POST support
🔒 Transparent User-Agent by default
🐍 Pure Python
💨 Lightweight & easy to deploy

📸 Screenshots

Dashboard

Benchmark Result

🚀 Installation

Quick Start

git clone https://github.com/AlguevaraSec/Guevara-benchmark.git

cd Guevara-benchmark

pip install -r requirements.txt

python main.py

# or

uvicorn main:app --reload

Open your browser:

http://127.0.0.1:8000

📊 Example Result

BENCHMARK COMPLETE

----------------------------------------
Total Requests : 5000
Time Elapsed   : 4.72 seconds
Throughput     : 1059.3 req/sec
----------------------------------------

HTTP 200 : 4987
HTTP 522 : 13

⚙️ Built With

Technology	Purpose
FastAPI	Backend Framework
aiohttp	Async HTTP Client
asyncio	Concurrency
Uvicorn	ASGI Server
HTML / CSS / JavaScript	Frontend

🛡️ Protect Your Server

Benchmarking is useful—but every public service should also be protected.

✅ Rate Limiting

Implement request limits at your application or reverse proxy.

Recommended options:

FastAPI Rate Limiting Middleware
Nginx Rate Limiting
Traefik Rate Limiting

☁️ Cloudflare

Cloudflare's free plan provides excellent protection for most applications.

Benefits

🛡️ Layer 4 & Layer 7 DDoS Protection
🔥 Web Application Firewall (WAF)
🤖 Bot Protection
⚡ Global CDN
🚦 Rate Limiting (advanced features depend on plan)
🔒 Recommended to hide your origin server IP behind Cloudflare

For small and medium-sized websites, Cloudflare is one of the easiest ways to improve availability and resilience.

⚠️ Educational & Authorized Use Only

This project is intended only for:

✅ Performance testing
✅ Load benchmarking
✅ Capacity planning
✅ Educational purposes
✅ Testing systems you own or are explicitly authorized to

项目描述

🚀Lightweight HTTP load testing tool with a modern web UI. Benchmark your APIs using configurable concurrency, custom headers, and real-time performance metrics.

Guevara-benchmark