SimpleViewer 공식 기술 문서 • v3.1.0

기술 문서 & 시스템 관리자 가이드

60초 빠른 시작, 무인 원격제어 설정, dashboard.simpleviewer.app에서의 개인 및 비즈니스 기기 관리, 무인 MSI/EXE 대량 배포 및 네트워크 보안 검증을 위한 완벽한 레퍼런스 가이드입니다.

01. 빠른 시작 02. 인증 모드 03. 클라우드 & 비즈니스 포털 04. 브라우저 웹 뷰어 05. CLI & GPO 배포 06. 포트 & 방화벽 07. 자주 묻는 질문
섹션 01

60초 만에 시작하기

SimpleViewer는 당사의 관리형 릴레이 인프라를 통해 공유기 포트포워딩, VPN 터널 또는 방화벽 재설정 없이 실행 즉시 작동합니다. 모든 데스크톱 바이너리는 호스트(Host)(수신 연결 수락)와 뷰어(Viewer)(원격 컴퓨터 제어) 기능을 동시에 수행합니다.

1단계 • 다운로드

Windows, macOS, Linux 또는 Android에서 SimpleViewerSetup.exe(백그라운드 서비스 포함 전체 설치형) 또는 SimpleViewer.exe(관리자 권한 불필요 포터블)를 실행합니다.

2단계 • 9자리 ID 확인

고유 9자리 기기 ID(XXX XXX XXX)를 대상 컴퓨터의 원격 연결(Remote Connect) 탭에서 확인합니다.

3단계 • 원격 접속

데스크톱 앱 또는 브라우저 웹 뷰어에 9자리 ID를 입력하고 원클릭 계정 인증, 무인 접속 비밀번호 또는 대화형 승인 창을 통해 연결합니다.

섹션 02

3가지 접속 인증 모드

SimpleViewer는 본인의 무인 기기에 접속하는지 또는 외부 고객·가족을 원격 지원하는지에 따라 3가지 인증 워크플로를 지원합니다:

  • 모드 A — 원클릭 계정 연동 ("내 컴퓨터"): 데스크톱 앱에서 SimpleViewer 또는 Google 계정으로 로그인하거나 내 포털에서 9자리 ID를 등록합니다. 연동된 모든 PC가 주소록에 자동 표시되어 비밀번호 입력 없이 원클릭으로 즉시 접속할 수 있습니다.
  • 모드 B — 임시 또는 영구 무인 접속 비밀번호: 자동 갱신되는 6자리 임시 세션 비밀번호를 사용하거나 설정(Settings) 탭에서 고정 무인 접속 비밀번호를 지정합니다. 솔트(Salted) SHA-256 챌린지-응답 핸드셰이크로 검증되므로 평문 비밀번호가 네트워크로 절대 전송되지 않습니다.
  • 모드 C — 대화형 수락 / 거절 승인 창: 가족이나 고객 PC에 연결할 때 비밀번호 입력란을 비워 두세요. 원격 화면에 실시간 권한 체크박스(마우스 & 키보드, 파일 전송, 클립보드, 오디오)가 포함된 30초 동의 대화상자가 표시됩니다.
섹션 03

통합 클라우드 & 비즈니스 대시보드 (dashboard.simpleviewer.app)

Free Starter부터 Business Unlimited까지 모든 사용자는 dashboard.simpleviewer.app에서 계정을 통합 관리합니다:

👤 개인 & Pro 사용자 기능

  • 무인 원격 컴퓨터 최대 3대(무료) 또는 15대(Pro) 연동
  • 각 워크스테이션에 알기 쉬운 별칭 & 메모 지정
  • 라이선스 키 등록, 인보이스 다운로드 & Stripe 결제 관리
  • PC 하드웨어 교체 시 사용된 대상 슬롯 즉시 초기화

🏢 Business 사용자 확장 기능

  • 무제한 무인 엔드포인트 & 최대 50개 동시 세션 관리
  • 사전 구성된 GPO / Intune 무인 배포 스크립트 생성
  • NIS2/ISO 규정 준수를 위한 타임스탬프 세션 감사 로그(CSV) 조회 & 내보내기
  • 전체 기기 접근 거버넌스 적용 & 즉각적인 기기 슬롯 회수
섹션 04

무설치 브라우저 웹 뷰어 (/connect)

프로그램 설치가 제한된 환경에서 고객을 지원하거나 사내 워크스테이션에 접속해야 하나요? Chrome, Edge, Brave, Safari 또는 Firefox에서 https://simpleviewer.app/ko/connect에 접속하세요:

  • 브라우저에서 원격 컴퓨터의 9자리 기기 ID와 무인 접속 비밀번호를 바로 입력합니다.
  • TLS WebSocket을 통해 HTML5 Canvas 위에 원격 데스크톱을 스트리밍하며 완벽한 마우스, 스크롤 및 키보드 입력을 지원합니다.
  • 멀티 모니터 전환, 화질 프리셋, 전체 화면 모드 및 원격 Ctrl+Alt+Del / 작업 관리자 실행을 포함합니다.
