HandyCafe Docs
owner it-admin

시스템 요구사항

인터넷 카페, 게이밍 센터 또는 e스포츠 아레나에 HandyCafe를 설치하기 전에 하드웨어와 네트워크가 다음 요구사항을 충족하는지 확인합니다.

서버 PC 요구사항

서버는 관리 스테이션입니다. HandyCafe Server를 실행하여 카페 전체를 모니터링하고 제어하는 PC입니다.

구성 요소 최소 권장
운영 체제 Windows 10+ (64비트), macOS 12 Monterey+, 또는 Linux (64비트) Windows 10/11 (64비트), macOS 12+, 또는 Linux (64비트)
프로세서 듀얼 코어 2.0 GHz 쿼드 코어 2.5 GHz+
RAM 4 GB 8 GB+
디스크 공간 500 MB (애플리케이션) 2 GB+ (녹화 및 스크린샷 포함)
디스플레이 1280 x 720 1920 x 1080+
네트워크 100 Mbps Ethernet 기가비트 Ethernet

참고: 세션 녹화와 함께 원격 데스크톱을 사용하는 경우 MP4 녹화 파일을 위한 추가 디스크 공간을 할당합니다(품질에 따라 녹화 시간당 약 50-200 MB).

Linux 참고: HandyCafe는 Linux에서 WebKit2GTK를 사용하는 Tauri v2로 빌드됩니다. 애플리케이션을 실행하기 전에 libwebkit2gtk-4.1 런타임 패키지를 설치해야 합니다. 지원되는 배포판에는 Ubuntu 22.04+, Fedora 38+, 동등한 버전의 WebKit2GTK를 제공하는 기타 배포판이 포함됩니다.

클라이언트 PC 요구사항

고객 대면 PC 각각은 로컬 네트워크를 통해 서버에 연결되는 HandyCafe Client를 실행합니다.

구성 요소 최소 권장
운영 체제 Windows 10+ (64비트), macOS 12 Monterey+, 또는 Linux (64비트) Windows 10/11 (64비트), macOS 12+, 또는 Linux (64비트)
프로세서 듀얼 코어 1.5 GHz 쿼드 코어 2.0 GHz+
RAM 2 GB 4 GB+
디스크 공간 200 MB 500 MB+
네트워크 100 Mbps Ethernet 기가비트 Ethernet

참고: 이것은 HandyCafe Client 소프트웨어만을 위한 요구사항입니다. 고객이 사용하는 게임과 애플리케이션을 위한 추가 리소스가 필요합니다.

네트워크 요구사항

모든 PC(서버 및 클라이언트)는 동일한 근거리 통신망(LAN)에 있어야 합니다.

필요 포트

포트 프로토콜 방향 용도
5001 TCP 서버: 인바운드, 클라이언트: 아웃바운드 명령 및 응답 통신
5002 TCP 양방향 파일 전송
5003 TCP 서버: 인바운드, 클라이언트: 아웃바운드 원격 관리 제어 채널
5004 UDP 양방향 화면 스트리밍(원격 데스크톱)

중요: 이것은 기본 포트입니다. 네트워크 설정에서 변경할 수 있습니다. 서버에서 포트를 변경하면 클라이언트 구성도 일치하도록 업데이트합니다.

방화벽 설정

  • Windows 방화벽: HandyCafe는 설치 중에 자동으로 방화벽 규칙을 추가합니다. 자동 구성이 실패하면 위에 나열된 포트에 대한 인바운드 규칙을 수동으로 추가합니다.
  • macOS 방화벽: 시스템 설정 > 네트워크 > 방화벽을 열고 HandyCafe에 대한 수신 연결을 허용합니다. 또는 위에 나열된 포트를 방화벽 허용 목록에 추가합니다.
  • Linux (iptables / ufw): ufw를 사용하는 경우 sudo ufw allow 5001:5004/tcpsudo ufw allow 5004/udp를 실행합니다. iptables를 직접 사용하는 경우 TCP 포트 5001-5003과 UDP 포트 5004에 대한 동등한 INPUT ACCEPT 규칙을 추가합니다.
  • 타사 방화벽: 서버 PC의 HandyCafe 서버 바이너리와 클라이언트 PC의 HandyCafe 클라이언트 바이너리에 대한 예외를 추가합니다.
  • 라우터/스위치: LAN 전용 운영에는 특별한 구성이 필요하지 않습니다. VLAN을 사용하는 경우 서버와 모든 클라이언트가 동일한 VLAN에 있거나 라우팅이 필요한 포트를 허용하는지 확인합니다.

클라이언트 검색

HandyCafe는 로컬 네트워크에서 자동 클라이언트 탐색을 위해 mDNS(멀티캐스트 DNS)를 사용합니다. 이를 위해 다음이 필요합니다.

  • 모든 PC가 동일한 서브넷에 있어야 합니다
  • 스위치나 라우터에서 멀티캐스트 트래픽이 차단되지 않아야 합니다
  • mDNS가 작동하지 않는 경우(예: 서브넷이 다른 경우) 클라이언트가 서버의 IP 주소를 수동으로 입력하여 연결할 수 있습니다

대역폭 고려사항

기능 대략적인 대역폭
일반 작동 (클라이언트당) < 1 Kbps
원격 데스크톱 스트리밍 350 - 25,000 Kbps (구성 가능)
파일 동기화 전송 네트워크 속도에 의해 제한
스크린샷 캡처 스크린샷당 약 100 KB

20-50대 PC를 보유한 일반적인 카페의 경우 표준 100 Mbps LAN이면 충분합니다. 여러 PC에 대해 원격 데스크톱을 자주 사용하는 경우 기가비트 Ethernet을 권장합니다.

콘솔 요구사항

게임 콘솔(PlayStation, Xbox 등)을 관리하는 경우 콘솔은 서버와 동일한 네트워크에 있어야 합니다. 각 콘솔은 MAC 주소로 식별되며 콘솔 설정에서 수동으로 등록됩니다.