HandyCafe Docs
it-admin cashier

원격 데스크톱 및 스크린샷 사용 방법

이 가이드는 HandyCafe 서버의 모든 원격 모니터링 기능을 다룹니다. 클라이언트 PC에서 무슨 일이 일어나고 있는지 확인하고, 제어하며, 스크린샷을 캡처하고, 세션을 녹화하고, 실행 중인 소프트웨어를 검사하고, 메시지를 보내고, 원격으로 기기를 관리할 수 있습니다.


스크린샷 캡처 방법

스크린샷을 통해 전체 원격 세션을 시작하지 않고도 클라이언트 PC의 화면을 한 프레임 캡처할 수 있습니다.

필요 사항

  • HandyCafe 서버 실행 중.
  • 최소한 하나의 클라이언트 PC가 온라인 상태로 연결됨.

단계

  1. 메인 페이지의 관리자 패널에서 대상 PC를 찾습니다. 온라인 PC는 녹색 상태 표시기로 나타납니다.
  2. PC 타일에서 스크린샷을 클릭합니다.
  3. 캡처가 완료될 때까지 몇 초 기다립니다. 스크린샷 뷰어가 자동으로 열리며 캡처된 이미지를 표시합니다.
  4. 스크린샷 뷰어에서 두 가지 옵션이 있습니다. 새로 고침을 클릭하여 현재 화면 상태의 새 스크린샷을 찍거나 다운로드를 클릭하여 이미지를 로컬 기기에 저장합니다. 파일은 PC01_2026-04-16_14-30-22.png와 같은 타임스탬프가 포함된 파일명으로 저장됩니다.

예상 결과

클라이언트의 화면을 전체 해상도로 캡처하여 뷰어에 표시합니다. 이미지는 캡처 순간의 화면을 정확히 반영합니다.

일반적인 실수

  • 오프라인 PC의 스크린샷을 시도하는 경우. 옵션이 회색으로 표시되거나 오류를 반환합니다. 먼저 PC가 온라인인지 확인하세요.
  • 단일 스크린샷에서 실시간 업데이트를 기대하는 경우. 지속적인 모니터링을 위해서는 원격 데스크톱을 사용하세요.

원격 데스크톱 세션 시작 방법

원격 데스크톱을 통해 클라이언트 PC의 화면을 실시간으로 스트리밍하고 마우스와 키보드를 완전히 제어할 수 있습니다.

필요 사항

  • HandyCafe 서버 실행 중.
  • 대상 클라이언트 PC가 온라인 상태로 연결됨.
  • 서버와 클라이언트 간 충분한 네트워크 대역폭. 원활한 스트리밍을 위해 최소 2 Mbps가 권장됩니다.

단계

  1. 관리자 패널에서 제어하려는 온라인 PC를 선택하고 카드에서 원격 데스크톱을 클릭합니다.
  2. 클라이언트의 실시간 비디오 피드를 보여주는 새 창이 열립니다. 스트림은 자동으로 시작됩니다.
  3. 원격 데스크톱 창 안에서 마우스를 움직여 클라이언트 PC의 커서를 제어합니다. 마우스 움직임이 원격 기기의 커서 움직임으로 직접 변환됩니다.
  4. 원격 데스크톱 창이 포커스된 상태에서 키보드를 입력하여 클라이언트에 키 입력을 보냅니다. 클립보드 동기화가 가능하여 기기 간 텍스트를 복사하고 붙여넣을 수 있습니다.

예상 결과

클라이언트 PC의 실시간 비디오 스트림을 보고 해당 기기에서 직접 작업하는 것처럼 상호작용할 수 있습니다. 클라이언트 PC 사용자도 화면에서 커서 움직임을 볼 수 있습니다.


스트림 품질 조정 방법

비트레이트와 품질 설정을 조정하여 시각적 선명도와 네트워크 사용량 간의 균형을 맞출 수 있습니다.

필요 사항

  • 활성 원격 데스크톱 세션.

단계

  1. 원격 데스크톱 창을 열고 도구 모음에서 품질 설정 컨트롤을 찾습니다.
  2. 비트레이트 슬라이더를 조정합니다. 범위는 350 kbps(매우 느린 네트워크에 적합한 최소값)에서 25,000 kbps(LAN 연결에 적합한 최대값)입니다. 대부분의 로컬 네트워크에는 2,000-5,000 kbps 설정이 적합합니다.
  3. FPS 설정을 조정합니다(가능한 경우). 높은 값은 더 부드러운 움직임을 제공하지만 더 많은 대역폭을 소모합니다.
  4. 스트림은 즉시 업데이트됩니다. 세션을 다시 시작할 필요는 없습니다.

