This project showcases a complete HTTP server implementation. Built entirely from scratch using Python's standard library, it demonstrates :

• System Programming - Low-level socket programming and network protocols
• Concurrent Programming - Multi-threading with bounded thread pools
• Security Engineering - Comprehensive security measures and attack prevention
• Production Operations - Monitoring, logging, and deployment automation
• Modern DevOps - Production deployment and monitoring practices

See it in action! Run the comprehensive test suite to showcase all features:

# Start the server
python server.py 8080 127.0.0.1 4

# Run the comprehensive test suite
python final_demo_test.py

Demo Output: Screenshots:

• ✅ Persistent Connections - Keep-alive with 30-second idle timeout
• ✅ Request Limits - Maximum 100 requests per connection
• ✅ Proper Headers - Connection, Keep-Alive, Content-Type, Content-Length
• ✅ Status Codes - 200, 201, 400, 403, 404, 405, 415, 503

• ✅ Thread Pool - Fixed-size worker thread pool with bounded queue
• ✅ Graceful Degradation - 503 responses when thread pool is saturated
• ✅ Connection Management - Efficient socket handling and cleanup
• ✅ Resource Optimization - Bounded queue prevents memory exhaustion
• ✅ High Throughput - 500+ requests/second capability

• ✅ Path Traversal Protection - Blocks ../ and percent-encoded attacks
• ✅ Host Header Validation - Prevents Host header injection attacks
• ✅ Input Sanitization - JSON validation and content-type checking
• ✅ Security Logging - Comprehensive audit trail for security violations
• ✅ Rate Limiting - Per-IP rate limiting with burst protection
• ✅ Request Size Limiting - DoS protection with configurable limits
• ✅ CORS Support - Cross-origin resource sharing for web applications
• ✅ Security Dashboard - Real-time attack monitoring and visualization

• ✅ Thread Tracking - Real-time thread status monitoring
• ✅ JSON Logging - Structured logging for analysis
• ✅ Security Audit - Detailed security violation logging
• ✅ Performance Metrics - Request timing and thread utilization
• ✅ Response Time Tracking - Per-request performance monitoring
• ✅ Memory Monitoring - System resource usage tracking
• ✅ Prometheus Metrics - /metrics endpoint for monitoring systems
• ✅ Connection Pooling - Efficient resource management

• ✅ Unit Tests - 28+ tests with 100% pass rate
• ✅ Integration Tests - Complete end-to-end testing
• ✅ Load Testing - Thread pool saturation and 503 behavior
• ✅ Security Testing - Path traversal and Host header validation
• ✅ Performance Testing - Concurrent request handling

• Python 3.11 or higher
• No external dependencies (uses only standard library)

# Clone the repository
git clone https://github.com/ujjwaljain16/multi-threaded-http-server.git


# Install dependencies (optional - for monitoring features)
pip install -r requirements.txt

# Basic usage (default: 127.0.0.1:8080, 10 threads)
python server.py

# Custom configuration
python server.py 9090 0.0.0.0 20

# Get performance metrics
curl http://127.0.0.1:8080/metrics

# View security dashboard
curl http://127.0.0.1:8080/security-dashboard

# Test CORS
curl -H "Origin: http://localhost:3000" http://127.0.0.1:8080/

# Test advanced features
python test_advanced_features.py

This project includes comprehensive documentation:

• Technical Documentation - Implementation details, architecture, and technical specifications

├── server.py                      # Main server entry point
├── server_lib/                    # Core server modules
│   ├── __init__.py               # Package initialization
│   ├── http_parser.py            # HTTP request parsing
│   ├── threadpool.py             # Thread pool implementation
│   ├── security.py               # Security and validation
│   ├── response.py               # HTTP response building
│   ├── logger.py                 # Enhanced logging system
│   ├── metrics.py                # Performance metrics collection
│   ├── metrics_endpoint.py       # Metrics API endpoint
│   ├── rate_limiter.py           # Rate limiting implementation
│   ├── request_limiter.py        # Request size limiting
│   ├── cors.py                   # CORS support
│   ├── security_dashboard.py     # Security monitoring dashboard
│   ├── connection_pool.py        # Connection pooling
│   └── utils.py                  # Utility functions
├── resources/                     # Static files and samples
│   ├── index.html                # Professional homepage
│   ├── about.html                # Technical documentation
│   ├── contact.html              # Interactive API testing
│   ├── logo.png                  # Logo image
│   ├── photo.jpg, photo2.jpg     # Sample images
│   ├── big.png                   # Large image for testing
│   ├── readme.txt                # Text file for testing
│   ├── sample.txt                # Sample text file
│   ├── sample_data.json          # Sample JSON data
│   ├── simple_test.json          # Test JSON file
│   ├── test_payload.json         # Test payload
│   └── uploads/                  # POST upload directory
│       └── upload_*.json         # Uploaded files
├── final_demo_test.py            # Comprehensive test suite (28 tests)
├── quick_test.py                 # Quick functionality test
├── requirements.txt              # Python dependencies
├── REQUIREMENTS_CHECKLIST.md     # Requirements verification
├── TECHNICAL_DOCUMENTATION.md    # Technical implementation docs
├── THEORETICAL_DOCUMENTATION.md  # Theoretical concepts docs
├── security.log                  # Security violation logs
└── README.md                     # This file

# Get homepage
curl http://127.0.0.1:8080/

# Download text file
curl -O http://127.0.0.1:8080/readme.txt

# Download image
curl -O http://127.0.0.1:8080/logo.png

# Get JSON data
curl http://127.0.0.1:8080/sample_data.json

# Upload JSON
curl -X POST -H "Content-Type: application/json" \
     -d '{"test": "data"}' http://127.0.0.1:8080/upload

# Get metrics
curl http://127.0.0.1:8080/metrics

# View security dashboard
curl http://127.0.0.1:8080/security-dashboard

# Test security (should return 403)
curl http://127.0.0.1:8080/../etc/passwd

python server.py [port] [host] [thread_pool_size]

• port: Server port (default: 8080)

• host: Server host (default: 127.0.0.1)

• thread_pool_size: Number of worker threads (default: 10

  ---