Skip to main content

​
Устранение неполадок узлов

Используйте эту страницу, когда узел виден в статусе, но инструменты узла не работают.

​
Командная лестница

Затем выполните проверки, специфичные для узла:
Здоровые сигналы:
  • Узел подключён и сопряжён для роли node.
  • nodes describe включает вызываемую вами возможность.
  • Подтверждения выполнения команд (exec approvals) показывают ожидаемый режим/список разрешённых.

​
Требования переднего плана

canvas.*, camera.* и screen.* доступны только при активном приложении на узлах iOS/Android. Быстрая проверка и исправление:
Если вы видите NODE_BACKGROUND_UNAVAILABLE, выведите приложение узла на передний план и повторите попытку.

​
Матрица разрешений

​
Сопряжение и подтверждения выполнения

Это разные «шлюзы» доступа:
  1. Сопряжение устройства: может ли этот узел подключиться к Gateway (шлюзу)?
  2. Подтверждения exec: может ли этот узел выполнить конкретную команду оболочки?
Быстрые проверки:
Если сопряжение отсутствует, сначала подтвердите устройство узла. Если с сопряжением всё в порядке, но system.run не проходит, исправьте подтверждения exec/список разрешённых.

​
Распространённые коды ошибок узлов

  • NODE_BACKGROUND_UNAVAILABLE → приложение в фоне; выведите его на передний план.
  • CAMERA_DISABLED → тумблер камеры отключён в настройках узла.
  • *_PERMISSION_REQUIRED → отсутствует/отклонено разрешение ОС.
  • LOCATION_DISABLED → режим геолокации выключен.
  • LOCATION_PERMISSION_REQUIRED → запрошенный режим геолокации не предоставлен.
  • LOCATION_BACKGROUND_UNAVAILABLE → приложение в фоне, но есть разрешение только «При использовании».
  • SYSTEM_RUN_DENIED: approval required → запрос exec требует явного подтверждения.
  • SYSTEM_RUN_DENIED: allowlist miss → команда заблокирована режимом списка разрешённых.

​
Быстрый цикл восстановления

Если всё ещё не удаётся:
  • Повторно подтвердите сопряжение устройства.
  • Снова откройте приложение узла (передний план).
  • Повторно выдайте разрешения ОС.
  • Пересоздайте/настройте политику подтверждений exec.
Связанное: