AmneziaWG 3.1 и 3.0 на своём сервере: что ставится и как вернуться на 2.0

Короткий ответ: с версии 6.0.0 новая установка ставит AmneziaWG 3.1, где поверх обфускации 2.0 добавлены шифрование заголовков и добавочный паддинг. На ARM и на ядре старше 6.7 установщик сам ставит 2.0, а для роутеров и старых приложений 2.0 выбирается одним флагом. Уже работающий сервер остаётся на своей версии.

Посмотрите, что стоит на сервере

Два разных вопроса с разными ответами: какой профиль сервер выдаёт клиентам и какая линия модуля работает в ядре. Конфигурацию VPN ни одна из них не меняет; manage show только пишет в свой лог.

Какой профиль выдаёт сервер, 3.1 или 2.0:

sudo bash /root/awg/manage_amneziawg.sh show   # строка «Поколение протокола установки»
grep AWG_PROTOCOL /root/awg/awgsetup_cfg.init   # тот же маркер напрямую

Поколение установщик называет и в итоговом отчёте. Сервер, поставленный до версии 6.0.0, работает на профиле 2.0: его маркер AWG_PROTOCOL равен 2.0 или отсутствует, а отсутствующий маркер читается как 2.0. У сервера 3.1 в секции [Interface] файла awg0.conf есть HeaderProtectionKey.

Какие модуль и утилиты работают на сервере:

cat /sys/module/amneziawg/version   # версия загруженного модуля
awg --version                      # версия утилит

Первая команда читает атрибут version модуля, который работает в ядре прямо сейчас, а не файла на диске. Если модуль не загружен, вывода не будет - тогда modinfo amneziawg | grep ^version покажет, что лежит на диске. Почему не modinfo сразу: если на хосте оказались два дерева модуля с одним именем, а на ARM так бывает, он назовёт не тот.

⚠️ Версия apt-пакета на этот вопрос не отвечает. dpkg -l amneziawg-dkms показывает строку, начинающуюся с 1.0.0, - это версия упаковки, а не протокола. Спрашивайте сам модуль командой выше.

Что получает новая установка

Без --protocol установщик решает по архитектуре и работающему ядру.

Ваш серверПрофиль для клиентовМодуль ядра
x86_64, ядро 6.7 или новее3.1третья линия из PPA команды Amnezia
Ядро старше 6.7 (штатный Debian 12 с 6.1)2.0, автоматическизакреплённый модуль 2.0, собранный из исходника, тег v1.0.20260725
ARM64 или armhf, есть готовая сборка под ваше ядро2.0, автоматическиготовый пакет проекта, закреплённый на том же теге 2.0
ARM64 или armhf, готовой сборки нет, ядро 6.7 или новее2.0, автоматически: ARM для 3.1 не замерялсятретья линия из PPA

Модуль третьей линии для 3.1 нужен, но его мало. После перезагрузок установщик проверяет ещё утилиты awg и загруженный модуль: применяет профиль к временному интерфейсу и читает его обратно. Если они третью линию не понимают, он сам переходит на 2.0 до создания ключей, при условии что набор 2.0 проходит ту же проверку, и объясняет причину в логе и в итоговом отчёте; если модуль отвергает и его, установка останавливается, не трогая файл настроек. Явный --protocol=3.1 на такой машине останавливает установку и называет причину.

На ядрах старше 6.7 модуль 2.0 выбран сознательно. Третья линия там сегодня собирается, но именно на старых ядрах у неё меньше всего обкатки, а закреплённый модуль проверен на неизменяемом коммите. Обновлений закреплённый путь не получает: апстрим заморозил линию 1.0.x. Таблица по системам с кодами причин - в ADVANCED.md.

Переход между 3.1 и 2.0

Поколение выбирается при установке. Обновления его не меняют, поэтому для перехода нужна переустановка.

Уже работающий сервер

Обновление скриптов и --force сохраняют его поколение, как и повседневное управление клиентами: сервер 2.0 остаётся на 2.0, а выданные конфиги продолжают работать. Сменить его может только manage restore бэкапа, снятого на другом поколении, и он сначала предупредит. Модуль ядра - отдельная история: на пути PPA новые сборки приходят с apt upgrade, а закреплённый модуль 2.0 не меняется.

Переход на 3.1

Сначала --uninstall, затем новая установка: она получит 3.1, если машина подходит (x86_64, ядро 6.7 или новее; на Debian 12 это ядро из backports). Каждому клиенту нужен новый профиль и приложение с поддержкой 3.1. На ARM профиль 3.1 пока не выдаётся.

