notParsec / 문서전체 문서

설명·설계 문서

통합 Windows 앱과 원격 화면·입력

design/UNIFIED_REMOTE.ko.md

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

이 문서의 목차

후속 소스 변경: GPU H.264/H.265·자동 업데이트. 아래 JPEG 설명은 이전 배포 이력입니다. 새 앱은 양쪽 교체가 필요하며 실제 GPU 성능·Windows 교체는 미검증입니다.

양쪽 PC에서 **동일한 notparsec.exe**를 사용한다. 관리자 웹의 Windows 다운로드도 이 파일 하나만 제공한다. 이전 host/client 실행 파일은 기존 인증 CLI 호환용 소스로 남으며 새 배포에는 포함하지 않는다.

후속 구현: F15 영상 오류 복구. GPU 오류 후 decoder 재생성·키 프레임 대기와 피드백을 연결했으며, 실제 Windows GPU 및 UDP 손실 복구는 미검증이다.

사용 순서

  1. 서버를 새 버전으로 갱신하고 관리자 웹에서 notparsec.exe를 받는다.
  2. 양쪽 PC에서 기존 앱을 종료하고 새 앱을 실행한다. 기존 기본 경로에 등록 정보가 있으면 통합 프로필로 복사하므로 같은 기기 ID와 승인을 유지한다. 신규 PC는 내 기기 → 기기 등록 요청 후 관리자가 한 번 승인한다.
  3. 접속받을 PC에서 이 PC 접속 허용을 열고 접속 비밀번호를 설정한 다음 이 PC 접속 허용 켜기를 누른다. 앱을 열어 둔다.
  4. 접속할 PC의 내 기기에서 상대 PC의 연결을 누르고 접속 비밀번호를 입력한다. 기기 목록 갱신은 최대 약 10초 걸린다.
  5. 원격 화면을 클릭하면 키보드·마우스 입력을 전달한다. Esc는 입력 전달을 해제한다. 연결 종료 또는 상대 PC의 접속 허용 끄기 · 연결 종료로 끝낸다.

인증서 파일 복사, 직접 IP 입력, 공유기 포트포워딩은 필요 없다. 두 PC 모두 서버의 HTTPS/WSS TCP 443으로 나가는 연결을 사용한다. 방화벽/프록시에서 해당 도메인의 WebSocket 연결을 허용해야 한다. 항상 서버를 경유하며 직접 UDP/STUN 경로는 이번 통합 앱에서 사용하지 않는다.

구현과 보안 경계

현재 화면·입력 범위

Windows GDI로 주 모니터를 캡처하고 JPEG quality 65, 최대 1280×720·10fps로 전송한다. 통합 앱의 egui 창에 표시하며 Windows SendInput으로 마우스 이동/좌우·가운데 버튼/휠, 일반 키와 텍스트 입력을 전달한다. 화면 해상도가 바뀌면 연결을 끝내고 재연결을 요구한다.

오디오, GPU H.264 인코딩, 고주사율, 다중 모니터 선택, 파일 전송, 백그라운드 Windows 서비스, 로그인·UAC 보안 데스크톱은 포함하지 않는다. 관리자 권한 앱의 입력은 Windows UIPI 제한을 받는다. Microsoft SendInput 설명.

기존 기기 정보

기본 통합 프로필은 %LOCALAPPDATA%\notParsec\desktop이다. 처음 실행할 때 해당 폴더가 없으면 기존 host/client 중 기기 키 파일이 가장 최근에 수정된 프로필의 device.secret, host.secret, host-cert.der, ui.json을 임시 폴더에 복사하고 원자적으로 옮긴다. 두 기존 프로필과 키는 삭제하지 않는다. 이미 통합 프로필이 있으면 덮어쓰거나 합치지 않는다. 사용자 지정 경로는 notparsec.exe --data-dir 경로로 지정한다. 어느 경로에서 가져왔는지는 imported-from.txt에 기록한다.

검증

crates/session/tests/remote_relay.rs는 격리 서버와 실제 기기 키·TLS 연결로 비밀번호 전 캡처 차단, 제3 기기 중계 차단, JPEG 프레임 수신/디코딩, 입력 전달, 기기 폐기 시 연결 종료와 키 해제를 검사한다. 캡처/입력 장치는 테스트 구현을 사용하므로 Windows GDI·SendInput의 실제 실행 증거는 아니다.

