Перейти к содержимому

Статья 102 из 141

Гайды

wg-easy на VPS: WireGuard с веб-панелью в Docker (версия 15)

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

Статья написана для версии 15. Это полностью переписанный проект: переменные окружения из v14 (WG_HOST, PASSWORD_HASH и другие) больше не работают, почти все настройки перенесены в веб-панель. Инструкции для v14 из старых статей к текущей версии не подходят.

Ресурс Минимум
CPU 1 vCPU
RAM 512 МБ – 1 ГБ
Диск 10 ГБ
ОС Ubuntu 22.04 или 24.04, архитектура x86_64 или arm64
  • Docker с плагином Compose.
  • Домен или поддомен, например vpn.example.com, с A-записью на IP сервера (DNS). Без домена тоже можно, об этом ниже.
Порт Протокол Назначение
51820 UDP сам WireGuard, открыт в интернет
51821 TCP веб-панель, наружу не открываем

Создайте папку и файл:

Окно терминала
mkdir -p /opt/wg-easy && cd /opt/wg-easy
nano docker-compose.yml

Это официальный docker-compose.yml из репозитория с двумя изменениями: панель слушает только 127.0.0.1, а данные лежат в папке ./wireguard рядом с файлом, чтобы их было проще бэкапить.

services:
wg-easy:
image: ghcr.io/wg-easy/wg-easy:15
container_name: wg-easy
networks:
wg:
ipv4_address: 10.42.42.42
ipv6_address: fdcc:ad94:bacf:61a3::2a
volumes:
- ./wireguard:/etc/wireguard
- /lib/modules:/lib/modules:ro
ports:
- "51820:51820/udp"
- "127.0.0.1:51821:51821/tcp"
restart: unless-stopped
cap_add:
- NET_ADMIN
- SYS_MODULE
sysctls:
- net.ipv4.ip_forward=1
- net.ipv4.conf.all.src_valid_mark=1
- net.ipv6.conf.all.disable_ipv6=0
- net.ipv6.conf.all.forwarding=1
- net.ipv6.conf.default.forwarding=1
networks:
wg:
driver: bridge
enable_ipv6: true
ipam:
driver: default
config:
- subnet: 10.42.42.0/24
- subnet: fdcc:ad94:bacf:61a3::/64
Окно терминала
docker compose up -d
docker compose logs -f

Используйте тег 15: он получает все обновления пятнадцатой версии без ломающих изменений. Тег latest у wg-easy до сих пор указывает на старую v14, его не берите.

Откройте UDP-порт WireGuard в файрволе (настройка файрвола):

Окно терминала
ufw allow 51820/udp

Порт 51821 открывать не нужно. Docker публикует порты в обход ufw, поэтому панель и привязана к 127.0.0.1: так она точно недоступна снаружи.

По умолчанию wg-easy пускает в панель только по HTTPS (переменная INSECURE=false). Поставьте перед ней Nginx с сертификатом Let’s Encrypt.

Конфиг /etc/nginx/sites-available/wg-easy:

