Начало работы

Установка BROray-Light

Пошаговый путь для первой установки Light. Если Entware и терминал уже настроены, соответствующие этапы можно пропустить.

Stable 2.0.0

1. Проверьте совместимость

  • Keenetic с Entware aarch64-3.10;
  • накопитель подключён как /opt;
  • есть root-доступ к Entware shell;
  • на роутере корректны время, DNS и HTTPS.

Если эти условия выполнены, переходите к Entware и установке. Точные требования к месту, временным каталогам и владению компонентами вынесены в технический справочник.

Подробные требования →

2. Установите Entware, если его ещё нет

  1. Откройте веб-интерфейс Keenetic по LAN-адресу своего роутера, обычно http://192.168.1.1/.
  2. Проверьте раздел приложений: если OPKG/Entware уже работает и выбран накопитель, переустанавливать Entware не нужно.
  3. Если Entware отсутствует, сохраните нужные файлы с выделенного накопителя. Форматирование удаляет его содержимое.
  4. Подготовьте накопитель и компоненты «Поддержка открытых пакетов»/OPKG согласно инструкции для своей модели и версии KeeneticOS. Названия пунктов могут различаться.
  5. Установите именно Entware aarch64-3.10 по инструкции Keenetic Community.
  6. Дождитесь завершения установки и убедитесь, что OPKG работает, а /opt доступен на запись.

Не переносите команды форматирования с другой модели и не выполняйте установку Light в командной строке KeeneticOS.

3. Подключитесь к терминалу Entware

Используйте Termius, PuTTY или встроенный SSH-клиент.

В Termius создайте New Host, в PuTTY заполните Host Name. Укажите LAN-IP роутера, SSH-порт Entware, пользователя root и свой пароль Entware. Сверьте ключ сервера при первом подключении. Пароль WebUI Keenetic и пароль root Entware могут различаться.

Во встроенном терминале:

ssh root@192.168.1.1

Для другого SSH-порта: ssh -p НОМЕР_ПОРТА root@IP_РОУТЕРА. Если приглашение выглядит как (config)>, это KeeneticOS CLI, а не Entware. Откройте правильный SSH-порт. При вводе пароля символы могут не отображаться — это нормально.

Проверьте окружение:

opkg --version
opkg print-architecture
ls -ld /opt
df -h /opt /tmp
test -x /opt/bin/ash && echo "Entware shell: OK"

Архитектура должна включать aarch64-3.10. При ошибке остановитесь и устраните её до следующего шага.

4. Чистая установка 2.0.0

Этот путь — только для отсутствующей установки Light. Если Light уже установлен, используйте раздел 8.

Скопируйте весь блок в Entware shell от root. Он устанавливает зависимости, скачивает точный установщик в оперативную память и проверяет его SHA-256 до запуска:

(
set -eu
PATH=/opt/bin:/opt/sbin:/usr/bin:/usr/sbin:/bin:/sbin
export PATH
[ "$(id -u)" = 0 ]
[ -d /tmp ] && [ ! -L /tmp ]
awk '$2=="/tmp" && ($3=="tmpfs" || $3=="ramfs") {ok=1} END {exit !ok}' /proc/mounts
umask 077
D="$(mktemp -d /tmp/broray-light-guide.XXXXXX)"
trap 'rm -f "$D/install.sh"; rmdir "$D/opkg" 2>/dev/null || :; rmdir "$D" 2>/dev/null || :' EXIT
mkdir "$D/opkg"
TMPDIR="$D/opkg" opkg --tmp-dir "$D/opkg" update
TMPDIR="$D/opkg" opkg --tmp-dir "$D/opkg" install ca-bundle ca-certificates curl coreutils-stat
curl -q --proto '=https' --proto-redir '=https' --tlsv1.2 \
  --connect-timeout 15 --max-time 600 -fsSL \
  -H 'Cache-Control: no-cache, no-store' -H 'Accept-Encoding: identity' \
  'https://github.com/BROadmin/BROray-Light/releases/download/v2.0.0/broray-light-install-2.0.0.sh' \
  -o "$D/install.sh"
[ "$(sha256sum "$D/install.sh" | awk 'NR==1{print $1}')" = \
  'd7d1a709621f3154c0f5b5892a98bddd3f3f782b57d01eb15025e739abcd44f2' ]
/opt/bin/ash "$D/install.sh"
)

Не используйте curl -k, opkg --force-reinstall или ручную распаковку вместо отказавшего установщика. Не запускайте тот же блок бесконечно при ошибке: сохраните сообщение, выясните причину и только затем повторите установку. Если аварийное завершение OPKG оставило файлы, удаляйте только каталог /tmp/broray-light-guide.XXXXXX, созданный этой попыткой, после проверки его точного имени и содержимого; не очищайте весь /tmp.

Проверка результата:

/opt/etc/init.d/S23broray-light-updater status && echo "Updater: OK"
/opt/etc/init.d/S24broray-light status && echo "BROray-Light: OK"
/opt/broray-light/runtime/xray version
/opt/bin/broray-light-web-publishctl status

При чистой установке используется Xray 26.9.9. Это предварительный выпуск самого Xray, отдельно проверенный в рамках Light; слово Stable относится к релизу приложения, а не меняет статус upstream-ядра. Пока сервер не выбран, Xray может быть остановлен — добавьте и активируйте рабочий VLESS-сервер.

5. Откройте WebUI и войдите

Локально: http://LAN-IP-РОУТЕРА:8080/.

При настроенном KeenDNS: https://brolight.ВАШ-ДОМЕН-KEENDNS/. Например, для myrouter.keenetic.link адрес будет https://brolight.myrouter.keenetic.link/. Порт 8080 в этом HTTPS-адресе не добавляется. Внешний доступ зависит от настроек KeenDNS и подтверждённого владения публикацией.

Введите логин и пароль пользователя Keenetic, не пароль root Entware. Пароль проверяется KeeneticOS и не сохраняется Light. Не открывайте порт 8080 напрямую в интернет, не отключайте авторизацию и защиту сессии.

Следующий шаг

Добавьте VLESS

После успешной установки переходите к подписке или отдельному серверу через WebUI.

Настроить Light →