Запись и трансляция эфирного ТВ на Raspberry Pi с Tvheadend

Что вы получите из этого руководства

• Полная инструкция по установке и первоначальной настройке Tvheadend на Raspberry Pi.
• Команды для проверки и установки прошивок тюнера.
• Советы по потоковой передаче в домашней сети и по записи программ.
• Руководства по отладке, матрицы совместимости, критерии приёмки и чек‑листы ролей.

Что такое Tvheadend

Tvheadend — это сервер для приёма, трансляции и записи телепередач с разных источников: эфирное DVB‑T/T2, кабельное DVB‑C, спутниковое DVB‑S/S2, ATSC и IPTV. Он предоставляет web‑интерфейс для настройки, EPG (гид передач), списки каналов в формате M3U и поддержку потоков для внешних плееров.

Краткое определение терминов:

• DVB‑T/T2 — цифровое эфирное телевизионное вещание (технологии для наземного ТВ).
• EPG — электронная программа передач, метаданные о передачах и времени их показа.

Необходимое оборудование и ПО

• Raspberry Pi 2, 3, 3B+ (или новее) с корпусом; Pi 3B+ или выше рекомендуется для стабильных многопоточных потоков.
• microSD с Raspbian (Lite подойдет для минимальной установки).
• Блок питания 5V @ 2.5A (качественный, чтобы избежать падения питания).
• USB DVB‑T/T2 тюнер или Raspberry Pi TV HAT (подключается к GPIO).
• Антенна, подходящая для вашего региона и частот.
• Второй компьютер или смартфон для SSH и доступа к web‑интерфейсу.

Важно: если вы используете TV HAT, он занимает GPIO‑пины; убедитесь, что другие расширения не конфликтуют.

Совместимость аппаратуры: матрица и подсказки

• Raspberry Pi 2/3/3B+: совместим с большинством USB‑тюнеров, но рекомендован Pi 3B+ или 4 для стабильной многопользовательской трансляции.
• Raspberry Pi TV HAT: работает с DVB‑T2 (зависит от региона).
• USB‑тюнеры (RTL2832U и производные): дешевые, широко распространены; для работы может понадобиться прошивка.
• Профессиональные тюнеры/HDHomeRun: чаще работают «из коробки», но дороже.

Совет: перед покупкой проверьте списки совместимости (производитель тюнера и ядро Linux). Если нужен многоканальный одновременный приём, выбирайте тюнеры с поддержкой мультиплексов и несколькими демодуляторами.

Шаг 1. Подготовка Raspberry Pi

1. Запишите Raspbian Lite на microSD и при первом запуске подключите Pi к сети.
2. При первой загрузке обновите систему и смените пароль:

sudo apt update
sudo apt upgrade -y
passwd

3. Для удалённого доступа создайте пустой файл ssh в разделе boot микросд — это включит SSH.
4. Найдите IP‑адрес Pi в вашей сети (через роутер или сетевой сканер) и подключитесь по SSH.

Подключите USB‑тюнер или установите TV HAT. Проверьте, что ОС видит USB‑устройство:

lsusb

Проверьте системный журнал на предмет загрузки модулей DVB:

dmesg | tail | grep dvb

Если вы видите ошибки о недостающей прошивке, установите пакет прошивок:

sudo apt install git
git clone https://github.com/OpenELEC/dvb-firmware.git
cd dvb-firmware
./install
sudo reboot

После перезагрузки повторите dmesg | tail | grep dvb и lsusb.

Шаг 2. Установка Tvheadend

Установите Tvheadend из репозиториев:

sudo apt install tvheadend -y

Во время установки инсталлятор запросит имя пользователя и пароль администратора для web‑интерфейса. Введите их и завершите установку. По умолчанию web‑интерфейс работает на порту 9981.

Если потребуется, можно управлять службой systemd:

sudo systemctl status tvheadend
sudo systemctl enable --now tvheadend

Шаг 3. Первая конфигурация через web

Откройте браузер и перейдите по адресу:

http://YourIPAddress:9981

Замените YourIPAddress на IP вашего Pi. Войдите с учетными данными, указанными при установке.

