문제 해결

이 페이지는 카테고리별로 정리된 일반적인 문제에 대한 해결 방법을 다룹니다.

연결 문제

클라이언트가 서버를 찾을 수 없습니다

증상: 클라이언트에 "서버 검색 중" 또는 "서버를 찾을 수 없음"이 표시됩니다.

해결 방법:

관리 PC에서 HandyCafe Server가 실행 중인지 확인합니다.
두 PC가 동일한 서브넷에 있는지 확인합니다(예: 모두 192.168.1.x).
네트워크 스위치나 라우터에서 mDNS가 차단되지 않았는지 확인합니다.
수동 연결을 시도합니다: 클라이언트 설정에서 서버의 IP 주소를 직접 입력합니다.
다른 소프트웨어가 서버의 TCP 포트(기본값: 5001)를 사용하고 있지 않은지 확인합니다.

클라이언트가 연결되었다가 즉시 연결이 끊어집니다

증상: 클라이언트에 "연결됨"이 잠시 표시된 후 "검색 중"으로 돌아갑니다.

해결 방법:

서버와 클라이언트의 연결 키가 일치하는지 확인합니다. 키는 서버의 설정 > 네트워크에서 설정됩니다.
네트워크 불안정(패킷 손실, 케이블 문제)을 확인합니다.
서버가 라이선스 PC 제한에 도달하지 않았는지 확인합니다.
서버 로그에서 인증 실패 메시지를 확인합니다.

클라이언트가 서버에서 "오프라인"으로 표시되지만 PC는 실행 중입니다

증상: 클라이언트 PC가 켜져 있고 클라이언트 애플리케이션이 실행 중이지만 서버에서 오프라인으로 표시됩니다.

해결 방법:

클라이언트 PC에서 HandyCafe Client가 실제로 실행 중인지 확인합니다(시스템 트레이 확인).
클라이언트 PC의 네트워크 연결을 확인합니다(서버에 핑할 수 있는지?).
방화벽 규칙을 확인합니다: TCP 포트 5001-5003이 서버와 클라이언트 모두에서 열려 있어야 합니다.
해당 PC에서 HandyCafe Client를 재시작합니다.
VLAN을 사용하는 경우 서버와 클라이언트 VLAN 간의 통신이 가능한지 확인합니다.

네트워크 설정 변경 후 연결할 수 없습니다

증상: 포트 또는 연결 키를 변경한 후 클라이언트가 연결되지 않습니다.

해결 방법:

클라이언트가 새 포트 번호와 연결 키로 업데이트되었는지 확인합니다.
네트워크 설정 변경 후 HandyCafe Server를 재시작합니다.
새 포트를 허용하도록 방화벽 규칙을 업데이트합니다.
모든 클라이언트를 새 값으로 재구성해야 합니다.

세션 문제

클라이언트에서 세션을 시작할 수 없습니다

증상: 시작 버튼이 비활성화되어 있거나 시작 작업이 오류와 함께 실패합니다.

해결 방법:

라이선스 상태를 확인합니다. 읽기 전용 모드에서는 새 세션을 시작할 수 없습니다.
클라이언트 상태가 "유휴"인지 확인합니다. 유휴 클라이언트에서만 세션을 시작할 수 있습니다.
캐셔 권한을 확인합니다. 역할에 AUTH_CLIENT_LOGIN 권한이 있어야 합니다.
요금이 구성되어 있는지 확인합니다(설정 > 요금에 유효한 시간당 요금이 있어야 합니다).

세션 타이머가 잘못된 시간을 표시합니다

증상: 표시된 시간이 실제 경과 시간과 일치하지 않습니다.

해결 방법:

서버와 클라이언트 PC의 시스템 시계를 확인합니다. 동기화되어야 합니다(NTP 사용).
세션이 일시 중지된 경우 일시 중지된 기간은 계산에 포함되지 않습니다.
선불 세션의 경우 타이머가 경과 시간이 아닌 잔여 시간을 표시합니다.

세션 비용이 맞지 않는 것 같습니다

증상: 청구된 금액이 예상과 일치하지 않습니다.

해결 방법:

요금 스케줄을 확인합니다. 활성화된 경우 세션이 다른 배율의 여러 요금 슬롯을 통과했을 수 있습니다.
요금 설정을 확인합니다: 기본 시간당 요금, 부가세, 시작 수수료, 반올림.
분석을 위해 거래 세부 정보에서 세션의 요금 구간을 확인합니다.
결제 수단의 수수료와 고정 수수료를 확인합니다.
선불 세션의 경우 "구매 시 잠금" 또는 "라이브 스케줄" 모드가 활성 상태인지 확인합니다.

일시 중지된 세션을 재개할 수 없습니다

증상: 재개 작업이 실패하거나 사용할 수 없습니다.

해결 방법:

클라이언트 PC가 여전히 서버에 연결되어 있는지 확인합니다.
클라이언트 상태가 "일시 중지"(주황색)로 표시되는지 확인합니다.
일시 중지 중에 클라이언트 연결이 끊어진 경우 먼저 재연결해야 할 수 있습니다.

결제 문제

결제 수단이 드롭다운에 없습니다

증상: 세션 또는 주문 마감 시 예상된 결제 수단이 나타나지 않습니다.

해결 방법:

관리 > 결제 수단에 해당 결제 수단이 있는지 확인합니다.
결제 수단이 활성 상태인지 확인합니다(삭제되거나 비활성화되지 않았는지).
캐셔 권한을 확인합니다. 모든 수단을 보려면 PAYMENT_MANAGE가 부여되어야 합니다.

수수료 계산이 맞지 않는 것 같습니다

