#proxy-server #local-server #socks5-proxy #proxy #firewall #sock #socks5

shadowsocks-service

shadowsocks is a fast tunnel proxy that helps you bypass firewalls

43 stable releases

new 1.18.4 May 11, 2024
1.18.2 Mar 13, 2024
1.17.1 Nov 26, 2023
1.15.4 Jul 6, 2023
1.10.2 Mar 28, 2021

#1322 in Network programming

Download history 2713/week @ 2024-01-25 3479/week @ 2024-02-01 4055/week @ 2024-02-08 3046/week @ 2024-02-15 2781/week @ 2024-02-22 3540/week @ 2024-02-29 5767/week @ 2024-03-07 5220/week @ 2024-03-14 7354/week @ 2024-03-21 3529/week @ 2024-03-28 4690/week @ 2024-04-04 5417/week @ 2024-04-11 3834/week @ 2024-04-18 4090/week @ 2024-04-25 4105/week @ 2024-05-02 3493/week @ 2024-05-09

16,746 downloads per month
Used in shadowsocks-rust

MIT license

2.5MB
69K SLoC

shadowsocks-service

License crates.io docs.rs

This is a port of shadowsocks.

shadowsocks is a fast tunnel proxy that helps you bypass firewalls.

Features

  • Local Server

    • SOCKS 5
    • SOCKS 4/4a (local-socks4)
    • HTTP (local-http)
    • Tunnel (local-tunnel)
    • Redir, aka Transparent Proxy (local-redir)
    • DNS (local-dns)
    • Tun (local-tun)
  • Server

  • Manager


lib.rs:

Shadowsocks Service

https://shadowsocks.org/

shadowsocks is a fast tunnel proxy that helps you bypass firewalls.

Usage

Build shadowsocks and you will get at least 2 binaries: sslocal and ssserver

Write your servers in a configuration file. Format is defined in shadowsocks' documentation

For example:

{
   "server": "my_server_ip",
   "server_port": 8388,
   "local_address": "127.0.0.1",
   "local_port": 1080,
   "password": "mypassword",
   "timeout": 300,
   "method": "aes-256-cfb"
}

Save it in file shadowsocks.json and run local proxy server with

cargo run --bin sslocal -- -c shadowsocks.json

Now you can use SOCKS5 protocol to proxy your requests, for example:

curl --socks5-hostname 127.0.0.1:1080 https://www.google.com

On the server side, you can run the server with

cargo run --bin ssserver -- -c shadowsocks.json

Server should use the same configuration file as local, except the listen addresses for servers must be socket addresses.

Of course, you can also use cargo install to install binaries.

Dependencies

~18–59MB
~1M SLoC