{"id":12951,"date":"2026-09-09T18:25:00","date_gmt":"2026-09-09T16:25:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=12951"},"modified":"2026-10-24T06:04:55","modified_gmt":"2026-10-24T04:04:55","slug":"tutorial-budowanie-i-sprawdzanie-adresow-rtsp-kamer-ip","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/cctv-pl\/tutorials-pl-cctv-pl\/tutorial-budowanie-i-sprawdzanie-adresow-rtsp-kamer-ip\/","title":{"rendered":"Tutorial: Budowanie i sprawdzanie adres\u00f3w RTSP kamer IP"},"content":{"rendered":"

Adres RTSP wskazuje us\u0142ug\u0119 multimedialn\u0105 i \u017c\u0105dany strumie\u0144. RTSP steruje sesj\u0105; obraz jest cz\u0119sto przesy\u0142any w pakietach RTP. Obs\u0142uga, \u015bcie\u017cki, uwierzytelnianie i transport zale\u017c\u0105 od modelu oraz oprogramowania. Udane po\u0142\u0105czenie jest pierwszym sprawdzeniem, a nie dowodem niezawodnego nagrywania.<\/p>\n

1. Ustalenie w\u0142a\u015bciwego serwera<\/h2>\n

Hostem mo\u017ce by\u0107 kamera, rejestrator, konsola Protect lub serwer przekazuj\u0105cy strumie\u0144. Adres musi wskazywa\u0107 komponent udost\u0119pniaj\u0105cy dany strumie\u0144. Konto kamery nie dzia\u0142a automatycznie na rejestratorze. Port 554 jest typowym portem RTSP, ale rozstrzyga rzeczywista konfiguracja.<\/p>\n

\"RTSP:
Kod stanu to wskaz\u00f3wka, nie pe\u0142na diagnoza<\/figcaption><\/figure>\n

Poni\u017cszy fikcyjny adres pokazuje sk\u0142adniki. Dane logowania w URL s\u0105 konwencj\u0105 obs\u0142ugiwan\u0105 przez klienta i wymagaj\u0105 sprawdzenia zgodno\u015bci. Oddzielne pola logowania s\u0105 lepszym wyborem, je\u015bli aplikacja je udost\u0119pnia.<\/p>\n

rtsp:\/\/viewer:Example%402026@192.0.2.10:554\/Streaming\/Channels\/102\nschemat | u\u017cytkownik:has\u0142o    | host      | port | \u015bcie\u017cka<\/code><\/pre>\n
Host, dane logowania ani port nie s\u0105 identyczne we wszystkich kamerach. Adres IPv6 wymaga nawias\u00f3w kwadratowych, np. rtsp:\/\/[2001:db8::10]:554\/stream<\/code>. Ci\u0105g zapytania mo\u017ce wybiera\u0107 dodatkowe ustawienia. Dok\u0142adne znaczenie wynika z dokumentacji urz\u0105dzenia.<\/p>\n
2. Pobranie \u015bcie\u017cki z urz\u0105dzenia lub dokumentacji<\/h2>\n\n\n\n\n\n\n\n\n
Rodzina urz\u0105dze\u0144<\/th>\nPrzyk\u0142adowa \u015bcie\u017cka<\/th>\n<\/tr>\n<\/thead>\n
Hikvision<\/td>\n\/Streaming\/channels\/101 \u00b7 \/Streaming\/channels\/102<\/code><\/td>\n<\/tr>\n
Amcrest IP<\/td>\n\/cam\/realmonitor?channel=1&subtype=0<\/code><\/td>\n<\/tr>\n
Reolink<\/td>\n\/Preview_01_main \u00b7 \/Preview_01_sub<\/code><\/td>\n<\/tr>\n
Axis<\/td>\n\/axis-media\/media.amp?streamprofile=PROFILE<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
To przyk\u0142ady, nie uniwersalne adresy. We wzorcu Hikvision numer kana\u0142u poprzedza dwucyfrowe oznaczenie strumienia: kana\u0142 12 i strumie\u0144 02 daj\u0105 1202. Kana\u0142 nie zawsze oznacza fizyczny obiektyw. Parametr rozdzielczo\u015bci Axis \u017c\u0105da obs\u0142ugiwanego rozmiaru, a nie automatycznie sta\u0142ego \u201epodstrumienia\u201d.<\/p>\n
W zgodnej us\u0142udze multimedialnej ONVIF GetProfiles<\/code> wskazuje dost\u0119pne profile. GetStreamUri<\/code> \u017c\u0105da URI dla wybranego profilu i transportu. Nadal wymagaj\u0105 sprawdzenia uwierzytelnianie, osi\u0105galno\u015b\u0107 i zgodno\u015b\u0107 klienta. Zwr\u00f3cony adres prywatny nie jest automatycznie dost\u0119pny z innej sieci.<\/p>\n
Oficjalna lista port\u00f3w Ubiquiti wymienia dla Protect zar\u00f3wno RTSPS na 7441, jak i RTSP na 7447. Wcze\u015bniejsze twierdzenie o sta\u0142ym odrzucaniu zwyk\u0142ego RTSP by\u0142o zbyt szerokie. Skonfigurowany, obs\u0142ugiwany adres eksportu i wersja konsoli maj\u0105 pierwsze\u0144stwo przed zgadywaniem zmian w URL.<\/p>\n
3. Kodowanie danych logowania nie jest szyfrowaniem<\/h2>\n
Znaki zastrze\u017cone mog\u0105 zmienia\u0107 spos\u00f3b podzia\u0142u URL. Nazwa u\u017cytkownika i has\u0142o wymagaj\u0105 oddzielnego kodowania: @ \u2192 %40<\/code>, \/ \u2192 %2F<\/code>, # \u2192 %23<\/code>, ? \u2192 %3F<\/code>, % \u2192 %25<\/code> oraz spacja \u2192 %20<\/code>. Dwukropek zapisany jako %3A<\/code> usuwa niejednoznaczno\u015b\u0107, lecz dwukropek wewn\u0105trz informacji o u\u017cytkowniku nie zawsze ko\u0144czy to pole. Warto\u015bci ju\u017c zakodowanej nie nale\u017cy kodowa\u0107 ponownie.<\/p>\n
Kodowanie procentowe jest odwracalne i nie zapewnia poufno\u015bci. Digest nie przesy\u0142a samego has\u0142a otwartym tekstem, ale nie szyfruje obrazu i nie jest gwarantowanym sposobem logowania ka\u017cdej kamery. Basic bez ochrony transportu ujawnia dane mo\u017cliwe do odzyskania. RTSPS chroni po\u0142\u0105czenie steruj\u0105ce przez TLS; ochrona medi\u00f3w zale\u017cy od uzgodnionego transportu.<\/p>\n
Oddzielne konto podgl\u0105du ogranicza uprawnienia. Adresy i identyfikatory nadal wymagaj\u0105 ochrony w argumentach proces\u00f3w, dziennikach i konfiguracji. Lokalne kodowanie pozwala unikn\u0105\u0107 wysy\u0142ania prawdziwego has\u0142a do internetowego kodera.<\/p>\n
4. Sprawdzenie metadanych z limitem czasu<\/h2>\n
Przyk\u0142ad dla Basha wymaga ffprobe i GNU timeout<\/code>. Odczytuje URL bez wy\u015bwietlania na terminalu, \u017c\u0105da transportu TCP wewn\u0105trz kana\u0142u steruj\u0105cego i zwraca metadane pierwszego strumienia wideo. Wpisany adres nie staje si\u0119 dos\u0142ownym poleceniem historii pow\u0142oki. Rozwini\u0119ty argument nadal mo\u017ce by\u0107 widoczny przy uprawnionym sprawdzaniu proces\u00f3w lub w b\u0142\u0119dach.<\/p>\n
IFS= read -r -s -p 'RTSP URL: ' RTSP_URL\nprintf '\\n'\ntimeout -k 2s 15s ffprobe -v error \\\n  -rtsp_transport tcp -timeout 5000000 \\\n  -select_streams v:0 \\\n  -show_entries stream=codec_name,width,height,avg_frame_rate \\\n  -of json "$RTSP_URL"\nprobe_status=$?\nunset RTSP_URL\nprintf 'Exit status: %s\\n' "$probe_status"<\/code><\/pre>\n
-timeout 5000000<\/code> ogranicza oczekiwanie na operacje gniazda RTSP do pi\u0119ciu sekund w sprawdzonej wersji FFmpeg 7.1.5. Zewn\u0119trzne polecenie nak\u0142ada osobny limit 15 sekund oraz dalsze dwie sekundy przed wymuszonym zako\u0144czeniem. GNU timeout zwykle zwraca kod 124 po przekroczeniu limitu. Poprawnie dzia\u0142aj\u0105ca kamera nie musi odpowiedzie\u0107 w dwie sekundy.<\/p>\n
Kodek i rozmiar w JSON potwierdzaj\u0105 przydatne metadane, nie ci\u0105g\u0142y odbi\u00f3r pakiet\u00f3w ani udane dekodowanie. Brak pozycji wideo nie oznacza zaliczonego testu obrazu. Nast\u0119pnie odtwarzacz i reprezentatywne nagranie powinny sprawdzi\u0107 rzeczywiste klatki, ruch, zmian\u0119 dnia i nocy oraz ponowne po\u0142\u0105czenie.<\/p>\n\n\n\n\n\n\n
401 Unauthorized<\/th>\nUwierzytelnianie jest wymagane albo nie powiod\u0142o si\u0119. Pierwsze \u017c\u0105danie logowania mo\u017ce by\u0107 normalne; poprawno\u015b\u0107 \u015bcie\u017cki nie jest dowiedziona.<\/td>\n<\/tr>\n
404 Not Found<\/th>\nNie znaleziono \u017c\u0105danego zasobu. Sam kod nie potwierdza przyj\u0119cia danych logowania.<\/td>\n<\/tr>\n
Connection refused<\/th>\nPunkt ko\u0144cowy lub po\u015brednik odrzuci\u0142 po\u0142\u0105czenie TCP. Sprawdzenia wymagaj\u0105 cel, port, us\u0142uga i zapora.<\/td>\n<\/tr>\n
Timeout<\/th>\nPo\u0142\u0105czenie lub odczyt nie zako\u0144czy\u0142 si\u0119 w terminie. Analizy wymagaj\u0105 etap, transport, trasa, obci\u0105\u017cenie i dzienniki.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Przeplatanie TCP pozwala unikn\u0105\u0107 osobnych port\u00f3w UDP dla medi\u00f3w. Nie naprawia b\u0142\u0119dnej \u015bcie\u017cki, nieobs\u0142ugiwanego kodeka, braku uprawnie\u0144 ani utraty \u0142\u0105czno\u015bci. UDP r\u00f3wnie\u017c mo\u017ce by\u0107 odpowiednie; utrata pakiet\u00f3w i buforowanie decyduj\u0105 o praktycznej r\u00f3\u017cnicy op\u00f3\u017anienia.<\/p>\n
5. \u015awiadomy podzia\u0142 detekcji i nagrywania<\/h2>\n
Frigate pozwala przypisa\u0107 wej\u015bciom role detect<\/code> i record<\/code>. Fragment pokazuje role dla potwierdzonej \u015bcie\u017cki w stylu Hikvision. Pe\u0142na konfiguracja wymaga tak\u017ce w\u0142a\u015bciwych ustawie\u0144 nagrywania i walidacji w zainstalowanej wersji Frigate.<\/p>\n
cameras:\n  driveway:\n    ffmpeg:\n      inputs:\n        - path: "rtsp:\/\/{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@192.0.2.10:554\/Streaming\/Channels\/102"\n          input_args: preset-rtsp-generic\n          roles: [detect]\n        - path: "rtsp:\/\/{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@192.0.2.10:554\/Streaming\/Channels\/101"\n          input_args: preset-rtsp-generic\n          roles: [record]<\/code><\/pre>\n
Podstawianie zmiennych \u015brodowiskowych dzia\u0142a tylko w udokumentowanych polach konfiguracji. Zmienna has\u0142a zawiera tutaj warto\u015b\u0107 zakodowan\u0105 dla URL. Chroniony plik \u015brodowiskowy ogranicza przypadkowe udost\u0119pnienie; warto\u015bci w dzia\u0142aj\u0105cym procesie nie staj\u0105 si\u0119 przez to sejfem na sekrety.<\/p>\n
Mniejszy strumie\u0144 detekcji mo\u017ce ograniczy\u0107 dekodowanie, ale odleg\u0142e obiekty mog\u0105 by\u0107 zbyt ma\u0142e. Przy tym samym kadrze zmiana szeroko\u015bci z 3840 na 640 pikseli zmniejsza liniow\u0105 g\u0119sto\u015b\u0107 do jednej sz\u00f3stej. Je\u015bli idealizowany obiekt zajmowa\u0142 172,8 piksela, po skalowaniu zostaje 28,8 piksela. Kadrowanie, perspektywa i kodowanie mog\u0105 zmieni\u0107 wynik praktyczny. To nie gwarancja wykrycia.<\/p>\n
\n
Pytania i odpowiedzi<\/h2>\n
Czy go2rtc zawsze potrzebuje jednego po\u0142\u0105czenia z kamer\u0105?<\/h3>\n
Kilku odbiorc\u00f3w mo\u017ce wsp\u00f3\u0142dzieli\u0107 jeden strumie\u0144 wej\u015bciowy. R\u00f3\u017cne \u017ar\u00f3d\u0142a strumienia g\u0142\u00f3wnego i podstrumienia nadal mog\u0105 wymaga\u0107 osobnych po\u0142\u0105cze\u0144 z kamer\u0105. Limity sesji zale\u017c\u0105 od modelu; uniwersalna granica dw\u00f3ch lub czterech sesji jest nieuzasadniona.<\/p>\n
Czy rezerwacja DHCP rozwi\u0105zuje ka\u017cd\u0105 p\u00f3\u017aniejsz\u0105 awari\u0119?<\/h3>\n
Rezerwacja pomaga utrzyma\u0107 przewidywalny adres. Konflikty adres\u00f3w, routing, zasilanie, oprogramowanie, ustawienia us\u0142ug i zmiany kont pozostaj\u0105 mo\u017cliwe. Restart routera nie musi zmienia\u0107 dzier\u017cawy adresu.<\/p>\n
Dlaczego strumie\u0144 urywa si\u0119 po pewnym czasie?<\/h3>\n
Dzienniki powinny rozr\u00f3\u017cnia\u0107 utrat\u0119 transportu, wyga\u015bni\u0119cie sesji i restart klienta lub urz\u0105dzenia. Znaczenie maj\u0105 obs\u0142ugiwany mechanizm RTSP keepalive i limit sesji serwera; brak informacji RTCP nie jest jedynym wyja\u015bnieniem. Automatyczne ponowne \u0142\u0105czenie mo\u017ce przywr\u00f3ci\u0107 us\u0142ug\u0119 bez ustalenia pierwotnej przyczyny.<\/p>\n<\/div>\n
\n
\u0179r\u00f3d\u0142a<\/h2>\n