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 ставится на сервер сейчас?
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 отличается от второй?
RandomTrailers и DisableCookies остаются выключенными.Почему в моём конфиге нет HeaderProtectionKey?
--protocol=2.0 или на ARM либо ядре старше 6.7, где установщик ставит 2.0. Ключ задаётся на весь сервер и обязан совпадать на обеих сторонах: клиент без него или с другим ключом рукопожатие не пройдёт. Поэтому дописать его одному клиенту или одному серверу нельзя. Перевести сервер на 3.1 - это --uninstall, новая установка и новые профили для всех клиентов.Может ли версия модуля смениться сама после перезагрузки?
amneziawg-dkms, то при появлении заголовков ядра DKMS собирает свой модуль, вытесняет файл готовой сборки, и после перезагрузки загружается уже он. Туннель при этом не падает, а dpkg по-прежнему показывает готовый пакет установленным. Установщик предупреждает об этом и даёт точные команды, как удалить пакет DKMS и вернуть его под hold. Профиль, который выдаёт сервер, при этом не меняется: смена модуля его не трогает.Почему на Debian 12 ставится 2.0, а не 3.1?
Куда смотреть дальше
Разбор параметров
Что меняется на проводе, какие параметры добавились и что обязано совпадать у сервера и клиента - в ADVANCED.md.
Установка с нуля
Пошаговый гайд по развёртыванию на чистом VPS - в INSTALL_VPS.ru.md. Модуль и профиль установщик выберет сам.
Управление клиентами
Как заводить, удалять и перевыпускать клиентов после установки - на странице управления клиентами.