shadowsocks-ruby

Current version: 0.11

shadowsocks-ruby is a lightweight tunnel proxy which can help you get through firewalls. It is a port of shadowsocks.

Usage

First, make sure you have Ruby 2.0.

$ ruby -v
ruby 2.0.0p247

Install Shadowsocks.

gem install shadowsocks

Create a file named config.json, with the following content.

{
    "server":"my_server_ip",
    "server_port":8388,
    "local_port":1080,
    "password":"barfoo!",
    "timeout":60,
    "method":"aes-128-cfb",
    "chnroute":true
}

Explanation of the fields:

server          your server IP (IPv4/IPv6), notice that your server will listen to this IP
server_port     server port
local_port      local port
password        a password used to encrypt transfer
timeout         in seconds
method          encryption method, "bf-cfb", "aes-256-cfb", "des-cfb", "rc4", etc. Default is "aes-128-cfb"
chnroute        speed up China ip

cd into the directory of config.json. Run ss-server on your server. To run it in the background, run nohup ss-server -c ./config.json > log &.

On your client machine, cd into the directory of config.json also, run ss-local -c config.json.

Change the proxy settings in your browser to

protocol: socks5
hostname: 127.0.0.1
port:     your local_port

It's recommended to use shadowsocks with AutoProxy or Proxy SwitchySharp.

Command line args

You can use args to override settings from config.json.

ss-local -s server_name -p server_port -l local_port -k password -m aes-128-cfb -d true
ss-server -p server_port -k password
ss-server -c /etc/shadowsocks/config.json

License

MIT

Bugs and Issues

Please visit issue tracker