HLS Restream Proxy: Công cụ đưa luồng thể thao miễn phí vào Jellyfin không quảng cáo

HLS Restream Proxy: Công cụ đưa luồng thể thao miễn phí vào Jellyfin không quảng cáo

HLS Restream Proxy là bộ công cụ nhẹ giúp người dùng tự host máy chủ media như Jellyfin hay Plex phát các luồng IPTV/HLS miễn phí mà không gặp lỗi 403. Công cụ hoạt động như một trung gian, tự động chèn các HTTP header cần thiết và xử lý token để đảm bảo trải nghiệm xem mượt mà.

Giới thiệu giải pháp

Đối với cộng đồng những người yêu thích tự dựng máy chủ media (self-hosted) sử dụng Jellyfin, Emby hay Plex, việc tích hợp các nguồn IPTV miễn phí thường gặp nhiều khó khăn. Nhiều luồng phát trực tuyến (stream) yêu cầu các tiêu đề HTTP cụ thể như User-Agent hoặc Referer để xác thực, mà các máy chủ media này thường không gửi đi theo mặc định, dẫn đến lỗi phát sóng.

HLS Restream Proxy ra đời để giải quyết vấn đề này. Đây là một bộ công cụ nhẹ đóng vai trò là trung gian giữa máy chủ media của bạn và nguồn phát trực tuyến ngược dòng (upstream).

Cơ chế hoạt động

Về cơ bản, proxy này sẽ chèn các header cần thiết vào yêu cầu và ghi lại (rewrite) các danh sách phát m3u8 để đảm bảo tất cả các yêu cầu phân đoạn (segment requests) đều đi qua proxy.

Quy trình hoạt động diễn ra như sau:

1. Jellyfin gửi yêu cầu phát tới hls-proxy.
2. Proxy thêm các header (User-Agent, Referer) và chuyển tiếp tới upstream HLS server.
3. Nguồn phát trả về các phân đoạn video (.ts).

Điểm đặc biệt là proxy này có khả năng tự động học (auto-learn) Referer chính xác cho từng máy chủ chủ, giúp người dùng không cần cấu hình thủ công. Ngoài ra, nó xử lý việc làm mới token một cách trong suốt, giúp các URL M3U không bao giờ bị hết hạn.

Các tính năng chính

Công cụ bao gồm các thành phần và tính năng hữu ích sau:

• hls-proxy.py: Một reverse proxy HTTP thêm các header vào các yêu cầu HLS ngược dòng.
• refresh-m3u.sh: Tự động quét các trang nguồn, trích xuất URL m3u8 và ghi file danh sách phát M3U.
• detect-headers.sh: Tự động phát hiện các HTTP header mà luồng stream yêu cầu, giúp việc cấu hình trở nên đơn giản hơn bao giờ hết.
• Hỗ trợ Docker & Systemd: Dễ dàng tích hợp vào môi trường container hoặc thiết lập chạy nền tự động trên Linux.

Hướng dẫn cài đặt nhanh

Để sử dụng HLS Restream Proxy, bạn cần Python 3.8+, bash, curl và grep. Các bước cài đặt cơ bản bao gồm:

1. Clone mã nguồn từ GitHub.
2. Cấu hình file channels.conf với danh sách kênh của bạn.
3. Khởi chạy proxy bằng lệnh python3 hls-proxy.py.
4. Tạo file M3U và thêm nó vào Jellyfin dưới dạng M3U Tuner.

Nếu máy chủ media của bạn chạy trong Docker trên mạng bridge, hãy đảm bảo sử dụng IP Gateway của Docker (thường là 172.x.0.1) thay vì 127.0.0.1 cho URL proxy.

Đây là một công cụ hữu ích cho những ai muốn tùy biến hệ thống giải trí gia đình của mình một cách chuyên nghiệp và tự chủ.