scripts/smoke_https.py는 임시 Nginx·검증 가능한 인증서로 실제 중계 URL의 WSS 업그레이드와 양방향 바이너리 전달, 접속 허용 해제 시 종료를 확인한다. Windows MSVC 교차 빌드/정적 분석과 실제 Windows 두 PC 실행은 구별해 보고한다.

2026-09-23 검증: Linux workspace 33개 테스트, Linux 및 Windows target Clippy -D warnings, fmt, Windows MSVC release 빌드와 PE 의존성 검사, Ubuntu native release와 격리 Nginx TLS/WSS 중계, 원자적 다운로드 설치 테스트, 릴리스 도구 8개 테스트가 통과했다. Chromium에서 통합 EXE 하나만 표시되고 다운로드 원본 SHA-256과 일치하는 것도 확인했다. 실제 Windows GDI 캡처·SendInput·DPAPI와 서로 다른 두 실제 네트워크에서의 실행은 이 Ubuntu 환경에서 수행하지 않았다.

최종 native release로 Chromium 관리자 화면·통합 EXE 다운로드를 다시 확인했다. 릴리스 압축 파일과 같은 디렉터리 구조에서도 서버 준비 상태·정상 종료 및 동봉한 통합 EXE의 다운로드 설치를 확인했다.

운영 반영 상태

2026-09-23 18:47 UTC 재확인: 서비스가 18:39:31 UTC에 시작됐으며 운영 서버와 다운로드 EXE의 SHA-256이 아래 준비 파일과 일치한다. 공개 준비 상태는 200, 토큰 없는 /v1/remote/hosts는 401이다. 아래 설치 실패 기록 이후 운영 반영이 이루어졌다. 현재 끊김·화질 문제의 코드 분석은 현재 구조 HTML에 정리했다. 두 Windows PC의 실행 버전과 실제 FPS는 이번 확인에 포함하지 않는다.

2026-09-23 18:34 UTC 기준 기존 서버는 실행 중이며 공개 HTTPS 및 로컬 준비 상태가 200이다. 운영 실행 파일은 이전 버전으로 /v1/remote/hosts가 아직 404를 반환한다. 이번 설치 시도는 sudo: a password is required로 시작 전에 중단되어 운영 서버를 바꾸지 않았다.

준비된 서버와 통합 다운로드를 함께 반영하려면 서버 터미널에서 다음 명령을 실행한다. 기존 승인 정보와 관리자 비밀번호는 유지한다. 도메인은 이미 설정되어 있어 다시 구성하지 않는다.

sudo bash /home/ahn/notparsec/deploy/ubuntu/install.sh

통합 EXE: dist/unified-preview/notparsec.exe (SHA-256 bc838c5d09e3cd6e77252696c0fef1e07b239303edebf30cf7621ddc5db33608). 준비한 서버 SHA-256: 4305622d194fab703e0961b6de28b11696b02167050a19697bbe78ff9b4a7d47.

2026-09-23 main 병합 보완

통합 화면·입력 경로와 관리자 승인 기능은 유지하며 main의 공유 프로필 검증·충돌 선택 및 host, connect, migrate-profile CLI를 통합했다. 이전 프로필을 수정 시각만으로 선택하지 않는다. 키·호스팅 자격·설정이 다르면 원본 선택을 요구하고 모든 원본을 보존한다. --data-dir 경로와 gui --data-dir 경로를 모두 지원한다. 설정 → Host의 직접 인증 시험과 이 PC 접속 허용의 WSS 화면 전송은 별도 경로다. 기존 성능 및 원본 대조의 미검증 범위는 그대로다.

병합 검증: Linux workspace Rust 시험 35개, Linux 및 Windows MSVC 대상 workspace/all-targets Clippy, HTML·프롬프트 시험 43개, 릴리스 도구 9개와 문서 게시·복원 6개 시험이 통과했다. 동일 EXE CLI의 양방향 인증·프로필 이전, 기기 승인·목록·만료·폐기, 격리 Nginx HTTPS/WSS 양방향 중계와 통합 앱 다운로드도 통과했다. DB 운영 시험은 2개 통과·이전 schema 실행 파일 없는 1개 생략이다. Windows 대상은 교차 컴파일 검사이며 Windows GUI 실행·실제 두 PC 성능 시험 결과가 아니다. 문서 허브는 812개 경로와 검색·모바일·기존 체크리스트를 격리 Nginx/Chromium에서 확인했다.