Серверный бэкенд Lampac: запуск в Docker и настройка
Серверный бэкенд Lampac в Docker: архитектура Next Generation, развертывание docker-compose, настройка модулей TorrServer, JacRed, парсеров и прокси TMDB.
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.
Официальный премиум-пакет от Шаровоз: 296 Кинозалов (BCU и 4K новинки), 116 каналов РФ, 92 Спортивных (Матч Премьер 50fps) и архив за 6 дней.
Готовые плагины под вашу задачу
Ответьте на 3 вопроса о вашем ТВ, и мастер подберет проверенный набор скриптов.
- Онлайн-видео (балансеры)Без P2P
- 4K торренты (TorrServer)В стриме
- Зеркала CUB и плагиныАктуально
Ремонтирует и настраивает медиаприставки, ноутбуки, телефоны и компьютеры в Уссурийске. Ведёт lampa.help: редактирует материалы и сверяет команды, адреса и настройки с исходным кодом Lampa, TorrServer и Lampac и с документацией производителей.