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

WireGuard на Linux: wg-quick, NetworkManager и проверка

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

WireGuard в Linux подключают по готовому .conf через wg-quick или NetworkManager. Установите пакет, сохраните профиль с закрытыми правами, поднимите интерфейс и проверьте handshake, маршруты и DNS. Выберите один способ управления; автозапуск включайте после ручной проверки. На удалённом сервере сначала обеспечьте независимую консоль.

Разбор по симптому

Какой слой WireGuard проверять

Выберите первый результат, который не совпал с ожидаемым.

Профиль и менеджер

Проверьте имя интерфейса, конфликт NetworkManager/wg-quick и сообщение DNS/resolvconf. Не переходите к серверным ключам до запуска.

1Запуск интерфейса2Handshake3Маршрут и DNS
Запуск интерфейса → Handshake → Маршрут и DNS

Установите пакет и выберите один менеджер

Нужен клиентский профиль от администратора или поставщика. Установка пакета WireGuard сама по себе не выдаёт ключ и сервер. Пакет берите из репозитория своей системы: случайный скрипт «wget wireguard» не нужен для обычного клиента.

Установка и способ управления
СредаКоманда или путьУсловие
Ubuntu/Debian; Mint/Kali с соответствующим штатным пакетомsudo apt update, затем sudo apt install wireguardРепозитории должны соответствовать вашему выпуску
Fedorasudo dnf install wireguard-toolsШтатное поддерживаемое ядро
Desktop с NetworkManagerИмпорт через nmcliNetworkManager управляет соединением вместо 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-трафик
DNSDNS для туннеляОжидать, что одно поле всегда работает без 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 протокол не меняет.