###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
- install MySQL 5.x.x
pip install cymysql
- create a database named
shadowsocks
import shadowsocks.sql into shadowsocks
-
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
-
Running the first time:
cd shadowsockspython 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.
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:
| Name | Explanation |
|---|---|
| server | the address your server listens |
| server_port | server port |
| local_address | the address your local listens |
| local_port | local port |
| password | password used for encryption |
| timeout | in seconds |
| method | default: "aes-256-cfb", see Encryption |
| fast_open | use TCP_FASTOPEN, true / false |
| workers | number of workers, available on Unix/Linux |
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