Auto-PROXY-SF is a privacy-focused userscript that automatically redirects mainstream surveillance platforms to privacy-respecting proxy frontends. The tool employs intelligent health monitoring, latency-based instance selection, and supports both clearnet and I2P networks.
Features
- Intelligent Instance Selection: Monitors instance health and latency, automatically routing to the fastest available proxy
- I2P Network Support: Curated collection of low-latency I2P instances for anonymous browsing
- Automatic Health Checking: Parallel health verification with 5-minute caching to minimize overhead
- Dynamic Link Rewriting: Processes links using Intersection Observer for optimal performance
- Adaptive Loading Page: Professional redirect interface with progress indication
- Network Switching: Toggle between clearnet and I2P via integrated menu
Supported Services
| Service |
Proxy Frontend |
| YouTube |
Invidious |
| Twitter/X |
Nitter |
| Reddit |
Libreddit |
| Google Search |
SearX |
| TikTok |
ProxiTok |
Installation
Install a userscript manager:
- Firefox: Greasemonkey, Violentmonkey
- Chrome/Brave: Tampermonkey, Violentmonkey
- Safari: Userscripts
Click the script file to install
Grant necessary permissions when prompted
Script activates automatically on supported sites
Usage
Automatic Mode: Visit any supported service (YouTube, Twitter, Reddit, etc.). The script detects the platform and redirects to a privacy proxy after displaying a loading screen.
Link Rewriting: When browsing sites containing links to tracked services, the script automatically rewrites them to proxy equivalents. Modified links appear in green.
Network Selection:
- Access userscript menu (varies by manager)
- Select "Network: CLEARNET" to toggle to I2P
- Select "Network: I2P" to toggle back to clearnet
- Page reload required after network change
Cache Management:
- Select "Clear Cache" to reset instance health data
- Useful when experiencing connectivity issues
- Automatically rebuilds health metrics on next use
Configuration
The script operates with secure defaults. Advanced users can modify:
const CONFIG = {
HEALTH_CHECK_INTERVAL: 300000, // 5 minutes
INSTANCE_TIMEOUT: 4000, // 4 seconds
PARALLEL_CHECKS: 4, // Concurrent checks
MAX_RETRY_ATTEMPTS: 2 // Retry count
};
Technical Architecture
Health Monitor: Implements exponential scoring based on latency (30%), uptime (50%), and reliability (20%). Caches results with timestamp validation.
Instance Manager: Maintains separate pools for clearnet and I2P, selecting optimal instances through parallel health verification.
URL Processor: Uses WeakSet tracking to prevent duplicate processing, with regex-based service detection.
Loading Interface: Injects animated redirect page using document.write(), avoiding CORS restrictions while maintaining visual continuity.
Privacy Considerations
- All requests use
anonymous: true flag to prevent credential leakage
- No telemetry or analytics
- Instance health data stored locally only
- Original URLs never transmitted to third parties
- I2P routing provides network-level anonymity
Troubleshooting
Redirect loops: Clear browser cache and script storage via menu
No instances available: Check network connectivity, verify userscript manager permissions
Slow redirects: Network may be selected incorrectly. I2P requires properly configured router with established tunnels
Links not rewriting: Disable conflicting userscripts, ensure script runs at document-start
Metadata
- Version: 1.0.0
- Release Date: 2025-01-06
- Author: Anonymousik
- Homepage: https://anonymousik.is-a.dev
- License: AGPL-3.0-only
- Division: SecFerro
Inspiration
This project builds upon the original Proxy Redirect userscript by Schimon Jehudah, with significant architectural improvements:
- Replaced synchronous XHR with async health monitoring
- Implemented intelligent scoring algorithms
- Added I2P network support with curated instances
- Redesigned loading interface based on modern web aesthetics
- Enhanced security with anonymous request flags
The loading page design draws inspiration from contemporary loader patterns emphasizing visual feedback and brand consistency.
Contributing
Instance suggestions, bug reports, and performance optimizations welcomed at the project homepage.
