Устранение сбоев Lampa: решение проблем TMDB, буфера и CUB

Архитектура медиаоболочки Lampa распределена: клиентский интерфейс, API каталогов, синхронизация CUB и P2P-движок. В отличие от закрытых кинотеатров, в Lampa все запросы прозрачны, что позволяет быстро локализовать неисправность. Базовые принципы работы описаны в материале об архитектуре Lampa TV, специфика проксирования афиш — в руководстве по TMDB Proxy в Lampa, а аудиосбои — в инструкции по звуку в AC3 и DTS. Ниже разобран порядок устранения шести типовых проблем.

Если Lampa работает без ошибок, но в карточке фильма есть только кнопка «Трейлеры», это не сбой: источники фильмов ещё не подключены. Что сделать, описано в статье «В Lampa только трейлеры».

Сводная диагностическая таблица сетевых кодов и ошибок

Проблемы проявляются как симптомы в интерфейсе, коды HTTP или сетевые ошибки браузерного движка:

Белые квадраты вместо постеров: TMDB недоступен

Частая проблема на Smart TV (Tizen, webOS, Android TV) — пустые серые или белые плашки вместо обложек фильмов. Обычно это значит, что api.themoviedb.org и image.tmdb.org недоступны из сети провайдера. Самый простой способ — включить в Lampa «Настройки» → «TMDB» → «Проксировать TMDB» (или «Включить прокси автоматически»). Если это не помогло, смените DNS.

Порядок смены DNS в параметрах телевизора:

• Откройте сетевые параметры ТВ (Wi-Fi или проводное Ethernet-соединение).
• Переведите конфигурацию параметров IP и DNS из режима DHCP в «Вручную» (Manual).
• В поле «Основной DNS» (Primary DNS) укажите 94.140.14.14 (AdGuard DNS, блокирует рекламу и трекеры) либо 1.1.1.1 (Cloudflare).
• В строке «Дополнительный DNS» введите 94.140.15.15 или 8.8.8.8.
• Сохраните параметры и перезапустите ТВ.

На Android TV 9 и новее проверку доступности и включение Private DNS (DNS-over-TLS) можно выполнить через ADB:

adb shell ping -c 4 image.tmdb.org
adb shell settings put global private_dns_mode hostname
adb shell settings put global private_dns_specifier dns.adguard-dns.com

Шифрованный DNS-over-TLS (DoT) защищает DNS-запросы от подмены провайдером, но не помогает, если блокируется сам IP-адрес сервера.

Зависания и буферизация 4K HDR

При просмотре тяжелых релизов 4K HDR10 и Dolby Vision видеопоток может регулярно останавливаться на буферизацию.

Причины разные: мало сидов, недостаточная скорость сети или Wi-Fi, слабое устройство, на котором работает TorrServer. Инструкция по установке описана в руководстве по серверу TorrServer Matrix, а настройка кэша — в статье о буферизации 4K в TorrServer. Если плеер теряет связь с сервером, пройдите проверку из статьи о том, что делать, когда TorrServer не отвечает. На приставках с небольшим объемом ОЗУ завышенный кэш может привести к тому, что Android выгрузит TorrServer из памяти (Low Memory Killer). В таком случае вынесите сервер на другое устройство, например TorrServer на Keenetic через Entware или на ПК.

