notParsec / 문서전체 문서

설명·설계 문서

구현·설계 도구 검증 기록

design/VERIFICATION.md

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

이 문서의 목차

v0.1.0-ci.2 태그 준비 · 원격 CI 병합 · 2026-09-21

progress-7 · 동일 Windows 앱·공유 프로필 · 2026-09-21

progress-6 · Parsec 원본 재현 기준 보완 · 2026-09-21

확인일: 2026-09-20. v5부터 Rust 인증 CLI와 서버 기반의 실제 실행 검사를 포함한다. 영상 성능이나 두 물리 PC의 원격 접속을 검증한 결과는 아니다.

progress-6 · 자체 GitLab 자동 빌드·태그 Release (최신)

Ubuntu 24.04.4/N100의 전용 비권한 계정과 프로젝트 전용 protected Runner 1을 등록했다. 실제 main 파이프라인 15와 16은 verify만 수행해 성공했고 Release를 생성하지 않았다. 최초 환경 실패는 Ubuntu logout profile, rustup proxy 및 버전 문자열 검사로 확인해 수정했다.

미사용 v0.1.0-ci.1 태그의 파이프라인 17이 verify 81 → build_release 82 → publish_release 83을 모두 성공했다. 실제 빌드 commit은 3e610325e8259d1fa8b785311f35efd5cb469d4f, Cargo 버전은 0.1.0이다. 태그·HEAD·CI_COMMIT_SHA 및 게시 전후 원격 태그 commit을 확인했다. 기존 태그를 이동하거나 정식 버전을 올리지 않았다.

fmt/clippy -D warnings/workspace Rust 23개, HTML 29개, 게시 도구 8개, QUIC 인증·기기 CLI·31초 presence 만료와 Linux SIGTERM exit 0, SQLite 운영 2개 및 격리 HTTPS/WSS를 통과했다. CI에 이전 schema 2 실행 파일을 제공하지 않아 해당 시험 1개는 명시적으로 skip했다. Windows subprocess.terminate는 TerminateProcess exit 1로 구분하도록 수정했으며 Linux 정상 종료 기준은 유지했다.

Windows host/client는 Ubuntu에서 Rust 1.93.1/cargo-xwin 0.23.0/LLVM 18.1.3, 고정 SDK/CRT로 x86_64-pc-windows-msvc release를 실제 빌드했다. 두 EXE 모두 11,841,536 bytes, PE32+ AMD64이며 normal/delay import 검사에서 별도 C 런타임·SQLite DLL이 없었다. 기존 console subsystem과 정적 C 런타임을 유지한다. 실행에는 Windows OS 구성 요소·GPU 드라이버·글꼴이 필요하다. 이 산출물의 실제 Windows GUI·GPU·DPAPI·두 PC 및 Wine 실행은 미검증이다.

고정 Microsoft catalogue와 버전 selector를 사용하는 prepare_xwin.py를 별도 빈 캐시에서도 실행했다. 18:03 UTC 다운로드·추출이 성공했고 crt/sdk 전체 파일·symlink digest가 lock과 일치했다. 다른 새 OS/서버에 전체 환경을 설치한 검증으로 확대하지 않는다.

Ubuntu는 기존 빌드 스크립트로 native release를 만들고, 실제 게시할 실행 파일 및 압축 해제한 실행 파일로 임시 DB/서명 키·임시 포트에서 readiness 200/미인증 401/SIGTERM 0을 확인했다. release HTTPS/WSS도 통과했다. Ubuntu 패키지는 설치기가 기대하는 dist/deploy 상대 경로와 명시적인 운영 파일 목록을 포함하며 설치기 구문과 경로를 검사했다. 운영 서버에 설치기를 실행하지 않았다.

실제 Release에 Windows EXE 2개·Ubuntu 패키지·SHA256SUMS·manifest·실행 안내·의존성 notice 등 다운로드 7개를 게시했다. CI_JOB_TOKEN으로 Generic Package Registry에 올리고 전부 다시 다운로드해 hash/크기를 비교한 후 Release를 생성했다. 독립 다운로드도 모두 SHA-256 일치했다. publish 재시도 84는 7개 파일을 전부 재사용했고 새 업로드 없이 성공했다. 최종 package 1개/파일 7개/Release 1개이며 다른 내용 덮어쓰기·부분 실패 복구는 게시 도구 회귀 시험에서도 확인했다.

