Справочник config.env

Панель настраивается переменными окружения. Значения читаются из файла config.env:

• Linux — /etc/gameap/config.env
• Windows — C:\gameap\web\config.env

Формат файла — по одной паре ИМЯ=значение на строку, без кавычек и без export. Строки, начинающиеся с #, игнорируются. После изменения файла панель нужно перезапустить:

gameapctl panel restart

Переменные, заданные в окружении процесса, имеют приоритет над файлом.

Обязательных переменных всего две: DATABASE_URL и AUTH_SECRET. Без них панель не запустится. Все остальные имеют значения по умолчанию, пригодные для типовой установки на одном сервере.

Обозначения в таблицах: длительность — число с суффиксом s, m или h (30s, 5m, 12h); список — значения через запятую; размер — число с двоичным суффиксом K, M, G, T (8M, 100G), голое число трактуется как байты.

HTTP

HTTP_ALLOWED_ORIGINS задаётся полными источниками со схемой: https://panel.example.com. Подстановка * не поддерживается.

База данных

Названия драйвера PostgreSQL взаимозаменяемы: postgres, postgresql, pgsql, pg, pgx.

Форматы строки подключения:

# PostgreSQL
DATABASE_DRIVER=postgres
DATABASE_URL=postgres://gameap:пароль@localhost:5432/gameap?sslmode=disable

# MySQL / MariaDB
DATABASE_DRIVER=mysql
DATABASE_URL=gameap:пароль@tcp(localhost:3306)/gameap?parseTime=true

# SQLite
DATABASE_DRIVER=sqlite
DATABASE_URL=file:/var/lib/gameap/db.sqlite?_busy_timeout=5000&_journal_mode=WAL&cache=shared

Драйвер inmemory хранит данные только в оперативной памяти и предназначен для тестов: при перезапуске всё теряется.

TLS и сертификаты

HTTPS включается, если задан хотя бы один источник сертификата: файлы, значения в переменных или ACME. Если не задан ни один, панель работает только по HTTP.

При TLS_FORCE_HTTPS=true все запросы по HTTP получают перенаправление 301, кроме /.well-known/acme-challenge/ — иначе выпуск сертификата Let’s Encrypt был бы невозможен.

ACME (Let’s Encrypt)

ACME включается только при одновременно заданных ACME_ENABLED=true, ACME_EMAIL и ACME_DOMAINS. Если чего-то не хватает, панель молча продолжит работу без ACME.

По умолчанию используется боевой каталог Let’s Encrypt с жёсткими ограничениями на число попыток. При отладке настройки указывайте staging: ACME_DIRECTORY_URL=https://acme-staging-v02.api.letsencrypt.org/directory.

Аутентификация

Подробности — на странице Безопасность.

AUTH_SECRET приводится к 32 байтам молча: короткое значение дополняется, длинное обрезается. Задавайте ровно 32 случайных байта, например openssl rand -hex 16.

Первый администратор

Эти три переменные читаются только при первоначальном заполнении пустой базы:

Пароль из ADMIN_PASSWORD не проходит проверку политики паролей: ни по длине, ни по списку скомпрометированных. Задавайте его осознанно.

Права доступа и кэш

CACHE_DRIVER принимает memory (синоним inmemory), redis, mysql (синоним database) и postgres (синонимы postgresql, pgsql, pg). Неизвестное значение приводит к аварийному завершению при старте.

Кэш хранит не только справочные данные: в нём живут ключ установки демона, список отозванных токенов и счётчики попыток входа. При CACHE_DRIVER=memory всё это теряется при перезапуске и не разделяется между несколькими экземплярами панели. Для установки из нескольких экземпляров используйте redis.

Файлы

Загрузка файлов

Предельный размер файла — произведение FILES_UPLOAD_CHUNK_SIZE на FILES_UPLOAD_MAX_CHUNKS. При значениях по умолчанию это около 780 ГБ. Отдельно действует ограничение в 100 МБ на обычную загрузку одним запросом, оно не настраивается.

Архивы

gRPC

Подробности — на странице GRPC API.

DAEMON_SETUP_KEY задаёт ключ, который не истекает. Это удобно для автоматического развёртывания, но такой ключ позволяет зарегистрировать в панели новый выделенный сервер кому угодно, кто его узнает. Для обычной установки не задавайте эту переменную — панель выпустит временный ключ на час.

Безопасность

Полное описание — на странице Безопасность.

Значение SECURITY_SENSITIVE_PATH_PREFIXES по умолчанию: /api/auth/,/api/profile/,/api/users/,/api/tokens/.

CAPTCHA

Журнал аудита

Плагины

Сетевые запросы плагинов

Адреса служб метаданных облачных провайдеров заблокированы всегда, PLUGIN_HTTP_ALLOWED_HOSTS на них не действует.

Отдельная группа настроек управляет собственными протоколами RCON и Query, реализуемыми плагинами:

Планировщик плагинов

Обмен событиями между экземплярами

Нужен только при работе нескольких экземпляров панели. При одном экземпляре достаточно значений по умолчанию. Неизвестное значение PUBSUB_DRIVER приводит к аварийному завершению при старте.

Прочее

Значение GAMES_CDN_URLS по умолчанию: https://cdn.gameap.ru/games.json,https://cdn.gameap.com/games.json.

Переменные, которые не действуют

Эти переменные разбираются панелью, но на её поведение не влияют. Не рассчитывайте на них:

Ограничения частоты входов тоже не настраиваются переменными окружения — они заданы константами в коде. Значения приведены на странице Безопасность.

Пример минимальной конфигурации

DATABASE_DRIVER=postgres
DATABASE_URL=postgres://gameap:пароль@localhost:5432/gameap?sslmode=disable

AUTH_SECRET=замените_на_32_случайных_байта
ENCRYPTION_KEY=замените_на_32_случайных_байта

HTTP_HOST=panel.example.com
HTTP_PORT=8025

Всё остальное будет взято из значений по умолчанию.