Home
Softono

Amneziawg Installer

Open source MIT Shell
547
Stars
49
Forks
4
Issues
10
Watchers
2 months
Last Commit

 About Amneziawg Installer

One-command install script for self-hosted AmneziaWG 2.0 VPN on Ubuntu and Debian: DPI bypass, traffic obfuscation, auto-hardening, client management

Platforms

Web Self-hosted Linux

Languages

Shell

Need Help Installing Amneziawg Installer?

We provide expert installation service for this software. Our team will install, configure, and secure Amneziawg Installer on your server. plans start at just $30.

Amneziawg Installer

View on GitHub

RU Русский | EN English

AmneziaWG 2.0 VPN installer for Ubuntu, Debian, Raspberry Pi and ARM64 VPS

Install AmneziaWG 2.0 VPN on Ubuntu and Debian VPS

VPN за одну команду - работает там, где WireGuard блокируют. Любой VPS за $3, без знания Linux.

One-command, self-hosted AmneziaWG 2.0 VPN for Ubuntu 24.04 / 25.10 and Debian 12 / 13. Kernel-native DKMS, no Docker, no web panel, runs on any cheap VPS.

Ubuntu 24.04 | 25.10 | 26.04 Debian 12 | 13 x86_64 | ARM64 | ARMv7 AWG 2.0 License Version Tests Stars Last commit

В ядре, без Docker и панелей - нет накладных расходов  |  сервер только под VPN, защита из коробки  |  поставил и забыл  |  QR-код или vpn:// в один тап

🚀 Быстрый старт

wget -O install_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg.sh
chmod +x install_amneziawg.sh
sudo bash ./install_amneziawg.sh

Что делает: ставит AmneziaWG 2.0 (модуль ядра через DKMS), настраивает firewall и форвардинг, создаёт первого клиента, печатает QR-код и vpn:// ссылку для импорта в Amnezia Client. Добавить друга или устройство потом - одна команда add. 3 команды. 2 перезагрузки по ходу. Около 20 минут до готового VPN. Для чистого Ubuntu/Debian VPS, не роутер и не shared-хостинг. Подробнее →

📘 Полный гайд по развёртыванию (EN): Install AmneziaWG VPN server on Ubuntu/Debian VPS - выбор VPS, ARM, troubleshooting, удаление.

🔐 Целостность: скрипт качается по HTTPS с raw.githubusercontent.com (тег закреплён), вспомогательные скрипты (awg_common, manage) проверяются по закреплённым SHA256-хешам. Отдельные detached-подписи релизов пока не активны (запланированы) - статус и модель угроз в SECURITY.md.

Что установщик меняет на сервере (прозрачность)

Скрипт получает root - вот краткий список того, что он делает с системой:

  • Пакеты: обновляет систему, ставит зависимости (amneziawg-tools, qrencode и т.д.); вычищает ненужное на VPN-сервере - в т.ч. unattended-upgrades (значит, обновления безопасности перестают ставиться автоматически) и cloud-init, если он не управляет сетью (полный список в ADVANCED.md).
  • Ядро: подключает PPA Amnezia (GPG-ключ проверяется по полному отпечатку) и собирает модуль AmneziaWG через DKMS.
  • Сеть: sysctl - форвардинг, сетевые буферы, BBR (отдельными файлами в /etc/sysctl.d/); IPv6 на хосте по умолчанию выключается (оставить: --allow-ipv6); swap подгоняется под размер RAM.
  • Защита: UFW - входящие запрещены, SSH с rate-limit, открыт только UDP-порт VPN; Fail2Ban для SSH.
  • Файлы и сервисы: основные файлы в /root/awg/ и /etc/amnezia/amneziawg/ с правами 600/700; сервис awg-quick@awg0; крон автоудаления истёкших клиентов.
  • Откат: --uninstall убирает своё - модуль, конфиги, sysctl-файлы, кроны, UFW-правило VPN-порта и UFW-правило маршрутизации awg0. UFW отключает и Fail2Ban удаляет только если сам их включал/ставил; если UFW был активен до установки, добавленное правило SSH rate-limit остаётся. Не возвращает: swap и удалённые пакеты.

Пошаговые детали - в ADVANCED.md, модель угроз - в SECURITY.md.

