Настройка
Настройка lomiri в админ-панели и что остаётся в .env.
Почти всё настраивается в самой панели, в разделе Админ → Настройки: клиентские функции, резервные копии, единый вход и название установки. Изменения применяются сразу после сохранения — без перезапуска и передеплоя.
В файле .env хранится только то, что нужно стеку для запуска (адрес, секреты и версия образа),
плюс необязательные значения по умолчанию для настроек ниже. Значение, сохранённое в админ-панели,
всегда важнее переменной окружения.
Настройки в админ-панели
Общие
Название установки, которое показывается в заголовке страницы и в верхней панели. Адрес панели,
окружение и версия показаны для справки; они берутся из .env и образа.
Функции
Что игроки могут делать сами:
- Базы данных: пользователи создают базы данных для своих серверов на ваших хостах баз данных.
- Автоаллокации: пользователи добавляют порты к своим серверам из заданного диапазона.
- Создавать новые аллокации: если в диапазоне нет свободного порта, создаётся новый.
Резервные копии
Куда сохраняются резервные копии серверов: на саму ноду (Wings) или в любое S3-совместимое хранилище — AWS S3, Cloudflare R2 или MinIO. Для AWS оставьте endpoint пустым. Сохранённые ключи скрыты; оставьте поле ключа пустым, чтобы сохранить текущее значение.
Вход через OAuth
Единый вход через одного провайдера OAuth2 / OpenID Connect. Отображаемое имя показывается на кнопке входа («Войти через Authentik»). Зарегистрируйте у провайдера такой redirect URI:
<APP_URL>/auth/oauth/callback/<driver>
Ограничение запросов, самообслуживание, саморегистрация и панель объявлений настраиваются в разделе Админ → Модули. См. Модули.
Файл .env
Читается compose-файлом из раздела Установка.
| Переменная | По умолчанию | Назначение |
|---|---|---|
APP_URL | — | Публичный адрес панели для OAuth-редиректов и ссылок. По нему Wings обращается к панели, и для этого домена Caddy получает сертификат. |
POSTGRES_PASSWORD | — | Пароль базы данных. Обязателен. |
OAUTH_STATE_SECRET | — | Подписывает токен состояния входа. Обязателен, даже без SSO. |
APP_NAME | пусто | Название установки по умолчанию. Меняется в Админ → Настройки. |
LOMIRI_TAG | latest | Версия образа: latest, релиз (1.2.3, 1.2) или sha-<short>. |
LOG_LEVEL | info | trace, debug, info, warn или error. |
TRUSTED_PROXIES | частные диапазоны | См. Сеть. |
Значения по умолчанию из окружения
Начальные значения настроек админ-панели можно задать и через окружение — удобно для
автоматических установок. Добавьте их в environment сервиса api в docker-compose.yml и
выполните docker compose up -d:
api:
environment:
BACKUP_ADAPTER: s3
S3_BUCKET: my-backups| Настройка | Переменные |
|---|---|
| Функции | DATABASES_ENABLED, ALLOCATIONS_ENABLED, ALLOCATIONS_CREATE_NEW, ALLOCATIONS_RANGE_START, ALLOCATIONS_RANGE_END |
| Резервные копии | BACKUP_ADAPTER (wings или s3), S3_BUCKET, S3_REGION, S3_ENDPOINT, S3_KEY, S3_SECRET |
| Вход через OAuth | OAUTH_DISPLAY_NAME, OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET, OAUTH_AUTHORIZE_URL, OAUTH_TOKEN_URL, OAUTH_USERINFO_URL, OAUTH_SCOPES |
Два параметра задаются только через окружение:
| Переменная | По умолчанию | Назначение |
|---|---|---|
USE_BINARY_PREFIX | выкл. | Двоичные префиксы (МиБ/ГиБ) для расчёта памяти и диска, как panel.use_binary_prefix в Pelican. |
LOG_JSON | выкл. | Структурированные JSON-логи для сбора логов. |
Сеть
TRUSTED_PROXIES перечисляет узлы, чьему заголовку X-Forwarded-For можно верить при определении
адреса посетителя:
- IP-адреса или CIDR через запятую, например
203.0.113.10,10.0.0.0/8. *— доверять всем.none— не доверять никому.- Пусто (по умолчанию) — доверять loopback и частным диапазонам: этого достаточно для встроенного Caddy и любого прокси в той же сети Docker.
От адреса посетителя зависит ограничение запросов.
Используйте *, только если контейнеры недоступны иначе как через ваш прокси, — иначе посетители
смогут подделать свой адрес.