Назад на 2.0

Так же, только в обратную сторону: --uninstall (он удаляет сервер и его профили 3.1 и по умолчанию пытается сохранить архив-бэкап; проверьте, что он создан), затем установка с --protocol=2.0 и новые профили для всех клиентов. Если среди устройств есть роутер или старое приложение, выберите 2.0 до установки: это дешевле, чем переходить потом.

🔴 Одно, о чём стоит знать владельцам ARM: линия модуля может смениться сама после перезагрузки. Если рядом с готовым модулем оказался пакет amneziawg-dkms, то при появлении заголовков ядра DKMS собирает свой модуль, вытесняет файл готовой сборки, и после перезагрузки загружается уже он. Туннель при этом не падает, а dpkg по-прежнему показывает готовый пакет установленным. Установщик предупреждает об этом и даёт точные команды, как удалить пакет DKMS и вернуть его под hold; если остановиться после удаления, у нового ядра может не оказаться рабочего модуля. Проверить версию после перезагрузки в любом случае полезно.

Что происходит с конфигами клиентов

Конфиги уже работающего сервера продолжают работать без единой правки: обновление установщика поколение не трогает. Новая установка 3.1 выдаёт профили 3.1. От 2.0 они отличаются в четырёх местах: HeaderProtectionKey (один случайный ключ на установку, общий для сервера и всех его клиентов), ContentPaddingAddition = 32-128, H1-H4 равны 1-4, а S3/S4 начинаются с 12. Мусорные пакеты Jc, Jmin, Jmax, S1/S2 и маскирующий пакет I1 остаются прежними.

Приложение без поддержки 3.1 профиль 3.1 не примет: рукопожатия нет, и сообщения об ошибке часто тоже нет. В эту группу входят роутеры, чья прошивка ещё не поддерживает 3.1 (например, стабильная KeeneticOS), Hiddify и давно не обновлявшиеся приложения. Какие клиенты понимают 3.1 и с какой версии - в таблице клиентов. Какое приложение взять: на Android WG Tunnel или AmneziaWG, на iPhone, Mac и Windows AmneziaWG (почему).

Почему H1-H4 равны 1-4: ключ шифрует заголовок, поэтому тип сообщения на проводе не виден при любом H, и случайные диапазоны ничего не добавляют. Из ключа следуют две вещи. Сменить его - значит перевыпустить профили всех клиентов. И он обязан совпадать на обеих сторонах: клиент без ключа или с другим ключом рукопожатие не пройдёт. У сервера, поставленного на 2.0, ключа нет вовсе, и если дописать его руками на одной стороне, эта сторона отрежет себя от другой.

Что добавила третья линия и что включает профиль 3.1

Коротко, без побайтовых подробностей. Полный разбор - в расширенной документации.

Что добавилосьЗачем этоВ профиле 3.1
Шифрование заголовков (HeaderProtectionKey)Поля, которые во второй линии шли открыто, перестают быть готовой структурой для наблюдателя. Собственную криптографию WireGuard это не трогает. Обязано совпадать на обеих сторонах.включено
Добавочный паддинг внутри зашифрованной части (ContentPaddingAddition)Задаётся диапазоном, длина берётся из него случайно, и предсказуемое выравнивание длин пакетов размывается. Совпадать у сторон не обязан.включено, 32-128
Тайминги диапазонамиИнтервалы перевыпуска ключей, рукопожатия и keepalive берутся из диапазона при каждом использовании, а не фиксированы. Действуют только на той стороне, где заданы.выключено
RandomTrailers, DisableCookies (3.1)Первый обязан совпадать на обеих сторонах и вместе с остальной обфускацией режет скорость в разы. Второй вместе с сигнатурой cookie-ответа убирает и защиту от флуда рукопожатиями.выключено, в конфиге нет даже строки off

Пока ничего из этого не задано, движок третьей линии кладёт на провод тот же формат, что и вторая, поэтому конфиги 2.0 продолжают работать на модуле третьей линии. Замеры и доводы по каждому выбору - в разделе про профиль 3.1 в ADVANCED.md.

Частые вопросы

