Skip to content

v2.4.0 — Proxy Support & Streaming Fix

Choose a tag to compare

@Shineii86 Shineii86 released this 14 Aug 02:22
· 12 commits to main since this release

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/status shows 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/stream returning null URL — 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 extractStreamInfo and extractServerList
  • Upstream error detection — detects status >= 400 and 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:8191

Full Changelog: v2.2.2...v2.4.0