코드 경로 · 통합 EXE · 실행 방법

상세 실행 문서 ↗

모든 Windows PC는 같은 notparsec.exe를 사용합니다. 같은 앱에서 다른 PC 연결과 이 PC 호스팅을 제공합니다. Ubuntu 연결 관리 서버는 별도입니다. 현재 PC 간 시험은 비밀번호 인증까지이며 영상·오디오·입력은 미완료입니다.

실행 위치코드실행 파일
양쪽 Windows PC · 동일 앱apps/desktop/ → crates/desktop-ui/ → crates/session/notparsec.exe · 연결/호스팅 공용
Ubuntu 24.04.4 x86_64 홈서버apps/control-server/, deploy/ubuntu/notparsec-control-server · 기존 Nginx/n3m.kr
공통 코드 · 앱 내부crates/access, wire, device-client, platform-win별도 실행 불필요
과거 CLI 회귀 시험apps/host, apps/client새 사용자 배포에서 제외. 소스 호환 래퍼만 보존
단일 사용자 EXE와 설정·키 파일은 별개입니다. Rust/Cargo 없이 EXE만 복사해 실행하는 시험을 통과했습니다. GPU/OS DLL은 필요하며 향후 가상 장치 드라이버·서비스는 별도 구현과 검증 대상입니다. 구버전 dist/windows-x64는 기록 보존용이며 새 빌드에 포함하지 않습니다.
1. Windows 빌드와 결과
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
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

빌드 환경은 Rust 1.93.1, MSVC C++ Build Tools, Windows SDK입니다. 파일 manifest · 단독 EXE 양방향 인증 결과 · 원본 대응과 남은 차이.

2. GUI에서 사용
  1. 각 Windows PC에 같은 notparsec.exe를 복사하고 실행합니다.
  2. 호스팅할 PC: 설정 → Host에서 비밀번호 초기화 → 공개 인증서 내보내기 → 호스트 시작.
  3. 접속할 PC: Computers → 직접 연결 (인증 시험)에서 대상 IP:포트와 공개 인증서 지정 → 인증서 확인 → 대상 PC 비밀번호 입력.
  4. 역할을 바꾸려면 같은 앱의 Host 설정과 Computers를 사용합니다. 다른 실행 파일이 필요하지 않습니다.

현재 수동 IP/인증서 교환은 개발 인증 경로입니다. Parsec의 최종 Connect 흐름으로 확정하지 않습니다. 실제 미디어·자동 NAT·원클릭 연결은 남아 있습니다. 창을 닫으면 호스팅 대기도 종료됩니다.

3. CLI로 인증 재현
# 같은 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

성공 응답 PASSWORD_ACCEPTED; media pipeline is not implemented yet는 인증 성공입니다. ACCESS_DENIED는 비밀번호 거부, RETRY_LATER는 시도 제한입니다. 호스트 종료는 Ctrl+C입니다. LAN 시험은 실제 IP와 필요한 수신 UDP 방화벽 설정, 신뢰 경로로 전달한 공개 인증서의 SHA-256 확인이 필요합니다. 현재 실제 두 PC는 미검증입니다.

4. 기존 설정·키 이전

기본 프로필은 %LOCALAPPDATA%\notParsec\desktop입니다. 이 폴더가 없으면 이전 host/client를 검사합니다. 기기 키·호스팅 자격 증명·공통 설정 충돌 시 화면에서 사용할 원본을 선택합니다. 이전 중에는 새 키를 만들지 않습니다. 원본 폴더와 선택하지 않은 키는 보존하고 서버 기기를 자동 폐기하지 않습니다.

gui --data-dir PATH는 지정한 프로필을 양쪽 역할에 사용합니다. 자동 이전을 생략합니다. CLI 이전은 상세 안내를 따릅니다. 다른 PC로 DPAPI 비밀 파일을 복사하지 않습니다.

5. Ubuntu 연결 관리 서버
# Ubuntu checkout에서만 실행
CARGO_BUILD_JOBS=2 bash scripts/build-ubuntu.sh
systemctl status notparsec-control --no-pager
curl --fail https://n3m.kr/health/ready

기존 Ubuntu/Nginx 배포는 유지합니다. 이번 Windows 교정에서 운영 서버를 변경하지 않았습니다. 서버 설치·등록·백업·복원은 운영 절차, 기존 검증은 Ubuntu 기록를 따릅니다. Windows WSS/세션/ticket/lease와 미디어 통합은 남았습니다.