2026-06-03

RTSP 집계 제어 URL 디버깅: SDP 제어:*, 추적 URL, SETUP 404 및 PLAY 실패

RTSP 집계 제어 URL, SDP 제어:* 속성, 트랙 수준 제어 경로, SETUP 404 오류, PLAY 실패 및 카메라 URL 구성 버그 문제를 해결하는 방법입니다.

클라이언트가 SDP에서 잘못된 제어 URL을 구축하기 때문에 RTSP 카메라 URL이 실패하는 경우가 많습니다. 카메라가 SDP를 성공적으로 반환했지만 미디어가 시작되지 않으면 사용자는 "RTSP SETUP 404", "SDP 제어 별", "RTSP 집계 제어 URL", "RTSP 트랙 URL이 잘못됨", "DESCRIBE 작동하지만 SETUP 실패" 및 "SETUP 후 재생 실패"를 검색합니다.

RTSP Inspector는 이 실패가 플레이어가 비디오를 그릴 수 있는지 여부에 관한 것이 아니기 때문에 유용합니다. RTSP 클라이언트가 세션 수준 및 미디어 수준 control 속성을 올바르게 해석했는지 여부에 관한 것입니다.

일반적인 증상

일반적인 추적은 다음과 같습니다.

DESCRIBE rtsp://camera/live
200 OK
SDP contains a=control:*
SDP video media contains a=control:trackID=1
SETUP rtsp://camera/trackID=1
404 Not Found

Session-level and media-level control

a=control:*
m=video 0 RTP/AVP 96
a=control:trackID=1
m=audio 0 RTP/AVP 97
a=control:trackID=2

세션 수준 제어는 'PLAY' 및 'PAUSE'에 사용되는 집계 리소스를 식별할 수 있습니다. 미디어 수준 컨트롤은 'SETUP'에 사용되는 각 RTP 트랙을 식별합니다.

클라이언트가 모든 control 값을 절대 경로로 취급하는 경우 잘못된 URL을 생성할 수 있습니다.

상대 및 절대 제어 URL

RTSP SDP 제어 값은 다음과 같습니다.

절대 RTSP URL.
상대 경로.
트랙 식별자.
* 집계 제어.
공급업체별 경로.

예:

a=control:rtsp://192.168.1.10/live/trackID=1
a=control:trackID=1
a=control:streamid=0
a=control:video
a=control:*

DESCRIBE succeeds but SETUP fails

Evidence to collect:

Content-Base and Content-Location

Failure patterns:

PLAY uses aggregate control

Search symptoms:

Multi-track audio and video

m=video ...
a=control:trackID=1
m=audio ...
a=control:trackID=2

클라이언트는 자체 제어 URL을 사용하여 두 트랙을 모두 설정한 다음 올바른 집계 URL을 재생해야 합니다. 클라이언트가 비디오만 설정했지만 PLAY가 오디오를 대상으로 하거나 두 트랙을 하나의 SETUP URL로 병합하는 경우 카메라는 관련이 없어 보이는 오류를 반환할 수 있습니다.

ONVIF 프로필 URL과 RTSP 트랙 URL 비교

ONVIF는 최종 SDP 트랙 URL과 다른 스트림 URI를 보고할 수 있습니다. ONVIF의 스트림 URI는 DESCRIBE에는 유효할 수 있지만 모든 SETUP 요청에는 직접적으로 유효하지 않을 수 있습니다.

그러면 "ONVIF는 작동하지만 RTSP URL은 실패합니다."라는 일반적인 지원 문구가 생성됩니다. 다음 진단 단계는 새로운 ONVIF URL을 계속 생성하는 것이 아니라 SDP 및 파생된 SETUP URL을 검사하는 것입니다.

디버그 체크리스트

다음 워크플로를 사용하세요.

DESCRIBE 응답을 캡처합니다.
'Content-Base' 및 'Content-Location'을 저장합니다.
세션 수준 a=control을 추출합니다.
각 미디어 수준 a=control을 추출합니다.
예상되는 SETUP URL을 수동으로 작성하십시오.
클라이언트 SETUP URL과 비교해보세요.
404, 461, 500으로 인해 SETUP이 실패하는지 확인하세요.
PLAY가 집계 또는 추적 URL을 타겟팅하는지 확인하세요.
멀티트랙 오디오/비디오 동작을 확인하세요.
공급업체 지원을 위해 정확한 RTSP 요청 라인을 유지하세요.

