← Все проекты
Проект / Shell

pcruz1905/hls-restream-proxy: hls-restream-proxy — лёгкий прокси для IPTV-стримов в Jellyfin/Emby/Plex

Позволяет смотреть бесплатные IPTV-каналы в медиасерверах, которые требуют специальных заголовков.

Это набор скриптов на Python и Bash для организации ретрансляции HLS-потоков. Прокси решает проблему с заголовками, которые требуют многие бесплатные стриминговые сайты. Включает в себя основной прокси-сервер, скрипт для обновления плейлистов и утилиту для...

★ 135 Shell Форки 5 Issue 1 Оценка 6/10 Карточка проверена

Для кого это

Для энтузиастов домашних медиасерверов (Jellyfin, Emby, Plex), которые хотят добавить бесплатные IPTV-каналы из открытых источников.

Проблема / задача

Многие бесплатные IPTV-источники требуют отправки специфичных HTTP-заголовков (User-Agent, Referer), которые медиасерверы по умолчанию не отправляют, из-за чего стримы не работают.

Как это работает

Прокси становится промежуточным звеном между медиасервером и источником стрима. Он автоматически определяет нужные заголовки, подставляет их в запросы и переписывает плейлисты так, чтобы все сегменты видео тоже шли через него. Токены обновляются автоматически — пользователь получает стабильные ссылки.

Что видно по README

Это набор скриптов на Python и Bash для организации ретрансляции HLS-потоков. Прокси решает проблему с заголовками, которые требуют многие бесплатные стриминговые сайты. Включает в себя основной прокси-сервер, скрипт для обновления плейлистов и утилиту для автоматического определения необходимых заголовков.

Ключевые возможности

Внедрение HTTP-заголовков (User-Agent, Referer) в запросы к стримуАвтоматическое обновление токенов и URL стримовПереписывание плейлистов для проксирования всех сегментов видеоПоддержка Docker и systemd для фоновой работыАвтоопределение необходимых заголовков для каждого источника

Технологии

Python 3.8+ (только стандартная библиотека)Bash, curl, grepShellDockerGo

Темы и ключи

embyhlshomelabiptvjellyfinlive-tvm3um3u8plexproxyrestreamselfhosted

Интересный факт

Проект полностью обходится без внешних Python-библиотек — всё работает на стандартных модулях, что делает его очень лёгким и переносимым.

С чего начать

  • Склонируйте репозиторий и настройте channels.conf
  • Запустите прокси через Docker или Python
  • Сгенерируйте M3U-плейлист и добавьте его в медиасервер

Оценка GitRadar

Удобство
7/10
Свежесть
6/10
Перспектива
7/10
Монетизация
3/10
Общая оценка
6/10

Вердикт GitRadar

Стоит попробовать, если вы используете Jellyfin/Emby/Plex и хотите добавить бесплатные IPTV-каналы. Решает конкретную техническую проблему элегантно и без лишних зависимостей.

Наблюдения по обновлениям

Проект поддерживается, есть Docker-образ, последние коммиты в пределах года. Активность умеренная.

Что мы проверили

Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.

Исходный репозиторий
https://github.com/pcruz1905/hls-restream-proxy
Лицензия
MIT
Создан на GitHub
8 апреля 2026 г.
Последнее обновление репо
8 апреля 2026 г.
Последняя проверка GitRadar
8 апреля 2026 г.
Изученные файлы
README.md, Dockerfile, refresh-m3u.sh, detect-headers.sh, hls-proxy.py

FAQ

Что это такое?

Прокси-сервер, который позволяет медиасерверам работать с IPTV-источниками, требующими специальные HTTP-заголовки.

Для кого подходит?

Для владельцев домашних медиасерверов (Jellyfin, Emby, Plex), которые хотят смотреть бесплатные IPTV-каналы.

Источники

  • GitHub исходный код и активность
  • README описание, ссылки, стартовые материалы

Нужна помощь с pcruz1905/hls-restream-proxy?

Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.