portredirect 0.1.0

PortRedirect is a tool that bridges your frontend and backend by redirecting TCP connections through a persistent QUIC connection. It provides both a server (accepting TCP connections and forwarding them via QUIC) and a client (relaying QUIC streams to a TCP destination).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# PortRedirect-RS

*Glue your frontend to the backend!*

PortRedirect-RS is split into *server* and *client* side.

**Server:** Redirects incoming TCP connections (e.g. port 443) to a remote *client* through a persistent QUIC connection. Acts as a QUIC server.

**Client:** Redirects incoming server-initiated QUIC streams to a *destination* TCP host and port (e.g. `localhost:443`). Acts as a QUIC client to the QUIC server, i.e. initiates the QUIC connection.

[![codecov](https://codecov.io/gh/unspezifisch/portredirect-rs/graph/badge.svg?token=TJSQNU6NMR)](https://codecov.io/gh/unspezifisch/portredirect-rs)

## Testing the server

```sh
RUST_LOG=tracing=debug cargo run --bin portredirect_server -- --local-host 127.0.0.1 --local-port 12345 --quic-server-host 127.0.0.1 --quic-server-port 4433 --quic-psk supersecret --mode quic
```

## Testing the client

```sh
RUST_LOG=tracing=debug cargo run --bin portredirect_client -- --destination-host 127.0.0.1 --destination-port 20000 --quic-server-host 127.0.0.1 --quic-server-port 4433 --quic-psk supersecret
```

## Limitations

- Currently IPv4-only, TCP-only
- Currently 1 server, 1 client in a 1:1 QUIC connection

## License

`GPL-3.0-only`