SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-11-18

Как работает cryptokey routing в WireGuard

Поймите принцип работы cryptokey routing в WireGuard. Узнайте, почему параметр AllowedIPs одновременно выполняет функции таблицы маршрутизации и списка контроля доступа.

Принцип работы WireGuard в одном тезисе

WireGuard привязывает каждый пакет к открытому ключу. Этот механизм называется cryptokey routing, и на нем строится вся архитектура: строка AllowedIPs рядом с узлом (peer) одновременно является таблицей маршрутизации для исходящих пакетов и списком контроля доступа для входящих пакетов от этого узла. Одна настройка — две функции. Читайте AllowedIPs именно так, и любой конфигурационный файл WireGuard станет понятным.

Здесь нет таблицы сессий, привязанной к IP-адресам, и нет базы данных пользователей. Узел — это открытый ключ плюс набор адресов, которые этот ключ может использовать. Рукопожатие (handshake) и таймеры нужны для поддержания этой привязки при изменениях в нижележащей сети. Если вы хотите сначала увидеть работающий туннель, а потом теорию, создайте его с помощью собственного VPN-сервера WireGuard на своем VPS, а затем вернитесь сюда, если какая-то строка конфигурации вызовет вопросы.

AllowedIPs — это таблица маршрутизации и список доступа

Рассмотрим сначала исходящее направление. Ядро направляет пакет на устройство wg0 обычным способом, через основную таблицу маршрутизации. Затем WireGuard сопоставляет адрес назначения пакета с таблицей, содержащей разрешенные префиксы всех пиров, используя алгоритм поиска по самому длинному префиксу. Совпадение указывает на конкретный пир, который определяет открытый ключ, а тот, в свою очередь, — сессионный ключ и UDP-эндпоинт. Пакет шифруется для этого пира и отправляется по адресу.

Если ни один AllowedIPs пира не охватывает адрес назначения, пакет не отправляется, так как отсутствует ключ для шифрования.

ping: sendmsg: Required key not available

Эта ошибка означает одно: адрес, к которому вы пытаетесь обратиться, не указан ни у одного из пиров. Другая ошибка, ping: sendmsg: Destination address required, означает, что пир был найден, но у WireGuard нет для него эндпоинта, так как он не был настроен и еще не был получен динамически.

Теперь рассмотрим входящее направление. UDP-пакет поступает на порт прослушивания. WireGuard находит сессию по индексу получателя в заголовке, расшифровывает и проверяет подлинность полезной нагрузки, а затем сверяет счетчик с «скользящим окном» для защиты от повторов. Только после этого считывается внутренний пакет, и поиск по самому длинному префиксу адреса источника должен идентифицировать аутентифицированного отправителя. Если этого не происходит, пакет отбрасывается. При включенном динамическом отладочном режиме ядро выводит причину в строке вида:

wg0: Packet has unallowed src IP (10.8.0.9) from peer 2 (203.0.113.10:51820)

Именно поэтому пир на стороне сервера получает /32. Пир, настроенный с AllowedIPs = 10.8.0.2/32, может отправлять пакеты только с адреса 10.8.0.2 и ни с какого другого. Укажите там 0.0.0.0/0, и этому клиенту будет разрешено использовать любой IPv4-адрес источника, который выбирается при поиске по самому длинному префиксу, но не адрес, назначенный другому пиру через более специфичный префикс.

Перекрывающиеся префиксы разрешаются по принципу специфичности, так как используется поиск по самому длинному префиксу. Одинаковые префиксы у двух пиров ведут себя иначе: запись переходит к тому пиру, который был настроен последним, а первый пир перестает получать этот трафик без вывода каких-либо ошибок. Команда wg show wg0 allowed-ips выводит таблицу, которая фактически находится в ядре; именно она имеет значение, если файл на диске и текущее состояние системы разошлись.

Чтение конфигурационного файла с учетом маршрутизации через cryptokey

