Как безопасно составить и проверить RTSP-URL камеры

RTSP-URL состоит из нескольких частей: схемы, адреса камеры, необязательного порта, учётных данных и пути, который зависит от производителя. Один неверный символ может дать такое же пустое превью, как и заблокированная сеть, поэтому проверяйте каждое предположение, не передавая никому полный URL с учётными данными.

Это руководство предназначено для внешней IP-камеры. Встроенные камеры принтеров должны оставаться подключёнными через поддерживаемую интеграцию принтера.

Printer Tools

Все ваши 3D-принтеры на одной панели

Следите за принтерами Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo и Prusa в одном приложении

Доступно на Android, iPhone, iPad и Mac, с приложениями-компаньонами для Apple Watch и Wear OS и дополнительным удалённым доступом через VPN, OctoEverywhere или Obico

Начните с документации камеры

Найдите раздел о RTSP для конкретной модели камеры и версии прошивки. Внешне похожая модель может использовать другой путь или требовать предварительного включения RTSP.

Запишите локальный IP-адрес, порт RTSP, путь к потоку и то, требует ли камера локального пользователя. Не копируйте в рабочую сеть публичный пример с учётными данными по умолчанию.

Разберитесь в структуре URL

Типичная структура — rtsp://user:password@camera-address:port/path, но каждый элемент после схемы зависит от устройства. Некоторые приложения принимают учётные данные в отдельных полях и формируют URL с аутентификацией самостоятельно.

Если Printer Tools предлагает отдельные поля для учётных данных, используйте их. Так не придётся редактировать секрет внутри длинной строки, и ошибок с зарезервированными символами будет меньше.

Правильно кодируйте специальные символы

Такие символы, как @, :, /, ? и #, имеют особое значение в URL. Пароль, содержащий их, может потребовать процентного кодирования при вставке в URL.

Не ослабляйте пароль только ради того, чтобы обойтись без кодирования. Используйте функцию локальной учётной записи камеры и формат ввода, который запрашивает Printer Tools.

Проверяйте из той же сети

Сначала убедитесь, что устройство может достучаться до адреса камеры. Затем добавьте поток в Printer Tools и дождитесь первоначального согласования. Тайм-аут указывает на маршрутизацию или заблокированный порт; ошибка аутентификации — на имя пользователя, пароль или права учётной записи; ответ «не найдено» — на путь к потоку.

Проверьте всё в основной локальной сети, прежде чем разбираться с гостевой сетью или VPN. Когда всё заработает, зарезервируйте адрес камеры в DHCP.

Выберите основной или дополнительный поток

Основной поток даёт больше деталей, но может перегрузить Wi-Fi или мобильный декодер. Дополнительного потока с умеренным разрешением и частотой кадров часто достаточно, чтобы проверить адгезию и ход печати.

Начните с меньших настроек, убедитесь в стабильности и повышайте качество, только если у устройства наблюдения и сети есть запас.

Никогда не публикуйте полный URL

URL RTSP с аутентификацией может в одной строке раскрыть адрес камеры, имя пользователя и пароль. Скрывайте учётные данные и частные адреса на скриншотах, в журналах и сообщениях в поддержку.

Если URL утёк, смените пароль камеры. Удалить сообщение недостаточно, потому что могут остаться копии.

Удалённый доступ — через VPN

RTSP не рассчитан на прямой доступ через домашний роутер. Не настраивайте проброс портов. Подключайтесь через доверенный VPN, чтобы Printer Tools обращался к тому же частному адресу, что и дома.

Для автоматического обнаружения профилей используйте руководство по ONVIF-камерам.

Часто задаваемые вопросы

Порт 554 всегда правильный?

Он распространён, но камера может использовать другой порт. Следуйте точной конфигурации устройства.

Почему мой пароль ломает URL?

Зарезервированные символы могут восприниматься как разделители URL. Используйте отдельные поля или правильное процентное кодирование.

Основной поток всегда лучше?

Нет. Дополнительный поток может давать более надёжное превью на панели при гораздо меньшей пропускной способности.

Можно ли отправить URL в поддержку?

Не отправляйте URL с аутентификацией без скрытия данных. Вместо этого укажите ошибку и очищенную структуру.

Официальные источники: RFC 7826 — RTSP 2.0 · RFC 3986 — URI percent-encoding · ONVIF — Profile S