Let your servers breathe, let your clients breathe, all via a simple configuration file.

• Oxygn is a lightweight, high-performance single-binary reverse proxy server.

• It operates as a fast TCP tunnel that sits between your clients and backend services, allowing you to seamlessly manage traffic routing without complex setups.

• oxygn exists to provide a simple, secure, and easily configurable proxy solution that protects your backend applications from overload while guaranteeing continuous availability.

• Universal Protocol Support: Routes raw TCP traffic directly.
  • Proxies HTTP/1.1, HTTP/2, HTTPS (SSL/TLS passthrough), WebSockets, and database streams seamlessly.
• Intelligent Load Balancing: Distributes incoming client connections evenly across multiple backend servers.
  • Ensures no single server is overwhelmed by requests.
  • Automatically handles routing across different host machines and ports.
• Active Health Checking: Continuously monitors the health of your backend pool.
  • Performs fast, parallel checks to detect outages without delaying client requests.
  • Automatically removes unresponsive servers from the routing pool.
  • Supports lightweight TCP ping checks and robust HTTP application-level checks.
• Strict Rate Limiting: Protects your services from abuse and traffic spikes.
  • Enforces maximum request limits per client IP address within configurable time windows.
  • Operates with a strictly bounded memory footprint, ensuring the proxy never consumes excessive system resources.
• Simple Declarative Configuration: Managed entirely through a single, YAML file.

• First Install the project using the installation guide
• Next setup your config.yaml file using the configuration reference
• Finally start the proxy using the startup guide

• Whats the architecture of this project ? (You can view)
• Is this project open to open source contributions ? Yes checkout contribution guide
• How can i run benchmarks on my setup? Using the benchmarking tool

Benchmarks were run on localhost with oxygn and nginx both configured as TCP stream proxies (Layer 4), routing to the same pool of 3 Rust async HTTP backends to ensure a fair, apples-to-apples comparison.

oxygn achieves ~94% of nginx's throughput while being a single-binary Rust application with a fraction of the configuration complexity.

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.