A fast tunnel proxy that helps you bypass firewalls. regulation cause this repo to get truncated, but there is still some history there. And tags.
Go to file
Zou Yong 0f4e3fa00c Add mbedtls wrapper, custom crypto lib path, test files (#803)
* add mbedtls crypto wrapper.
add tests files for new aead ciphers
add custom lib path support
fix some typo

* fix forbidden ip list

* rm crypto lib build files

* remove crypto source

* add xchacha20 test config

* convert dos new line format to unix format

* Fix help msg
2017-04-29 14:27:55 +08:00
debian new debian package (#659) 2016-11-20 15:29:11 +08:00
shadowsocks Add mbedtls wrapper, custom crypto lib path, test files (#803) 2017-04-29 14:27:55 +08:00
tests Add mbedtls wrapper, custom crypto lib path, test files (#803) 2017-04-29 14:27:55 +08:00
utils fix that autoban can not get ip when use ipv6 (#674) 2016-11-20 14:57:52 +08:00
.gitignore Add AEAD ciphers support (#775) 2017-03-04 14:37:29 +08:00
.travis.yml Add mbedtls wrapper, custom crypto lib path, test files (#803) 2017-04-29 14:27:55 +08:00
CHANGES update CHANGES 2015-08-10 12:37:42 +08:00
CONTRIBUTING.md Update CONTRIBUTING.md 2015-08-06 17:24:51 +08:00
Dockerfile Dockfile add libsodium (#601) 2016-08-23 22:00:32 +08:00
LICENSE license under Apache License v2.0 2015-02-03 14:10:36 +08:00
MANIFEST.in fix MANIFEST.in 2015-01-21 14:32:55 +08:00
README.md Update README.md (#575) 2017-03-02 21:28:16 +08:00
README.rst readme 2015-10-26 10:48:52 +08:00
config.json.example Add mbedtls wrapper, custom crypto lib path, test files (#803) 2017-04-29 14:27:55 +08:00
setup.py Add AEAD ciphers support (#775) 2017-03-04 14:37:29 +08:00

README.md

shadowsocks

PyPI version Build Status Coverage Status

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.

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

To start:

ssserver -c /etc/shadowsocks.json

Documentation

You can find all the documentation in the Wiki.

License

Apache License