diff --git a/README.md b/README.md index 5481c5f..ae809ce 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,22 @@ # Spurt [![Go](https://github.com/zer-far/spurt/workflows/Go/badge.svg)](https://github.com/zer-far/spurt/actions?query=workflow%3A%22Go%22) -Spurt is a powerful testing tool designed to simulate high volumes of traffic and evaluate the performance and resilience of web servers. +## Introduction -## Building +Spurt is a powerful stress testing tool designed to simulate high volumes of traffic and evaluate the performance and resilience of web servers. It has been tested on Linux. + +Spurt first checks if the target URL is valid. A custom module is used to generate common "User-Agent" and "Referer" headers quickly, allowing it to make thousands of requests per second. Another module is used for multi-threading to send requests in parallel. + +## Compile + +### Prerequisites + +Make sure you have the following installed: +- Go +- Automake +- Git + +### Steps ```bash git clone https://github.com/zer-far/spurt @@ -11,15 +24,65 @@ cd spurt make ``` -## Usage +## Basic usage ```bash ./spurt --url https://example.com ``` + Press Ctrl+C to stop Spurt. -## Note +## Features + +### Target URL + +- Option: --url string + +- Description: Sets the target URL for requests. +- +### Check IP address + +- Option: --check + +- Description: Checks your public IP address before using it for testing. + +### Custom cookie + +- Option: --cookie string + +- Description: Uses a custom cookie. + +### Sleep time between requests + +- Option: --sleep int + +- Description: Sets a delay (in ms) between requests to avoid rate limits. + +- Default: 1 ms + +### Multi-threading + +- Option: --threads int +- Description: Specifies the number of threads for sending requests. +- Default: 1 thread + +### Request timeout + +- Option: --timeout int +- Description: Sets a timeout (in ms) for each request to handle slow responses. +- Default: 3000 ms + +### Example command + +```bash +./spurt --check --cookie "sessionid=123456" --sleep 10 --threads 2 --timeout 4000 --url https://example.com +``` + +This command uses the IP check, a custom cookie, a sleep time of 10 ms, 2 threads and a timeout ot 4000 ms. -Please note that the primary purpose of Spurt is to assess the performance and robustness of web servers under controlled conditions. It is not intended for malicious use or to facilitate any form of Denial of Service (DoS) attack. Unauthorized or inappropriate usage of this tool is strictly prohibited and may have legal consequences. +## Notes -Additionally, it's important to consider the potential impact on your internet connection while running Spurt. The tool generates a substantial amount of traffic, which may temporarily slow down your internet connection. +- Spurt is intended for testing server performance under controlled conditions. It should not be used maliciously or for Denial of Service (DoS) attacks. Unauthorised use may lead to legal consequences. +- Your internet connection may slow down during use. +- Excessive requests may result in rate limiting or blocking. +- Avoid using on connections with limited bandwidth.