Автофайлы: в помощь автовладельцу » Программы » Настройка сети » AmneziaWG на Linux: модуль ядра, awg-quick и файл конфигурации

AmneziaWG на Linux: модуль ядра, awg-quick и файл конфигурации

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

На Linux AmneziaWG можно поднять как системный туннель: установить совместимую реализацию, сохранить native .conf и применить его через awg-quick. Для Ubuntu есть официальный PPA. Утилита awg показывает состояние peer, а адреса, маршруты и DNS применяет awg-quick.

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

Подсказка: AmneziaWG на Linux

Выберите свою ситуацию: помощник покажет следующий шаг. Данные доступа вводить не нужно.

Установка из PPA

Проверьте Candidate пакета, установите amneziawg и подтвердите модуль через modinfo.

1Определить исходные данные2Выполнить подходящий шаг3Проверить результат
Определить исходные данные → Выполнить подходящий шаг → Проверить результат

Выбрать графический клиент или системный туннель

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

  1. Добавьте PPA amnezia/ppa штатной командой add-apt-repository и обновите индекс пакетов.
  2. Проверьте apt-cache policy amneziawg. При Candidate: (none) пакет недоступен для текущей конфигурации источников: установка не исправляется многократным повтором.
  3. Установите пакет amneziawg штатным apt. Затем проверьте modinfo amneziawg и наличие awg/awg-quick.
  4. Если модуль не найден, сравните ядро, установленные 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 нельзя подставлять автоматически.

  1. Перед запуском проверьте Address, DNS, Endpoint, AllowedIPs и все AWG-параметры. Не меняйте выданные ключи.
  2. Поднимите профиль через sudo awg-quick up home. При ошибке сохраните конкретную строку, не добавляя автозапуск.
  3. Посмотрите sudo awg show home, откройте ресурс из AllowedIPs и снова проверьте handshake и обмен.
  4. Для остановки используйте 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.