notParsec / 문서전체 문서

생성 코드·템플릿

run-guide.fragment.html

design/run-guide.fragment.html

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

<section id="run-guide">
<div class="section-head"><h2>코드 경로 · 통합 EXE · 실행 방법</h2><a href="../IMPLEMENTATION.md">상세 실행 문서 ↗</a></div>
<p><strong>모든 Windows PC는 같은 notparsec.exe를 사용합니다.</strong> 같은 앱에서 다른 PC 연결과 이 PC 호스팅을 제공합니다. Ubuntu 연결 관리 서버는 별도입니다. 현재 PC 간 시험은 비밀번호 인증까지이며 영상·오디오·입력은 미완료입니다.</p>
<div class="run-table"><table><thead><tr><th>실행 위치</th><th>코드</th><th>실행 파일</th></tr></thead><tbody>
<tr><td>양쪽 Windows PC · 동일 앱</td><td><code>apps/desktop/</code> → <code>crates/desktop-ui/</code> → <code>crates/session/</code></td><td><a href="../dist/windows-unified-x64/app/notparsec.exe" download>notparsec.exe</a> · 연결/호스팅 공용</td></tr>
<tr><td>Ubuntu 24.04.4 x86_64 홈서버</td><td><code>apps/control-server/</code>, <code>deploy/ubuntu/</code></td><td><code>notparsec-control-server</code> · 기존 Nginx/n3m.kr</td></tr>
<tr><td>공통 코드 · 앱 내부</td><td><code>crates/access</code>, <code>wire</code>, <code>device-client</code>, <code>platform-win</code></td><td>별도 실행 불필요</td></tr>
<tr><td>과거 CLI 회귀 시험</td><td><code>apps/host</code>, <code>apps/client</code></td><td>새 사용자 배포에서 제외. 소스 호환 래퍼만 보존</td></tr>
</tbody></table></div>
<div class="callout">단일 사용자 EXE와 설정·키 파일은 별개입니다. Rust/Cargo 없이 EXE만 복사해 실행하는 시험을 통과했습니다. GPU/OS DLL은 필요하며 향후 가상 장치 드라이버·서비스는 별도 구현과 검증 대상입니다. 구버전 <code>dist/windows-x64</code>는 기록 보존용이며 새 빌드에 포함하지 않습니다.</div>
<details class="run-step" open><summary>1. Windows 빌드와 결과</summary><div class="run-content">
<pre><code>powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build-windows.ps1
python scripts/smoke_desktop.py --binary dist/windows-unified-x64/app/notparsec.exe
python scripts/inspect_artifacts.py windows</code></pre>
<pre><code>dist/windows-unified-x64/
  app/notparsec.exe                 # 양쪽 PC에서 사용하는 동일 파일
  tools/diagnostics/                # 선택 개발 도구
  tools/control-server-dev/         # Windows 서버 시험 도구 (Ubuntu용 아님)
  manifest.json                    # 크기·SHA-256

dist/linux-x64/control-server/notparsec-control-server</code></pre>
<p>빌드 환경은 Rust 1.93.1, MSVC C++ Build Tools, Windows SDK입니다. <a href="../dist/windows-unified-x64/manifest.json">파일 manifest</a> · <a href="evidence/unified-app-smoke.json">단독 EXE 양방향 인증 결과</a> · <a href="UNIFIED_APP_PARITY.ko.md">원본 대응과 남은 차이</a>.</p>
</div></details>
<details class="run-step" open><summary>2. GUI에서 사용</summary><div class="run-content">
<ol><li>각 Windows PC에 같은 <code>notparsec.exe</code>를 복사하고 실행합니다.</li><li>호스팅할 PC: 설정 → Host에서 비밀번호 초기화 → 공개 인증서 내보내기 → 호스트 시작.</li><li>접속할 PC: Computers → 직접 연결 (인증 시험)에서 대상 IP:포트와 공개 인증서 지정 → 인증서 확인 → 대상 PC 비밀번호 입력.</li><li>역할을 바꾸려면 같은 앱의 Host 설정과 Computers를 사용합니다. 다른 실행 파일이 필요하지 않습니다.</li></ol>
<p>현재 수동 IP/인증서 교환은 개발 인증 경로입니다. Parsec의 최종 Connect 흐름으로 확정하지 않습니다. 실제 미디어·자동 NAT·원클릭 연결은 남아 있습니다. 창을 닫으면 호스팅 대기도 종료됩니다.</p>
</div></details>
<details class="run-step"><summary>3. CLI로 인증 재현</summary><div class="run-content">
<pre><code># 같은 notparsec.exe · 터미널 A (최초 한 번 init)
.\notparsec.exe host init --directory .\data
.\notparsec.exe host serve --directory .\data --listen 127.0.0.1:40010

# 터미널 B · 매번 숨김 프롬프트에서 대상 PC 비밀번호 입력
.\notparsec.exe connect --host 127.0.0.1:40010 --certificate .\data\host-cert.der

# 비밀번호 변경 / 공개 인증서 내보내기
.\notparsec.exe host set-password --directory .\data
.\notparsec.exe host export-certificate --directory .\data --output .\host-public.der</code></pre>
<p>성공 응답 <code>PASSWORD_ACCEPTED; media pipeline is not implemented yet</code>는 인증 성공입니다. <code>ACCESS_DENIED</code>는 비밀번호 거부, <code>RETRY_LATER</code>는 시도 제한입니다. 호스트 종료는 Ctrl+C입니다. LAN 시험은 실제 IP와 필요한 수신 UDP 방화벽 설정, 신뢰 경로로 전달한 공개 인증서의 SHA-256 확인이 필요합니다. 현재 실제 두 PC는 미검증입니다.</p>
</div></details>
<details class="run-step"><summary>4. 기존 설정·키 이전</summary><div class="run-content">
<p>기본 프로필은 <code>%LOCALAPPDATA%\notParsec\desktop</code>입니다. 이 폴더가 없으면 이전 <code>host</code>/<code>client</code>를 검사합니다. 기기 키·호스팅 자격 증명·공통 설정 충돌 시 화면에서 사용할 원본을 선택합니다. 이전 중에는 새 키를 만들지 않습니다. 원본 폴더와 선택하지 않은 키는 보존하고 서버 기기를 자동 폐기하지 않습니다.</p>
<p><code>gui --data-dir PATH</code>는 지정한 프로필을 양쪽 역할에 사용합니다. 자동 이전을 생략합니다. CLI 이전은 <a href="../IMPLEMENTATION.md">상세 안내</a>를 따릅니다. 다른 PC로 DPAPI 비밀 파일을 복사하지 않습니다.</p>
</div></details>
<details class="run-step"><summary>5. Ubuntu 연결 관리 서버</summary><div class="run-content">
<pre><code># Ubuntu checkout에서만 실행
CARGO_BUILD_JOBS=2 bash scripts/build-ubuntu.sh
systemctl status notparsec-control --no-pager
curl --fail https://n3m.kr/health/ready</code></pre>
<p>기존 Ubuntu/Nginx 배포는 유지합니다. 이번 Windows 교정에서 운영 서버를 변경하지 않았습니다. 서버 설치·등록·백업·복원은 <a href="../deploy/ubuntu/README.ko.md">운영 절차</a>, 기존 검증은 <a href="UBUNTU_OPERATIONS.ko.md">Ubuntu 기록</a>를 따릅니다. Windows WSS/세션/ticket/lease와 미디어 통합은 남았습니다.</p>
</div></details>
</section>