AO3 Mirror v4 — initial commit

Cookie-aware proxy pool with CF challenge solving
- Tiered proxy pool (fast 50 + main 676)
- Per-proxy cf_clearance cookie persistence
- CF challenge detection + user-browser solving
- Safari + Chrome TLS fingerprint rotation
- Async FastAPI backend with LRU cache
- Passive daemon with systemd supervision
- Stats dashboard + Prometheus metrics

.env.example

@@ -0,0 +1,43 @@
+# AO3 Mirror — Environment Configuration
+# Copy to .env.local and fill in real values:
+#   cp .env.example .env.local
+
+# ── Mirror ─────────────────────────────────────────────────
+MIRROR_DOMAIN=agento3.miscs.dev
+AO3_URL=https://archiveofourown.org
+PROXY_FILE=/home/ubuntu/proxy.txt
+WORKING_PROXIES_FILE=/dev/shm/working_proxies.txt
+
+# Worker config
+WORKER_COUNT=2
+WORKER_START_PORT=8081
+UVICORN_WORKERS=1
+
+# ── Monitoring ────────────────────────────────────────────
+PRODUCTION_URL=https://agento3.miscs.dev
+HEALTH_CHECK_URL=https://agento3.miscs.dev/health
+SENTRY_DSN=your-sentry-dsn
+
+# ── Notifications — at least one required for alerts ─────
+# Telegram: create bot via @BotFather, get chat ID by messaging @userinfobot
+TELEGRAM_BOT_TOKEN=your-telegram-bot-token
+TELEGRAM_CHAT_ID=your-telegram-chat-id
+
+# Slack
+SLACK_WEBHOOK_URL=your-slack-webhook-url
+
+# Email (for status reports)
+EMAIL_TO=your-email@example.com
+
+# ── GitHub (for issue tracking, PR management) ───────────
+GITHUB_REPO=owner/ao3-mirror
+GITHUB_USERNAME=your-username
+GITHUB_TOKEN=ghp_your-fine-grained-token
+
+# ── Cloudflare ────────────────────────────────────────────
+CF_API_TOKEN=your-cloudflare-api-token
+CF_ZONE_ID=your-zone-id
+
+# ── WebShare Proxy ────────────────────────────────────────
+WEBSHARE_API_KEY=your-webshare-api-key
+PROXY_REFRESH_INTERVAL_MIN=30