2015-10-26 02:48:52 +00:00
About shadowsocks-rm
---------------
This project is https://github.com/shadowsocks/shadowsocks clone. I JUST fix bug on the original code. Unless it is necessary to have additional features.
2013-06-22 11:02:43 +00:00
shadowsocks
===========
2014-12-27 15:36:09 +00:00
|PyPI version| |Build Status| |Coverage Status|
2014-06-01 03:22:57 +00:00
2014-11-06 06:52:15 +00:00
A fast tunnel proxy that helps you bypass firewalls.
2013-06-22 11:02:43 +00:00
2014-06-20 15:23:14 +00:00
Server
2015-01-06 11:41:20 +00:00
------
Install
~~~~~~~
2014-06-20 15:23:14 +00:00
2014-05-17 07:43:19 +00:00
Debian / Ubuntu:
::
2014-11-06 06:52:15 +00:00
apt-get install python-pip
2014-05-17 07:43:19 +00:00
pip install shadowsocks
CentOS:
2013-06-22 11:02:43 +00:00
::
2015-01-06 11:41:20 +00:00
yum install python-setuptools && easy_install pip
2013-06-22 11:02:43 +00:00
pip install shadowsocks
2014-11-06 06:52:15 +00:00
Windows:
2015-01-06 11:41:20 +00:00
See `Install Server on
Windows <https://github.com/shadowsocks/shadowsocks/wiki/Install-Shadowsocks-Server-on-Windows>`__
2014-05-17 07:43:19 +00:00
2015-01-06 11:41:20 +00:00
Usage
~~~~~
2013-06-22 11:02:43 +00:00
::
2015-02-02 08:42:37 +00:00
ssserver -p 443 -k password -m rc4-md5
2013-06-22 11:02:43 +00:00
2014-12-21 06:06:28 +00:00
To run in the background:
2014-06-20 15:23:14 +00:00
::
2015-02-02 08:42:37 +00:00
sudo ssserver -p 443 -k password -m rc4-md5 --user nobody -d start
To stop:
::
sudo ssserver -d stop
To check the log:
::
sudo less /var/log/shadowsocks.log
2014-05-17 07:43:19 +00:00
2015-01-06 11:41:20 +00:00
Check all the options via `` -h `` . You can also use a
`Configuration <https://github.com/shadowsocks/shadowsocks/wiki/Configuration-via-Config-File> `__
file instead.
2013-06-22 11:02:43 +00:00
2015-01-06 11:41:20 +00:00
Client
------
2013-06-22 11:02:43 +00:00
2015-01-06 11:41:20 +00:00
- `Windows <https://github.com/shadowsocks/shadowsocks/wiki/Ports-and-Clients#windows> `__
/ `OS
X <https://github.com/shadowsocks/shadowsocks-iOS/wiki/Shadowsocks-for-OSX-Help>`__
- `Android <https://github.com/shadowsocks/shadowsocks/wiki/Ports-and-Clients#android> `__
/ `iOS <https://github.com/shadowsocks/shadowsocks-iOS/wiki/Help> `__
- `OpenWRT <https://github.com/shadowsocks/openwrt-shadowsocks> `__
2013-06-22 11:02:43 +00:00
2015-01-06 11:41:20 +00:00
Use GUI clients on your local PC/phones. Check the README of your client
for more information.
2014-06-20 15:23:14 +00:00
2014-12-21 06:06:28 +00:00
Documentation
-------------
2013-06-22 11:02:43 +00:00
2015-01-06 11:41:20 +00:00
You can find all the documentation in the
`Wiki <https://github.com/shadowsocks/shadowsocks/wiki> `__ .
2013-06-22 11:02:43 +00:00
License
-------
2015-02-03 06:10:36 +00:00
Copyright 2015 clowwindy
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
::
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
2013-06-22 11:02:43 +00:00
Bugs and Issues
---------------
2014-12-27 15:36:09 +00:00
- `Troubleshooting <https://github.com/shadowsocks/shadowsocks/wiki/Troubleshooting> `__
2014-07-06 15:43:50 +00:00
- `Issue
2014-12-27 15:36:09 +00:00
Tracker <https://github.com/shadowsocks/shadowsocks/issues?state=open>`__
2015-01-06 11:41:20 +00:00
- `Mailing list <https://groups.google.com/group/shadowsocks> `__
2014-05-17 07:43:19 +00:00
2014-06-21 03:18:33 +00:00
.. |PyPI version| image :: https://img.shields.io/pypi/v/shadowsocks.svg?style=flat
2014-06-05 13:02:36 +00:00
:target: https://pypi.python.org/pypi/shadowsocks
2014-12-27 15:36:09 +00:00
.. |Build Status| image :: https://img.shields.io/travis/shadowsocks/shadowsocks/master.svg?style=flat
:target: https://travis-ci.org/shadowsocks/shadowsocks
2015-01-03 08:48:05 +00:00
.. |Coverage Status| image :: https://jenkins.shadowvpn.org/result/shadowsocks
2015-02-02 08:42:37 +00:00
:target: https://jenkins.shadowvpn.org/job/Shadowsocks/ws/PYENV/py34/label/linux/htmlcov/index.html
