WireGuard. Управление модулем

Эта статья — продолжение WireGuard. Быстрый старт. Если вы ещё не установили модуль и не создали первого пользователя — начните с него. Здесь собраны операции над самим модулем: запуск и остановка сервиса, обновление, переустановка и удаление. Управление пользователями VPN вынесено в отдельную статью — WireGuard. Управление пользователями.

Шапка страницы и меню действий

В шапке страницы доступны основные действия с модулем — запуск, остановка и перезапуск сервиса. Состояние сервиса отображается индикатором и чипом с версией «WireGuard». В меню с тремя точками рядом — остальные действия: открыть логи, запустить обновление, переустановить или удалить модуль.

Управление сервисом

• «Запустить» — поднимает сервис WireGuard из остановленного состояния.
• «Остановить» — выключает сервис. Все активные VPN‑подключения разрываются, новые установить не получится.
• «Перезапустить» — останавливает и сразу запускает сервис заново. Открытые соединения сбрасываются.

Изменения в составе пользователей сервер применяет на лету, без перезапуска сервиса: добавили, отключили или удалили — новая конфигурация подхватывается сразу. А вот если в карточке пользователя поменялись «Сервер DNS» или «Persistent keepalive», файл .conf на устройстве нужно переимпортировать — подробности в статье WireGuard. Управление пользователями.

⚠️ Остановка сервиса разрывает все VPN‑подключения

Пока сервис выключен, ни один пользователь не сможет подключиться. Планируйте остановку и перезапуск на окно обслуживания или предупреждайте пользователей заранее.

Пока модуль обновляется, переустанавливается или удаляется, кнопки управления сервисом и меню действий временно недоступны.

Логи модуля

В меню действий выберите «Логи» — откроется журнал операций жизненного цикла модуля: установка, обновление, переустановка, удаление. У каждой записи виден статус и полный вывод выполнения. Пригодится, если очередное действие завершилось ошибкой и нужно понять причину.

Настройки сервера

У WireGuard нет отдельной страницы настроек сервера: серверные параметры (приватный ключ интерфейса, адресация туннеля, набор пиров) панель BeAdmin подбирает сама при установке и держит их под капотом. Сервер принимает входящие подключения по UDP на порту 51820 — это стандартный порт WireGuard, в панели он фиксирован и не меняется. Если этот порт занят другим сервисом на хосте, освободите его до установки модуля.

ℹ️ Если VPN блокируют по порту

Протокол WireGuard узнаваем DPI‑фильтрами независимо от порта, поэтому смена UDP‑порта от активных блокировок не спасает. В сетях с жёсткой цензурой используйте Amnezia (AmneziaWG с обфускацией) или Xray.

Обновление модуля

В меню действий выберите «Обновить WireGuard». Панель проверит, есть ли более свежая версия WireGuard в репозитории, установит её поверх текущей и перезапустит сервис. Список пользователей и их ключи сохраняются — переимпортировать .conf на устройства не нужно.

Подтверждения у обновления нет — действие запускается сразу. Пока идёт обновление, кнопки управления сервисом и пункты меню недоступны; текущая версия модуля видна на чипе «WireGuard» в шапке. Если установлена актуальная версия, обновление не запускается — панель сообщит об этом.

Переустановка модуля

В меню действий выберите «Переустановить WireGuard». Панель попросит подтвердить переустановку в диалоге «Подтвердите переустановку WireGuard» — нажмите «Подтвердить». Та же версия WireGuard разворачивается поверх текущей, сервис перезапускается. Список пользователей, их ключи и сгенерированные файлы .conf сохраняются — переимпортировать настройки на устройства не требуется.

Применяйте переустановку, если модуль работает нестабильно и хочется прогнать установку заново, не теряя пользователей. В отличие от удаления, переустановка не стирает пользователей и их ключи — уже выданные конфигурации .conf продолжат работать без переподключения и переимпорта.

Параметры подключения переустановка не меняет — модуль поднимется на том же UDP‑порту 51820 и с теми же ключами интерфейса. WireGuard ставится одной кнопкой без диалога параметров, поэтому ничего выбирать перед переустановкой не нужно.

Если у клиентов перестало подключаться после переустановки — в раскрытой строке пользователя заново скачайте файл .conf или пересоздайте QR‑код. Если ошибки сохраняются, крайнее средство — полностью удалить модуль и установить его заново.

Удаление модуля

В меню действий выберите «Удалить WireGuard». Панель попросит подтвердить удаление в диалоге «Подтвердите удаление модуля WireGuard»: вместе с модулем удаляются все настройки пользовательских подключений; после повторной установки модуль появится с нуля.

‼️ Удаление модуля стирает всех пользователей VPN

Удаление необратимо: вместе с модулем пропадают все пользователи WireGuard, их ключи и сгенерированные конфигурационные файлы .conf. Уже импортированные клиентские конфигурации после удаления подключиться не смогут — серверная сторона туннеля исчезнет вместе с приватным ключом. После повторной установки модуль и пользователей придётся создавать заново; ключи выпустятся новые, и у клиентов нужно будет переимпортировать .conf.

После подтверждения панель запускает удаление. По завершении страница модуля возвращается в исходное состояние с кнопкой «Установить».

Что дальше

• WireGuard. Быстрый старт — установка модуля и первое подключение.
• WireGuard. Управление пользователями — создание, редактирование и удаление пользователей.
• Как настроить SMTP‑релей для отправки писем — чтобы можно было отправлять пользователям файл .conf на почту.