---
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
```bash
npm run deploy
# or
wrangler deploy
```

### 6. Test
```bash
# 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
```