GitHub - bivlked/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

RU Русский | EN English

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.

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

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

wget https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/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 (тег закреплён). Отдельные detached-подписи релизов пока не активны (запланированы) - статус и модель угроз в SECURITY.md.

sudo bash ./install_amneziawg.sh --yes --route-all

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

Зачем это нужно • AWG vs WG • CLI 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 является прямой заменой.

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

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

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

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

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

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

• Часто заводишь и меняешь клиентов, удобнее мышкой в браузере - веб-панель: 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 (по умолчанию выключено, подробнее)

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

Если 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

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

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

На 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 https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/install_amneziawg.sh
   # или: curl -fLo install_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/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 https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/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 УСПЕШНО ЗАВЕРШЕНА!

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

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

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

scp root@IP_СЕРВЕРА:/root/awg/my_phone.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 и remove автоматически применяют изменения через awg syncconf - перезапуск сервиса не требуется.

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

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

# Установка (English)
wget https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/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 (Основные вопросы)

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

  # Русская версия:
  wget -O /root/awg/manage_amneziawg.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/manage_amneziawg.sh
  wget -O /root/awg/awg_common.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/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.15.6/manage_amneziawg_en.sh
wget -O /root/awg/awg_common.sh https://raw.githubusercontent.com/bivlked/amneziawg-installer/v5.15.6/awg_common_en.sh
chmod 700 /root/awg/manage_amneziawg.sh /root/awg/awg_common.sh

Больше ответов и решений см. в 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 1.x →

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

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

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

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

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

↑ К началу