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

Как создать конфиг WireGuard и QR-код для нового клиента

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

Рабочий конфиг WireGuard создаётся из данных двух сторон: ключей клиента, публичного ключа сервера, адреса клиента, Endpoint и нужных сетей. Генератор файла не поднимает сервер. Сначала зарегистрируйте публичный ключ клиента на своём сервере, затем сохраните профиль .conf и импортируйте его на устройство.

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

От данных сервера к готовому профилю

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

Файл ещё не даст доступ

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

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

Сначала определить адрес и право доступа

Пример ниже предназначен для уже работающего собственного сервера. Его 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/0Forwarding, 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; доступ к удалённой локальной сети.