1. Блог
  2. Мануалы

WireGuard с веб-интерфейсом: установка wg-easy на VPS

WireGuard с веб-интерфейсом: установка wg-easy на VPS

WireGuard — быстрый и простой VPN-протокол, но управлять им из консоли неудобно: для каждого клиента нужно создавать ключи и править конфигурацию. Проект wg-easy добавляет к WireGuard веб-панель, где клиент создаётся одной кнопкой, а подключение настраивается сканированием QR-кода.

Что понадобится

Шаг 1. Установка

Создайте каталог и скачайте официальный файл Compose:

mkdir -p ~/wg-easy && cd ~/wg-easy
curl -o docker-compose.yml https://raw.githubusercontent.com/wg-easy/wg-easy/master/docker-compose.yml

Файл уже содержит всё необходимое: образ ghcr.io/wg-easy/wg-easy:15, том для конфигурации, сетевые права контейнера и два порта — 51820/udp для VPN и 51821/tcp для панели управления.

Шаг 2. Доступ к панели

Панель передаёт пароль администратора, поэтому по умолчанию работает только через HTTPS. Есть два варианта.

Вариант А: домен и обратный прокси (рекомендуется). Направьте поддомен, например vpn.example.com, на сервер и опубликуйте порт 51821 через Nginx Proxy Manager или Nginx с Certbot. В этом случае порт панели лучше привязать к локальному адресу — замените строку в docker-compose.yml:

      - "127.0.0.1:51821:51821/tcp"

Вариант Б: без домена. Разрешите работу по HTTP, добавив в описание сервиса переменную:

    environment:
      - INSECURE=true

Этот вариант подходит только для первого знакомства: пароль передаётся в открытом виде. Не оставляйте панель в таком режиме доступной из интернета — подключайтесь к ней через SSH-туннель:

ssh -L 51821:127.0.0.1:51821 root@203.0.113.10

Шаг 3. Запуск

docker compose up -d

Откройте порт VPN в файрволе:

sudo ufw allow 51820/udp

Шаг 4. Первый вход

Откройте панель в браузере. Мастер настройки предложит:

  1. создать учётную запись администратора;
  2. указать Host — внешний IP-адрес или домен сервера, к которому будут подключаться клиенты;
  3. подтвердить порт 51820.

Адрес из поля Host попадает в конфигурацию каждого клиента. Если указать его неверно, клиенты не смогут подключиться.

Шаг 5. Добавление клиента

  1. Нажмите New и введите имя клиента, например phone.
  2. Для телефона нажмите на значок QR-кода и отсканируйте его приложением WireGuard: + → Сканировать QR-код.
  3. Для компьютера скачайте файл конфигурации и импортируйте его в приложение WireGuard: Импорт туннелей из файла.

Приложения WireGuard есть для Windows, macOS, Linux, Android и iOS. После включения туннеля проверьте свой IP-адрес — он должен совпадать с адресом сервера.

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

Полезные настройки

Параметры меняются в панели администратора:

  • DNS — сервер, который получают клиенты. Если на том же сервере работает AdGuard Home, укажите его адрес, и реклама будет блокироваться на всех подключённых устройствах.
  • Allowed IPs — какие адреса клиент отправляет в туннель. Значение 0.0.0.0/0, ::/0 направляет через VPN весь трафик; для доступа только к внутренней сети укажите её подсеть.
  • Persistent Keepalive — значение 25 помогает клиентам за NAT не терять соединение.
  • Срок действия — клиенту можно задать дату, после которой доступ отключится автоматически.

Разбор параметров клиентской конфигурации есть в статье о настройке клиента WireGuard.

Безопасность

  • Включите двухфакторную аутентификацию в профиле администратора.
  • Не публикуйте порт панели в интернет без HTTPS.
  • Создавайте отдельного клиента для каждого устройства: потерянное устройство отключается без перенастройки остальных.
  • Защитите сам сервер: вход по SSH-ключам и Fail2Ban.

Обновление

cd ~/wg-easy
docker compose pull
docker compose up -d

Конфигурация и ключи клиентов хранятся в томе etc_wireguard и при обновлении сохраняются.

Если клиент не подключается

  • Нет рукопожатия. Проверьте, что UDP-порт 51820 открыт в файрволе сервера и что в поле Host указан правильный адрес.
  • Подключение есть, интернета нет. Убедитесь, что контейнер запущен с параметрами из официального файла Compose: без sysctls и cap_add пересылка пакетов не работает.
  • Не открываются сайты по имени. Проверьте адрес DNS в настройках.
  • Журнал контейнера: docker logs wg-easy.

Видеоинструкция

Видео снято для более ранней версии: способ установки и интерфейс изменились, принцип работы остался прежним.

YouTube video