도움말

연결이 안 될 때

상대 기기가 오프라인으로 보입니다

받는 쪽 Kitedesk가 실행 중인지, 화면에 ID가 표시되는지 먼저 확인하세요. ID가 안 보이면 서버에 등록되지 않은 상태입니다. 인터넷 연결과 방화벽을 확인해 주세요.

비밀번호가 틀렸다고 나옵니다

일회용 비밀번호는 세션이 끝나거나 앱을 다시 켜면 바뀝니다. 받는 쪽 화면에 지금 표시된 값을 다시 확인하세요.

연결은 되는데 화면이 안 보입니다

Android가 받는 쪽이면 화면 녹화 동의 다이얼로그를 수락했는지 확인하세요. 이 다이얼로그는 Android가 매번 띄우는 것이라 건너뛸 수 없습니다.

연결이 느립니다

직접 연결(P2P)이 안 되어 중계 서버를 거치는 중일 수 있습니다. 양쪽 네트워크가 엄격한 NAT 뒤에 있으면 흔히 생깁니다. 같은 네트워크 안에 있다면 보통 직접 연결됩니다.

원격에서 키보드가 안 먹힙니다 (Android)

접근성 서비스가 꺼져 있을 가능성이 큽니다. 받는 쪽 앱의 화면 공유 탭에서 입력 제어를 켜고, 시스템 설정에서 접근성 → Kitedesk Input → 사용을 확인하세요. 켠 뒤에는 세션을 다시 연결해야 적용됩니다.

한글이 자모로 분리되어 입력됩니다

모바일에서 원격 기기로 한글을 보낼 때 생기던 문제로, 1.4.9-4에서 조합 처리를 고쳤습니다. 최신 버전으로 업데이트해 주세요.

데스크톱에서 원격으로 한글을 보내는 경우는 아직 제약이 있습니다. 운영체제 단에서 키 입력을 가로채는 방식이라 입력기(IME)의 조합 결과가 전달되지 않습니다. 개선 작업 중입니다.

단축키가 원격으로 넘어갑니다

대부분의 키는 원격으로 전달되는 게 정상입니다. 예외적으로 툴바 위치 순환(Ctrl+Shift+F12)처럼 내 화면에서만 처리되는 키가 몇 개 있습니다.

Android에서 파일 목록이 안 보입니다

저장소 접근 권한이 필요합니다. 파일 전송에 처음 들어갈 때 시스템이 물어보며, 거부했다면 앱 설정에서 다시 허용해야 합니다.

전송이 멈춘 것 같습니다

1.4.9-4부터 진행률과 전송량이 표시됩니다. 그 이전 버전은 속도만 보여줘서 멈춘 것처럼 보였습니다.

한글 파일 이름이 깨집니다

macOS와 다른 운영체제 사이에서 한글 자모가 분리되어 보이는 경우가 있습니다. 알려진 문제이고 수정 예정입니다.

개인키는 어디에 저장되나요

Android Keystore(iOS는 Keychain)에만 저장됩니다. 앱 데이터나 일반 파일, 로그 어디에도 남지 않습니다.

호스트 키 지문이 바뀌었다며 접속을 거부합니다

서버의 호스트 키가 실제로 바뀌었거나(서버 재설치 등), 중간자 공격일 수 있습니다. 서버 관리자에게 확인한 뒤 접속하세요. 지금은 저장된 지문을 앱에서 지우는 기능이 없어, 정당한 키 교체라면 앱 데이터를 초기화해야 합니다.

자체 서버를 쓸 수 있나요

네. 설정에서 ID 서버 주소와 공개키를 지정하면 됩니다. 서버는 오픈소스인 hbbs·hbbr을 그대로 쓰므로 직접 운영할 수 있습니다.

통신 내용이 서버에 남나요

남지 않습니다. 서버는 두 기기를 서로 찾게 해주고, 직접 연결이 안 될 때만 암호화된 데이터를 중계합니다. 내용은 종단 간 암호화되어 서버가 열어볼 수 없습니다.

문제를 제보하려면

현재 검증된 공개 이슈 접수 채널은 준비 중입니다. 존재하지 않는 접수 링크를 대신 표시하지 않으며, 공식 채널이 열리면 이 문서와 지원 센터에 함께 공지합니다.

RustDesk와 무슨 관계인가요

Kitedesk는 오픈소스 원격 데스크톱 프로그램인 RustDesk를 기반으로 만든 독립 포크입니다. RustDesk 프로젝트와 제휴하거나 승인받지 않았으며, 별개의 프로젝트로 개발됩니다. 원본과 마찬가지로 AGPL-3.0 라이선스이며 전체 소스를 공개합니다.