###Why This? The shadowsocks manyuser branch implements 3 functions which the original version doesn't have: 1.For sharing shadowsocks server

2.For creating multiple servers by shadowsocks

3.For managing the servers (transfer / accounting)

It is ideal for an environment which needs to manage multiple users.

###Installing

1. install MySQL 5.x.x

pip install cymysql

2. create a database named shadowsocks

import shadowsocks.sql into shadowsocks

3. edit the file Config.py:E.g.:

   #Config MYSQL_HOST = 'mdss.mengsky.net' MYSQL_PORT = 3306 MYSQL_USER = 'ss' MYSQL_PASS = 'ss' MYSQL_DB = 'shadowsocks'

   MANAGE_PASS = 'ss233333333' #if you want manage in other server you should set this value to global ip MANAGE_BIND_IP = '127.0.0.1' #make sure this port is idle MANAGE_PORT = 23333

4. Running the first time: cd shadowsocks python server.py

If there is no other mistakes, the server will startup automatically. you will see things such as

db start server at port [%s] pass [%s]

###Database user table columns

passwd : server pass

port : server port

t : last keepalive time

u : upload transfer

d : download transer

transfer_enable if u + d > transfer_enable this server will be stop (db_transfer.py del_server_out_of_bound_safe)

###Managing the socket

The managing server work in UDP at MANAGE_BIND_IP MANAGE_PORT

use MANAGE_PASS:port:passwd:0 to delete a server at port port

use MANAGE_PASS:port:passwd:1 to run a server at port port password is passwd

E.g.(Python):

udpsock.sendto('MANAGE_PASS:65535:123456:1', (MANAGE_BIND_IP, MANAGE_PORT))

E.g.(PHP):

$sock = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
$msg = 'MANAGE_PASS:65535:123456:1';
$len = strlen($msg);
socket_sendto($sock, $msg, $len, 0, MANAGE_BIND_IP, MANAGE_PORT);
socket_close($sock);

###Noticements If an error occurs such as 2014-09-18 09:02:37 ERROR [Errno 24] Too many open files , The solution is: edit /etc/security/limits.conf

Add:

*                soft    nofile          8192
*                hard    nofile          65535

A fast tunnel proxy that helps you bypass firewalls.

中文说明

You'll have a client on your local machine, and install a server on a remote server.

• Windows / OS X
• Android / iOS
• OpenWRT

apt-get install python-pip python-m2crypto
pip install shadowsocks

Or simply apt-get install shadowsocks if you have Debian sid in your source list.

yum install m2crypto python-setuptools
easy_install pip
pip install shadowsocks

On your server create a config file /etc/shadowsocks.json. Example:

{
    "server":"my_server_ip",
    "server_port":8388,
    "local_address": "127.0.0.1",
    "local_port":1080,
    "password":"mypassword",
    "timeout":300,
    "method":"aes-256-cfb",
    "fast_open": false,
    "workers": 1
}

Explanation of the fields:

Run ssserver -c /etc/shadowsocks.json on your server. To run it in the background, use Supervisor.

On your client machine, use the same configuration as your server, and start your client.

If you use Chrome, it's recommended to use SwitchySharp. Change the proxy settings to

protocol: socks5
hostname: 127.0.0.1
port:     your local_port

If you can't install SwitchySharp, you can launch Chrome with the following arguments to force Chrome to use the proxy:

Chrome.exe --proxy-server="socks5://127.0.0.1:1080" --host-resolver-rules="MAP * 0.0.0.0 , EXCLUDE localhost"

If you can't even download Chrome, find a friend to download a Chrome Standalone installer for you.

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 --workers 2
ssserver -c /etc/shadowsocks/config.json

List all available args with -h.

https://github.com/clowwindy/shadowsocks/wiki

MIT

• Troubleshooting
• Issue Tracker
• Mailing list