섹션 05

명령줄 인수(CLI) & 무인 대량 배포

IT 관리자는 다음 명령줄 매개변수를 사용해 Active Directory GPO, Microsoft Intune 또는 RMM 도구를 통한 무인 자동 배포를 구성할 수 있습니다:

# 1. Silent installation with unattended Windows background service registration
SimpleViewerSetup.exe /S --install-service

# 2. Launch portable client silently minimized to the Windows system tray
SimpleViewer.exe --minimized

# 3. Run an isolated configuration profile (stores separate settings_<name>.json)
SimpleViewer.exe --profile helpdesk-tier2

# 4. macOS one-line Terminal installer (Apple Silicon M1–M4 & Intel Universal)
curl -fsSL https://simpleviewer.app/download-macos | bash
섹션 06

네트워크 포트 & 방화벽 설정

SimpleViewer는 아웃바운드(Outbound) 연결만 사용하므로 사내 라우터나 Windows 방화벽에서 인바운드 포트를 열 필요가 전혀 없습니다. 엄격한 사내 프록시/방화벽으로 아웃바운드 트래픽을 통제하는 조직의 경우 simpleviewer.app에 대해 아래 아웃바운드 TCP 포트를 허용하세요:

포트 프로토콜 방향 용도
TCP 443 HTTPS / WSS (TLS 1.3) 아웃바운드 클라우드 대시보드 API, Stripe 라이선스 인증, 바이너리 체크섬 검증 & 브라우저 웹 뷰어
TCP 7890 WebSocket 시그널링 아웃바운드 기기 온라인 하트비트, 9자리 ID 탐색 & 솔트 SHA-256 챌린지-응답 핸드셰이크
TCP 7891 바이너리 TCP 릴레이 아웃바운드 종단간 AES-256-GCM 암호화 60 FPS 비디오 스트림, WASAPI 오디오 & 듀얼 패널 파일 전송
섹션 07

Business & Enterprise용 선택형 자체 호스팅 릴레이

기본적으로 모든 SimpleViewer 연결은 종단간 AES-256-GCM 암호화가 적용된 당사의 초고속 관리형 릴레이 메시를 통해 서버 설정 없이 자동 라우팅됩니다. 프라이빗 VPC나 폐쇄망(Air-gapped LAN) 내부에 격리된 온프레미스 릴레이가 필요한 규제 산업 기업(NIS2, DORA, HIPAA, ISO 27001)에는 당사 엔지니어링 팀이 전용 자체 호스팅 릴레이 패키지와 사전 구성된 맞춤형 클라이언트 바이너리를 제공합니다.

섹션 08

문제 해결 & 기술 FAQ

SimpleViewerSetup.exe 설치형과 포터블 SimpleViewer.exe의 차이점은 무엇인가요?
SimpleViewerSetup.exe는 Program Files에 SimpleViewer를 설치하고 바탕화면/시작 메뉴 바로가기를 생성하며, Windows 사용자 로그인 전 잠금 화면에서도 24시간 상시 무인 원격제어가 가능하도록 백그라운드 시작 서비스를 등록할 수 있습니다. 반면 포터블 SimpleViewer.exe는 관리자 권한 없이 모든 폴더나 USB 드라이브에서 즉시 실행되므로 빠른 일회성 고객 원격 지원에 이상적입니다.
내 컴퓨터에서 Pro 또는 Business 구독은 어떻게 활성화하나요?
Stripe 결제를 완료하는 즉시 계정이 실시간으로 자동 업그레이드됩니다. SimpleViewer 데스크톱 앱에서 동일한 이메일 주소로 로그인하거나 dashboard.simpleviewer.app을 열어 컴퓨터를 연동하고 결제 및 라이선스(Billing & Licenses) 메뉴에서 라이선스 키를 등록하세요.
"기기 슬롯 한도 도달(Device Slot Limit Reached)" 메시지가 표시되는 이유는 무엇인가요?
Free Starter 플랜은 최대 3대의 고유 컴퓨터 연동 및 접속을 지원하며, Pro 플랜은 최대 15대, Business Unlimited는 무제한 엔드포인트를 지원합니다. 기존 PC를 교체한 경우 내 포털에 로그인하여 사용된 대상 슬롯 초기화(Reset Used Target Slots)를 클릭하거나 이전 기기를 삭제하면 즉시 슬롯을 확보할 수 있습니다.
SimpleViewer로 Windows 사용자 계정 컨트롤(UAC) 팝업 및 관리자 권한 창을 제어할 수 있나요?
네. SimpleViewer를 관리자 권한으로 실행하거나 SimpleViewerSetup.exe로 설치하면, 내장된 Win32 입력 주입 엔진이 권한 상승된 사용자 계정 컨트롤(UAC) 대화상자, 작업 관리자 및 시스템 설정 유틸리티를 끊김 없이 표시하고 제어합니다.