notParsec / 문서전체 문서

생성 코드·템플릿

device-guide.fragment.html

design/device-guide.fragment.html

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

<section id="device-tools">
<div class="section-head"><h2>추가된 실행 기능 · 장치 등록과 화면 캡처 진단</h2><a href="IMPLEMENTATION_WAVE_2.ko.md">이번 구현·검증 상세 ↗</a></div>
<p>계정 가입·로그인 없이 <strong>내 장치의 키</strong>로 Ubuntu API에 접근합니다. 최초 등록에만 관리자 일회 코드를 사용합니다. 원격 화면을 연결할 때의 <strong>호스트 비밀번호</strong>는 별개이며 매 연결마다 그대로 필요합니다.</p>
<details class="run-step" open><summary>6. Ubuntu 서버에 장치 등록하기</summary><div class="run-content">
<p>운영 주소는 <code>https://n3m.kr</code>입니다. 공개 HTTPS/WSS와 Linux 기기 CLI 검증이 완료됐습니다. Windows 두 PC 연동은 아직 검증하지 않았습니다. GUI의 내 기기에서 주소 입력 → 이 기기의 키 생성 → 일회 코드 등록 → 목록 갱신 → 온라인 상태 확인 순서로 사용합니다. <a href="UBUNTU_OPERATIONS.ko.md">실제 적용 상태</a>.</p>
<pre><code># Ubuntu · 관리자 로컬 명령 / 예시의 systemd 설치 경로
sudo -u notparsec /opt/notparsec/notparsec-control-server --database /var/lib/notparsec/control.sqlite3 issue-enrollment --expires-in 300</code></pre>
<p>출력되는 코드는 5분 동안 한 번만 쓸 수 있습니다. 등록할 기기마다 새 코드를 발급합니다. 이 코드를 아래 숨김 프롬프트에 입력합니다.</p>
<pre><code># Windows 호스트 PC · 최초 한 번
.\notparsec.exe device init --directory .\device-data --server https://n3m.kr
.\notparsec.exe device enroll --directory .\device-data --name "내 데스크톱"

# 접속하는 Windows PC · 별도의 일회 코드 사용
.\notparsec.exe device init --directory .\device-data --server https://n3m.kr
.\notparsec.exe device enroll --directory .\device-data --name "내 노트북"
.\notparsec.exe device list --directory .\device-data

# 호스트에서 별도 터미널로 실행 · 10초마다 온라인 상태 갱신
.\notparsec.exe device heartbeat --directory .\device-data --watch</code></pre>
<p><code>device.secret</code>에는 서버 주소와 장치 개인키가 보호 저장됩니다. 같은 PC의 연결·호스팅은 같은 directory의 기기 키를 사용합니다. GUI 기본 경로는 %LOCALAPPDATA%\notParsec\desktop입니다. 다른 PC에는 키를 복사하지 않고 새로 만듭니다. <code>heartbeat</code> 종료 후 마지막 갱신에서 30초가 지나면 offline으로 표시됩니다. GUI에서도 등록·조회·수동 갱신을 지원합니다. 호스팅 대기와의 자동 연동·WSS 알림은 남아 있습니다. <a href="#desktop-gui">GUI 안내</a></p>
<pre><code># Ubuntu · device list에 나온 공개 device_id로 등록 해제
sudo -u notparsec /opt/notparsec/notparsec-control-server --database /var/lib/notparsec/control.sqlite3 revoke-device --device-id DEVICE_ID</code></pre>
<p>폐기 후 API·WSS 인증이 거부되고 서버 관리 세션은 종료 상태로 바뀝니다. Windows의 종료 ACK/lease watchdog·미디어 연결은 아직 통합하지 않았습니다. 새 기기는 새 키와 코드로 등록합니다. 장치 목록은 개인 기기끼리 공유하며 host 접속 권한은 별도 관리자 grant입니다.</p>
</div></details>
<details class="run-step"><summary>7. 서버 없이 GPU·디스플레이·캡처 확인하기</summary><div class="run-content">
<pre><code>.\dist\windows-unified-x64\tools\diagnostics\notparsec-diagnostics.exe devices
.\dist\windows-unified-x64\tools\diagnostics\notparsec-diagnostics.exe capture-probe --adapter 0 --output 0 --frames 60</code></pre>
<p><a href="../dist/windows-unified-x64/tools/diagnostics/notparsec-diagnostics.exe" download>진단 EXE 다운로드</a>. 캡처 probe는 최대 10초/600프레임으로 제한되고 이미지 파일을 저장하거나 외부로 전송하지 않습니다. 이 PC에서 RTX 3070·3840×2160·60프레임 획득을 확인했습니다. <a href="evidence/windows-devices.json">장치 결과</a> · <a href="evidence/windows-capture.json">캡처 결과</a>.</p>
<p>획득 대기 p50/p95는 화면이 바뀌기를 기다린 시간과 복사 명령 제출 구간입니다. 원격 지연·인코딩 성능을 나타내지 않습니다. hardware MFT 목록이 비어 있어도 실제 D3D11 H.264 decoder 시험 전에는 미지원이라고 단정하지 않습니다.</p>
</div></details>
<details class="run-step"><summary>8. 생성된 Linux 서버 파일 · 실제 서버에서 남은 확인</summary><div class="run-content">
<p><a href="../dist/linux-x64/control-server/notparsec-control-server" download>Ubuntu x86_64용 서버 파일</a> · <a href="../dist/linux-x64/control-server/SHA256SUMS">SHA-256</a> · <a href="evidence/ubuntu-native.json">Ubuntu native 검사</a>. Ubuntu N100에서 빌드하고 격리 Nginx TLS/WSS로 실행했습니다. 별도 SQLite/OpenSSL 동적 라이브러리는 요구하지 않습니다.</p>
<pre><code># Ubuntu에 파일을 복사한 후 해당 폴더에서
sha256sum -c SHA256SUMS
chmod 755 notparsec-control-server
ldd ./notparsec-control-server
./notparsec-control-server --database ./test-data/control.sqlite3 --listen 127.0.0.1:18080

# Ubuntu의 다른 터미널
curl --fail http://127.0.0.1:18080/health/ready</code></pre>
<p>Ubuntu 24.04.4 LTS·Intel N100·x86_64·4코어/4스레드에서 native 빌드·실행·정상 종료·재시작·백업/복원·이전 binary rollback을 시험했습니다. 운영 systemd/Nginx·공개 HTTPS/WSS·백업 timer·동일 release rollback·자동 재시작도 검증했습니다. 실제 Windows/별도 외부 회선은 미검증입니다. 화면 스트리밍은 미완료이며 health 성공과 구분합니다.</p>
</div></details>
</section>