Установка

AWG-Manager устанавливается на роутер Keenetic через пакетный менеджер opkg. Последовательность: компонент Wireguard → Entware (если ещё нет) → SSH → awg-manager.

Требования

  • Роутер Keenetic с USB-портом или Кинетикозаменитель (больше известный как пиратская версия)
  • Прошивка Keenetic OS 4.x или 5.x
  • Одна из поддерживаемых архитектур: mipsel-3.4, mips-3.4, aarch64-3.10
  • Установлен компонент Wireguard в Keenetic OS — веб-интерфейс роутера → Управление → Настройки системы → Изменить набор компонентов → включить Wireguard VPN
Проверить архитектуру можно на сайте производителя роутера.

Шаг 1 — установить Entware

Если Entware уже установлен — пропускайте. Если нет, пройдите подготовку и выберите удобный способ установки.

1.1. Подготовка флешки (рекомендуется)

USB-накопитель должен быть отформатирован в ext4. На Windows — через Paragon Partition Manager. На macOS/Linux — стандартные утилиты. Если у вас установлена Keenetic OS версии 5.1 и выше, вы можете отформатировать USB-накопитель через веб-интерфейс.

Подробности по подготовке накопителя — официальная справка Keenetic.

Tip

Начиная с прошивок 5.X и новее перейдя в настройки системы и изменить набор компонентов можно установить компоненты: утилиты файловой системы ext и файловую систему ext и тогда появится возможность форматирования usb диска или внутреннего накопителя с помощью самого роутера из его веб панели, перейдя в накопители и устройства, выбираете нужный диск и отключаете его, после нажать три точки и потом форматировать, после нужно будет подключить диск обратно и диск будет готов к установке entware.

1.2. Подготовка роутера

Включите компонент OPKG в Keenetic OS: веб-интерфейс → Управление → Настройки системы → Изменить набор компонентов → включить OPKG.

1.3. Определите архитектуру процессора

  • Mips - чипы EcoNet (MIPSBE)
  • Mipsel — чипы MT7628 / MT7621 (MIPSLE)
  • Aarch64 — чипы MT7622 / MT7981 / MT7988 (ARM)

1.4. Установка через WebCLI

Откройте WebCLI-консоль роутера: http://192.168.1.1/a. Введите opkg disk, нажмите Tab — выберите имя накопителя из подсказки. Затем укажите URL установщика под вашу архитектуру:

# Mips
opkg disk <накопитель> https://bin.entware.net/mipssf-k3.4/installer/mips-installer.tar.gz
# Mipsel (MT7628 / MT7621)
opkg disk <накопитель> https://bin.entware.net/mipselsf-k3.4/installer/mipsel-installer.tar.gz
# Aarch64 (MT7622 / MT7981 / MT7988)
opkg disk <накопитель> https://bin.entware.net/aarch64-k3.10/installer/aarch64-installer.tar.gz

Для встроенной памяти <накопитель> = storage:. Для USB-флешки — имя диска, например Label: (с подсказкой по Tab).

1.5. Проверка

После установки в журнале диагностики должна появиться строка:

Opkg::Manager: /opt/etc/init.d/doinstall: [5/5] "Entware" installed!
#либо можно спустя несколько минут ввести команду и увидеть логи в терминале:
show log | grep Opkg::Manager:

Установка занимает одну–две минуты.

Шаг 2 — подключиться по SSH

Данные по умолчанию:

  • IP: 192.168.1.1 (если вы его не меняли)
  • Порт: 222 (если установлен компонент Keenetic SSH) или 22 (если на роутере нет компонента SSH-сервер)
  • Логин: root
  • Пароль: keenetic

Немедленно смените пароль после первого входа:

passwd

Стандартный пароль keenetic лучше сменить на известный только вам.

Для доступа в SSH Entware можно использовать для Windows — PuTTY или PowerShell. Для Linux/macOS — ssh root@192.168.1.1 -p 222.

Шаг 3 — установить awg-manager

