notParsec / 문서전체 문서

설명·설계 문서

PC 간 직접 UDP · BUD 일부 복구와 남은 차이

design/DIRECT_UDP.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-09-24 · F04/F10/F11/F14/F31/F32/F33/F68/F81 · 부분 구현, 원본 일치 미확인

입문용 상세 과정은 Network 지연 분석부터 직접 UDP까지를 참고한다. 당시 게시 대기 이후의 배포 결과와 용어·측정 해석도 함께 설명한다.

왜 항상 서버를 거쳤나

서로 다른 네트워크에서 영상과 입력을 먼저 연결하는 과정에서 WSS 중계를 구현했고, STUN 탐색·UDP hole punching·직접 미디어 선택을 연결하지 않은 채 남겨 두었다. 기존 QUIC 인증 시험 도구는 사용자 앱의 직접 영상 전송 경로가 아니었다. 따라서 같은 LAN에서도 기존 앱은 클라이언트 → HTTPS 프록시/Ubuntu 중계 → 호스트 경로를 사용했다. Parsec을 따르려면 해결해야 하는 미완성 항목이며, 원래 요구에 필요한 제약이 아니다.

기존 경로에는 인터넷 우회와 TCP 재전송뿐 아니라 동일 스트림의 영상·제어 큐 대기가 있었다. Network도 해당 스트림에 넣은 Probe/Pong 왕복이라 디코더 큐가 막히면 크게 증가했다. 이전 합성 시험에서는 디코더 소비를 프레임마다 50ms 지연시키자 RTT가 약 2.2–4.0초로 늘었다. 이는 사용자 PC에서 측정한 회선 지연이 아니다. 이전 진단 원본은 analysis/network/2026-09-24/에 보관했다.

새 연결 흐름

  1. 기존 기기 승인과 대상 PC 비밀번호를 확인하고 종단 TLS를 만든다. 비밀번호 확인 전에 영상·입력이나 직접 UDP 세션을 열지 않는다.
  2. PC마다 IPv4 UDP 포트를 열고 기본 경로의 LAN 주소와 STUN의 공인 매핑 주소를 구한다. STUN은 stun.cloudflare.com:3478이며 영상 중계 서버가 아니다. 탐색은 최대 1초다.
  3. 후보 주소를 종단 TLS로 교환한다. 같은 TLS 세션의 exporter에서 방향별 AES-128-GCM 키·nonce 접두어를 얻는다. 서버에 UDP 키를 전달하지 않는다.
  4. 양쪽이 인증된 UDP 탐색 패킷을 보내 NAT 매핑을 만든다. 클라이언트가 응답한 경로를 지정하고 호스트가 해당 출발 주소를 확인한다. 최대 2초 뒤 TLS에서 양쪽 성공 여부를 교환한다.
  5. 양쪽이 성공한 경우 영상과 입력을 PC ↔ PC UDP로 전달한다. 기존 WSS에는 2초 간격의 작은 인증 유지 메시지만 남는다. 관리자 차단·호스팅 해제·인증 연결 종료 시 UDP도 종료한다.
  6. 한쪽이라도 실패하면 양쪽 모두 기존 종단 TLS/WSS 미디어 경로를 사용한다. UDP 연결 중 단절은 세션 종료 후 다시 연결해야 한다. 전송 도중 자동 경로 전환은 아직 없다.

캡처는 경로 협상이 끝난 뒤 시작한다. 연결 준비 중 캡처한 오래된 화면과 빈 Encode 통계가 첫 프레임보다 먼저 전달되는 일을 방지한다.

원본 근거와 실제 구현 범위

기준은 Windows Parsec 150-104a, 코어 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 보관한 Ghidra 의사 코드에서 아래 구조를 확인했다. 추출 함수·출처 hash는 근거 목록에 있다. 이 자료는 원본 소스가 아니며, 원본 DLL과 차등 실행한 결과도 아니다.