Неинтерактивная установка (для автоматизации)
sudo bash ./install_amneziawg.sh --yes --route-all

Все параметры принимаются автоматически. Подробнее: ADVANCED.md#cli-params-adv

🎯 Выберите свой случай

Ваша ситуация Что добавить
Обычный дешёвый VPS, просто нужен VPN Ничего - команда выше уже всё делает
Мобильный интернет, DPI режет (ТСПУ, Иран, школа или корпоратив) При установке добавьте --preset=mobile (проверенные операторы)
ARM: Raspberry Pi, Oracle Ampere, Hetzner CAX Та же команда - готовые ARM-модули ядра выберутся автоматически (детали)
Доступ другу или гостю на время После установки: manage_amneziawg.sh add guest --expires=7d

Зачем это нужноAWG vs WGCLI vs панелиПохожие инструментыБыстрый стартЧто умеетОператорыТребованияХостингУстановкаПосле установкиУправлениеДополнительноFAQУстранение неполадокЭкосистемаЛицензия

💡 Зачем это нужно

AmneziaWG - форк WireGuard с обфускацией трафика. Обфускация делает трафик трудноотличимым от случайного шума для систем DPI, поэтому там, где обычный WireGuard детектируют и блокируют, AmneziaWG обычно продолжает работать.

Этот набор скриптов превращает чистый VPS в готовый VPN-сервер. Не нужны знания Linux - скрипт сам настроит firewall, оптимизирует систему, создаст конфиги и QR-коды для клиентов.

Сервер настраивается под одну задачу - VPN: лишние пакеты убираются, ядро, сеть и swap тюнингуются под железо, включаются firewall и базовая защита. AmneziaWG работает в ядре, поэтому накладных расходов почти нет - быстро и экономно. Поставил один раз для дома или семьи и забыл: добавить друга или новое устройство через месяц - минута, конфиг и QR готовятся одной командой.

Работает на Ubuntu 24.04/25.10/26.04 и Debian 12/13. Хватит любого дешёвого VPS с 1 ГБ RAM.


⚖️ AmneziaWG vs WireGuard

WireGuard AmneziaWG 2.0
Обнаружение DPI Детектируется по фиксированным размерам пакетов и magic bytes Трудно зафингерпринтить - случайные заголовки, padding, имитация протоколов
Блокируется в Китай, Россия, Иран, ОАЭ, Туркменистан Не известно о блокировках (по состоянию на апрель 2026)
Настройка сервера Вручную: ключи, iptables, sysctl, systemd Одна команда, 20 минут, полностью автоматически
Безопасность Сами: UFW, Fail2Ban, sysctl Автоматически: firewall + защита от брутфорса + тюнинг ядра
Управление клиентами Ручное редактирование конфигов, рестарт add/remove/list/stats с hot-reload
Временный доступ Нет --expires=7d с автоматическим удалением
Требования к серверу - Те же - любой VPS за $3-5/мес, 1 ГБ RAM
Потеря скорости Базовая Минимальная (<2% в типичных тестах)

Если WireGuard у вас работает и не блокируется - используйте его. Если блокируется или режется - AmneziaWG 2.0 является прямой заменой.


⚙️ CLI-инсталлер vs веб-панели

Задача - поднять VPN на дешёвом VPS за 20 минут. Скрипт не тянет за собой Docker, веб-сервер или базу данных. После установки на сервере работает только AWG и firewall - минимум нагрузки, максимум ресурсов для VPN.

Этот проект (CLI) Веб-панели на Docker
Модуль AWG Kernel module - работает на уровне ядра Userspace в контейнере
Требования к серверу Любой VPS от 512 МБ RAM Нужны PHP/Python, БД, веб-сервер, Docker
Поверхность атаки SSH + UDP-порт VPN + HTTP-панель, база данных, Docker
Установка Одна команда на сервере, 20 минут docker-compose + передача SSH-доступа панели
После перезагрузки Продолжит установку с того же шага Зависит от состояния контейнеров и БД
Веб-интерфейс ❌ Нет, только SSH (управление через скрипт manage) ✅ GUI, управление через браузер
Несколько протоколов Только AmneziaWG WireGuard, OpenVPN, VLESS и другие

