ainzl / singlefetch

A simple web proxy that can fetch (download or stream) a single URL.

SingleFetch

A simple web proxy that can fetch (download or stream) a single URL. It is written in Go programming language.

How to use

After running, you can fetch a single URL this way:

[host]:[port]/?url=[url]

For example:

https://domain.com/?url=https://target.com/video.mp4

The proxy passes the request body and headers (HTTP method, referrer, auth, etc.) to the requested URL.

Base64 Encoding

If you want to use this proxy on censored internet, you might need to encode URLs. To do so, you can use the base64 parameter instead of url like this example:

// Using "url" parameter:
https://domain.com/?url=https://miladrahimi.com

// Using "base64" parameter:
https://domain.com/?base64=aHR0cHM6Ly9taWxhZHJhaGltaS5jb20=

Redirection

The requested URL might return an HTTP redirection response. In this case, the proxy behaves based on the redirection parameter or its default behavior when the parameter is not present. You can pass this parameter to the app this way:

[host]:[port]/?url=[url]&redirection=[value]

Default

The default behavior is returning the response with no manipulation. For example, if the request was http://proxy.com/?url=https://google.com the response would be a standard redirection to https://www.google.com.

follow

When redirection is follow, It will be redirected through the proxy. For example, if the request was http://proxy.com/?url=https://google.com&redirection=follow the response would be a redirection to http://proxy.com/?url=https://www.google.com&redirection=follow.

stop

When redirection is stop, It returns a JSON response contains the target location. For example, if the request was http://proxy.com/?url=https://google.com&redirection=stop the response would be:

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Length: ...
Content-Type: application/json
Date: ...

{"location":"https://www.google.com/"}

HTTP Header Manipulation

In default, SingleFetch passes the request headers without any change, but you may want to manipulate some headers like referer or any other HTTP header. In this case, you can pass the related header in the query string with the prefix h__ like this example:

https://proxy.com/?url=https://www.google.com&h__referer=https://images.google.com

License

SingleFetch is initially created by Milad Rahimi and released under the MIT License.