HandyCafe Docs
it-admin

시작하기: IT 관리자

이 가이드는 HandyCafe의 기술 설정을 다룹니다. 완료 후에는 서버 및 클라이언트가 설치되고, 네트워크가 구성되며, 앱 메뉴가 생성되고, 원격 관리가 테스트됩니다.

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

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

서버 설치:

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

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

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

팁: 서버의 자동 이름 지정 기능(설정 > 클라이언트)을 사용하여 "PC #1", "PC #2" 등과 같은 접두사를 사용하여 클라이언트 이름을 자동으로 지정할 수 있습니다. 나중에 표시 이름을 사용자 정의할 수 있습니다.

자세한 단계는 서버 설치 및 클라이언트 설치를 참조하세요.

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를 통해 모든 연결된 클라이언트에 실시간으로 자동 푸시됩니다.

팁: IGDB 통합을 사용하여 게임 메타데이터와 아이콘을 자동으로 검색하세요.

완전한 메뉴 빌더 문서는 클라이언트 메뉴를 참조하세요.

4단계: 대기 화면 및 외관 구성

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

대기 화면은 세션이 활성화되지 않았을 때 고객이 보는 화면입니다 (잠금 화면).

  1. 대기 화면 슬라이드쇼를 활성화합니다.
  2. 이미지 또는 비디오를 추가합니다 (PNG, JPG, WebP, GIF, MP4, WebM).
  3. 항목당 지속 시간과 전환 효과를 설정합니다 (페이드, 슬라이드, 줌).
  4. 선택적으로 시계 오버레이와 카페 이름 표시를 사용자 정의 색상으로 활성화합니다.
  5. 저장을 클릭합니다.

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

고객이 세션 중에 사용하는 온라인 데스크톱의 모양을 구성합니다.

  1. 테마를 선택합니다: Neon Arena, Crimson Pulse, Emerald Depth.
  2. 레이아웃 프리셋을 선택합니다: Split Classic, Hero Wide Top, Catalog Wide Bottom, Compact Focus.
  3. 배경을 구성합니다: 단색, 그라데이션, 이미지 또는 비디오와 오버레이 및 블러 설정.
  4. 카드 밀도(크게, 중간, 작게)와 호버 효과를 조정합니다.
  5. 저장을 클릭합니다.

모든 옵션은 클라이언트 대기 화면 및 클라이언트 외관을 참조하세요.

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

원격 관리가 작동하는지 확인합니다:

스크린샷:

  1. 관리자 패널에서 온라인 클라이언트 카드를 선택합니다.
  2. 클라이언트 카드에서 스크린샷을 클릭합니다.
  3. 클라이언트 화면의 스크린샷이 뷰어에 나타납니다.
  4. 스크린샷을 다운로드하거나 새로 고침할 수 있습니다.

원격 데스크톱:

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

참고: 원격 데스크톱은 UDP 스트리밍을 사용합니다. 비디오가 지연되면 네트워크 대역폭을 확인하고 UDP 포트 5004가 차단되지 않았는지 확인하세요. 스트림 설정에서 비트레이트를 조정할 수도 있습니다 (350-25,000 kbps).

모든 원격 기능은 원격 데스크톱 및 스크린샷을 참조하세요.

네트워크 아키텍처 개요

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

다음 단계