Перейти к содержимому

Статья 69 из 141

Гайды

Remnawave: установка панели и ноды на VPS через Docker Compose

Remnawave — панель управления прокси-серверами на Xray-core. Она подходит, когда серверов несколько и пользователей много: все ноды, пользователи и подписки собраны в одном интерфейсе. Для одного сервера на несколько человек проще 3x-ui. Сравнение панелей: 3x-ui, Marzban, Remnawave.

Компонент Что делает Где работает
Панель (remnawave/backend) веб-интерфейс, API, база PostgreSQL и Valkey отдельный VPS, за reverse proxy
Нода (remnawave/node) запускает Xray и принимает подключения клиентов на каждом сервере с VPN
Страница подписки (remnawave/subscription-page) красивая страница подписки на отдельном домене рядом с панелью, по желанию

Панель сама трафик клиентов не обрабатывает. Она отправляет конфигурацию на ноды и собирает статистику. Документация не рекомендует ставить ноду на сервер с панелью.

Что Панель Нода
ОС Ubuntu или Debian Ubuntu или Debian
RAM от 2 ГБ, лучше 4 ГБ от 1 ГБ
vCPU от 2, лучше 4 от 1
Диск 20 ГБ по месту под логи

Ещё понадобятся:

  • домен или поддомен для панели, например panel.example.com, с A-записью на IP сервера (DNS);
  • Docker с плагином Compose.

Панель работает только через reverse proxy и только в корне домена или поддомена. Путь вида example.com/panel не поддерживается, проброс порта через SSH тоже.

Docker ставится официальным скриптом:

Окно терминала
curl -fsSL https://get.docker.com | sh

Скачайте docker-compose.yml и шаблон .env из репозитория:

Окно терминала
mkdir /opt/remnawave && cd /opt/remnawave
curl -o docker-compose.yml https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/docker-compose-prod.yml
curl -o .env https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/.env.sample

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

Окно терминала
sed -i "s/^APP_SECRET=.*/APP_SECRET=$(openssl rand -hex 64)/" .env && sed -i "s/^METRICS_PASS=.*/METRICS_PASS=$(openssl rand -hex 64)/" .env && sed -i "s/^WEBHOOK_SECRET_HEADER=.*/WEBHOOK_SECRET_HEADER=$(openssl rand -hex 64)/" .env

Смените пароль PostgreSQL. Команда меняет его сразу в POSTGRES_PASSWORD и в DATABASE_URL:

Окно терминала
pw=$(openssl rand -hex 24) && sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$pw/" .env && sed -i "s|^\(DATABASE_URL=\"postgresql://postgres:\)[^\@]*\(@.*\)|\1$pw\2|" .env

Откройте .env (nano .env) и укажите домены:

FRONT_END_DOMAIN=panel.example.com
SUB_PUBLIC_DOMAIN=panel.example.com/api/sub
Переменная Зачем
FRONT_END_DOMAIN домен панели для заголовков CORS
SUB_PUBLIC_DOMAIN адрес ссылок подписки, без https:// и без / в конце
PANEL_DOMAIN необязательно, для ссылок в уведомлениях Telegram
APP_SECRET секрет для входа в панель, храните вместе с бэкапом

Запустите:

Окно терминала
docker compose up -d && docker compose logs -f -t

В docker-compose.yml порты уже привязаны к 127.0.0.1: панель слушает 127.0.0.1:3000, база 127.0.0.1:6767. Снаружи они недоступны, так и должно остаться. Выйти из логов: Ctrl+C.

Caddy сам получит сертификат Let’s Encrypt. Он работает в Docker и подключается к сети remnawave-network, которую создала панель.

Окно терминала
mkdir -p /opt/remnawave/caddy && cd /opt/remnawave/caddy
nano Caddyfile
https://panel.example.com {
encode
reverse_proxy * http://remnawave:3000
}
:443 {
tls internal
respond 204
}

Второй блок отвечает пустым ответом на запросы без вашего домена, например на сканирование по IP.

nano docker-compose.yml:

services:
caddy:
image: caddy:2.9
container_name: 'caddy'
hostname: caddy
restart: always
ports:
- '0.0.0.0:443:443'
- '0.0.0.0:80:80'
networks:
- remnawave-network
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
- caddy-ssl-data:/data
networks:
remnawave-network:
name: remnawave-network
driver: bridge
external: true
volumes:
caddy-ssl-data:
driver: local
external: false
name: caddy-ssl-data
Окно терминала
docker compose up -d && docker compose logs -f -t

Порты 80 и 443 должны быть открыты (файрвол). Официальная документация описывает также Nginx, Traefik и Angie. Если на сервере уже есть Nginx с certbot, проксируйте домен на http://127.0.0.1:3000 с заголовками Upgrade и Connection.

Откройте https://panel.example.com. Первый зарегистрированный пользователь становится суперадмином. Зарегистрируйтесь сразу после запуска, пока этого не сделал кто-то другой. Кнопка Generate & copy создаст надёжный пароль.

Регистрация суперадмина Remnawave

