Автофайлы: в помощь автовладельцу » Программы » Настройка сети » wg-easy: установить WireGuard с веб-панелью и не открыть управление всем

wg-easy: установить WireGuard с веб-панелью и не открыть управление всем

Автор: Алексей Воронов

wg-easy разворачивает WireGuard и панель выпуска клиентских профилей через Docker Compose. Для новой установки используйте согласованный с документацией тег версии, сохраните постоянный volume и откройте наружу только VPN UDP-порт. Веб-панель выдаёт секретные профили, поэтому её доступ нужно защитить отдельно.

Практический помощник

Запуск и обслуживание wg-easy

Помощник показывает действие по вашей ситуации. Он не подключается к серверу и не запрашивает ключи.

Используйте мастер выбранной ветки

Подготовьте compose, закройте панель loopback-привязкой, затем задайте администратора, публичный Host и UDP Port.

1Выбрать ситуацию2Выполнить проверку3Сверить результат
Выбрать ситуацию → Выполнить проверку → Сверить результат

Подготовить хост и выбрать версию

Нужен собственный 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-клиента.

  1. В мастере задайте Username и уникальный Password администратора.
  2. Для новой установки выберите отсутствие старой конфигурации. Импорт v14 используйте только как отдельную миграцию с резервной копией.
  3. В Host укажите публичный IP или домен сервера, доступный клиентам; не 127.0.0.1 и не внутренний Docker IP.
  4. В Port укажите внешний UDP-порт. Он должен соответствовать публикации контейнера и правилам NAT/firewall.
  5. Создайте отдельного клиента, скачайте .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-порт и порт панели; состав клиентского профиля.