tokio-multi-proxy 0.1.2

A modular async proxy with TLS/mTLS and multiple transport support
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

# tokio-multi-proxy


[![Crates.io](https://img.shields.io/crates/v/tokio-multi-proxy.svg)](https://crates.io/crates/tokio-multi-proxy)
[![Docs.rs](https://docs.rs/tokio-multi-proxy/badge.svg)](https://docs.rs/tokio-multi-proxy)
[![CI](https://github.com/ahmed-masud/tokio-multi-proxy/actions/workflows/ci.yml/badge.svg)](https://github.com/ahmed-masud/tokio-multi-proxy/actions/workflows/ci.yml)

**An async, modular proxy with support for TCP, UDP, Unix sockets, TLS, and mutual TLS. Built on [Tokio](https://tokio.rs) and [Rustls](https://github.com/rustls/rustls).**

---

## ✨ Features

- 🔌 Raw TCP passthrough
- 🌊 UDP datagram proxying
- 🧱 Unix Domain Socket bridging
- 🔐 TLS termination
- 🔐 Mutual TLS (mTLS) authentication
- ⚙️ Compile-time feature flags to minimize dependencies

---

## 📦 Install

Add to your `Cargo.toml`:

```toml
tokio-multi-proxy = { version = "0.1.0", features = ["tls", "mtls"] }
```

Or if using only TCP passthrough (no TLS):

```toml
tokio-multi-proxy = "0.1.0"
```

---

## 🚀 Examples

Run examples with:

```bash
cargo run --example tcp           # plain TCP
cargo run --example udp           # UDP
cargo run --example unix          # Unix socket
cargo run --example tls --features tls         # TLS
cargo run --example mtls --features mtls       # mTLS
```

---

## 🔧 Usage

### TCP

```rust
tokio_multi_proxy::start_tcp("0.0.0.0:8080", "127.0.0.1:9000").await?;
```

### TLS

```rust
tokio_multi_proxy::start_tls_tcp("0.0.0.0:443", "127.0.0.1:8080", "cert.pem", "key.pem").await?;
```

### mTLS

```rust
tokio_multi_proxy::start_mtls_tcp("0.0.0.0:443", "127.0.0.1:8080", "cert.pem", "key.pem", "ca.pem").await?;
```

---

## 🛠 Features

| Feature     | Description                         |
|-------------|-------------------------------------|
| `passthrough` | Raw TCP proxying (default)         |
| `tls`         | TLS termination support            |
| `mtls`        | Mutual TLS (requires `tls`)        |

Enable with:

```bash
cargo build --features tls
```

---

## 🔐 Dev Certificate (for local testing)

```bash
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout examples/key.pem -out examples/cert.pem \
  -subj "/CN=localhost"

# Optional mTLS CA
cp examples/cert.pem examples/ca.pem
```

---

## 📚 Documentation

- [API Docs (docs.rs)](https://docs.rs/tokio-multi-proxy)
- Build locally:
  ```bash
  cargo doc --all-features --open
  ```

---

## 🪪 License

Licensed under either of:

- MIT
- Apache-2.0

---

## 👤 Author

**Ahmed Masud** — [saf.ai](https://saf.ai)  
MIT/Apache dual-license. Contributions welcome!