Решение типовых проблем

Ниже перечислены частые ситуации и что можно сделать. Логи и расположение файлов описаны в Структура файлов и данные.

Приложение не запускается или падает

Проверьте каталог рядом с исполняемым файлом (exe) на наличие startup_error.txt или файлов crash_*.txt — там может быть трассировка ошибки.
Логи и дампы крашей также могут писаться в Documents\NTBot_Recorder\logs (Windows). Просмотрите последние файлы на предмет исключений.
Антивирус или брандмауэр могут блокировать приложение — попробуйте добавить исключение для каталога с exe.

Убедитесь, что в Рекордере нажата кнопка Запись и прокси запущен (обычно на 127.0.0.1:8080). После нажатия Стоп новые запросы не записываются.
Если используете опцию «Автоматически устанавливать системный прокси», убедитесь, что она включена в настройках и что браузер использует системный прокси (в Firefox — «Использовать настройки прокси этой системы»). Иначе настройте прокси вручную в браузере: адрес 127.0.0.1, порт 8080.
Убедитесь, что порт 8080 не занят другим процессом. При необходимости смените порт в Настройки → Настройки приложения.

Ошибки вида «сертификат не доверен» или «SSL» при открытии HTTPS-сайтов через прокси означают, что в системе/браузере не установлен корневой сертификат Рекордера. Выполните: Настройки → Управление сертификатами → «Установить сертификат в систему», затем перезапустите браузер.
В некоторых браузерах нужно отдельно включить использование системных сертификатов или импортировать сертификат в хранилище браузера (см. справку браузера).
После обновления приложения сертификат мог измениться — переустановите его и снова перезапустите браузер.

Проверьте, что Рекордер запущен и прокси запущен (кнопка Запись была нажата).
Проверьте адрес и порт: по умолчанию 127.0.0.1:8080. Если порт был изменён в настройках, укажите его в настройках прокси клиента.
Брандмауэр Windows/ОС может блокировать входящие подключения на порт прокси — разрешите приложение или порт.
Если используется удалённый доступ к машине, убедитесь, что прокси привязан к нужному интерфейсу (в настройках приложения), и что клиент обращается к правильному IP и порту.

При очень большом количестве записей таблица и база могут замедлять интерфейс. Остановите запись (Стоп), при необходимости очистите таблицу или загрузите меньший набор сессий.
Ограничьте размер сохраняемого тела запросов/ответов в настройках (если есть параметры вроде максимального размера тела) — это снижает объём данных и нагрузку на диск и память.
Закройте лишние вкладки браузера и другие приложения, использующие прокси, чтобы уменьшить число одновременных запросов.

Логи и краш-дампы — в каталоге рядом с исполняемым файлом (exe); при сбое запуска — файл startup_error.txt в том же каталоге. Дополнительно логи могут писаться в Documents\NTBot_Recorder\logs (Windows).
В логах ищут сообщения об ошибках (ERROR, CRITICAL) и трассировки исключений — по ним можно уточнить причину сбоя или передать информацию в поддержку.

Ситуации, специфичные для установки из .deb-пакета на Astra Linux:

Проблема	Решение
Не устанавливается, ошибки зависимостей	После `sudo dpkg -i …` выполните `sudo apt-get install -f` — недостающие зависимости доустановятся, установка завершится.
«Address already in use» / порт 8080 занят при повторной записи	Полностью закройте приложение и запустите заново, затем начните новую запись.
Firefox не перехватывается	Полностью закройте Firefox (`pkill -9 firefox`) и откройте снова после установки сертификата.
Ошибка сертификата при входе (`CERTIFICATE_VERIFY_FAILED`)	Администратору — установить CA-сертификат сервера в `/opt/ntbot-recorder/config/ntbot_ca.crt` (см. Установка → первый запуск).
Не запускается из меню	Запустите из терминала командой `ntbot-recorder` — в консоли будет видна причина ошибки.

Журналы на Astra Linux: ~/.local/share/NTBot_Recorder/logs/ntbot_recorder.log.

При необходимости см. также Установка и Быстрый старт.