1. Выберите язык интерфейса и для EPG, нажмите Save & Next.
2. В разделе Allowed Network укажите подсеть вашей локальной сети (например, 192.168.1.0/24), чтобы сервер принимал соединения только с домашней сети.
3. Настройте дополнительные пользователи (админ/стандартный пользователь) при необходимости.
4. Tvheadend должен обнаружить ваш тюнер (он появится в списке адаптеров). Выберите тип сети: DVB‑T Network.
5. Выберите «pre‑defined muxes» для вашей страны и ближайшей вышки. Если вы не уверены, воспользуйтесь локальным инструментом для поиска передатчика (например, сайты радио/телеком компаний или ББС‑инструмент в UK).
6. Запустите сканирование — дождитесь 100% и сохраните результаты.
7. В разделе сопоставления сервисов отметьте Map all services, Create provider tags и Create network tags, затем нажмите Save & Next.

Если каналы обнаружены и сопоставлены, нажмите Finish.

Шаг 4. Стриминг и запись

Tvheadend умеет отдавать плейлисты M3U и потоки в формате MPEG‑TS, которые воспроизводят VLC, Kodi и мобильные клиенты (например, TvhClient).

Скачать список каналов для VLC можно по URL:

http://username:password@YourIPAddress:9981/playlist/channels

Подставьте свои имя пользователя, пароль и IP. Откройте ссылку в VLC — каналы должны появиться как плейлист.

Чтобы записать программу через web‑интерфейс, откройте EPG, выберите передачу и нажмите Record program или Record series для записи серий. Файлы будут сохраняться в директории записи, заданной в настройках Tvheadend (по умолчанию в /home или /var — проверьте в настройках записи).

Критерии приёмки (проверки установки)

• Web‑интерфейс доступен на порту 9981 и авторизация работает.
• Тюнер виден в списке адаптеров в Tvheadend.
• Сканирование мультиплексов возвращает список каналов и EPG‑данные.
• Поток воспроизводится в VLC без значимых торможений в локальной сети.
• Запись запускается по расписанию и создаёт плейбэк‑файл, который можно воспроизвести.

Отладка: пошаговый playbook при проблемах

1. Нет тюнера в lsusb / dmesg: проверьте питание USB и кабель, попробуйте другой порт.
2. Проблемы с прошивкой: установите прошивки из репозитория dvb‑firmware и перезагрузитесь.
3. Нет каналов после сканирования: убедитесь, что выбраны правильные «pre‑defined muxes» и антенна направлена.
4. Низкая производительность при трансляции нескольких потоков: проверьте нагрузку CPU (top) и использование сети; при необходимости используйте Raspberry Pi 4 или внешний сервер.
5. Проблемы с правами записи: убедитесь, что путь записи доступен для пользователя tvheadend (обычно tvheadend:tvheadend).

Роли и чек‑листы

Чек‑лист владельца домашней сети:

• Установить Pi в компактном корпусе с охлаждением.
• Использовать стабильный источник питания.
• Настроить резервное копирование важных записей на NAS.

Чек‑лист администратора Tvheadend:

• Контролировать логи (/var/log/syslog и tvheadend‑логи).
• Периодически обновлять ОС и Tvheadend.
• Ограничить доступ по сети (Allowed Network) и использовать сильные пароли.

Чек‑лист медиапользователя:

• Подключить VLC/Kodi к M3U.
• Проверить качество потока и время записи.
• Настроить автоматические записи для любимых сериалов.

Шаблоны и тест‑кейсы приёмки

Тест‑кейс 1 — доступ к web‑интерфейсу:

• Шаги: перейти по http://IP:9981, войти.
• Ожидаемый результат: открылся главный экран Tvheadend.

Тест‑кейс 2 — воспроизведение канала в VLC:

• Шаги: скачать плейлист /playlist/channels, открыть в VLC.
• Ожидаемый результат: видео идёт без значимой паузы в локальной сети.

Тест‑кейс 3 — запись программы:

• Шаги: запустить запись из EPG, дождаться окончания, воспроизвести файл.
• Ожидаемый результат: файл воспроизводится на любом клиенте поддерживающем MPEG‑TS.

Когда это не сработает (ограничения и контрпримеры)

