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

Квас Про ставится на сам роутер, поэтому сначала роутер нужно к этому подготовить. Что именно делать — зависит от устройства:

• Роутер Keenetic/Netcraze — на него ставят Entware: дополнение, которое добавляет роутеру возможность устанавливать программы из отдельного хранилища пакетов.
• Устройство с OpenWrt — готовить почти нечего (какие модели подходят — на странице Модели роутеров): OpenWrt (свободная прошивка для роутеров) сама умеет ставить программы. Но если OpenWrt ещё не установлена, её нужно поставить — это отдельная ответственная процедура.

Entware на Keenetic/Netcraze

Что это. Entware — хранилище готовых программ для роутеров и сама возможность их ставить. На Keenetic/Netcraze оно размещается на USB-накопителе, в каталоге /opt: встроенной памяти роутера для этого слишком мало.

Что понадобится: роутер Keenetic/Netcraze, внешний USB-накопитель, интернет на роутере и доступ к панели управления в браузере. Накопитель должен стоять постоянно: если его вынуть, программы из /opt перестанут работать.

Шаги

1. Подготовьте накопитель. Менеджер пакетов работает только с файловой системой EXT; рекомендуется журналируемая EXT4. Обычные для флешек FAT и NTFS не подойдут. Накопитель удобнее отформатировать на компьютере либо средствами самого роутера — в справке Keenetic/Netcraze это статья «Использование файловой системы EXT4 на USB-накопителях».

2. Установите в роутер компонент «Поддержка открытых пакетов». Он основной и обязательный для работы с пакетами. Где именно находится список компонентов — зависит от версии KeeneticOS, смотрите официальную справку для своей модели.

   Заодно посмотрите компонент «Модули ядра подсистемы Netfilter» (английское название — Kernel modules for Netfilter). Для самой установки Entware он не нужен, но без него на Keenetic недоступен режим «Обычный»: остаётся «Совместимый» — обычные соединения и DNS идут по вашим правилам, QUIC не перехватывается и устройствам с туннелем отклоняется сразу, поэтому приложение переходит на обычное соединение, а остальной UDP идёт напрямую. Когда компонент есть, Квас Про сам загружает его модули, и «Обычный» становится доступен — но режим выбираете вы сами: продукт больше не переключает его автоматически, а по умолчанию на Keenetic остаётся «Совместимый». Ставится он там же, в наборе компонентов: Управление → Общие настройки → Изменение набора компонентов (в части версий прошивки раздел называется «Настройки системы»), поиск по слову netfilter; после применения набора роутер нужно перезагрузить.

   Модули из этого компонента Квас Про загружает сам — при запуске службы и по кнопке «Проверить снова» в оповещении: ручных команд для этого не нужно, и после перезагрузки роутера продукт загрузит их снова. Компонент нужен для того, чтобы файлы модулей были в системе. В вашей версии прошивки такого компонента может не быть — тогда режима «Обычный» на этом роутере не будет, и продукт скажет об этом прямо, а не промолчит; доступность режима показывает Диагностика (подробнее).

3. Скачайте установщик Entware для процессора вашего роутера. Имя архива зависит от платформы, поэтому берите файл из каталога installer своей платформы в хранилище проекта:

   • aarch64 (большинство современных моделей) — aarch64-installer.tar.gz;
   • mipsel — mipsel-installer.tar.gz;
   • mips — mips-installer.tar.gz;
   • остальные платформы — общий список хранилища (откройте каталог своей платформы, затем installer).

   Если сайт хранилища не открывается — так бывает: доступ к bin.entware.net ограничивают не только провайдеры. Возьмите тот же файл с зеркала, путь на нём такой же — <платформа>/installer/<платформа>-installer.tar.gz. Одно из проверенных зеркал: mirrors.nju.edu.cn/entware, например для mipsel — mipsel-installer.tar.gz. Что ещё можно попробовать (дополнительные DNS-серверы, интернет с телефона) — в разделе «Решение проблем».

   Не уверены, какой у вас процессор? Посмотрите opkg print-architecture на роутере: хранилище называет архитектуру так, как её видит само (aarch64-k3.10, armv7sf-k3.2, mipsel-3.4).

   Важно: Entware ставится и на другие платформы, но для установки самого Квас Про есть ограничения — подходят aarch64, armv7 и mipsel (MIPS32 с прямым порядком байт), а на mips (обратный порядок байт) и остальных платформах приложение не работает. Условия собраны в разделе Требования к оборудованию: там же — минимальный объём памяти и свободного места. Сверьтесь с ним до установки.

4. Подключите накопитель к USB-порту роутера. Он появится на странице «Приложения» в разделе «Диски и принтеры».

5. Скопируйте установщик на накопитель. Проще всего по сети: включите в роутере приложение «Сервер SMB» и откройте диск из проводника компьютера. В корне раздела создайте каталог install и положите туда скачанный архив.

6. Включите установку в веб-интерфейсе роутера. Откройте страницу «Менеджер пакетов OPKG», выберите в поле «Накопитель» ваш диск с файловой системой ext4 и убедитесь, что включена опция «Доступ» для вашей учётной записи. Нажмите «Сохранить» — установка начнётся сразу.