각 설정을 사용할 때

  • 낮은 비트레이트 (350-1,000 kbps): 느리거나 혼잡한 네트워크에서 사용하거나 여러 PC를 동시에 모니터링할 때 사용합니다. 이미지는 부드럽지만 기능적입니다.
  • 중간 비트레이트 (2,000-5,000 kbps): 로컬 네트워크에 대한 기본 설정으로 적합합니다. 텍스트와 UI 요소가 명확하게 보입니다.
  • 높은 비트레이트 (10,000-25,000 kbps): 기가비트 LAN에서 작은 텍스트를 읽거나 원격 기기에서 비디오 재생을 볼 때 사용합니다.

원격 세션 녹화 방법

세션 녹화는 원격 데스크톱 스트림을 비디오 파일로 캡처하여 나중에 검토할 수 있도록 합니다.

필요 사항

  • 활성 원격 데스크톱 세션.
  • 서버 기기에 FFmpeg가 설치되어 있어야 합니다. 녹화는 FFmpeg를 사용하여 스트림을 인코딩합니다.

단계

  1. 원격 데스크톱 창을 열고 도구 모음에서 녹화 버튼을 클릭합니다.
  2. 녹화 표시기가 나타나 캡처가 활성 상태임을 확인합니다.
  3. 원격 데스크톱 세션에서 계속 작업합니다. 모든 비디오가 캡처됩니다.
  4. 완료되면 녹화 중지를 클릭합니다.
  5. 녹화는 MP4 파일로 녹화 디렉토리에 저장됩니다. 기본 경로는 HandyCafe 서버 구성 디렉토리의 config_dir/recordings/입니다. 파일명에는 PC 이름과 타임스탬프가 포함됩니다.

예상 결과

녹화를 시작한 순간부터 중지할 때까지의 전체 원격 세션이 포함된 MP4 비디오 파일이 생성됩니다. 파일은 모든 비디오 플레이어에서 재생할 수 있습니다.


클라이언트에서 실행 중인 앱 보기

이 기능은 클라이언트 PC에서 현재 실행 중인 모든 프로세스를 보여줍니다.

필요 사항

  • 대상 클라이언트 PC가 온라인 상태로 연결됨.

단계

  1. 관리자 패널에서 대상 PC를 선택하고 카드에서 실행 중인 앱을 클릭합니다.
  2. 클라이언트 기기의 모든 활성 프로세스를 보여주는 패널이 열립니다. 각 항목은 프로세스 이름과 리소스 사용량을 표시합니다.

예상 결과

클라이언트 PC에서 실행 중인 프로세스의 실시간 목록이 표시됩니다. 고객이 무엇을 하고 있는지 확인하거나 성능 문제를 진단하는 데 유용합니다.


설치된 앱 보기

클라이언트 기기에 설치된 모든 소프트웨어 목록을 가져올 수 있습니다.

필요 사항

  • 대상 클라이언트 PC가 온라인 상태로 연결됨.

단계

  1. 관리자 패널에서 대상 PC를 선택하고 카드에서 설치된 앱을 클릭합니다.
  2. 클라이언트 기기에 감지된 모든 설치된 소프트웨어 목록이 표시됩니다.

예상 결과

클라이언트 PC에 설치된 애플리케이션의 전체 목록이 표시됩니다. 필요한 소프트웨어가 있는지 확인하거나 클라이언트 기기를 감사하는 데 사용합니다.


클라이언트에게 메시지 보내기

메시지는 고객의 화면에 팝업으로 표시됩니다. "5분 후 세션이 종료됩니다" 또는 "프론트 데스크로 와주세요"와 같은 알림에 사용하세요.

필요 사항

  • 대상 클라이언트 PC가 온라인 상태로 활성 세션 중.

단계

  1. 관리자 패널에서 대상 PC를 선택하고 카드에서 메시지 보내기를 클릭합니다.
  2. 나타나는 대화 상자에 메시지 텍스트를 입력합니다.
  3. 보내기를 클릭하여 메시지를 전달합니다.

예상 결과

