BROray

BROray — менеджер Xray для Keenetic с WebUI, подписками, выбором серверов и интеграцией со штатным прокси-интерфейсом KeeneticOS.

Решение упрощает установку и управление Xray на роутерах Keenetic. Проект работает в среде Entware и использует штатные механизмы KeeneticOS: OPKG, CLI/ndmc, HTTP Proxy и интерфейсы ProxyN. Скрипты рассчитаны на BusyBox ash.

Возможности

• авторизованный WebUI со страницами «Главная», «Серверы», «Подписки», «Маршруты», «Keenetic», «Xray» и «BROray»;
• импорт отдельных подключений и подписок с выбором активного сервера;
• проверка качества серверов и безопасное автоматическое переключение;
• создание, проверка и восстановление принадлежащего BROray интерфейса ProxyN;
• запуск, остановка, перезапуск, диагностика и обновление Xray;
• готовые наборы маршрутов для Telegram, WhatsApp, YouTube, ChatGPT, Facebook, Instagram, Meta, TikTok и Speedtest;
• локальный WebUI на порту 8080 и публикация через KeenDNS HTTP Proxy;
• обновление BROray через собственный OPKG-репозиторий.

Текущая версия

BROray 2.1.0, пакет OPKG 2.1.0-1.

Проверено на Keenetic Ultra KN-1811 с KeeneticOS 5.1.1 Preview, BusyBox 1.37.0 и Entware aarch64-3.10.

Установка

Требуется установленный Entware и доступ к терминалу Keenetic под root.

opkg update &&
opkg install ca-bundle ca-certificates wget-ssl

wget -qO /tmp/broray-opkg.sh \
    https://api.brovibe.cloud/releases/opkg.sh &&
ash /tmp/broray-opkg.sh

После установки WebUI обычно доступен по адресу:

http://192.168.1.1:8080/

Фактический LAN-адрес определяется автоматически.

Обновление

opkg update &&
opkg upgrade broray

Перед обновлением пакет создаёт локальную резервную копию программных файлов и пользовательской конфигурации. Серверы, подписки и активная конфигурация Xray при штатном обновлении сохраняются.

Удаление

opkg remove broray

После удаления пакета пользовательские данные и резервные копии могут сохраняться в /opt/broray. Перед их ручным удалением убедитесь, что нужные подписки и настройки сохранены отдельно.

CLI

broray help
broray list
broray current
broray status
broray test
broray restart
broray-servers summary
broray-subscriptions list
broray-routes summary

Исходный код и релизы

Каталог root/ повторяет пути устанавливаемой файловой системы. Бинарный файл Xray не хранится в исходном дереве репозитория; он добавляется при сборке пакета из официального выпуска Xray-core.

Сценарий scripts/build-opkg-release.sh:

1. собирает очищенное дерево пакета;
2. загружает официальный Xray для Linux ARM64;
3. проверяет официальную и закреплённую SHA-256;
4. создаёт пакет, Packages, Packages.gz и архив обновления сайта;
5. проверяет, что пользовательские данные не попали в пакет.

Готовые пакеты распространяются через OPKG-репозиторий:

https://api.brovibe.cloud/releases/opkg/aarch64-3.10

Важно

• Для проверки shell-скриптов на Keenetic используйте ash -n, а не /bin/sh -n.
• Не публикуйте файлы из servers/, subscriptions/, deleted-subscriptions/, run/, backup/, backups/ и рабочих каталогов routes/: они могут содержать адреса серверов, UUID, ссылки подписок и локальное состояние роутера.
• Перед применением маршрутизации убедитесь, что использование решения соответствует правилам вашей сети и применимому законодательству.

Поддержать проект

Если BROray оказался полезен, вы можете поддержать дальнейшую разработку:

Поддержать BROray через CloudTips

Лицензия

Исходный код BROray распространяется на условиях GNU General Public License v3.0. Xray-core не является частью исходного кода BROray и распространяется на собственных условиях, сохранённых в third_party/xray/.