Сообщение о проблеме
О проблемах с b4 сообщают через issues на GitHub. Форма отчёта об ошибке просит версию b4, платформу, отчёт «Информация о системе» и трассировку лога. Трассировка, записанная в момент проблемы, показывает, что b4 делал с трафиком.
Что собрать
| Что | Где |
|---|---|
| Версия b4 | Внизу бокового меню |
| Информация о системе | Информация о системе в разделе Настройки > Система > Сервис, затем Копировать JSON в окне Диагностика системы, см. Информация о системе |
| Трассировка лога | Страница Логи, см. Запись трассировки |
| Сет, о котором идёт речь | Копировать JSON на вкладке Импорт/Экспорт сета, см. Импорт/Экспорт |
| Конфигурация, если её попросят | Скачать безопасную копию в разделе Настройки > Система > Бэкап, см. Безопасная копия |
В тексте отчёта стоит описать, что ожидалось и что произошло вместо этого, какие сет, устройство или приложение затронуты и как часто это повторяется: каждый раз, только на некоторых сайтах или только после того, как b4 поработал какое-то время.
Запись трассировки
В трассировку попадают только строки текущего уровня логирования, поэтому сначала уровень повышают.
- В разделе Настройки > Система > Сервис выберите в поле Уровень логирования значение Отладка и нажмите Сохранить.
- На странице Логи нажмите Начать трассировку.
- Воспроизведите проблему, например откройте сайт, который не работает.
- Нажмите Остановить и сохранить. Браузер скачает файл трассировки, а Скачать последнюю трассировку скачивает его ещё раз.
- Верните в поле Уровень логирования значение Инфо.
Трассировка останавливается сама через 15 минут. Файл описан в разделе Запись трассировки страницы «Логи».
Если веб-интерфейс не открывается
По SSH установщик выводит сведения о системе, установленную версию и состояние модулей ядра, см. Диагностика:
curl -fsSL https://raw.githubusercontent.com/DanielLavrushin/b4/main/install.sh | sh -s -- --sysinfo
Если включена запись логов в файл, ошибки b4 и предупреждения при запуске хранит errors.log в папке логов, по умолчанию /var/log/b4. Команды для чтения лога на OpenWrt и MikroTik приведены в разделе Особенности платформ.
Что может быть личным
Issues на GitHub видны всем. Собранные файлы содержат сведения о роутере и сети:
| Что | Что содержит |
|---|---|
| Информация о системе | Имя хоста, адреса и MAC-адреса интерфейсов, правила файрвола и адрес прокси каждого прокси-сета. Отчёт не маскируется. |
| Трассировка лога | Отчёт «Информация о системе», включённые сеты с первыми доменами каждого, не больше восьми, и строки лога. В строках видны сайты, которые открывают устройства, с IP- и MAC-адресами устройств. Адрес прокси у прокси-сета указан, а логин - нет. |
| JSON сета | Домены и адреса сета. У прокси-сета - ещё адрес прокси, имя пользователя и пароль. |
| Безопасная копия | Сеты с доменами и адресом прокси каждого прокси-сета, устройства с именами и MAC-адресами, интерфейсы и порты. Пароли, токены, секреты и имена хостов роутера и релеев владельца скрыты. |
| Вывод установщика | Имя хоста. |
Каждый из этих файлов - обычный текст, и перед отправкой его содержимое можно просмотреть в текстовом редакторе. Имя или адрес, которые должны остаться личными, заменяют заглушкой, одной и той же везде, где они встречаются.