Установка Lampac NextGen: Docker, Linux, Windows

Lampac NextGen поддерживает несколько способов установки: от готового Docker-образа до ручной сборки из исходников. Выберите подходящий вариант в зависимости от вашей операционной системы и уровня опыта.

Docker Compose
Linux
Windows
Ручная сборка

Рекомендуемый способ для большинства пользователей. Образ поддерживает архитектуры linux/amd64 и linux/arm64.

Тома

Путь на хосте	Путь в контейнере	Назначение
`./lampac-docker/config/passwd`	`/lampac/passwd`	Пароль root
`./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>`	Пользовательские модули

Сетевые режимы

По умолчанию используется bridge-сеть с IP 10.10.10.10. Для host-режима раскомментируйте network_mode: host в compose-файле и уберите или скорректируйте блоки ports и networks.

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

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

Поддерживаются Debian/Ubuntu на amd64 и arm64. Скрипт автоматически устанавливает .NET 10 runtime, создает системного пользователя lampac и регистрирует systemd-сервис.

Флаги install.sh

Флаг	Описание
`--update`	Обновить до последней версии
`--tag v1.2.3`	Установить или обновить на конкретный тег
`--force`	Переустановить ту же версию без подтверждения
`--dry-run`	Показать изменения без применения
`--pre-release`	Использовать последний pre-release
`--remove`	Удалить systemd-сервис, пользователя и директорию
`--verbose`	Подробный лог для диагностики

Переменные окружения

Переменная	По умолчанию	Описание
`LAMPAC_INSTALL_ROOT`	`/opt/lampac`	Директория установки
`LAMPAC_USER`	`lampac`	Системный пользователь
`LAMPAC_UID`	`1000`	UID
`LAMPAC_GID`	`1000`	GID
`LAMPAC_PORT`	`9118`	Порт
`LAMPAC_GITHUB_REPO`	`lampac-nextgen/lampac`	Репозиторий релизов
`LAMPAC_DOTNET_ROOT`	`/usr/share/dotnet`	Путь .NET
`LAMPAC_DOTNET_CHANNEL`	`10.0`	Версия .NET runtime

Команды

# Установка
curl -fsSL https://raw.githubusercontent.com/lampac-nextgen/lampac/main/install.sh | sudo bash

# Обновление
curl -fsSL https://raw.githubusercontent.com/lampac-nextgen/lampac/main/install.sh | sudo bash -s -- --update

# Удаление
curl -fsSL https://raw.githubusercontent.com/lampac-nextgen/lampac/main/install.sh | sudo bash -s -- --remove

# Управление сервисом
systemctl status lampac
systemctl restart lampac
journalctl -u lampac -f

Установка на Windows требует .NET 10 Runtime и запуска через dotnet Core.dll или NSSM для фоновой работы.

Установите .NET 10 Runtime

Скачайте и установите ASP.NET Core Runtime с официального сайта.

Скачайте релиз

Перейдите на страницу релизов и скачайте архив lampac-nextgen.zip. Распакуйте, например, в C:\lampacNG.

Настройте конфигурацию

Переименуйте example.init.conf в init.conf и отредактируйте под свои нужды.

Запустите сервер

Откройте командную строку в распакованной папке и выполните:

dotnet Core.dll

Сервер запустится на порту 9118. Для остановки нажмите Ctrl+C.

Создайте сервис через NSSM (опционально)

Для фонового запуска скачайте NSSM и выполните от имени администратора:

"C:\nssm\win64\nssm.exe" install Lampac "C:\Program Files\dotnet\dotnet.exe" "C:\lampacNG\Core.dll"
"C:\nssm\win64\nssm.exe" set Lampac AppDirectory "C:\lampacNG"
"C:\nssm\win64\nssm.exe" set Lampac Start SERVICE_AUTO_START
"C:\nssm\win64\nssm.exe" start Lampac

Удаление сервиса NSSM

"C:\nssm\win64\nssm.exe" stop Lampac
"C:\nssm\win64\nssm.exe" remove Lampac

Требуется .NET SDK 10.0+. Подходит для разработчиков и тех, кто хочет собрать сервер с кастомными изменениями.

Сборка через build.sh

Флаг	Описание
`--clean`	Удалить `bin/` и `obj/` из всех проектов
`--format`	Форматирование кода (`dotnet format`)
`-o /path`	Кастомная директория вывода
`-c Debug`	Debug-конфигурация

./build.sh                          # сборка в publish/
RUNTIME_ID=linux-arm64 ./build.sh   # кросс-компиляция

Сборка напрямую через dotnet

dotnet publish Core/Core.csproj -c Release -o publish
dotnet build NextGen.slnx           # проверка компиляции всего solution
cd publish && dotnet Core.dll

Ручная сборка из исходников

Для сборки требуется .NET SDK 10.0+.

# Сборка в publish/ (рекомендуется)
./build.sh

# Кросс-компиляция для arm64
RUNTIME_ID=linux-arm64 ./build.sh

# Напрямую через dotnet
dotnet publish Core/Core.csproj -c Release -o publish

# Проверка компиляции всего solution
dotnet build NextGen.slnx

# Запуск
cd publish && dotnet Core.dll

Опции build.sh

Флаг	Описание
`--clean`	Удалить bin/ и obj/ из всех проектов
`--format`	Форматирование кода (`dotnet format`)
`-o /path`	Кастомная директория вывода
`-c Debug`	Debug-конфигурация

Dev-режим Docker (порт 29118)

В репозитории есть отдельный docker-compose.dev.yaml для разработки на порту 29118 с включёнными томами по умолчанию:

mkdir -p lampac-docker/config lampac-docker/plugins
cp config/example.init.conf lampac-docker/config/development.init.conf
# В development.init.conf установите: "listen"."port": 29118

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

docker compose -f docker-compose.dev.yaml up -d

docker-compose.dev.yaml и основной docker-compose.yaml используют одинаковый container_name: lampac. Одновременный запуск обоих без изменения имён контейнера невозможен.

По умолчанию сервер слушает порт 9118. Если порт занят, измените listen.port в init.conf до первого запуска.

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

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

Архитектура

Модули

Провайдеры

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

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

Установка Lampac NextGen: Docker, Linux, Windows

Тома

Сетевые режимы

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

Флаги install.sh

Переменные окружения

Команды

Удаление сервиса NSSM

Сборка через build.sh

Сборка напрямую через dotnet

Ручная сборка из исходников

Опции build.sh

Dev-режим Docker (порт 29118)

​Тома

​Сетевые режимы

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

​Флаги install.sh

​Переменные окружения

​Команды

​Удаление сервиса NSSM

​Сборка через build.sh

​Сборка напрямую через dotnet

​Ручная сборка из исходников

​Опции build.sh

​Dev-режим Docker (порт 29118)

Тома

Сетевые режимы

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

Флаги install.sh

Переменные окружения

Команды

Удаление сервиса NSSM

Сборка через build.sh

Сборка напрямую через dotnet

Ручная сборка из исходников

Опции build.sh

Dev-режим Docker (порт 29118)