WireGuard на Linux: wg-quick, NetworkManager и проверка
Опубликовано 18.11.2026
WireGuard в Linux подключают по готовому .conf через wg-quick или NetworkManager. Установите пакет, сохраните профиль с закрытыми правами, поднимите интерфейс и проверьте handshake, маршруты и DNS. Выберите один способ управления; автозапуск включайте после ручной проверки. На удалённом сервере сначала обеспечьте независимую консоль.
Разбор по симптому
Какой слой WireGuard проверять
Выберите первый результат, который не совпал с ожидаемым.
Профиль и менеджер
Проверьте имя интерфейса, конфликт NetworkManager/wg-quick и сообщение DNS/resolvconf. Не переходите к серверным ключам до запуска.
Установите пакет и выберите один менеджер
Нужен клиентский профиль от администратора или поставщика. Установка пакета WireGuard сама по себе не выдаёт ключ и сервер. Пакет берите из репозитория своей системы: случайный скрипт «wget wireguard» не нужен для обычного клиента.
| Среда | Команда или путь | Условие |
|---|---|---|
| Ubuntu/Debian; Mint/Kali с соответствующим штатным пакетом | sudo apt update, затем sudo apt install wireguard | Репозитории должны соответствовать вашему выпуску |
| Fedora | sudo dnf install wireguard-tools | Штатное поддерживаемое ядро |
| Desktop с NetworkManager | Импорт через nmcli | NetworkManager управляет соединением вместо wg-quick |
| Минимальная система или сервер | wg-quick, затем служба systemd | Проверены DNS-интеграция и доступ при смене маршрута |
Команда wg --version проверяет наличие утилиты. Сообщение об отсутствии поддержки типа интерфейса относится уже к ядру или модулю, а не к ключу сервера. Версию ядра покажет uname -r; это полезнее повторного импорта того же ключа. Не ставьте сторонний модуль поверх произвольного старого ядра без инструкции своего дистрибутива. Особенно это касается специальных и сертифицированных сборок Linux.
Проверьте файл до запуска с правами администратора
Обычный профиль содержит секции [Interface] и [Peer]. В первой находятся адрес и закрытый ключ клиента; во второй — открытый ключ сервера, Endpoint и AllowedIPs. Закрытый ключ не публикуют вместе с вопросом об ошибке.
| Поле | Смысл | Частая ошибка |
|---|---|---|
| Address | Выданный адрес интерфейса внутри туннеля | Подставить публичный адрес сервера |
| Endpoint | Внешний адрес и UDP-порт peer | Заменить порт случайным значением |
| AllowedIPs | Допустимые сети peer; wg-quick создаёт для них маршруты | Считать 0.0.0.0/0 только меткой, не влияющей на весь IPv4-трафик |
| DNS | DNS для туннеля | Ожидать, что одно поле всегда работает без resolvconf |
| PreUp/PostUp/PreDown/PostDown | Команды, выполняемые при запуске и остановке | Запустить неизвестный файл с чужими командами |
На рабочем столе удобно начать с NetworkManager. Для wg-quick положите проверенный профиль в /etc/wireguard/wg0.conf. В примере исходный файл называется ~/Downloads/client.conf; замените путь своим. Если wg0.conf уже существует, сохраните его копию и выберите другое свободное имя, не перезаписывая действующее подключение.
sudo install -d -m 700 /etc/wireguard
sudo install -m 600 ~/Downloads/client.conf /etc/wireguard/wg0.conf
Перед полным туннелем запишите текущие маршруты: ip route, ip -6 route и ip rule. Если работаете по SSH, сначала откройте независимую консоль провайдера или подключитесь локально. Новое SSH-окно через тот же маршрут не спасёт, если маршрут исчезнет.
Запуск через wg-quick и возврат назад
sudo wg-quick up wg0
sudo wg show wg0
wg-quick сам создаёт интерфейс, назначает адреса и маршруты. Предварительно выполнять ip link add dev wg0 type wireguard не нужно: это команда для ручной низкоуровневой настройки, и готовый интерфейс с тем же именем создаст конфликт.
Откройте ресурс, адрес которого входит в AllowedIPs, и повторите wg show. Должны появиться недавний handshake и растущие счётчики передачи. Без трафика WireGuard может молчать — отсутствие немедленного handshake после запуска не равнозначно ошибке.
Для остановки используйте sudo wg-quick down wg0. После неё проверьте обычное соединение. Если в профиле были собственные firewall-команды, корректность возврата зависит и от соответствующих PreDown/PostDown, поэтому неизвестные hooks нужно разобрать до первого запуска.
Ошибка resolvconf: command not found означает, что обработчику поля DNS не хватает инструмента интеграции. На desktop проще выбрать NetworkManager. Для wg-quick используйте поддерживаемую вашим дистрибутивом интеграцию DNS; не стирайте строку DNS только ради зелёного запуска, не проверив разрешение имён после этого.
Вариант с NetworkManager в GNOME или KDE
Остановите wg-quick для этого профиля. Затем импортируйте файл:
nmcli connection import type wireguard file ~/Downloads/client.conf
nmcli -f NAME,UUID,TYPE connection show
Скопируйте UUID импортированного соединения. В следующих командах UUID_ПРОФИЛЯ заменяется этим значением:
nmcli connection modify uuid UUID_ПРОФИЛЯ connection.autoconnect no
nmcli --ask connection up uuid UUID_ПРОФИЛЯ
nmcli connection show --active
Остановка: nmcli connection down uuid UUID_ПРОФИЛЯ. После успешной проверки можно включить автоматическое подключение этого же профиля. Не включайте параллельно службу wg-quick для того же интерфейса: владеть настройками должен один менеджер.
Проверьте маршрут, DNS и обе версии IP
Для адреса, который должен идти в туннель, выполните ip route get АДРЕС_РЕСУРСА. Замените обозначение настоящим IPv4-адресом. При полном туннеле wg-quick использует дополнительные правила, поэтому вместе с маршрутом смотрите ip rule и ip route show table all, а не только одну строку default.
Проверьте DNS через getent ahosts example.com, затем откройте нужный сайт. Если задан только 0.0.0.0/0, IPv6 этим правилом не охвачен. Для IPv6 нужен выданный сервером маршрут и поддержка; наличие ::/0 нельзя добавлять как украшение к неработающему IPv6-серверу.
| Симптом | Следующая проверка |
|---|---|
| Интерфейс уже существует | Не управляет ли им другой экземпляр wg-quick или NetworkManager |
| Трафик отправляется, handshake нет | Endpoint/UDP-порт, ключи, разрешение endpoint-имени и доступность сети |
| Handshake есть, ресурс не работает | AllowedIPs, реальный маршрут, серверный forwarding и разрешения для клиента |
| IP доступен, доменные имена нет | DNS и системный resolver |
| Часть загрузок зависает | Сравнить размер запроса и сеть; MTU менять только после такого различия, не обещая универсального числа |
Включите автозапуск проверенного профиля
Для ветки wg-quick сначала остановите ручной интерфейс, затем передайте его службе:
sudo wg-quick down wg0
sudo systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0
sudo journalctl -u wg-quick@wg0 -b --no-pager
Завершённая настройка проверяется повторным подключением и работой ресурса; статус службы сам по себе недостаточен. Для возврата используйте sudo systemctl disable --now wg-quick@wg0. Если выбирали NetworkManager, управляйте автоматическим запуском там.
Настройка роутера отличается зонами firewall и трафиком LAN: её описывает инструкция WireGuard для OpenWrt. А если поставщик выдал .ovpn, нужен клиент OpenVPN на Linux, переименование файла в .conf протокол не меняет.