7. Дождитесь окончания установки. Ход виден в роутере: «Диагностика» → «Системный журнал». В журнале будут строки installer: [1/5] … [5/5] Установка системы пакетов "Entware" завершена. Занимает несколько минут: установщик скачивает основные пакеты из сети.

8. Проверьте вход по SSH. Установщик Entware ставит и сервер удалённого доступа. Подключитесь к роутеру с компьютера (логин root, пароль keenetic, порт 222, если в роутере установлен компонент «Сервер SSH»; иначе порт 22). Сразу смените пароль командой passwd.

9. Обновите список пакетов — эта команда понадобится и установщику Квас Про:

   opkg update
   opkg install curl
   

Как понять, что всё получилось

• opkg update завершается без ошибок и скачивает списки пакетов;
• opkg list-installed показывает установленные пакеты;
• каталог /opt существует, и в нём есть свободное место (df -h /opt);
• вход по SSH с компьютера работает, и команда opkg print-architecture показывает архитектуру (aarch64-k3.10, armv7sf-k3.2 или mipsel-3.4).

Частые ошибки

• Накопитель в FAT или NTFS — Entware не заработает: нужна файловая система EXT (лучше EXT4).
• Накопитель вынули или заменили — каталог /opt пропал, программы Квас Про останавливаются. Накопитель должен стоять постоянно.
• Крупное обновление KeeneticOS — после него Entware может потребовать повторной установки: проверьте opkg update после обновления прошивки.
• Нет интернета или сбито время — opkg update не сможет скачать списки пакетов.
• Процессор MIPS с обратным порядком байт (mips) — Entware на нём работает, но Квас Про — нет: поддерживается только mipsel (MIPS32 с прямым порядком байт). Порядок байт проверит установщик — на mips он откажется с понятным сообщением.
• Сторонние сборки Entware — существуют, но это уже вне официальной поддержки: последствия для гарантии и поддержки производителя уточняйте у него.

OpenWrt

Что это. OpenWrt — свободная прошивка для роутеров со своим хранилищем программ. Часть устройств продаётся с ней сразу (например, роутеры GL.iNet — это тоже OpenWrt), на другие её устанавливают вместо заводской прошивки. Важно: у роутеров GL.iNet заводская прошивка основана на OpenWrt, но у старых её версий (21.02) есть ограничения — подробности на странице Роутеры GL.iNet.

Шаги

1. Проверьте, поддерживается ли ваша модель. Откройте официальную таблицу оборудования Table of Hardware и найдите свою модель и аппаратную ревизию (v1, v2 и так далее) — от них зависят и файл прошивки, и способ установки.

2. Прочитайте страницу своей модели. На ней указано, какой файл нужен, каким способом устройство прошивается и какие есть ограничения.

3. Сохраните резервную копию настроек и, если возможно, заводской прошивки — это ваша страховка.

4. Скачайте файл прошивки именно для своей модели и ревизии и сверьте контрольную сумму. Для первой установки нужен образ «factory», для обновления уже установленной OpenWrt — «sysupgrade»: это разные файлы.

5. Установите прошивку тем способом, который описан для вашей модели: обычно через панель заводской прошивки, реже — через загрузчик устройства по сетевому кабелю. Соединяйтесь кабелем, а не по Wi-Fi, и держите питание включённым.

6. Первый вход. После перезагрузки задайте пароль администратора и настройте подключение к интернету.

7. Проверьте готовность к установке Квас Про:

   cat /etc/openwrt_release    # версия OpenWrt и строка DISTRIB_ARCH — архитектура
   free -m                     # оперативная память: нужно не меньше 256 МБ
   df -h                       # свободное место под программу
   apk update                  # списки пакетов скачиваются без ошибок (в OpenWrt 25.12 и новее;
                               #  в 24.10 и старше команда называется opkg update)
   

Как понять, что всё получилось

Панель OpenWrt открывается в браузере, apk update работает (в 24.10 и старше — opkg update), а строка DISTRIB_ARCH в /etc/openwrt_release содержит aarch64, armv7 или mipsel.

Частые ошибки

• Не тот файл прошивки (для другой модели или ревизии, либо «sysupgrade» вместо «factory») — самая частая причина неработающего роутера.
• Установка по Wi-Fi или без копии настроек — при неудаче восстановление сложнее.
• Роутер не загружается — у OpenWrt есть режим восстановления и отдельная инструкция по оживлению устройств (восстановление, режим восстановления).
• Мало встроенной памяти — на устройствах со 128 МБ оперативной памяти Квас Про не рекомендуется, а маленького раздела под программы может не хватить: помогает внешний накопитель или вынос данных (зависит от модели).
• Процессор MIPS с обратным порядком байт (mips) — Квас Про такие устройства не поддерживает: нужен MIPS32 с прямым порядком байт (mipsel).

Официальные инструкции

• Entware на Keenetic/Netcraze: в справке Keenetic/Netcraze для вашей модели есть статья «Установка репозитория Entware на USB-накопитель» — откройте справку и найдите статью по названию (пример статьи: Keenetic Giant). Общая документация проекта — вики Entware.
• OpenWrt: установка OpenWrt (русский перевод: установка), таблица поддерживаемых устройств, что сделать перед установкой, обновление уже установленной OpenWrt.

Что дальше

• Установка Квас Про — одна команда, дальше скрипт всё сделает сам.
• Первый запуск — вход в панель по токену и мастер первичной настройки.