После первого входа панель покажет отказ от ответственности: Remnawave распространяется «как есть», а за использование отвечает владелец сервера. Нажмите Понимаю и принимаю. Интерфейс сам переключится на русский, если он выбран в браузере. Язык меняется кнопкой в правом верхнем углу.

Главная страница Remnawave 3.4

Если пароль потерян, используйте Rescue CLI:

Окно терминала
docker exec -it remnawave cli

В меню есть сброс суперадмина. После него панель снова предложит создать администратора.

Лучше ставить ноду на отдельный VPS. Если ставите на сервер с панелью, учтите: порт 443 уже занят Caddy, и inbound Xray придётся вешать на другой порт.

  1. На сервере ноды установите Docker и создайте каталог:
Окно терминала
curl -fsSL https://get.docker.com | sh
mkdir /opt/remnanode && cd /opt/remnanode
  1. В панели откройте раздел Ноды и нажмите + справа.

Раздел «Ноды» в Remnawave

  1. Заполните форму Создать ноду: внутреннее название, страну, Домен или IP сервера ноды и Node Port — порт, на котором нода принимает команды от панели.

Форма создания ноды: Secret Key, название, страна, адрес и порт

  1. Нажмите Скопировать docker-compose.yml, на сервере ноды выполните nano docker-compose.yml и вставьте скопированное. В файле уже есть NODE_PORT и SECRET_KEY, нода работает в режиме network_mode: host.
  2. Запустите ноду:
Окно терминала
docker compose up -d && docker compose logs -f -t
  1. В панели нажмите Далее, выберите профиль конфигурации и завершите создание ноды.

Порт ноды откройте только для IP панели:

Окно терминала
ufw allow from IP_ПАНЕЛИ to any port 2222 proto tcp

Подставьте свой Node Port вместо 2222. Порты inbound (например, 443 для VLESS Reality) откройте для всех.

Основные разделы в верхнем меню панели:

Раздел Назначение
Профили (Config Profiles) конфигурации Xray с inbound
Ноды (Nodes) серверы с нодами
Подписка → Хосты (Hosts) адреса и порты, которые увидит клиент в подписке
Пользователи → сквады (Internal Squads) группы inbound, к которым получают доступ пользователи
Пользователи (Users) пользователи, лимиты трафика и срок действия

Профили конфигурации в Remnawave

Порядок такой: профиль конфигурации с inbound, нода с этим профилем, host для inbound, squad с этим inbound, затем пользователь в squad. У пользователя появится ссылка подписки вида https://panel.example.com/api/sub/<shortUuid>. Её импортируют в клиент с поддержкой Xray.

Чтобы не показывать клиентам домен панели, поставьте страницу подписки на свой поддомен. Создайте API-токен в Settings → API Tokens, затем:

Окно терминала
mkdir -p /opt/remnawave/subscription && cd /opt/remnawave/subscription
nano .env
APP_PORT=3010
REMNAWAVE_PANEL_URL=http://remnawave:3000
REMNAWAVE_API_TOKEN=ваш_токен

docker-compose.yml:

services:
remnawave-subscription-page:
image: remnawave/subscription-page:latest
container_name: remnawave-subscription-page
hostname: remnawave-subscription-page
restart: always
env_file:
- .env
ports:
- '127.0.0.1:3010:3010'
networks:
- remnawave-network
networks:
remnawave-network:
driver: bridge
external: true
Окно терминала
docker compose up -d

Добавьте в Caddyfile блок для поддомена с reverse_proxy * http://remnawave-subscription-page:3010 и перезапустите Caddy. В .env панели поменяйте SUB_PUBLIC_DOMAIN=sub.example.com и перезапустите панель.

Сначала обновляйте панель, потом ноды. Перед обновлением прочитайте changelog на docs.rw.

Окно терминала
cd /opt/remnawave && docker compose pull && docker compose down && docker compose up -d && docker compose logs -f
cd /opt/remnanode && docker compose pull && docker compose down && docker compose up -d && docker compose logs -f
docker image prune

Всё важное лежит в базе PostgreSQL и в файле .env:

Окно терминала
docker exec remnawave-db pg_dump -U postgres postgres | gzip > /root/remnawave-db-$(date +%F).sql.gz
cp /opt/remnawave/.env /root/remnawave-env-$(date +%F)

Если вы меняли пользователя или имя базы в DATABASE_URL, подставьте свои значения. Храните копии вне сервера: бэкапы.

Симптом Причина/решение
Домен панели не открывается Нет A-записи или закрыты 80/443. Проверьте docker logs caddy и порты.
Caddy не получает сертификат Домен ещё не указывает на сервер или порт 80 занят другим веб-сервером.
Панель перезапускается по кругу Ошибка в .env. Смотрите docker compose logs remnawave, проверьте пароль в DATABASE_URL.
Нода в панели офлайн Node Port закрыт файрволом для IP панели или SECRET_KEY скопирован не полностью.
Нода не стартует на сервере с панелью Inbound на 443 конфликтует с Caddy. Перенесите inbound на другой порт.
В подписке нет серверов Пользователь не добавлен в squad или для inbound не создан host.
Забыт пароль администратора docker exec -it remnawave cli и сброс суперадмина.

Дополнительно закройте панель: защита VPN-панелей, SSH-ключи, fail2ban.