문제 해결

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

연결 문제

클라이언트가 서버를 찾을 수 없음

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

해결책:

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

클라이언트가 연결 후 즉시 연결 해제됨

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

해결책:

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

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

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

해결책:

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

네트워크 설정 변경 후 연결할 수 없음

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

해결책:

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

세션 문제

클라이언트에서 세션을 시작할 수 없음

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

해결책:

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

세션 타이머가 잘못된 시간을 표시함

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

해결책:

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

세션 비용이 잘못된 것 같음

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

해결책:

가격 일정표를 확인하세요. 활성화된 경우, 세션이 다른 배수의 여러 가격 슬롯을 통과했을 수 있습니다.
가격 설정을 검토하세요: 기본 시간당 요금, 부가세, 시작 요금, 반올림.
거래 내역에서 세션의 가격 세그먼트를 확인하여 세부 내역을 확인하세요.
결제 방법의 수수료 및 고정 요금을 확인하세요.
선불 세션의 경우, "구매 시 고정" 또는 "실시간 일정" 모드가 활성화되어 있는지 확인하세요.

일시 중지된 세션을 재개할 수 없음

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

해결책:

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

결제 문제

결제 방법이 드롭다운에 없음

증상: 세션이나 주문을 마감할 때 예상되는 결제 방법이 나타나지 않습니다.

해결책:

관리 > 결제 방법에서 결제 방법이 존재하는지 확인하세요.
결제 방법이 활성 상태인지 확인하세요 (삭제되거나 비활성화되지 않음).
캐셔 권한을 확인하세요. PAYMENT_MANAGE 권한이 있어야 모든 방법을 볼 수 있습니다.

수수료 계산이 잘못된 것 같음

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

해결책:

결제 방법의 수수료 비율(백분율) 및 고정 요금을 확인하세요.
수수료 공식: 수수료 = (청구된 금액 * 수수료 비율 / 100) + 고정 요금.
캐셔가 청구된 금액에 수동으로 조정한 것이 있는지 확인하세요.

클라이언트 디스플레이 문제

클라이언트 대기 화면이 빈 화면임

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

해결책:

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

클라이언트 메뉴에 앱이 표시되지 않음

증상: 앱 실행기가 비어 있거나 카테고리가 없습니다.

해결책:

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

클라이언트 외관 테마가 적용되지 않음

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

해결책:

설정 > 클라이언트 > 외관에서 테마 설정이 저장되었는지 확인하세요.
클라이언트에 설정 푸시를 트리거하세요.
클라이언트 애플리케이션을 다시 시작하세요.

원격 데스크톱 문제

원격 데스크톱이 느리거나 끊김

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

해결책:

비트레이트를 낮추세요 (표준 LAN 사용을 위해 1000-2000 kbps 시도).
FPS 설정을 줄이세요.
WiFi 대신 유선 이더넷을 사용하세요.
네트워크 혼잡이나 다른 애플리케이션의 높은 대역폭 사용을 확인하세요.
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 권한이 부여되었는지 확인하세요 (그렇지 않으면 오늘의 로그만 표시됨).
특정 작업에 대해 텍스트 검색 필드를 사용하여 검색하세요.