README.md

metadata

title: YumeZone HLS Proxy
emoji: 🎬
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false

YumeZone HLS Proxy

A fast, deployable HLS proxy server that rewrites M3U8 playlists and proxies video streams through your Hugging Face Space.

Features

• Base64url encoded payload support
• M3U8 playlist rewriting
• CDN rule-based referer/origin spoofing
• CORS enabled
• Works with various anime/video streaming CDNs

Deployment

This Space uses Docker. The server starts automatically on port 3000.

Endpoints

• GET /health — Health check
• GET /proxy?url=<url>&ref=<referer> — Proxy request with optional referer
• GET /p/<base64url> — Base64-encoded payload proxy

Test

Visit: /health to verify it's running

Example proxy:

/proxy?url=https%3A%2F%2Fexample.com%2Fvideo.m3u8&ref=https%3A%2F%2Fexample.com%2F

• For custom domain:
  • route: Your worker route (e.g., example.com/api/proxy/*)
  • zone_id: Your domain's zone ID

4. Update WORKER_BASE in index.js

Replace {url here} with your worker's URL (e.g., https://yumezone.example.com or https://yourname.workers.dev)

5. Deploy

npm run deploy
# or
wrangler deploy

6. Test

# Health check
curl https://yourname.workers.dev/health

# Proxy a URL
curl "https://yourname.workers.dev/proxy?url=https://example.com/video.m3u8"

Features

• Base64URL encoding: /p/<base64url> - secure, obfuscated requests
• Legacy support: /proxy?url=...&ref=... - backward compatible
• CDN Rules: Pre-configured headers for popular CDN hosts
• M3U8 Rewriting: Auto-rewrites playlist URLs to go through proxy
• Browser impersonation: Spoofs User-Agent and other headers
• Range requests: Supports HTTP Range header for video segments
• CORS enabled: Works with cross-origin requests

Environment

This is a Service Worker - no external dependencies required. Uses native Cloudflare Worker APIs.

File Structure

.
├── index.js          # Main worker code
├── package.json      # Project metadata
├── wrangler.toml     # Cloudflare Worker config
├── .gitignore        # Git ignore rules
└── README.md         # This file