4 releases

0.1.6 Feb 5, 2025
0.1.5 Nov 20, 2024
0.1.4 Mar 14, 2024
0.1.3 Feb 15, 2024
0.0.2 Jun 3, 2023

#997 in Network programming

Download history 149/week @ 2024-11-19 9/week @ 2024-11-26 110/week @ 2024-12-03 119/week @ 2024-12-10 9/week @ 2024-12-17 2/week @ 2024-12-24 7/week @ 2025-01-07 4/week @ 2025-01-14 138/week @ 2025-02-04 7/week @ 2025-02-11

145 downloads per month

MIT license

3MB
72K SLoC

C 71K SLoC // 0.2% comments GNU Style Assembly 280 SLoC // 0.4% comments Rust 251 SLoC // 0.0% comments Shell 171 SLoC // 0.0% comments

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