최종 진단

RTSP 집계 제어 버그는 SDP 해석 내부에 숨겨져 있습니다. 클라이언트가 잘못된 트랙이나 집계 제어 URL을 구축한 경우 카메라는 DESCRIBE를 허용하면서도 SETUP 또는 PLAY를 계속 거부할 수 있습니다.

RTSP Inspector는 SDP 제어 속성, 콘텐츠 기반 헤더, SETUP URL 및 PLAY 대상을 노출하여 엔지니어가 문제가 URL 구성, 카메라 엄격성, 프록시 재작성 또는 클라이언트 측 SDP 처리인지 증명할 수 있도록 도와줍니다.

“RTSP 집계 제어 URL 디버깅: SDP 제어:*, 추적 URL, SETUP 404 및 PLAY 실패”을 재현 가능하게 검증하는 방법

직접적인 답은 검은 화면이나 상태 코드 하나만으로 장애 위치를 증명할 수 없다는 것입니다. 신뢰할 수 있는 진단은 RTSP 요청과 응답, 합의된 Transport, 유효한 Session, 이어지는 RTP 시퀀스 번호와 타임스탬프, RTCP 근거를 하나의 시간선으로 연결합니다. “RTSP 집계 제어 URL 디버깅: SDP 제어:*, 추적 URL, SETUP 404 및 PLAY 실패”에서는 보이는 증상에 가까운 계층부터 시작하되 제어, 네트워크, 디코더 문제를 섞지 않도록 같은 기록 시계를 사용합니다.

카메라, 방화벽, VMS 설정을 바꾸기 전에 작은 기준 시험을 만드십시오. 비밀번호를 제거한 RTSP URL, 시험 시각, 경로, 요청 Transport, 서버 응답, 첫 미디어 패킷 도착 시각을 기록합니다. 장비가 지원하면 UDP와 TCP interleaved를 따로 시험합니다. 경로, 자격 증명, Transport를 동시에 바꾸면 두 번째 성공을 만든 변수를 알 수 없습니다.

검사 계층	보존할 근거	판단 질문
RTSP	메서드, 상태, 헤더, CSeq, Session	서버가 해당 작업을 수락했는가
SDP	control, payload type, clock rate, codec	기대한 트랙을 설명하는가
Transport	client_port, server_port, interleaved	양쪽이 같은 채널을 사용하는가
RTP	SSRC, sequence, timestamp, marker	미디어 단위가 설명 가능한 순서로 도착하는가
RTCP	sender report, CNAME, BYE	시계, 식별자, 종료를 추적할 수 있는가
Decoder	SPS/PPS/VPS, packetization mode	수신 payload로 초기화할 수 있는가

“미디어가 오지 않음”과 “미디어는 오지만 디코딩할 수 없음”을 분리합니다. SETUP과 PLAY가 성공했는데 RTP가 없으면 UDP 경로, NAT, 방화벽, Transport 응답을 확인합니다. 시퀀스 공백은 손실이나 재정렬을 증명합니다. 연속 RTP가 있는데 영상이 없으면 payload type, clock rate, 프레임 경계, H.264 또는 H.265 파라미터로 이동합니다. 이 경계가 플레이어의 일반 오류 문구보다 더 유용합니다.

인용 가능한 짧은 답은 어떻게 작성합니까

마지막 성공 작업, 처음 실패한 근거, 두 원인을 나누는 다음 시험을 세 문장으로 씁니다. 예: “DESCRIBE, SETUP, PLAY는 성공했다. 알린 클라이언트 포트에 RTP가 도착하지 않는다. TCP interleaved 재시험으로 UDP 차단과 미디어 경로 오류를 구분한다.” 응답이나 패킷 없이 카메라 또는 네트워크 전체를 원인으로 단정하지 마십시오.

재현에 필요한 최소 정보는 무엇입니까

OPTIONS, DESCRIBE, SETUP, PLAY, SDP, Transport 응답, 비밀을 제거한 Session을 보존합니다. RTP에는 SSRC, 첫 번째와 마지막 sequence, clock rate, 공백 수, 캡처 시간을 기록합니다. VLC나 다른 VMS의 성공 여부는 차이 시험이지만 성공한 클라이언트가 모든 규칙을 올바르게 처리한다는 증명은 아닙니다.

