R2 Mirror

Hybrid file sync to Cloudflare R2 with intelligent CDN bypass and multi-source acceleration

Features

📋
Manifest-Driven
Simple sync.txt file controls everything. Human-readable, git-friendly.
🛡️
CDN Bypass
Routes Discord CDN through VPS proxy with aria2 multi-connection acceleration.
🌐
Browser Downloads
Headless Chromium for JS-heavy sites like Proton Drive and Google Drive.
📱
Phone Uploads
Share links from mobile to upload directly to R2 via iOS Shortcuts or Android.
⚡
Parallel Downloads
Use Worker + VPS simultaneously for maximum throughput on large files.
👀
Watch Mode
Auto-sync on manifest changes with intelligent debouncing.

Architecture

┌────────────────────────────────────────────────────────────────┐ │ Control Plane (Local) │ │ │ │ sync.txt ────▶ SyncService ────▶ R2Client ────▶ R2 Bucket │ │ │ │ │ ┌────────┴────────┐ │ │ ▼ ▼ │ │ ┌──────────┐ ┌───────────┐ │ │ │ Worker │ │ VPS Proxy │ │ │ │ (edge) │ │ (aria2) │ │ │ └──────────┘ └───────────┘ │ └────────────────────────────────────────────────────────────────┘

Usage

terminal
# One-time sync python run.py sync # Watch mode (auto-sync on changes) python run.py sync --watch # Pull remote changes from phone uploads python run.py pull # Parallel download (Worker + VPS combined) python run.py parallel "https://example.com/file.mp4" "file.mp4"

Performance

Source
Method
Speed
Discord CDN
VPS + aria2
400-600 Mbps
Fast CDNs
Cloudflare Worker
100-200 Mbps
Throttled hosts
aria2 (16 connections)
3-5× faster
Large files
Parallel mode
Combined BW

Cost

~€4/month
Hetzner VPS + Cloudflare R2 & Workers free tier

Stack

Python
Local client + VPS services
FastAPI
VPS proxy + browser API
Playwright
Headless browser
Workers
Edge compute