shadowsocks-python is the initial version written by @clowwindy. It aims to provide a simple-to-use and easy-to-deploy implementation with basic features of shadowsocks.


First, make sure you have Python 2.6 or 2.7.

$ python --version
Python 2.6.8

Then install from PIP

$ pip install shadowsocks


Checkout the source codes and run the scripts directly.

$ git clone
$ cd shadowsocks
$ python

shadowsocks-python is licensed under the Apache License, Version 2.0.


shadowsocks-go is a state-of-the-art port written in Go language, designed for large-scale system. It implements the multi-ports-multi-password feature, which is suitable for paid service providers with user management and traffic statistics support. This port is maintained by @cyfdecyf.

Pre-built Binaries

Download archives from


Use go get to install the scripts.

$ go get

shadowsocks-go is licensed under the MIT license.

C with libev

shadowsocks-libev is a lightweight and full featured port for embedded devices and low end boxes. It's a pure C implementation and has a very small footprint (several megabytes) for thousands of connections. This port is maintained by @madeye.


First, add the GPG public key to your system:

$ wget -O- | sudo apt-key add -

Install the binaries by adding each of the following repositories to your system.

On Debian Wheezy, Ubuntu 12.04 or any distribution with libssl > 1.0.0

$ echo "deb wheezy main" >> /etc/apt/sources.list

On Debian Squeeze, Ubuntu 11.04, or any distribution with libssl > 0.9.8, but < 1.0.0

$ echo "deb squeeze main" >> /etc/apt/sources.list


$ apt-get update
$ apt-get install shadowsocks-libev


Build and install the project from source codes.

$ git clone
$ cd shadowsocks-libev
$ sudo apt-get install build-essential autoconf libtool libssl-dev
$ ./configure && make
$ make install

shadowsocks-libev is licensed under the GNU General Public License v3.0.

C++ with Qt

libQtShadowsocks is a lightweight and ultra-fast shadowsocks library written in C++ with Qt 5. The client shadowsocks-libqss can be used in both client-side and server-side. This port is maintained by @librehat.

Prebuilt binaries

Download pre-built binaries from


$ git clone
$ cd libQtShadowsocks
$ qmake
$ make -j4
$ sudo make install

libQtShadowsocks is licensed under the GNU Lesser General Public License, version 3.0