pancors

README

📡 PanCORS

We all know how it feels when you want to fetch something and CORS screws it all up.

Meet PanCORS: super light-weight CORS-anywhere proxy implemented in just a few lines of Go code.

Installation

From DockerHub:

docker pull michaljanocko/pancors and just run it! 🚀

The container is also published on GitHub Container Registry

You can also build it yourself:

1. Clone the repo
2. docker build -t pancors .
3. docker run --rm -d -p 8080:8080/tcp pancors:latest

Usage

Just pass your desired request to the root endpoint like this:

https://pan.cors/?url=https%3A%2F%2Fmichaljanocko.com

Please include the scheme (https or http) to qualify as a valid URL. PanCORS can't proxy other protocols so it has to check.

If you need to request something from a server that checks the Referer header, you can set the &referer= URL parameter and PanCORS will send the request with the correct referer.

Also, don't forget to query encode the address because some URI implementations merge neighboring slashes into one if they're part of the path or query (e.g. https:// wouldn't work and would come out as https:/ so that why we have to encode it as a param; this is the safest way IMO)

For custom response headers, use the snippet below if you're using the handler functions

func HandleProxyWith(origin string, credentials string)

or set these environment for the binary or the container:

• ALLOW_ORIGIN to whatever you want your Access-Control-Allow-Origin header to be (default is *)
• ALLOW_CREDENTIALS to either true or false (default is true)

Manifesto

Stop CORS oppresion!

CORS keeps us all safe but sometimes it just gets in the way. Peace

Documentation

Index

• func HandleProxy(w http.ResponseWriter, r *http.Request)
• func HandleProxyWith(origin string, credentials string) func(http.ResponseWriter, *http.Request)

Functions

func HandleProxy

func HandleProxy(w http.ResponseWriter, r *http.Request)

HandleProxy is a handler which passes requests to the host and returns their responses with CORS headers

func HandleProxyWith

func HandleProxyWith(origin string, credentials string) func(http.ResponseWriter, *http.Request)

HandleProxyFromHosts is a handler which passes requests only from specified to the host