Быстрая установка (рекомендуется) 

opkg update
wget -qO- http://repo.hoaxisr.ru/install.sh | sh

Установщик определит архитектуру, добавит репозиторий, скачает и установит пакет, запустит сервис. В последней строке выведется URL веб-интерфейса.

Повторный запуск той же команды — обновление до последней версии.

Ручная установка

Если предпочитаете не запускать внешний скрипт:

# 1. Определить архитектуру репозитория (aarch64-k3.10 / mipsel-k3.4 / mips-k3.4)
ARCH=$(opkg print-architecture | grep '_kn' | awk '{print $2}' | sed 's/_kn.*//' | sed 's/-\([0-9]\)/-k\1/')

# 2. Добавить репозиторий
mkdir -p /opt/etc/opkg
echo "src/gz hoaxisr http://repo.hoaxisr.ru/${ARCH}" > /opt/etc/opkg/awg_manager.conf

# 3. Установить
opkg update
opkg install awg-manager

Первый вход

После установки сервис стартует автоматически. Порт 2222 по умолчанию — если занят, awg-manager сам выберет свободный.

При установке через install.sh итоговая ссылка выводится в последней строке:

[+] ========================================
[+]   AWG Manager: http://192.168.1.1:2222
[+] ========================================

Откройте этот URL в браузере. Если ссылку пропустили — актуальный порт виден в /opt/etc/awg-manager/settings.json (поле port).

По умолчанию UI открыт без авторизации. Если хотите защитить доступ — включите авторизацию в разделе Настройки: awg-manager начнёт требовать учётные данные администратора Keenetic (те же, что и для входа в веб-интерфейс роутера).

awg-manager после первого входа

Обновление

Повторный запуск установщика обновит до последней версии:

wget -qO- http://repo.hoaxisr.ru/install.sh | sh

Или вручную:

opkg update
opkg upgrade awg-manager

Установка конкретной версии (downgrade)

Если нужна более ранняя стабильная версия (например, после релиза с регрессией) — напрямую из репозитория:

# Для aarch64:
opkg install --force-downgrade http://repo.hoaxisr.ru/aarch64-k3.10/awg-manager_ВЕРСИЯ_aarch64-3.10-kn.ipk

# Для mipsel:
opkg install --force-downgrade http://repo.hoaxisr.ru/mipsel-k3.4/awg-manager_ВЕРСИЯ_mipsel-3.4-kn.ipk

# Для mips:
opkg install --force-downgrade http://repo.hoaxisr.ru/mips-k3.4/awg-manager_ВЕРСИЯ_mips-3.4-kn.ipk

Подставьте номер версии вместо ВЕРСИЯ — например, 2.16.4.

В репозитории хранятся последние 5 стабильных версий. Какие именно доступны сейчас, видно прямо в каталоге своей архитектуры: aarch64-k3.10, mipsel-k3.4, mips-k3.4. Более ранние версии — в GitHub Releases.

При переходе между версиями может потребоваться пересоздать туннели (загрузить конфиги заново). По старым версиям поддержка не осуществляется.

Полное удаление 

opkg remove awg-manager && \
rm -f /opt/etc/opkg/awg_manager.conf && \
rm -rf /opt/etc/awg-manager /opt/var/lib/awg-manager /opt/var/log/awg-manager && \
opkg update

Удалит пакет, файл репозитория, все настройки, данные и логи. Если хотите сохранить настройки для переустановки — уберите rm -rf /opt/etc/awg-manager из команды.

Проблемы при установке

  • “Не удалось определить архитектуру” — значит Entware не найден. Вернитесь к Шагу 1
  • Entware не устанавливается / накопитель “занят” — возможно нужно отформатировать накопитель
  • “Connection refused” при заходе в UI — сервис не успел стартовать. Подождите 10–20 секунд, обновите страницу
  • Не помню, на каком порту сервис — подключитесь по SSH и выполните cat /opt/etc/awg-manager/settings.json, поле port

Что дальше?