증상: 차감된 수수료가 예상 비율과 일치하지 않습니다.

해결 방법:

결제 수단의 수수료율(퍼센트)과 고정 수수료를 확인합니다.
수수료 공식: 수수료 = (청구 금액 * 수수료율 / 100) + 고정 수수료.
캐셔가 청구 금액에 수동 재정의를 적용했는지 확인합니다.

클라이언트 표시 문제

클라이언트 대기 화면이 비어 있습니다

증상: 대기 화면에 구성된 슬라이드쇼 대신 아무것도 표시되지 않습니다.

해결 방법:

설정 > 클라이언트 > 대기 화면에서 대기 화면이 활성화되어 있는지 확인합니다.
최소 하나의 미디어 항목(이미지 또는 비디오)이 추가되었는지 확인합니다.
미디어 파일이 유효하고 손상되지 않았는지 확인합니다.
동기화를 실행하여 최신 설정을 클라이언트에 푸시합니다.

클라이언트 메뉴에 앱이 표시되지 않습니다

증상: 앱 런처가 비어 있거나 카테고리가 없습니다.

해결 방법:

설정 > 클라이언트 > 콘텐츠에서 앱과 카테고리가 구성되어 있는지 확인합니다.
카테고리와 앱의 표시가 활성화되어 있는지 확인합니다.
클라이언트가 최신 메뉴 데이터를 수신했는지 확인합니다(변경 사항은 TCP를 통해 자동으로 푸시됩니다).
실시간 동기화가 적용되지 않은 경우 클라이언트를 재시작합니다.

클라이언트 외관 테마가 적용되지 않습니다

증상: 클라이언트가 구성된 테마 대신 기본 외관을 표시합니다.

해결 방법:

설정 > 클라이언트 > 외관에서 테마 설정이 저장되었는지 확인합니다.
클라이언트에 설정 푸시를 실행합니다.
클라이언트 애플리케이션을 재시작합니다.

원격 데스크톱 문제

원격 데스크톱이 느리거나 끊깁니다

증상: 비디오 피드가 지연되거나 끊기거나 프레임 속도가 낮습니다.

해결 방법:

비트레이트를 낮춥니다(표준 LAN 사용의 경우 1000-2000 kbps를 시도합니다).
FPS 설정을 줄입니다.
Wi-Fi 대신 유선 Ethernet을 사용합니다.
다른 애플리케이션의 네트워크 혼잡이나 높은 대역폭 사용을 확인합니다.
UDP 포트 5004가 차단되거나 속도 제한되지 않았는지 확인합니다.

원격 데스크톱이 검은 화면을 표시합니다

증상: 원격 데스크톱 창이 열리지만 검은색만 표시됩니다.

해결 방법:

클라이언트가 온라인이고 응답하는지 확인합니다(먼저 스크린샷을 시도합니다).
UDP 포트 5004가 양방향으로 열려 있는지 확인합니다.
클라이언트의 그래픽 드라이버 업데이트가 필요할 수 있습니다.
키프레임 새로고침을 요청합니다.

원격으로 마우스나 키보드를 제어할 수 없습니다

증상: 원격 화면은 볼 수 있지만 클릭과 키 입력이 반영되지 않습니다.

해결 방법:

원격 관리 포트(TCP 5003)가 열려 있는지 확인합니다.
클라이언트 애플리케이션에 적절한 시스템 권한이 있는지 확인합니다.
일부 전체 화면 게임은 원격 입력을 차단할 수 있습니다.

라이선싱 문제

라이선스가 "offline_grace"를 표시합니다

증상: 라이선스 상태가 카운트다운과 함께 offline_grace를 표시합니다.

해결 방법:

서버 PC의 인터넷 연결을 복구합니다.
DNS 해석을 확인합니다. 서버가 라이선스 서버에 도달할 수 있어야 합니다.
아웃바운드 HTTPS 연결을 차단하는 프록시나 방화벽을 확인합니다.
서버가 잠기기 전까지 72시간의 연결 복구 시간이 있습니다.

라이선스가 "over_limit"를 표시합니다

증상: 라이선스가 허용하는 것보다 많은 클라이언트가 연결되어 있습니다.

해결 방법:

사용하지 않는 유휴 클라이언트의 연결을 끊습니다.
현재 클라이언트 수와 라이선스 제한을 확인합니다.
더 많은 PC 용량을 위해 라이선스를 업그레이드합니다.
참고: 콘솔도 총 PC 제한에 포함됩니다.

라이선스가 "expired" 또는 "revoked"를 표시합니다

증상: 서버가 제한 모드로 전환됩니다.

해결 방법:

라이선스 만료일을 확인합니다.
HandyCafe 웹사이트에서 라이선스를 갱신합니다.
취소된 라이선스의 경우 HandyCafe 지원팀에 문의합니다.

일반 문제

설정 변경이 저장되지 않습니다

증상: 설정에서 벗어나면 변경 사항이 되돌아갑니다.

해결 방법:

변경 후 저장 버튼을 클릭했는지 확인합니다.
유효성 검사 오류(오류 메시지가 강조 표시된 필드)를 확인합니다.
관리자 권한이 있는지 확인합니다.

감사 로그에 항목이 없습니다

증상: 예상된 작업이 로그 페이지에 나타나지 않습니다.

해결 방법:

로그 필터를 확인합니다. 올바른 카테고리와 날짜 범위가 선택되었는지 확인합니다.
LOG_DISPLAY_FULL 권한이 부여되었는지 확인합니다(그렇지 않으면 오늘의 로그만 표시됩니다).
특정 작업을 위해 텍스트 검색 필드를 사용하여 검색합니다.