연결 문제 해결

먼저 이 두 가지를 실행하세요.

droidline doctor
droidline serve --verbose

doctor는 서버가 응답하는지, 포트가 비어 있는지, 폰이 페어링됐는지, PC에 네트워크 주소가 있는지 확인합니다. --verbose는 거부된 핸드셰이크를 포함해 모든 접속 시도를 로그로 남깁니다.

앱이 와이파이에서 PC를 찾지 못함

• Windows 방화벽에서 개인 네트워크에 대해 droidline을 허용하고, 와이파이가 개인 네트워크로 설정되어 있는지 확인하세요.
• 게스트 네트워크와 일부 메시 공유기는 클라이언트를 격리합니다. 메인 네트워크를 쓰거나, 대신 QR 코드를 스캔하세요.
• 폰과 PC가 서로 다른 서브넷에 있다면 PC 주소가 들어 있는 QR 코드로 페어링하세요.

페어링 코드가 거부됨

PAIRING_FAILED는 그 코드로 기다리는 폰이 없다는 뜻입니다. 코드는 5분 뒤 만료됩니다. 이 Wi-Fi에서 페어링을 다시 눌러 새 코드를 받으세요. QR 코드는 10분 동안 폰 한 대에만 유효합니다. 새 QR 코드가 필요하면 droidline pair를 다시 실행하세요.

앱에 PC가 거부했다고 나옴

PC가 이 폰을 더 이상 모르는 상태입니다. 보통 droidline revoke로 폰을 지웠거나, 서버 폴더를 지우거나 옮긴 경우입니다. 폰을 다시 페어링하세요.

폰이 자꾸 끊김

• 배터리 최적화: 앱을 제한 없음으로 설정하고, 제조사별 절전 앱이나 자동 실행 목록이 있다면 거기서도 허용하세요.
• 신호가 약한 모바일 데이터에서는 재접속이 잦습니다. 정상이며, 명령이 두 번 실행되지는 않습니다.
• 와이파이에서는 되는데 밖에서 안 된다면 폰에 아직 원격 주소가 없는 것입니다. 주소를 설정한 뒤 와이파이로 한 번 접속시키거나, 다시 페어링하세요.

포트포워딩이 안 됨

• 회선이 CGNAT(carrier-grade NAT) 뒤에 있을 수 있습니다. 터널이나 릴레이를 쓰세요.
• tls.crt를 지웠다면 인증서가 바뀌었으므로 폰이 거부합니다. 폰을 다시 페어링하세요.

릴레이 문제

증상	원인
서버 로그에 릴레이가 보낸 401이 보임	릴레이의 RELAY_TOKEN과 droidline relay set에 넘긴 토큰이 다름
Workers 릴레이가 503을 반환	RELAY_TOKEN 시크릿을 아직 설정하지 않음
폰을 릴레이로 페어링할 때 409	그 폰이 이미 자기 티켓으로 접속해 있음. 정상 동작
폰이 코드 4008로 끊김	초당 50줄을 넘김. 앱을 업데이트하세요

터널 주소가 바뀜

빠른 터널은 시작할 때마다 새 주소를 받습니다. remote.addresses를 고치고 서버를 다시 시작한 뒤 폰을 와이파이로 한 번 접속시키세요. 아니면 호스트 이름이 고정된 이름 있는 터널(named tunnel)을 쓰세요.