Skip to content
An example SOCKSv5 server implementation with tokio
Branch: master
Clone or download
Latest commit a6952ad Nov 30, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Switch from deprecated tokio_core::io to tokio_io::io Jul 21, 2017
tests Fix tests on nightly Nov 18, 2016
.travis.yml Tweak travis config Nov 30, 2017
Cargo.toml Switch from deprecated tokio_core::io to tokio_io::io Jul 21, 2017
LICENSE-APACHE Rename from futures-socks5 to tokio-socks5 Aug 26, 2016


An implementation of a SOCKSv5 proxy server built on top of tokio-core.

Build Status Build status


First, run the server

$ cargo run
Listening for socks5 proxy connections on

Then in a separate window you can test out the proxy:

$ export https_proxy=socks5h://localhost:8080
$ curl -v

If you have an older version of libcurl which doesn't support the socks5h scheme, you can try:

$ curl -v --socks5-hostname localhost:8080

The server is hardcoded to use Google's public DNS resolver (IPv4 address If you can't use external DNS services, change the address in the source and rebuild the server.


This project is licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

You can’t perform that action at this time.