tun2tor
tun2tor
is a Rust library that creates a utun
(userspace tunnel) interface, and connects it to to a stream-based proxy like tor
. It is primarily intended to be embedded in the iCepa project, but it can also be used as a standalone utility.
Currently, only macOS and iOS are supported, although Linux support is almost there.
tun2tor
uses tokio
for async IO and LwIP
for its TCP implementation (for now).
Running
Running tun2tor
as a standalone utility is primarily useful for debugging at the moment. Here is how to get it running:
$ git clone --recursive https://github.com/iCepa/tun2tor.git
$ cd tun2tor
$ cargo build
$ sudo target/debug/tun2tor
$ tor --DnsPort 12345
Running it requires root privileges in order to create a utun
interface. tun2tor
is currently hardcoded in main.rs
to create an interface with an IP address of 172.30.20.1
, look for a SOCKS proxy at 127.0.0.1:9050
, and look for a DNS server at 127.0.0.1:12345
.
In order to route traffic through the interface, you need to modify the route table:
$ sudo route add 8.8.8.8 172.30.20.1
$ dig @8.8.8.8 facebookcorewwwi.onion