YOUR HOME SERVER, YOUR REMOTE DESKTOP

홈서버는 연결을 주선하고,
화면은 PC끼리 보냅니다.

Parsec처럼 앱을 켜면 내 컴퓨터가 보이고, 누르면 연결되는 경험을 만들려면 “연결 관리 서버”와 “실제 원격 스트리밍”을 나눠야 합니다. 이미 가진 홈서버와 도메인으로 연결 관리 부분을 운영할 수 있습니다.

확인됨 · Ubuntu 24.04.4 / N100확인됨 · 도메인 연결확인됨 · 공인 IP + UDP 포트포워딩

서버는 Ubuntu 24.04.4 LTS / kernel 6.8.0-136-generic / Intel N100 / x86_64 / 4코어·4스레드입니다. 실제 서비스 도메인·회선 속도·호스트 위치는 미확인입니다. 아래는 집 PC 접속을 기본 예로 한 제안이며, 이름·포트·주소·속도는 설명용입니다. 기존 Parsec 서버에 연결하는 구성이 아닌 자체 notParsec 서비스입니다.

연결 관리 · Control plane

내 장치 목록, 온라인 상태, 기기 인증, 접속 승인, 접속할 주소 전달. 홈서버의 Rust API가 처리합니다.

영상과 조작 · Data plane

화면·소리·키보드·마우스. 가능한 경로로 두 앱이 통신하고, 직접 연결이 안 되면 relay가 패킷을 전달합니다.

Parsec도 host/client, Signal API, STUN을 구분합니다. 이 구분을 참고해 아래 자체 운영안을 설계했습니다. 공식 연결 구조

ACCESS / SINGLE OWNER

계정 로그인 대신 접속 대상 PC의 비밀번호를 입력합니다

내 기기만 사용하므로 가입·계정 로그인·로그아웃 화면은 없습니다. 앱은 저장된 서버 주소와 장치 키로 시작하고, 원격 접속할 때 그 PC에 설정한 비밀번호를 입력합니다.

접속할 PC 선택→인증서 확인 · 비밀번호 입력→호스트 검증 후 접속

Windows host가 보관·검증

비밀번호 원문 대신 Argon2id verifier를 저장하고 개인키와 함께 DPAPI로 보호합니다. 신뢰한 host 인증서가 확인된 QUIC 채널 안에서만 전달하며, 실패 제한은 새 연결에서도 유지됩니다. 비밀번호를 저장해 재접속을 자동 통과시키지 않습니다.

Ubuntu 서버는 장치 연결을 관리

비밀번호나 verifier를 중앙 서버에 업로드하지 않습니다. 앱 내부의 장치 키 인증은 유지합니다. 서버의 접속 ticket은 연결 시도만 허용하고, 화면·입력은 host 비밀번호 확인 뒤에만 열립니다.

현재 구현: Windows GUI와 실제 QUIC 인증 CLI, 로컬 비밀번호 초기 설정·변경, 인증서 검증, host 전체 실패 제한, 장치 등록/인증/목록/heartbeat/폐기 API, GPU 캡처 probe, Ubuntu native ELF, WSS·세션/ticket·grant/lease·명시 후보와 백업/복원/rollback 시험. 남은 작업: sudo 권한 준비 후 운영 Nginx/systemd 적용, Windows 새 세션 통합·영상·음성·입력·외부망 시험. 실제 검증 기록.

F80–F82 개발 목록 ↗ · 빌드·실행 방법 ↗

02 / CONCEPTS · VPS · VPN · RELAY

VPS는 서버를 두는 곳, VPN은 연결하는 방법입니다

이 둘은 서로 대체하는 제품 이름이 아닙니다. VPS 위에 VPN을 실행할 수도 있고, 지금 가진 홈서버에서 VPN을 운영할 수도 있습니다. 어디에 컴퓨터를 둘지와 어떤 네트워크 경로로 연결할지를 나누어 보면 이해하기 쉽습니다.

