AmneziaWG на Linux: модуль ядра, awg-quick и файл конфигурации
Опубликовано 15.11.2026
На Linux AmneziaWG можно поднять как системный туннель: установить совместимую реализацию, сохранить native .conf и применить его через awg-quick. Для Ubuntu есть официальный PPA. Утилита awg показывает состояние peer, а адреса, маршруты и DNS применяет awg-quick.
Практический помощник
Подсказка: AmneziaWG на Linux
Выберите свою ситуацию: помощник покажет следующий шаг. Данные доступа вводить не нужно.
Установка из PPA
Проверьте Candidate пакета, установите amneziawg и подтвердите модуль через modinfo.
Выбрать графический клиент или системный туннель
Для подключения без обслуживания ядра подходит основной AmneziaVPN для Linux. Эта статья посвящена другому пути: системному интерфейсу AmneziaWG с утилитами awg и awg-quick. Отдельного Windows MSI или Android APK для Linux не используют.
| Компонент | Что делает |
|---|---|
| Модуль amneziawg | Передаёт пакеты через реализацию в ядре. Должен собраться под текущее ядро. |
| amneziawg-go | Реализация в пользовательском пространстве; требует TUN и отдельной сетевой настройки. |
| awg | Показывает и задаёт параметры peer. |
| awg-quick | Применяет адреса, маршруты и DNS из .conf. |
Модуль .ko от чужого компьютера не считается переносимым пакетом. После обновления ядра DKMS должен собрать совместимый модуль заново. Наличие команды awg ещё не означает, что модуль загрузился.
Установка на Ubuntu и проверка модуля
Для Ubuntu официальная инструкция использует PPA amnezia/ppa. Сначала установите software-properties-common, python3-launchpadlib, gnupg2 и linux-headers для запущенного ядра. Если перед этим обновилось ядро, загрузитесь в новое ядро до сборки модуля.
- Добавьте PPA amnezia/ppa штатной командой add-apt-repository и обновите индекс пакетов.
- Проверьте
apt-cache policy amneziawg. При Candidate: (none) пакет недоступен для текущей конфигурации источников: установка не исправляется многократным повтором. - Установите пакет amneziawg штатным apt. Затем проверьте
modinfo amneziawgи наличие awg/awg-quick. - Если модуль не найден, сравните ядро, установленные headers и результат DKMS. При Secure Boot учитывайте необходимость доверенной подписи модуля по правилам дистрибутива.
На Debian официальная инструкция содержит отдельную схему подключения репозитория. Это не разрешение добавлять любой Ubuntu PPA в любую Debian-производную. Для Mint, Arch, Alpine и SteamOS готовые команды Ubuntu без проверки пакетной базы не подходят; если нужен простой пользовательский VPN, выбирайте подтверждённый клиент для своей системы.
Файл настройки, запуск и проверка
Получите отдельный native .conf для Linux-клиента. Проверьте, что версия установленной реализации понимает все поля AWG сервера. Профиль хранит PrivateKey, поэтому доступ к нему должен быть только у администратора: каталог /etc/amnezia/amneziawg с ограниченными правами, файл например home.conf с правами 600.
Проверенный awg-quick ищет профиль по короткому имени в /etc/amnezia/amneziawg/home.conf. Имя интерфейса ограничено 15 допустимыми символами; используйте простое home или awg0. Путь /etc/wireguard из обычной инструкции WireGuard нельзя подставлять автоматически.
- Перед запуском проверьте Address, DNS, Endpoint, AllowedIPs и все AWG-параметры. Не меняйте выданные ключи.
- Поднимите профиль через
sudo awg-quick up home. При ошибке сохраните конкретную строку, не добавляя автозапуск. - Посмотрите
sudo awg show home, откройте ресурс из AllowedIPs и снова проверьте handshake и обмен. - Для остановки используйте
sudo awg-quick down home, затем проверьте восстановление обычного маршрута.
Если файл содержит DNS, эта реализация awg-quick вызывает resolvconf. Ошибка «command not found» относится к системной интеграции DNS, а не к ключам сервера. Не удаляйте DNS из файла без понимания, какой резолвер будет обслуживать туннель.
Userspace и диагностика после обновления ядра
AmneziaWG-Go собирается из официального репозитория amnezia-vpn/amneziawg-go средствами Go и make. После установки проверьте версию. Создание интерфейса командой amneziawg-go само по себе не назначает IP, маршруты и DNS; использовать его как «VPN уже готов» нельзя.
В awg-quick предусмотрен переход к userspace-реализации при отсутствии модуля. Предупреждение AmneziaWG-Go о возможности ядровой версии само по себе не доказывает ошибку запуска. Смотрите фактическое наличие интерфейса и вывод awg.
Автозапуск включайте только после успешного ручного запуска и остановки, через поставляемый вашей сборкой сервис. Название юнита и наличие шаблона сначала проверьте в пакете. Самодельный сервис поверх уже включённого GUI-клиента может создать конкурирующие маршруты.
Как получить профиль, разобрано в материале о конфигурациях Amnezia. Для нулевого приёма, неизвестного H1 и неработающего DNS используйте дерево ошибок AmneziaWG.
