Как создать конфиг WireGuard и QR-код для нового клиента
Опубликовано 02.11.2026
Рабочий конфиг WireGuard создаётся из данных двух сторон: ключей клиента, публичного ключа сервера, адреса клиента, Endpoint и нужных сетей. Генератор файла не поднимает сервер. Сначала зарегистрируйте публичный ключ клиента на своём сервере, затем сохраните профиль .conf и импортируйте его на устройство.
Практический помощник
От данных сервера к готовому профилю
Помощник показывает действие по вашей ситуации. Он не подключается к серверу и не запрашивает ключи.
Файл ещё не даст доступ
Сначала получите разрешённые параметры от администратора или разверните сервер. Случайные ключи не подключаются к чужому Endpoint.
Сначала определить адрес и право доступа
Пример ниже предназначен для уже работающего собственного сервера. Его VPN-адрес — 10.77.0.1, новый клиент получит 10.77.0.2/32. Убедитесь, что эти адреса не заняты и не совпадают с локальной сетью устройства. SERVER_HOST — публичный IP или домен сервера, 51820 — выбранный UDP-порт, а не обязательное значение протокола.
Сгенерируйте отдельную пару ключей для каждого устройства. Android умеет создавать туннель вручную, но это лишь создаёт локальную конфигурацию: сервер всё равно должен получить публичный ключ телефона. Для нескольких клиентов ведите список «устройство — публичный ключ — VPN-адрес». Копия одного профиля на два активных устройства может заставлять сервер постоянно менять endpoint одного peer.
Собрать клиентский .conf
[Interface]
PrivateKey = CLIENT_PRIVATE_KEY
Address = 10.77.0.2/32
[Peer]
PublicKey = SERVER_PUBLIC_KEY
Endpoint = SERVER_HOST:51820
AllowedIPs = 10.77.0.1/32
PersistentKeepalive = 25Все строки с заглавными именами замените реальными значениями, полученными для вашего сервера. Это минимальный доступ к одному адресу VPN-сервера. Keepalive 25 нужен клиенту за NAT, если связь должна сохраняться после простоя; без этой задачи строку можно убрать. DNS здесь намеренно не задан: пример не меняет DNS и не направляет весь интернет в VPN.
| Задача | AllowedIPs клиента | Что ещё необходимо |
|---|---|---|
| Только сервер | 10.77.0.1/32 | Сервис слушает VPN-адрес и разрешён firewall |
| Удалённая сеть | 10.77.0.1/32, 192.168.50.0/24 | Маршрутизация сервера, обратный путь и разрешение доступа |
| Весь IPv4-интернет | 0.0.0.0/0 | Forwarding, NAT или маршрутизируемая сеть на сервере, доступный DNS |
Добавление ::/0 означает отдельную задачу для IPv6. Не обещайте полный туннель, пока не настроен и не проверен IPv6. В редакторе сохраняйте обычный текст с расширением .conf, например phone.conf, без дополнительного .txt.
Добавить соответствующий peer на сервере
[Peer]
PublicKey = CLIENT_PUBLIC_KEY
AllowedIPs = 10.77.0.2/32Эта секция добавляется в серверный конфиг, а не в файл телефона. Для сервера с wg-quick это обычно /etc/wireguard/wg0.conf. Перед изменением сохраните закрытую резервную копию. Примените изменение используемым менеджером; перезапуск wg-quick@wg0 на короткое время разрывает все туннели интерфейса. Не правьте один интерфейс одновременно через NetworkManager и wg-quick.
Следующий клиент получит свою пару и, например, 10.77.0.3/32. На сервере каждому соответствует отдельная секция Peer. Сохраняйте записи на диске: добавление только через wg set без сохранения менеджером может исчезнуть после перезагрузки.
Сделать QR-код без отправки секрета на сайт
QR содержит весь профиль, включая PrivateKey. На Linux утилита qrencode может показать его прямо в локальном терминале:
qrencode -t ansiutf8 < phone.confОтсканируйте код в приложении WireGuard через добавление туннеля по QR. Не делайте это в терминале с общедоступной записью сеанса. В RouterOS экспорт show-client-config тоже способен выдавать QR, но только если у peer подготовлены клиентские поля и ключ; доступные поля и AllowedIPs зависят от версии RouterOS. Универсальный локальный путь — QR из уже проверенного .conf.
После импорта обратитесь к 10.77.0.1 и проверьте handshake и счётчики. Если handshake нет, сравните ключи и UDP Endpoint. Если handshake есть, но ресурс не отвечает, проверьте адрес сервиса, AllowedIPs и firewall. Генерация нового QR не меняет серверные маршруты и не продлевает чужой доступ.
По следующему шагу: генерация ключей WireGuard; доступ к удалённой локальной сети.
