---
url: https://docs.ogmabox.com/ru/troubleshooting.md
description: >-
  Диагностируйте типичные проблемы настройки Ogma, записи прокси, HTTPS,
  десктопной среды, плагинов, MCP, сканера и экспорта.
---

# Решение проблем {#troubleshooting}

Эта страница помогает диагностировать типичные проблемы настройки и работы Ogma.

## В истории HTTP нет трафика {#no-traffic-appears-in-http-history}

Проверьте:

1. Экземпляр Ogma запущен.
2. Прокси браузера или приложения указывает на слушатель, обычно `127.0.0.1:8080`.
3. Целевое приложение не обходит прокси.
4. Настройки VPN, системного прокси, контейнера, эмулятора или мобильного прокси не переопределяют тестовый клиент.
5. Активный проект открыт в пространстве.

В браузере Ogma откройте новую вкладку и убедитесь в наличии метки **Через прокси**.

## Запросы HTTPS не работают {#https-requests-fail}

Проверьте:

* CA Ogma установлен в нужное хранилище доверия.
* CA импортирован в фактически используемый профиль.
* Цель не использует certificate pinning.
* Правила сквозной передачи TLS не исключают хост.
* Клиентские сертификаты заданы в **Настройки > Клиентские сертификаты**, если нужен mTLS.

Для мобильных или десктопных приложений с pinning может требоваться отдельная настройка тестирования за пределами Ogma.

## Перехват задерживает слишком много трафика {#intercept-pauses-too-much-traffic}

Используйте более узкие правила.

Рекомендуемые шаги:

1. Отключите перехват.
2. Задайте область.
3. Добавьте условия хоста, метода, пути, типа содержимого или заголовка.
4. Включите перехват снова.
5. Следите за размером очереди.

При заполнении очереди Ogma передаёт новый трафик во избежание блокировки клиента.

## Сканер создаёт слишком много шума {#scanner-reports-too-much-noise}

Для пассивного сканера:

* Активируйте область перед сканированием.
* Сначала изучайте результаты проверки безопасности со средней, высокой и критической критичностью.
* Учитывайте контекст для отсутствующих заголовков.
* Используйте свои правила для доказательств конкретного проекта.

Для активного сканера:

* Проверяйте выбранные запросы перед всей историей.
* Изучайте доказательные запросы и тела ответов.
* Убедитесь, что доказательство отсутствовало в базовом ответе.
* Проверьте, имеет ли результат уверенность «вероятно» или «подтверждено».

## Плагины не загружаются {#plugins-do-not-load}

Проверьте:

1. В корне есть `manifest.json`.
2. Пути точек входа существуют после сборки.
3. Плагин скомпилирован в обычный JavaScript.
4. Ресурсы интерфейса включены в пакет.
5. Нужные разрешения объявлены и выданы.
6. В журнале нет ошибок `init()` или моста.
7. Размер пакета ниже заданного предела.

## MCP-помощник не видит Ogma {#mcp-assistant-cannot-see-ogma}

Проверьте:

* Встроенный HTTP: MCP запущен в **Настройки > MCP**, клиент использует скопированный адрес Streamable HTTP, обычно `http://127.0.0.1:3000/mcp`.
* Отдельный stdio: путь к бинарному файлу корректен, `--api-url` / `OGMA_API_URL` соответствует работающему серверу. Десктопные экземпляры могут использовать динамический порт API.
* Клиент проходит все курсоры `tools/list`; первая страница не содержит всех инструментов.
* Инструменты записи или отправки требуют явных разрешений настроек или флагов отдельного процесса.
* Переподключитесь после перезапуска MCP. Старые ID сессий и токены подтверждения недействительны.

См. [Настройка MCP](./mcp-setup.md).

## Браузер Ogma пуст или расположен неверно {#ogma-browser-is-blank-or-mispositioned}

Проверьте:

* Запущено десктопное приложение, а не только веб-интерфейс.
* Активная вкладка имеет настоящий URL вместо `about:blank`.
* Попробуйте отдельное окно браузера.
* Измените размер окна Ogma для пересчёта границ браузера.

## Свой JavaScript или CSS ломает интерфейс {#custom-javascript-or-css-breaks-the-ui}

Используйте один способ восстановления:

* Нажмите **Сбросить пользовательский интерфейс**.
* Нажмите `Ctrl+Alt+Shift+R`.

Это удаляет свой JavaScript и CSS из локального хранилища, десктопных настроек и серверных настроек, затем перезагружает Ogma.

## Данные или проект выглядят неправильно {#data-or-project-looks-wrong}

Проверьте:

* Открыт нужный экземпляр.
* Активен нужный проект.
* Стартовые настройки не открыли другой экземпляр.
* Фильтры или область не скрывают ожидаемые строки.
* Скрытие статических ресурсов не исключает искомый тип содержимого.

Создайте резервную копию перед ручными изменениями данных проекта.