Updated Home (markdown)
parent
96504a442b
commit
2cc1db5bfb
1 changed files with 3 additions and 64 deletions
67
Home.md
67
Home.md
|
@ -1,64 +1,3 @@
|
|||
shadowsocks
|
||||
===========
|
||||
|
||||
[](https://travis-ci.org/clowwindy/shadowsocks)
|
||||
Current version: 0.9.3
|
||||
|
||||
shadowsocks is a lightweight tunnel proxy which can help you get through firewalls
|
||||
|
||||
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
|
||||
|
||||
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 proxy settings of your browser into
|
||||
|
||||
SOCKS5 127.0.0.1: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
|
||||
python server.py -p server_port -k password
|
||||
|
||||
You may want to install gevent for better performance.
|
||||
|
||||
$ apt-get install python-gevent
|
||||
|
||||
Or:
|
||||
|
||||
$ sudo easy_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.
|
||||
|
||||
- [Ports and clients](https://github.com/clowwindy/shadowsocks/wiki/Ports-and-Clients)
|
||||
- [Troubleshooting](https://github.com/clowwindy/shadowsocks/wiki/Troubleshooting)
|
||||
- [Mailing list](http://groups.google.com/group/shadowsocks)
|
Loading…
Add table
Add a link
Reference in a new issue