This library is maintained by anyip.io a residential and mobile socks5 proxy provider.
- An
async/.awaitSOCKS5 implementation. - An
async/.awaitSOCKS4 Client implementation. - An
async/.awaitSOCKS4a Client implementation. - No unsafe code
- Built on-top of
tokiolibrary - 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 + AsyncWritetraits are implemented on Socks5Stream & Socks5SocketIPv4,IPv6, andDomainstypes 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)
Open in crates.io.
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:[email protected]:1337 https://ipapi.co/json/- Tests have to be implemented
- Better Rust doc
- UDP bind command not implemented
Thanks to all these SOCKS5 projects
- https://github.com/sfackler/rust-socks/blob/master/src/v5.rs
- https://github.com/shadowsocks/shadowsocks-rust/blob/master/src/relay/socks5.rs
- https://github.com/ylxdzsw/v2socks/blob/master/src/socks.rs
- Implementation made with Tokio-codec https://github.com/yfaming/yimu-rs/blob/master/src/socks5.rs