홈서버 · 내가 집에서 운영하는 컴퓨터

집에 있는 물리 PC나 그 안의 가상 머신에 서버 프로그램을 실행합니다. 이미 보유한 장비·공인 IP를 활용하지만 집의 전원·공유기·인터넷 회선에 영향을 받습니다.

이 프로젝트에서는 장치 목록과 접속 승인 서버를 먼저 배치합니다. 원격으로 조작할 Windows PC와 같은 장비일 수도, 다른 장비일 수도 있습니다.

외부 VPS · 집 밖에서 빌리는 가상 서버

Virtual Private Server의 약자입니다. 호스팅 업체의 데이터센터 컴퓨터를 가상으로 나눠, 내가 OS와 프로그램을 운영할 수 있게 빌리는 서버입니다. “외부”는 집 네트워크 밖이라는 뜻이며 반드시 해외라는 뜻은 아닙니다.

여기에 연결 관리 API, 패킷 relay, VPN 서버 등을 설치할 수 있습니다. 임대료·전송량 조건·지역·UDP 사용 가능 여부를 확인해야 하며, 일반 VPS에 스트리밍용 GPU가 있다고 가정하지 않습니다.

VPS 개념 · AWS 공식 설명

개인 VPN · 내 장치의 사설 연결 통로

Virtual Private Network입니다. 외부 노트북과 집 네트워크 사이에 인증·암호화된 터널을 만들고, 정해 둔 사설 IP 경로로 통신하게 합니다. 여기서는 WireGuard를 집 공유기나 홈서버에 설치하는 구성을 예로 듭니다.

VPN 자체가 화면을 캡처하거나 마우스를 조작하지는 않습니다. 그 기능은 notParsec 앱이 담당합니다. 업체의 인터넷 출구를 빌리는 상용 VPN 구독과도 용도가 다릅니다.

WireGuard 공식 개념 설명

개인 VPN 예시

외부 노트북집 WireGuard 허브집 PC

노트북 ↔ 허브는 VPN 터널, 허브 ↔ 집 PC는 LAN 경로입니다. 앱은 그 위에서 PC 간 QUIC을 유지합니다. VPN이 끝나는 허브를 영상 암호화의 끝으로 취급하지 않습니다.

외부 VPS relay 예시

외부 노트북데이터센터의 VPS집 PC

VPS에서 실행하는 relay 프로그램이 두 PC의 암호화된 패킷을 전달합니다. VPS를 빌리는 것만으로 relay가 생기지는 않으며, 프로그램과 포트 설정이 필요합니다.

개념답하는 질문이 설계에서의 역할
홈서버 / VPS서버 프로그램을 어디서 실행할까?집 장비 또는 외부 데이터센터의 가상 서버
VPN내 장치가 어떤 사설 경로로 접근할까?접근 가능한 IP 경로·암호화 터널. 앱의 신뢰/승인은 계속 필요
연결 관리 서버어떤 PC에 누가 연결하도록 허용할까?기기 목록·온라인 상태·승인·주소 전달
Relay직접 통신이 안 되면 누가 패킷을 전달할까?홈서버나 VPS에서 실행할 수 있는 선택 중계 프로그램
현재 환경에 적용하면
이미 공인 IP와 UDP 포트포워딩이 있으므로 홈서버의 연결 관리 API와 집 PC 직접 경로부터 시작할 수 있습니다. PC의 앱 포트를 따로 공개하고 싶지 않다면 VPN의 UDP 포트만 열고 사설 경로로 접속하는 대안이 있습니다. VPS는 집 중계 경로의 지연·가용성 문제가 실제로 확인되었을 때 추가로 검토합니다.

VPN은 집 대역만 보내는 split tunnel로 구성할 수 있어 모든 인터넷 트래픽을 집으로 우회할 필요가 없습니다. route·AllowedIPs·방화벽은 별도 설정해야 합니다. 이 문서의 WireGuard는 허브 방식이며, 자동 direct/relay를 선택하는 mesh VPN은 다른 배치입니다. UDP가 차단된 외부망에서는 기본 WireGuard도 막힐 수 있습니다.

