YOU’RE INVITED
내 노드를 위한
든든한 파트너를 만나세요.
Pi Guardian에 오신 것을 환영해요.
PC에 설치하고 연결하면, 어디서든 노드의 안부를 확인할 수 있어요.
릴리스 16 · Windows 10/11 · x64
Pi와 Docker Desktop이 실행 중인 PC에서 시작해 주세요.
ON YOUR PHONE
휴대폰에서도, Pi Guardian
일반 Android 휴대폰과 폴드의 접힌 화면·펼친 화면에 맞춰 노드를 관리해요.
버전 1.1.1 · Android 8.0 이상 · 직접 설치용 APK
Android 앱 설치 안내휴대폰에서 관리자 계정으로 시작해요
- 휴대폰에서 APK를 다운로드하고 열어 설치해 주세요. Android가 설치 출처 허용을 요청하면 확인해 주세요.
- Pi Guardian을 열고 기존 관리자 계정으로 로그인해 주세요. 설정 → 노드 상태 알림 → 휴대폰 알림 설정에서 알림을 켜면 노드 상태 알림을 받을 수 있어요.
- 노드 등록에서 QR 스캔을 누르면 카메라 권한을 요청합니다. QR 이미지나 6자리 코드로도 등록할 수 있어요.
인터넷 연결이 필요합니다. 휴대폰 앱은 노드 관리용이며, Windows PC에 설치하는 Pi Guardian과 별개입니다. 폴드 8 실제 기기에서의 검증은 아직 진행하지 않았습니다.
도움이 필요하신가요? 필요한 안내만 열어보세요.
처음이신가요? 설치와 등록4단계로 간단하게 시작해요
- 압축 해제
Pi와 Docker를 사용하는 Windows 계정에서 ZIP을 다운로드하고 모두 압축 해제하세요.
- INSTALL.cmd 실행
Pi 컨테이너 이름을 입력하세요. testnet2이면 Enter를 누릅니다. Pi 앱 경로를 묻는 경우 Pi Network.exe 위치를 입력하세요.
- QR 또는 6자리 코드 확인
자동으로 열리는 PC 등록 화면에서 확인하세요. 화면이 열리지 않으면 해당 PC에서 127.0.0.1:4317에 접속하세요. 코드는 5분마다 갱신됩니다.
- 웹에서 등록
관리자가 전체 노드에 로그인 → 새로고침 옆 ＋ → QR 스캔 또는 코드 입력 → 노드명과 사용하는 그룹·로케이션 입력 → 등록. 약 1분 뒤 상태를 확인하세요. 모바일 웹에서도 가능합니다.
이미 설치된 PC라면기존 PC 업데이트 방법을 확인해요
기존 공통 설치본은 같은 계정에서 압축 해제한 UPDATE.cmd를 한 번 실행하세요. PC 등록정보를 유지하며 원격 업데이트 기능을 설치합니다. 다른 경로에 설치된 개발용 Pi Guardian은 별도 이전이 필요합니다.
이후 원격 업데이트
새 버전이 준비되면 운영 담당자에게 Pi Guardian 업데이트를 요청해 주세요. 전체·그룹별·로케이션별·개별 PC를 대상으로 진행할 수 있어요. 먼저 테스트 PC에서 확인한 뒤 순차 적용합니다.
Pi Guardian이 약 60~75초 간격으로 요청을 확인합니다. 서명과 파일 해시를 검사한 뒤 Pi Guardian만 재시작합니다. 시작 확인에 실패하면 이전 파일로 복구합니다. Pi·Docker·Windows를 재시작하지 않습니다. 오프라인 PC는 접속하면 예약한 버전을 설치합니다. 대기 예약은 관리자가 취소할 때까지 유지됩니다.
시작 전에 알아두면 좋아요자동 실행과 연결 정보를 안내해요
Windows 로그인 시 자동 실행됩니다. 시계 옆 Pi Guardian 아이콘을 더블클릭하거나 바탕화면 바로가기로 상태 창을 열 수 있어요. 창을 닫아도 감시는 계속됩니다. 재부팅 후에도 Windows에 로그인해야 감시가 재개됩니다. 등록 시 기본 설정은 수동 모드입니다.
설치 위치: %LOCALAPPDATA%\PiGuardian
로그: runtime\agent.log
업데이트 상태: runtime\update-state.json
설치가 차단되면 오류 내용을 관리자에게 전달하세요. 보안 프로그램은 끄지 마세요. 현재 화면 캡처는 일부 PC에서 보안 프로그램에 차단될 수 있습니다.
설치 후 runtime 폴더에는 해당 PC의 연결 키가 저장됩니다. 다른 PC에 복사하지 마세요.