BROray · 3.5.9 · Stable

Решение проблем BROray

Начните с симптома и сообщения в интерфейсе. Повторная установка и перезагрузка — не первый шаг диагностики.

WebUI не открывается

Проверьте подключение к домашней сети и адрес с портом 8080. Для KeenDNS сначала проверьте локальный вход: внешний адрес и само приложение могут иметь разную доступность. Убедитесь, что Entware запущен. В терминале используйте /opt/bin/broray ctl ping.

Не получается войти

Для BROray нужны данные администратора Keenetic. Логин root и пароль SSH Entware здесь не подходят. После перезапуска или обновления BROray вход выполняется заново.

FAQ: В Keenetic войти получается, а в BROray — нет

На KeeneticOS 5.2 старый короткий пароль может продолжать работать в штатной панели через NDW2. BROray 3.5.8 предпочитает новый механизм NDW4, которому нужен пароль администратора не менее 8 символов. В исследованном случае со старым коротким паролем BROray возвращал 502 KEENETIC_AUTH_PROTOCOL_ERROR.

Это требование нового механизма NDW4, а не общее ограничение всех старых версий KeeneticOS и авторизации NDW2.

Для входа через новый механизм авторизации KeeneticOS 5.2 нужен пароль администратора длиной не менее 8 символов. Измените пароль в разделе “Пользователи и доступ” веб-интерфейса роутера, сохраните изменения и повторите вход в BROray.

Порядок действий:

  1. Войдите в штатный веб-интерфейс роутера своей учётной записью администратора.
  2. Откройте «Пользователи и доступ», выберите свою учётную запись администратора и задайте новый пароль длиной не менее 8 символов.
  3. Сохраните изменения и убедитесь, что роутер подтвердил сохранение без ошибки.
  4. Повторите вход в BROray с новым паролем.

Переустановка BROray не изменяет пароль администратора Keenetic и не заменяет эти действия.

Всегда ли 502 или 503 означают короткий пароль?

Нет. Смена пароля не является универсальным исправлением любого 502 или 503. Первоначальный 503 в исследованном случае не удалось однозначно связать с длиной пароля: возможны транспортные причины и блокировка запросов HTTP-защитой роутера.

Если пароль уже содержит не менее 8 символов или ошибка остаётся, проверьте доступность штатной панели и локальной страницы BROray. Сохраните код ошибки, версии BROray и KeeneticOS и время сбоя для диагностики. Не публикуйте пароль, cookie, адреса владельца и полный диагностический отчёт без удаления личных данных.

Не выполняется команда установки

При строке (config)> включите доступ OPKG своей учётной записи и перейдите в Entware командой exec sh. Нужна строка shell с #. Веб-терминал и SSH по шагам. Если opkg отсутствует, проверьте Entware. При несовпадении архитектуры сверяйте KN/NC-модель и opkg print-architecture.

Не хватает места

Установщик требует 60 МиБ свободного места в /opt. Сам объём flash не равен свободному месту. Проверьте накопитель Entware; при необходимости используйте USB. Не удаляйте чужие файлы и не обходите проверку места.

Сервер активен, но нужный сервис не открывается

Нажмите «Проверить» у активного сервера. Затем проверьте состояние Xray, ProxyN и наличие нужных маршрутов в Keenetic. Выбор сервера сам по себе не определяет, какой трафик устройств должен идти через него.

Не работает UDP

Посмотрите возможности ProxyN на странице Keenetic и предупреждения. На прошивке без поддержки UDP действует TCP-only. Успешная TCP-проверка не доказывает работу UDP.

Качество и состояние соединения отличаются

Это разные измерения. Ошибка дополнительной оценки качества не отменяет успешный HTTPS-тест активного подключения. Посмотрите время последней проверки и обновите её вручную.

Подписка обновилась не полностью

Пустой, повреждённый или частично разобранный ответ не подтверждает удаление прежних узлов. Прочитайте предупреждения. Валидный AmneziaWG в режиме «Только сохранение» сам по себе не означает ошибку подписки. Сверьте формат с таблицей поддержки. Для ошибки импорта сохраните её текст, не публикуя ссылку и ключи.

Маршрутный набор требует внимания

Откройте подробности: скачанный каталог, установленный набор и фактические записи Keenetic — разные состояния. Сначала выясните причину, затем выполните предлагаемую проверку, загрузку или продолжение. Не удаляйте общий реестр и квитанции вручную.

Обновление или операция прерваны

Откройте журнал и статус текущей операции. Не запускайте дубликат и не удаляйте файлы блокировки операции вручную. Используйте предлагаемый сценарий восстановления; инструкция по обслуживанию.

Ошибки старой ветки 3.2

Коды owner-publication-incomplete и RUNNING_SNAPSHOT_FAILED из старой документации относятся к прежней системе обновления. Архив документации 3.2. Не применяйте её команды восстановления к 3.5.

