Работа с Remnawave

Установите панель согласно официальной документации:

После установки панели откройте Панели → Remnawave → Настройки и заполните блоки на этой странице:

• 1Включите переключатель «Включить Remnawave» (remnawave_enabled).
• 2В блоке «Подключение к панели»:
  remnawave_base_url URL панели, например https://panel.example.com

  remnawave_api_token API-токен из настроек панели Remnawave
• 3В блоке «Новые пользователи и миграция»:
  remnawave_default_internal_squad_uuid UUID Squad (группы серверов) из панели Remnawave

  remnawave_default_traffic_limit_gb Лимит трафика по умолчанию в ГБ. 0 = безлимит
• 4Отдельно: Настройки → Основные → Режим провайдера — выберите Remnawave (subscription_provider для новых пользователей).
• 5Нажмите Сохранить на странице Remnawave. Бот начнёт создавать новых пользователей в Remnawave.

• 1Установите и полностью настройте панель Remnawave — добавьте серверы, настройте Squad, укажите API-токен в веб-админке.
• 2Убедитесь, что параметр remnawave_default_traffic_limit_gb выставлен корректно — именно это значение будет присвоено каждому клиенту при миграции:
  Панели → Remnawave → Настройки

  remnawave_default_traffic_limit_gb = 0   # 0 = безлимит

  💡

  Значение используется при регистрации новых пользователей и при миграции. 0 означает безлимитный трафик.
• 3 Рекомендуется остановить сервис бота на время миграции, чтобы исключить конфликты при одновременной обработке запросов:
  bashКопировать

  systemctl stop vpn-bot

• 1Откройте веб-админку → Инструменты → Миграция.
• 2Выберите направление миграции: в Remnawave.
• 3Нажмите кнопку запуска — бот обработает всех пользователей из базы данных и создаст их в Remnawave с текущими сроками подписки.
• 4После завершения миграции запустите бота обратно:
  bashКопировать

  systemctl start vpn-bot

Это один из ключевых сценариев совместного режима. Когда пользователь расходует весь лимит трафика в Remnawave при активной подписке:

Экспортёр использует те же параметры, что уже прописаны в /opt/remnawave/.env (DATABASE_URL, WEBHOOK_URL, WEBHOOK_SECRET_HEADER). Дополнительно настраивать его конфиг не нужно — но сначала проверьте три пункта ниже.

• 1Nginx на сервере бота — location для вебхука Remnawave (см. следующий блок).
• 2Webhook в Remnawave — WEBHOOK_ENABLED, WEBHOOK_URL, WEBHOOK_SECRET_HEADER в /opt/remnawave/.env.
• 3Веб-админка бота — включено «Принимать вебхуки от Remnawave» и заполнен «Секрет вебхука» (тот же 64-символьный ключ).

Убедитесь, что в конфиге Nginx на сервере бота присутствует блок для вебхука Remnawave. Откройте конфиг:

nano /etc/nginx/conf.d/xuiweb.conf

Найдите или добавьте следующий блок внутри секции server { }, перед закрывающей скобкой:

location /remnawave/webhook {
    proxy_pass http://127.0.0.1:8081/remnawave/webhook;
    proxy_set_header Host $host;
    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 Content-Type $content_type;
    proxy_set_header Content-Length $content_length;
    proxy_read_timeout 30s;
    proxy_connect_timeout 30s;
    proxy_send_timeout 30s;
}

Сохраните файл (Ctrl+O → Enter → Ctrl+X) и перезагрузите Nginx:

nginx -t && systemctl reload nginx

На сервере с Remnawave откройте файл .env:

cd /opt/remnawave
nano .env

Найдите блок # Webhook configuration и выставьте следующие значения:

# Webhook configuration
WEBHOOK_ENABLED=true
WEBHOOK_URL=https://бот.ваш-домен.ru/remnawave/webhook
### Секрет для подписи вебхука — 64 символа (a-z, 0-9, A-Z)
WEBHOOK_SECRET_HEADER=<ваш_секрет_64_символа>

Откройте Панели → Remnawave → Настройки → блок «Вебхуки и NO LIMIT»:

• 1Включите переключатель «Принимать вебхуки от Remnawave» (remnawave_webhook_enabled).
• 2Заполните поле «Секрет вебхука» (remnawave_webhook_secret) — то же значение, что WEBHOOK_SECRET_HEADER в .env Remnawave. Сохраните страницу.

На сервере с Remnawave выполните одну команду от root. Скрипт создаст каталог /opt/remnawave_node_exporter, скачает архив, соберёт Docker-контейнер и запустит его в сети Remnawave. Настройки читаются автоматически из /opt/remnawave/.env.

curl -fsSL https://update.3xstore.ru/remnawave_node_exporter/install.sh | bash

Проверка логов после установки:

cd /opt/remnawave_node_exporter && docker compose logs -f

Убедитесь, что в конфиге Nginx на сервере бота присутствует блок для вебхука Remnawave. Откройте конфиг:

nano /etc/nginx/conf.d/xuiweb.conf

Найдите или добавьте следующий блок внутри секции server { }, перед закрывающей скобкой:

location /remnawave/webhook {
    proxy_pass http://127.0.0.1:8081/remnawave/webhook;
    proxy_set_header Host $host;
    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 Content-Type $content_type;
    proxy_set_header Content-Length $content_length;
    proxy_read_timeout 30s;
    proxy_connect_timeout 30s;
    proxy_send_timeout 30s;
}

Сохраните файл (Ctrl+O → Enter → Ctrl+X) и перезагрузите Nginx:

nginx -t && systemctl reload nginx

На сервере с Remnawave откройте файл .env:

cd /opt/remnawave
nano .env

Найдите блок # Webhook configuration и выставьте следующие значения:

# Webhook configuration
WEBHOOK_ENABLED=true
WEBHOOK_URL=https://бот.ваш-домен.ru/remnawave/webhook
### Секрет для подписи вебхука — 64 символа (a-z, 0-9, A-Z)
WEBHOOK_SECRET_HEADER=<ваш_секрет_64_символа>

• 1Откройте панель Remnawave и найдите ноды, которые хотите сделать безлимитными.
• 2В настройках каждой такой ноды установите коэффициент потребления = 0. Это критически важно — только ноды с коэффициентом 0 не тратят трафик пользователя.
  ⚠️

  Без коэффициента 0 трафик будет продолжать расходоваться даже в «безлимитном» скваде.
• 3Создайте новый внутренний сквад (Internal Squad) и добавьте в него все ноды с коэффициентом 0. При желании можно добавить хосты-заглушки и включить их в этот же сквад.
• 4Скопируйте UUID нового сквада — он понадобится на следующем шаге.

Откройте Панели → Remnawave → Настройки → блок «Вебхуки и NO LIMIT»:

• 1Включите «Принимать вебхуки от Remnawave» (remnawave_webhook_enabled), если вебхук настроен на панели.
• 2Заполните поля ниже и сохраните страницу.