Introduction

If you're reading this, you may just have gotten your vintage computer online, through PiSCSI's DaynaPORT adapter emulation, other any other means. And now you're asking yourself, what's next?

While a vintage computer is excellent for telneting into a BBS such as Level 29, or browsing websites made for vintage computers such as http://www.theoldnet.com or http://68k.news, the broader modern Web is an unforgiving place for a vintage computer and its equally vintage browsers. The sheet amount of data that they send to the user agent, javascript libraries thousands of lines long, massive images in exotic formats, multimedia, etc... It may take minutes to load a page, and minutes more to parse and reflow the DOM over and over, and you're lucky if it doesn't crash when running out of memory.

And the biggest practical hurdle: the move to enforcing encrypted https connections on a vast majority of sites (I blame Google for that) that even the last versions of classic Mac OS (or AmigaOS, Windows 98, etc.) aren't able to decrypt due to expired root certificates or other cryptographic limitations.

Vintage Web Proxy servers to the rescue! The Raspberry Pi that PiSCSI runs on is a versatile little device, and if it is not already overburdened by other software, it should be able to run a proxy server in parallel with PiSCSI. This page will cover a few options, tested in particular with older Macs.

Macproxy

Note: As of PiSCSI 21.11.01, easyinstall.sh has an option to install Macproxy for you.

The recommended vintage web proxy companion to PiSCSI is Macproxy Classic, but there are many others you can play around with too.

Despite the name, the use of Macproxy is not at all limited to Macs. It is a super light-weight proxy implemented as a Python script running a Flask app, which will translate https requests to http, and strip out the vast majority of linked contents such as style sheets and JavaScript, while suppressing inline scripts as well. It has support for binary file downloading, and can convert embedded images to be decoded by vintage browsers.

Macproxy is an excellent choice for any 68k Mac, or other retro computer of a similar vintage. But don't expect contents that rely on heavy scripting to work well.

Then simply follow the instructions in the README.md of that project to learn how to run the script stand-alone or as a systemd daemon.

By default, the proxy server will run on port 5001, so configure your vintage browser to use the RPi's ip address with port 5001 as http and https proxy. On Mac, depending on which browser you're using, you may have to install the stand-alone utility Internet Config to configure a proxy server.

On really old systems, such as 68000 Macs, it is recommended to turn on 1-bit gif conversion of images.