2026-06-02

RTSP 400 잘못된 요청 수정: DESCRIBE 실패, 잘못된 카메라 URL 및 헤더 오류

DESCRIBE에서 RTSP 400 잘못된 요청을 수정합니다. Axis/Dahua/Hikvision에 대한 잘못된 카메라 URL, 지원되지 않는 헤더, 역방향 프록시 문제, 인증 및 실제 진단 명령을 사용하여 공급업체별 스트림 경로를 다룹니다.

'RTSP/1.0 400 잘못된 요청'은 카메라가 잘못된 형식의 RTSP 요청을 거부했음을 의미합니다. 네트워크 문제는 아닙니다. 코덱 문제는 아닙니다. 이는 요청 형식 문제입니다. 카메라가 수신한 정확한 요청을 확인하면 문제를 해결할 수 있습니다.

빠른 답변: 30초 분류

먼저 VLC로 테스트하세요. VLC가 작동하는 경우 VLC가 보내는 정확한 RTSP 요청을 캡처하세요. 실패한 클라이언트와 비교해 보세요.
URL 경로를 확인하세요. 서로 다른 카메라는 동일한 RTSP 스트림에 대해 완전히 다른 경로를 사용합니다. 한 카메라 브랜드에서 다른 카메라 브랜드로 URL을 복사하는 것이 400 오류의 가장 큰 원인입니다.
Check URL encoding. Special characters in passwords break RTSP URL parsing. Encode @ as %40, : as %3A, / as %2F.
프록시 간섭을 확인하세요. 카메라에 대한 직접 RTSP가 작동하지만 프록시를 통해 400을 반환합니까? 프록시가 RTSP 헤더를 변경하고 있습니다.

이 방법으로도 문제가 해결되지 않으면 아래 세부 섹션을 수행하세요.

먼저: 카메라에 접근할 수 있는지 확인하세요.

RTSP를 디버깅하기 전에 기본 연결을 확인하세요.

# TCP reachability
nc -zv 192.168.1.100 554

# Or with telnet
telnet 192.168.1.100 554

# RTSP OPTIONS — the simplest RTSP request
# If this fails, the camera isn't speaking RTSP

Camera-specific URL formats

Axis

rtsp://<ip>/axis-media/media.amp
rtsp://<ip>/mpeg4/media.amp
rtsp://<ip>:554/axis-media/media.amp?videocodec=h264

Dahua

rtsp://<user>:<pass>@<ip>:554/cam/realmonitor?channel=1&subtype=0
rtsp://<user>:<pass>@<ip>:554/cam/realmonitor?channel=1&subtype=1

subtype=0: main stream
subtype=1: sub stream

Generic / ONVIF

rtsp://<ip>:554/stream1
rtsp://<ip>:554/live
rtsp://<ip>:554/h264
rtsp://<ip>:554/h265
rtsp://<ip>:554/profile1/media.smp
rtsp://<ip>/onvif1
rtsp://<ip>/onvif2

Testing with ffmpeg

# Test DESCRIBE only (don't decode)
ffmpeg -rtsp_transport tcp -i "rtsp://user:pass@192.168.1.100:554/stream1" -t 1 -f null -

# 자세한 출력은 정확한 RTSP 교환을 보여줍니다.
ffmpeg -loglevel 디버그 -rtsp_transport tcp -i "rtsp://..." -t 1 -f null - 2>&1 | grep -E "설명|설정|응답"

URL 인코딩: 자동 400 트리거

WRONG: rtsp://admin:pa@ss@192.168.1.100/stream1
       parser sees: user=admin, pass=pa, host=ss@192.168.1.100

RIGHT:  rtsp://admin:pa%40ss@192.168.1.100/stream1
       parser sees: user=admin, pass=pa@ss, host=192.168.1.100

Full diagnostic decision tree

