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

WireGuard — быстрый и простой VPN-протокол, но управлять им из консоли неудобно: для каждого клиента нужно создавать ключи и править конфигурацию. Проект wg-easy добавляет к WireGuard веб-панель, где клиент создаётся одной кнопкой, а подключение настраивается сканированием QR-кода.
Что понадобится
- VPS с Ubuntu или Debian — достаточно минимального тарифа;
- Docker и Docker Compose — см. инструкцию по установке;
- открытый UDP-порт 51820.
Шаг 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. Первый вход
Откройте панель в браузере. Мастер настройки предложит:
- создать учётную запись администратора;
- указать Host — внешний IP-адрес или домен сервера, к которому будут подключаться клиенты;
- подтвердить порт 51820.
Адрес из поля Host попадает в конфигурацию каждого клиента. Если указать его неверно, клиенты не смогут подключиться.
Шаг 5. Добавление клиента
- Нажмите New и введите имя клиента, например
phone. - Для телефона нажмите на значок QR-кода и отсканируйте его приложением WireGuard: + → Сканировать QR-код.
- Для компьютера скачайте файл конфигурации и импортируйте его в приложение 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.
Видеоинструкция
Видео снято для более ранней версии: способ установки и интерфейс изменились, принцип работы остался прежним.



