Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iCepa/tun2tor
A rust library to provide a virtual utun interface to Tor
https://github.com/iCepa/tun2tor
Last synced: about 2 months ago
JSON representation
A rust library to provide a virtual utun interface to Tor
- Host: GitHub
- URL: https://github.com/iCepa/tun2tor
- Owner: iCepa
- License: mit
- Created: 2015-09-29T11:35:44.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-11-14T21:33:30.000Z (over 2 years ago)
- Last Synced: 2024-02-07T17:32:33.220Z (5 months ago)
- Language: Rust
- Size: 3.88 MB
- Stars: 98
- Watchers: 13
- Forks: 16
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-tor - tun2tor - Rust library to provide a virtual `utun` (userspace tunnel) interface to Tor. (Uncategorized / Uncategorized)
README
# tun2tor
**This project will most probably be discontinued.**
Have a look at [leaf](http://github.com/eycorsican/leaf), for something similar,
which is written in latest Rust and is way more flexible and stable.
[](https://travis-ci.org/iCepa/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](https://github.com/iCepa/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`](https://github.com/tokio-rs/tokio) for async IO and
[`LwIP`](http://savannah.nongnu.org/projects/lwip/) for its TCP implementation (for now).
[API Documentation](https://conradev.github.io/tun2tor)
## Running
Running `tun2tor` as a standalone utility is primarily useful for debugging at the moment.
Here is how to get it running:
```bash
$ git clone --recursive https://github.com/iCepa/tun2tor.git
$ cd tun2tor
$ cargo build
$ sudo RUST_BACKTRACE=1 target/debug/tun2tor
```
```bash
$ brew install tor
$ tor --DNSPort 12345 --AutomapHostsOnResolve 1
```
Running it requires root privileges in order to create a `utun` interface.
`tun2tor` is currently hardcoded in [`main.rs`](https://github.com/iCepa/tun2tor/blob/master/src/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:
```bash
// Test DNS:
$ sudo route add 8.8.8.8 172.30.20.1
$ dig @8.8.8.8 facebookcorewwwi.onion
// Test data:
$ sudo route add 116.202.120.181 172.30.20.1 // check.torproject.org
$ wget check.torproject.org
```
## Compiling for iOS
```bash
# If you use Homebrew:
$ brew install rustup
# (Note: Rust via brew can't give you the iOS targets! So do use Rustup!)
# If not: (See https://rustup.rs)
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Add cross-compile targets for iOS:
$ rustup target add aarch64-apple-ios x86_64-apple-ios
# Install cargo-lipo to create universal binaries:
$ cargo install cargo-lipo
# Compile:
$ cargo lipo
# The binary can be found in target/universal/
```
## Creating a header file
(Noted here for reference, in case you extend `tun2tor`.)
```bash
# Install header generator tool.
$ cargo install cbindgen
# Generate:
$ cbindgen --cpp-compat --crate tun2tor --lang C --output tun2tor.h
```