wg-easy: установить WireGuard с веб-панелью и не открыть управление всем
Опубликовано 05.11.2026
wg-easy разворачивает WireGuard и панель выпуска клиентских профилей через Docker Compose. Для новой установки используйте согласованный с документацией тег версии, сохраните постоянный volume и откройте наружу только VPN UDP-порт. Веб-панель выдаёт секретные профили, поэтому её доступ нужно защитить отдельно.
Практический помощник
Запуск и обслуживание wg-easy
Помощник показывает действие по вашей ситуации. Он не подключается к серверу и не запрашивает ключи.
Используйте мастер выбранной ветки
Подготовьте compose, закройте панель loopback-привязкой, затем задайте администратора, публичный Host и UDP Port.
Подготовить хост и выбрать версию
Нужен собственный Linux-хост с поддержкой WireGuard, публичным IP или доменом и Docker Engine с Compose plugin. Официальная инструкция перечисляет x86_64 и arm64. Проверьте docker version и docker compose version. В контейнерной виртуализации без нужных возможностей ядра приложение может не поднять интерфейс; увеличение RAM этого не исправляет.
Для описанной ветки документация использует образ ghcr.io/wg-easy/wg-easy:15. Не заменяйте его машинально на latest: в прочитанной справке latest всё ещё относится к v14. Старые примеры с WG_HOST/PASSWORD и новая первоначальная настройка относятся к разным поколениям.
| Объект | Зачем |
|---|---|
| docker-compose.yml | Версия образа, порты, права и сети |
| Volume /etc/wireguard | Клиенты, ключи и настройки |
| Административная учётная запись | Управление профилями |
| Публичный Host и UDP Port | Именно эти значения попадут в клиентские Endpoint |
Подготовить Compose до первого запуска
Возьмите docker-compose.yml из официального репозитория wg-easy, указанного в документации Basic Installation, сохраните его в отдельный каталог, например /etc/docker/containers/wg-easy, и прочитайте до запуска. Это конфигурация контейнера, а не команда curl|bash. Сохраните выбранный образ, постоянный volume, capabilities и sysctl из официального примера.
Для управления только через SSH-туннель замените публикацию панели на 127.0.0.1:51821:51821/tcp. VPN-порт оставьте 51820:51820/udp. Если частные Docker-подсети 10.42.42.0/24 и fdcc:ad94:bacf:61a3::/64 пересекаются с вашими сетями, согласованно измените сеть и статические адреса контейнера.
ports:
- "51820:51820/udp"
- "127.0.0.1:51821:51821/tcp"
environment:
- INSECURE=trueЭтот фрагмент заменяет соответствующие поля внутри services/wg-easy, не является полным Compose. INSECURE=true разрешает HTTP только для выбранной закрытой схемы: панель привязана к loopback, браузер обращается к ней через зашифрованный SSH-туннель. Не публикуйте HTTP-панель на 0.0.0.0. Для постоянного доступа по домену используйте рекомендованный документацией HTTPS reverse proxy; не сочетайте открытый HTTP и административные пароли.
Запустить контейнер и пройти мастер
cd /etc/docker/containers/wg-easy
sudo docker compose config
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100В firewall хостера разрешите выбранный UDP-порт. При Docker проверьте фактическую публикацию портов: контейнерные правила могут обходить привычную фильтрацию UFW, поэтому закрытая привязка панели к loopback обязательна для этой схемы.
На своём компьютере установите SSH-туннель к VPS: ssh -N -L 51821:127.0.0.1:51821 USER@SERVER. Откройте в браузере локальный адрес 127.0.0.1:51821 по HTTP. USER и SERVER заменяют разрешённый SSH-вход, а не реквизиты VPN-клиента.
- В мастере задайте Username и уникальный Password администратора.
- Для новой установки выберите отсутствие старой конфигурации. Импорт v14 используйте только как отдельную миграцию с резервной копией.
- В Host укажите публичный IP или домен сервера, доступный клиентам; не 127.0.0.1 и не внутренний Docker IP.
- В Port укажите внешний UDP-порт. Он должен соответствовать публикации контейнера и правилам NAT/firewall.
- Создайте отдельного клиента, скачайте .conf либо покажите QR только владельцу устройства.
Проверить подключение, обновить и сохранить возможность восстановления
Подключитесь телефоном из другой сети, откройте нужный ресурс и посмотрите handshake и счётчики клиента в панели. Наличие работающего веб-интерфейса не доказывает доступность WireGuard UDP. Если handshake есть, но интернет недоступен, проверьте серверный выход, пересылку и DNS профиля. Отдельно проверьте поведение IPv6.
Перед обновлением остановите изменение клиентов и сделайте согласованную закрытую резервную копию volume с конфигурацией и compose. Затем в его каталоге выполните docker compose pull и docker compose up -d для выбранной ветки. Не используйте docker compose down -v для обычного обновления: -v удаляет именованные volumes. После запуска проверьте прежний клиент, а не только страницу входа.
Отключение клиента выполняется в панели; удаление локального файла у получателя не отзывает серверную запись. При смене major сначала прочитайте руководство миграции и сохраните возврат к прежнему образу и данным. Ключи, QR, дампы volume и пароли не должны попадать в публичный репозиторий.
По следующему шагу: VPN-порт и порт панели; состав клиентского профиля.