03 / NETWORK PATH

같은 앱, 서로 다른 연결 경로

현재 환경에서는 집 호스트로 직접 연결하는 경로부터 만들 수 있습니다. PC 포트를 따로 공개하지 않고 시작하려면 개인 VPN도 가능합니다. 자동 NAT 통과와 relay는 연결 범위를 넓히는 다음 단계입니다.

파란 경로: 접속 요청·주소 교환초록 경로: 화면·소리·조작
CLIENT / OUTSIDE외부 노트북

영상 decode · 화면 표시
키보드·마우스 입력 수집

Windows client
MF · D3D11 · Rust

YOUR HOME SERVER연결 관리 서버

기존 Nginx
Rust API + WebSocket
기기 목록 · 신뢰 · SQLite

목록·인증·접속 요청만 담당

HOST / HOME LAN조작할 집 PC

화면 capture · encode
오디오 수집 · 승인된 입력 적용

Windows host
DXGI · NVENC · Rust

외부 노트북집 PC

종단 간 QUIC / UDP · 홈서버는 미디어를 처리하지 않음

PC끼리 직접 연결

연결 조건

그림은 논리 경로입니다. 인터넷·공유기·방화벽을 모두 그린 물리 배선도는 아닙니다. 경로를 바꾸면 아래 포트 안내와 회선 계산도 갱신됩니다.

04 / WHAT RUNS WHERE

홈서버에 올릴 것, PC에 남길 것

위치프로세스 / 역할보관 데이터와 자원
홈서버 · 필수Control API + WSS
장치 등록·접속 요청·온라인 상태·승인 전달. 개인용은 한 Rust 프로세스 안에 모듈로 구성.
기기 공개키·신뢰 정책·초대 hash·설정·연결 이력. GPU 불필요.
홈서버 · 필수기존 Nginx 재사용
도메인별 HTTPS 인증서·API/WebSocket 전달.
인증서와 설정을 영속 저장. 기존 웹사이트의 443 listener에 가상 호스트 추가.
홈서버 · 필수SQLite
한 서버·소수 기기에서 시작. 접속 상태는 메모리 + heartbeat로 관리.
DB·schema migration·일관된 백업. Redis/Kafka/Kubernetes는 초기 요구에 없음.
홈서버 · 선택Media relay
인증된 두 endpoint 사이 암호문 전달. API와 별도 프로세스로 격리.
소켓·짧은 allocation·대역폭/큐 예산. 저장·트랜스코딩 없음.
홈서버 · 대안WireGuard VPN
외부 장치에서 집 LAN으로 접근할 경로 제공.
VPN key·장치별 route. 앱의 호스트 승인과 장치 인증도 계속 필요.
호스트 PCHost agent
GPU 캡처/인코딩·음성·입력·Privacy·가상 디스플레이.
실제 데스크톱·GPU·입력 권한. 홈서버가 대신 처리하지 않음.
클라이언트 PCClient app
기기 선택·decode/render·입력 전송·overlay.
개인키·신뢰한 호스트 키·영상 버퍼. 서버 웹페이지가 이 기능을 자동 대체하지 않음.
홈서버가 조작할 PC와 같은 기기라면?
논리 역할은 그대로 나눕니다. 단, headless Linux 서버에 API를 올리는 것만으로 Windows 데스크톱이 생기지는 않습니다. Windows VM을 스트리밍하려면 VM 내부 host agent와 GPU/가상 디스플레이 조건을 별도로 갖춰야 합니다.

Ubuntu + systemd를 기본 배포로 정했습니다. 24.04 LTS를 초기 검증 목표로 두며, API 1개·DB 1개·선택 relay 1개로 시작하는 것이 이 규모에 맞는 설계 제안입니다.

05 / CONTROL SERVER · F71–F79

연결 관리 서버도 하나의 개발 시스템입니다

