vbatts
/
shadowsocks
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
A fast tunnel proxy that helps you bypass firewalls. regulation cause this repo to get truncated, but there is still some history there. And tags.
85 Commits 2 Branches 18 Tags 2.6 MiB
Python 91.5%
Shell 8.3%
Dockerfile 0.2%
Go to file
clowwindy 0893c7be42 Update README.md 2013-05-22 14:14:37 +08:00
.gitignore initial commit 2012-04-20 06:10:49 -07:00
.travis.yml Python 2.5 is no longer supported 2013-05-16 11:47:09 +08:00
README.md Update README.md 2013-05-22 14:14:37 +08:00
config.json use random iv so we finally have strong encryption now 2013-05-22 11:35:25 +08:00
encrypt.py use random iv so we finally have strong encryption now 2013-05-22 11:35:25 +08:00
local.py bump 2013-05-22 11:37:03 +08:00
server.py bump 2013-05-22 11:37:03 +08:00
test.py fix test for python 2.5 2013-03-05 00:17:37 +08:00

README.md

shadowsocks

Build Status Current version: 1.2

shadowsocks is a lightweight tunnel proxy which can help you get through firewalls

Other ports and clients can be found here.

usage

First, make sure you have Python 2.6 or 2.7.

$ python --version
Python 2.6.8

Then edit config.json, change the following values:

server          your server ip or hostname
server_port     server port
local_port      local port
password        a password used to encrypt transfer
method          encryption method, "bf-cfb", "aes-256-cfb", "des-cfb", "rc4", etc. Default is table. If you wa

If you want to use non-default encryption method like "bf-cfb", please install M2Crypto.

pip install M2Crypto

Put all the files on your server. Run python server.py on your server. To run it in the background, run nohup python server.py > log &.

Put all the files on your client machine. Run python local.py on your client machine.

Change the proxy setting in your browser into

protocol: socks5
hostname: 127.0.0.1
port:     your local_port

advanced

You can use args to override settings from config.json.

python local.py -s server_name -p server_port -l local_port -k password -m bf-cfb
python server.py -p server_port -k password -m bf-cfb

You may want to install gevent for better performance.

$ sudo apt-get install python-gevent

Or:

$ sudo apt-get install libevent-dev python-pip
$ sudo pip install gevent

troubleshooting

  • I can only load some websites
    Check the logs of local.py. If you see only IPs, not hostnames, your may got DNS poisoned, but your browser hasn't been configured to let the proxy resolve DNS.
    To set proper DNS config, you can simply install FoxyProxy / Autoproxy for Firefox, or ProxySwitchy / SwitchySharp for Chrome. They will set the config in your browser automatically.
    Or you can change network.proxy.socks_remote_dns into true in about:config page if you use Firefox.
  • I can't load any websites and the log prints mode != 1
    Make sure proxy protocol is set to Socks5, not Socks4 or HTTP.
  • I use IE and I can't get my proxy to work
    Since you can't specify Socks4 or Socks5 in IE settings, you may want to use a PAC(Proxy auto-config) script, or just use Firefox instead.