Hyproxy: a reverse proxy for HTTP

Hyproxy is an HTTP reverse proxy built on Hyper and Tokio. It aims for high throughput and low memory consumption. It is meant to demonstrate the usefulness of Rust's new asynchronous I/O stack, Tokio, for building high-performance servers.

This project is under construction! Many features are missing, do not use in production!

Required features for 1.0:

• Detailed logging
• Static files support
• Virtual Hosts/SNI
• Better documentation

Installation

As of now, this project is not on crates.io, therefore you will have to build it from git:

$ git clone https://github.com/moosingin3space/hyproxy.git
$ cargo build --release

The resulting binary at target/release/hyproxy is the Hyproxy executable.

Running

Hyproxy reads a file Hyproxy.toml in the current working directory, which configures route-to-server mappings. A sample Hyproxy.toml file is provided in this repository, and another sample is provided here:

[general]
listen_addr = "0.0.0.0:8000"

[paths]
# Proxying to your app's server
"/app" = "http://localhost:2015"

# Proxying to a remote server works too
"/static" = "https://cdn.site.org"

To configure SSL/TLS, the tls_key parameter of the general table must be set to a PKCS#12 that contains the private key and the chain of certificates for the server. The tls_password must also be set to the password used to protect the file. Both parameters must be set to enable SSL/TLS.

[general]
listen_addr = "0.0.0.0:4443"
tls_key = "identity.p12"
tls_password = "strongpassword?"

This syntax will be extended to support some of the features mentioned above.