Pi Guardian 공통 설치 안내

이 파일은 모든 Windows x64 노드 PC에 동일하게 사용할 수 있습니다.
관리자 비밀번호나 장치 연결 키가 포함되어 있지 않습니다.

1. Pi와 Docker Desktop을 사용하는 Windows 계정으로 로그인합니다.
2. ZIP을 모두 압축 해제한 후 INSTALL.cmd를 실행합니다.
3. 실제 Pi 컨테이너 이름을 입력합니다. testnet2이면 Enter를 누릅니다.
4. 자동으로 열린 Pi Guardian 환영 창에서 QR과 6자리 코드를 확인합니다.
5. https://guardian.nodebaksa.com/fleet 에 로그인합니다.
6. 노드 등록에서 코드, 노드명, 로케이션, 그룹을 입력하고 등록합니다.
   모바일 기본 카메라로 QR을 스캔하면 로그인 후 코드가 자동 입력됩니다.
7. 약 1분 뒤 상태 수신을 확인합니다. 새 PC는 수동 모드입니다.

코드는 5분간 유효하며 자동 갱신됩니다. 한번 등록하면 다시 입력하지 않습니다.
설치 및 등록 자체는 Pi 재시작이나 PC 재부팅을 실행하지 않습니다.
전체 PC 복구 설정은 현재 등록된 PC에 일괄 적용하며 이후 등록 PC는 수동 모드입니다.

설치 위치: %LOCALAPPDATA%\PiGuardian
실행 작업: PiGuardianAgent (Windows 사용자 로그인 시)
재부팅 후 Windows에 로그인해야 감시자가 재개됩니다.
Pi와 Docker Desktop의 자동 시작은 해당 프로그램 설정에서 확인하세요.

예약 작업 접근 거부: 같은 Windows 계정의 관리자 권한 명령 프롬프트에서
압축 해제 폴더로 이동한 후 INSTALL.cmd를 실행하세요.
다른 관리자 계정으로 설치하지 마세요.
이미 감시자가 등록된 PC에는 덮어쓰기 설치하지 않습니다.
설치 후 runtime 폴더는 PC별 키를 포함하므로 다른 PC에 복사하지 마세요.
진단 로그: %LOCALAPPDATA%\PiGuardian\runtime\agent.log
다른 실물 PC에서 설치·재부팅 시험은 아직 수행하지 않았습니다.

화면 캡처 지원 버전: 기존 공통 설치 PC는 UPDATE.cmd로 업데이트하세요.
기존 PC별 등록 키는 그대로 보존됩니다. 신규 PC는 INSTALL.cmd를 사용하세요.
캡처는 로그인된 사용자의 주 모니터만 최대 1920픽셀로 전송합니다.
잠금·로그아웃·보안 데스크톱에서는 실패하거나 검은 화면이 될 수 있습니다.

원격 업데이트 지원 릴리스 1
기존 공통 설치 PC는 UPDATE.cmd를 한 번 실행한 뒤 운영 담당자에게 원격 업데이트를 요청합니다.
관리자는 새 릴리스 배포 후 테스트 PC 1대 선택 > 업데이트 입력 > 요청 > 완료 확인 > 나머지 PC에 순차 적용합니다.
파일 서명과 해시를 검사하며 실패 시 이전 앱 파일을 복구합니다. runtime 등록정보는 보존합니다.
설치/등록 가이드: https://guardian.nodebaksa.com/download

릴리스 2: 시계 옆 Pi Guardian 트레이 아이콘을 더블클릭하면 상태 창이 열립니다.
창을 닫아도 감시는 계속됩니다. 바탕화면 Pi Guardian 바로가기로 다시 열 수 있습니다.
