/shadowsocks-heroku

Primary LanguageCoffeeScriptMIT LicenseMIT

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