프로젝트와 Package Registry는 private다. 비로그인 Release 페이지는 로그인으로 302, 패키지 다운로드는 401, 프로젝트 API는 404였다. Runner는 동시 job 1, Cargo 2개, 전용 사용자 slice CPU 200%/메모리 6GiB로 제한했다. 실제 job에서 운영 DB·키·인증서·GitLab 데이터·Runner 인증 설정 및 /home/ahn 접근 차단을 확인했다. 기존 nginx/GitLab/notParsec/workspace/monitor의 PID·시작 시각·active 상태는 모두 유지됐고 공개 readiness 200/미인증 401도 유지됐다. Cloudflare 설정 변경과 운영 자동 배포는 없다.

상세 실행 근거는 GitLab CI 결과, 버전·라이선스·재등록·부팅/재시작·실행 명령은 Runner/Release 운영 안내를 따른다. 전체 기능 완료 판정과 실제 Windows 실행 검증으로 확대하지 않는다.

progress-5 · 실제 Ubuntu 배포·운영 검증 (이전 기록)

root 실행 권한과 깨끗한 main=acb9277/origin 일치를 확인하고, 준비된 native release를 /opt/notparsec에 설치했다. 전용 사용자·systemd·Nginx·백업 timer를 적용했고 공개 https://n3m.kr health 200·미인증 기기 조회 401을 확인했다. Cloudflare DNS/보안 설정은 변경하지 않았다.

별도 runtime 상태로 공개 HTTPS 등록·인증·challenge 재사용 거부, 세션 승인·ticket 서명/단일 소비/비밀번호 gate, WSS upgrade·재연결·철회·폐기, 재시작/token 무효화 및 실제 Linux Rust CLI 등록·heartbeat·목록 조회를 통과했다. 검증 상태를 제거하고 운영 키/DB를 보존했다. Python 기본 User-Agent의 Cloudflare 403/error 1010은 앱 식별자를 명시한 요청에서 해소됐으며 Rust 공통 HTTP 클라이언트도 앱/버전을 명시한다. 기존 Windows EXE는 이번에 재빌드하지 않았다.

운영 pre-update backup·같은 release/schema 3 rollback·DB integrity·서명 키 보존, SIGKILL 자동 복구, 백업 service 실행, 로그 회전, Nginx burst 429/과대 body 413을 확인했다. 실제 schema 2 binary를 포함한 격리 운영 시험 3개, Rust workspace 23개와 fmt/clippy, 최신 헤더의 격리 TLS/WSS와 기기 CLI smoke도 통과했다. 기존 nginx/GitLab/workspace/monitor의 PID·active 상태와 사이트 응답을 비교했다.

기존 n3m.kr 인증서의 4개 SAN 모두 Certbot 갱신 dry-run에 성공했다. 상세 결과·검증 범위는 Ubuntu 운영 검증 및 배포 근거를 따른다. 실제 Windows 두 PC·별도 외부 회선·영상/소리/입력, 실제 재부팅·DB 장애 주입·장시간 proxy timeout·외부 백업은 남았다. 운영 성공을 전체 기능 완료로 처리하지 않아 진행 30개·검증 대기 1개·미착수 51개·전체 완료 0개를 유지한다. 진행 기록과 HTML을 갱신하고 Node 자동 검사 29개를 통과했다. 사용자 선택/수동 상태는 덮어쓰지 않았다. 이번 Ubuntu 작업의 브라우저 수동 UI 검사는 수행하지 않았다.

progress-4 · Ubuntu 연결 관리 구현 (이전 기록)

Ubuntu 24.04.4/N100에서 Rust 1.93.1 native fmt/clippy/test/build --locked, 서버 release, QUIC·장치 CLI smoke를 통과했다. Linux workspace 23개, 운영 backup/restore/실행 파일 rollback 3개 시험이 통과했다. 새 서버 단위/통합 시험 11개에는 WSS generation/queue overflow/재연결/폐기, 승인·취소 경합, ticket 단일 소비·대상·만료·키 증명, grant 철회·ACK·lease, 후보 상한이 포함된다.

실제 release 프로세스+격리 Nginx에서 인증서 검증을 켠 TLS/WSS, 원본 URI, body/rate 상한, 비밀 없는 access log와 재시작을 확인했다. 임시 DB로 실제 31초 presence 만료와 SIGTERM exit 0을 확인했다. 시작 commit의 schema 2 실행 파일을 별도로 빌드해 schema 3 거부→이전 DB/binary 복원→health 200을 확인했다.

