Retro-Proxy-Stack/README.md

Retro-Proxy-Stack

A Docker Compose orchestration layer that bundles existing proxy tools to help legacy Windows 9x/XP clients (Outlook Express 6, IE 5/6) connect to modern services.

Note: This project is purely a configuration layer. All core functionality is provided by the respective upstream projects.

Features

• Legacy Mail Proxy: Uses Stunnel to translate non-SSL legacy client connections into secure TLS 1.3 tunnels for modern servers. Note: Best used with your own private mail server (like Synology MailPlus) that supports standard basic authentication (PLAIN/LOGIN).
• WebOne Proxy: An HTTP proxy that strips modern security requirements and complex scripts, allowing vintage browsers to access the modern web.
• WRP (Web Rendering Proxy): A visual proxy that renders modern webpages as clickable image maps for hardware that cannot handle modern web standards.

Included Tools

• Stunnel: Handles secure TLS translation for legacy mail clients.
• WebOne: An HTTP proxy that strips modern security requirements, enabling vintage browsers to access the modern web.
• WRP (Web Rendering Proxy): A visual proxy that renders modern webpages as clickable image maps.

Setup

1. Configure: Update stunnel.conf with your upstream mail server details.
2. Launch: Run docker compose up -d to start all services.
3. Configure Clients:
   • Mail: Set up accounts in your legacy client (Outlook Express 6) using the host's IP. Disable "Secure Password Authentication" (SPA) and use no encryption (the proxy handles it).
   • Web: Set your browser's proxy settings to host-ip:8081 (WebOne) or visit http://host-ip:8082 (WRP).

Documentation

For full details on architecture, service mappings, and configuration, see GEMINI.md.