Краткий ответ
Начните с видимого симптома и стабильного error ID. Сначала проверяйте наиболее вероятный слой, используйте безопасные команды с ожидаемым выводом, меняйте по одному параметру и подтверждайте восстановление edge-ready маршрутом и реальным внешним запросом.
Путь диагностики
- Зафиксируйте error ID, версию agent, ОС, состояние маршрута и время.
- Отдельно проверьте локальный сервис на loopback.
- Выполните
oxaa routes listиoxaa diagnose --network. - Сравните реальный вывод с документированным ожидаемым состоянием.
- Примените минимальное безопасное исправление.
- Отправьте новый внешний запрос и подтвердите локальный ответ.
- Если восстановление не удалось, передайте проверенную и очищенную диагностику в поддержку.
Технические детали
- Стабильный симптом или идентификатор ошибки
- Вероятные причины в порядке диагностики
- Безопасная диагностическая команда и ожидаемый вывод
- Исправление и безопасность повторной попытки
- Проверка восстановления через edge-ready и внешний запрос
- Пакет эскалации без чувствительных данных
Устранение неполадок
Сначала проверьте локальный процесс, порт и scheme. Затем - аутентификацию и часы, DNS, UDP/443, fallback на TCP/443, корпоративный proxy или перехват TLS, владение маршрутом и edge-ready. Используйте oxaa routes list, oxaa diagnose --network и стабильные error ID; перед отправкой диагностики удалите secrets, body и приватные пути.
Как обрабатываются трафик и данные Inspector
На публичном edge завершается публичный TLS, чтобы Oxaa мог определить точный hostname, найти текущий аутентифицированный маршрут и переслать запрос. Сессия между зарегистрированным устройством и Oxaa зашифрована; по ней запрос попадает только в выбранный локальный сервис.
Oxaa хранит ограниченные метаданные аккаунта, маршрута, использования, безопасности, оплаты, поддержки и диагностики, необходимые для работы и защиты сервиса. Capture body в Inspector - отдельное, явно включаемое действие отладки: ограниченная копия request или response body, показанная локальным Inspector, остается на устройстве разработчика и может быть замаскирована, немедленно удалена или автоматически истечь. Публичный трафик все равно обрабатывается на edge; корректная формулировка - «копии Inspector остаются локально», а не «Oxaa не видит трафик».
Очистка и переход к production
Удалите внешний callback, preview URL или DNS-привязку; смените тестовые секреты; удалите локальные capture; остановите маршрут и при необходимости отзовите устройство или сессию. Production-трафик следует перевести на развернутое приложение, production ingress или специализированную платформу доставки событий.
Что такое Oxaa - и чем он не является
Oxaa - это соединение для разработки с выбранным локальным HTTP/HTTPS-сервисом, пока зарегистрированное устройство и аутентифицированный маршрут активны. Это не хостинг, не универсальный VPN, не forward proxy, не постоянный production-деплой, не raw TCP/UDP-туннель, не произвольный TLS passthrough, не замена CDN/WAF и не платформа production-доставки вебхуков.