24 releases

0.9.6 Mar 25, 2024
0.9.2 Nov 30, 2023
0.8.2 Apr 3, 2023
0.8.1 Aug 25, 2022
0.3.0 Jan 19, 2020

#86 in Network programming

Download history 7378/week @ 2024-08-20 7664/week @ 2024-08-27 6848/week @ 2024-09-03 6445/week @ 2024-09-10 7309/week @ 2024-09-17 7323/week @ 2024-09-24 8404/week @ 2024-10-01 8998/week @ 2024-10-08 10171/week @ 2024-10-15 9573/week @ 2024-10-22 7820/week @ 2024-10-29 7976/week @ 2024-11-05 8239/week @ 2024-11-12 9325/week @ 2024-11-19 10037/week @ 2024-11-26 7497/week @ 2024-12-03

36,411 downloads per month
Used in 15 crates (8 directly)

MIT license

100KB
2K SLoC

SOCKS5 client/server library using async/.await

License crates.io dependency status Release

This library is maintained by anyip.io a residential and mobile socks5 proxy provider.

Features

  • An async/.await SOCKS5 implementation.
  • An async/.await SOCKS4 Client implementation.
  • An async/.await SOCKS4a Client implementation.
  • No unsafe code
  • Built on-top of tokio library
  • Ultra lightweight and scalable
  • No system dependencies
  • Cross-platform
  • Authentication methods:
    • No-Auth method
    • Username/Password auth method
    • Custom auth methods can be implemented via the Authentication Trait
    • Credentials returned on authentication success
  • All SOCKS5 RFC errors (replies) should be mapped
  • AsyncRead + AsyncWrite traits are implemented on Socks5Stream & Socks5Socket
  • IPv4, IPv6, and Domains types are supported
  • Config helper for Socks5Server
  • Helpers to run a Socks5Server à la "std's TcpStream" via incoming.next().await
  • Examples come with real cases commands scenarios
  • Can disable DNS resolving
  • Can skip the authentication/handshake process, which will directly handle command's request (useful to save useless round-trips in a current authenticated environment)
  • Can disable command execution (useful if you just want to forward the request to a different server)

Install

Open in crates.io.

Examples

Please check examples directory.

# Run client
RUST_LOG=debug cargo run --example client -- --socks-server 127.0.0.1:1337 --username admin --password password -a perdu.com -p 80

# Run server
RUST_LOG=debug cargo run --example server -- --listen-addr 127.0.0.1:1337 password -u admin -p password

# Test it with cURL
curl -v --proxy socks5://admin:password@127.0.0.1:1337 https://ipapi.co/json/

TODO

  • Tests have to be implemented
  • Better Rust doc
  • UDP bind command not implemented

Inspired by

Thanks to all these SOCKS5 projects

Further consideration

Dependencies

~3–11MB
~118K SLoC