coldgemini / shadowsocksr

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Build Status

A fast tunnel proxy that helps you bypass firewalls.


Install with one click (一键安装)

sudo su

wget --no-check-certificate

chmod +x

./ 2>&1 | tee ssr-install.log

To uninstall, using

./ uninstall


Please make you as root account and change your working directory to the root first.

sudo su
cd / 

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" folder, please enter "/shadowsocksr" first,

cd /shadowsocksr

then run:


Now, move to "/shadowsocksr/shadowsocks",

cd /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" with vi text editor,

vi /shadowsocksr/user-config.json

then move to "/shadowsocksr/shadowsocks" again,

cd /shadowsocksr/shadowsocks

and just run:


Now. Mission completed.

To run in the background:


To stop:


To monitor the log:


Run as an automatical service

If you hope the remote host to start the shadowsocksr service automatically when the host started, please:

Edit the configuration file "user-config.json" with vi text editor, modify it with correct parameters.

vi /shadowsocksr/user-config.json

Edit /etc/rc.local file with vi editor,

vi /etc/rc.local

and add the following command to the end of the /etc/rc.local file.


If the first line of file /etc/rc.local is not #!/bin/sh -e, please add it to the first line, then make /etc/rc.local executable using the following command:

chmod +x /etc/rc.local

Please reboot your linux computer and all is done.

About editing user-config.json and /etc/rc.local files with vi text editor utility, please see How to Use the vi Editor.


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


License:Apache License 2.0


Language:Python 91.3%Language:Shell 8.5%Language:Dockerfile 0.2%Language:Batchfile 0.1%