API 주소만 정하는 것으로는 “앱을 켜면 내 PC가 보이고 연결되는” 경험이 완성되지 않습니다. 장치 등록, 권한 검사, 온라인 상태, 승인 경합, 재시작 뒤 복구를 서버가 구현해야 합니다. 기존 체크리스트에 개요와 UI만 있던 부분을 독립 서버 기능 9개로 보강했습니다.

PC 앱 · HTTPS/WSSRust API · 인증/승인SQLite + 메모리 접속 상태

장기 권한은 DB에, 현재 socket·heartbeat는 메모리에 · 영상은 이 서버의 처리 대상이 아님

체크 항목서버가 구현할 내용완료 확인의 핵심
F71 · 실행·APIRust 프로세스, REST/WSS, 설정·오류·health실제 Linux build/기동/종료, 비정상 설정 거부
F72 · DB장치·권한·초대·세션, migration·transaction동시 token 소비 1회, 중단 후 상태 일관성
F73 · 등록·인증일회 등록 코드, 공개키 증명, API credential·키 교체사칭·만료·재생 거부, host pin 자동 교체 금지
F74 · 목록·온라인허용 기기 목록, heartbeat, WSS snapshot/revision늦은 이벤트·재시작에도 유령 online 방지
F75 · 접속 승인요청→승인→연결→종료, 세션 ticket취소/승인 경합, host 최종 승인, ticket 재사용 차단
F76 · 초대·철회기한·권한 있는 초대와 신뢰 철회새 접속 차단, host 종료 ACK, offline 차이 표시
F77 · 주소 교환승인된 peer 후보 전달·경로 정책·relay credential비인가 후보 노출 방지, 미설정 relay 미광고
F78 · 서버 운영TLS/WSS, 재시작·지표·백업·복원빈 환경 복원, DB/key 보존, 이전 세션 무효화
F79 · 통합 시험서버 + 두 PC + 외부 회선 연결30분 실제 스트리밍, 10회 접속·종료, 철회·단절 검증

서버 9개 개발 범위를 체크하러 가기 ↗ · API·DB·상태 전이 상세 설계 ↗

필요한 서버 범위부터 선택합니다
“연결 관리 서버 9개 추가”는 기존 선택을 유지하면서 필요한 선행 기능을 포함합니다. 기본 30개는 LAN 엔진이고 전체 카탈로그는 82개입니다. F64/F65 목록·초대 UI는 F74/F76에 연결되며, F32 자동 NAT 통과와 F33 relay는 별도 추가 기능입니다. 아래 검토 체크 6개는 개발 완료 기록과 다릅니다.

초기 서버 관리 세션은 권한 lease를 주기적으로 갱신하고, 마지막 갱신 후 120초가 지나면 host가 입력 해제·종료하도록 제안합니다. 서버 단절 시 철회를 즉시 전달할 수 없기 때문입니다. 수동 direct/VPN offline 접속은 별도 로컬 허용 정책이며 서버 관리 세션의 철회 보장을 자동으로 받지 않습니다. 값과 정책은 상세 설계의 초기 제안입니다.

06 / DOMAIN & PORTS

도메인은 주소, 포트는 실제 통로입니다

웹사이트가 열린다는 사실은 UDP 영상 포트가 열린다는 뜻이 아닙니다. HTTPS 요청은 reverse proxy로, 직접 연결/relay UDP는 공유기와 방화벽에서 각각 해당 프로세스로 보냅니다.

입력은 이 페이지의 예시만 바꿉니다. DNS·공유기·홈서버 설정에 접속하지 않습니다. ASCII 또는 punycode 도메인을 사용하세요.