Серверная часть:

[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <server private key>

[Peer]
PublicKey = <laptop public key>
AllowedIPs = 10.8.0.2/32

Клиентская часть:

[Interface]
Address = 10.8.0.2/32
PrivateKey = <laptop private key>

[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

Одно и то же ключевое слово имеет противоположное значение для каждой из сторон. На клиенте оно означает «отправлять все пакеты назначения этому узлу». На сервере оно означает «принимать от этого узла только данный адрес». Асимметрия заключается в значениях, а не в ролях.

Половина этих ключей вообще не относится к протоколу. Address, DNS, MTU, PostUp и SaveConfig принадлежат wg-quick — скрипту оболочки, который поднимает интерфейс. Это не настройки протокола WireGuard; wg-quick обрабатывает их отдельно. wg-quick strip wg0 выводит сокращенную конфигурацию, которую фактически загружает утилита wg; это самый быстрый способ увидеть данное разделение.

Что на самом деле происходит во время рукопожатия

Рукопожатие WireGuard использует протокол Noise_IKpsk2 из состава Noise Protocol Framework. Часть IK наиболее важна для системного администратора: открытый статический ключ отвечающей стороны уже известен инициатору, так как он указан в PublicKey внутри вашего блока [Peer], а инициатор передает свой открытый статический ключ внутри первого сообщения в зашифрованном виде. Таким образом, обмен сертификатами и дополнительные раунды подтверждения личности не требуются. Пассивный наблюдатель не сможет определить, какой именно ключ инициирует соединение, если только у него нет закрытого ключа отвечающей стороны.

Стоимость этого процесса — один раунд обмена данными. Сообщение инициации занимает 148 байт, ответ — 92 байта, после чего сразу начинается передача данных. Каждая сторона генерирует новую эфемерную пару ключей Curve25519 для каждого рукопожатия, а сессионные ключи формируются из цепочки результатов Диффи-Хеллмана, объединяющей статические и эфемерные ключи. Эфемерные закрытые ключи затем удаляются, что обеспечивает совершенную прямую секретность (forward secrecy): если кто-то запишет ваш трафик сегодня и украдет закрытый ключ сервера в следующем году, он все равно не сможет расшифровать записанные данные.

Сообщение инициации рукопожатия содержит метку времени TAI64N, и каждый узел запоминает наибольшую метку времени, полученную от партнера, поэтому повторно отправленные (replayed) сообщения инициации отклоняются. Пакеты данных содержат 64-битный счетчик, используемый в качестве nonce, а получатель поддерживает скользящее окно недавно полученных счетчиков. Это позволяет обрабатывать повторы и сильное нарушение порядка пакетов без необходимости поддерживать состояние соединения, как в TCP.

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

ГрафикWireGuard protocol timers, in seconds
Данные, на которых построен график
[
  {
    "label": "REKEY_TIMEOUT",
    "seconds": 5,
    "notes": "resend a handshake initiation that got no answer, plus up to 333 ms of random jitter"
  },
  {
    "label": "KEEPALIVE_TIMEOUT",
    "seconds": 10,
    "notes": "send a keepalive after receiving data and sending none back"
  },
  {
    "label": "REKEY_ATTEMPT_TIME",
    "seconds": 90,
    "notes": "stop retrying the handshake and drop the packets queued for that peer"
  },
  {
    "label": "REKEY_AFTER_TIME",
    "seconds": 120,
    "notes": "the peer that initiated the current session begins a fresh handshake when it next sends"
  },
  {
    "label": "REJECT_AFTER_TIME",
    "seconds": 180,
    "notes": "the old session key is refused and traffic stops"
  }
]

Это константы из спецификации протокола, а не результаты измерений. Эти 5 таймеров управляют жизненным циклом сессии. Как только сессионному ключу исполняется 120 секунд, узел, инициировавший рукопожатие, запускает новое при следующей отправке данных; отвечающая сторона не инициирует пересоздание ключей по этому таймеру. Через 180 секунд старый ключ полностью перестает приниматься, поэтому передача трафика прекращается до завершения нового рукопожатия. Инициация, на которую не получен ответ, отправляется повторно через 5 секунд плюс случайная задержка до трети секунды, а попытки прекращаются примерно через 90 секунды. Именно поэтому wg show выводит latest handshake как относительное время, и именно поэтому в активном и исправном туннеле это значение остается небольшим. Если время растет при активной отправке трафика, это означает, что рукопожатия завершаются неудачей, а не то, что туннель простаивает.

Почему у узла нет роли клиента или сервера

Оба узла используют идентичный код и одинаковый формат конфигурации. Режима сервера не существует. Асимметрия, которую вы наблюдаете, обусловлена Endpoint, а Endpoint является необязательным параметром.

Узел с настроенным endpoint может инициировать рукопожатие. Узел без него ожидает, а затем узнает адрес и порт другой стороны из первого успешно аутентифицированного пакета. Этот полученный endpoint сохраняется и обновляется при каждом получении корректного пакета с нового адреса. Так работает роуминг: ноутбук, переключающийся с Wi-Fi на мобильную сеть, сохраняет туннель, поскольку сессия идентифицируется по ключу и индексу, а не по IP-адресу. Никаких переподключений не происходит, так как в понимании TCP соединение никогда не устанавливалось.

Этот же механизм создает важный факт: узел с публичным адресом всегда хранит последний известный публичный IP-адрес другой стороны, и wg show выводит его.

Фиксированные примитивы без согласования

В WireGuard отсутствует список наборов шифров. Используются ChaCha20-Poly1305 для аутентифицированного шифрования, Curve25519 для согласования ключей, BLAKE2s для хеширования и HKDF для формирования ключей. Все реализации используют эти алгоритмы, поэтому фаза согласования, которую можно было бы проанализировать, отсутствует, как и возможность понижения уровня безопасности до более слабого варианта. Это осознанный компромисс: если один из примитивов будет скомпрометирован, исправлением станет новая версия всего протокола и обновление на обеих сторонах, а не изменение конфигурации. Такое решение исключает большую часть кода и большинство типов сбоев, характерных для туннелей на базе TLS, к чему, по сути, и сводится сравнение в WireGuard против OpenVPN.

Почему порт не отвечает на сканирование

Сообщения инициализации и ответа рукопожатия содержат поле mac1; ответы с cookie его не содержат. Это MAC (код аутентификации сообщения), вычисленный для сообщения с использованием ключа, производного от статического открытого ключа получателя. Отправитель, не знающий этого открытого ключа, не может создать корректный mac1, поэтому получатель отбрасывает такой пакет без какого-либо ответа. Нет ни ошибки, ни сброса, ни ICMP-сообщения.

Видимый результат — UDP-сканирование, которое не получает ответа.

sudo nmap -sU -p 51820 vpn.example.com

nmap сообщает open|filtered, что является тем же ответом, который он выдает для порта, молча отбрасываемого межсетевым экраном. Нефильтрованный UDP-порт, на котором ничего не запущено, обычно возвращает ICMP-ошибку port-unreachable, которую nmap помечает как closed.

Второе поле, mac2, используется для защиты от атак типа «отказ в обслуживании» (DoS). Когда получатель находится под нагрузкой, он отвечает на инициализацию или ответ с корректным mac1, но без корректного mac2, отправляя 64-байтовый ответ с cookie, привязанным к IP-адресу отправителя. Он отказывается выполнять ресурсоемкие операции с открытыми ключами, пока отправитель не использует этот cookie для вычисления корректного mac2. Это подтверждает доступность IP-адреса отправителя до начала выполнения тяжелых криптографических операций и активируется только при высокой нагрузке.

Почему 0.0.0.0/0 делает пира маршрутом по умолчанию

Поскольку AllowedIPs — это таблица маршрутизации, AllowedIPs = 0.0.0.0/0, ::/0 выбирает этого пира для всех адресов назначения, которые не покрываются более специфичными префиксами, назначенными другим пирам. Это и есть полная настройка полнотуннельного режима.

Механизм маршрутизации, обеспечивающий работу этого режима, интереснее самой строки конфигурации. Обычный маршрут по умолчанию через wg0 привел бы к зацикливанию, так как зашифрованный UDP-пакет с вашим трафиком также должен покинуть машину и попал бы под действие собственного маршрута по умолчанию. wg-quick избегает этого с помощью policy routing. Система помечает исходящие пакеты WireGuard с помощью fwmark, помещает маршрут по умолчанию для туннеля в отдельную таблицу маршрутизации и добавляет правила, согласно которым в эту таблицу попадает только немаркированный трафик. Выполните ip rule show, чтобы увидеть результат:

32764:	from all lookup main suppress_prefixlength 0
32765:	not from all fwmark 0xca6c lookup 51820
32766:	from all lookup main

0xca6c — это 51820 в шестнадцатеричном виде, и 51820 — это также номер таблицы. Правило suppress_prefixlength 0 заставляет основную таблицу игнорировать собственный маршрут по умолчанию, поэтому специфичные маршруты, такие как ваша локальная подсеть, сохраняют приоритет, в то время как весь остальной трафик перенаправляется в таблицу туннеля. Для раздельного туннелирования (split tunnel) это не требуется: более узкий список, такой как AllowedIPs = 10.8.0.0/24, 10.20.0.0/16, становится обычными маршрутами в основной таблице.

Единственное, что не исправляется полнотуннельным режимом автоматически — это разрешение имен, так как DNS-резолвер, полученный клиентом из локальной сети, обычно продолжает использоваться, а маршрут к нему является более специфичным. Это отдельная задача, которая описана в DNS, который утекает за пределы туннеля WireGuard.

Для чего на самом деле нужен PersistentKeepalive

WireGuard ничего не отправляет, если нет трафика. Никаких «сердцебиений» (heartbeats), обновления сессии или чего-либо еще в сети. Эта тишина помогает экономить заряд батареи, помогает в случае сканирования, описанном выше, но нарушает работу одной специфической конфигурации.

Узел, находящийся за NAT (преобразование сетевых адресов) или за stateful-файрволом, доступен извне только до тех пор, пока в этом устройстве существует запись о трансляции, созданная исходящим пакетом. Обычное время жизни UDP-записи начинается примерно с 30 секунд. Как только запись истекает, пакеты из публичной сети отбрасываются промежуточным устройством, и туннель выглядит нерабочим, пока узел за NAT не отправит что-либо сам. PersistentKeepalive = 25 отправляет пустой аутентифицированный пакет, если прошло 25 секунд без передачи каких-либо аутентифицированных пакетов через туннель в любую сторону. Реальный трафик сбрасывает счетчик, поэтому в загруженном туннеле пустой пакет почти никогда не отправляется, а в простаивающем — интервал никогда не превышает минимальное время жизни записи, поэтому соединение остается открытым.

Настраивайте этот параметр на узле, который находится за NAT. Серверу с публичным адресом и открытым UDP-портом он не нужен, и его включение там лишь добавит лишний трафик. Не путайте его с автоматическим keepalive, который срабатывает через 10 секунд после того, как узел получил данные и ему нечего отправить в ответ. Этот механизм включен всегда и не настраивается.

Маршрутизация локальной сети через туннель не является функцией WireGuard

Допустим, узел B находится в домашней сети 192.168.50.0/24, и узел A должен получить к ней доступ. Две независимые системы должны быть согласованы, и только одна из них — WireGuard.

Часть WireGuard: добавьте 192.168.50.0/24 в AllowedIPs узла B на стороне A. Это заставляет A выбирать B для данного префикса и принимать пакеты с этими адресами отправителя от B, за исключением случаев, когда более специфичный префикс указывает на другой узел. Без этого криптографическая маршрутизация не имеет ключа для назначения и разрешения для отправителя.

Часть ядра: на узле B параметр net.ipv4.ip_forward должен быть 1, иначе ядро отбросит каждый расшифрованный пакет, который адресован не самому узлу B. Цепочка forward в межсетевом экране узла B должна разрешать этот трафик. Хосты в локальной сети нуждаются в маршруте обратно к 10.8.0.0/24, либо узел B должен применять source NAT, чтобы ответы возвращались через B.

Задача WireGuard заканчивается в момент передачи расшифрованного пакета ядру. Всё, что происходит после этого — обычная маршрутизация и фильтрация в Linux, поэтому данная проблема отражается в счётчиках nft list ruleset или в ip -s link show wg0, а не в wg show. Если вы предпочитаете управлять узлами через веб-интерфейс, запуск wg-easy в Docker создаст записи узлов за вас, хотя пересылка по-прежнему зависит от ядра хоста и настроек межсетевого экрана. Тот же принцип разделения ответственности сохраняется, когда уровень координации распределяет префикс за вас: анонсирование частной сети с VPS через Tailscale subnet router заменяет ручное редактирование AllowedIPs на каждом узле, но вам всё равно нужно включить IP forwarding на маршрутизаторе; Tailscale по умолчанию управляет собственными правилами межсетевого экрана.

Почему WireGuard работает в ядре

wg0 является драйвером сетевого устройства. Пакеты попадают в него через стандартный стек маршрутизации, шифруются рабочими потоками ядра и покидают его через UDP-сокет, не переходя в пространство пользователя. WireGuard был включен в основную ветку Linux 5.6 в марте 2020 года. Ubuntu 24.04 и Debian 13 поставляются с ним, поэтому отсутствует только пакет wireguard-tools.

Работа в качестве обычного интерфейса имеет практические последствия. tcpdump -ni wg0 показывает внутренние пакеты в открытом виде, тогда как tcpdump -ni eth0 udp port 51820 отображает зашифрованные внешние пакеты; сравнение этих данных позволяет сразу определить, в каком направлении возник сбой. netfilter и инструменты управления трафиком обрабатывают wg0 так же, как любой другой сетевой интерфейс. Там, где модуль ядра недоступен, например, в контейнерной виртуализации, использующей общее ядро хоста, wireguard-go реализует тот же протокол в пространстве пользователя через устройство TUN. Это приводит к реальному снижению пропускной способности, так как каждый пакет дважды пересекает границу ядра.

От чего WireGuard вас не защищает

Модель угроз намеренно ограничена, а скрытность протокола часто порождает ложные ожидания. Сформулируем это прямо.

  • Он не скрывает факт использования WireGuard. Сообщения рукопожатия имеют фиксированный размер, первый байт указывает на тип сообщения, а транспорт осуществляется по UDP. Системы глубокого анализа пакетов (DPI) легко распознают его, и сеть, запрещающая VPN, может его заблокировать. Обфускация была исключена из протокола намеренно.
  • Он не скрывает объем и время передачи данных. Полезная нагрузка дополняется только до границы 16 байт, поэтому наблюдатель всё равно видит, когда вы отправляете данные и в каком примерно объеме.
  • Он хранит последний известный адрес конечной точки. Узел с публичным IP-адресом сохраняет текущий публичный IP другой стороны, и wg show отображает его. Вместе с адресом туннеля, который зафиксирован в конфигурации, это создает стабильный идентификатор, следующий за пользователем при смене сетей. На собственном VPS это допустимо. Именно поэтому коммерческие сервисы добавляют дополнительный уровень поверх протокола.
  • Он аутентифицирует ключ, а не человека. Тот, у кого есть файл закрытого ключа, и является узлом. Храните /etc/wireguard с правами 700, а файлы ключей — с правами 600.
  • В протоколе нет списка отзыва и срока действия ключей. Доступ прекращается только тогда, когда вы удаляете запись об узле с каждого сервера, где она есть, а статические ключи действуют до тех пор, пока вы их не удалите.

Ничто из этого не делает WireGuard слабым. Это делает его компактным, а компактность — главная цель: он аутентифицирует и шифрует, оставляя управление идентификацией и распределение адресов тому, что вы построите поверх него. Уровень координации, описанный в сравнении WireGuard и Tailscale, существует именно для заполнения этого пробела, используя ту же плоскость передачи данных, о которой вы только что прочитали. Как только такой уровень внедрен, следующим решением становится вопрос о том, кто может получить доступ к сервису, запущенному внутри туннеля, что и определяет выбор между Tailscale serve и funnel для конкретного порта.

FAQ

Что такое маршрутизация по криптоключам (cryptokey routing) в WireGuard?

Маршрутизация по криптоключам — это правило, которое привязывает каждый пакет к публичному ключу. Каждая запись об участнике (peer) содержит список префиксов в AllowedIPs. При отправке WireGuard выбирает участника, сопоставляя адрес назначения пакета со списком каждого участника (используется поиск по самому длинному префиксу), поэтому этот список работает как таблица маршрутизации. При получении, после расшифровки и проверки подлинности пакета, выполняется поиск по самому длинному префиксу для внутреннего адреса источника: если выбранный участник не совпадает с тем, от которого пришел пакет, он отбрасывается. Таким образом, список также выполняет роль списка контроля доступа. В WireGuard нет отдельной конфигурации маршрутизации или внутреннего межсетевого экрана, так как этот единственный список выполняет обе задачи.

Нужно ли настраивать PersistentKeepalive на обоих участниках?

Нет. Настройте этот параметр на стороне, находящейся за NAT (network address translation) или за stateful-файрволом, что обычно соответствует клиенту. WireGuard не передает данные в режиме простоя, поэтому трансляция адресов, позволяющая удаленной стороне связаться с участником, истекает (часто в течение минуты), и туннель начинает выглядеть нерабочим в одном направлении. PersistentKeepalive = 25 отправляет пустой аутентифицированный пакет, если в течение 25 секунд не было передано или получено аутентифицированного трафика, что поддерживает активность трансляции. Участнику с публичным IP-адресом и открытым UDP-портом этот параметр не требуется.

Почему ping через туннель выдает ошибку "Required key not available"?

Потому что адрес назначения не входит ни в один список AllowedIPs ни одного из участников. Маршрутизация по криптоключам не нашла ключ для шифрования пакета, и ядро отказалось его отправлять. Выполните wg show wg0 allowed-ips и сравните вывод с адресом, который вы пытаетесь пропинговать. Похожая ошибка Destination address required указывает на другую проблему: участник найден, но у WireGuard нет для него конечной точки (endpoint), так как она не была настроена, а аутентифицированный пакет от этого участника еще не поступал.

Может ли межсетевой экран обнаружить и заблокировать WireGuard?

Да. WireGuard аутентифицирует и шифрует трафик, не пытаясь его скрыть. Сообщения инициализации и ответа рукопожатия имеют фиксированный размер 148 и 92 байта соответственно, ответы с cookie — 64 байта, первый байт каждого сообщения определяет его тип, а транспортным протоколом является UDP. Поэтому системы глубокого анализа пакетов (DPI) легко идентифицируют этот протокол. Сети, блокирующие UDP или выполняющие сигнатурный анализ протоколов, смогут его остановить. Чтобы скрыть туннель, его необходимо инкапсулировать в другой протокол, что реализуется сторонними инструментами, а не настройками самого WireGuard.

Была ли эта статья полезной?