Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


backup of

Subscribe to updates I use shadowsocks

Statistics on shadowsocks

Number of watchers on Github 1061
Number of open issues 3
Average time to close an issue 4 months
Main language Python
Open pull requests 0+
Closed pull requests 0+
Last commit about 4 years ago
Repo Created over 4 years ago
Repo Last Updated over 1 year ago
Size 273 KB
Organization / Authorziggear
Page Updated
Do you use shadowsocks? Leave a review!
View open issues (3)
View shadowsocks activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating shadowsocks for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

backup of
copy from release 2.8.2


PyPI version Build Status Coverage Status

A fast tunnel proxy that helps you bypass firewalls.


  • TCP & UDP support
  • User management API
  • TCP Fast Open
  • Workers and graceful restart
  • Destination IP blacklist



Debian / Ubuntu:

apt-get install python-pip
pip install shadowsocks


yum install python-setuptools && easy_install pip
pip install shadowsocks


See Install Server on Windows


ssserver -p 443 -k password -m aes-256-cfb

To run in the background:

sudo ssserver -p 443 -k password -m aes-256-cfb --user nobody -d start

To stop:

sudo ssserver -d stop

To check the log:

sudo less /var/log/shadowsocks.log

Check all the options via -h. You can also use a Configuration file instead.


Use GUI clients on your local PC/phones. Check the README of your client for more information.


You can find all the documentation in the Wiki.


Copyright 2015 clowwindy

Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Bugs and Issues

shadowsocks questions on Stackoverflow (View All Questions)
  • How to set iptables when using shadowsocks?
  • Debian7 install shadowsocks but it can`t work
  • shadowsocks client was injected some poison code?
  • Use shadowsocks qt5 in ubuntu can not connect
  • Rotate through Shadowsocks proxy via Python
  • Connection to shadowsocks proxy from PhantomJS
  • How shadowsocks-android installed share to other?
  • running shadowsocks-nodejs on heroku
shadowsocks list of languages used
Other projects in Python