notParsec / 문서전체 문서

생성 코드·템플릿

notParsec · 내 홈서버로 운영하는 원격 데스크톱

design/homeserver.template.html

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

<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>notParsec · 내 홈서버로 운영하는 원격 데스크톱</title>
<style>
:root{color-scheme:light;--bg:#f6f8f6;--surface:#fff;--ink:#18312e;--muted:#526963;--line:#d5dfd9;--green:#126b59;--greenbg:#e2f1e8;--blue:#326b9d;--bluebg:#e8f0f8;--orange:#926028;--orangebg:#fff1dc;--radius:10px}*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.75 'Segoe UI','Malgun Gothic',sans-serif}a{color:var(--green);text-underline-offset:4px}button,input,select{font:inherit}button{cursor:pointer;border:1px solid var(--line);border-radius:6px;padding:9px 14px;background:var(--surface);color:var(--ink)}button:hover{border-color:var(--green)}button[aria-pressed=true],button.primary{background:var(--green);color:#fff;border-color:var(--green)}button:focus-visible,a:focus-visible,input:focus-visible,select:focus-visible,summary:focus-visible{outline:3px solid var(--blue);outline-offset:3px}input,select{padding:9px 11px;border:1px solid #a9bdb2;border-radius:5px;color:var(--ink);background:var(--surface);max-width:100%}input[type=range]{accent-color:var(--green);width:100%;padding:0}input[type=checkbox]{accent-color:var(--green);width:19px;height:19px}h1,h2,h3,p{margin-top:0}h1{font-size:clamp(32px,4.5vw,57px);line-height:1.22;letter-spacing:-2px;font-weight:650;margin:18px 0 26px}h2{font-size:27px;line-height:1.4;letter-spacing:-.8px;margin-bottom:20px}h3{font-size:18px;line-height:1.5;margin-bottom:9px}p{margin-bottom:14px}code,pre{font-family:Consolas,'Malgun Gothic',monospace;overflow-wrap:anywhere}code{font-size:.9em}pre{white-space:pre-wrap;background:var(--bluebg);padding:20px;border-radius:6px;font-size:13px;line-height:1.7}small,.small{font-size:13px;color:var(--muted)}.shell{max-width:1520px;margin:auto;display:grid;grid-template-columns:226px minmax(0,1fr)}aside{padding:32px 24px;position:sticky;top:0;height:100vh;overflow-y:auto;border-right:1px solid var(--line)}.brand{font-size:24px;font-weight:700;letter-spacing:-1px}.brand em{font-style:normal;color:var(--green)}.edition{font:12px/1.8 Consolas,monospace;letter-spacing:1px;margin:24px 0;color:var(--muted)}nav{display:grid;gap:12px;margin:22px 0}nav a{color:var(--muted);text-decoration:none;font-size:14px}nav a:hover{color:var(--green)}.side-note{font-size:12px;color:var(--muted);margin-top:35px}main{min-width:0;padding:38px clamp(22px,4vw,64px) 80px}header{padding-bottom:12px}.eyebrow{color:var(--green);font-size:12px;letter-spacing:1px}.lead{font-size:18px;max-width:850px}.known{display:flex;gap:10px;flex-wrap:wrap;margin:25px 0}.known span{background:var(--greenbg);padding:5px 10px;border-radius:4px;font-size:13px}.section{padding-top:54px;scroll-margin-top:22px;border-top:1px solid var(--line);margin-top:34px}.section-top{display:flex;justify-content:space-between;align-items:baseline;gap:15px;flex-wrap:wrap}.number{color:var(--green);font:13px Consolas,monospace;display:block;margin-bottom:9px}.callout{border-left:3px solid var(--green);padding:17px 20px;background:var(--greenbg);margin:22px 0}.callout.warn{background:var(--orangebg);border-color:var(--orange)}.columns{display:grid;grid-template-columns:1fr 1fr;gap:28px}.columns.three{grid-template-columns:repeat(3,1fr)}.note-block{border-top:2px solid var(--line);padding-top:17px}.mode-buttons{display:flex;gap:8px;flex-wrap:wrap;margin:22px 0 12px}.compact-select{display:flex;align-items:center;gap:12px;flex-wrap:wrap;margin-bottom:22px}.legend{display:flex;gap:18px;flex-wrap:wrap;color:var(--muted);font-size:13px}.legend span{display:inline-flex;align-items:center;gap:8px}.swatch{width:27px;height:3px;background:var(--blue);display:inline-block}.swatch.media{background:var(--green);height:4px}.network{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:24px;margin-top:18px}.network-grid{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1.2fr) minmax(0,1fr);gap:26px;align-items:start}.network-node{padding:18px;background:var(--bg);border-top:3px solid var(--line);min-width:0}.network-node.server{border-color:var(--blue);background:var(--bluebg)}.network-node .tag{font:11px Consolas,monospace;letter-spacing:1px;color:var(--muted)}.network-node strong{display:block;font-size:19px;margin:8px 0}.network-node p{font-size:13px;margin:0}.network-node .role{margin-top:12px;border-top:1px solid var(--line);padding-top:10px}.network-node.selected{border-color:var(--green)}.control-links{display:grid;grid-template-columns:1fr 1fr;gap:16px;color:var(--blue);font-size:13px;text-align:center;padding:12px 0}.control-links span{border-bottom:2px solid var(--blue);padding-bottom:8px}.media-route{display:flex;align-items:center;gap:8px;justify-content:center;flex-wrap:wrap;padding:22px 0 10px;border-top:1px solid var(--line);margin-top:6px}.route-node{background:var(--greenbg);padding:9px 14px;border-radius:5px;color:var(--green);font-size:14px}.route-arrow{color:var(--green);font-size:20px}.route-caption{text-align:center;font-size:13px;color:var(--muted);margin:8px 0 0}.path-answer{display:grid;grid-template-columns:1fr 1fr;gap:22px;margin-top:22px}.path-answer h3{font-size:15px}.path-answer p{font-size:14px}.facts{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.facts>div{border-top:2px solid var(--line);padding-top:17px}.facts strong{font-size:28px;display:block;line-height:1.4;font-variant-numeric:tabular-nums}.facts span{font-size:13px;color:var(--muted)}.table-wrap{overflow-x:auto}table{width:100%;border-collapse:collapse;margin:20px 0;font-size:14px}th,td{border-bottom:1px solid var(--line);padding:13px 11px;text-align:left;vertical-align:top}th{font-size:12px;color:var(--muted);font-weight:600}td:first-child{font-weight:600}td p{margin:0}.steps{list-style:none;padding:0;margin:24px 0;counter-reset:step}.steps li{counter-increment:step;display:grid;grid-template-columns:34px 1fr;gap:14px;border-bottom:1px solid var(--line);padding:18px 0}.steps li:before{content:counter(step,decimal-leading-zero);font:14px Consolas,monospace;color:var(--green);padding-top:5px}.steps strong{display:block}.steps p{font-size:14px;margin:6px 0 0}.domain-control{display:grid;grid-template-columns:1fr auto;gap:14px;align-items:end;margin-top:20px}.domain-control label{display:grid;gap:6px;font-size:14px}.error{color:#9c2a27;font-size:13px;min-height:24px;margin:6px 0}details{margin:16px 0}summary{cursor:pointer;color:var(--green);font-size:14px}details>div{padding-top:15px}.sliders{display:grid;grid-template-columns:1fr 1fr;gap:21px 30px;margin:24px 0}.sliders label{display:block;font-size:14px}.slider-head{display:flex;justify-content:space-between;gap:10px}.slider-head output{font-weight:600;font-variant-numeric:tabular-nums}.meter{height:8px;background:var(--line);border-radius:3px;overflow:hidden;margin:15px 0}.meter span{display:block;height:100%;background:var(--green);transition:width .18s}.meter.high span{background:var(--orange)}.capsule{font:12px Consolas,monospace;background:var(--bluebg);padding:2px 5px}.source{font-size:12px;color:var(--muted)}.task{display:flex;align-items:flex-start;gap:12px;padding:14px 0;border-bottom:1px solid var(--line);font-size:14px}.task input{flex-shrink:0;margin-top:5px}.task strong{display:block}.task small{display:block;margin-top:5px}.check-progress{font-size:13px;color:var(--muted)}footer{font-size:12px;color:var(--muted);border-top:1px solid var(--line);margin-top:45px;padding-top:20px}.sources-list{padding-left:20px;font-size:14px}.sources-list li{margin:10px 0}.no-js{padding:16px;background:var(--orangebg)}.copy-status{min-height:24px;font-size:13px;color:var(--green)}[hidden]{display:none!important}
@media(max-width:1000px){.shell{grid-template-columns:190px 1fr}aside{padding:25px 20px}main{padding:30px 25px}.network-grid{gap:12px}.network-node{padding:13px}.network-node strong{font-size:17px}.columns.three{grid-template-columns:1fr}}
@media(max-width:740px){html{scroll-behavior:auto}.shell{display:block}aside{height:auto;position:static;border-right:0;border-bottom:1px solid var(--line);padding:20px}.edition,.side-note{display:none}nav{display:flex;flex-wrap:wrap;gap:8px 16px;margin:12px 0 0}nav a{font-size:12px}main{padding:25px 18px 50px}h1{font-size:37px;letter-spacing:-1.4px}h2{font-size:24px}.lead{font-size:16px}.section{padding-top:32px;margin-top:28px}.columns,.path-answer,.facts,.sliders{grid-template-columns:1fr}.network{padding:16px}.network-grid{grid-template-columns:1fr}.network-node{padding:15px}.control-links{grid-template-columns:1fr;text-align:left}.control-links span{border-bottom:0;border-left:2px solid var(--blue);padding:0 0 0 10px}.media-route{align-items:stretch;flex-direction:column;text-align:center}.route-arrow{transform:rotate(90deg);line-height:1}.domain-control{grid-template-columns:1fr}.mode-buttons button{flex:1 1 145px;min-height:46px}.compact-select select{width:100%}td{min-width:125px}td:first-child{min-width:115px}.facts{gap:12px}.facts strong{font-size:25px}.callout{padding:15px}.table-wrap{margin-right:0}}
@media print{aside,.mode-buttons,.compact-select,.domain-control button,.sliders,button,.meter{display:none}.shell{display:block}body{background:#fff}main{padding:0}.section{margin-top:20px;padding-top:24px}.network,.steps li,.note-block{break-inside:avoid}details>div{display:block!important}.table-wrap{overflow:visible}a{color:inherit}}
@media(prefers-reduced-motion:reduce){*{scroll-behavior:auto!important;transition:none!important}}
</style>
</head>
<body>
<div class="shell">
<aside><div class="brand">not<em>Parsec</em></div><div class="edition">SELF-HOSTED ARCHITECTURE<br>2026.09 · EXPLAINER</div><nav aria-label="설명 목차"><a href="#idea">01 전체 구조</a><a href="#password-access">접속 비밀번호</a><a href="#concepts">02 VPN·VPS 개념</a><a href="#paths">03 연결 경로 비교</a><a href="#deploy">04 홈서버 배치</a><a href="#control-system">05 연결 관리 서버</a><a href="#domains">06 도메인과 포트</a><a href="#sequence">07 연결되는 순서</a><a href="#rust">08 Rust 모듈</a><a href="#capacity">09 회선 계산</a><a href="#operations">10 운영·장애</a><a href="#start">11 개발 순서</a></nav><div class="side-note">공인 IP · UDP 포트포워딩 가능<br>개인 소유 장치용 설계<br><br><a href="notparsec-plan.html#features">기능 체크리스트로 돌아가기 ↗</a></div></aside>
<main>
<header id="idea"><span class="eyebrow">YOUR HOME SERVER, YOUR REMOTE DESKTOP</span><h1>홈서버는 연결을 주선하고,<br>화면은 PC끼리 보냅니다.</h1><p class="lead">Parsec처럼 <strong>앱을 켜면 내 컴퓨터가 보이고, 누르면 연결되는 경험</strong>을 만들려면 “연결 관리 서버”와 “실제 원격 스트리밍”을 나눠야 합니다. 이미 가진 홈서버와 도메인으로 연결 관리 부분을 운영할 수 있습니다.</p><div class="known"><span>확인됨 · Ubuntu 24.04.4 / N100</span><span>확인됨 · 도메인 연결</span><span>확인됨 · 공인 IP + UDP 포트포워딩</span></div><p class="small">서버는 Ubuntu 24.04.4 LTS / kernel 6.8.0-136-generic / Intel N100 / x86_64 / 4코어·4스레드입니다. 실제 서비스 도메인·회선 속도·호스트 위치는 미확인입니다. 아래는 집 PC 접속을 기본 예로 한 제안이며, 이름·포트·주소·속도는 설명용입니다. 기존 Parsec 서버에 연결하는 구성이 아닌 자체 notParsec 서비스입니다.</p><div class="columns"><div class="note-block"><h3>연결 관리 · Control plane</h3><p>내 장치 목록, 온라인 상태, 기기 인증, 접속 승인, 접속할 주소 전달. 홈서버의 Rust API가 처리합니다.</p></div><div class="note-block"><h3>영상과 조작 · Data plane</h3><p>화면·소리·키보드·마우스. 가능한 경로로 두 앱이 통신하고, 직접 연결이 안 되면 relay가 패킷을 전달합니다.</p></div></div><p class="source">Parsec도 host/client, Signal API, STUN을 구분합니다. 이 구분을 참고해 아래 자체 운영안을 설계했습니다. <a href="https://support.parsec.app/hc/en-us/articles/32361410290324-Components-and-Connection-Sequence" target="_blank" rel="noopener">공식 연결 구조</a></p></header>

<section class="section" id="password-access"><span class="number">ACCESS / SINGLE OWNER</span><h2>계정 로그인 대신 접속 대상 PC의 비밀번호를 입력합니다</h2><p>내 기기만 사용하므로 가입·계정 로그인·로그아웃 화면은 없습니다. 앱은 저장된 서버 주소와 장치 키로 시작하고, 원격 접속할 때 <strong>그 PC에 설정한 비밀번호</strong>를 입력합니다.</p><div class="network" role="figure" aria-label="접속 대상 선택, 호스트 인증서 검증, 비밀번호 입력, 호스트 검증 성공 후 영상 입력 허용"><div class="media-route"><span class="route-node">접속할 PC 선택</span><span class="route-arrow">→</span><span class="route-node">인증서 확인 · 비밀번호 입력</span><span class="route-arrow">→</span><span class="route-node">호스트 검증 후 접속</span></div></div><div class="columns"><div class="note-block"><h3>Windows host가 보관·검증</h3><p>비밀번호 원문 대신 Argon2id verifier를 저장하고 개인키와 함께 DPAPI로 보호합니다. 신뢰한 host 인증서가 확인된 QUIC 채널 안에서만 전달하며, 실패 제한은 새 연결에서도 유지됩니다. 비밀번호를 저장해 재접속을 자동 통과시키지 않습니다.</p></div><div class="note-block"><h3>Ubuntu 서버는 장치 연결을 관리</h3><p>비밀번호나 verifier를 중앙 서버에 업로드하지 않습니다. 앱 내부의 장치 키 인증은 유지합니다. 서버의 접속 ticket은 연결 시도만 허용하고, 화면·입력은 host 비밀번호 확인 뒤에만 열립니다.</p></div></div><div class="callout"><strong>현재 구현:</strong> Windows GUI와 실제 QUIC 인증 CLI, 로컬 비밀번호 초기 설정·변경, 인증서 검증, host 전체 실패 제한, 장치 등록/인증/목록/heartbeat/폐기 API, GPU 캡처 probe, Ubuntu native ELF, WSS·세션/ticket·grant/lease·명시 후보와 백업/복원/rollback 시험. <strong>남은 작업:</strong> sudo 권한 준비 후 운영 Nginx/systemd 적용, Windows 새 세션 통합·영상·음성·입력·외부망 시험. <a href="UBUNTU_OPERATIONS.ko.md">실제 검증 기록</a>.</div><p><a href="notparsec-plan.html#password-access">F80–F82 개발 목록 ↗</a> · <a href="../IMPLEMENTATION.md">빌드·실행 방법 ↗</a></p></section>
<section class="section" id="concepts"><span class="number">02 / CONCEPTS · VPS · VPN · RELAY</span><h2>VPS는 서버를 두는 곳, VPN은 연결하는 방법입니다</h2><p>이 둘은 서로 대체하는 제품 이름이 아닙니다. VPS 위에 VPN을 실행할 수도 있고, 지금 가진 홈서버에서 VPN을 운영할 수도 있습니다. <strong>어디에 컴퓨터를 둘지</strong>와 <strong>어떤 네트워크 경로로 연결할지</strong>를 나누어 보면 이해하기 쉽습니다.</p>
<div class="columns three"><div class="note-block"><h3>홈서버 · 내가 집에서 운영하는 컴퓨터</h3><p>집에 있는 물리 PC나 그 안의 가상 머신에 서버 프로그램을 실행합니다. 이미 보유한 장비·공인 IP를 활용하지만 집의 전원·공유기·인터넷 회선에 영향을 받습니다.</p><p class="small">이 프로젝트에서는 장치 목록과 접속 승인 서버를 먼저 배치합니다. 원격으로 조작할 Windows PC와 같은 장비일 수도, 다른 장비일 수도 있습니다.</p></div>
<div class="note-block"><h3>외부 VPS · 집 밖에서 빌리는 가상 서버</h3><p><strong>Virtual Private Server</strong>의 약자입니다. 호스팅 업체의 데이터센터 컴퓨터를 가상으로 나눠, 내가 OS와 프로그램을 운영할 수 있게 빌리는 서버입니다. “외부”는 집 네트워크 밖이라는 뜻이며 반드시 해외라는 뜻은 아닙니다.</p><p>여기에 연결 관리 API, 패킷 relay, VPN 서버 등을 설치할 수 있습니다. 임대료·전송량 조건·지역·UDP 사용 가능 여부를 확인해야 하며, 일반 VPS에 스트리밍용 GPU가 있다고 가정하지 않습니다.</p><p class="source"><a href="https://aws.amazon.com/what-is/vps/" target="_blank" rel="noopener">VPS 개념 · AWS 공식 설명</a></p></div>
<div class="note-block"><h3>개인 VPN · 내 장치의 사설 연결 통로</h3><p><strong>Virtual Private Network</strong>입니다. 외부 노트북과 집 네트워크 사이에 인증·암호화된 터널을 만들고, 정해 둔 사설 IP 경로로 통신하게 합니다. 여기서는 WireGuard를 집 공유기나 홈서버에 설치하는 구성을 예로 듭니다.</p><p>VPN 자체가 화면을 캡처하거나 마우스를 조작하지는 않습니다. 그 기능은 notParsec 앱이 담당합니다. 업체의 인터넷 출구를 빌리는 상용 VPN 구독과도 용도가 다릅니다.</p><p class="source"><a href="https://www.wireguard.com/" target="_blank" rel="noopener">WireGuard 공식 개념 설명</a></p></div></div>
<div class="columns" style="margin-top:26px"><div class="network" role="figure" aria-label="개인 VPN: 외부 노트북에서 암호화 터널로 집 VPN 허브에 연결하고 집 PC로 라우팅"><h3>개인 VPN 예시</h3><div class="media-route"><span class="route-node">외부 노트북</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">집 WireGuard 허브</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">집 PC</span></div><p class="small">노트북 ↔ 허브는 VPN 터널, 허브 ↔ 집 PC는 LAN 경로입니다. 앱은 그 위에서 PC 간 QUIC을 유지합니다. VPN이 끝나는 허브를 영상 암호화의 끝으로 취급하지 않습니다.</p></div>
<div class="network" role="figure" aria-label="외부 VPS relay: 외부 노트북과 집 PC가 데이터센터의 중계 서버를 거쳐 연결"><h3>외부 VPS relay 예시</h3><div class="media-route"><span class="route-node">외부 노트북</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">데이터센터의 VPS</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">집 PC</span></div><p class="small">VPS에서 실행하는 relay 프로그램이 두 PC의 암호화된 패킷을 전달합니다. VPS를 빌리는 것만으로 relay가 생기지는 않으며, 프로그램과 포트 설정이 필요합니다.</p></div></div>
<div class="table-wrap"><table><thead><tr><th>개념</th><th>답하는 질문</th><th>이 설계에서의 역할</th></tr></thead><tbody><tr><td>홈서버 / VPS</td><td>서버 프로그램을 어디서 실행할까?</td><td>집 장비 또는 외부 데이터센터의 가상 서버</td></tr><tr><td>VPN</td><td>내 장치가 어떤 사설 경로로 접근할까?</td><td>접근 가능한 IP 경로·암호화 터널. 앱의 신뢰/승인은 계속 필요</td></tr><tr><td>연결 관리 서버</td><td>어떤 PC에 누가 연결하도록 허용할까?</td><td>기기 목록·온라인 상태·승인·주소 전달</td></tr><tr><td>Relay</td><td>직접 통신이 안 되면 누가 패킷을 전달할까?</td><td>홈서버나 VPS에서 실행할 수 있는 선택 중계 프로그램</td></tr></tbody></table></div>
<div class="callout"><strong>현재 환경에 적용하면</strong><br>이미 공인 IP와 UDP 포트포워딩이 있으므로 홈서버의 연결 관리 API와 집 PC 직접 경로부터 시작할 수 있습니다. PC의 앱 포트를 따로 공개하고 싶지 않다면 VPN의 UDP 포트만 열고 사설 경로로 접속하는 대안이 있습니다. VPS는 집 중계 경로의 지연·가용성 문제가 실제로 확인되었을 때 추가로 검토합니다.</div>
<p class="small">VPN은 집 대역만 보내는 split tunnel로 구성할 수 있어 모든 인터넷 트래픽을 집으로 우회할 필요가 없습니다. route·AllowedIPs·방화벽은 별도 설정해야 합니다. 이 문서의 WireGuard는 허브 방식이며, 자동 direct/relay를 선택하는 mesh VPN은 다른 배치입니다. UDP가 차단된 외부망에서는 기본 WireGuard도 막힐 수 있습니다.</p></section>

<section class="section" id="paths"><span class="number">03 / NETWORK PATH</span><h2>같은 앱, 서로 다른 연결 경로</h2><p>현재 환경에서는 <strong>집 호스트로 직접 연결</strong>하는 경로부터 만들 수 있습니다. PC 포트를 따로 공개하지 않고 시작하려면 개인 VPN도 가능합니다. 자동 NAT 통과와 relay는 연결 범위를 넓히는 다음 단계입니다.</p><div class="mode-buttons" role="group" aria-label="연결 경로"><button type="button" data-mode="direct" aria-pressed="true">PC끼리 직접 연결</button><button type="button" data-mode="home" aria-pressed="false">홈서버 중계</button><button type="button" data-mode="vpn" aria-pressed="false">개인 VPN</button><button type="button" data-mode="vps" aria-pressed="false">외부 VPS 중계</button></div><div class="compact-select"><label for="host-place">조작할 호스트 PC 위치</label><select id="host-place"><option value="home">집 안 · 홈서버와 같은 LAN</option><option value="away">집 밖 · 다른 네트워크</option></select></div><div class="legend"><span><i class="swatch" aria-hidden="true"></i>파란 경로: 접속 요청·주소 교환</span><span><i class="swatch media" aria-hidden="true"></i>초록 경로: 화면·소리·조작</span></div>
<div class="network" role="figure" aria-label="클라이언트, 홈서버, 호스트 사이의 연결 구조"><div class="network-grid"><div class="network-node" id="client-node"><span class="tag">CLIENT / OUTSIDE</span><strong>외부 노트북</strong><p>영상 decode · 화면 표시<br>키보드·마우스 입력 수집</p><p class="role">Windows client<br>MF · D3D11 · Rust</p></div><div class="network-node server" id="server-node"><span class="tag">YOUR HOME SERVER</span><strong>연결 관리 서버</strong><p>기존 Nginx<br>Rust API + WebSocket<br>기기 목록 · 신뢰 · SQLite</p><p class="role" id="server-role">목록·인증·접속 요청만 담당</p></div><div class="network-node" id="host-node"><span class="tag" id="host-tag">HOST / HOME LAN</span><strong id="host-title">조작할 집 PC</strong><p>화면 capture · encode<br>오디오 수집 · 승인된 입력 적용</p><p class="role">Windows host<br>DXGI · NVENC · Rust</p></div></div><div class="control-links"><span>클라이언트 ↔ 홈서버 · HTTPS / WSS</span><span>호스트 ↔ 홈서버 · HTTPS / WSS</span></div><div class="media-route" id="media-route"><span class="route-node">외부 노트북</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">집 PC</span></div><p class="route-caption" id="route-caption">종단 간 QUIC / UDP · 홈서버는 미디어를 처리하지 않음</p></div>
<div class="path-answer" aria-live="polite"><div><h3 id="path-title">PC끼리 직접 연결</h3><p id="path-detail"></p></div><div><h3>연결 조건</h3><p id="path-condition"></p></div></div><div class="callout" id="path-context"></div><p class="small">그림은 논리 경로입니다. 인터넷·공유기·방화벽을 모두 그린 물리 배선도는 아닙니다. 경로를 바꾸면 아래 포트 안내와 회선 계산도 갱신됩니다.</p></section>

<section class="section" id="deploy"><span class="number">04 / WHAT RUNS WHERE</span><h2>홈서버에 올릴 것, PC에 남길 것</h2><div class="table-wrap"><table><thead><tr><th>위치</th><th>프로세스 / 역할</th><th>보관 데이터와 자원</th></tr></thead><tbody><tr><td>홈서버 · 필수</td><td><strong>Control API + WSS</strong><br>장치 등록·접속 요청·온라인 상태·승인 전달. 개인용은 한 Rust 프로세스 안에 모듈로 구성.</td><td>기기 공개키·신뢰 정책·초대 hash·설정·연결 이력. GPU 불필요.</td></tr><tr><td>홈서버 · 필수</td><td><strong>기존 Nginx 재사용</strong><br>도메인별 HTTPS 인증서·API/WebSocket 전달.</td><td>인증서와 설정을 영속 저장. 기존 웹사이트의 443 listener에 가상 호스트 추가.</td></tr><tr><td>홈서버 · 필수</td><td><strong>SQLite</strong><br>한 서버·소수 기기에서 시작. 접속 상태는 메모리 + heartbeat로 관리.</td><td>DB·schema migration·일관된 백업. Redis/Kafka/Kubernetes는 초기 요구에 없음.</td></tr><tr><td>홈서버 · 선택</td><td><strong>Media relay</strong><br>인증된 두 endpoint 사이 암호문 전달. API와 별도 프로세스로 격리.</td><td>소켓·짧은 allocation·대역폭/큐 예산. 저장·트랜스코딩 없음.</td></tr><tr><td>홈서버 · 대안</td><td><strong>WireGuard VPN</strong><br>외부 장치에서 집 LAN으로 접근할 경로 제공.</td><td>VPN key·장치별 route. 앱의 호스트 승인과 장치 인증도 계속 필요.</td></tr><tr><td>호스트 PC</td><td><strong>Host agent</strong><br>GPU 캡처/인코딩·음성·입력·Privacy·가상 디스플레이.</td><td>실제 데스크톱·GPU·입력 권한. 홈서버가 대신 처리하지 않음.</td></tr><tr><td>클라이언트 PC</td><td><strong>Client app</strong><br>기기 선택·decode/render·입력 전송·overlay.</td><td>개인키·신뢰한 호스트 키·영상 버퍼. 서버 웹페이지가 이 기능을 자동 대체하지 않음.</td></tr></tbody></table></div><div class="callout"><strong>홈서버가 조작할 PC와 같은 기기라면?</strong><br>논리 역할은 그대로 나눕니다. 단, headless Linux 서버에 API를 올리는 것만으로 Windows 데스크톱이 생기지는 않습니다. Windows VM을 스트리밍하려면 VM 내부 host agent와 GPU/가상 디스플레이 조건을 별도로 갖춰야 합니다.</div><p class="small">Ubuntu + systemd를 기본 배포로 정했습니다. 24.04 LTS를 초기 검증 목표로 두며, API 1개·DB 1개·선택 relay 1개로 시작하는 것이 이 규모에 맞는 설계 제안입니다.</p></section>

<section class="section" id="control-system"><span class="number">05 / CONTROL SERVER · F71–F79</span><h2>연결 관리 서버도 하나의 개발 시스템입니다</h2><p>API 주소만 정하는 것으로는 “앱을 켜면 내 PC가 보이고 연결되는” 경험이 완성되지 않습니다. 장치 등록, 권한 검사, 온라인 상태, 승인 경합, 재시작 뒤 복구를 서버가 구현해야 합니다. 기존 체크리스트에 개요와 UI만 있던 부분을 <strong>독립 서버 기능 9개</strong>로 보강했습니다.</p>
<div class="network" role="figure" aria-label="PC 앱에서 HTTPS WSS를 거쳐 Rust 연결 관리 서버에 접근하고 서버가 SQLite 영속 상태와 메모리 접속 상태를 관리"><div class="media-route"><span class="route-node">PC 앱 · HTTPS/WSS</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">Rust API · 인증/승인</span><span class="route-arrow" aria-hidden="true">↔</span><span class="route-node">SQLite + 메모리 접속 상태</span></div><p class="route-caption">장기 권한은 DB에, 현재 socket·heartbeat는 메모리에 · 영상은 이 서버의 처리 대상이 아님</p></div>
<div class="table-wrap"><table><thead><tr><th>체크 항목</th><th>서버가 구현할 내용</th><th>완료 확인의 핵심</th></tr></thead><tbody>
<tr><td>F71 · 실행·API</td><td>Rust 프로세스, REST/WSS, 설정·오류·health</td><td>실제 Linux build/기동/종료, 비정상 설정 거부</td></tr>
<tr><td>F72 · DB</td><td>장치·권한·초대·세션, migration·transaction</td><td>동시 token 소비 1회, 중단 후 상태 일관성</td></tr>
<tr><td>F73 · 등록·인증</td><td>일회 등록 코드, 공개키 증명, API credential·키 교체</td><td>사칭·만료·재생 거부, host pin 자동 교체 금지</td></tr>
<tr><td>F74 · 목록·온라인</td><td>허용 기기 목록, heartbeat, WSS snapshot/revision</td><td>늦은 이벤트·재시작에도 유령 online 방지</td></tr>
<tr><td>F75 · 접속 승인</td><td>요청→승인→연결→종료, 세션 ticket</td><td>취소/승인 경합, host 최종 승인, ticket 재사용 차단</td></tr>
<tr><td>F76 · 초대·철회</td><td>기한·권한 있는 초대와 신뢰 철회</td><td>새 접속 차단, host 종료 ACK, offline 차이 표시</td></tr>
<tr><td>F77 · 주소 교환</td><td>승인된 peer 후보 전달·경로 정책·relay credential</td><td>비인가 후보 노출 방지, 미설정 relay 미광고</td></tr>
<tr><td>F78 · 서버 운영</td><td>TLS/WSS, 재시작·지표·백업·복원</td><td>빈 환경 복원, DB/key 보존, 이전 세션 무효화</td></tr>
<tr><td>F79 · 통합 시험</td><td>서버 + 두 PC + 외부 회선 연결</td><td>30분 실제 스트리밍, 10회 접속·종료, 철회·단절 검증</td></tr>
</tbody></table></div>
<p><a href="notparsec-plan.html#server-system">서버 9개 개발 범위를 체크하러 가기 ↗</a> · <a href="CONTROL_SERVER.ko.md">API·DB·상태 전이 상세 설계 ↗</a></p>
<div class="callout"><strong>필요한 서버 범위부터 선택합니다</strong><br>“연결 관리 서버 9개 추가”는 기존 선택을 유지하면서 필요한 선행 기능을 포함합니다. 기본 30개는 LAN 엔진이고 전체 카탈로그는 82개입니다. F64/F65 목록·초대 UI는 F74/F76에 연결되며, F32 자동 NAT 통과와 F33 relay는 별도 추가 기능입니다. 아래 검토 체크 6개는 개발 완료 기록과 다릅니다.</div>
<p class="small">초기 서버 관리 세션은 권한 lease를 주기적으로 갱신하고, 마지막 갱신 후 120초가 지나면 host가 입력 해제·종료하도록 제안합니다. 서버 단절 시 철회를 즉시 전달할 수 없기 때문입니다. 수동 direct/VPN offline 접속은 별도 로컬 허용 정책이며 서버 관리 세션의 철회 보장을 자동으로 받지 않습니다. 값과 정책은 상세 설계의 초기 제안입니다.</p></section>

<section class="section" id="domains"><span class="number">06 / DOMAIN & PORTS</span><h2>도메인은 주소, 포트는 실제 통로입니다</h2><p>웹사이트가 열린다는 사실은 UDP 영상 포트가 열린다는 뜻이 아닙니다. HTTPS 요청은 reverse proxy로, 직접 연결/relay UDP는 공유기와 방화벽에서 각각 해당 프로세스로 보냅니다.</p><div class="domain-control"><label for="domain">예시를 바꿀 도메인 <input id="domain" type="text" value="example.com" autocomplete="off" spellcheck="false" aria-describedby="domain-error"></label><button type="button" id="copy-config">현재 구성 요약 복사</button></div><p class="error" id="domain-error" role="alert"></p><p class="small">입력은 이 페이지의 예시만 바꿉니다. DNS·공유기·홈서버 설정에 접속하지 않습니다. ASCII 또는 punycode 도메인을 사용하세요.</p><div class="table-wrap"><table><thead><tr><th>이름 / 대상</th><th>외부 포트 예시</th><th>공유기에서 전달할 곳</th><th>사용 시점</th></tr></thead><tbody><tr><td><code data-domain-prefix="remote">remote.example.com</code></td><td>TCP 443<br>TCP 80은 인증 방식에 따라</td><td>홈서버 <code>192.168.1.10</code><br>기존 Nginx → 127.0.0.1:18080</td><td>기기 목록·인증·WSS<br>VPN 전용이면 내부로 제한 가능</td></tr><tr><td><code data-domain-prefix="pc">pc.example.com</code></td><td>UDP 40010</td><td>집 호스트 PC <code>192.168.1.20:40010</code></td><td>집 PC 직접 연결<br>PC별 고정 DHCP/방화벽 필요</td></tr><tr><td><code data-domain-prefix="relay">relay.example.com</code></td><td>UDP 40000</td><td>홈서버 relay <code>:40000</code><br>VPS 선택 시 DNS도 VPS IP로</td><td>자체 relay를 구현했을 때<br>TURN의 기본 포트가 아님</td></tr><tr><td><code data-domain-prefix="vpn">vpn.example.com</code></td><td>UDP 51820</td><td>집 공유기 또는 홈서버 VPN</td><td>VPN 대안 선택 시<br>위 두 미디어 공개 포트 생략 가능</td></tr><tr><td>STUN / TURN</td><td>보통 3478<br>TURN은 relay 포트 범위도 필요</td><td>선택한 STUN/TURN 서비스</td><td>자체 NAT 통과/표준 relay 단계에서만<br>별도 프로토콜 통합 필요</td></tr></tbody></table></div><p class="callout" id="active-ports" aria-live="polite"></p><div class="columns"><div class="note-block"><h3>공인 IP가 하나여도 됩니다</h3><p>여러 이름이 같은 A 레코드 IP를 가리킬 수 있습니다. HTTP 도메인은 reverse proxy가 구분하고, UDP는 포트/프로토콜과 앱의 라우팅이 구분합니다. 공유기가 도메인명으로 UDP를 다른 PC에 자동 분배하지는 않습니다.</p><p class="small">공인 IP가 변경되면 DDNS/DNS 갱신과 연결 재시도가 필요합니다. 내부 접속은 LAN 주소나 split DNS로 처리해 hairpin NAT 의존을 줄입니다. AAAA는 IPv6 경로·방화벽을 확인한 경우에 추가합니다.</p></div><div class="note-block"><h3>이미 연결한 도메인 서비스 확인</h3><p>Cloudflare의 일반 HTTP 프록시를 켠 이름을 임의 UDP endpoint로 사용하지 않습니다. 미디어 이름은 DNS-only로 실제 공인 IP를 가리키게 하거나 UDP를 지원하는 별도 구성을 씁니다.</p><p class="source">HTTP proxy와 UDP proxy는 별도 기능입니다. <a href="https://developers.cloudflare.com/dns/proxy-status/limitations/" target="_blank" rel="noopener">Cloudflare 제한</a> · <a href="https://developers.cloudflare.com/spectrum/reference/configuration-options/" target="_blank" rel="noopener">Spectrum의 TCP/UDP 역할</a></p></div></div><details><summary>HTTPS reverse proxy 예시와 배포 시 구분</summary><div><pre><code id="nginx-example"># 기존 HTTPS server block 내부, URI 보존
location ^~ /v1/ {
    proxy_pass http://127.0.0.1:18080;
}</code></pre><p class="small">현재 대상은 호스트 Nginx입니다. 위는 URI 보존 개념 예시이며 WSS 헤더/timeout·요청 제한·health를 포함한 실제 설정은 <a href="../deploy/ubuntu/README.ko.md">배포 파일</a>을 사용합니다. 실제 origin 후보는 <code>https://n3m.kr</code>이고 인증서는 유효하지만 운영 API 적용은 sudo 권한 대기입니다. 아래의 pc/relay/vpn 이름은 예시이며 해당 DNS·서비스·UDP 포트를 생성하지 않았습니다. 컨테이너를 쓰는 다른 환경에서는 그 컨테이너의 loopback을 호스트 loopback으로 취급하면 안 됩니다.</p><p class="source"><a href="https://nginx.org/en/docs/http/websocket.html" target="_blank" rel="noopener">Nginx WebSocket 전달</a></p><p class="small">TCP 443과 UDP 443은 다른 포트 공간입니다. 여기서는 HTTP/3와 자체 QUIC listener가 UDP 443을 두고 충돌하지 않도록 미디어에 별도 예시 포트를 배정했습니다.</p></div></details><p class="copy-status" id="copy-status" aria-live="polite"></p></section>

<section class="section" id="sequence"><span class="number">07 / CONNECTION LIFECYCLE</span><h2>“연결”을 누른 뒤 일어나는 일</h2><ol class="steps"><li><div><strong>한 번만: 장치를 등록하고 서로의 키를 신뢰</strong><p>관리자가 만든 일회 등록 코드로 장치 공개키를 서버에 등록합니다. 호스트 키의 fingerprint도 별도 확인해 저장합니다. 서버 API 인증과 원격 입력 허용은 다른 권한입니다.</p></div></li><li><div><strong>앱이 홈서버에 나가는 WSS 연결을 유지</strong><p>호스트가 온라인 상태·지원 codec·접속 후보를 알립니다. heartbeat가 끊기면 오프라인으로 표시합니다. 서버는 잠든 PC의 화면을 대신 제공할 수 없습니다.</p></div></li><li><div><strong>클라이언트가 특정 호스트로 접속 요청</strong><p>서버는 장치 신뢰·권한·만료를 검사하고 호스트에 요청을 전달합니다. 호스트가 승인하거나, 미리 허용한 개인 장치의 무인 접속 정책을 적용합니다.</p></div></li><li><div><strong>주소를 교환하고 도달 가능한 경로 선택</strong><p>LAN 주소 → 집의 명시 포트포워딩/VPN 주소 → NAT 통과 후보 → relay 순으로 후보를 평가합니다. 실제 정책은 timeout·측정 결과로 결정합니다. STUN만 설치한다고 hole punching이 자동 구현되지는 않습니다.</p></div></li><li><div><strong>두 PC가 종단 간 암호화 연결을 수립</strong><p>pinning한 host 키와 승인된 client 키를 확인합니다. 단기 ticket은 세션/양쪽 장치/권한/nonce/만료에 묶습니다. HTTPS 인증서만 확인하고 임의 호스트 키를 신뢰하지 않습니다.</p></div></li><li><div><strong>호스트 비밀번호 검증 뒤 codec·화면·입력 협상</strong><p>먼저 이 host에 설정한 비밀번호를 새 연결마다 확인합니다. 성공한 뒤 호스트가 DXGI → GPU 변환 → NVENC를 실행하고, 클라이언트가 decode → 표시합니다. 제어·키 입력은 reliable stream, 미디어는 QUIC DATAGRAM으로 보냅니다. 마이크·가상 장치·Privacy는 각 host/client 모듈이 처리합니다.</p></div></li><li><div><strong>단절·취소·종료를 정리</strong><p>입력 release-all, relay allocation 정리, 장치·Privacy 상태 복원, 로그와 상태 갱신. 직접/relay 전환의 초기 구현은 epoch를 새로 만들고 keyframe을 요청하는 재연결로 시작합니다. 무중단 전환은 별도 목표입니다.</p></div></li></ol><div class="callout warn"><strong>집 안 STUN의 위치에 주의</strong><br>호스트와 같은 LAN의 STUN에 LAN으로 질의하면 집 밖에서 보이는 NAT 매핑을 얻는 용도로 충분하지 않습니다. 집 PC는 명시 포트포워딩 주소를 우선 쓰고, 자동 NAT 통과는 외부 관측 지점·socket 유지·후보 검사까지 함께 설계합니다. 이는 현재 배치에 대한 설계 판단입니다.</div><p class="source">STUN은 주소 관측과 연결 검사 등에 쓰는 도구이며 독립적인 NAT 통과 해법은 아닙니다. <a href="https://www.rfc-editor.org/rfc/rfc8489.html" target="_blank" rel="noopener">RFC 8489</a></p></section>

<section class="section" id="rust"><span class="number">08 / RUST IMPLEMENTATION</span><h2>Rust 코어에 운영 서버를 붙이는 방법</h2><p>기존 설계의 영상 엔진을 그대로 두고 <code>apps/control-server</code>와 <code>apps/relay-server</code>를 추가하는 제안입니다. 논리 역할을 분리하되 소규모 API를 여러 microservice로 쪼개지는 않습니다.</p><div class="table-wrap"><table><thead><tr><th>모듈</th><th>책임</th><th>기존 개발 항목과 연결</th></tr></thead><tbody><tr><td><code>control-server</code></td><td>Tokio + axum 후보. HTTPS 뒤의 REST·WSS, 장치 등록·목록·초대·접속 요청, SQLite 저장소.</td><td>F71–F78·F64·F65<br>F71–F76/F78에 API·DB·배포 정의</td></tr><tr><td><code>protocol</code></td><td>DeviceId, SessionId, signed ticket, capability, candidate, error. 요청 ID·epoch·한도·만료 검증.</td><td>F04·F06·F67<br>서버와 PC가 같은 schema 사용</td></tr><tr><td><code>transport</code></td><td>Quinn QUIC·직접 socket·candidate 검사·relay adapter. 경로별 MTU와 deadline·혼잡 처리.</td><td>F10·F11·F28·F31–F33·F60</td></tr><tr><td><code>relay-server</code></td><td>배정된 세션의 암호문 forwarding. endpoint 확인·allocation 수명·대역폭 quota·bounded queue.</td><td>F33·F05·F68<br>codec/GPU 의존성 없음</td></tr><tr><td><code>host / client</code></td><td>장치 키 저장, 호스트 최종 승인, 영상·오디오·입력, 세션/복구 UI. service와 사용자 세션 agent 분리.</td><td>F07–F25·F40·F48–F59·F66–F70</td></tr></tbody></table></div><p class="source">라이브러리 후보: <a href="https://docs.rs/axum/latest/axum/" target="_blank" rel="noopener">axum</a> · <a href="https://docs.rs/quinn/0.11.12/quinn/struct.Endpoint.html" target="_blank" rel="noopener">Quinn endpoint / abstract socket</a>. 이는 구현 선택안이며 성능 검증 결과가 아닙니다.</p><div class="columns"><div class="note-block"><h3>Relay를 구현하는 두 선택지</h3><p><strong>A. 자체 제한형 UDP relay:</strong> 양쪽 앱의 인증된 allocation을 연결하고, 내부 QUIC 패킷을 봉투에 담아 전달합니다. 포트는 단순해질 수 있지만 프로토콜·주소 변경·혼잡·반사 방지·시험을 직접 구현해야 합니다.</p><p><strong>B. coturn + TURN client adapter:</strong> 표준 relay 서버를 재사용합니다. 앱에 allocation/permission/channel/refresh와 Quinn socket adapter를 구현하고 추가 header만큼 MTU를 조정해야 합니다.</p><p class="small">A와 B는 대안입니다. 이 페이지의 UDP 40000은 A의 예시이며 coturn 설정이 아닙니다. relay 상세 프로토콜을 결정하기 전에는 배포 완료로 취급하지 않습니다.</p><p class="source"><a href="https://github.com/coturn/coturn" target="_blank" rel="noopener">coturn 공식 저장소</a> · <a href="https://www.rfc-editor.org/rfc/rfc8656.html" target="_blank" rel="noopener">TURN RFC 8656</a></p></div><div class="note-block"><h3>암호화의 끝은 두 PC여야 합니다</h3><p>클라이언트↔서버 QUIC과 서버↔호스트 QUIC을 두 개 만들고 평문 영상을 이어주면 서버는 내용을 볼 수 있습니다. 여기서 제안한 relay는 <strong>PC 사이 QUIC를 내부에 유지하는 암호문 전달 경로</strong>입니다.</p><p>relay를 통과하는 socket의 peer 주소·MTU·packet 수명을 transport adapter가 관리해야 합니다. Quinn을 붙였다는 이유만으로 NAT 통과·relay·종단 암호화가 완성되지는 않습니다.</p><p class="small">홈서버는 시각·IP·패킷 크기 같은 metadata는 알 수 있습니다. 호스트의 사전 신뢰 키를 서버가 임의 교체할 수 없도록 첫 등록과 key rotation 정책도 필요합니다.</p></div></div><details><summary>처음 정의할 서버 API와 저장 항목</summary><div><div class="table-wrap"><table><thead><tr><th>API 제안</th><th>동작</th></tr></thead><tbody><tr><td><code>POST /v1/devices/enroll</code></td><td>일회 코드 검증, 장치 공개키 등록. 관리자 bootstrap은 별도 로컬 절차.</td></tr><tr><td><code>GET /v1/devices</code></td><td>허용된 장치만 조회. 온라인 상태·capability·접속 가능 사유.</td></tr><tr><td><code>WSS /v1/events</code></td><td>presence, session.offer, decision, candidate, revoke. reconnect 뒤 snapshot과 revision 재동기화.</td></tr><tr><td><code>POST /v1/sessions</code></td><td>호스트에 요청 전달. 승인 전 media ticket 발급하지 않음.</td></tr><tr><td><code>POST /v1/sessions/{id}/decision</code></td><td>지정된 host 키만 승인/거절. 요청 ID와 만료·중복 검증.</td></tr><tr><td><code>POST /v1/sessions/{id}/relay</code></td><td>승인된 세션만 제한된 relay allocation/ticket 발급.</td></tr><tr><td><code>DELETE /v1/trust/{grant_id}</code></td><td>신뢰 철회·새 ticket 차단·활성 host에 종료 요청.</td></tr></tbody></table></div><p class="small">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 계약도 구현해야 합니다.</p></div></details></section>

<section class="section" id="capacity"><span class="number">09 / BANDWIDTH, NOT GPU</span><h2>중계할 때 중요한 것은 집의 업로드입니다</h2><p>아래는 <strong>영상 평균 bitrate × 동시 스트림 수</strong>에 여유 10%를 더한 설명용 추정입니다. 입력·오디오·header·재전송 비용을 실제 측정한 값은 아니며, reverse microphone·복수 화면 등 추가 트래픽은 별도 합산해야 합니다.</p><div class="sliders"><label for="bitrate"><span class="slider-head">영상 평균 bitrate <output id="bitrate-out">25 Mbps</output></span><input type="range" id="bitrate" min="5" max="100" step="5" value="25"></label><label for="upload"><span class="slider-head">집 실측 업로드 <output id="upload-out">100 Mbps</output></span><input type="range" id="upload" min="10" max="1000" step="10" value="100"></label><label for="sessions"><span class="slider-head">동시 스트림 수 <output id="sessions-out">1개</output></span><input type="range" id="sessions" min="1" max="5" step="1" value="1"></label><label for="hours"><span class="slider-head">하루 이용 시간 <output id="hours-out">2시간</output></span><input type="range" id="hours" min="0.5" max="8" step="0.5" value="2"></label></div><p class="small">다중 스트림은 회선 계산 예시입니다. 기존 첫 버전의 동시 세션 1개 목표를 변경하지 않습니다.</p><div class="facts" aria-live="polite"><div><span>집 WAN 업로드</span><strong id="home-up">27.5 Mbps</strong><span id="upload-ratio">업로드의 27.5%</span></div><div><span>집 WAN 다운로드</span><strong id="home-down">0 Mbps</strong><span>미디어 방향 기준 · 제어 트래픽 제외</span></div><div><span>하루 집 WAN 전송량 · 양방향 합</span><strong id="home-gb">24.8 GB</strong><span>십진 GB · 상시 동일 평균 bitrate 가정</span></div></div><div class="meter" id="upload-meter" role="meter" aria-label="집 업로드 사용 비율" aria-valuemin="0" aria-valuemax="100" aria-valuenow="27.5"><span id="upload-fill" style="width:27.5%"></span></div><p id="capacity-answer" aria-live="polite"></p><p class="small" id="capacity-topology"></p><details><summary>왜 항상 “중계면 업로드 2배”가 아닐까요?</summary><div><p>호스트가 집에 있으면 <strong>집 PC → 홈서버</strong>는 LAN이고 <strong>홈서버 → 외부 client</strong>가 WAN 업로드입니다. 같은 stream을 직접 보내든 집 relay가 보내든 집 WAN 업로드의 기본량은 한 번입니다.</p><p>두 PC가 모두 집 밖인데 집 relay를 쓰면 <strong>WAN 다운로드 R + WAN 업로드 R</strong>이 발생합니다. 합산 트래픽은 2R지만 업로드만 2R인 것은 아닙니다. relay NIC의 수신+송신과 집 WAN 사용량도 구분해야 합니다.</p><p class="small">계산식: R = bitrate × streams × 1.1. 1 Mbps × 1시간 = 0.45 GB. 업로드 70%를 미디어 예산으로 보는 것은 다른 집 트래픽과 순간 burst를 위한 초기 가정이며, 통과 기준이나 성능 보장이 아닙니다.</p></div></details></section>

<section class="section" id="operations"><span class="number">10 / OPERATING THE SERVICE</span><h2>서버 장애와 화면 장애를 분리해서 봅니다</h2><div class="table-wrap"><table><thead><tr><th>상황</th><th>예상 영향</th><th>설계할 동작</th></tr></thead><tbody><tr><td>Control API 중단</td><td>목록·새 접속·권한 변경 전달 실패. 서버 관리 세션은 마지막 권한 갱신 후 120초 내 종료하는 초기 정책. 수동 offline 모드는 별도.</td><td>WSS backoff, 온라인 상태 재동기화. 서버 철회는 전달 전까지 즉시 적용할 수 없음. host 로컬 종료와 세션 만료는 독립 집행.</td></tr><tr><td>홈서버 relay 중단</td><td>그 relay를 쓰는 stream 중단. 직접 연결은 별도.</td><td>입력 release-all, 경로 재검사·재연결, epoch 교체·IDR 요청.</td></tr><tr><td>집 인터넷 / 정전</td><td>집 host와 control·home relay 모두 도달 불가.</td><td>VPS relay만 추가해도 집 host를 살릴 수는 없음. UPS·자동 기동·DNS 갱신·전원 복구를 별도 검토.</td></tr><tr><td>외부망이 UDP 차단</td><td>직접 QUIC·UDP relay·기본 WireGuard 모두 실패 가능.</td><td>필요하면 앱이 지원하는 TCP/TLS relay 어댑터를 후속 개발. TCP 443을 열기만 해서는 같은 UDP가 통과하지 않음. 지연 영향 측정.</td></tr><tr><td>집 PC 절전 / 로그인 전</td><td>host agent의 화면 캡처 불가 또는 offline.</td><td>Wake-on-LAN은 NIC/펌웨어/전원 상태 조건을 확인한 선택 기능. 로그인 전 화면은 service/session agent 구현과 별개 시험 필요.</td></tr><tr><td>호스트 GPU / Privacy 실패</td><td>네트워크가 정상이어도 영상이나 물리 화면 차단 실패.</td><td>host가 실제 상태를 확인해 알림·중단·복원. 서버의 “연결됨” 상태로 정상 처리하지 않음.</td></tr></tbody></table></div><div class="columns"><div class="note-block"><h3>운영 데이터</h3><p>DB·TLS 설정·서버 signing key는 일관된 백업과 복원 시험 대상입니다. 미디어 packet은 저장하지 않고 연결 성공률·직접/relay 비율·RTT·drop·큐·회선 사용량을 측정합니다.</p></div><div class="note-block"><h3>서버에 줄 권한</h3><p>API와 relay는 최소 권한의 별도 프로세스로 실행합니다. relay는 승인한 세션·endpoint로만 전달하고 allocation 만료·byte quota를 적용합니다. DB 관리 포트나 개인 PC 관리 포트를 함께 공개할 이유는 없습니다.</p></div></div></section>

<section class="section" id="start"><span class="number">11 / A PRACTICAL START</span><h2>당신의 환경에서는 이 순서가 맞습니다</h2><p><strong>추천 시작점:</strong> 홈서버에 단일 Control API를 두고, 집 host의 명시 UDP 경로 또는 개인 VPN으로 먼저 연결합니다. 자동 NAT 통과와 relay는 외부망 시험 결과를 보고 추가합니다. 현재 조건에서는 외부 VPS를 먼저 구매할 필요가 없습니다.</p><div id="launch-checks"><label class="task"><input type="checkbox" data-check="S01"><span><strong>S01 · 집 PC 두 대로 엔진 검증</strong>기존 F01–F25, F46/F47, F80–F82. 계정 없이 비밀번호 확인 후 화면·입력·소리·승인·종료를 LAN에서 검증.<small>네트워크 자동화를 먼저 만들어도 GPU/입력 문제가 해결되지는 않음.</small></span></label><label class="task"><input type="checkbox" data-check="S02"><span><strong>S02 · 홈서버의 장치 목록·인증·WSS</strong>F71–F78: 실행·DB·인증·온라인 상태·승인·초대·후보 교환·배포. F64/F65 UI와 연결.<small>PC 양쪽에서 직접 API에 연결해 “온라인 → 요청 → 승인 → 종료” 확인.</small></span></label><label class="task"><input type="checkbox" data-check="S03"><span><strong>S03 · 외부에서 집 PC 연결</strong>UDP 40010 직접 경로 또는 WireGuard VPN 중 하나를 검증. F10/F28/F31과 F79 통합 합격.<small>같은 Wi-Fi만으로 확인하지 말고 외부 회선에서 테스트. IP 변경·PC 재시작 포함.</small></span></label><label class="task"><input type="checkbox" data-check="S04"><span><strong>S04 · 여러 네트워크의 자동 연결</strong>외부 후보 관측·같은 socket 유지·후보 교환·hole punching·timeout·IPv4/IPv6. F32/F60.<small>두 PC가 모두 외부망에 있는 경우도 시험. STUN 설치만으로 완료 처리하지 않음.</small></span></label><label class="task"><input type="checkbox" data-check="S05"><span><strong>S05 · 직접 실패 시 relay</strong>자체 UDP relay 또는 coturn 통합을 선택. 내부 QUIC 암호화·MTU·allocation·재연결 검증. F33/F67/F68.<small>인증 없는 중계, 서버 평문, 무제한 큐를 허용하지 않는 계약을 시험.</small></span></label><label class="task"><input type="checkbox" data-check="S06"><span><strong>S06 · 일상 운영과 고급 기능</strong>자동 시작·업데이트 rollback·관측·백업 복원, Privacy/VDD와 권한·복구 UI. F30/F40/F48–F50/F69/F70.<small>필요하면 Wake-on-LAN과 UDP 차단망 fallback을 별도 개발 항목으로 확정.</small></span></label></div><p class="check-progress" id="check-progress">검토 표시 0 / 6 · 실제 개발 완료 상태와는 별도</p><p class="small">여기 체크는 이 설명의 검토 기록입니다. 현재 82개 기능 체크리스트의 선택·진행 상태는 바꾸지 않습니다.</p><p><a href="notparsec-plan.html#features">기존 개발 체크리스트 열기 ↗</a> · <a href="ARCHITECTURE.ko.md">영상 엔진 상세 아키텍처 ↗</a></p></section>

<section class="section" id="references"><span class="number">12 / SOURCES & ASSUMPTIONS</span><h2>공식 근거와 자체 설계의 경계</h2><p class="small">공식 자료 확인: 2026-09-20. 서버 배치·Rust API·포트 40000/40010·회선 여유율·개발 순서는 이 프로젝트의 제안입니다. Parsec의 전용 서버 코드를 복원했다거나 동등 성능을 검증했다는 의미가 아닙니다.</p><ul class="sources-list"><li><a href="https://support.parsec.app/hc/en-us/articles/32361410290324-Components-and-Connection-Sequence" target="_blank" rel="noopener">Parsec Components and Connection Sequence</a> — host/client·Signal API·STUN의 역할.</li><li><a href="https://support.parsec.app/hc/en-us/articles/32381460716180-Parsec-Connectivity-Requirements" target="_blank" rel="noopener">Parsec Connectivity Requirements</a> — backend TCP·STUN/peer UDP의 구분. 원본 포트를 자체 앱의 필수값으로 복사하지 않음.</li><li><a href="https://www.rfc-editor.org/rfc/rfc8489.html" target="_blank" rel="noopener">RFC 8489 STUN</a> · <a href="https://www.rfc-editor.org/rfc/rfc8656.html" target="_blank" rel="noopener">RFC 8656 TURN</a> — 주소 관측과 중계의 차이.</li><li><a href="https://www.rfc-editor.org/rfc/rfc9000.html" target="_blank" rel="noopener">RFC 9000 QUIC</a> · <a href="https://docs.rs/quinn/0.11.12/quinn/struct.Endpoint.html" target="_blank" rel="noopener">Quinn Endpoint</a> — UDP transport와 socket adapter.</li><li><a href="https://www.wireguard.com/quickstart/" target="_blank" rel="noopener">WireGuard Quick Start</a> — 별도 터널 경로. <a href="https://tailscale.com/docs/reference/connection-types" target="_blank" rel="noopener">Tailscale 연결 방식</a>은 direct/relay를 선택하는 mesh 방식의 비교 자료.</li><li><a href="https://github.com/coturn/coturn" target="_blank" rel="noopener">coturn</a> · <a href="https://nginx.org/en/docs/http/websocket.html" target="_blank" rel="noopener">Nginx HTTPS/WSS</a> · <a href="https://developers.cloudflare.com/dns/proxy-status/limitations/" target="_blank" rel="noopener">Cloudflare proxy 제한</a> — 선택한 구성의 조건은 배포 전 다시 확인.</li></ul></section>
<footer>notParsec · 개인 홈서버 운영 설명 · 비밀번호 인증 구현 착수 · 서버 배포 전<br>이 파일은 외부 스크립트·폰트 없이 동작합니다. 설명용 입력은 외부 서버로 전송되지 않습니다.</footer>
</main></div>
<noscript><p class="no-js">JavaScript가 꺼져 있어 경로 변경과 계산기는 동작하지 않습니다. 나머지 설명과 표는 읽을 수 있습니다.</p></noscript>
<script>__HOME_MODEL__</script>
<script>
(()=>{'use strict';const $=id=>document.getElementById(id),M=HomeArchitecture;let mode='direct';let lastDomain='example.com';
const values=()=>({mode,host:$('host-place').value,bitrate:+$('bitrate').value,upload:+$('upload').value,sessions:+$('sessions').value,hours:+$('hours').value});
const num=n=>n.toLocaleString('ko-KR',{maximumFractionDigits:1});
function update(){const v=values(),m=M.modes[mode],a=M.estimate(v),home=v.host==='home';document.querySelectorAll('[data-mode]').forEach(b=>b.setAttribute('aria-pressed',String(b.dataset.mode===mode)));$('host-tag').textContent=home?'HOST / HOME LAN':'HOST / ANOTHER NETWORK';$('host-title').textContent=home?'조작할 집 PC':'조작할 외부 PC';$('server-role').textContent=m.server;$('server-node').classList.toggle('selected',mode==='home'||mode==='vpn');
 const hostLabel=home?'집 PC':'외부 호스트';const nodes=['외부 노트북',...(mode==='direct'?[]:[mode==='home'?'홈서버 relay':mode==='vpn'?'홈서버 VPN':'외부 VPS relay']),hostLabel];$('media-route').replaceChildren();nodes.forEach((name,i)=>{if(i){const arrow=document.createElement('span');arrow.className='route-arrow';arrow.textContent='↔';arrow.setAttribute('aria-hidden','true');$('media-route').append(arrow)}const el=document.createElement('span');el.className='route-node';el.textContent=name;$('media-route').append(el)});
 $('route-caption').textContent=m.transport+' · '+(mode==='direct'?'홈서버는 미디어를 처리하지 않음':'영상 인코딩은 호스트 PC에서 수행');$('path-title').textContent=m.title;$('path-detail').textContent=m.detail;$('path-condition').textContent=mode==='direct'&&!home?'집 공유기의 포트포워딩으로 외부 호스트의 NAT가 열리지는 않습니다. 외부 호스트의 공개 endpoint, VPN 또는 NAT 통과에 성공한 직접 경로가 필요합니다.':mode==='vpn'&&!home?'외부 클라이언트와 외부 호스트 모두 홈서버 VPN에 가입하고, 양쪽 VPN 주소 사이의 route·AllowedIPs·방화벽을 구성합니다.':m.condition;
 $('path-context').textContent=mode==='direct'?(home?'현재 환경의 가장 단순한 앱 직접 경로: 집 공인 IP의 UDP 40010을 집 host PC로 전달하고, 홈서버는 접속할 주소와 승인만 주선합니다.':'외부 호스트는 별도 네트워크입니다. 두 PC 모두 집 밖에 있어도 direct에 성공하면 집 회선에는 연결 관리 트래픽만 남습니다.'):(mode==='home'?(home?'집 PC → 홈서버는 LAN, 홈서버 → 외부 노트북은 집 WAN 업로드입니다. 같은 LAN에서는 relay 내부 주소/route도 확인합니다.':'두 PC가 모두 집 밖이면 집 relay가 다운로드와 업로드를 모두 사용합니다. 집을 우회하는 경로가 빨라지는지는 실제 측정이 필요합니다.'):mode==='vpn'?'WireGuard 허브의 IP forwarding·장치 route·AllowedIPs·방화벽을 설정해야 합니다. 도메인 접속만으로 이 라우팅이 생기지는 않습니다.':'VPS가 데이터 경로만 맡는 구성입니다. 현재 홈서버는 기기 목록과 신규 접속의 단일 장애 지점으로 남습니다.');
 $('active-ports').textContent='지금 선택한 경로: '+(mode==='direct'&&!home?'TCP 443 → 홈서버 연결 관리 · 미디어 UDP는 외부 호스트가 속한 네트워크의 접속 조건에 따름':m.ports);
 ['bitrate','upload','sessions','hours'].forEach(id=>$(id+'-out').textContent=num(v[id])+({bitrate:' Mbps',upload:' Mbps',sessions:'개',hours:'시간'}[id]));$('home-up').textContent=num(a.homeUp)+' Mbps';$('home-down').textContent=num(a.homeDown)+' Mbps';$('home-gb').textContent=num(a.homeGB)+' GB';$('upload-ratio').textContent='업로드의 '+num(a.ratio*100)+'%';$('upload-meter').setAttribute('aria-valuenow',String(Math.min(100,a.ratio*100)));$('upload-meter').setAttribute('aria-valuetext',num(a.ratio*100)+'% · 추정 미디어 사용량');$('upload-fill').style.width=Math.min(100,a.ratio*100)+'%';$('upload-meter').classList.toggle('high',a.overBudget);
 $('capacity-answer').textContent=a.homeUp===0?'이 경로에서는 집 WAN에 큰 미디어 트래픽이 없습니다. 외부 호스트의 업로드와 client 다운로드는 여전히 필요합니다.':a.overBudget?'추정 업로드 '+num(a.homeUp)+' Mbps가 여유를 둔 예산 '+num(a.budget)+' Mbps를 넘습니다. 평균 bitrate·스트림 수를 낮추고 실제 지연/손실을 확인하세요.':'추정 업로드 '+num(a.homeUp)+' Mbps는 초기 예산 '+num(a.budget)+' Mbps 안입니다. 이는 회선 계산이며 실제 저지연 성능을 보장하지 않습니다.';
 $('capacity-topology').textContent=(mode==='vps'?'VPS 미디어 수신+송신 합 '+num(a.relayInOut)+' Mbps · 일일 VPS 송신 약 '+num(a.vpsGB)+' GB. 과금 방향은 업체 정책에 따라 다름.':mode==='home'?'relay NIC의 미디어 수신+송신 합 '+num(a.relayInOut)+' Mbps. LAN 구간을 집 WAN 사용량과 혼동하지 않습니다.':mode==='vpn'?'VPN 허브 경유를 가정한 계산입니다. mesh VPN에서 P2P로 전환하면 경로와 사용량이 달라집니다.':'직접 경로: 집 host라면 집 WAN 업로드를 사용하지만 홈서버의 relay 대역폭은 사용하지 않습니다.')+' 모든 0 표시는 미디어만 기준이며 API/heartbeat 트래픽은 제외했습니다.';
}
document.querySelectorAll('[data-mode]').forEach(b=>b.addEventListener('click',()=>{mode=b.dataset.mode;update()}));['host-place','bitrate','upload','sessions','hours'].forEach(id=>$(id).addEventListener(id==='host-place'?'change':'input',update));
function domainChanged(){const d=M.hostname($('domain').value);$('domain-error').textContent=d?'':'https://·경로·포트를 빼고 example.com 형식의 도메인을 입력하세요.';$('domain').setAttribute('aria-invalid',String(!d));$('copy-config').disabled=!d;if(!d)return;lastDomain=d;document.querySelectorAll('[data-domain-prefix]').forEach(el=>el.textContent=el.dataset.domainPrefix+'.'+d);$('nginx-example').textContent='# '+d+' 기존 HTTPS server block 내부\nlocation ^~ /v1/ {\n    proxy_pass http://127.0.0.1:18080;\n}';}
$('domain').addEventListener('input',domainChanged);
$('copy-config').addEventListener('click',async()=>{const v=values(),a=M.estimate(v);const t=['notParsec 홈서버 운영 제안','확인된 조건: 공인 IP + UDP 포트포워딩 가능','도메인 예시: '+lastDomain,'선택 경로: '+M.modes[mode].title,'호스트 위치: '+(v.host==='home'?'집 LAN':'외부망'),$('active-ports').textContent,'집 WAN 미디어 추정: 업로드 '+num(a.homeUp)+' Mbps / 다운로드 '+num(a.homeDown)+' Mbps','구현 순서: LAN 엔진 → Control API/WSS → 직접 또는 VPN → NAT 통과 → relay','근거: design/homeserver-architecture.html','포트·주소는 제안이며 실제 서버 배포/설정 변경은 아직 하지 않았음'].join('\n');try{await navigator.clipboard.writeText(t);$('copy-status').textContent='현재 조건과 구성 요약을 복사했습니다.'}catch{$('copy-status').textContent='자동 복사가 허용되지 않았습니다. 화면의 도메인·포트 표를 직접 복사하세요.'}});
const key='notparsec-home-architecture-review-v1';let saved=[];try{const x=JSON.parse(localStorage.getItem(key)||'[]');if(Array.isArray(x))saved=x}catch{}document.querySelectorAll('[data-check]').forEach(c=>{c.checked=saved.includes(c.dataset.check);c.addEventListener('change',()=>{const picked=[...document.querySelectorAll('[data-check]:checked')].map(e=>e.dataset.check);try{localStorage.setItem(key,JSON.stringify(picked))}catch{}review()})});function review(){$('check-progress').textContent='검토 표시 '+document.querySelectorAll('[data-check]:checked').length+' / 6 · 실제 개발 완료 상태와는 별도'}
update();domainChanged();review();
})();
</script>
</body></html>