86 lines
1.9 KiB
Markdown
86 lines
1.9 KiB
Markdown
shadowsocks
|
|
===========
|
|
|
|
[![PyPI version]][PyPI]
|
|
[![Build Status]][Travis CI]
|
|
[![Coverage Status]][Coverage]
|
|
|
|
A fast tunnel proxy that helps you bypass firewalls.
|
|
|
|
Features:
|
|
- TCP & UDP support
|
|
- User management API
|
|
- TCP Fast Open
|
|
- Workers and graceful restart
|
|
- Destination IP blacklist
|
|
|
|
Server
|
|
------
|
|
|
|
### Install
|
|
|
|
Debian / Ubuntu:
|
|
|
|
apt-get install python-pip
|
|
pip install git+https://github.com/shadowsocks/shadowsocks.git@master
|
|
|
|
CentOS:
|
|
|
|
yum install python-setuptools && easy_install pip
|
|
pip install git+https://github.com/shadowsocks/shadowsocks.git@master
|
|
|
|
Windows:
|
|
|
|
See [Install Shadowsocks Server on Windows](https://github.com/shadowsocks/shadowsocks/wiki/Install-Shadowsocks-Server-on-Windows).
|
|
|
|
### Usage
|
|
|
|
ssserver -p 443 -k password -m aes-256-cfb
|
|
|
|
To run in the background:
|
|
|
|
sudo ssserver -p 443 -k password -m aes-256-cfb --user nobody -d start
|
|
|
|
To stop:
|
|
|
|
sudo ssserver -d stop
|
|
|
|
To check the log:
|
|
|
|
sudo less /var/log/shadowsocks.log
|
|
|
|
Check all the options via `-h`. You can also use a [Configuration] file
|
|
instead.
|
|
|
|
### Usage with Config File
|
|
|
|
[Create configeration file and run](https://github.com/shadowsocks/shadowsocks/wiki/Configuration-via-Config-File)
|
|
|
|
To start:
|
|
|
|
ssserver -c /etc/shadowsocks.json
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
You can find all the documentation in the [Wiki](https://github.com/shadowsocks/shadowsocks/wiki).
|
|
|
|
License
|
|
-------
|
|
|
|
Apache License
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[Build Status]: https://img.shields.io/travis/shadowsocks/shadowsocks/master.svg?style=flat
|
|
[Coverage Status]: https://jenkins.shadowvpn.org/result/shadowsocks
|
|
[Coverage]: https://jenkins.shadowvpn.org/job/Shadowsocks/ws/PYENV/py34/label/linux/htmlcov/index.html
|
|
[PyPI]: https://pypi.python.org/pypi/shadowsocks
|
|
[PyPI version]: https://img.shields.io/pypi/v/shadowsocks.svg?style=flat
|
|
[Travis CI]: https://travis-ci.org/shadowsocks/shadowsocks
|
|
|