---
id: pproxy
version: "2.7.9"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# pproxy — Proxy server that can tunnel among remote servers by regex rules.

License: permissive · Maintenance: dormant · Downloads: 153.0K/mo

## What it is and what it does

pproxy is a lightweight, single-threaded asynchronous proxy server written in pure Python that implements a wide range of tunneling protocols. It can act as both a proxy client and server, supporting HTTP (including v2 and v3/QUIC), SOCKS4/5, Shadowsocks, SSH tunnels, and several other protocols. The core use case is routing traffic through remote proxy servers with optional encryption, authentication, and regex-based filtering rules.

The package requires Python 3.6 or later and has no mandatory runtime dependencies, making it lightweight to deploy. Optional dependencies like pycryptodome improve cipher performance, and asyncssh enables SSH tunnel support. It can be used as a command-line tool, a Docker container, or integrated into applications via its client/server API. The tool supports load balancing across multiple remote servers, system-wide proxy configuration on macOS and Windows, and traffic statistics.

Use it for:

- Set up a local SOCKS5 proxy server to tunnel traffic through a remote Shadowsocks server with encryption
- Route HTTP traffic through multiple remote proxies with load balancing and regex-based hostname filtering
- Configure system-wide proxy settings on macOS or Windows to redirect all local traffic through a remote proxy
- Create an SSH tunnel client to forward traffic through a remote SSH server
- Run a Docker-based proxy relay to bridge traffic between different network segments or protocols

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pproxy is an asynchronous proxy server that tunnels TCP and UDP traffic across HTTP, SOCKS, Shadowsocks, SSH, and other protocols, with support for load balancing and regex-based routing rules.

Yes, if you need a lightweight, protocol-rich proxy server with no mandatory dependencies. The package is mature and stable (MIT license, 2200 stars, production-stable classifier), though dormant maintenance means you should verify compatibility with your Python version and monitor for security updates. Install it for local tunneling, testing, or simple relay scenarios.

## Install

pip install pproxy
uv add pproxy
poetry add pproxy

## Installing pproxy

Before you install: Installation is straightforward with no required dependencies. The package is dormant (last release 2024-01-16, last commit 2024-11-16) but has been stable since its early releases and maintains 2200 GitHub stars, suggesting a mature codebase despite infrequent updates.

License in practice: MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions—only requiring attribution.

Quickstart:

$ pip3 install pproxy
$ pproxy
Serving on :8080 by http,socks4,socks5

Or with Shadowsocks:
$ pproxy -l ss://chacha20:abc@:8080
Serving on :8080 by ss (chacha20-py)

Requires Python 3.6 or later. Optional pycryptodome dependency improves cipher performance; asyncssh enables SSH tunnel support.

Verify before relying:

- Whether the dormant maintenance status affects compatibility with current Python versions beyond the stated 3.6+ support
- Performance characteristics of built-in pure-Python ciphers versus C-accelerated alternatives in production scenarios

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 153.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

proxy server python asyncio, socks5 http proxy tunnel, shadowsocks proxy implementation, tcp udp tunnel routing, multi-protocol proxy load balance, proxy-server, tunneling, asyncio

[View on SkillFed](https://skillfed.io/packages/pproxy) · [View on PyPI](https://pypi.org/project/pproxy/)