Proxy.py

💫 Ngrok FRP Alternative • ⚡ Fast • 🪶 Lightweight • 0️⃣ Dependency • 🔌 Pluggable • 😈 TLS interception • 🔒 DNS-over-HTTPS • 🔥 Poor Man's VPN • ⏪ Reverse & ⏩ Forward • 👮🏿 "Proxy Server" framework • 🌐 "Web Server" framework • ➵ ➶ ➷ ➠ "PubSub" framework • 👷 "Work" acceptor & executor framework

Generate Convert Improve

Install / Use

/learn @abhinavsingh/Proxy.py

About this skill

Quality Score

0/100

README

Features
Install
- Using PIP
  - Stable version
  - Development version
- Using Docker
- Using HomeBrew
  - Stable version
  - Development version
Start proxy.py
- From command line when installed using PIP
- From command line using repo source
- Docker Image
  - Customize Startup Flags
Plugin Examples
- HTTP Proxy Plugins
- HTTP Web Server Plugins
  - Web Server Route
- Reverse Proxy Plugins
  - Reverse Proxy
- Plugin Ordering
End-to-End Encryption
TLS Interception
- Insecure TLS Interception
- TLS Interception With Docker
GROUT (NGROK Alternative)
- Grout Usage
- Grout Authentication
- Grout Paths
- Grout Wildcard Domains
- "Host" Header Based Wildcard Routing
- "Dynamic" Routing
- Grout using Docker
- How Grout works
- Self-hosted Grout
Proxy Over SSH Tunnel
- Proxy Remote Requests Locally
- Proxy Local Requests Remotely
Embed proxy.py
- Blocking Mode
- Non-blocking Mode
- Ephemeral Port
- Loading Plugins
Unit testing with proxy.py
- proxy.TestCase
- Override Startup Flags
- With unittest.TestCase
Utilities
- TCP
  - new_socket_connection
  - socket_connection
- Http
  - build_http_request
  - build_http_response
- Public Key Infrastructure
  - API Usage
  - CLI Usage
Run Dashboard
- Inspect Traffic
Chrome DevTools Protocol
Prometheus Metrics
Frequently Asked Questions
- Deploying proxy.py in production
- Stable vs Develop
  - Release Schedule
- Threads vs Threadless
- Threadless Remote vs Local Execution Mode
- SyntaxError: invalid syntax
- Unable to load plugins
- Unable to connect with proxy.py from remote host
- Basic auth not working with a browser
- Docker image not working on MacOS
- ValueError: filedescriptor out of range in select
- None:None in access logs
- OSError when wrapping client for TLS Interception
Plugin Developer and Contributor Guide
- High level architecture
- Everything is a plugin
- Managing states for your stateless plugins
- Passing processing context between plugins
- Internal Documentation
- Development Guide
Projects Using Proxy.Py
Benchmarks
Flags
Changelog
- v2.x
- v1.x
- v0.x

Features

A drop-in alternative to ngrok
Fast & Scalable
- Scale up by using all available cores on the system
- Threadless executions using

Related Skills

node-connect

335.8k

Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps

frontend-design

82.7k

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

openai-whisper-api

335.8k

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

commit-push-pr

82.7k

Commit, push, and open a PR