이름 / 대상외부 포트 예시공유기에서 전달할 곳사용 시점
remote.example.comTCP 443
TCP 80은 인증 방식에 따라
홈서버 192.168.1.10
기존 Nginx → 127.0.0.1:18080
기기 목록·인증·WSS
VPN 전용이면 내부로 제한 가능
pc.example.comUDP 40010집 호스트 PC 192.168.1.20:40010집 PC 직접 연결
PC별 고정 DHCP/방화벽 필요
relay.example.comUDP 40000홈서버 relay :40000
VPS 선택 시 DNS도 VPS IP로
자체 relay를 구현했을 때
TURN의 기본 포트가 아님
vpn.example.comUDP 51820집 공유기 또는 홈서버 VPNVPN 대안 선택 시
위 두 미디어 공개 포트 생략 가능
STUN / TURN보통 3478
TURN은 relay 포트 범위도 필요
선택한 STUN/TURN 서비스자체 NAT 통과/표준 relay 단계에서만
별도 프로토콜 통합 필요

공인 IP가 하나여도 됩니다

여러 이름이 같은 A 레코드 IP를 가리킬 수 있습니다. HTTP 도메인은 reverse proxy가 구분하고, UDP는 포트/프로토콜과 앱의 라우팅이 구분합니다. 공유기가 도메인명으로 UDP를 다른 PC에 자동 분배하지는 않습니다.

공인 IP가 변경되면 DDNS/DNS 갱신과 연결 재시도가 필요합니다. 내부 접속은 LAN 주소나 split DNS로 처리해 hairpin NAT 의존을 줄입니다. AAAA는 IPv6 경로·방화벽을 확인한 경우에 추가합니다.

이미 연결한 도메인 서비스 확인

Cloudflare의 일반 HTTP 프록시를 켠 이름을 임의 UDP endpoint로 사용하지 않습니다. 미디어 이름은 DNS-only로 실제 공인 IP를 가리키게 하거나 UDP를 지원하는 별도 구성을 씁니다.

HTTP proxy와 UDP proxy는 별도 기능입니다. Cloudflare 제한 · Spectrum의 TCP/UDP 역할

HTTPS reverse proxy 예시와 배포 시 구분
# 기존 HTTPS server block 내부, URI 보존
location ^~ /v1/ {
    proxy_pass http://127.0.0.1:18080;
}

현재 대상은 호스트 Nginx입니다. 위는 URI 보존 개념 예시이며 WSS 헤더/timeout·요청 제한·health를 포함한 실제 설정은 배포 파일을 사용합니다. 실제 origin 후보는 https://n3m.kr이고 인증서는 유효하지만 운영 API 적용은 sudo 권한 대기입니다. 아래의 pc/relay/vpn 이름은 예시이며 해당 DNS·서비스·UDP 포트를 생성하지 않았습니다. 컨테이너를 쓰는 다른 환경에서는 그 컨테이너의 loopback을 호스트 loopback으로 취급하면 안 됩니다.

Nginx WebSocket 전달

TCP 443과 UDP 443은 다른 포트 공간입니다. 여기서는 HTTP/3와 자체 QUIC listener가 UDP 443을 두고 충돌하지 않도록 미디어에 별도 예시 포트를 배정했습니다.

07 / CONNECTION LIFECYCLE

