Автофайлы: в помощь автовладельцу » Программы » Настройка сети » Ключи WireGuard: генерация, обмен и замена без путаницы

Ключи WireGuard: генерация, обмен и замена без путаницы

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

У каждого участника WireGuard своя пара ключей: приватный остаётся на устройстве, публичный передают другой стороне. Для доступа нужен зарегистрированный на сервере публичный ключ клиента. Дополнительный PresharedKey необязателен, но при его использовании значение должно совпадать у обоих участников.

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

Какой ключ нужен в вашей ситуации

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

Создайте пару на клиенте

Сгенерируйте private/public локально. Передайте серверу public и получите адрес, Endpoint и серверный public.

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

Создать пару ключей локально

На Linux с установленным wireguard-tools откройте отдельную закрытую папку. Эти команды создают файлы, поэтому не запускайте их поверх уже работающего private.key: перенаправление перезапишет прежний ключ.

umask 077
wg genkey > private.key
wg pubkey < private.key > public.key

Первая команда ограничивает права новых файлов. Вторая получает случайный приватный ключ, третья вычисляет соответствующий публичный. Для нового телефона можно создать пустой туннель в приложении WireGuard: приложение сгенерирует пару само. Передайте администратору только поле Public key. Онлайн-генератору пришлось бы доверить материал, которым подтверждается ваш доступ; для этой задачи достаточно локального инструмента.

Какие ключи куда записать

Ключи при подключении телефона к серверу
ПолеНа телефонеНа сервере
Interface / PrivateKeyПриватный ключ телефонаПриватный ключ сервера
Peer / PublicKeyПубличный ключ сервераПубличный ключ телефона
Peer / PresharedKeyОбщий секрет этой пары, если заданТот же общий секрет

Публичный ключ из собственной секции Interface не нужно переносить в собственную секцию Peer. Peer всегда описывает другую сторону. Ключ не является адресом сервера: отдельно нужны Endpoint, внутренний Address и AllowedIPs. Даже правильно сгенерированная пара не предоставит доступ, пока администратор не добавит клиента на сервере.

Добавить PresharedKey и не потерять соединение

PresharedKey добавляет общий симметричный секрет поверх пары публичного и приватного ключей. Создайте его локально командой ниже и безопасно перенесите одинаковое значение в секцию Peer на обоих концах. Для каждого клиента используйте отдельный PSK. Не вставляйте содержимое в общий чат или команду, которая попадёт в журнал shell.

umask 077
wg genpsk > peer.psk

Пустое поле с обеих сторон допустимо. Если одна сторона использует PSK, а другая нет, успешного handshake не будет. Сам по себе PSK не заменяет публичный ключ и не является одноразовым кодом входа.

Заменить ключ или отозвать доступ

  1. Создайте новую пару на том устройстве, чей приватный ключ раскрыт. Сохраните новый профиль под отдельным именем.
  2. Администратор сервера добавляет новый публичный ключ с согласованным адресом клиента. Не оставляйте два активных peer с одинаковым AllowedIPs: переключайте запись согласованно.
  3. Подключите новый профиль и запросите разрешённый ресурс. На сервере проверьте wg show wg0: свежий handshake и рост transfer.
  4. Удалите старый peer из текущего интерфейса и постоянной конфигурации. При изменении серверного ключа новый публичный ключ придётся раздать всем клиентам.

Приватный ключ нельзя восстановить из публичного. Если утерян единственный файл профиля, безопасный путь — новая пара и замена записи сервера. Удаление приложения на телефоне не отзывает серверную запись. Не публикуйте вывод wg showconf или wg show all dump: он может содержать секретные значения.

По следующему шагу: собрать полный профиль WireGuard; настроить сервер Ubuntu.