remo · документация
AI EN

Устранение неполадок

Симптом → причина → что проверить: вход, сокет, сохранение, экспорт, вебхук, агенты.

Статус: доступно обновлено 2026-11-06

Вход и доступ

Симптом Причина Что проверить
Вход «проходит», но сессии нет нет HTTPS при NODE_ENV=production cookie Secure не сохраняется без TLS
401 AUTH_REQUIRED при наличии аккаунта cookie потеряна или истекла срок сессии 30 дней, домен и SameSite
403 FORBIDDEN на действие роль не даёт capability таблица ролей и источники роли
403 UNCLAIMED на комнату у комнаты нет владельца закрепите комнату по ссылке; если это невозможно — обратитесь к оператору установки, он назначит владельца или архивирует комнату; автоматического удаления нет
404 на комнату, которая есть другой аккаунт или организация доступ и ?org=<slug> в адресе
Ссылка не открывается выключена, истекла или сменился пароль блок Публичная ссылка
Не видно обсуждения вы вошли по ссылке без аккаунта или роль ниже Комментарии аккаунт и роль в комнате
Не снимается замок объект заблокировал другой человек попросить автора или менеджера комнаты

Сокет и сохранение

4429 и 4413 — коды закрытия сокета, а не ответы API. В обоих случаях правки остаются в текущей вкладке и уходят после следующего подключения.

Симптом Причина Что проверить
Правки не видны другим сокет не подключён индикатор, 101 Switching Protocols в сети
Индикатор стоит на connecting прокси не пропускает WebSocket location /sync/ и заголовки Upgrade
офлайн (N) не уходит связь не восстановилась сеть, затем перезагрузка вкладки
ввод остановлен очередь достигла 1000 изменений восстановите связь; правки в очереди сохранятся
Соединение закрыто с 4429 превышен бюджет записи: 256 КиБ/с на сокет (всплеск 16 МиБ) или 2 МиБ/с на организацию (всплеск 64 МиБ) размер правки и число открытых вкладок; повтор через 5 с, затем пауза растёт до 60 с
Соединение закрыто с 4413 комната заполнена: 64 МиБ или 20 000 объектов размер комнаты, число объектов и последние крупные вставки; повтор через 30 с, затем пауза растёт до 5 мин
Кадр больше 16 МиБ не принимается правка превышает предел одного кадра уменьшите вставку или разбейте её на части; комната при этом может быть не заполнена
В заполненной комнате не проходит вставка правка больше 16 КиБ при полной комнате разбейте вставку; правки существующих объектов сохраняются
Новые объекты не создаются достигнут потолок 20 000 объектов число объектов; изменение существующих сохраняется, новые отклоняются
После отзыва доступа правки не принимаются вкладка в режиме чтения это ожидаемое поведение

Экспорт и бэкап

Симптом Причина Что проверить
«В выбранной области нет объектов для экспорта» в выбранной области нет объектов выделите объекты или фрейм
Нет варианта бэкапа у роли нет board.backup роль редактора и выше
Импорт отклонён повреждённый файл или неверная контрольная сумма целостность JSON и manifest
PDF пустой визуализация идёт в браузере отключённые расширения, размер комнаты

События и интеграции

Симптом Причина Что проверить
Событие не пришло эндпоинт не настроен или отвечает не 2xx GET …/webhook/deliveries
События копятся в DLQ эндпоинт стабильно недоступен dead=1, lastError, затем replay
401 INTEGRATION_TOKEN_* токен неизвестен, отозван или истёк выпустите новый
403 SCOPE_REQUIRED у токена нет нужного scope board.read / board.edit
409 WEBHOOK_LOCKED не задан REMO_KEK ключ и его резерв

Агенты

Симптом Причина Что проверить
AI_NOT_CONFIGURED нет ключа провайдера REMO_AI_* или ключ в интерфейсе
AGENT_DENIED агенты выключены, нет прав или скилл запрещён политика организации и роль владельца
BUDGET_REQUIRED задача без бюджета задайте бюджет
Задача в очереди лимит одновременных задач дождитесь или уменьшите нагрузку

Документация

Симптом Причина Что проверить
/guide/ отвечает 404 портал не собран или не скопирован pnpm guide:build, rsync в /srv/remo/docs-site/
/guide/ открыт, но /help/… не работает локальный просмотр на другом порту в production оба на одном origin

Куда дальше

Известные проблемы — ограничения, которые не являются дефектами.