“연결”을 누른 뒤 일어나는 일

  1. 한 번만: 장치를 등록하고 서로의 키를 신뢰

    관리자가 만든 일회 등록 코드로 장치 공개키를 서버에 등록합니다. 호스트 키의 fingerprint도 별도 확인해 저장합니다. 서버 API 인증과 원격 입력 허용은 다른 권한입니다.

  2. 앱이 홈서버에 나가는 WSS 연결을 유지

    호스트가 온라인 상태·지원 codec·접속 후보를 알립니다. heartbeat가 끊기면 오프라인으로 표시합니다. 서버는 잠든 PC의 화면을 대신 제공할 수 없습니다.

  3. 클라이언트가 특정 호스트로 접속 요청

    서버는 장치 신뢰·권한·만료를 검사하고 호스트에 요청을 전달합니다. 호스트가 승인하거나, 미리 허용한 개인 장치의 무인 접속 정책을 적용합니다.

  4. 주소를 교환하고 도달 가능한 경로 선택

    LAN 주소 → 집의 명시 포트포워딩/VPN 주소 → NAT 통과 후보 → relay 순으로 후보를 평가합니다. 실제 정책은 timeout·측정 결과로 결정합니다. STUN만 설치한다고 hole punching이 자동 구현되지는 않습니다.

  5. 두 PC가 종단 간 암호화 연결을 수립

    pinning한 host 키와 승인된 client 키를 확인합니다. 단기 ticket은 세션/양쪽 장치/권한/nonce/만료에 묶습니다. HTTPS 인증서만 확인하고 임의 호스트 키를 신뢰하지 않습니다.

  6. 호스트 비밀번호 검증 뒤 codec·화면·입력 협상

    먼저 이 host에 설정한 비밀번호를 새 연결마다 확인합니다. 성공한 뒤 호스트가 DXGI → GPU 변환 → NVENC를 실행하고, 클라이언트가 decode → 표시합니다. 제어·키 입력은 reliable stream, 미디어는 QUIC DATAGRAM으로 보냅니다. 마이크·가상 장치·Privacy는 각 host/client 모듈이 처리합니다.

  7. 단절·취소·종료를 정리

    입력 release-all, relay allocation 정리, 장치·Privacy 상태 복원, 로그와 상태 갱신. 직접/relay 전환의 초기 구현은 epoch를 새로 만들고 keyframe을 요청하는 재연결로 시작합니다. 무중단 전환은 별도 목표입니다.

집 안 STUN의 위치에 주의
호스트와 같은 LAN의 STUN에 LAN으로 질의하면 집 밖에서 보이는 NAT 매핑을 얻는 용도로 충분하지 않습니다. 집 PC는 명시 포트포워딩 주소를 우선 쓰고, 자동 NAT 통과는 외부 관측 지점·socket 유지·후보 검사까지 함께 설계합니다. 이는 현재 배치에 대한 설계 판단입니다.

STUN은 주소 관측과 연결 검사 등에 쓰는 도구이며 독립적인 NAT 통과 해법은 아닙니다. RFC 8489

08 / RUST IMPLEMENTATION

Rust 코어에 운영 서버를 붙이는 방법

기존 설계의 영상 엔진을 그대로 두고 apps/control-server와 apps/relay-server를 추가하는 제안입니다. 논리 역할을 분리하되 소규모 API를 여러 microservice로 쪼개지는 않습니다.

모듈책임기존 개발 항목과 연결
control-serverTokio + axum 후보. HTTPS 뒤의 REST·WSS, 장치 등록·목록·초대·접속 요청, SQLite 저장소.F71–F78·F64·F65
F71–F76/F78에 API·DB·배포 정의
protocolDeviceId, SessionId, signed ticket, capability, candidate, error. 요청 ID·epoch·한도·만료 검증.F04·F06·F67
서버와 PC가 같은 schema 사용
transportQuinn QUIC·직접 socket·candidate 검사·relay adapter. 경로별 MTU와 deadline·혼잡 처리.F10·F11·F28·F31–F33·F60
relay-server배정된 세션의 암호문 forwarding. endpoint 확인·allocation 수명·대역폭 quota·bounded queue.F33·F05·F68
codec/GPU 의존성 없음
host / client장치 키 저장, 호스트 최종 승인, 영상·오디오·입력, 세션/복구 UI. service와 사용자 세션 agent 분리.F07–F25·F40·F48–F59·F66–F70

라이브러리 후보: axum · Quinn endpoint / abstract socket. 이는 구현 선택안이며 성능 검증 결과가 아닙니다.

Relay를 구현하는 두 선택지

A. 자체 제한형 UDP relay: 양쪽 앱의 인증된 allocation을 연결하고, 내부 QUIC 패킷을 봉투에 담아 전달합니다. 포트는 단순해질 수 있지만 프로토콜·주소 변경·혼잡·반사 방지·시험을 직접 구현해야 합니다.