원본 함수·관찰 Rust 대응과 차이
18003d430 7바이트 헤더, 4바이트 메시지 길이, 조각 순번, 마지막 조각 0x21 direct/bud.rs에서 해당 평문 형식 사용. 조각 payload 최대 1193바이트, 브리지 메시지는 32KiB로 제한. 원본의 가변 MTU 전체 동작은 미복원
18003c230, 18003c780, 18003c670 19개 채널, 4000개 창, 개별/누적 ACK, gap 표시 순서 재조립·중복 처리·수신 창·ACK 적용. 현재 호스트/클라이언트 스트림의 채널 0/1 배정은 자체 연결이며 원본 메시지 배정과 일치 미확인
18003c3a0 gap 재전송, RTT 기반 타이머, 한 처리에서 최대 100개 재전송 fast retransmit과 재전송 타이머 일부 반영. 현재 ACK를 받지 않은 송신 조각을 약 100개 미만으로 제한. 완전한 원본 혼잡 제어·pacing·FEC는 미구현
18003cc80 30ms 처리/keepalive와 채널별 처리 UDP 수신·ACK·역방향 입력을 디코더 전달 큐와 분리. 소비 기준 수신 창 4000개와 제한된 앱 큐로 메모리 상한 유지
18003beb0 AES-GCM과 외부 레코드 원본 DTLS wire/key setup은 미복원. 현행은 기존 TLS exporter와 자체 NPB6 인증 헤더·방향별 카운터·재전송 방지 창을 사용. Parsec과 wire 호환 아님

원본의 네트워크 조건·DTLS·혼잡 제어를 복원한 완성 BUD로 표시하지 않는다. E01/E02는 자체 인증·서버 운영의 근거이며, 별도 암호화 형식이나 후보 선택 정책의 원본 일치를 승인하는 근거가 아니다. 이 차이는 parity: different로 남긴다.

RFC 8489 STUN 주소 조회와 RFC 8445의 후보 확인/지정 개념을 참고했으나, 전체 ICE 구현을 주장하지 않는다. STUN 표준, ICE 표준, 사용하는 STUN 서비스 문서. 공개 문서는 보관한 Parsec 버전의 내부 사양 증거와 구분한다.

화면에서 확인

기존 오버레이 통계와 Basic Performance에 실제 경로를 표시한다.

표시 의미
Direct UDP 영상·입력이 직접 UDP로 이동. Network는 별도 UDP Probe/Pong RTT이며 디코더 전달 대기를 제외
WSS relay (UDP unavailable) 직접 UDP 확인 실패. 기존 종단 TLS/WSS 중계 사용. Network에는 스트림 큐 지연도 포함
UDP TX retransmissions 이 PC가 송신하면서 재전송한 조각 수의 누계. 클라이언트에서는 입력/제어 송신에 해당하며 호스트 영상 손실률이 아님. 손실률이나 Parsec 그래프와 동일한 지표가 아님

RTT는 왕복이며 단방향 지연, 영상의 종단 지연, 회선 대역폭과 다르다. UDP 처리에서 측정해도 OS 스케줄링·송수신 큐 대기는 포함된다. 가변 비트레이트는 기존 제어기에 새 경로의 RTT를 전달한다. 원본 BUD의 전체 대역폭 추정과 같지는 않다.

업데이트·운영

프로토콜 ALPN을 notparsec-remote/6으로 올렸다. /5 앱과 직접 호환되지 않으므로 접속하는 PC와 접속받는 PC 모두 같은 새 앱으로 업데이트해야 한다. 사용자용 실행파일은 여전히 하나다. 기존 서버의 불투명 WSS API로 부트스트랩하므로 이 변경만을 위해 서버 바이너리를 교체할 필요는 없다.

양쪽에서 정상 연결 후 경로 표시를 확인한다. WSS relay라면 외부 UDP 차단·Windows 방화벽·STUN 조회 실패·대칭형 NAT 등을 조사해야 한다. IPv4 기본 경로/LAN + 공인 매핑을 우선 지원한다. IPv6, 다중 NIC 전체 탐색, UPnP/PCP, 완전한 ICE/TURN, 대칭형 NAT 보장은 남아 있다. UDP가 인증 상태에서 8초 무응답이거나 데이터가 5초 동안 확인되지 않으면 연결을 종료한다. 이 시간은 자체 정책이며 원본과 일치 미확인이다.

시험과 한계

재현: cargo test -p notparsec-session --lib --test remote_relay. 최신 빌드·시험·배포 여부는 검증 기록을 따른다. 실제 Windows 외부망과 원본 Parsec의 같은 조건 대조는 남아 있다.