WireGuard invalid h1 value: причина и решение

При настройке WireGuard пользователи иногда сталкиваются с сообщением invalid h1 value при запуске интерфейса. Эта ошибка ставит в тупик, потому что параметр h1 отсутствует в официальной документации. На самом деле проблема не в WireGuard, а в конфигурационном файле: чаще всего это опечатка или неправильно записанное поле. Разберём, что означает сообщение, почему оно появляется и как быстро восстановить работоспособность туннеля.

Что означает ошибка «invalid h1 value»

WireGuard использует простой текстовый формат конфигурации. Каждая непустая строка должна начинаться с известного ключа (например, Address, PrivateKey, PublicKey, AllowedIPs). Если парсер встречает строку, которая начинается с нераспознанного токена — например, h1 — он выдаёт сообщение вида invalid [ключ] value. То есть «недопустимое значение для h1». Практически всегда это значит, что вы неверно написали какой-то параметр или вставили мусорную строку в файл .conf.

Например, при ручном редактировании можно случайно заменить Address на h1 из-за невнимательности или при копировании из wiki с другим синтаксисом. Также ошибка появляется, если в начале строки есть лишний пробел или символ перевода строки — парсер считает такой отступ частью ключа.

Частые причины появления ошибки

• Опечатка в названии ключа. Самая распространённая ситуация. Вместо Address написано h1, вместо PrivateKey — pr1 и т.д. Синтаксис WireGuard чувствителен к регистру.
• Лишний пробел перед ключом. Парсер не игнорирует начальные пробелы. Строка Address = 10.0.0.1 будет воспринята как ключ с пробелом — и снова ошибка.
• Неправильное значение. Даже если ключ написан верно, значение может не соответствовать формату. Например, Address = 10.0.0.1 без /24 (для IP-адреса) или AllowedIPs = 0.0.0.0 без длины префикса.
• Редактирование в Windows-редакторе. Символы переноса строки CRLF могут вызвать сбой парсинга, если конфиг читается в Linux-окружении.

Как исправить ошибку: пошаговая диагностика

1. Откройте конфигурационный файл. Обычно он находится в /etc/wireguard/ (Linux) или в папке %ProgramFiles%\WireGuard\Data\Configurations (Windows). Команда для просмотра: sudo cat /etc/wireguard/*.conf.
2. Проверьте каждую строку. Убедитесь, что все параметры внутри секций [Interface] и [Peer] соответствуют списку допустимых: PrivateKey, ListenPort, Address, DNS, MTU; для пиров — PublicKey, PresharedKey, AllowedIPs, Endpoint, PersistentKeepalive.
3. Удалите посторонние строки. Если в файле есть пустые строки или строки, не начинающиеся с #, [ или допустимого ключа, удалите их. Например, случайно вставленный текст h1 нужно стереть.
4. Проверьте формат значений. Для адресов используйте CIDR-нотацию (например, 192.168.4.1/24). Ключи должны быть закодированы в base64. После исправлений сохраните файл.
5. Протестируйте конфигурацию. Запустите sudo wg-quick strip wg0 — команда покажет обработанный конфиг без комментариев. Если она выдаёт ошибку, вы увидите точную строку. Затем запустите интерфейс: sudo wg-quick up wg0.

Пример правильного файла:

[Interface]
PrivateKey = aBcD...=
Address = 10.0.0.1/24

[Peer]
PublicKey = XyZ...=
AllowedIPs = 10.0.0.0/24

Неправильно: h1 = 10.0.0.1 — парсер не знает такого ключа.

Профилактика и рекомендации

Чтобы избежать ошибки в будущем, используйте официальный генератор конфигураций из клиента WireGuard или программы-мастера (например, wg-quick в интерактивном режиме). Если редактируете вручную, включите отображение скрытых символов в текстовом редакторе и используйте UTF-8 без BOM. Для Linux убедитесь, что файл имеет права 600 и принадлежит root — права доступа не влияют на парсинг, но это хорошая практика.

Помните, что в разных версиях WireGuard набор допустимых ключей может меняться. Проверьте для своей версии список параметров в официальной документации. Если вы используете сторонний GUI (например, TunSafe или мобильные приложения), сверьтесь с инструкцией: в некоторых из них параметр называется иначе, но ошибка всё равно появляется из-за несоответствия ключей.