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

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

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

В правом верхнем углу страницы модуля доступны три кнопки управления сервисом WireGuard: «Запустить», «Остановить» и «Перезапустить».

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

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

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

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

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

ℹ️ Порт

Сервис WireGuard принимает подключения по UDP на порту 51820.

⚠️ Ограничения провайдеров

Шифрование трафика делает VPN надёжным средством защиты подключения, но в ряде стран и регионов провайдеры применяют технические меры против VPN-протоколов. Из-за этого стопроцентная доступность сервиса не гарантируется — независимо от типа подключения. Если один протокол не подходит, попробуйте другой модуль VPN из панели. Если ни один не работает в вашей сети, напишите в поддержку — оформим возврат средств за лицензию.

Уведомление о ненастроенном SMTP

В шапке страницы модуля может появиться информационный блок «Отправка писем не настроена» со ссылкой «К настройкам». Он означает, что в панели нет рабочего SMTP — отправлять пользователям файл .conf на почту не получится. Сам VPN при этом работает: информационный блок относится только к отправке писем, скачивание .conf и QR-код в диалоге «Настройки подключения» остаются доступными. Настройку SMTP см. в статье Как настроить SMTP-релей для отправки писем.

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

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

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

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

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

ℹ️ Данные сохраняются

Список пользователей и их активные подключения остаются на месте — переимпортировать .conf на устройствах не нужно. Этим переустановка отличается от удаления и повторной установки модуля.

ℹ️ Если подключение не восстановилось

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

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

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

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

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

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

Журнал задач

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

Полезные ссылки

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