Skip to content

About

Console installer and manager for Remnawave

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RemnaManager

Консольный менеджер Remnawave: панель, ноды, страница подписки, сертификаты, клиентские балансировщики, мосты и WARP-Native.

Требования

  • Debian 12/13 или Ubuntu 22.04/24.04, root, systemd, Bash 4.4+.
  • Для панели: от 2 vCPU и 2 ГБ RAM, место для PostgreSQL и резервных копий.
  • Отдельные VPS для нод; рабочий SSH-доступ от root.
  • Отдельные домены панели, подписки и сайта-заглушки ноды. DNS-записи без CDN-проксирования.
  • Входящие TCP 80/443 и SSH. TCP 2222 ноды доступен только с IP панели.
  • Для WARP-Native: поддержка WireGuard в ядре, nftables и исходящий UDP к Cloudflare.
  • Исходящий HTTPS для загрузки образов, обновлений, ACME и API.

Зависимости устанавливаются автоматически: curl, jq, OpenSSL, OpenSSH, Docker Engine/Compose, Nginx, Certbot и сетевые утилиты.

Установка

bash <(curl -fsSL https://raw.githubusercontent.com/OverlayNode/RemnaManager/refs/heads/main/install.sh)

Устанавливается последняя стабильная версия из Releases. Затем открывается меню. Установка панели и компонентов выбирается отдельно.

Повторный запуск:

sudo remna_manager
# или
sudo re

Под root доступны remna_manager и re из любого каталога, в том числе re --debug. Команда Linux rm не используется для запуска менеджера.

Если в текущей Bash-сессии осталось старое сокращение rm, удалите его подключением обновлённых настроек или войдите по SSH заново:

. /etc/profile.d/remnamanager.sh

Главное меню

Шапка обновляется каждые две секунды: число доступных ядер, загрузка ЦП, load average, размер и свободное место диска, состояние интерфейса и маршрутов, IPv4/IPv6, версия и доступные обновления. Частично введённый пункт сохраняется при обновлении. Адреса берутся с сетевых интерфейсов; за NAT они могут отличаться от внешнего IP. Отсутствующий IPv6 отмечается явно.

Пункт Возможности
Панель и компоненты Установка, запуск, остановка, обновление, копия БД, доступ к панели, Remnawave CLI
Ноды и расширения SSH-подключения, установка и переустановка, обновление, запуск/остановка, диагностика, Xray, selfsteal
Страница подписки Домен и email сертификата, HTTPS, запуск, обновление, остановка, совместимый Docker-образ
WARP-Native Нативный WireGuard-интерфейс, установка/удаление, выбранные домены в профиле ноды
Мониторинг Xray Checker, статус/логи, обновление, Telegram-уведомления об изменении доступности нод
Плагины BBR + fq, диагностика нод
Версии и обновления Проверка Releases, выбор версии, обновление и возврат к сохранённому коду
Балансировщики и мосты Одна запись для группы нод в Xray JSON; РФ напрямую, остальное через европейскую ноду

Панель и подписка

  1. Выберите Панель и компоненты → Установить панель. Введите домены, email ACME, публичный IP панели и логин администратора.
  2. Сохраните выданные логин, пароль и секретный адрес входа.
  3. На предложение установить подписку ответьте ДА или да: используются уже введённые домен и email. Создаются HTTPS-конфигурация Nginx и сертификат, затем запускается контейнер подписки.
  4. Отдельная установка через Страница подписки → Установка / запуск запрашивает домен и email. Адрес страницы: https://домен-подписки/<shortUuid>.

Панель и подписка используют разные домены. Для HTTP-01 каждый A/AAAA должен вести на соответствующий сервер с доступным TCP 80. При неработающем IPv6 удалите ошибочную AAAA-запись. Сертификаты продлевает Certbot через systemd timer.

Если установка прервалась, повторите соответствующий пункт с сохранёнными значениями. Контейнеры и тома удалять не требуется.

Ноды

В Ноды и расширения доступны добавление, переименование, переустановка с прежними ключами и доменом, обновление, перезапуск, статус и смена SSH-подключения. Перед первым SSH-подключением подтвердите SHA256-отпечаток сервера, сверив его через консоль хостинга.

Для новой ноды создаются профиль VLESS RAW + Reality + Vision, хост и internal squad. Назначьте squad пользователям панели. Незавершённые установки доступны отдельным пунктом. «Перезапустить» перезапускает контейнер, а не VPS.

Сайт selfsteal: три встроенных шаблона или самодостаточный HTML до 2 МБ. Xray обновляется с проверкой SHA256 и возвратом прежнего override при ошибке запуска.

Клиентские балансировщики

Балансировщики и мосты → Клиентский балансировщик объединяет несколько хостов, например серверы Германии, в одну запись Xray JSON. Клиент проверяет доступность и выбирает узел с меньшей задержкой. При недоступности всего пула прямой выход не используется.

  • Каждый участник сохраняет свои транспорт, Reality-ключи и inbound.
  • Squads участников получают доступ ко всем участникам пула.
  • В Xray JSON исходные записи заменяются общей; в обычных VLESS/Mihomo-подписках остаются отдельные хосты.
  • Нужен клиент с поддержкой Xray JSON. После создания обновите подписку в приложении.
  • Удаление возвращает связанные параметры. Незавершённую настройку можно отменить в списке балансировщиков и мостов.

Мост РФ → Европа

Выберите входную ноду РФ и отдельную выходную ноду Европы. Обе должны иметь отдельные профили, созданные RemnaManager.

Российские домены geosite:category-ru и IP geoip:ru идут напрямую с входной ноды. Остальной трафик идёт по VLESS Reality через европейскую ноду. Закрытые сети блокируются. Для связи создаётся отдельный служебный пользователь; при удалении моста он удаляется. Перед применением конфигурация проверяется Xray на входной ноде.

Существующие отдельные правила маршрутизации сохраняются. Маршрут моста применяется к клиентскому inbound выбранной входной ноды.

WARP-Native

На выбранной ноде поднимается интерфейс warp через WireGuard и wgcf. Официальный клиент Cloudflare, warp-cli и SOCKS-прокси не требуются.

Через WARP идут только заданные домены. Исходящий блок Xray привязан к интерфейсу warp и метке 51888; nftables блокирует отмеченный трафик, если интерфейс недоступен. Основной маршрут сервера, SSH и системный DNS не перенаправляются.

Перед регистрацией запрашивается согласие с условиями Cloudflare. Аккаунт сохраняется для повторной установки. Чужая конфигурация интерфейса warp не перезаписывается.

Обычный режим и debug

Обычный режим показывает этапы и результат: обновление пакетов, Docker, образы, контейнеры, домены, сертификаты. Вывод исполняемых команд сохраняется в закрытые журналы /opt/remnamanager/logs/.

Для вывода команд и их результатов в консоль:

sudo remna_manager --debug

Для установки с подробным выводом:

bash <(curl -fsSL https://raw.githubusercontent.com/OverlayNode/RemnaManager/refs/heads/main/install.sh) --debug

Диагностические пункты меню показывают запрошенные статус и логи. NO_COLOR=1 remna_manager отключает цвета.

Версии и резервные копии

Менеджер проверяет стабильные Releases и показывает обновление в шапке. Кэш проверки — 15 минут; недоступность GitHub не мешает работе меню. В пункте Версии и обновления доступны обновление, выбор выпуска и откат. Текущая версия:

remna_manager --version

Перед заменой код сохраняется в /opt/remnamanager/versions/. Проверяются SHA256, состав файлов и запуск --check. Откат меняет код менеджера, сохраняя настройки, SSH-ключи, контейнеры и БД.

Обновление панели делает pg_dump -Fc, сохраняет Compose, .env и состояние в /opt/remnamanager/backups/. Версии PostgreSQL и Valkey автоматически не повышаются. Откат кода панели после миграции не заменяет восстановление БД.

Состояние и секреты находятся в /opt/remnamanager/state.json, SSH-ключи — в /opt/remnamanager/ssh. Каталог имеет права 0700, секретные файлы — 0600. Храните резервные копии в защищённом месте.

Защита

Контейнерные порты панели, БД, подписки и Checker привязаны к loopback. Внешний HTTPS обслуживает Nginx. Домен панели без cookie доступа показывает статический сайт. Секретная ссылка выдаёт cookie Secure, HttpOnly, SameSite=Strict и открывает обычную авторизацию Remnawave. Это дополнительное ограничение доступа, а не гарантия невидимости.

Панель использует собственный API-токен менеджера; подписка получает отдельный токен чтения. Используйте доверенные Docker-образы и защищайте root-доступ.

Компоненты

Remnawave · Xray · Subscription Page · wgcf · Xray Checker

Лицензии сторонних компонентов: LICENSES.

About

Console installer and manager for Remnawave

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages