Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shadowsocks/shadowsocks-dotcloud

a port of shadowsocks via websockets protocol, able to tunnel through HTTP proxy
https://github.com/shadowsocks/shadowsocks-dotcloud

Last synced: about 1 month ago
JSON representation

a port of shadowsocks via websockets protocol, able to tunnel through HTTP proxy

Awesome Lists containing this project

README

        

shadowsocks-dotcloud
===========

[![Build Status](https://travis-ci.org/clowwindy/shadowsocks-dotcloud.png)](https://travis-ci.org/clowwindy/shadowsocks-dotcloud)

shadowsocks-dotcloud is a lightweight tunnel proxy which can help you get through
firewalls. It is a port of [shadowsocks](https://github.com/clowwindy/shadowsocks), but
through a different protocol.

shadowsocks-dotcloud uses WebSockets instead of raw sockets,
so it can be deployed on [dotcloud](https://www.dotcloud.com/).

Notice that the protocol is INCOMPATIBLE with the origin shadowsocks.

usage
-----------

Sign up for [dotcloud](https://www.dotcloud.com/).

Install [dotcloud CLI](https://docs.dotcloud.com/0.9/firststeps/install/).

Put the code somewhere, for example shadowsocks-dotcloud/. Edit `shadowsocks/config.json`, change the following values:

server your server hostname, for example, shadowsocks-YOURUSERNAME.dotcloud.com
local_port local port
password a password used to encrypt transfer
timeout in seconds
method encryption method, null by default, or use "rc4"

Upload the code. You can choose your own app name other than `shadowsocks`. You'll see your hostname at the end.

$ dotcloud create shadowsocks
Created application "shadowsocks" using the flavor "sandbox"
...
$ dotcloud push --application shadowsocks shadowsocks-dotcloud/
# upload shadowsocks-dotcloud/ ssh://[email protected]:443/shadowsocks
...
Deployment finished. Your application is available at the following URLs
www: http://shadowsocks-YOURUSERNAME.dotcloud.com/

Open terminal, cd into shadowsocks, run `node local.js`.

Change proxy settings of your browser into

SOCKS5 127.0.0.1:local_port

troubleshooting
----------------

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

$ dotcloud logs www --application shadowsocks