Работа с Remnawave

Панель можно поставить на внешнем сервере или на том же сервере, что и бот (под ботом). Сама панель в обоих случаях ставится по официальной документации:

После панели настройте reverse proxy по официальной инструкции (Caddy, Nginx, Traefik и др.):

На сервере с ботом (nginx уже есть) после установки панели запустите скрипт: SSL Let's Encrypt и прокси на Remnawave. Тот же скрипт можно использовать и на внешнем сервере вместо ручной настройки из docs.rw.

curl -fsSL https://update.3xstore.ru/remnawave/install_nginx.sh | bash -s -- вашдомен.ru admin@gmail.com

Образец конфига — /root/bot/service/remnawave.conf, на сервере панели: /etc/nginx/conf.d/remnawave.conf (прокси на 127.0.0.1:3000). Все шаблоны: Полезное → сервисные шаблоны.

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

• 1Включите переключатель «Включить Remnawave» (remnawave_enabled).
• 2В блоке «Подключение к панели»:
  remnawave_base_url URL панели, например https://panel.example.com.
  Если Remnawave стоит на том же сервере, что и бот — укажите http://127.0.0.1:3000 (loopback, без публичного домена). Перенос панели с отдельного VPS: Скрипт бекапа → перенос под бота.

  remnawave_api_token API-токен из настроек панели Remnawave — с полными правами.
• 3В блоке «Новые пользователи и миграция»:
  remnawave_default_internal_squad_uuid UUID сквада при платном продлении. Также запасной вариант для триала

  remnawave_trial_internal_squad_uuid UUID сквада при выдаче триала. Пустое = как при продлении. Необязательно — заполнять не нужно, если триал и оплата идут в один сквад.

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

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

  remnawave_default_traffic_limit_gb = 0   # 0 = безлимит; для NO LIMIT+ укажите лимит

  💡

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

  systemctl stop vpn-bot

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

  systemctl start vpn-bot

Экспортёр использует те же параметры, что уже прописаны в /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
# WEBHOOK_SECRET_HEADER уже сгенерирован при установке — не меняйте, просто скопируйте
WEBHOOK_SECRET_HEADER=<ваш_секрет_64_символа>

Не забудьте пересоздать контейнеры с новым .env:

cd /opt/remnawave
docker compose up -d
docker compose logs -f -t

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

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

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

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

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

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

Remnawave при дублировании remark автоматически добавляет суффиксы 1, 2, 3 к имени хоста. Если у вас три ноды с одним «логическим» сервером, без балансировки клиент увидит три одинаковых кнопки в приложении. С включённой балансировкой — одну кнопку, а фактическое подключение распределяется между нодами.

• ✓Меньше шума в списке серверов у пользователя
• ✓Равномерная нагрузка между дубликатами при режиме random
• ✓Исключение offline и перегруженных нод при режиме online

1. Пользователь обновляет подписку в клиенте → запрос идёт на SUBPAGE (/sub/{uuid}).
2. xuiweb получает от Remnawave список текстовых ключей (plain links).
3. Если в админке включена «Балансировка текстовых ключей», ключи группируются по «базовому» имени (см. правила ниже).
4. Из каждой группы выбирается один ключ — по режиму random или online.
5. Имя в фрагменте ключа (#… или ps у vmess) перезаписывается на каноническое — без цифры 1/2/3 в конце.

Поддерживаемые теги платформы: [PC], [MOBILE], [ROUTER], [TV] (регистр не важен). Теги не смешиваются между собой и с «общими» хостами без тега.

Откройте Remnawave → Настройки → Подключение → блок «Доп возможности», переключатель «Балансировка текстовых ключей (один ключ на имя)»:

Чтобы xuiweb мог отсеивать offline и перегруженные серверы, у каждого хоста в пуле балансировки должна быть указана нода:

• 1Remnawave → Хосты (Hosts)
• 2Откройте нужный хост → Редактировать
• 3В блоке Хост ноды (Host nodes) выберите ноду, на которой реально крутится этот inbound
• 4Сохраните. Повторите для всех хостов в группе (… 1, … 2, … 3)

xuiweb сопоставляет ключ с хостом по адресу и порту из подписки, затем читает usersOnline и статус (isConnected) привязанной ноды через API Remnawave.

Без балансировки — три ключа в подписке:

🇪🇺 Евро WIFI 1
🇪🇺 Евро WIFI 2
🇪🇺 Евро WIFI 3

С балансировкой — одна строка, при следующем обновлении может выпасть другая нода из того же пула:

🇪🇺 Евро WIFI

Работает ли с JSON-подпиской (Happ / INCY)?
Нет. Только для plain-текстовой выдачи. Для JSON используйте умную балансировку Xray.

Нужно ли что-то менять в Remnawave кроме имён хостов?
Для режима random — достаточно имён с суффиксами 1/2/3 и переключателя в админке. Для режима online дополнительно привяжите ноду в каждом хосте: Хосты → Редактировать → Хост ноды.

Можно ли балансировать только по нагрузке, без случайности?
Нет — внутри «здорового» пула выбор всё равно случайный. Режим online лишь отсекает offline и перегруженные ноды.

Что если все ноды в пуле offline или перегружены (режим online)?
Ключ из этой группы в подписку не попадёт — пользователь не увидит эту строку до появления «здоровой» ноды.

Убедитесь, что в конфиге 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
# WEBHOOK_SECRET_HEADER уже сгенерирован при установке — не меняйте, просто скопируйте
WEBHOOK_SECRET_HEADER=<ваш_секрет_64_символа>

Не забудьте пересоздать контейнеры с новым .env:

cd /opt/remnawave
docker compose up -d
docker compose logs -f -t

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

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

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

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