운영 systemd·Nginx 적용은 sudo 권한 대기다. 공개 n3m.kr은 인증서가 유효하나 API 경로가 아직 404다. 실제 Windows 장치·외부 회선·영상/음성/입력은 미검증/미구현이다. 단위 시험의 media_started는 mock 보고다. 기존 사용자 기능 선택·진행 기록은 변경하지 않았다. 자세한 명령·환경·미검증 항목은 Ubuntu 운영 검증을 따른다.

HTML 원본 fragment/template와 실제 구현 ledger를 갱신하고 생성기를 실행했다. 기존 기능 선택·수동 기록 보존을 포함한 Node 자동 검사 29개 통과. ledger는 진행 30개·검증 대기 1개·미착수 51개·전체 완료 0개다. 브라우저 수동 UI 확인은 이번 Ubuntu 작업에서 하지 않았다. 의존성 provenance는 467개 package·728개 notice이며 기존 Windows 의존성 버전은 유지했다.

progress-3 · Windows GUI (이전 기록)

progress-2 · 전체 범위 착수 결과 (이전 기록)

아래는 progress-1 및 이전 버전의 검증 이력이다. 당시 숫자·미구현 설명은 최신 상태와 다를 수 있다.

전체 개발 진행 현황 보강

v5 계정 없는 비밀번호 접속 · Rust 구현 착수

역할 분리·단일 EXE release 확인 (추가)

현재 82개 기능, 기본 30개. F80(호스트 비밀번호), F81(연결별 인증), F82(계정 없는 UI)를 추가했다. 접속 대상 PC에 비밀번호를 설정하고 접속하는 앱에서 매 연결마다 입력하는 해석을 적용했다. Ubuntu를 연결 관리 서버 대상으로 정했다.

Ubuntu systemd/Caddy 예시와 Windows/Ubuntu 24.04 CI 정의를 작성했다. 이 PC에는 WSL 배포판이 없으며 Ubuntu 빌드·실행, systemd 운영, GitHub CI 실행은 미검증이다. 화면·소리·입력·GUI·장치 등록/목록/WSS는 아직 구현 전이다. 현재 성공 메시지는 비밀번호 인증 결과이며 원격 화면 연결 성공이 아니다. 구현 및 명령은 IMPLEMENTATION.md에 있다.

아래 v4/v3/v2/v1 기록은 각 버전 당시의 이력이다.

v4 연결 관리 서버·용어 설명 보강 검증

현재 79개 기능, 기본 27개, 서버 기능 F71–F79 9개. 기존 설정 163개와 UI 흐름 39개를 유지한다. node --test design/plan.test.cjs design/homeserver.test.cjs: 23개 통과, 실패 0.

이번 변경은 서버 설계와 HTML 도구다. Rust 서버·DB migration·실제 인증·배포·외부 회선 성능은 아직 구현 또는 실측하지 않았다. 이하 v3/v2/v1 기록은 각 버전 당시의 이력이다.

v3 UI 텍스트 재검토 검증

현재 설계: 70개 기능, 기본 27개, 설정 항목 163개, UI 흐름 39개. node design/plan.test.cjs --write-brief: 14개 성공, 실패 0.

한계: Parsec 실행 UI·드라이버·원격 연결은 이번 검사에서 실행하지 않았다. 서버 문구·웹 bundle·NSIS 압축 language table은 미복원이다. 자세한 범위는 UI_TEXT_AUDIT.ko.md에 있다.

이하 v2/v1 기록은 당시 결과를 보존한 이력이다.

v2 설정·복구 확장 검증

현재 설계: 63개 기능, 기본 27개, 설정·감사 항목 163개. node design/plan.test.cjs --write-brief: 11개 성공, 실패 0.

이하 기록은 확장 전 v1의 검증 이력이다.

자동 검사

node design/plan.test.cjs --write-brief: 7개 성공, 실패 0.

브라우저 확인

로컬 HTTP 미리보기에서 실제 UI 조작으로 확인했다.

다운로드한 HTML의 내장 상태는 파일 내용으로 검증했다. 브라우저 도구의 URL 보안 정책이 file: 열기를 차단하여 다운로드본을 직접 다시 여는 자동 UI 검사는 수행하지 못했다. 로컬 HTTP 미리보기에서의 동작 검증과 구별한다. JSON 가져오기, 복사, 다운로드는 실제 UI에서 확인했다.

아직 실행하지 않은 검증

Rust 빌드, 실제 두 PC 연결, NVENC/MF 하드웨어 경로, 지연·프레임률, 원격 입력, 오디오, NAT 통과는 구현 이후 각 기능의 완료 기준에 따라 수행해야 한다. 1080p60과 지연 수치는 설계 목표이며 이번 HTML 검사에서 달성한 측정값이 아니다.