Деплой Lampac в Docker: compose и конфигурация

Lampac NextGen распространяется как готовый Docker-образ ghcr.io/lampac-nextgen/lampac. С помощью docker-compose.yaml вы развернете сервер за несколько минут, сохранив конфигурацию, кеш и базы данных на хосте. Эта страница описывает полный путь от клонирования репозитория до запуска контейнера в production.

Клонируйте репозиторий

git clone https://github.com/lampac-nextgen/lampac.git
cd lampac

Создайте директории для данных

mkdir -p lampac-docker/config lampac-docker/plugins

Скопируйте пример конфигурации

cp config/example.init.conf lampac-docker/config/init.conf

Отредактируйте init.conf под свои нужды. Рабочая директория внутри контейнера — /lampac, поэтому файлы читаются из ее корня, а не из подкаталога config/.

Создайте файл пароля root

printf '%s' 'ваш_пароль_root' > lampac-docker/config/passwd

Пароль root требуется для служебных функций и доступа к WebLog.

Раскомментируйте тома в compose-файле

Откройте docker-compose.yaml и уберите символ # у блока volumes. По умолчанию все тома закомментированы, и контейнер стартует с init.conf и passwd из образа.

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

docker compose up -d

Сервер станет доступен на порту 9118.

Тома

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

Путь на хосте	Путь в контейнере	Назначение
`./lampac-docker/config/passwd`	`/lampac/passwd`	Пароль root (WebLog, служебные функции)
`./lampac-docker/config/init.conf`	`/lampac/init.conf`	Конфигурация сервера
`./lampac-docker/plugins/lampainit.js`	`/lampac/plugins/override/lampainit.js`	Переопределение клиентского плагина
`./lampac-docker/cache`	`/lampac/cache`	Файловый кеш
`./lampac-docker/database`	`/lampac/database`	Базы данных (Sync, TimeCode, SISI)
`./lampac-docker/mods/<Name>`	`/lampac/mods/<Name>`	Пользовательские модули

По умолчанию все тома в docker-compose.yaml закомментированы. Контейнер запустится, но изменения конфигурации и пароля не сохранятся после пересоздания контейнера. Раскомментируйте нужные строки перед первым запуском в production.

Сеть

По умолчанию compose-файл использует bridge-сеть с фиксированным IP-адресом контейнера 10.10.10.10. Если вам нужен host-режим (например, для DLNA или UPnP), раскомментируйте строку network_mode: host и убедитесь, что блоки ports и networks не конфликтуют друг с другом.

Минимальный пример сервиса

Если вы хотите собрать собственный docker-compose.yaml с нуля, достаточно следующего блока:

services:
  lampac:
    image: ghcr.io/lampac-nextgen/lampac
    ports:
      - "9118:9118"
    shm_size: 1024mb
    restart: unless-stopped
    volumes:
      - ./lampac-docker/config/passwd:/lampac/passwd
      - ./lampac-docker/config/init.conf:/lampac/init.conf
      - ./lampac-docker/plugins/lampainit.js:/lampac/plugins/override/lampainit.js

Укажите shm_size: 1024mb или больше, если планируете использовать Playwright (Chromium/Firefox). Браузеры активно используют shared memory, и стандартного 64 МБ может не хватить.

Управление модулями в Docker

Состав загружаемых модулей определяется двумя механизмами:

BaseModule.SkipModules в init.conf — список имен модулей, которые не загружаются даже при наличии кода в образе.
manifest.json в каталоге модуля — ключ "enable": true|false. Часть модулей, например AdminPanel и ExternalBind, поставляются с "enable": false.

Чтобы включить выключенный модуль без пересборки образа, скопируйте его каталог, отредактируйте manifest.json и смонтируйте в /lampac/module/<Name>/ (штатный путь) или /lampac/mods/<Name>/ (пользовательский). При следующем старте контейнера Roslyn скомпилирует модуль автоматически.

Начало работы

Конфигурация

Архитектура

Модули

Провайдеры

Развёртывание

Обслуживание

Деплой Lampac в Docker: compose и конфигурация

Тома

Сеть

Минимальный пример сервиса

Управление модулями в Docker

​Тома

​Сеть

​Минимальный пример сервиса

​Управление модулями в Docker

Тома

Сеть

Минимальный пример сервиса

Управление модулями в Docker