Нужен VPN без GUI на выделенном сервере - этот проект. Нужна веб-панель с несколькими протоколами - ищите Docker-решения.


🔧 Сравнение с похожими инструментами

Есть ещё несколько способов поднять AmneziaWG. Каждый выбирает свой компромисс:

Инструмент Способ Кому подходит
Этот установщик SSH + одна bash-команда Headless VPS, single-purpose сервер, без Docker и панели, ARM-prebuilt'ы
wiresock/amneziawg-install SSH + bash + опциональная нативная веб-панель Часто заводишь/меняешь клиентов, удобна веб-панель (без Docker)
wg-easy Docker + веб-интерфейс Домашние боксы, на которых уже крутится Docker; нужна панель для клиентов
spcfox/amnezia-wg-easy Docker-форк wg-easy Те, кто уже на wg-easy и хочет именно AmneziaWG вместо обычного WireGuard
Amnezia VPN Десктоп-клиент + SSH deploy Установка кликами без терминала; нужен графический клиент

Быстрый выбор:

  • Часто заводишь и меняешь клиентов, удобнее мышкой в браузере - веб-панель: wiresock (нативная, без Docker) или wg-easy (Docker). Учти: панель - это лишний постоянно работающий сервис, открытый порт и расход ресурсов сервера; для режима «поставил и забыл» это ненужная нагрузка.
  • Дешёвый или слабый VPS, ARM (Raspberry Pi, Oracle Ampere) - этот установщик с готовыми prebuilt'ами, без ожидания сборки модуля.
  • Импорт в телефон одним тапом (QR или vpn://), клиенты по сроку (--expires), пресеты под мобильных операторов - этот установщик.
  • Установка мышкой без терминала - десктоп-клиент Amnezia VPN.

Когда этот проект - не лучший выбор:

  • Часто заводишь и меняешь клиентов и хочется браузерную панель - возьми wiresock или wg-easy. Здесь панели нет осознанно: если клиенты меняются изредка, постоянно работающая панель только ест ресурсы сервера, а управление и так делается из CLI (manage add/remove/list) по SSH.
  • Нужен графический клиент или установка мышкой без терминала - десктоп-клиент Amnezia VPN.

✨ Что умеет

  • Обход блокировок - AmneziaWG 2.0 с обфускацией трафика. DPI не детектирует подключение
  • Одна команда - готовый VPN - от чистого VPS до работающего сервера с клиентскими конфигами и QR-кодами
  • Безопасность из коробки - UFW, Fail2Ban, sysctl hardening, строгие права доступа (600/700)
  • Удобное управление - добавление/удаление клиентов, временные клиенты с авто-удалением, статистика, бэкапы
  • Широкая поддержка ОС - Ubuntu 24.04/25.10/26.04 и Debian 12/13
  • x86_64 и ARM - облачные VPS, Raspberry Pi 3/4/5, ARM64-серверы (AWS Graviton, Oracle Ampere, Hetzner)
  • Оптимизация для мобильных сетей - --preset=mobile для Tele2, Yota, Мегафон и других операторов с DPI-блокировками. Тонкая настройка через --jc, --jmin, --jmax (подробнее)
  • Опциональный dual-stack IPv6 - флаг --allow-ipv6-tunnel добавляет IPv6 внутри туннеля рядом с IPv4 (по умолчанию выключено, подробнее)
Все возможности
  • Нативная генерация ключей и конфигов через awg - без Python и внешних зависимостей
  • Hardware-aware оптимизация: swap, NIC offloads, сетевые буферы на основе характеристик сервера
  • DKMS - автоматическая пересборка модуля ядра при обновлении
  • vpn:// URI для импорта в Amnezia Client одним тапом (.vpnuri файлы)
  • Статистика трафика по клиентам (stats, stats --json)
  • Временные клиенты с авто-удалением (--expires=1h, 7d, 4w и др.)
  • Диагностический отчёт (--diagnostic) и полная деинсталляция (--uninstall)
  • Логирование всех действий в /root/awg/
  • Возобновление установки после перезагрузки - скрипт продолжит с нужного шага
  • Выбор порта, подсети, режима IPv6 и маршрутизации. Поддержка --endpoint для серверов за NAT

📡 С какими операторами проверено

Если VPN нестабилен через мобильный интернет, запускайте установку с --preset=mobile. Ниже - рабочие конфигурации по отчётам пользователей из issues и discussions (не гарантия: блокировки и параметры операторов меняются со временем):

  • Yota - Москва, --preset=mobile
  • Tele2 - Москва (--preset=mobile); Красноярск (--preset=mobile; в майскую волну 2026 заработал I1=<r 48>)
  • Таттелеком / Летай - Татарстан, --preset=mobile
  • Мегафон - регионы, --preset=mobile + удалить параметр I1
  • Билайн - дефолтный preset, флаги не нужны
  • Домашний/проводной интернет - дефолт, как правило, «из коробки»

Вашего оператора нет в списке? Попробуйте --preset=mobile. Не помогло - заведите тред в Discussions или Issues, добавлю в список.

Полная таблица операторских параметров (Jc, Jmin, Jmax, I1) - в ADVANCED.md → FAQ «через мобильную сеть». Точечная настройка через --jc/--jmin/--jmax - в ADVANCED.md → Presets.


🖥️ Требования

  • ОС: Чистая установка Ubuntu Server 24.04 LTS / Ubuntu 25.10 / Ubuntu 26.04 / Debian 12 / Debian 13 Minimal
  • Доступ: Права root (через sudo)
  • Интернет: Стабильное подключение
  • Ресурсы: 512 МБ ОЗУ минимум, рекомендуется 1 ГБ (комфортно 2+ ГБ); минимум ~2 ГБ диска (рекомендуется 3+ ГБ)
  • SSH: Доступ по SSH

Совместимость ОС:

ОС Статус Примечание
Ubuntu 24.04 LTS ✅ Полная поддержка Рекомендуется
Ubuntu 25.10 ✅ Поддерживается PPA noble fallback применяется автоматически с v5.13.0
Ubuntu 26.04 ✅ Поддерживается PPA noble fallback применяется автоматически с v5.13.0
Debian 12 (bookworm) ✅ Поддержка Протестировано. PPA через маппинг codename на focal
Debian 13 (trixie) ✅ Поддержка Протестировано. PPA через маппинг codename на noble, DEB822

Поддержка архитектур (v5.10.0+):

Архитектура Статус Платформы
x86_64 (amd64) ✅ Полная поддержка Все облачные VPS
ARM64 (aarch64) ✅ Поддержка Raspberry Pi 3/4/5, AWS Graviton, Oracle Ampere, Hetzner
ARMv7 (armhf) ✅ Поддержка Raspberry Pi 3/4 (32-bit)

На ARM установщик загружает готовые модули ядра при наличии, и автоматически переключается на DKMS-сборку если нужно.

⚠️ Нестандартный порт SSH: Установщик обычно определяет SSH-порт автоматически. Если SSH на нестандартном порту или автодетект недоступен, запускайте с --ssh-port=ВАШ_ПОРТ (несколько портов - списком через запятую). Как дополнительная консервативная страховка можно заранее выполнить sudo ufw allow ВАШ_ПОРТ/tcp до запуска установки.

Клиенты:

  • Все платформы: Amnezia VPN >= 4.8.12.7 - полнофункциональный VPN-клиент с AWG 2.0. Импорт через vpn:// URI
  • Windows: AmneziaWG >= 2.0.0 - легковесный tunnel manager с AWG 2.0. Импорт через .conf файлы

Полная таблица совместимости клиентов →


🚀 Рекомендация хостинга

Для стабильной работы VPN-сервера с высокой пропускной способностью важен надежный хостинг с хорошим каналом.

На что смотреть при выборе VPS под VPN:

  • IP-адреса, не помеченные как датацентровые - меньше риск блокировок по диапазону.
  • Большой или неограниченный трафик и канал от 1 Гбит/с.
  • Поддержка нужной ОС (Ubuntu 24.04+ / Debian 12+) и root-доступ.

Опробовал и рекомендую FreakHosting. В частности, их линейка BUDGET VPS предлагает отличное соотношение цены и качества.

Их IP-адреса не идентифицируются, как адреса датацентров и не попадают под блокировки по признаку «IP принадлежит хостинг-провайдеру» (в отличие, например, от Azure и некоторых крупных облаков).

  • Рекомендуемый тариф: BVPS-2
  • Характеристики: 2 vCPU, 2 GB RAM, 40 GB NVMe SSD.
  • Ключевое преимущество: порт 10 Gbps с неограниченным трафиком. Идеально для VPN!
  • Цена: Всего €25 в год (около 2200 руб.; на момент проверки, цена может меняться).

Этой конфигурации более чем достаточно для комфортной работы AmneziaWG с большим количеством подключений и высоким трафиком.


🔧 Установка (Рекомендуемый способ)

Этот метод установки гарантирует корректную работу интерактивных запросов и цветного вывода в вашем терминале.

  1. Подключитесь к чистому серверу (Ubuntu 24.04 / Ubuntu 25.10 / Ubuntu 26.04 / Debian 12 / Debian 13) по SSH.

    Совет: После создания сервера подождите 5-10 минут, чтобы завершились все фоновые процессы инициализации системы, прежде чем запускать установку.

  2. Скачайте скрипт:

    wget -O install_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg.sh
    # или: curl -fLo install_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg.sh
    

    На минимальном Debian curl может отсутствовать (wget обычно есть) - используйте wget. Сам curl установщик доставит на шаге 1.

  3. Сделайте его исполняемым:

    chmod +x install_amneziawg.sh
    
  4. Запустите с sudo:

    sudo bash ./install_amneziawg.sh
    

    (Вы также можете передать параметры командной строки, см. sudo bash ./install_amneziawg.sh --help или ADVANCED.md#cli-params-adv)

    English version: Для вывода на английском используйте install_amneziawg_en.sh:

    wget -O install_amneziawg_en.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg_en.sh
    sudo bash ./install_amneziawg_en.sh
    

    Английская версия функционально идентична; только сообщения и логи на английском. После перезагрузки продолжайте тем же файлом: sudo bash ./install_amneziawg_en.sh

  5. Начальная настройка: Скрипт интерактивно запросит:

    • UDP порт: Порт для подключения клиентов (1024-65535). По умолчанию: 39743.
    • Подсеть туннеля: Внутренняя сеть для VPN. По умолчанию: 10.9.9.1/24.
    • Отключение IPv6: Рекомендуется отключить (Y) для избежания утечек трафика.
    • Режим маршрутизации: Определяет, какой трафик пойдет через VPN. По умолчанию 2 (Список Amnezia+DNS) - рекомендуется для лучшей совместимости и обхода блокировок.

    Параметры AWG 2.0 (Jc, S1-S4, H1-H4, I1) генерируются автоматически - никаких действий не требуется.

  6. Перезагрузки: Потребуется ДВЕ перезагрузки. Скрипт запросит подтверждение [y/N]. Введите y и нажмите Enter.

  7. Продолжение: После каждой перезагрузки снова запустите скрипт той же командой:

    sudo bash ./install_amneziawg.sh
    

    Скрипт автоматически продолжит с нужного шага без повторных запросов.

  8. Завершение: После второй перезагрузки и третьего запуска скрипта вы увидите сообщение: Установка и настройка AmneziaWG 2.0 УСПЕШНО ЗАВЕРШЕНА!


📦 После установки

Где найти файлы клиентов:

Файл Путь Назначение
.conf /root/awg/имя.conf Конфигурация для импорта в клиент
.png /root/awg/имя.png QR-код для мобильных устройств
.vpnuri /root/awg/имя.vpnuri vpn:// URI для Amnezia Client

Скачать конфиг на компьютер:

scp root@IP_СЕРВЕРА:/root/awg/my_phone.conf .
Импорт в Amnezia VPN (телефон) через vpn:// URI
  1. На сервере выполните: cat /root/awg/my_phone.vpnuri
  2. Скопируйте текст и отправьте себе (Telegram, почта и т.д.)
  3. На телефоне: Amnezia VPN → «Добавить VPN» → «Вставить из буфера»
Импорт через QR-код
  1. Скачайте QR-код: scp root@IP_СЕРВЕРА:/root/awg/my_phone.png .
  2. Откройте файл на экране компьютера
  3. На телефоне: Amnezia VPN → «Добавить VPN» → «Сканировать QR-код»
Импорт в AmneziaWG for Windows
  1. Скачайте .conf файл на компьютер через scp или sftp
  2. AmneziaWG → Import tunnel(s) from file → выберите .conf файл

Другие файлы на сервере:

  • Конфигурация сервера: /etc/amnezia/amneziawg/awg0.conf
  • Настройки скрипта: /root/awg/awgsetup_cfg.init
  • Скрипт управления: /root/awg/manage_amneziawg.sh
  • Общие функции: /root/awg/awg_common.sh
  • Данные истечения клиентов: /root/awg/expiry/
  • Логи: /root/awg/*.log

👥 Управление клиентами (manage_amneziawg.sh)

Скрипт manage_amneziawg.sh для управления пользователями скачивается автоматически.

Использование:

sudo bash /root/awg/manage_amneziawg.sh <команда> [аргументы]

Полный список - ... help или ADVANCED.md#manage-commands-adv.

Повседневные команды:

Команда Аргументы Описание Перезапуск?
add <имя> [имя2 ...] [--expires=ВРЕМЯ] Добавить клиента(ов) (опц. с истечением) Нет (авто)
remove <имя> [имя2 ...] Удалить клиента(ов) Нет (авто)
list [-v] [--json] Список клиентов (-v детали, --json машиночитаемый с client_ipv6) Нет
show Статус awg show Нет
stats [--json] Статистика трафика по клиентам Нет

Обслуживание и восстановление:

Команда Аргументы Описание Перезапуск?
regen [имя_клиента] Переген. файлы (всех/одного) Нет
modify <имя> <пар> <зн> Изменить параметр клиента Нет
backup Создать резервную копию Нет
restore [файл] Восстановить из резервной копии Нет
check Проверка состояния сервера Нет
diagnose [--carrier=ИМЯ] Диагностика (опц. под оператора) Нет
repair-module Пересобрать модуль ядра (DKMS) Да
restart Перезапуск сервиса AmneziaWG -

💡 Примечание: Команды add и remove автоматически применяют изменения через awg syncconf - перезапуск сервиса не требуется.

📌 Краткая справка

# Установка (русский)
wget -O install_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg.sh
sudo bash ./install_amneziawg.sh          # Запуск (+ 2 перезагрузки)

# Установка (English)
wget -O install_amneziawg_en.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/install_amneziawg_en.sh
sudo bash ./install_amneziawg_en.sh       # Запуск (+ 2 перезагрузки)

# Управление клиентами
sudo bash /root/awg/manage_amneziawg.sh add my_phone       # Добавить
sudo bash /root/awg/manage_amneziawg.sh add my_iphone --psk  # +PresharedKey (Shadowrocket iOS/macOS)
sudo bash /root/awg/manage_amneziawg.sh remove my_phone    # Удалить
sudo bash /root/awg/manage_amneziawg.sh list                # Список
sudo bash /root/awg/manage_amneziawg.sh list --json         # Список в JSON (для скриптов)
sudo bash /root/awg/manage_amneziawg.sh regen               # Перегенерация

# Временный клиент (7 дней)
sudo bash /root/awg/manage_amneziawg.sh add guest --expires=7d

# Статистика трафика
sudo bash /root/awg/manage_amneziawg.sh stats
sudo bash /root/awg/manage_amneziawg.sh stats --json

# Обслуживание
sudo bash /root/awg/manage_amneziawg.sh check               # Диагностика
sudo bash /root/awg/manage_amneziawg.sh backup               # Бэкап
sudo bash /root/awg/manage_amneziawg.sh restart              # Перезапуск

ℹ️ Дополнительная информация

Более подробную информацию о деталях конфигурации, настройках безопасности, параметрах AWG 2.0, дополнительных командах управления, технических деталях и ответах на другие вопросы вы можете найти в файле ADVANCED.md.

Историю изменений смотрите в CHANGELOG.md.

Планы развития и приоритеты - в docs/ROADMAP.md.


❓ FAQ (Основные вопросы)

В разделе: установка и обновление, подключение клиентов, мобильные сети, выбор хостинга и перенос, безопасность и параметры. Разверните нужный вопрос ниже.

В: Будет ли работать после обновления ядра? О: Да, DKMS должен автоматически пересобрать модуль. Проверьте dkms status.
В: Как полностью удалить AmneziaWG? О: Скачайте скрипт установки (если его нет) и запустите: sudo bash ./install_amneziawg.sh --uninstall.
В: Клиенты не подключаются, что делать? О: 1. Проверьте статус: sudo bash /root/awg/manage_amneziawg.sh check. 2. Проверьте фаервол: sudo ufw status verbose. 3. Проверьте конфиг клиента. 4. Проверьте логи: sudo journalctl -u awg-quick@awg0 -n 50. 5. Убедитесь, что клиент поддерживает AWG 2.0: Amnezia VPN >= 4.8.12.7 или AmneziaWG >= 2.0.0.
В: Handshake проходит, но трафик не идёт - что не так? О: Частая причина - split-tunneling AllowedIPs gotcha при ручной правке. Если хочешь пинговать/SSH'иться к серверу по его внутреннему IP (10.9.9.1 в дефолтной подсети), добавь в AllowedIPs клиента подсеть туннеля (по умолчанию 10.9.9.0/24, или твою кастомную, если менял --subnet). Иначе клиент не маршрутизирует трафик к серверу даже изнутри тоннеля. Режим --route-all (полный туннель 0.0.0.0/0) покрывает подсеть автоматически; режим --route-amnezia (по умолчанию, Amnezia List) и --route-custom= - нет, добавляй вручную. Подробнее - в ADVANCED.md → AllowedIPs.
В: Можно ли использовать с AWG 1.x клиентами? О: Нет. AWG 2.0 несовместим с AWG 1.x. Все клиенты должны поддерживать протокол 2.0. Для AWG 1.x используйте ветку legacy/v4.
В: Ошибка импорта конфига «Неверный ключ: s3» - что делать? О: Вы используете устаревшую версию amneziawg-windows-client (< 2.0.0). Обновите до версии 2.0.0+, которая поддерживает AWG 2.0. Альтернатива - Amnezia VPN >= 4.8.12.7.
В: Как обновить скрипты до новой версии? О: Скачайте новый скрипт установки и замените скрипты управления на сервере:
  # Русская версия:
  wget -O /root/awg/manage_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/manage_amneziawg.sh
  wget -O /root/awg/awg_common.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/awg_common.sh
  chmod 700 /root/awg/manage_amneziawg.sh /root/awg/awg_common.sh

Английская версия:

wget -O /root/awg/manage_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/manage_amneziawg_en.sh wget -O /root/awg/awg_common.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.16.0/awg_common_en.sh chmod 700 /root/awg/manage_amneziawg.sh /root/awg/awg_common.sh

Переустановка сервера не требуется.

В: Какое максимальное количество клиентов? О: Подсеть /24 позволяет до 253 клиентов (.2 - .254), что достаточно для большинства сценариев.
В: Какой хостинг подходит? О: Любой VPS с Ubuntu 24.04 LTS / Ubuntu 25.10 / Ubuntu 26.04 / Debian 12 / Debian 13, root-доступом и от 512 МБ RAM (рекомендуется 1 ГБ). Беру хостинги с незаблокированными IP и неограниченным трафиком. См. рекомендацию ниже.
В: Как перенести VPN на другой сервер? О: 1. Создайте бэкап: sudo bash /root/awg/manage_amneziawg.sh backup. 2. Скопируйте архив из /root/awg/backups/ на новый сервер. 3. Установите AmneziaWG на новом сервере. 4. Восстановите: sudo bash /root/awg/manage_amneziawg.sh restore (интерактивный выбор из списка, или укажите полный путь к архиву). 5. Перегенерируйте конфиги с новым IP: sudo bash /root/awg/manage_amneziawg.sh regen.
В: Как создать временного клиента? О: sudo bash /root/awg/manage_amneziawg.sh add guest --expires=7d. Форматы: 1h, 12h, 1d, 7d, 30d, 4w. Cron проверяет каждые 5 минут и автоматически удаляет истёкших клиентов.
В: Что такое файлы .vpnuri? О: Файлы .vpnuri содержат vpn:// URI для импорта конфигурации в Amnezia Client одним тапом. Скопируйте содержимое файла → откройте Amnezia Client → «Добавить VPN» → «Вставить из буфера».
В: Не подключается Shadowrocket на iOS/macOS - нужен PresharedKey О: С v5.11.1 добавлен флаг --psk для команды add: sudo bash /root/awg/manage_amneziawg.sh add my_iphone --psk. В файле клиента появится строка PresharedKey = ... совпадающая с серверным [Peer]. Для уже созданных клиентов: пересоздать с флагом (remove + add --psk) или вручную - сгенерировать ключ один раз (PSK=$(awg genpsk)) и вставить одно и то же значение в обе стороны (серверный [Peer] клиента и клиентский [Peer] сервера); если значения различаются - handshake не пройдёт. regen сохраняет существующий PSK через rotation. Подробнее - в ADVANCED.md.
В: Почему порт 39743? О: Это случайный порт из верхнего диапазона, выбранный как дефолт. Можно изменить при установке: --port=XXXXX (любой порт 1024-65535).
В: Нужен ли Perl на сервере? О: Perl используется опционально для генерации vpn:// URI (.vpnuri файлов). Если Perl отсутствует, .conf файлы создаются как обычно - ими можно пользоваться через импорт файла или QR-код. На Ubuntu и Debian Perl установлен по умолчанию.
В: Безопасно ли запускать скрипт повторно? О: Да. При повторном запуске серверный конфиг пересоздаётся, но существующие клиенты автоматически восстанавливаются из бэкапа. Дефолтные клиенты (my_phone, my_laptop) пересоздаются, остальные - сохраняются.

Больше ответов и решений см. в ADVANCED.md.


🛠️ Устранение неполадок

  1. Логи: /root/awg/install_amneziawg.log, /root/awg/manage_amneziawg.log
  2. Статус сервиса: sudo systemctl status awg-quick@awg0
  3. Статус AmneziaWG: sudo awg show
  4. Статус UFW: sudo ufw status verbose
  5. Диагностический отчет: sudo bash ./install_amneziawg.sh --diagnostic Подробное описание содержимого отчета см. в ADVANCED.md.

🌐 Экосистема

Клиенты

Какой клиент выбрать? Установите Amnezia VPN (>= 4.8.12.7) - работает на всех платформах, поддерживает импорт vpn:// URI. Для легковесного подключения (только .conf) используйте AmneziaWG для вашей платформы.

Клиент Платформа AWG 2.0 Тип Примечание
Amnezia VPN Windows, macOS, Linux, Android, iOS ✅ >= 4.8.12.7 Официальный Рекомендуется. Полнофункциональный, vpn:// URI
AmneziaWG Windows ✅ >= 2.0.0 Официальный Легковесный tunnel manager, импорт .conf
AmneziaWG Android ✅ >= 2.0.0 Официальный Легковесный tunnel manager, импорт .conf
AmneziaWG iOS Официальный Легковесный tunnel manager, импорт .conf
WG Tunnel Android ⚠️ частично Сторонний, FOSS Auto-tunneling, split tunnel, F-Droid
VeilBox Windows, macOS Сторонний, FOSS Также поддерживает VLESS

Полная таблица совместимости с AWG 1.x →

Инструменты настройки

Проект Описание
Junker Веб-генератор подписей AmneziaWG от @spatiumstas - для ручной настройки без установочного скрипта
AmneziaWG-Architect Веб-генератор CPS/мимикрии для AWG 2.0 от @Vadim-Khristenko (GitHub)

Прошивки для роутеров

Проект Платформа Описание
AWG Manager Keenetic (Entware) Веб-интерфейс для управления AWG-туннелями на роутерах Keenetic
AmneziaWG for Merlin ASUS (Asuswrt-Merlin) Аддон AWG 2.0 с веб-интерфейсом, GeoIP/GeoSite маршрутизация

📰 Упоминания

📖 Гайды и туториалы

📰 Статьи и обзоры

📋 Каталоги и подборки

💬 Форумы и сообщества


📝 Лицензия и Автор

  • Автор скриптов: @bivlked - GitHub
  • Лицензия: MIT - свободное ПО с открытым исходным кодом (см. LICENSE)

Проект пригодился - поставьте ⭐. Так его проще найти другим.

↑ К началу