Параметры кэша задаются в веб-интерфейсе TorrServer (http://IP_АДРЕС:8090 → «Настройки»). Значения по умолчанию в исходном коде TorrServer:

• Размер кеша (CacheSize): 64 МБ.
• Буфер предзагрузки (PreloadCache): 50% от размера кеша.
• Опережающий кеш (ReaderReadAHead): 95%.
• Торрент-соединения (ConnectionsLimit): 25 (подсказка в интерфейсе — «рекомендуется 20-25»).
• Тайм-аут отключения торрента: 30 секунд.

{
  "CacheSize": 67108864,
  "PreloadCache": 50,
  "ReaderReadAHead": 95,
  "ConnectionsLimit": 25,
  "TorrentDisconnectTimeout": 30
}

На устройствах с большим запасом памяти кэш можно увеличить, чтобы плеер мог пережидать кратковременные падения скорости. На слабых приставках лучше оставить значения по умолчанию или включить хранение кеша на накопителе («ПЗУ / Накопитель»), если он достаточно быстрый.

Сбой 403 Forbidden в каталоге CUB: аварийные шлюзы

Платформа CUB отвечает за синхронизацию закладок, истории просмотров, тайм-кодов и каталог расширений. Ошибка HTTP 403 возникает, если текущий домен CUB заблокирован у провайдера или запрос отклонен защитой сервера. Домены cub.red и cub.rip в исходном коде Lampa отмечены как старые зеркала; актуальный список — cub.best, cub.black, durex.monster, cubnotrip.top. Подробнее — в статье про актуальные зеркала Lampa.

Восстановление синхронизации:

• Выберите другое зеркало в параметре «Основной домен» (в зависимости от версии — в разделе «Синхронизация» или в меню разработчика).
• При необходимости выйдите из аккаунта и снова выполните вход: Настройки -> Синхронизация -> Выполнить вход, затем подтвердите код на сайте CUB.
• При блокировках направьте запросы через собственный Lampac (модуль CubProxy).
• Перезапустите приложение.

После восстановления в разделе «Синхронизация» снова отображаются строки «Вошли как» и «Профиль».

Ошибка ERR_CONNECTION_TIMED_OUT при старте через MSX

На телевизорах LG webOS и Samsung Tizen Lampa запускается через Media Station X (подробнее в руководстве по установке Lampa на Smart TV и в инструкции по настройке Media Station X для Lampa, где разобраны ошибки запуска MSX). Если торренты недоступны, используйте онлайн-балансеры для Lampa, а при исчезновении раздач восстановите кнопку «Торренты» в Lampa и проверьте парсер для Lampa.

Ошибка ERR_CONNECTION_TIMED_OUT означает, что хост не ответил за отведенное время — например, из-за сетевой блокировки или недоступности сервера. Детальный аудит сетевого стека описан в инструкции по ошибке Error -8 net::ERR_CONNECTION_TIMED_OUT в Lampa.

Смена стартового параметра MSX:

1. Откройте Settings -> Start Parameter в меню Media Station X.
2. Введите другой стартовый адрес. Пользователи применяют, например, сторонние хосты wals09.github.io и msxplayer.ru (лаунчер для MSX); это не официальные адреса Lampa, их работоспособность нужно проверять самостоятельно.
3. Подтвердите ввод и перезапустите MSX (Reboot). Если приложение зациклилось при старте из-за поврежденных скриптов, выполните аварийный сброс Lampa для очистки LocalStorage.

Красная точка в онлайн-кинотеатре: что делать с CORS и балансерами

Некоторые онлайн-плагины показывают у источников (Rezka, Filmix, Collaps и др.) цветной индикатор доступности; конкретная логика зависит от плагина. Красный цвет обычно означает, что источник не ответил.

Типичные причины: провайдер заблокировал адрес сервера, браузер ТВ отклонил запрос из-за политики CORS (нет заголовка Access-Control-Allow-Origin) или источник временно не работает.

Как вернуть источники к жизни:

• Откройте Настройки и найдите раздел нужного онлайн-плагина (названия пунктов зависят от плагина).
• Если плагин поддерживает прокси для источников, включите его: прокси добавляет нужные заголовки, и телевизор сможет получить поток.
• Если плагин позволяет указать зеркало источника, введите актуальный домен.
• Проверьте авторизацию: для Filmix PRO или HDRezka при ошибке 401 Unauthorized обновите токен или войдите заново.
• Если внешние прокси перегружены, поднимите локальный бэкенд Lampac в Docker, который проксирует потоки прямо в домашней сети.

Телевизор перезагружается при запуске Lampa: нехватка RAM и краш WebProcess

Если телевизор внезапно уходит в перезагрузку при открытии постеров или старте тяжелого видео, вероятная причина — нехватка оперативной памяти. С этим чаще сталкиваются владельцы бюджетных моделей LG webOS и Samsung Tizen с небольшим объемом ОЗУ.

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

Куда уходит память:

1. Кэш и данные приложения: при включенном «Кэше изображений» постеры и фоны сохраняются в локальное хранилище, а кэш запросов растет со временем.
2. Много плагинов: каждый плагин загружается в память при старте приложения.
3. TorrServer на самом ТВ: торрент-сервер с большим кэшем на телевизоре конкурирует с браузером за память.

Как прекратить вылеты и перезагрузки:

• Очистите кэш: в меню Настройки -> Кеш и данные выберите «Очистить кэш» -> «Только кеш» (основные настройки сохранятся). При необходимости отключите «Кэш изображений».
• Переключите плеер: в разделе Настройки -> Плеер в пункте «Тип плеера» выберите Tizen/WebOS вместо встроенного либо на Android TV — «Android» и внешний Vimu Media Player.
• Отключите неиспользуемые плагины: удалите лишние онлайн-источники и тяжелые дополнения.
• Разгрузите память: не завышайте кэш TorrServer или вынесите сервер на ПК/роутер по инструкции TorrServer на ПК, Mac и в Docker.