Перейти к содержимому

Серверный бэкенд Lampac: запуск в Docker и настройка

Серверный бэкенд Lampac в Docker: архитектура Next Generation, развертывание docker-compose, настройка модулей TorrServer, JacRed, парсеров и прокси TMDB.

6 мин чтения
Серверный бэкенд Lampac: запуск в Docker и настройка

Lampac разворачивается одним Docker-контейнером ghcr.io/lampac-nextgen/lampac на порту 9118: он отдает веб-клиент Lampa из домашней сети, проксирует и кэширует TMDB и CUB, содержит парсер и встроенный TorrServer. Вместо отдельных контейнеров TorrServer, Jackett и TMDB-прокси телевизорам достаточно знать один адрес — http://IP_СЕРВЕРА:9118.

Серверный бэкенд Lampac (актуальная ветка — Lampac NextGen). Это модульный веб-сервис на C# (ASP.NET Core, .NET 10), который объединяет серверную инфраструктуру для Lampa в одном процессе.

Docker-образ избавляет от ручной установки рантайма и системных библиотек: в образ уже включены .NET и GStreamer.

Сравнение изолированных сервисов и Lampac

Консолидация модулей упрощает схему домашней сети: клиентам достаточно знать один адрес.

Эксплуатационный критерийРазрозненные службы (TorrServer + Jackett + прокси)Серверный бэкенд Lampac
Сетевые портыОтдельный порт на каждую службу (например, TorrServer — 8090, Jackett — 9117)Один порт 9118; TorrServer доступен по префиксу /ts/
Кэширование данных TMDBПрямые запросы с ТВ к серверам TMDBЛокальный кэш модуля TmdbProxy (cache/tmdb/)
Поиск раздачОтдельный Jackett с настройкой индексаторовВстроенный JacRed с Jackett-совместимым API
Загрузка интерфейса LampaС внешнего хоста или зеркалаИз локальной сети (модуль LampaWeb)

Для понимания принципов взаимодействия с видеопотоками изучите фундаментальное руководство по настройке связки Lampa и TorrServer Matrix, где детально разобран процесс буферизации тяжелых релизов 4K HDR.

Архитектура модулей Lampac Next Generation

Серверный бэкенд Lampac построен из модулей (каталог Modules в репозитории). Загрузку каждого модуля можно отключить через BaseModule.SkipModules в init.conf или ключ enable в manifest.json модуля.

Встроенный агрегатор JacRed

В состав Lampac входит модуль JacRed — агрегатор торрент-индексаторов с API, совместимым с Jackett (/api/v2.0/indexers/...). По документации проекта, он поддерживает популярные публичные и закрытые трекеры (список — в документации). Подключайте только те источники, к которым у вас есть законный доступ. Учтите, что стартовый шаблон example.init.conf добавляет JacRed в SkipModules — модуль нужно включить вручную.

Если в карточке фильма на экране вашего телевизора отсутствует кнопка вызова раздач, используйте наш алгоритм устранения ошибки, когда пропала кнопка Торренты в Lampa, для правильного сопряжения портов парсера.

Проксирование TMDB и онлайн-модули

Модуль TmdbProxy (плагин /tmdbproxy.js) проксирует запросы к api.themoviedb.org и image.tmdb.org и кэширует ответы и изображения в каталоге cache/tmdb/. При повторном открытии карточки данные отдаются из локального кэша.

Модули онлайн-источников (каталоги Modules/OnlineRUS, OnlinePaid и др.) собирают ссылки на видео и отдают их клиенту Lampa в виде плагина (/online.js). Документация проекта предупреждает: не открывайте прокси Lampac как универсальный выход в интернет — ограничивайте доступ (accsdb, WAF).

Развертывание Lampac через Docker Compose

Ниже — сокращенная версия официального сценария из README и документации проекта (docs.lampac.dev). Нужен Linux-хост с Docker и Docker Compose (amd64 или arm64).

Подготовка файловой структуры хоста

Выполните в терминале хост-системы следующие команды:

# Клонирование репозитория с docker-compose.yaml
git clone https://github.com/lampac-nextgen/lampac.git
cd lampac

# Каталоги для конфигурации, плагинов, кэша и баз данных
mkdir -p lampac-docker/config lampac-docker/plugins lampac-docker/cache lampac-docker/database
cp config/example.init.conf lampac-docker/config/init.conf
printf '%s' 'ваш_пароль_root' > lampac-docker/config/passwd

