cttynul/waybackproxy repository overview

⁠WaybackProxy

WaybackProxy is a retro-friendly HTTP proxy which retrieves pages from the Internet Archive Wayback Machine⁠ or OoCities⁠ and delivers them in their original form, without toolbars, scripts and other extraneous content that may confuse retro browsers.

⁠Setup

A Dockerfile is included that allows you to run WaybackProxy from a docker container.

⁠Environment Variables

When deploying via Docker, the config.json can be customized by specifying environment variables when creating the docker container. The environment variables match the example config.json in this repository. Below is a complete list:

⁠Usage

docker run [-d] \
    --name=waybackproxy \
    [-e <VARIABLE>=<VALUE>]... \
    [-p <HOST_PORT>:<CONTAINER_PORT>]... \ 
    cttynul/waybackproxy

Example:

docker run -d --name=waybackproxy -e DATE=20011025 -p 8888:8888 cttynul/waybackproxy

⁠Known issues and limitations

• The Wayback Machine itself is not 100% reliable. Known issues include:
  • Pages newer than the specified date (setting a specific YYYYMMDD date instead of a wider YYYYMM or YYYY helps with that);
  • Random broken images;
  • Strange 404 errors caused by bad server responses or incorrect URL capitalization at archival time;
  • Infinite redirect loops;
  • Server errors when it's having a bad day.
• WaybackProxy will work around some redirection scripts (example: http://example.com/redirect?to=http://...) which are not archived by the Wayback Machine, but the destination URLs are sometimes not archived either.
• WaybackProxy is not a generic proxy. The POST and CONNECT methods are not implemented.
• Transparent proxying mode requires HTTP/1.1 and therefore cannot be used with some really old (pre-1996) browsers. Use standard mode with such browsers.

⁠Links

• richardg867⁠'s original repository⁠
• cttynul⁠'s fork repository⁠