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.
Порядок действий:
- Войдите в штатный веб-интерфейс роутера своей учётной записью администратора.
- Откройте «Пользователи и доступ», выберите свою учётную запись администратора и задайте новый пароль длиной не менее 8 символов.
- Сохраните изменения и убедитесь, что роутер подтвердил сохранение без ошибки.
- Повторите вход в 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.
KEENDNS_ADDRESS_UNAVAILABLE: проверьте регистрацию имени KeenDNS.WEB_ACCESS_OWNERSHIP_CONFLICT,WEB_PUBLISH_RECEIPT_INVALID,WEB_PUBLISH_RECEIPT_LIVE_MISMATCH: требуется проверка записи и её владельца; не удаляйте конфигурацию или файлы вручную.- Код с
RECOVERY_REQUIRED: сохраните ошибку предыдущей операции для диагностики. OPERATION_BUSY: дождитесь завершения текущей операции и повторите один раз.is the daemon running?: сначала проверьте службу 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 автоматически не импортируются.
Что отправить в поддержку
- Модель KN и версию KeeneticOS.
- Версию BROray и Xray, точный текст ошибки и страницу, где она появилась.
- Последовательность действий и время проблемы.
- Обезличенный диагностический отчёт, если он доступен. Пароли, ссылки серверов и подписок, приватные ключи и резервные копии не публикуются.
Предупреждения импорта
«Предупреждения обновления» на странице «Подписки» раскрываются по нажатию. Предупреждения сохранённого сервера доступны в его карточке и разделе «Подробнее». Предупреждение о сохранённых, но неприменяемых метаданных отличается от запрета подключения: ориентируйтесь на результат импорта и сообщение карточки. Валидная приватная запись без возможности подключения сама по себе не означает повреждённую подписку. Если версия Xray не определена, сначала проверьте состояние ядра; это не доказательство необходимости обновления. Отсутствие ответа STUN означает, что UDP в этой проверке не подтверждён, а не установленную причину отказа сервера.
Если версия Xray не определена, проверьте состояние ядра: это не доказательство необходимости обновления. Отсутствие ответа STUN означает, что UDP в этой проверке не подтверждён.
DoT: «состояние установки неизвестно»
В 3.5.8 исправлено распознавание DoT, создаваемых встроенным фильтром Keenetic. Обновите BROray и нажмите «Обновить состояние» на странице DNS. В технических сведениях такие записи показаны отдельно; BROray не удаляет их.
Если после обновления неизвестное состояние осталось, сохраните диагностический отчёт. Не удаляйте вручную DNS или файлы квитанций: неизвестная структура по-прежнему блокирует изменение для защиты настроек.
Сообщение «Выбранная конфигурация отличается от фактической» означает другое: выбор в BROray ещё не применён или отличается от настроек роутера. Обновление не устанавливает выбранные DNS автоматически. Применяйте их только если действительно хотите изменить DNS.