클라이언트 PC의 화면에 메시지가 표시된 팝업 알림이 나타납니다. 고객은 즉시 메시지를 확인할 수 있습니다.


클라이언트를 원격으로 종료하거나 재부팅하는 방법

서버 워크스테이션을 떠나지 않고 클라이언트 PC를 전원 관리할 수 있습니다.

필요 사항

  • 대상 클라이언트 PC가 온라인 상태로 연결됨.

단일 PC에 대한 단계

  1. 관리자 패널에서 대상 PC를 선택하고 종료를 클릭하여 전원을 끄거나 재부팅을 클릭하여 다시 시작합니다.
  2. 나타나는 대화 상자에서 작업을 확인합니다.

여러 PC를 동시에 처리하는 단계

  1. Ctrl을 누른 상태에서 각 PC를 클릭하여 관리자 패널에서 여러 PC를 선택하거나 Ctrl+A를 사용하여 모두 선택합니다.
  2. 작업 버튼에서 종료 또는 재부팅을 클릭합니다.
  3. 일괄 작업을 확인합니다. 선택한 모든 PC가 동시에 명령을 실행합니다.

예상 결과

선택한 클라이언트 PC가 종료되거나 재부팅됩니다. 관리자 패널에서 상태가 종료 후 오프라인으로 변경되거나 재부팅 중에는 잠시 다시 연결 중으로 표시됩니다.


오프라인 PC를 깨우는 방법

Wake on LAN은 오프라인 PC를 원격으로 시작하기 위해 특별한 네트워크 패킷을 보냅니다.

필요 사항

  • 클라이언트 PC의 BIOS/UEFI 설정에서 Wake on LAN(WoL)이 활성화되어 있어야 합니다.
  • PC는 이더넷을 통해 네트워크에 연결되어 있어야 합니다(Wi-Fi를 통한 WoL은 대부분의 하드웨어에서 신뢰할 수 없습니다).
  • 서버는 클라이언트와 동일한 네트워크 세그먼트에 있어야 하며, 라우터는 브로드캐스트 패킷을 전달하도록 구성되어 있어야 합니다.

단계

  1. 관리자 패널에서 오프라인 PC를 찾습니다. 회색 또는 빨간색 상태 표시기로 나타납니다.
  2. PC 카드에서 Wake on LAN을 클릭합니다.
  3. 서버가 클라이언트의 MAC 주소로 매직 패킷을 보냅니다.
  4. PC가 부팅되고 HandyCafe 클라이언트가 시작될 때까지 30-60초 기다립니다.

예상 결과

클라이언트 PC가 전원이 켜지고 운영 체제로 부팅되며 HandyCafe 클라이언트가 자동으로 서버에 연결됩니다. 관리자 패널에서 PC 상태가 온라인으로 변경됩니다.

일반적인 실수

  • 클라이언트 PC의 BIOS에서 WoL이 활성화되지 않음. 대부분의 기기에서 기본적으로 비활성화되어 있습니다. BIOS 설정에 들어가 "Wake on LAN" 또는 "Wake on PCI-E"를 찾아 활성화하세요.
  • 클라이언트 PC가 다른 서브넷에 있음. 기본적으로 WoL 브로드캐스트 패킷은 라우터를 통과하지 않습니다. 지향성 브로드캐스트가 필요하거나 PC가 동일한 VLAN에 있어야 합니다.
  • 클라이언트 PC가 전원에서 분리됨. WoL은 네트워크 카드에 대기 전력을 공급하기 위해 전원 공급이 필요합니다. 완전히 전원이 분리된 기기는 깨울 수 없습니다.

모든 원격 기능에서의 일반적인 실수

  • 오프라인으로 표시된 PC에서 원격 기능을 사용하려고 시도하는 경우. 원격 작업을 시도하기 전에 항상 연결 상태를 확인하세요.
  • 저대역폭 네트워크에서 여러 원격 데스크톱 세션을 동시에 실행하는 경우. 각 세션은 상당한 대역폭을 소모합니다. 두세 개 이상의 세션을 열 경우 네트워크 사용량을 모니터링하세요.
  • 고객이 원격 커서와 키 입력을 볼 수 있다는 것을 잊는 경우. 원격 데스크톱은 숨겨진 모니터링 도구가 아닙니다. 고객은 화면에서 당신이 하는 모든 것을 볼 수 있습니다.