• Если канал шифруется (DRM или платные пакеты), Tvheadend не сможет декодировать его без соответствующих CAM/модулей и подписки.
• В регионах без DVB‑T/T2 (или где эфирное ТВ снято) этот подход бесполезен.
• По слабому приёму антенны будут постоянные артефакты или отсутствие каналов.
• Если вы хотите записывать платное спутниковое ТВ с CA, стандартный Tvheadend и дешёвый тюнер скорее всего не помогут.

Альтернативные подходы

• HDHomeRun + Plex/Plex DVR: коммерческое сетевое решение, часто проще в настройке, но платно за Plex DVR.
• MythTV: старый, зрелый PVR с широкими возможностями, более требовательный к настройке.
• NextPVR: удобный для Windows/в некоторых Linux‑сборках.
• Использовать облачные DVR/легальные сервисы — если вам важна простота и официальные метаданные/DRM.

Производительность и зрелость решения

• Уровень 1 (Proof of Concept): одна Raspberry Pi 3 с одним USB‑тюнером и локальным воспроизведением.
• Уровень 2 (Домашний сервер): Raspberry Pi 4 или NAS + 1–2 тюнера, записи на NAS, поток для 1–3 устройств.
• Уровень 3 (Многопользовательский): выделенный сервер, многотюнерные платы, резервирование, высокоскоростной NAS.

Безопасность и приватность

• По умолчанию Tvheadend не шифрует трафик; для доступа извне используйте VPN или обратный прокси с TLS.
• Ограничьте Allowed Network к домашней подсети.
• Логи EPG и записей содержат метаданные о просмотрах — храните их локально и очищайте при необходимости.

Краткая методология развертывания (mini‑methodology)

1. Подготовьте Pi и подключите тюнер.
2. Обновите систему и установите прошивки тюнера.
3. Установите Tvheadend и завершите начальную настройку через веб‑мастер.
4. Сканируйте мультиплексы и сопоставьте каналы.
5. Настройте записи и проверьте воспроизведение на типичных клиентах.

Примеры команд для администрирования

Просмотр статуса службы:

sudo systemctl status tvheadend

Просмотр логов (реальное время):

sudo journalctl -u tvheadend -f

Проверка использования процессора и сети:

top
iftop   # при наличии пакета

ТCO / ROI — качественная оценка

• Затраты: Raspberry Pi + тюнер + антенна — обычно значительно дешевле годовой подписки на кабельное ТВ.
• Возврат инвестиций: экономия на месячной абонентской плате, гибкость записи и использования личных архивов.
• Риски: время на настройку и обслуживание; возможные ограничения доступа к платному контенту.

Совместимость и миграция

• Если вы планируете мигрировать с другого PVR (MythTV, NextPVR), экспортируйте/импортируйте EPG и плейлисты, но учтите различия в форматах записи и расписаниях.
• При переходе на мощный сервер можно перенести базу настроек Tvheadend (конфиг и записи) путем копирования конфигурации и каталогов записей.

Памятка: пути файлов и разрешения

• Проверьте, где Tvheadend сохраняет записи (в настройках записи указана директория).
• Убедитесь, что пользователь tvheadend имеет права на чтение/запись в этой директории.

Глоссарий (1‑строчные определения)

• DVB‑T2 — современный стандарт эфирного цифрового телевидения; улучшенная версия DVB‑T.
• EPG — электронная программа передач.
• M3U — плейлист используемый плеерами для списка потоков.

Итог и рекомендации

Tvheadend на Raspberry Pi — зрелое и гибкое решение для записи и трансляции эфирного телевидения в домашней сети. Оно экономит деньги по сравнению с традиционным кабелем, даёт контроль над записями и поддерживает множество плееров. Вывод: если в вашей стране есть DVB‑T/T2 и вам важна автономность медиа‑хранилища — это хорошая инвестиция времени и средств.

Короткие советы перед стартом:

• Начните с простой сборки (Pi + один тюнер).
• Убедитесь в качестве сигнала антенны до покупки нескольких тюнеров.
• Планируйте резервное копирование записей на NAS.

Вопросы, которые стоит задать себе перед разворачиванием:

• Нужен ли мне доступ к записям извне? (если да — готовьте VPN/TLS).
• Хочу ли я записывать несколько каналов одновременно? (проверьте количество демодуляторов в тюнере).

Конец руководства.