94 lines
4.2 KiB
Markdown
94 lines
4.2 KiB
Markdown
# `protomask`: Fast & reliable user space NAT64
|
|
[](https://github.com/ewpratten/protomask/releases/latest)
|
|
[](https://github.com/ewpratten/protomask/actions/workflows/build.yml)
|
|
[](https://github.com/ewpratten/protomask/actions/workflows/audit.yml)
|
|
|
|
> The protomask tool suite is a collection of user space tools that translate packets between OSI layer 3 protocol versions
|
|
|
|
This repository (referred to as the *protomask tool suite*) contains the following sub-projects:
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<td><strong>Crate</strong></td>
|
|
<td><strong>Info</strong></td>
|
|
<td><strong>Latest Version</strong></td>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><a href="./src/protomask.rs"><code>protomask</code></a></td>
|
|
<td>User space NAT64 implementation</td>
|
|
<td><a href="https://crates.io/crates/protomask"><img src="https://img.shields.io/crates/v/protomask" alt="crates.io"></a></td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./src/protomask-clat.rs"><code>protomask-clat</code></a></td>
|
|
<td>User space Customer-side transLATor (CLAT) implementation</td>
|
|
<td><a href="https://crates.io/crates/protomask"><img src="https://img.shields.io/crates/v/protomask" alt="crates.io"></a></td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./libs/easy-tun/"><code>easy-tun</code></a></td>
|
|
<td>A pure-rust TUN interface library</td>
|
|
<td>
|
|
<a href="https://crates.io/crates/easy-tun"><img src="https://img.shields.io/crates/v/easy-tun" alt="crates.io"></a>
|
|
<a href="https://docs.rs/easy-tun"><img src="https://docs.rs/easy-tun/badge.svg" alt="docs.rs"></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./libs/fast-nat/"><code>fast-nat</code></a></td>
|
|
<td>An OSI layer 3 Network Address Table built for speed</td>
|
|
<td>
|
|
<a href="https://crates.io/crates/fast-nat"><img src="https://img.shields.io/crates/v/fast-nat" alt="crates.io"></a>
|
|
<a href="https://docs.rs/fast-nat"><img src="https://docs.rs/fast-nat/badge.svg" alt="docs.rs"></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./libs/interproto/"><code>interproto</code></a></td>
|
|
<td>Utilities for translating packets between IPv4 and IPv6</td>
|
|
<td>
|
|
<a href="https://crates.io/crates/interproto"><img src="https://img.shields.io/crates/v/interproto" alt="crates.io"></a>
|
|
<a href="https://docs.rs/interproto"><img src="https://docs.rs/interproto/badge.svg" alt="docs.rs"></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./libs/rfc6052/"><code>rfc6052</code></a></td>
|
|
<td>A Rust implementation of RFC6052</td>
|
|
<td>
|
|
<a href="https://crates.io/crates/rfc6052"><img src="https://img.shields.io/crates/v/rfc6052" alt="crates.io"></a>
|
|
<a href="https://docs.rs/rfc6052"><img src="https://docs.rs/rfc6052/badge.svg" alt="docs.rs"></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="./libs/rtnl/"><code>rtnl</code></a></td>
|
|
<td>Slightly sane wrapper around rtnetlink</td>
|
|
<td>
|
|
<a href="https://crates.io/crates/rtnl"><img src="https://img.shields.io/crates/v/rtnl" alt="crates.io"></a>
|
|
<a href="https://docs.rs/rtnl"><img src="https://docs.rs/rtnl/badge.svg" alt="docs.rs"></a>
|
|
</td>
|
|
</tbody>
|
|
</table>
|
|
|
|
## Installation
|
|
|
|
Protomask can be installed using various methods:
|
|
|
|
### Debian
|
|
|
|
Head over to the [releases](https://github.com/ewpratten/protomask/releases) page and download the latest release for your architecture.
|
|
|
|
Then, install with:
|
|
|
|
```sh
|
|
apt install /path/to/protomask_<version>_<arch>.deb
|
|
|
|
# You can also edit the config file in /etc/protomask.toml
|
|
# And once ready, start protomask with
|
|
systemctl start protomask
|
|
```
|
|
|
|
### Using Cargo
|
|
|
|
```bash
|
|
cargo install protomask
|
|
```
|