Данная инструкция описывает процесс развертывания сервера Lampac NextGen в среде TrueNAS с использованием Docker Compose, а также настройку дополнительных модулей для расширения функциональности: панели администратора, поиска торрентов и уведомлений о новых сериях.

Важное замечание: В ходе настройки выяснилось, что сеть сервера TrueNAS может блокировать доступ к внешним сервисам (TMDB, Telegram). Некоторые модули (SeriesNotify) не будут работать без прокси или VPN. Инструкция отражает как успешные шаги, так и выявленные ограничения.

Установленный TrueNAS с поддержкой Docker (Apps).

Базовые навыки работы с терминалом (SSH или веб-консоль TrueNAS).

Свободный порт 9118 (или другой по вашему выбору).

Создайте директорию для конфигурационных файлов на хосте (например, в пуле хранения):

mkdir -p /mnt/storage/web/lampa/conf
cd /mnt/storage/web/lampa/conf

Создайте файл пароля root (требуется для доступа к служебным страницам, включая WebLog и AdminPanel):

printf '%s' 'ваш_пароль' > /mnt/storage/web/lampa/conf/passwd

Создайте базовый файл конфигурации init.conf. В минимальном варианте достаточно указать порт и разрешить загрузку всех модулей:

{
"listen": {
"ip": "any",
"port": 9118,
"scheme": "http"
},
"BaseModule": {
"SkipModules": [],
"LoadModules": [".*"]
},
"cache": {
"extend": 180
}
}

Создайте файл docker-compose.yml в удобной директории. Ниже приведен итоговый вариант с учетом всех настроенных модулей:

services:
lampac:
container_name: lampac
image: ghcr.io/lampac-nextgen/lampac:latest
ports:

'9118:9118'
restart: unless-stopped
shm_size: 1024mb
volumes:

/mnt/storage/web/lampa/conf/init.conf:/lampac/init.conf
 
/mnt/storage/web/lampa/conf/passwd:/lampac/passwd
 
/mnt/storage/web/lampa/conf/AdminPanel.manifest.json:/lampac/module/AdminPanel/manifest.json
 
/mnt/storage/web/lampa/conf/JacRed.manifest.json:/lampac/module/JacRed/manifest.json
 
/mnt/storage/web/lampa/conf/SeriesNotify.manifest.json:/lampac/module/SeriesNotify/manifest.json
version: '3'

Примечание: Монтирование файлов manifest.json необходимо для принудительного включения модулей, которые по умолчанию отключены в образе.

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

docker compose up -d

После запуска сервер будет доступен по адресу http://IP_ВАШЕГО_TNAS:9118.

Модули в Lampac включаются путем изменения параметра «enable» в их файлах manifest.json с false на true. Для этого файлы копируются из контейнера на хост, редактируются и монтируются обратно (как показано в docker-compose.yml).

3.1. AdminPanel (Панель администратора)

Модуль AdminPanel по умолчанию отключен . Для включения:

docker cp lampac:/lampac/module/AdminPanel/manifest.json /mnt/storage/web/lampa/conf/AdminPanel.manifest.json
sed -i 's/"enable": false/"enable": true/' /mnt/storage/web/lampa/conf/AdminPanel.manifest.json

После перезапуска контейнера панель будет доступна по адресу http://IP_ВАШЕГО_TNAS:9118/adminpanel. Пароль — тот, что вы указали в файле passwd.

3.2. JacRed (Поиск торрентов)

Модуль JacRed обеспечивает интеграцию с торрент-трекерами (Rutor, Kinozal, NNM-Club и др.) . В некоторых версиях образа он уже включен, но для надежности можно проверить и при необходимости принудительно включить:

docker cp lampac:/lampac/module/JacRed/manifest.json /mnt/storage/web/lampa/conf/JacRed.manifest.json
sed -i 's/"enable": false/"enable": true/' /mnt/storage/web/lampa/conf/JacRed.manifest.json

Убедитесь, что в логах появилось сообщение loaded module: JacRed. В клиенте Lampa для поиска торрентов необходимо указать адрес вашего сервера (порт 9118) и выбрать тип парсера Jackett, оставив поле API-ключа пустым.

3.3. SeriesNotify (Уведомления о сериях)

Модуль SeriesNotify предназначен для отправки уведомлений в Telegram о выходе новых серий . Для его работы требуется токен бота от @BotFather и ключ TMDB API.

Включение модуля:

docker cp lampac:/lampac/module/SeriesNotify/manifest.json /mnt/storage/web/lampa/conf/SeriesNotify.manifest.json
sed -i 's/"enable": false/"enable": true/' /mnt/storage/web/lampa/conf/SeriesNotify.manifest.json

Добавьте секцию в init.conf:

"SeriesNotify": {
"enable": true,
"bot_token": "ВАШ_ТОКЕН_ИЗ_BOTFATHER",
"tmdb_api_key": "ВАШ_КЛЮЧ_TMDB",
"lampac_host": "http://127.0.0.1:9118",
"check_interval_minutes": 60
}

⚠️ Ограничение: Если сервер TrueNAS не имеет доступа к api.telegram.org, модуль будет выдавать ошибку Request timed out и уведомления работать не будут. В этом случае рекомендуется отключить модуль («enable»: false), чтобы избежать засорения логов.

4.1. Подключение к серверу

В клиенте Lampa (на ТВ, приставке или ПК) укажите адрес вашего сервера Lampac:

Ссылка (Link): IP_ВАШЕГО_TNAS:9118 (без http:). Тип парсера: Jackett. Api-ключ: Оставить пустым. 4.2. Установка плагинов Для расширения функциональности в Lampa можно установить дополнительные плагины через раздел Настройки → Расширения: Плагин статусов сериалов: https://igorek1986.github.io/lampa-plugins/status.js. Добавляет метки «В эфире», «Завершен» на карточки сериалов. Работает только при наличии доступа к TMDB (напрямую или через прокси). ===== Диагностика проблем ===== Проблема: Страница /adminpanel не открывается (404). Решение: Убедитесь, что модуль AdminPanel включен в manifest.json и перезапустите контейнер. Проверьте логи: docker logs lampac | grep -i admin. Проблема: Поиск торрентов не работает в глобальном поиске. Решение: В настройках Lampa включите опцию «Парсер в поиске» (или parse_in_search). Убедитесь, что адрес сервера указан верно (порт 9118, не 9117). Проблема: Не загружаются постеры, метки статусов, не работают уведомления. Решение: Проверьте доступ сервера к api.themoviedb.org командой curl -v https://api.themoviedb.org. Если соединение блокируется (код 000 или таймаут), потребуется настроить прокси/VPN для контейнера Lampac или для клиента Lampa. Проблема: SeriesNotify выдает Request timed out. Решение: Сервер не имеет доступа к Telegram. В текущих условиях модуль неработоспособен. Отключите его в init.conf («enable»: false). ===== Заключение ===== Развертывание Lampac на TrueNAS позволяет получить мощный медиасервер с поиском торрентов и интеграцией с клиентом Lampa. Однако сетевая среда (блокировки провайдера) может ограничивать функциональность, связанную с внешними API (TMDB, Telegram). В таких случаях рекомендуется использовать прокси или VPN, либо отключать неработающие модули для поддержания стабильности системы.