skip to navigation
skip to content

Not Logged In

shadowsocks 1.3.7

a lightweight tunnel proxy

Build Status

shadowsocks is a lightweight tunnel proxy which can help you get through firewalls

Other ports and clients can be found here.


First, make sure you have Python 2.6 or 2.7.

$ python --version
Python 2.6.8

Install shadowsocks.

pip install shadowsocks

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


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 table

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

On your client machine, run sslocal.

Change the proxy settings in your browser to

protocol: socks5
port:     your local_port

Command line args

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

sslocal -s server_name -p server_port -l local_port -k password -m bf-cfb
ssserver -p server_port -k password -m bf-cfb
ssserver -c /etc/shadowsocks/config.json


If you want to use non-default encryption methods like "bf-cfb", please install M2Crypto.


sudo apt-get install python-m2crypto


pip install M2Crypto


You may want to install gevent for better performance.

$ sudo apt-get install python-gevent


$ sudo apt-get install libevent-dev python-pip
$ sudo pip install gevent



Bugs and Issues

Please visit issue tracker

File Type Py Version Uploaded on Size
shadowsocks-1.3.7.tar.gz (md5) Source 2014-04-18 8KB
  • Downloads (All Versions):
  • 71 downloads in the last day
  • 1092 downloads in the last week
  • 3525 downloads in the last month