Ключи WireGuard: генерация, обмен и замена без путаницы
Опубликовано 02.11.2026
У каждого участника WireGuard своя пара ключей: приватный остаётся на устройстве, публичный передают другой стороне. Для доступа нужен зарегистрированный на сервере публичный ключ клиента. Дополнительный PresharedKey необязателен, но при его использовании значение должно совпадать у обоих участников.
Практический помощник
Какой ключ нужен в вашей ситуации
Помощник показывает действие по вашей ситуации. Он не подключается к серверу и не запрашивает ключи.
Создайте пару на клиенте
Сгенерируйте private/public локально. Передайте серверу public и получите адрес, Endpoint и серверный public.
Создать пару ключей локально
На 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 не заменяет публичный ключ и не является одноразовым кодом входа.
Заменить ключ или отозвать доступ
- Создайте новую пару на том устройстве, чей приватный ключ раскрыт. Сохраните новый профиль под отдельным именем.
- Администратор сервера добавляет новый публичный ключ с согласованным адресом клиента. Не оставляйте два активных peer с одинаковым AllowedIPs: переключайте запись согласованно.
- Подключите новый профиль и запросите разрешённый ресурс. На сервере проверьте wg show wg0: свежий handshake и рост transfer.
- Удалите старый peer из текущего интерфейса и постоянной конфигурации. При изменении серверного ключа новый публичный ключ придётся раздать всем клиентам.
Приватный ключ нельзя восстановить из публичного. Если утерян единственный файл профиля, безопасный путь — новая пара и замена записи сервера. Удаление приложения на телефоне не отзывает серверную запись. Не публикуйте вывод wg showconf или wg show all dump: он может содержать секретные значения.
По следующему шагу: собрать полный профиль WireGuard; настроить сервер Ubuntu.
