Каталог частых ошибок и их устранение
В данном справочнике собраны типовые сообщения об ошибках, предупреждения в логах и коды ответов HTTP, с которыми можно столкнуться при эксплуатации RUSEON Core.
Таблица частых ошибок и решений
| Сообщение об ошибке / Код | Подсистема | Причина | Способ решения |
|---|---|---|---|
401 Unauthorized: token has expired | Аутентификация | Срок действия JWT-токена клиента истёк | Обновите токен через /api/v1/auth/refresh или выполните повторный вход через /api/v1/auth/login. |
403 Forbidden: insufficient role permissions | RBAC | У текущей роли пользователя недостаточно прав для выполнения операции | Назначьте пользователю роль operator или admin в панели управления. |
404 Not Found: camera not registered or inactive | REST / Stream | Камера с указанным ID не найдена в базе данных или отключена | Проверьте список камер через GET /api/v1/cameras или добавьте камеру заново. |
503 Service Unavailable: database / storage not ready | Пробы | Диск размонтирован, доступен только на чтение или БД восстанавливается | Проверьте ответ /readyz, права на запись и статус монтирования дисков. |
bind: address already in use | Сеть | Порт 8080, 8554 или 9090 уже занят другим процессом на хосте | Найдите конфликтующий процесс: sudo lsof -i :8080 или измените порт в config.yaml. |
badger: lock file is already acquired | Хранилище | Другой процесс RUSEON или CLI удерживает блокировку /app/data/db | Убедитесь, что к каталогу базы данных обращается только один процесс одновременно. |
RTSP DESCRIBE failed: 401 Unauthorized | Приём RTSP | Неверные, устаревшие или пустые логин/пароль в ссылке на поток камеры | Обновите учётные данные в настройках камеры. Экранируйте спецсимволы в URL. |
WebRTC ICE connection failed | WebRTC | UDP-медиапакеты заблокированы фаерволом или клиент получил локальный IP | Укажите webrtc.public_ip в config.yaml и откройте UDP-порты 50000-50100. |
Slow consumer detected, skipping P-frame | Ring Buffer | Клиент или диск не успевает вычитывать кадры из кольцевого буфера | Предупреждение. Буфер сбрасывает P-кадры для сохранения общей стабильности сервера. |
write /data/recordings: no space left on device | Архиватор | Дисковый раздел заполнен на 100% | Проверьте параметры recording.retention_days и порог min_disk_free_gb. |
Диагностические команды CLI
bash
# Проверка общего статуса службы
ruseon-cli status
# Валидация синтаксиса конфигурации
ruseon-cli config validate -c /etc/ruseon/config.yaml
# Проверка целостности базы данных
ruseon-cli db verify
# Список и статус камер
ruseon-cli cameras list