HandyCafe Docs
it-admin

네트워크 설정

네트워크 설정 카테고리는 HandyCafe 서버와 로컬 네트워크의 모든 클라이언트 PC 간에 사용되는 통신 포트와 인증 키를 구성합니다.

포트

HandyCafe는 다른 유형의 통신을 위해 세 개의 별도 포트를 사용합니다. 모든 포트 값은 1에서 65535 범위 내에 있어야 하며, 서로 충돌하거나 서버에서 실행 중인 다른 서비스와 충돌하지 않아야 합니다.

TCP 포트

  • 기본값: 5001
  • 용도: 서버와 클라이언트 간의 주요 명령 및 응답 통신입니다. 모든 세션 제어 메시지(시작, 종료, 연장), 상태 업데이트, 메뉴 푸시, 구성 동기화가 이 포트를 통해 이루어집니다.
  • 프로토콜: 바이너리 인코딩 및 암호화 인증이 적용된 TCP.

파일 포트

  • 기본값: 5002
  • 용도: 서버와 클라이언트 간의 파일 전송입니다. 동기화 탐색기 기능이 서버에서 클라이언트 PC로 파일(게임 업데이트, 구성 파일, 소프트웨어)을 푸시하는 데 사용됩니다.
  • 프로토콜: TCP 기반 청크 파일 전송.

UDP 포트

  • 기본값: 5004
  • 용도: 원격 데스크톱 기능을 위한 화면 스트리밍입니다. 관리자가 서버 콘솔에서 클라이언트 화면을 볼 때 비디오 프레임이 이 포트를 통해 전송됩니다.
  • 프로토콜: 낮은 지연 시간의 실시간 스트리밍을 위한 UDP.

연결 키

연결 키는 암호화 인증에 사용되는 공유 비밀 비밀번호입니다. 서버와 클라이언트 간의 모든 메시지는 이 키로 서명되어 무단 기기가 네트워크에 참여하는 것을 방지합니다.

  • 모든 클라이언트 PC는 서버와 동일한 연결 키로 구성되어야 합니다.
  • 서버에서 연결 키를 변경하면 일치하도록 모든 클라이언트의 구성을 업데이트해야 합니다. 키가 일치하지 않는 클라이언트는 인증에 실패하고 서버 콘솔에 나타나지 않습니다.
  • 강력하고 고유한 키를 사용하십시오. 기본값이나 쉽게 추측할 수 있는 값은 피합니다.

중요 사항

포트 또는 연결 키를 변경하려면 양쪽 모두에서 조치가 필요합니다.

  1. 서버의 네트워크 설정에서 값을 업데이트하고 저장합니다.
  2. HandyCafe 서버 애플리케이션을 재시작합니다.
  3. 모든 클라이언트의 구성에서 해당 값을 업데이트합니다.
  4. 각 PC에서 클라이언트 애플리케이션을 재시작합니다.

방화벽 규칙: 네트워크 방화벽(서버의 OS 방화벽과 하드웨어 방화벽 모두)이 구성된 세 개 포트 모두에서 인바운드 및 아웃바운드 트래픽을 허용하는지 확인합니다. 차단된 포트는 클라이언트의 연결 또는 스트리밍을 방해합니다.

LAN 요구 사항: 서버와 모든 클라이언트 PC는 동일한 근거리 통신망(LAN)에 있어야 합니다. HandyCafe는 클라이언트 탐색에 mDNS를 사용하며, 이는 단일 브로드캐스트 도메인 내에서 작동합니다. 다른 서브넷이나 VLAN에 있는 클라이언트는 추가 네트워크 구성 없이는 탐색되지 않을 수 있습니다.