B. coturn + TURN client adapter: 표준 relay 서버를 재사용합니다. 앱에 allocation/permission/channel/refresh와 Quinn socket adapter를 구현하고 추가 header만큼 MTU를 조정해야 합니다.

A와 B는 대안입니다. 이 페이지의 UDP 40000은 A의 예시이며 coturn 설정이 아닙니다. relay 상세 프로토콜을 결정하기 전에는 배포 완료로 취급하지 않습니다.

coturn 공식 저장소 · TURN RFC 8656

암호화의 끝은 두 PC여야 합니다

클라이언트↔서버 QUIC과 서버↔호스트 QUIC을 두 개 만들고 평문 영상을 이어주면 서버는 내용을 볼 수 있습니다. 여기서 제안한 relay는 PC 사이 QUIC를 내부에 유지하는 암호문 전달 경로입니다.

relay를 통과하는 socket의 peer 주소·MTU·packet 수명을 transport adapter가 관리해야 합니다. Quinn을 붙였다는 이유만으로 NAT 통과·relay·종단 암호화가 완성되지는 않습니다.

홈서버는 시각·IP·패킷 크기 같은 metadata는 알 수 있습니다. 호스트의 사전 신뢰 키를 서버가 임의 교체할 수 없도록 첫 등록과 key rotation 정책도 필요합니다.

처음 정의할 서버 API와 저장 항목
API 제안동작
POST /v1/devices/enroll일회 코드 검증, 장치 공개키 등록. 관리자 bootstrap은 별도 로컬 절차.
GET /v1/devices허용된 장치만 조회. 온라인 상태·capability·접속 가능 사유.
WSS /v1/eventspresence, session.offer, decision, candidate, revoke. reconnect 뒤 snapshot과 revision 재동기화.
POST /v1/sessions호스트에 요청 전달. 승인 전 media ticket 발급하지 않음.
POST /v1/sessions/{id}/decision지정된 host 키만 승인/거절. 요청 ID와 만료·중복 검증.
POST /v1/sessions/{id}/relay승인된 세션만 제한된 relay allocation/ticket 발급.
DELETE /v1/trust/{grant_id}신뢰 철회·새 ticket 차단·활성 host에 종료 요청.

SQLite: devices, trust_grants, enrollment_codes, invitations, sessions, session_audit, schema_version. 상세 API·DB는 CONTROL_SERVER.ko.md의 F71–F79 계약을 따릅니다. raw frame·입력 내용·채팅 본문은 기본 저장하지 않습니다. 장치 개인키는 각 PC의 OS 보호 저장소에 둡니다. 서버는 장치 공개키와 별도의 서버 signing key를 관리합니다. 배포 시 API 인증·요청 크기·rate limit·nonce·로그 redaction 계약도 구현해야 합니다.

09 / BANDWIDTH, NOT GPU

중계할 때 중요한 것은 집의 업로드입니다

아래는 영상 평균 bitrate × 동시 스트림 수에 여유 10%를 더한 설명용 추정입니다. 입력·오디오·header·재전송 비용을 실제 측정한 값은 아니며, reverse microphone·복수 화면 등 추가 트래픽은 별도 합산해야 합니다.

다중 스트림은 회선 계산 예시입니다. 기존 첫 버전의 동시 세션 1개 목표를 변경하지 않습니다.

집 WAN 업로드27.5 Mbps업로드의 27.5%
집 WAN 다운로드0 Mbps미디어 방향 기준 · 제어 트래픽 제외
하루 집 WAN 전송량 · 양방향 합24.8 GB십진 GB · 상시 동일 평균 bitrate 가정

왜 항상 “중계면 업로드 2배”가 아닐까요?

호스트가 집에 있으면 집 PC → 홈서버는 LAN이고 홈서버 → 외부 client가 WAN 업로드입니다. 같은 stream을 직접 보내든 집 relay가 보내든 집 WAN 업로드의 기본량은 한 번입니다.

