A CORS proxy in a container (Docker) for when you need to `Access-Control-Allow-Origin: *`!
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app ReponseBuilder May 30, 2016
test ReponseBuilder May 30, 2016
.gitignore Initial commit Mar 7, 2016
.travis.yml Adding Travis/CI May 30, 2016
Dockerfile Initial commit Mar 7, 2016
LICENSE Initial commit Mar 7, 2016
README.md Adding Travis/CI May 30, 2016
app.js Update app.js Mar 5, 2017
bootstrap.js ReponseBuilder May 30, 2016
index.html Changing examples Mar 15, 2016
package.json ReponseBuilder May 30, 2016



A CORS proxy in a container (Docker) for when you need to Access-Control-Allow-Origin: *!

Build Status


If you need permissive CORS for a front-end project, simply deploy this container and proxy your HTTP requests through it.

Once the container is running, you may navigate to http://container-address:3000/https://jacob.uk.com, cors-container will then proxy the specified resource and transform the original headers to be CORS permissive, whilst keeping origional headers in-tact.

If you intend to use this in production over the open web, ensure the service is locked down with restrictive firewall/access permissions, otherwise any content may be proxied over your server.

I suggest implementing proper CORS headers on your resources and using this for development purposes only.

Relative URL rewriting

cors-container can rewrite relative URLs to full URLs of the response body you have proxied.

For example if we wish to proxy http://blog.jacob.uk.com/ and cors-container is runinnng on http://localhost:3000/ the request URL would be http://localhost:3000/http://blog.jacob.uk.com/.

cors-container will rewrite any relative URLs it finds in the proxies response body. For example <a href="/css/style.css"> would be modified to <a href="http://localhost:3000/http://blog.jacob.uk.com/css/style.css"> in the proxied response.

This can be useful if you wish to be able to pull additional assets on a page through the proxy such as stylesheets and JavaScript.

This is not enabled by default as this option mutates the original response body.

Set rewrite-urls in the request header to cors-cotainer if you want relative URLs rewriting.


$ docker pull imjacobclark/cors-container
$ docker run --restart=always -d -p 3000:3000 --name cors-container imjacobclark/cors-container
$ git pull https://github.com/imjacobclark/cors-container.git && cd cors-container
$ docker build -t cors-container
$ docker run --restart=always -d -p 3000:3000 --name cors-container cors-container
$ git pull https://github.com/imjacobclark/cors-container.git && cd cors-container
$ npm run test && npm start

Thanks to