shadowsocks over WebSocket, support Heroku.
Switch branches/tags
Nothing to show
Clone or download
#34 Compare This branch is 54 commits ahead of shadowsocks:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.


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 create
Creating still-tor-8707... done, stack is cedar-14 |

Push the code to Heroku.

$ git push heroku master
-----> Compressing... done, 5.1MB
-----> Launching... done, v3 deployed to Heroku

 * [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

Install project dependencies with npm install:

$ npm install

Then run:

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

Change proxy settings of your browser into:



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