Skip to content

HttpWard¶

A high-performance HTTP proxy and reverse proxy server built with Rust, designed for modern web applications and microservices architecture.

Overview¶

HttpWard is a powerful, flexible, and efficient proxy server that provides:

High Performance: Built with Rust for maximum speed and reliability
Flexible Configuration: YAML-based configuration with advanced routing and middleware support
Modern Architecture: Support for HTTP/1.1, HTTP/2, and WebSocket protocols
Extensible: Plugin system for custom middleware and extensions
Production Ready: Comprehensive logging, monitoring, and error handling

Quick Start¶

Installation¶

cargo install httpward

Basic Configuration¶

Create a httpward.yaml file:

# Basic HTTP proxy configuration
server:
  host: "0.0.0.0"
  port: 8080
  tls: false

sites:
  - name: "example"
    domains:
      - "example.com"
      - "www.example.com"
    routes:
      - match:
          path: "/"
        backend: "http://localhost:3000"

Running HttpWard¶

httpward --config httpward.yaml

Key Features¶

Advanced Routing¶

Path-based routing with regex support
Domain-based virtual hosting
HTTP method matching
Header and query parameter routing

Middleware System¶

Rate limiting
Authentication and authorization
CORS handling
Request/response transformation
Custom middleware support

TLS/SSL Support¶

Automatic certificate management
SNI-based routing
Custom certificate configuration

Monitoring & Logging¶

Structured logging with multiple levels
Request tracing
Performance metrics
Health check endpoints

Documentation¶

Configuration Guide - Complete configuration reference
Configuration Examples - Practical examples and use cases
Extensions Guide - Building and using extensions
Extensions Migration Guide - Migrating between extension versions

Community¶

GitHub: https://github.com/ZEREX222/HttpWard
Issues: Report bugs and request features
Discussions: Community discussions and Q&A

License¶

HttpWard is licensed under the MIT License. See LICENSE for details.