서버와 클라이언트 중 어디를 확인합니까

메서드 거부, 존재하지 않는 control URL, 호환되지 않는 Transport, 설명 없는 SSRC나 시계 변경은 서버를 확인합니다. 만료 nonce 재사용, Session 누락, 포트를 열지 않은 UDP 요청, 모든 NAL 끝을 access unit 끝으로 취급하는 동작은 클라이언트를 확인합니다. 중간 경로 문제라면 각 결론에 패킷과 시각을 붙입니다.

보고서를 전달하기 전에 무엇을 확인합니까

새 연결로 다시 시험하고 두 시간선을 첫 차이까지만 비교합니다. 비밀번호와 전체 Authorization 값을 제거하고 결론을 CSeq, sequence, timestamp에 연결합니다. 관련 RTSP 안내서에서 인접 단계를 확인하고 RTSP Inspector로 RTSP 스트림을 로컬에서 시험하십시오. 카메라 영상을 공개 서비스에 업로드할 필요가 없습니다.

재시험 결과에는 통과 조건도 적으십시오. 같은 URL과 자격 증명으로 제어 요청이 성공하고, 선택한 Transport에서 RTP가 연속적으로 도착하며, 필요한 코덱 파라미터 뒤에 실제 프레임이 복원되어야 통과입니다. 재연결 뒤 Session이나 SSRC가 바뀌는 것은 그 자체로 오류가 아니므로 이전 연결과 새 연결을 섞어 비교하지 마십시오. 남은 불확실성은 “카메라 문제”처럼 넓게 쓰지 말고 확인하지 못한 포트, 트랙, 시간 구간 또는 디코더 조건으로 제한합니다.

관찰에서 계층별 판정으로

“RTSP 집계 제어 URL 디버깅: SDP 제어:*, 추적 URL, SETUP 404 및 PLAY 실패”에서는 해석보다 관찰을 먼저 기록합니다. 다른 담당자가 캡처에서 찾을 수 있어야 관찰입니다. CSeq에 연결된 RTSP 상태, SDP 값, Transport 응답, 연속 sequence 사이 공백, SSRC 변경, RTP timestamp와 RTCP sender report 차이가 예입니다. “서버가 느리다” 또는 “코덱이 호환되지 않는다”는 구체적 근거가 다른 원인보다 더 잘 설명할 때까지 가설입니다.

과정을 경계로 나눕니다. TCP 연결, OPTIONS 또는 DESCRIBE 수락, 사용할 수 있는 SDP track·control URL·payload type·clock rate, 호환되는 SETUP 응답, 유효한 Session이 있는 PLAY를 순서대로 확인합니다. 그 뒤에 RTP 도착, 순서, 시간, 디코더 준비를 확인합니다. 성공 근거가 없는 첫 경계에서 멈추고 뒤 단계 정보로 앞 단계 누락을 숨기지 마십시오.

비교 시험에서는 소스와 시간 범위를 고정합니다. UDP와 TCP interleaved는 같은 경로와 자격 증명을 사용합니다. main stream과 sub stream은 같은 클라이언트와 Transport를 사용합니다. VLC와 VMS를 비교할 때 실제 메서드, 헤더, URL을 기록하십시오. control URL, Authorization, Session, keepalive 차이가 프로그램 이름보다 결과를 잘 설명할 수 있습니다.

배제 행렬

가설 두 개로 시작합니다. 미디어가 없으면 UDP 차단 또는 다른 포트 전송을 생각합니다. TCP interleaved는 첫 가설을, Transport 제안과 응답·IP·포트 비교는 둘째 가설을 시험합니다. 깨진 영상에서는 RTP sequence가 손실과 초기화 부족을 나누고 첫 frame 전 SPS/PPS/VPS가 codec 파라미터 가설을 시험합니다.

각 가설에 지지 근거와 반증할 수 있는 근거를 적습니다. 어떤 패킷으로도 부정할 수 없는 주장은 너무 넓습니다. “NAT가 UDP를 버린다”는 클라이언트 포트의 RTP로 반증됩니다. “H.264 파라미터가 없다”는 IDR 전 유효한 SPS/PPS로 반증됩니다. 보고서가 가능성 목록이 아니라 우선순위 판정이 됩니다.

시간을 섞지 않기

