proxy

Standalone Python HTTP/SOCKS5 proxy with a small dashboard.

Docker

Build the image:

docker build -t proxy-local .

Run the proxy and dashboard:

docker run --rm \
  -p 8899:8899 \
  -p 8898:8898 \
  proxy-local

Ports:

• 8899: mixed HTTP and SOCKS5 proxy.
• 8898: dashboard at http://127.0.0.1:8898.

You can override the default ports with environment variables:

docker run --rm \
  -e PROXY_MIXED_PORT=1080 \
  -e PROXY_DASHBOARD_PORT=8898 \
  -p 1080:1080 \
  -p 8898:8898 \
  proxy-local

GitHub Codespaces

The devcontainer starts the proxy automatically as the container command. It forwards:

• 8899 as a private proxy port.
• 8898 as a private HTTP dashboard port.

Keep the proxy port private unless you intentionally want to expose it. A public proxy can be abused as an open proxy.

Checks

Compile-check the script:

python3 -m py_compile proxy

Test through the proxy:

curl -x http://127.0.0.1:8899 https://example.com -I