README.md

ProxyDev

It's a simple Node.js proxy that uses http-proxy package, reads a config.json file that maps domains to upstreams and starts an HTTP server.

And, that's all! Doesn't do anything else, does not recovers from any error from upstream and does not currently serve TLS (plans for the future).

It is a simple HTTP proxy that one can use for development purposes.

Pre-requisite

1. Install mkcert and generate a local CA
2. Make sure your browsers trust your local CA by running mkcert -install

Usage

1. Create a config.json file in the root of this app:

{
  "sni": [
    "api.local",
    "app.local",
    "*.local",
    "localhost",
    "127.0.0.1",
    "::1"
  ],
  "upstreams": {
    "api.local": "http://localhost:8081",
    "app.local": "http://localhost:8080"
  }
}

2. Generate the local certificate

3. Start the app directly

npm start

or using Docker and map config.json from your host.

docker run --init -v "$(pwd)"/config.json:/srv/config.json -p 80:80 registry.moveyourdigital.dev/proxydev