Python port of ShadowsocksR
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
破娃酱 fd723a92c4 bump 3 years ago
debian * still package issue 6 years ago
shadowsocks bump 3 years ago
tests fix test_command 5 years ago
utils merge master 5 years ago
.gitignore Update .gitignore 3 years ago
.travis.yml fix READEME and travis url 5 years ago
CHANGES bump 3 years ago Update 5 years ago
Dockerfile fix default work 3 years ago
LICENSE license under Apache License v2.0 5 years ago fix 5 years ago Update (#169) 3 years ago
README.rst license under Apache License v2.0 5 years ago add interface legendsockssr 3 years ago fix handle_event 5 years ago
config.json force additional ports only with ss-panel (#218) 3 years ago compatible python3 4 years ago not filter mu port 3 years ago fix reload module 4 years ago
initcfg.bat Add initcfg.bat for windows 3 years ago update init script 4 years ago fix, remove LRUCache init log 3 years ago fix run script 3 years ago
mudb.json generate random password 4 years ago update usage info 3 years ago
mysql.json set default node id to 0 and default db to "sspanel" 4 years ago fix run script 3 years ago Use thread.join() instead (#219) 3 years ago allow set speed limit in runtime 3 years ago add shadowsocks.obfsplugin to for distribution 4 years ago add cymysql setup script 3 years ago fix stop script 3 years ago using mysql.json to config mysql 4 years ago insert a reload step 5 years ago


Build Status

A fast tunnel proxy that helps you bypass firewalls.



Debian / Ubuntu:

apt-get install git
git clone


yum install git
git clone


git clone

Usage for single user on linux platform

If you clone it into “~/shadowsocksr”
move to “~/shadowsocksr”, then run:


move to “~/shadowsocksr/shadowsocks”, then run:

python -p 443 -k password -m aes-128-cfb -O auth_aes128_md5 -o tls1.2_ticket_auth_compatible

Check all the options via -h.

You can also use a configuration file instead (recommend), move to “~/shadowsocksr” and edit the file “user-config.json”, then move to “~/shadowsocksr/shadowsocks” again, just run:


To run in the background:


To stop:


To monitor the log:



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