# 관리자 기기 관리와 Computers 화면 변경 후속: 클라이언트의 추정 배치는 [150-104a 원본 자원·함수 기반 UI 복구](UI_RECOVERY.ko.md)로 교체했다. 이 문서의 이전 검증 기록은 당시 결과로 보존한다. 2026-09-24 · E01/E02/E04 · F24/F64/F67/F76/F82. Rust 독립 구현이며 원본 소스 복원이 아니다. 기능별 parity는 `different`를 유지한다. Windows 실기와 원본 동일 DPI 화면 대조는 남아 있다. ## 사용 방법 관리자 페이지에서 등록된 기기의 **호스트 접속 허용**을 켠다. 해당 PC에 최신 notParsec 앱이 실행 중이고 Host 설정에서 접속 비밀번호를 한 번 설정한 상태라면, 정상적인 서버 통신 시 다음 목록 갱신(최대 약 10초)에 호스팅을 시작한다. PC가 꺼져 있거나 앱이 닫혀 있으면 실행을 기다린다. 서버가 PC 전원을 켜거나 비밀번호를 대신 설정하지 않는다. 다른 PC의 앱에서 Computers → 대상 PC의 **Connect** → 비밀번호 모달 → **Connect** 순서로 접속한다. Enter로 제출하고 Esc·취소·배경 클릭으로 취소한다. 연결 중 취소는 작업을 중단한다. 실패하면 모달 안에서 오류를 확인하고 비밀번호를 다시 입력한다. 평문 비밀번호는 저장하지 않고 입력기의 undo 기록도 지운다. 관리자 비밀번호와 대상 PC 비밀번호는 별개다. 관리자에서 끄면 신규 연결을 차단하고 해당 호스트의 진행 중인 중계 연결을 종료한다. Windows 앱도 다음 조회에서 대기를 중지한다. PC 앱의 Host 설정에서도 같은 설정을 변경할 수 있다. 이것은 양쪽에서 편집하는 접속 허용 설정이며, 관리자만 수정할 수 있는 강제 정책은 아니다. 등록 해제는 관리자 전용이며 기기의 모든 인증을 차단한다. ## 관리자 변경 - 흰색 카드·밝은 배경의 라이트 모드. 모바일에서도 가로 넘침 없이 표시한다. - 등록 해제된 기기는 목록과 등록된 기기 수에서 즉시 제외한다. DB의 해제 기록과 기기 키 차단은 보존하므로 같은 키로 재등록하여 차단을 우회할 수 없다. - 기기별 접속 허용 스위치와 실제 접속 대기 상태를 구별한다. 켜짐이 곧 PC 온라인/호스팅 시작 성공을 뜻하지 않는다. 구형 앱, 꺼진 PC, 비밀번호 미설정은 대기 상태가 된다. - 관리자가 끄거나 등록 해제할 때 활성 중계 세션도 취소한다. 구형 앱의 호스트 재발행도 서버가 거절한다. 서버는 schema 5로 이전하며 기존 기기·승인·관리자 비밀번호를 보존한다. `hosting_enabled = NULL`인 기존 기기는 명시적으로 설정하기 전까지 기존 로컬 동작을 유지한다. `true/false` 설정은 서버 재시작 뒤에도 유지된다. 백업 복원은 폐기 기록을 보존하고 복원한 호스팅 설정을 꺼서 재확인하도록 한다. 이전 서버로 되돌릴 때는 해당 버전에 맞는 DB 백업도 필요하다. ## 원본 근거와 차이 기준은 Windows Parsec **150-104a**, 코어 SHA-256 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`다. | 항목 | 원본 근거 | 구현·판정 | |---|---|---| | Computers / Reload / 검색 / Connect | `ui-texts.tsv`: VA `18034e9f0`, `18034e1ec`, `18034e0f8`, `18034dfe0`; 함수 `180032300`, `180033bb0`, `18002ce40`, `18000c050`, `18002ad10` | 제목·검색·새로고침·PC 카드·접속 버튼 배치. 문자열 근거만으로 픽셀 배치 일치 판정을 내리지 않음 | | Hosting Enabled / Client / Host | VA `180349a48`, `18034c074`, 함수 `180012c50`, `1800192e0` | Settings의 Client/Host 구획. 실제 원격 호스팅 설정을 Host에 연결. 직접 QUIC 인증 시험은 진단 경로에 유지 | | PC 카드·좁은 아이콘 사이드바 | [공식 Windows 앱 설명](https://support.parsec.app/hc/en-us/articles/32381199341716-Parsec-App-for-Windows), [공식 이미지](https://support.parsec.app/hc/article_attachments/32381192725908) | 문서 조회 2026-09-24, 웹 페이지 갱신 표기 2026-07-07. **이미지에는 150-83c가 표시되어 150-104a와 버전이 다름**. 보조 배치 근거로만 사용 | | 비밀번호 모달 | 사용자 지시 + E01 | 계정 없는 PC별 비밀번호 인증에 필요한 변경. Parsec 원본의 동일 인증 모달이라고 주장하지 않음 | | 관리자 라이트 UI·호스팅 설정 | 사용자 지시 + E02 | 자체 Ubuntu 관리 기능. Parsec 서버 UI를 복원했다는 뜻이 아님 | [참고 이미지 출처·해시 기록](evidence/admin-ui-reference/reference.json). notParsec는 좁은 사이드바, 상단 기기 이름, Computers 제목, 카드 그리드, Settings Client/Host, 중앙 비밀번호 모달을 구현한다. PC 그림은 자체 벡터 도형이다. 원본 계정 대신 로컬 기기 이름을 표시하며 Share를 Host Settings로 치환한 부분은 E01/E02의 기기 관리 경로다. 친구·공유·전체 설정 탭·게스트 권한 표시·원본 아트/글꼴/정밀 배치는 아직 재현하지 않았고 완료로 세지 않는다. 등록된 오프라인 기기도 표시하는 현재 목록은 호스팅 가능한 기기 중심의 원본과 차이가 남는다. ## 구현과 검사 - 서버: `apps/control-server/migrations/005.sql`, `src/api/admin.rs`, `src/api/remote.rs`, `src/api.rs`. - 웹: `apps/control-server/web/admin.html`, `admin.css`, `admin.js`. - 클라이언트: `crates/desktop-ui/src/app.rs`, `app/remote_ui.rs`, `connection_prompt.rs`, `crates/device-client/src/{lib,remote}.rs`. - API: 관리자 `POST /notparsec-admin/api/hosting`는 대상 ID와 enabled, 기기 `POST /v1/remote/hosting`는 자신의 enabled만 받는다. 관리자/기기 토큰을 분리하고 다른 기기의 설정을 기기 토큰으로 변경할 수 없다. - 설정 변경과 호스트 발행/신규 세션 생성은 같은 잠금 순서를 사용해 끄기와 갱신의 경합을 직렬화한다. 끄기와 등록 해제는 활성 relay의 취소 채널에 전달한다. - 자동 시험: 관리자 토큰 경계, 설정 영속성, 해제된 목록/인증 차단, 브라우저 스위치·테마·다운로드·모바일, 실제 HTTPS/WSS 끄기/재활성화, 비밀번호 모달의 빈 제출/키보드/취소/입력 삭제, DB 백업·복원. - Windows x64 크로스 빌드·정적 검사는 실기 화면 및 실제 두 PC 연결 시험을 대신하지 않는다. 관리자에서 호스트 켜기 → 실제 Windows 자동 시작, 화면 렌더링, 모달 포커스/DPI와 GPU 성능의 실기 확인은 남아 있다. 이 빌드에는 [D3D11 GPU 직접 표시 개선](GPU_PRESENTATION.ko.md)도 포함한다. wire ALPN `/5`는 유지한다. 배포 및 검사 결과는 [검증 기록](evidence/admin-ui-validation.json)에 기록한다. ## 2026-09-26 관리자 웹 시각 규칙 후속 사용자 첨부 Tailscale 콘솔의 CSS·DOM·화면을 분석해 자체 관리자 웹의 탐색·표·버튼·여백을 정리했다. 기존 승인·호스팅·다운로드 계약과 데스크톱 앱 범위는 유지한다. [디자인 규칙·배치·검증](ADMIN_CONSOLE_DESIGN.ko.md)을 참고한다.