Skip to main content

A proxy server that implements Socks5/Shadowsocks/Redirect/HTTP (tcp) and Shadowsocks/TProxy/Tunnel (udp) protocols.

Project description


Build Status Python Version Version Format License


A proxy server that implements Socks5/Shadowsocks/Redirect/HTTP (tcp) and Shadowsocks/TProxy/Tunnel (udp) protocols.

Thanks to Dabeaz's awesome curio project:

This project is inspired by qwj's python-proxy project(, and some part of http proxy code was copy from it.

It is a replacement of shadowsocks and shadowsocks-libev, you can replace ss-redir, ss-tunnel, ss-server, ss-local with


usage: shadowproxy [-h] [-v] [--version] [--monitor] server [server ...]

uri syntax: {server_scheme}://[cipher:password@]{netloc}[#fragment][{=client_scheme}://[cipher:password@]{netloc}]

support tcp schemes:
  server_scheme: socks, ss, red, http, https
  client_scheme: ss, http
support udp schemes:
  server_scheme: ssudp, tproxyudp, tunneludp
  client_scheme: ssudp


# socks5 --> shadowsocks
shadowproxy -v socks://:8527=ss://aes-256-cfb:password@

# http   --> shadowsocks
shadowproxy -v http://:8527=ss://aes-256-cfb:password@

# https  --> shadowsocks
shadowproxy -v https://:8527#keyfile,certfile=ss://aes-256-cfb:password@

# redir  --> shadowsocks
shadowproxy -v red://:12345=ss://aes-256-cfb:password@

# shadowsocks server (tcp)
shadowproxy -v ss://aes-256-cfb:password@:8888

# shadowsocks server (udp)
shadowproxy -v ssudp://aes-256-cfb:password@:8527

# tunnel --> shadowsocks (udp)
shadowproxy -v tunneludp://:8527#

# tproxy --> shadowsocks (udp)
shadowproxy -v tproxyudp://:8527=ssudp://aes-256-cfb:password@


shadowproxy requires Python3.6+

pip install shadowproxy

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
shadowproxy-0.3.0-py3-none-any.whl (15.8 kB) Copy SHA256 hash SHA256 Wheel py3 Aug 20, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page