# Процесс в контейнере работает от пользователя lampac (UID 1000)
sudo chown -R 1000:1000 lampac-docker

Конфигурационный манифест docker-compose.yaml

В файле docker-compose.yaml из репозитория раскомментируйте блок volumes — иначе контейнер использует init.conf и passwd, встроенные в образ. Минимальный вариант сервиса выглядит так:

services:
  lampac:
    image: ghcr.io/lampac-nextgen/lampac
    container_name: lampac
    restart: unless-stopped
    ports:
      - "9118:9118"
    shm_size: 1024mb
    volumes:
      - ./lampac-docker/config/passwd:/lampac/passwd
      - ./lampac-docker/config/init.conf:/lampac/init.conf
      - ./lampac-docker/cache:/lampac/cache
      - ./lampac-docker/database:/lampac/database

По умолчанию официальный compose-файл использует bridge-сеть с адресом контейнера 10.10.10.10. Режим network_mode: host можно включить вместо блоков ports/networks — это полезно, например, для модуля DLNA, которому нужен мультикаст в локальной сети. Чтобы данные встроенного TorrServer переживали пересоздание контейнера, документация советует хранить каталог data/ts/ на постоянном томе.

Тонкая настройка конфигурации init.conf

Файл init.conf — это JSON (поддерживается и YAML-вариант init.yaml), изменения применяются без перезапуска. Стартовый шаблон отключает ряд модулей через SkipModules (в том числе JacRed, TorrServer, Sync, TimeCode, DLNA). Чтобы включить TorrServer и JacRed, уберите их из списка, например:

{
  "listen": {
    "ip": "0.0.0.0",
    "port": 9118
  },
  "BaseModule": {
    "SkipModules": ["Catalog", "DLNA", "Sync", "TimeCode", "Tracks", "Transcoding", "WebLog"]
  },
  "LampaWeb": {
    "initPlugins": {
      "torrserver": true,
      "jacred": true,
      "tmdbProxy": true
    }
  }
}

Встроенный TorrServer запускается как подпроцесс (по умолчанию на внутреннем порту 9085) и доступен снаружи через http://IP_СЕРВЕРА:9118/ts/.

Запустите контейнер командой:

docker compose up -d

Проверить, что сервер отвечает, можно командой curl -fsS "http://localhost:9118/version?type=hash".

Сервер поднимет веб-клиент Lampa по адресу http://IP_СЕРВЕРА:9118, а плагин онлайн-источников — по адресу http://IP_СЕРВЕРА:9118/online.js. Откройте адрес в браузере для первичной проверки. Если вы развертываете медиасервер на дисковом массиве, настройте сетевые хранилища NAS в Lampa для автоматического монтирования библиотеки. Для тех же, кто предпочитает вынести тяжелый трафик за пределы домашнего провайдера, подойдет TorrServer на удаленном VPS сервере в европейском дата-центре, либо установка сервера TorrServer на роутере Keenetic.

Скрытые аппаратные и сетевые сбои (Edge Cases)

При эксплуатации домашнего медиасервера стоит учитывать несколько ограничений.

Память и лимиты Docker

Потребление памяти зависит от включенных модулей и нагрузки (TorrServer держит кэш раздачи, транскодирование и Playwright тоже требуют ресурсов). Если на хосте работают и другие сервисы, контейнеру можно задать лимит памяти (mem_limit или deploy.resources.limits.memory); подбирайте значение по фактическому потреблению и учтите, что при достижении лимита процесс в контейнере будет завершен.

Сетевая маршрутизация между подсетями Wi-Fi

Если ваш сервер подключен к роутеру через кабель Ethernet RJ45 (подсеть 192.168.1.0/24), а Smart TV подключен к беспроводной гостевой сети Wi-Fi 5 ГГц (подсеть 192.168.2.0/24), встроенный межсетевой экран роутера заблокирует доступ к порту 9118. Гостевая сеть изолирована от основной намеренно: подключите телевизор к основной (не гостевой) сети Wi-Fi, а не снимайте изоляцию.

Если вы параллельно пользуетесь внешними адресами Lampa, смотрите статью об актуальных адресах и рабочих зеркалах Lampa.

Чек-лист проверки готовности медиасервера

