eGames авторизация

Обзор

eGames — это reverse-proxy для защиты панели Remnawave. При установке через скрипт eGames панель закрывается cookie-авторизацией: все HTTP-запросы без корректной cookie отклоняются. Бот поддерживает работу с защищенной панелью — для этого нужно указать секретный ключ, который передается как cookie при каждом запросе к API.

Настройка бота

Шаг 1: Получение секретного ключа

При установке Remnawave через скрипт eGames в процессе настройки генерируется cookie-ключ. Его можно найти в конфигурации nginx reverse-proxy:

Откройте конфигурацию nginx на сервере с панелью:

# Расположение зависит от установки, обычно:
nano /etc/nginx/nginx.conf
# или
nano /etc/nginx/conf.d/remnawave.conf

Найдите секцию map $http_cookie $auth_cookie — в ней указаны имя и значение cookie
Запишите их в формате ИМЯ:ЗНАЧЕНИЕ

Шаг 2: Настройка .env бота

REMNAWAVE_API_URL=https://panel.example.com
REMNAWAVE_API_KEY=your_api_key_here
REMNAWAVE_SECRET_KEY=XXXXXXX:DDDDDDDD

Где:

REMNAWAVE_API_URL — публичный адрес панели
REMNAWAVE_API_KEY — API-ключ из панели Remnawave
REMNAWAVE_SECRET_KEY — cookie в формате имя:значение

REMNAWAVE_AUTH_TYPE менять не нужно. Значение по умолчанию api_key работает с eGames. Cookie передается автоматически при наличии REMNAWAVE_SECRET_KEY.

Шаг 3: Перезапуск бота

docker compose up -d --build

Проверка

Выполните синхронизацию серверов через админ-панель бота. Если серверы загрузились — авторизация работает. Если в логах ошибки 401 Unauthorized или 403 Forbidden:

Проверьте формат REMNAWAVE_SECRET_KEY (должен быть имя:значение через двоеточие)
Убедитесь что значение совпадает с тем, что в nginx-конфигурации панели
Проверьте что REMNAWAVE_API_KEY валидный

Формат секретного ключа

Формат	Пример	Результат
`имя:значение`	`mysecret:abc123def`	Cookie: `mysecret=abc123def`
`только_значение`	`secret_key_name`	Cookie: `secret_key_name=secret_key_name`

Рекомендуется формат имя:значение. Если в значении есть двоеточие — разделение происходит по первому двоеточию.

Открытие внешнего API

По умолчанию eGames reverse-proxy блокирует внешний доступ к API панели. Если бот находится на отдельном сервере (не в одной Docker-сети с панелью), нужно открыть доступ к API. Добавьте в конфигурацию nginx на сервере с панелью:

location ^~ /api/ {
    proxy_http_version 1.1;
    proxy_pass http://remnawave;
    proxy_set_header Host $host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_send_timeout 60s;
    proxy_read_timeout 60s;
}

После открытия внешнего API обязательно отключите документацию API на панели: установите IS_DOCS_ENABLED=false в .env файле Remnawave, чтобы Swagger-документация не была доступна из интернета.

Отключение eGames авторизации

Если вы хотите отключить cookie-защиту eGames и перейти на прямое подключение к панели:

Вариант 1: Бот в одной Docker-сети с панелью

Используйте внутренний адрес без cookie:

REMNAWAVE_API_URL=http://remnawave:3000
REMNAWAVE_API_KEY=your_api_key_here
REMNAWAVE_SECRET_KEY=

Бот обращается к панели напрямую через Docker-сеть, минуя reverse-proxy. Cookie не нужен.

Вариант 2: Бот на отдельном сервере

Замените eGames reverse-proxy на Caddy с caddy-security:

REMNAWAVE_API_URL=https://panel.example.com
REMNAWAVE_API_KEY=your_api_key_here
REMNAWAVE_AUTH_TYPE=caddy
REMNAWAVE_CADDY_TOKEN=base64_encoded_credentials
REMNAWAVE_SECRET_KEY=

Или используйте Basic Auth:

REMNAWAVE_API_URL=https://panel.example.com
REMNAWAVE_API_KEY=your_api_key_here
REMNAWAVE_AUTH_TYPE=basic
REMNAWAVE_USERNAME=admin
REMNAWAVE_PASSWORD=password
REMNAWAVE_SECRET_KEY=

Вариант 3: Убрать reverse-proxy полностью

Если панель доступна по прямому HTTPS (например, за Cloudflare):

REMNAWAVE_API_URL=https://panel.example.com
REMNAWAVE_API_KEY=your_api_key_here
REMNAWAVE_SECRET_KEY=

Без reverse-proxy панель Remnawave остается без дополнительного слоя защиты. Убедитесь что доступ ограничен другими средствами (Cloudflare Access, IP whitelist, VPN).

Все методы авторизации

Метод	`REMNAWAVE_AUTH_TYPE`	Дополнительные переменные	Когда использовать
API Key	`api_key` (по умолчанию)	—	Прямое подключение без reverse-proxy
eGames (cookie)	`api_key`	`REMNAWAVE_SECRET_KEY`	Панель за eGames reverse-proxy
Basic Auth	`basic`	`REMNAWAVE_USERNAME`, `REMNAWAVE_PASSWORD`	Панель с Basic Auth защитой
Caddy Security	`caddy`	`REMNAWAVE_CADDY_TOKEN`	Панель за Caddy с caddy-security

REMNAWAVE_SECRET_KEY работает независимо от REMNAWAVE_AUTH_TYPE — cookie отправляется при любом типе авторизации, если ключ заполнен.

Устранение проблем

401 Unauthorized

Проверьте REMNAWAVE_API_KEY — скопируйте заново из панели
Проверьте REMNAWAVE_SECRET_KEY — формат имя:значение

403 Forbidden

Reverse-proxy блокирует запрос. Убедитесь что cookie совпадает
Если бот на отдельном сервере — проверьте что nginx location /api/ настроен

Connection refused / timeout

Проверьте доступность REMNAWAVE_API_URL с сервера бота:
curl -v https://panel.example.com/api/health
Если бот в Docker — убедитесь что сети пересекаются

Серверы не синхронизируются

Проверьте логи бота: docker compose logs -f bot
Попробуйте ручную синхронизацию через админ-панель
Убедитесь что API панели отвечает на запросы

Источник: eGames Wiki — External API Configuration

​Обзор

​Настройка бота

​Шаг 1: Получение секретного ключа

​Шаг 2: Настройка .env бота

​Шаг 3: Перезапуск бота

​Проверка

​Формат секретного ключа

​Открытие внешнего API

​Отключение eGames авторизации

​Вариант 1: Бот в одной Docker-сети с панелью

​Вариант 2: Бот на отдельном сервере

​Вариант 3: Убрать reverse-proxy полностью

​Все методы авторизации

​Устранение проблем

​401 Unauthorized

​403 Forbidden

​Connection refused / timeout

​Серверы не синхронизируются

Обзор

Настройка бота

Шаг 1: Получение секретного ключа

Шаг 2: Настройка .env бота

Шаг 3: Перезапуск бота

Проверка

Формат секретного ключа

Открытие внешнего API

Отключение eGames авторизации

Вариант 1: Бот в одной Docker-сети с панелью

Вариант 2: Бот на отдельном сервере

Вариант 3: Убрать reverse-proxy полностью

Все методы авторизации

Устранение проблем

401 Unauthorized

403 Forbidden

Connection refused / timeout

Серверы не синхронизируются