Устранение неполадок с камерами и приёмом RTSP
В данном руководстве собраны типовые причины сбоев при подключении IP-камер, обрывов RTSP-потоков и появления визуальных артефактов, а также пошаговые инструкции по их устранению.
1. Камера находится в статусе offline
Если камера переходит в статус offline, проверьте поле last_error через REST API (GET /api/v1/cameras/{id}) или утилиту CLI:
bash
# Проверка детального статуса камеры
ruseon-cli cameras status --id cam_entranceТиповые причины и способы устранения:
| Текст ошибки / Симптом | Причина | Способ решения |
|---|---|---|
401 Unauthorized | Неверный логин или пароль RTSP | Проверьте учётные данные. Специальные символы (@, :, #) в URL должны быть экранированы в формате URL-encoding (например, %40). |
i/o timeout / connection refused | Камера недоступна по сети | Проверьте доступность IP-адреса камеры командой ping <IP> и доступность порта RTSP командой nc -zv <IP> 554. |
RTSP DESCRIBE failed: 404 Stream Not Found | Неверный путь потока | Проверьте синтаксис RTSP-ссылки (например, /h264Preview_01_main для Reolink, /Streaming/Channels/101 для Hikvision, /cam/realmonitor?channel=1&subtype=0 для Dahua). |
max connections reached | Превышен лимит подключений на камере | Уменьшите число одновременных RTSP-клиентов на камере. RUSEON должен быть единственным получателем потока с последующей ретрансляцией. |
2. Проверка RTSP-потока через FFmpeg
Вы можете протестировать поток независимо от сервера с помощью утилит ffprobe и ffmpeg:
bash
# Анализ кодека, разрешения и метаданных SPS/PPS
ffprobe -rtsp_transport tcp -v verbose "rtsp://admin:password@192.168.1.50:554/live"
# Тестовый приём пакетов без декодирования на 10 секунд
ffmpeg -rtsp_transport tcp -i "rtsp://admin:password@192.168.1.50:554/live" -t 10 -f null -3. Неподдерживаемый видеокодек или формат аудио
RUSEON Core производит прямой трансмуксинг без перекодирования и поддерживает:
- Видео:
H.264 (AVC)иH.265 (HEVC). - Аудио:
AAC,Opus(для прямого проброса в WebRTC) иG.711 (PCMU/PCMA).
Если на камере включен кодек MJPEG или MPEG-4, сервер отклонит медиатрек.
- Решение: Откройте веб-интерфейс камеры (настройки видео/кодирования) и выберите кодек H.264 или H.265.
4. Частые переподключения и "зелёные квадраты" (артефакты сжатия)
Зелёные квадраты и смазывание картинки возникают при потере P-кадров:
- Переключение на TCP: Укажите
transport: "tcp"в настройках камеры для устранения потерь пакетов UDP. - Настройка интервала ключевых кадров (GOP): В веб-интерфейсе камеры установите интервал I-кадров равным 1-2 секундам (например, при 25 fps GOP = 25 или 50). Избегайте интервалов GOP более 4 секунд.