Repository navigation
v2.4.0 — Proxy Support & Streaming Fix
What's New
🛡️ Proxy Support (NEW)
- ScraperAPI Integration — Route requests through ScraperAPI premium residential IPs when direct requests fail
- FlareSolverr Integration — Route requests through self-hosted FlareSolverr browser when direct requests fail
- Proxy Status Endpoint —
GET /api/proxy/statusshows configured proxy providers - Auto Proxy Fallback —
fetchWithMirror()automatically falls back to configured proxies when all mirrors fail - Cloudflare Detection — Detects Cloudflare challenge pages and triggers proxy fallback
📺 Streaming Status
- Added
⚠️ Streaming Status section documenting which endpoints work vs which are blocked - Added solutions table with SCRAPER_API_KEY and FLARESOLVERR_URL env vars
🔧 New Files
src/helper/proxy.helper.js— Unified proxy support for ScraperAPI + FlareSolverr
Bug Fixes
🚨 CRITICAL
- Fixed
/api/streamreturningnullURL — Upstream AJAX endpoints (/ajax/server?get=,/ajax/server/list?servers=) require session cookies; now properly detects upstream 500 errors and returns HTTP 502 with error message
🐛 Other Fixes
- Cookie-aware session establishment in
extractStreamInfoandextractServerList - Upstream error detection — detects
status >= 400and non-JSON error strings - Optional
?slug=parameter for session establishment
Changes
- Mirror helper now includes proxy fallback and Cloudflare detection
- Updated all docs with streaming status warnings
- Version bumped to 2.4.0
Environment Variables
# Option 1: ScraperAPI (requires premium plan — $49/month)
SCRAPER_API_KEY=your_scraperapi_key
# Option 2: FlareSolverr (self-hosted, unlimited)
FLARESOLVERR_URL=http://your-flaresolverr-host:8191Full Changelog: v2.2.2...v2.4.0