RTSP returns 400 Bad Request
│
├─ Is port 554 reachable?
│  ├─ NO → Fix network/firewall. Not an RTSP issue.
│  └─ YES → Continue
│
├─ Does VLC play the same URL?
│  ├─ YES, VLC works → Capture VLC's exact request. Compare with your client.
│  │   Differences in headers, URI format, or auth will point to the fix.
│  └─ NO, VLC also fails → Problem is in the URL or camera config
│
├─ Check the URL path
│  ├─ Wrong manufacturer format → Use correct format for your camera brand
│  ├─ Query parameters missing → Add required parameters (channel, subtype)
│  └─ Path contains unencoded special chars → URL-encode credentials
│
├─ Check DESCRIBE headers
│  ├─ Missing Accept: application/sdp → Add it
│  ├─ Extra HTTP headers (via proxy) → Remove proxy from RTSP path
│  └─ Malformed Authorization → Fix Digest auth parameters
│
├─ Check CSeq and RTSP syntax
│  ├─ Missing CSeq → Add sequential CSeq header
│  ├─ Wrong RTSP version → Use RTSP/1.0
│  └─ CRLF formatting wrong → Ensure \r\n line endings
│
└─ Still failing?
   ├─ Try ONVIF discovery to get the correct RTSP URL
   ├─ Check camera firmware version (older firmware may have stricter parsing)
   └─ Test with a known-working RTSP client as baseline

역방향 프록시: 숨겨진 400 원인

HTTP 역방향 프록시를 통한 RTSP는 취약합니다. HTTP용으로 설계된 프록시는 다음을 수행할 수 있습니다.

HTTP 관련 헤더 삽입(Host, X-Forwarded-For, User-Agent)
요청 URI 다시 작성
TCP 연결 동작 버퍼링 및 변경
RTSP의 영구 연결 모델을 방해합니다.

프록시 간섭의 증상:

RTSP를 카메라에 직접 연결: 작동
프록시를 통한 RTSP: 400 잘못된 요청
카메라 로그에 직접 흐름에 없는 추가 헤더가 있는 "잘못된 요청"이 표시됩니다.

수정: RTSP 트래픽용 프록시를 우회하거나, RTSP 인식 프록시를 사용하거나, 수정되지 않은 RTSP 트래픽을 전달하도록 프록시를 구성하세요.

인증 엣지 케이스

대부분의 인증 문제는 401을 반환하지만 잘못된 Authorization 헤더는 400을 반환할 수 있습니다.

"첫 번째 시도에서는 작동하고 재시도에서는 실패" 패턴:

클라이언트가 인증되지 않은 DESCRIBE를 보냅니다.
카메라는 다이제스트 챌린지(영역, nonce)로 401을 반환합니다.
클라이언트가 다이제스트 응답을 계산합니다.
클라이언트는 Authorization 헤더와 함께 인증된 DESCRIBE를 보냅니다.
카메라는 400을 반환합니다.

이는 다이제스트 응답 계산이 잘못된 경우에 발생합니다. 즉, 다이제스트 계산에 사용된 URI가 실제 요청 URI와 일치하지 않거나 nonce가 오래되었거나 해싱 전에 비밀번호의 특수 문자가 올바르게 인코딩되지 않은 경우에 발생합니다.

확인: Authorization 헤더의 요청 URI를 유선의 실제 요청 URI와 비교하세요. 다이제스트 인증에서 URI는 해시의 일부입니다. 즉, 문자 대 문자(인코딩 포함)가 일치하지 않으면 응답이 유효하지 않습니다.

카메라가 방금 고장났을 때

일부 카메라에는 버그가 있는 RTSP 구현이 있습니다. 위의 모든 항목을 확인했는데도 여전히 400이 표시되는 경우:

펌웨어 업데이트 확인
제조업체의 자체 클라이언트 소프트웨어로 테스트
대체 검색 및 스트리밍 경로로 ONVIF를 사용해 보세요.
카메라가 자체 앱에서는 작동하지만 표준 호환 RTSP 클라이언트에서는 작동하지 않는 경우 카메라의 RTSP 스택은 비준수입니다.

카메라 공급업체에 버그를 신고하세요. 정확한 RTSP DESCRIBE 요청 및 응답을 포함하세요. 적절한 RTSP 구현은 URL 경로에 관계없이 유효하고 올바른 형식의 요청에 대해 400을 반환해서는 안 됩니다. 즉, 404를 반환해야 합니다.

“RTSP 400 잘못된 요청 수정: DESCRIBE 실패, 잘못된 카메라 URL 및 헤더 오류”을 재현 가능하게 검증하는 방법

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

카메라, 방화벽, 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 400 잘못된 요청 수정: DESCRIBE 실패, 잘못된 카메라 URL 및 헤더 오류”에서는 해석보다 관찰을 먼저 기록합니다. 다른 담당자가 캡처에서 찾을 수 있어야 관찰입니다. 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 보고서 안내에 따라 전달하십시오.