7 releases

Uses new Rust 2024

0.1.10 Aug 22, 2025
0.1.8 Mar 5, 2025
0.1.5 Nov 20, 2024
0.1.4 Mar 14, 2024
0.1.0 Jun 5, 2023

#1469 in Network programming

Download history 32/week @ 2025-08-29 17/week @ 2025-09-05 2/week @ 2025-09-12 51/week @ 2025-09-19 30/week @ 2025-09-26 4/week @ 2025-10-03

687 downloads per month

MIT license

3.5MB
73K SLoC

C 73K SLoC // 0.2% comments GNU Style Assembly 289 SLoC // 0.3% comments Shell 179 SLoC // 0.0% comments Rust 59 SLoC

Contains (Windows DLL, 430KB) impl/third-part/wintun/bin/wintun.dll

Tun2Socks

Rust bindings for HevSocks5Tunnel

Features

  • IPv4/IPv6. (dual stack)
  • Redirect TCP connections.
  • Redirect UDP packets. (Fullcone NAT, UDP in UDP/TCP)
  • Linux/Android/FreeBSD/macOS/iOS.

Benchmarks

See here for more details.

Speed

CPU usage

Memory usage

API

/// Start and run the socks5 tunnel, this function will blocks until the
/// quit() is called or an error occurs.
///
/// # Arguments
///
/// * `config_path` - config file path
/// * `tun_fd` - tunnel file descriptor
///
/// # Returns
///
/// Returns Ok(()) on successful, otherwise returns Err(r).
pub fn main_from_file(config_path: &Path, tun_fd: RawFd) -> Result<(), i32>

/// Start and run the socks5 tunnel, this function will blocks until the
/// quit() is called or an error occurs.
///
/// # Arguments
///
/// * `config_str` - config string
/// * `tun_fd` - tunnel file descriptor
///
/// # Returns
///
/// Returns Ok(()) on successful, otherwise returns Err(r).
pub fn main_from_str(config_str: &str, tun_fd: RawFd) -> Result<(), i32>

/// Stop the socks5 tunnel.
pub fn quit()

Contributors

License

MIT

No runtime deps