prefxpy 0.1.3

Local dev reverse proxy to reproduce production prefix and forwarded-header behavior.

PrefxPy

A small local reverse proxy for reproducing production subpath / reverse-proxy issues during development.

Works well when your app behaves differently behind a path prefix (e.g. /myapp/) or with X-Forwarded-* headers — problems that often only show up in staging or production.

Not a high-performance production proxy. Use it for local verification with FastAPI, Django, Flask, and similar stacks.

Install

pip install prefxpy

Quick start

prefxpy

Defaults:

• Public URL: http://127.0.0.1:9000/myapp/
• Upstream: http://127.0.0.1:8000

Another upstream port:

prefxpy --target http://127.0.0.1:5000

On startup, PrefxPy prints the URL to open in your browser.

Config file

prefxpy --config prefxpy.toml

See examples/prefxpy.example.toml for a sample. CLI flags override file values when set.

By default PrefxPy sets these forwarded headers on upstream requests:

• X-Forwarded-Host
• X-Forwarded-Proto
• X-Forwarded-Prefix
• X-Forwarded-For

Development

git clone https://github.com/smyrk2031/prefxpy.git
cd prefxpy
pip install -e ".[dev]"
pytest

Publishing to TestPyPI / PyPI: docs/PYPI.md.

Documentation

Language	Topic
日本語	仕様 · 設計
English	This README · Project site

License

PrefxPy is released under the MIT License.

Third-party licenses for runtime dependencies (aiohttp, httpx, etc.) are listed in THIRD_PARTY_NOTICES.md.