두 PC가 모두 집 밖인데 집 relay를 쓰면 WAN 다운로드 R + WAN 업로드 R이 발생합니다. 합산 트래픽은 2R지만 업로드만 2R인 것은 아닙니다. relay NIC의 수신+송신과 집 WAN 사용량도 구분해야 합니다.

계산식: R = bitrate × streams × 1.1. 1 Mbps × 1시간 = 0.45 GB. 업로드 70%를 미디어 예산으로 보는 것은 다른 집 트래픽과 순간 burst를 위한 초기 가정이며, 통과 기준이나 성능 보장이 아닙니다.

10 / OPERATING THE SERVICE

서버 장애와 화면 장애를 분리해서 봅니다

상황예상 영향설계할 동작
Control API 중단목록·새 접속·권한 변경 전달 실패. 서버 관리 세션은 마지막 권한 갱신 후 120초 내 종료하는 초기 정책. 수동 offline 모드는 별도.WSS backoff, 온라인 상태 재동기화. 서버 철회는 전달 전까지 즉시 적용할 수 없음. host 로컬 종료와 세션 만료는 독립 집행.
홈서버 relay 중단그 relay를 쓰는 stream 중단. 직접 연결은 별도.입력 release-all, 경로 재검사·재연결, epoch 교체·IDR 요청.
집 인터넷 / 정전집 host와 control·home relay 모두 도달 불가.VPS relay만 추가해도 집 host를 살릴 수는 없음. UPS·자동 기동·DNS 갱신·전원 복구를 별도 검토.
외부망이 UDP 차단직접 QUIC·UDP relay·기본 WireGuard 모두 실패 가능.필요하면 앱이 지원하는 TCP/TLS relay 어댑터를 후속 개발. TCP 443을 열기만 해서는 같은 UDP가 통과하지 않음. 지연 영향 측정.
집 PC 절전 / 로그인 전host agent의 화면 캡처 불가 또는 offline.Wake-on-LAN은 NIC/펌웨어/전원 상태 조건을 확인한 선택 기능. 로그인 전 화면은 service/session agent 구현과 별개 시험 필요.
호스트 GPU / Privacy 실패네트워크가 정상이어도 영상이나 물리 화면 차단 실패.host가 실제 상태를 확인해 알림·중단·복원. 서버의 “연결됨” 상태로 정상 처리하지 않음.

운영 데이터

DB·TLS 설정·서버 signing key는 일관된 백업과 복원 시험 대상입니다. 미디어 packet은 저장하지 않고 연결 성공률·직접/relay 비율·RTT·drop·큐·회선 사용량을 측정합니다.

서버에 줄 권한

API와 relay는 최소 권한의 별도 프로세스로 실행합니다. relay는 승인한 세션·endpoint로만 전달하고 allocation 만료·byte quota를 적용합니다. DB 관리 포트나 개인 PC 관리 포트를 함께 공개할 이유는 없습니다.

11 / A PRACTICAL START

당신의 환경에서는 이 순서가 맞습니다

추천 시작점: 홈서버에 단일 Control API를 두고, 집 host의 명시 UDP 경로 또는 개인 VPN으로 먼저 연결합니다. 자동 NAT 통과와 relay는 외부망 시험 결과를 보고 추가합니다. 현재 조건에서는 외부 VPS를 먼저 구매할 필요가 없습니다.

검토 표시 0 / 6 · 실제 개발 완료 상태와는 별도

여기 체크는 이 설명의 검토 기록입니다. 현재 82개 기능 체크리스트의 선택·진행 상태는 바꾸지 않습니다.

기존 개발 체크리스트 열기 ↗ · 영상 엔진 상세 아키텍처 ↗

12 / SOURCES & ASSUMPTIONS

공식 근거와 자체 설계의 경계

공식 자료 확인: 2026-09-20. 서버 배치·Rust API·포트 40000/40010·회선 여유율·개발 순서는 이 프로젝트의 제안입니다. Parsec의 전용 서버 코드를 복원했다거나 동등 성능을 검증했다는 의미가 아닙니다.