Какая версия AmneziaWG ставится на сервер сейчас?
С версии 6.0.0 новая установка ставит AmneziaWG 3.1 на x86_64 с ядром 6.7 или новее: шифрование заголовков (HeaderProtectionKey) и добавочный паддинг поверх обфускации 2.0. На ядре старше 6.7, например на штатном Debian 12 с 6.1, и на ARM установщик сам ставит 2.0 и объясняет причину. Так же он переходит на 2.0, если установленные утилиты awg или загруженный модуль не понимают третью линию, при условии что набор 2.0 проходит проверку; иначе останавливается и называет причину. --protocol=2.0 даёт новой установке профиль 2.0 на любой поддерживаемой системе.
Как узнать, какая версия AmneziaWG стоит на моём сервере?
Профиль, который выдаёт сервер, покажет sudo bash /root/awg/manage_amneziawg.sh show: в нём есть строка о поколении протокола установки, 3.1 или 2.0. Тот же маркер - AWG_PROTOCOL в /root/awg/awgsetup_cfg.init. Модуль покажет cat /sys/module/amneziawg/version - она читает модуль, загруженный в ядро, а не файл на диске; утилиты - awg --version. modinfo для этого не годится: если на хосте два дерева модуля с одним именем, он может назвать не тот, что работает.
Нужно ли переводить работающий сервер на 3.1?
Ничто к этому не вынуждает. Работающий сервер сохраняет поколение при обновлении скриптов, --force и повседневном управлении клиентами, и его клиенты продолжают работать. Чтобы перейти на 3.1, нужен --uninstall и новая установка на подходящей машине (x86_64, ядро 6.7 или новее), а затем новые профили для всех клиентов в приложениях с поддержкой 3.1. Если среди ваших устройств есть роутеры без поддержки 3.1, Hiddify или старые приложения, правильнее остаться на 2.0.
Старые конфиги клиентов перестанут работать?
Нет, из-за обновления не перестанут: установщик сохраняет поколение работающего сервера, и выданные конфиги работают без единой правки. Перестают они только тогда, когда вы меняете сам сервер: переустановка на другое поколение или переустановка с --preset, --jc, --jmin или --jmax. Тогда установщик заново генерирует набор обфускации и предупреждает, что выданные конфиги придётся заменить. Один --no-cps только убирает I1 и оставляет остальное, хотя установщик всё равно предложит перевыпустить профили, в которых есть I1.
Чем третья линия AmneziaWG отличается от второй?
Главное отличие - шифрование заголовков пакетов в тех полях, что во второй линии шли открыто. Добавились ещё добавочный паддинг внутри зашифрованной части и тайминги диапазоном, значение из которого берётся случайно при каждом использовании. Каждая возможность задаётся отдельно, и пока ни одна не задана, движок третьей линии кладёт на провод тот же формат, что и вторая. Профиль 3.1 включает первые две; тайминги, RandomTrailers и DisableCookies остаются выключенными.
Почему в моём конфиге нет HeaderProtectionKey?
Потому что сервер работает на профиле 2.0: он поставлен до версии 6.0.0, с --protocol=2.0 или на ARM либо ядре старше 6.7, где установщик ставит 2.0. Ключ задаётся на весь сервер и обязан совпадать на обеих сторонах: клиент без него или с другим ключом рукопожатие не пройдёт. Поэтому дописать его одному клиенту или одному серверу нельзя. Перевести сервер на 3.1 - это --uninstall, новая установка и новые профили для всех клиентов.
Может ли версия модуля смениться сама после перезагрузки?
На ARM линия модуля может. Если рядом с готовым модулем оказался пакет amneziawg-dkms, то при появлении заголовков ядра DKMS собирает свой модуль, вытесняет файл готовой сборки, и после перезагрузки загружается уже он. Туннель при этом не падает, а dpkg по-прежнему показывает готовый пакет установленным. Установщик предупреждает об этом и даёт точные команды, как удалить пакет DKMS и вернуть его под hold. Профиль, который выдаёт сервер, при этом не меняется: смена модуля его не трогает.
Почему на Debian 12 ставится 2.0, а не 3.1?
Это осознанное решение, а не техническое ограничение. Штатное ядро 6.1 старше 6.7, поэтому установщик собирает закреплённый модуль 2.0 и выдаёт профиль 2.0. Третья линия на ядре 6.1 сегодня собирается, но именно на старых ядрах у неё меньше всего обкатки, а закреплённый модуль проверен на неизменяемом коммите. С ядром 6.7 или новее из backports новая установка на Debian 12 может получить 3.1, если модуль и утилиты пройдут проверку установщика.

Куда смотреть дальше

Разбор параметров

Что меняется на проводе, какие параметры добавились и что обязано совпадать у сервера и клиента - в ADVANCED.md.

Установка с нуля

Пошаговый гайд по развёртыванию на чистом VPS - в INSTALL_VPS.ru.md. Модуль и профиль установщик выберет сам.

Управление клиентами

Как заводить, удалять и перевыпускать клиентов после установки - на странице управления клиентами.