server {
listen 80;
server_name vpn.example.com;
location / {
proxy_pass http://127.0.0.1:51821;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/wg-easy /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d vpn.example.com

Подробнее: Nginx, Let’s Encrypt. Если вы уже используете Caddy или Traefik, у wg-easy есть для них готовые примеры в документации, см. также Traefik и Caddy.

wg-easy сам не ограничивает число попыток входа. Документация советует ограничить на прокси запросы к /api/auth/password, /api/auth/verify-2fa и /cnf/*. Дополнительно можно пустить в панель только свои IP: защита VPN-панелей.

Если домена нет, оставьте порт на 127.0.0.1 и заходите через SSH-туннель. Панель тогда открывается по HTTP, поэтому добавьте в сервис переменную:

environment:
- INSECURE=true
Окно терминала
docker compose up -d

На своём компьютере:

Окно терминала
ssh -L 51821:127.0.0.1:51821 root@IP_СЕРВЕРА

И откройте в браузере http://localhost:51821. Не публикуйте панель с INSECURE=true на внешний IP: пароль будет передаваться открытым текстом.

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

  1. Приветствие. Нажмите «Продолжить».
  2. Аккаунт администратора. Задайте имя пользователя и надёжный пароль и нажмите «Создать аккаунт». Сделайте это сразу после запуска, пока панель никто другой не открыл.

Мастер wg-easy: создание администратора

  1. Существующая настройка. Для новой установки выберите «Нет». «Да» нужен только при переезде с v14: мастер попросит файл wg0.json из старой версии.
  2. Хост и порт. Хост — домен или IP, к которому будут подключаться клиенты (например vpn.example.com), кнопка «Предложить» подставит адрес сервера. Если домен проксируется через Cloudflare, укажите IP: WireGuard через прокси Cloudflare не работает. Порт: 51820.

Мастер wg-easy: хост и порт для клиентов

  1. Мастер сообщит «Настройка завершена успешно». Нажмите «Войти» и войдите под созданным администратором.

Остальное (DNS для клиентов, диапазоны адресов, Allowed IPs, MTU) меняется потом в админ-панели. Также включите двухфакторную аутентификацию для своей учётной записи: wg-easy её поддерживает.

  1. Нажмите Новый, дайте клиенту понятное имя (phone-anna, laptop-work) и при необходимости дату окончания, затем Создать клиента.

Создание клиента в wg-easy

  1. У клиента в списке появятся кнопки: изменить, QR-код, скачать конфигурацию и одноразовая ссылка. Для телефона откройте QR-код и отсканируйте его в приложении WireGuard.
  2. Для компьютера скачайте файл .conf и импортируйте его в приложение. Одноразовая ссылка удобна, чтобы отправить конфиг человеку: после первого открытия она перестаёт работать.

Список клиентов wg-easy

Для каждого устройства делайте отдельного клиента. Тогда потерянный телефон можно отключить, не трогая остальных. В карточке клиента можно задать срок действия, после которого он отключится сам.

Клиентские приложения WireGuard есть для Windows, macOS, Linux, Android и iOS: клиенты WireGuard.

Окно терминала
cd /opt/wg-easy
docker compose pull
docker compose up -d

Перед обновлением сделайте бэкап (ниже). Переход на следующую мажорную версию делайте только по официальной инструкции миграции.

Все данные wg-easy (ключи сервера, клиенты, настройки, учётка администратора) лежат в /opt/wg-easy/wireguard. Ключи нельзя восстановить: без них всех клиентов придётся настраивать заново.

Окно терминала
cd /opt/wg-easy
docker compose stop
tar -czf /root/wg-easy-$(date +%F).tar.gz wireguard docker-compose.yml
docker compose start

Храните архив за пределами сервера: бэкапы.

Окно терминала
cd /opt/wg-easy
docker compose exec -it wg-easy cli db:admin:reset

Команда спросит новый пароль. В той же утилите есть cli clients:list и cli clients:qr <id> для вывода QR-кода прямо в терминал.

Симптом Причина/решение
Подключение есть, интернета нет Чаще всего DNS, MTU или маршрутизация. Разбор: WireGuard подключён, но нет интернета
Нет handshake, счётчики трафика по нулям Закрыт UDP 51820 в файрволе или неверный Host в настройках. Проверьте: проверка портов. Host должен указывать на IP сервера без прокси
Панель по HTTP не пускает или сразу выкидывает В v15 по умолчанию нужен HTTPS. Используйте Nginx с сертификатом или INSECURE=true только для доступа через SSH-туннель
В логах Cannot find device "wg0" Не загружен модуль ядра: modprobe wireguard, для автозагрузки echo "wireguard" >> /etc/modules
can't initialize iptables table 'nat' Не загружен модуль: modprobe iptable_nat (для IPv6 ip6table_nat), добавьте его в /etc/modules
Старые инструкции с WG_HOST и PASSWORD_HASH не работают Это переменные v14. В v15 хост и порт задаются в мастере и админ-панели
Контейнер с тегом latest ведёт себя как старая версия latest указывает на v14. Поменяйте образ на ghcr.io/wg-easy/wg-easy:15

Похожая панель для WireGuard: WGDashboard. Если нужен голый WireGuard без панели, см. WireGuard вручную, а сравнение протоколов: OpenVPN или WireGuard.