shadowsocks-heroku

shadowsocks-heroku is a lightweight tunnel proxy which can help you get through firewalls. It is a port of shadowsocks, but through a different protocol.

shadowsocks-heroku uses WebSocket instead of raw sockets, so it can be deployed on Heroku.

Notice that the protocol is INCOMPATIBLE with the origin shadowsocks.

Heroku

Usage

$ heroku create
Creating still-tor-8707... done, stack is cedar-14
http://still-tor-8707.herokuapp.com/ | git@heroku.com:still-tor-8707.git

Push the code to Heroku.

$ git push heroku master
…
-----> Compressing... done, 5.1MB
-----> Launching... done, v3
       http://still-tor-8707.herokuapp.com/ deployed to Heroku

To git@heroku.com:still-tor-8707.git
 * [new branch]      master -> master

Set a few configs:

$ heroku config:set METHOD=rc4 KEY=foobar
Setting config vars and restarting still-tor-8707... done, v11
KEY:    foobar
METHOD: rc4

Install project dependencies with npm install:

$ npm install
…

Then run:

$ node local.js -s still-tor-8707.herokuapp.com -l 1080 -m rc4 -k foobar -r 80
server listening at { address: '127.0.0.1', family: 'IPv4', port: 1080 }

Change proxy settings of your browser into:

SOCKS5 127.0.0.1:1080

Troubleshooting

If there is something wrong, you can check the logs by:

$ heroku logs -t --app still-tor-8707

Supported Ciphers

• rc4
• rc4-md5
• table
• bf-cfb
• des-cfb
• rc2-cfb
• idea-cfb
• seed-cfb
• cast5-cfb
• aes-128-cfb
• aes-192-cfb
• aes-256-cfb
• camellia-256-cfb
• camellia-192-cfb
• camellia-128-cfb