# 관리자 기기 목록 · PC 운영체제와 버전 2026-09-26 · E02 자체 관리 서버 · 사용자 요청에 따른 관리 정보 확장. ## 화면과 업데이트 관리자 기기 표에 **운영체제** 열을 추가했다. 이름 아래에 버전·빌드 번호를 표시한다. 휴대폰에서는 기기 ID 아래에 같은 정보가 나온다. | 플랫폼 | 표시 형태의 예 | 읽는 곳 | |---|---|---| | Windows | Windows 11 / 24H2 · 빌드 26100.9550 | OS 버전 API와 읽기 전용 CurrentVersion 레지스트리 | | macOS | macOS / 26.5.2 · 빌드 25F84 | `/usr/bin/sw_vers -productVersion`, `-buildVersion` | | Linux | Ubuntu / 24.04.4 LTS (Noble Numbat) · 빌드 6.8.0-136-generic | `/etc/os-release`와 `/proc/sys/kernel/osrelease` | 예시는 표시 형식이며 각 PC의 실제 값은 다를 수 있다. Linux의 빌드 칸은 커널 릴리스다. OS 정보가 없는 기존 기기는 **정보 미수신 / 앱 업데이트 후 표시**로 남긴다. 기기 이름, 접속 브라우저의 User-Agent, Ubuntu 서버 자체 버전으로 PC 정보를 추정하지 않는다. **PC 앱도 이 변경이 들어간 버전으로 업데이트해야 한다.** 업데이트한 앱이 실행 중이면 기존 정기 상태 갱신에서 자동으로 전달한다. 별도 기기 등록이나 재승인은 필요 없다. Windows의 기존 업데이트 경로와 Mac의 다운로드·수동 교체 경로를 따른다. 플랫폼별 실제 게시·검증 여부는 [검증 기록](evidence/device-os-information.json)을 확인한다. Mac 빌드 방식은 병행 작업의 [고정 코드 서명](MAC_FIXED_SIGNING.ko.md)과 같다. 실제 Mac에서 native release로 빌드하고 같은 인증서·앱 식별 조건으로 앱과 동봉 FFmpeg를 서명한 뒤 DMG를 만든다. 이번 패키지와 현재 `/Applications/notParsec.app`을 동일 인증서 조건으로 검증했다. 작업별 빌드 번호는 다르며 진행 중인 서명 도구 수정을 덮어쓰지 않도록 소스를 별도 디렉터리에 고정했다. 동시에 진행된 서명 작업이 자신의 Mac 패키지를 나중에 게시하면서 OS 정보 기능이 없는 파일로 잠시 교체된 것을 확인했다. 최종 `1790451983`은 두 변경을 합쳐 별도 소스·별도 Cargo 빌드 경로에서 만들었다. 서명 검사 5개와 OS 수집 시험 3개, 최종 패키지의 인증서 조건·운영 서버 상태 갱신을 확인한 뒤 재게시했다. 내보낸 소스에는 Git 저장소가 없으므로 앱 내부 commit은 0으로 남으며, 실제 기반 commit과 964개 입력 파일 hash는 별도 소스 manifest에 보존한다. ## 감지와 전달 `crates/device-client/src/system_info.rs`에서 로컬 OS를 읽는다. 첫 수집은 작업 스레드에서 수행하고 프로세스 동안 캐시하여 매 갱신마다 시스템 명령을 실행하지 않는다. OS 업그레이드 후 앱을 다시 시작하면 새 값을 읽는다. 관리자 권한이나 새 캡처·입력 권한은 필요하지 않다. Windows는 `RtlGetVersion`의 실제 버전·빌드·제품 유형과 HKLM의 `DisplayVersion`, `UBR`을 읽는다. Windows 10/11의 주 버전 번호가 같으므로 워크스테이션의 빌드 범위를 함께 확인한다. 서버 제품은 Windows Server로 구분한다. 레지스트리 값이 없으면 OS API의 숫자 버전을 남긴다. macOS에는 `SYSTEM_VERSION_COMPAT=0`을 지정한다. Linux의 os-release는 데이터로 파싱하며 셸에서 실행하지 않는다. 읽지 못한 버전은 빈 값을 지어내지 않고 ‘버전 확인 불가’로 표시한다. 기존 인증된 `POST /v1/devices/heartbeat` 요청에 선택적 `system_info`를 덧붙인다. ```json { "system_info": { "name": "Windows 11", "version": "24H2", "build": "26100.9550" } } ``` 서버는 인증 토큰의 기기 ID에만 저장한다. 본문에서 다른 기기 ID를 지정할 수 없다. 미인증·등록 해제 기기는 갱신할 수 없다. OS 이름은 80바이트, 버전은 128바이트, 빌드는 80바이트 이내의 제어 문자가 없는 문자열이며, 버전·빌드는 미확인 시 null을 허용한다. 페이지는 `textContent`로 표시한다. 기존 클라이언트의 빈 본문·`null`·`{}`도 계속 허용한다. 이 경우 이미 보고된 OS 정보를 지우지 않는다. 마지막 정보는 오프라인에서도 유지된다. 이는 기기가 보고한 관리용 표시 정보이며, 장치 보안 검증·접속 허용 판단에 사용하지 않는다. 관리자 인증이 필요한 목록 API에만 추가하고 일반 기기 목록 API는 변경하지 않는다. ## 저장과 배포 서버 DB schema 6은 `device_system_info` 테이블만 추가한다. 기존 기기 키·승인·호스팅 설정·해제 기록을 바꾸지 않는다. `reported_at`에는 마지막 보고 시각을 저장한다. 기존 서버를 먼저 백업하고 새 서버를 적용한 뒤 PC 앱을 배포한다. 구버전 앱과 새 서버, 새 앱의 추가 heartbeat 필드를 무시하는 기존 서버의 조합을 유지한다. schema 6을 모르는 이전 서버로 되돌릴 때는 배포 전 DB 백업을 함께 복구해야 한다. 기존 백업·복구 도구를 사용하며 문서만 수정하는 배포와 구분한다. ## 검증과 원본 대조 범위 - 서버 25개, device-client 13개 시험: 인증 범위, 다른 기기 지정 거부, 문자열 제한, 기존 본문 호환, OS 값 갱신·영속성·등록 해제 후 거부, schema 5→6 보존, Linux 파싱, Windows 워크스테이션/서버 구분, 실제 앱 모니터 전달. - 실제 임시 서버·Linux 클라이언트·Chromium으로 OS 미수신→자동 보고→표 표시, 승인·거절·호스팅·등록 해제·기존 다운로드·모바일 표시를 확인했다. - 백업/복구 시험 2개 통과. 별도 이전 schema-2 실행파일을 사용하는 선택 시험 1개는 해당 파일을 지정하지 않아 건너뛰었다. - 실제 Apple Silicon Mac에서 수집 시험 3개를 통과했고, macOS 26.5.2 / 빌드 25F84를 확인했다. Mac 네이티브 release 앱·DMG와 Windows x64 release 앱을 빌드했다. Windows PE의 외부 의존성 검사와 서버 임시 실행·인증·종료 검사도 통과했다. Windows 실제 PC의 OS 수집 실행은 아직 미확인이다. - 게시 빌드는 Windows `1790451407`, Mac Apple Silicon `1790451983`이다. 서버·두 플랫폼 앱을 게시하고 실제 배포 hash와 공개 페이지 일치를 확인했다. 파일 hash·배포 여부는 [검증 기록](evidence/device-os-information.json)에 남긴다. 실제 등록된 Mac 프로필로 새 패키지의 상태 갱신 명령을 한 번 실행하여 운영 서버가 OS 보고를 받는 것까지 확인했다. Mac 설치본과 실행 중인 앱은 교체하거나 재시작하지 않았다. Mac 패키지는 기존 로컬 인증서로 서명되며 Apple Developer ID 서명·공증과는 다르다. [관리 콘솔 디자인 규칙](ADMIN_CONSOLE_DESIGN.ko.md)에 같은 글자·간격·색상 규칙으로 열을 추가했다. Tailscale에만 있는 메뉴를 가져온 변경이 아니며, 이번에 명시적으로 요청한 OS 정보의 수집 기능을 함께 구현한 것이다. Parsec Windows 150-104a 코어 기준은 유지한다. 비공개 Parsec 서버 API나 OS 보고 형식을 복원했다고 주장하지 않으며 F76의 parity `different`와 기존 부분 구현 상태를 유지한다. 근거: [Microsoft OSVERSIONINFOEXW](https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-osversioninfoexw), [RtlGetVersion](https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nf-wdm-rtlgetversion), [Windows 11 버전과 빌드](https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information). 위 자료는 OS 판별 근거이며 Parsec 원본 대응 근거와 구별한다.