Перед интеграцией клиентов проверьте основные индикаторы:

  • Контейнер Lampac запущен и в docker ps имеет статус Up (healthy); порт 9118 доступен.
  • Блок volumes в docker-compose.yaml раскомментирован, init.conf и passwd лежат на хосте.
  • На хосте выставлены права chown 1000:1000 для каталога lampac-docker.
  • Локальный адрес http://IP_СЕРВЕРА:9118 успешно открывает веб-клиент в браузере.
  • Если TorrServer включен, его веб-интерфейс открывается по адресу http://IP_СЕРВЕРА:9118/ts/.

Источники

  • lampac-nextgen/lampac: README, docker-compose.yaml, config/example.init.conf, каталог Modules, HEALTHCHECK в Dockerfile (последний коммит — 13.11.2026, проверено 14.11.2026).
  • Документация Lampac: установка в Docker, модули JacRed, TmdbProxy, CubProxy, DLNA и ограничение доступа (accsdb, WAF).
  • Docker — Compose file reference: shm_size, network_mode, mem_limit.

Часто задаваемые вопросы (FAQ)

Зачем использовать Lampac, если можно поставить чистый TorrServer?

Одиночный TorrServer отвечает только за торрент-поток. Lampac — комплексная платформа: он раздает веб-клиент Lampa из локальной сети (с автообновлением из GitHub), содержит агрегатор JacRed, кэширует данные TMDB и предоставляет плагины онлайн-источников, поэтому для загрузки интерфейса не нужны внешние зеркала. Доступ в интернет для каталога и видео при этом все равно нужен.

Каковы минимальные системные требования для запуска Lampac в Docker?

Официальная документация не называет минимальных требований. Docker-образ собирается для linux/amd64 и linux/arm64; потребление ресурсов сильно зависит от включенных модулей (TorrServer, транскодирование GStreamer/FFmpeg, Playwright с Chromium). Для домашнего использования обычно хватает мини-ПК или NAS, но ориентируйтесь на собственный мониторинг нагрузки.

Как обновлять контейнер Lampac без потери пользовательских настроек?

Если файл init.conf, кэш и каталог database смонтированы через Docker Volumes на хостовую файловую систему (в официальном docker-compose.yaml эти строки по умолчанию закомментированы, их нужно раскомментировать), обновление выполняется стандартными командами docker compose pull и docker compose up -d.

Как подключить телевизоры LG и Samsung к локальному Lampac?

В приложении Media Station X на Smart TV в качестве стартового параметра (Start Parameter) укажите адрес файла MSX, который отдает модуль LampaWeb: IP_СЕРВЕРА:9118/msx/start.json. Кроме того, Lampac отдает готовые виджеты для установки в режиме разработчика: /samsung.wgt для Tizen и /lg.ipk для webOS.

Бесплатный тест 24 часа (без карты) Скидка 15% СБП +20% бонус Оплата из ЕС и РФ
Шаровоз: 2 000+ каналов и 4K кинозалы

Официальный премиум-пакет от Шаровоз: 296 Кинозалов (BCU и 4K новинки), 116 каналов РФ, 92 Спортивных (Матч Премьер 50fps) и архив за 6 дней.

Оплата:⚡️СБП QR (РФ)+20%💳Карты РФ (МИР)🇪🇺Карты ЕС / Зарубеж💎USDT / Crypto🌐PayPal / FreeKassa
Единый тариф
3$/ месяц
~240 ₽ • 0 ₽ за 24ч теста
Тест 24ч без оплаты →
Интерактив
Мастер

Готовые плагины под вашу задачу

Ответьте на 3 вопроса о вашем ТВ, и мастер подберет проверенный набор скриптов.

  • Онлайн-видео (балансеры)Без P2P
  • 4K торренты (TorrServer)В стриме
  • Зеркала CUB и плагиныАктуально
Запустить конфигуратор

Теги

Опубликовано:
Обновлено:
Понравилось руководство? Поделитесь:
В Telegram
Илья Новиков
Автор материала
Илья Новиков
Инженер по ремонту медиаприставок, ноутбуков, телефонов и ПК

Ремонтирует и настраивает медиаприставки, ноутбуки, телефоны и компьютеры в Уссурийске. Ведёт lampa.help: редактирует материалы и сверяет команды, адреса и настройки с исходным кодом Lampa, TorrServer и Lampac и с документацией производителей.