Skip to content

Readme.md

Latest commit

 

History

History
119 lines (83 loc) · 2.31 KB

Readme.md

File metadata and controls

119 lines (83 loc) · 2.31 KB

🚀 High-Performance C++ Web Server with Load Balancing and LRU Cache

A multi-threaded web server written in modern C++ featuring:

  • Round-robin load balancing
  • Thread-safe LRU caching
  • Static file serving
  • Docker support
  • Built from scratch using POSIX sockets and threads

🔄 System Flow Chart

System Architecture Flow Chart

📦 Project Structure

web-server/
├── src/                  # Core source files
│   ├── main.cpp          # Entry point with server setup
│   ├── web_server.hpp    # Backend HTTP server
│   ├── proxy_server.hpp  # Caching proxy & load balancer
│   ├── lru_cache.hpp     # Thread-safe LRU implementation
│   └── load_balancer.hpp # Round-robin dispatcher
│── index.html            # Example homepage(html/css)
├── Makefile              # Build configuration
├── Dockerfile            # Container setup
└── README.md             # This file

🚀 Features

✅ Multi-threaded Architecture
✅ Intelligent Load Balancing
✅ LRU Caching (5,000+ entries)
✅ Static File Support
✅ 26,000+ req/sec throughput
✅ Docker-ready Deployment

🔧 Quick Start

Local Build (Manually)

git clone https://github.com/sidd2512/web-server.git
cd web-server
make && ./web-server

Run with Docker

Pull the prebuilt Docker image directly from Docker Hub:

docker pull sid2512/web-server

Run the container

docker run -p 8080:8080 sid2512/web-server

Test Endpoint

Using curl:

curl http://localhost:8080/

Or open in your web browser:

http://localhost:8080/

📈 Benchmark

Tested with wrk:

wrk -t4 -c100 -d10s http://localhost:8080/
Metric Result
Requests/sec 26,422
Avg Latency ~3.5 ms
Backends 3
Cache Size 5,000 entries
Transfer Rate 16.08 MB/s
Cache Hit Rate 92% (warm)

🛠️ Technology Stack

  • C++17 (STL containers, threading)
  • POSIX sockets (TCP networking)
  • LRU cache (std::unordered_map + list)
  • Round-robin load balancing
  • Docker for containerization

📜 License

MIT License © 2025 Siddharth Kumar