Не получается удалить 3.2 перед чистой установкой

Если старый WebUI не принимает вход, штатная команда удаления 3.2 доступна в инструкции. accepted:true означает приём запроса, а не завершённое удаление. Сначала сохраните нужные данные. При отказе «состав или владение файлов BROray неоднозначны», QUEUE_STATE_INVALID или UPDATER_STOP_UNCONFIRMED сохраните код и состояние операции и обратитесь в поддержку. Эти случаи требуют проверки файлов и квитанций прежней версии; массовое удаление каталогов, перенос любых неизвестных журналов и принудительная остановка процессов не являются универсальным исправлением.

Есть внешний адрес панели, но нет SSH или адреса BROray

KeenDNS может открывать только веб-панель и не предоставлять SSH. Откройте штатный веб-терминал, включите доступ OPKG для своей учётной записи и выполните exec sh. Для установленной 3.5 включите её адрес штатной командой ctl. Не закрывайте основную панель до проверки нового адреса. Если компонент терминала требуется установить, учтите возможное обновление ОС и автоматическую перезагрузку по подтверждению мастера.

После чистой установки BROray открывается только локально

В 3.5.6 это исправлено: адрес создаётся при чистой установке, если настроен KeenDNS. При обновлении отключённый адрес сохраняется отключённым.

В 3.5.0–3.5.5 установщик не создаёт адрес broray.… автоматически. Если основная панель доступна по KeenDNS, переустанавливать BROray не нужно. Оставьте её открытой и перейдите в веб-терминал. Из приглашения (config)> выполните exec sh: команды ниже предназначены для Entware.

Проверьте, что BROray запущен:

/opt/bin/broray ctl ping

При success:true включите адрес:

/opt/bin/broray ctl post /api/keenetic/web-access-enable.cgi '{}'

После успешного ответа получите адрес и проверьте результат:

/opt/bin/broray ctl get /api/keenetic/web-access-status.cgi

Откройте адрес из data.address. Успешное состояние: data.state=enabled, data.enabled=true, data.consistent=true. VPN и перезагрузка для этого не требуются. Вместо команд можно нажать «Включить» в блоке доступа к WebUI на странице «Keenetic» локального BROray.

При ошибке остановитесь и сохраните её код. Даже при enabled внешний доступ может зависеть от доступности KeenDNS; отдельно проверьте основную панель и локальную страницу BROray.

После установки видна старая страница или не работает вход

После замены 3.2 на 3.5 браузер может показать сохранённый HTML старой версии. Выполните Ctrl+F5 или Ctrl+Shift+R в Firefox; при необходимости проверьте адрес в новой приватной вкладке. Затем на странице «BROray» сверьте версию 3.5.8. Для входа используйте учётную запись администратора основной панели, а не пароль root Entware. Если свежая страница также отказывает во входе, сохраните код ошибки и версию прошивки; не повторяйте пароль многократно.

Xray установлен, но подключения ещё нет

После чистой установки нет активного сервера и его конфигурации. В этом состоянии остановленный Xray ожидаем. Добавьте сервер или подписку, выберите подключение и выполните проверку; затем настройте маршруты. Старые данные 3.2 автоматически не импортируются.

Что отправить в поддержку

Предупреждения импорта

«Предупреждения обновления» на странице «Подписки» раскрываются по нажатию. Предупреждения сохранённого сервера доступны в его карточке и разделе «Подробнее». Предупреждение о сохранённых, но неприменяемых метаданных отличается от запрета подключения: ориентируйтесь на результат импорта и сообщение карточки. Валидная приватная запись без возможности подключения сама по себе не означает повреждённую подписку. Если версия Xray не определена, сначала проверьте состояние ядра; это не доказательство необходимости обновления. Отсутствие ответа STUN означает, что UDP в этой проверке не подтверждён, а не установленную причину отказа сервера.

Если версия Xray не определена, проверьте состояние ядра: это не доказательство необходимости обновления. Отсутствие ответа STUN означает, что UDP в этой проверке не подтверждён.

DoT: «состояние установки неизвестно»

В 3.5.8 исправлено распознавание DoT, создаваемых встроенным фильтром Keenetic. Обновите BROray и нажмите «Обновить состояние» на странице DNS. В технических сведениях такие записи показаны отдельно; BROray не удаляет их.

Если после обновления неизвестное состояние осталось, сохраните диагностический отчёт. Не удаляйте вручную DNS или файлы квитанций: неизвестная структура по-прежнему блокирует изменение для защиты настроек.

Сообщение «Выбранная конфигурация отличается от фактической» означает другое: выбор в BROray ещё не применён или отличается от настроек роутера. Обновление не устанавливает выбранные DNS автоматически. Применяйте их только если действительно хотите изменить DNS.