HandyCafe Docs
it-admin

시작하기: IT 관리자

이 가이드는 HandyCafe의 기술적 설정을 다룹니다. 가이드를 마치면 서버와 클라이언트가 설치되고, 네트워크가 구성되고, 앱 메뉴가 구축되고, 원격 관리가 테스트된 상태가 됩니다.

소요 시간: 5분(클라이언트 배포 시간 제외)

1단계: 서버 및 클라이언트 설치

서버 설치:

  1. 서버 PC가 시스템 요구사항을 충족하는지 확인합니다.
  2. 관리 PC에 HandyCafe 서버를 다운로드하여 설치합니다.
  3. 서버를 실행하고 초기 설정 마법사를 완료하여 관리자 계정을 생성합니다.
  4. 서버 PC의 로컬 IP 주소를 기록합니다. 클라이언트 연결에 필요합니다.

클라이언트 설치 (각 PC에 반복):

  1. 각 고객용 PC에 HandyCafe 클라이언트를 다운로드합니다.
  2. 설치하고 실행합니다.
  3. 클라이언트가 mDNS 검색을 사용하여 로컬 네트워크에서 서버를 자동으로 찾습니다.
  4. 서버가 자동으로 검색되지 않으면 클라이언트 설정에서 서버 IP 주소를 수동으로 입력합니다.
  5. 연결되면 클라이언트가 서버의 관리자 패널에 나타납니다.

자세한 내용은 서버 설치 및 클라이언트 설치를 참조하십시오.

2단계: 네트워크 설정 구성

서버에서 설정 > 네트워크로 이동합니다.

HandyCafe는 통신에 네 개의 포트를 사용합니다.

포트 기본값 용도
TCP 포트 5001 명령 및 응답 통신
파일 포트 5002 서버와 클라이언트 간 파일 전송
원격 관리 포트 5003 원격 데스크톱 스트리밍 제어
UDP 포트 5004 화면 스트리밍 데이터

구성:

  1. 포트를 설정합니다(대부분의 설정에서 기본값으로 충분합니다).
  2. 연결 키를 설정합니다. HMAC-SHA256 인증에 사용되는 공유 비밀 키입니다. 모든 클라이언트가 동일한 키를 사용해야 합니다.
  3. 저장을 클릭합니다.

방화벽 규칙:

서버와 클라이언트 PC 모두에서 다음 포트가 열려 있는지 확인합니다.

  • TCP: 5001, 5002, 5003
  • UDP: 5004

중요: 모든 PC는 동일한 로컬 네트워크(서브넷)에 있어야 합니다. HandyCafe는 클라이언트 검색에 mDNS를 사용하며, 이는 LAN 연결이 필요합니다.

자세한 내용은 네트워크 설정을 참조하십시오.

3단계: 클라이언트 메뉴 설정

설정 > 클라이언트 > 콘텐츠 탭으로 이동합니다.

  1. 카테고리를 생성합니다. 앱을 유형별로 그룹화합니다(예: 게임, 브라우저, 소셜 미디어, 도구).
  2. 각 카테고리에 앱을 추가합니다. 앱 이름, 설명, 앱 종류, 실행 경로 또는 URI, 아이콘 및 포스터 이미지를 설정합니다.
  3. 드래그 핸들로 카테고리와 앱의 순서를 변경합니다.
  4. 표시 전환으로 항목을 표시하거나 숨깁니다.
  5. 저장을 클릭합니다.

변경 사항이 TCP를 통해 모든 연결된 클라이언트에 실시간으로 자동 반영됩니다.

자세한 내용은 클라이언트 메뉴를 참조하십시오.

4단계: 대기 화면 및 외관 설정

대기 화면 (설정 > 클라이언트 > 대기 화면 탭):

  1. 대기 화면 슬라이드쇼를 활성화합니다.
  2. 이미지 또는 비디오를 추가합니다.
  3. 항목당 표시 시간 및 전환 효과를 설정합니다.
  4. 시계 오버레이 및 카페명 표시를 활성화합니다(선택 사항).
  5. 저장을 클릭합니다.

외관 (설정 > 클라이언트 > 외관 탭):

  1. 테마를 선택합니다: Neon Arena, Crimson Pulse 또는 Emerald Depth.
  2. 레이아웃 프리셋을 선택합니다.
  3. 배경을 설정합니다: 단색, 그라데이션, 이미지 또는 비디오.
  4. 카드 밀도 및 호버 효과를 조정합니다.
  5. 저장을 클릭합니다.

5단계: 원격 데스크톱 및 스크린샷 테스트

스크린샷:

  1. 관리자 패널에서 온라인 클라이언트 카드를 선택합니다.
  2. 스크린샷을 클릭합니다.
  3. 뷰어에 클라이언트 화면의 스크린샷이 표시됩니다.

원격 데스크톱:

  1. 온라인 클라이언트 카드를 선택하고 원격 데스크톱을 클릭합니다.
  2. 실시간 H.264 스트리밍이 포함된 원격 데스크톱 창이 열립니다.
  3. 원격 PC의 마우스와 키보드를 제어할 수 있습니다.
  4. 서버와 클라이언트 간 클립보드 동기화가 작동합니다.

자세한 내용은 원격 데스크톱 및 스크린샷을 참조하십시오.

네트워크 아키텍처 개요

서버 PC (관리)
    |
    |--- TCP (5001) --- 명령/응답 (bincode + HMAC-SHA256)
    |--- TCP (5002) --- 파일 전송
    |--- TCP (5003) --- 원격 관리 제어
    |--- UDP (5004) --- 화면 스트리밍 (H.264)
    |--- mDNS ------- 클라이언트 검색 (자동)
    |
    +-- 클라이언트 PC 1
    +-- 클라이언트 PC 2
    +-- 클라이언트 PC 3
    +-- ...

다음에 할 일