GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - romnn/proxybootstrap: A simple python wrapper script for bootstrapping a reverse proxy inside a docker container.

BranchesTags
Open more actions menu

Latest commit

 

History

38 Commits
38 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
proxybootstrap
proxybootstrap
 
 
.gitignore
.gitignore
 
 
.pre-commit-config.yaml
.pre-commit-config.yaml
 
 
LICENSE
LICENSE
 
 
Pipfile
Pipfile
 
 
Pipfile.lock
Pipfile.lock
 
 
README.md
README.md
 
 
setup.cfg
setup.cfg
 
 
setup.py
setup.py
 
 

Repository files navigation

CORS reverse development proxy

Build Status PyPI License PyPI Version PyPI Python versions

A simple yet extensible python wrapper script for templating a proxy nginx configuration that functions as host mapped reverse proxy container.

Why and when to use?

Modern browsers enforce CORS policy and won't let you make requests from your frontend running on localhost:8080 to your backend at localhost:4000. To solve this problem, start a proxy at localhost:5000 (or any other spare port) and proxy requests based on paths:

  • localhost:5000/api and localhost:5000/buy will be routed to the backend localhost:4000
  • localhost:5000/ will be routed to the frontend localhost:8080

Installation and usage

pip install proxybootstrap # using pip

Note: You will need docker for running the proxy container

Start the proxy server with your configuration

proxybootstrap \
    --port 5000 \
    /api@http://127.0.0.1:4000 /buy@http://127.0.0.1:4000 /@http://127.0.0.1:8080

Customization

Option Description Default
locations service locations to proxy. None
-c / -config nginx config template file ./config/default.conf
--port listening port for the reverse proxy 5000
--verbose enable verbose output False
--sync force synchronous communication with the proxy False
--tag docker tag for the reverse proxy container dev/cors-reverse-proxy
--dockerfile dockerfile for building the container ./Dockerfile

Under the hood, configuration options are applied to the --config template file and rendered using jinja2. If you wish, you can pass additional arguments and use them in the config template. Example:

proxybootstrap \
    -my_var1 Test1 \
    --my_var2 Test2 \
    --port 5000 \
    /@http://127.0.0.1:8080

can be accessed in a template with

{{ my_var1 }}
{{ my_var2 }}

Alternatives

  • Write a custom proxy configuration for nginx or other proxy servers like trafik, envoy or haproxy
  • When using webpack or another popular tool there might be some plugins like devserver-proxy for vuejs
  • Mess around with headers to allow specific CORS requests

Development

If you do not have pipx and pipenv, install with

python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install pipenv

Install all dependencies with

pipenv install --dev

To format, sort imports and check PEP8 conformity, run

pipenv run black .
pipenv run isort
pipenv run flake8

(These are also configured as a git pre commit hook)

Notice

This configuration is very minimal and intended for development use only.

About

A simple python wrapper script for bootstrapping a reverse proxy inside a docker container.

Topics

cicorsdev-proxyfrontendhelperproxypythonpython-wrapper-scriptreverse-proxyweb-development

Resources

Readme
MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.