RTSP CSeq는 제어 거래, RTP sequence는 패킷 순서, RTP timestamp는 미디어 샘플 시간, capture clock은 관찰 지점 도착을 나타냅니다. 같은 시계가 아닙니다. 도착 변동만으로 timestamp drift를 증명하지 못하고 sequence 근거 없는 timestamp 점프로 손실을 증명하지 못합니다. 오디오와 영상은 RTCP sender report로 공통 기준에 연결합니다.

인수 자료

새 연결에서 문서화한 한 가지 변경으로 결과를 반복할 때 조사를 닫습니다. 입력, 마지막 성공 경계, 첫 실패 근거, 변경, 재시험 결과, 미시험 항목을 씁니다. 큰 파일 대신 짧은 transcript나 통계를 첨부합니다. 비밀은 지우되 CSeq, 정리한 Session, SSRC, 시간 범위는 남깁니다.

RTSP 문제 해결로 순서를 다시 확인하고 RTSP Inspector 보고서로 카메라, 네트워크 또는 VMS 팀에 증거 경계를 전달하십시오.

변경 기록과 회귀 시험

수정을 반복 가능한 변경 기록으로 만드십시오. 이전 값과 새 값, 설정 위치, 재연결 시각, 패킷에서 기대하는 변화를 함께 적습니다. TCP interleaved로 바꿨다면 “영상이 보인다”만으로 통과시키지 마십시오. 미디어가 별도 UDP 포트에 더 이상 의존하지 않고 협상된 interleaved 채널에 나타나는지 확인해야 합니다. control URL을 바꿨다면 SETUP이 새 경로를 사용하고 PLAY와 keepalive가 같은 Session을 유지해야 합니다.

안전한 시험 환경에서는 음성 대조가 아니라 부정 대조도 수행합니다. 이전 값을 잠시 복원하거나 같은 입력을 가진 과거 캡처와 비교하여 같은 경계가 다시 실패하는지 확인합니다. 이 과정은 우연한 재시작, 캐시, 기록되지 않은 네트워크 변경을 해결책으로 오인하는 일을 막습니다. 운영 카메라를 의도적으로 중단하면 안 되는 경우에는 시간과 입력이 명확한 과거 기록을 사용하십시오.

연결을 일반 keepalive와 Session timeout보다 오래 유지합니다. OPTIONS 또는 GET_PARAMETER가 예상 간격으로 오가고 CSeq가 진행하며 Session이 일관적인지 봅니다. RTP는 수정 전후에 같은 길이의 구간을 골라 손실, 중복, 재정렬, SSRC 변경을 비교합니다. 구간 길이가 다르면 단순 패킷 수 비교가 왜곡됩니다.

codec 수정은 이미 재생 중인 화면으로 검증하지 않습니다. 완전히 새 연결을 열고 SDP, 시작 파라미터, 첫 IDR, 이후 프레임을 순서대로 확인하십시오. 기존 decoder 상태가 남아 있으면 시작 시 SPS/PPS/VPS 누락이 가려질 수 있습니다. 오디오와 영상이 함께 있는 경우에는 각 payload type과 clock rate를 따로 기록하고 RTCP sender report로 공통 시간 기준을 확인합니다.

결론 범위를 제한하십시오. “이 클라이언트에서 main stream을 TCP로 10분 확인했다”가 “RTSP가 고쳐졌다”보다 정확합니다. 검증한 track, Transport, codec, 클라이언트, 지속 시간을 씁니다. 오디오, sub stream, 네트워크 단절 뒤 재연결을 시험하지 않았다면 열린 항목으로 남겨야 합니다.

사실과 권고를 분리합니다. 사실은 응답, 패킷, 측정값입니다. 권고는 그 사실에 따라 카메라, 방화벽, VMS 또는 클라이언트 설정을 바꾸자는 제안입니다. 다른 팀이 다른 해결책을 선택하더라도 사실 자체는 받아들일 수 있어야 합니다.

마지막에는 다음 조치의 담당자와 종료 조건을 씁니다. 예를 들어 카메라 팀은 Transport 응답을 수정하고, VMS 팀은 새 빌드에서 같은 캡처를 재생하며, 네트워크 팀은 지정된 UDP 범위를 확인할 수 있습니다. 비밀을 제거한 짧은 시간 구간과 판정 근거를 RTSP Inspector 보고서 안내에 따라 전달하십시오.