Macintosh-HW
/
RASCSI
mirror of https://github.com/akuker/RASCSI.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Created Vintage Web Proxy (markdown)

Daniel Markstedt 2021-11-07 10:25:09 -08:00
parent 13b2b0be4f
commit 8b89155323
1 changed files with 40 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Vintage-Web-Proxy.md Normal file

@ -0,0 +1,40 @@
# Introduction
If you're reading this, you may just have gotten your vintage computer online, through RaSCSI'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](https://www.pcmag.com/news/7-modern-bbses-worth-calling-today) such as Level 29, or browsing websites made for vintage computers such as http://www.theoldnet.com or http://68k.news.
However, 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) and even the last versions of classic Mac OS (or AmigaOS, Windows 98, etc.) have root certificates long since expired.
Vintage Web Proxy servers to the rescue! The Raspberry Pi that RaSCSI runs in 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 RaSCSI. This page will cover a few options, tested in particular with older Macs.
# macproxy
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 will retain 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.
The author has [forked macproxy](https://github.com/rdmark/macproxy) and improved it to work with venv and Python3, more aggressive translation of https to http, adding support for embedded images and binary downloads, among other fixes.
To use it on your Raspberry Pi, clone the repository to your home folder, e.g.:
```
cd
git clone https://github.com/rdmark/macproxy.git
```
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 5000, so configure your vintage browser to use the Pi's ip address with port 5000 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](https://macintoshgarden.org/apps/internet-config-202) to configure a proxy server.
On really old systems, such as 68000 Macs, it is recommended to turn off image loading in the browser altogether. Otherwise you'll have to contend with a ton of errors and slowdown as the software is struggling to deal with content it isn't able to handle.
# WebOne
[WebOne](https://github.com/atauenis/webone) is a full-featured proxy server implemented with .NET and is able to run on a Pi with Microsoft's .NET Core libraries for Linux. It translates https to http, and does pinpointed JavaScript injection and image file transcoding to deliver as close a modern web experience as possible on vintage systems.
It is a recommended solution for late-90s or early 2000s systems such as mid to late era Power Macs, or Windows 95/98 machines.
The author has tested and recommends the 0.11.1-noffmpeg release for ARM. By using the noffmpeg version, you avoid pulling in 500+ MB of audio and video libraries for multimedia transcoding to your Pi.
Follow the [Linux installation](https://github.com/atauenis/webone/wiki/Linux-installation) instructions on that project's wiki to install and configure WebOne.
By default, WebOne will run on port 8080 which conflicts with the RaSCSI Web Interface. After installing the software, you'd want to edit /etc/webone.conf and change the Port line to something like 8088.