Initial commit: Retro-Proxy-Stack

README.md

@@ -0,0 +1,25 @@
+# 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](https://www.stunnel.org/):** Handles secure TLS translation for legacy mail clients.
+- **[WebOne](https://github.com/atauenis/webone):** An HTTP proxy that strips modern security requirements, enabling vintage browsers to access the modern web.
+- **[WRP (Web Rendering Proxy)](https://github.com/tenox7/wrp):** 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](./GEMINI.md).