Устранение неполадок
Симптом → причина → что проверить: вход, сокет, сохранение, экспорт, вебхук, агенты.
Статус: доступно
обновлено 2026-10-28
Вход и доступ
| Симптом |
Причина |
Что проверить |
| Вход «проходит», но сессии нет |
нет HTTPS при NODE_ENV=production |
cookie Secure не сохраняется без TLS |
401 AUTH_REQUIRED при наличии аккаунта |
cookie потеряна или истекла |
срок сессии 30 дней, домен и SameSite |
403 FORBIDDEN на действие |
роль не даёт capability |
таблица ролей и источники роли |
404 на доску, которая есть |
другой аккаунт или организация |
доступ и organization в адресе |
| Ссылка не открывается |
выключена, истекла или сменился пароль |
блок Публичная ссылка |
| Не видно обсуждения |
вы вошли по ссылке без аккаунта или роль ниже Комментарии |
аккаунт и роль на доске |
| Не снимается замок |
объект заблокировал другой человек |
попросить автора или менеджера доски |
Сокет и сохранение
| Симптом |
Причина |
Что проверить |
| Правки не видны другим |
сокет не подключён |
индикатор, 101 Switching Protocols в сети |
Индикатор стоит на connecting |
прокси не пропускает WebSocket |
location /sync/ и заголовки Upgrade |
офлайн (N) не уходит |
связь не восстановилась |
сеть, затем перезагрузка вкладки |
ввод остановлен |
очередь достигла 1000 изменений |
восстановите связь; правки в очереди сохранятся |
| После отзыва доступа правки не принимаются |
вкладка в режиме чтения |
это ожидаемое поведение |
Экспорт и бэкап
| Симптом |
Причина |
Что проверить |
| «В этом скоупе нечего экспортировать» |
нет выделения для выбранного скоупа |
выделите объекты или фрейм |
| Нет варианта бэкапа |
у роли нет 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 |
Куда дальше
Известные проблемы — ограничения, которые не являются дефектами.