Skip to content

ko USER GUIDE

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


사용자 가이드

VD Dropbear는 root 기기에 비공개 SSH 서버를 제공합니다. 이 가이드는 설치부터, 파일 전송과 첫 잠금 해제 전(BFU) 모드를 포함해, 동작하는 연결까지 안내합니다.

로그인은 기본적으로 완전한 root 셸입니다. 비밀번호보다 키를 우선하고, 신뢰하는 네트워크에만 바인드하며, 이유 없이 포트를 개방된 인터넷에 노출하지 마십시오.

1. 설치

KernelSU, APatch 또는 Magisk 매니저에서 모듈 zip을 플래시하고(또는 셸에서 ksud module install / apd module install 로), 이어서 모듈의 WebUI 를 엽니다.

2. 키 추가(권장)

WebUI의 Authorized keys 에서 공개 키(ssh-ed25519 AAAA... you@host)를 붙여넣고 Add key 를 누릅니다. 키가 기본이자 가장 안전한 진입 방법입니다.

아직 키가 없다면, 컴퓨터에서 키를 생성하려면:

ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub     # paste this into the WebUI

3. 또는 비밀번호 설정

비밀번호 로그인은 기본적으로 꺼져 있습니다(로그인은 기본적으로 root이므로 키가 권장됩니다). 켜려면 설정에서 Password login 을 켜고, 이어서 Password accounts 에서 로그인 사용자의 비밀번호를 설정합니다. 해시는 브라우저에서 PBKDF2로 계산되며, 비밀번호 자체는 페이지를 떠나지 않습니다.

4. 포트와 수신 위치 선택

Settings 에서 Port 를 설정하고 바인드를 선택합니다. 기본적으로 VD Dropbear는 loopback 에서만 수신합니다; LAN이나 VPN에서 접근하려면 원하는 인터페이스를 켜십시오. 노출을 이해하지 못한다면 Listen on all interfaces 는 피하십시오.

적용하려면 Save & restart 를 누르고, 아직 실행 중이 아니면 Start 를 누르십시오.

5. 연결

ssh -p 2222 root@<device-ip>
sftp -P 2222 root@<device-ip>
scp -P 2222 file root@<device-ip>:/sdcard/
rsync -e 'ssh -p 2222' -av ./dir/ root@<device-ip>:/sdcard/dir/

sftp-server, scp, rsync 가 함께 제공되므로 SFTP, sshfs, GUI 클라이언트, 백업이 모두 같은 연결로 동작합니다.

USB로 연결하기 (wifi 없이, ADB 없이)

네트워크를 전혀 거치지 않고 더 빠르고 안정적으로 전송하려면 USB 테더링을 사용해 USB 케이블로 데몬에 접속하세요. ADB나 USB 디버깅은 필요 없습니다:

  1. 케이블을 연결한 뒤 휴대폰에서 USB 테더링을 켭니다 (설정 -> 네트워크 -> 핫스팟 및 테더링).
  2. 휴대폰이 USB 전용의 작은 네트워크에 들어가며, 보통 192.168.42.129입니다.
  3. 위의 4단계에서 그 주소를 특정 바인드(LISTEN_ADDRESSES)에 추가하고 모든 인터페이스는 꺼 두면, 데몬이 케이블로만 응답합니다.

그런 다음 무선 주소 대신 USB 주소로 접속하세요:

ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/

192.168.42.129이 기기의 주소가 아니면 ip addr로 휴대폰의 USB 인터페이스를 확인하세요.

6. 첫 잠금 해제 전(BFU)

기본적으로 데몬은 기기를 한 번 잠금 해제한 뒤(AFU)에만 시작합니다. 시크릿이 자격 증명 암호화 저장소에 있기 때문입니다. 첫 잠금 해제 전 에 SSH가 필요하다면(예를 들어 재부팅 후 기기를 원격으로 잠금 해제하기 위해) Start before first unlock (BFU) 를 켜십시오. 그러면 시크릿이 기기 암호화 저장소로 옮겨져 잠금 해제 전에 읽을 수 있게 됩니다: 의도적이고 문서화된 트레이드오프입니다. README의 Security model 을 참고하십시오.

7. 데몬 제어

  • WebUI: Start / Stop / Restart, 그리고 실시간 상태(실행 여부, PID, 포트, 모드, 호스트 키 지문).
  • 매니저 Action 버튼: 데몬을 (재)실행합니다.
  • 부팅 시 자동으로도 시작됩니다(비활성화하지 않는 한).

문제 해결

  • 시작되지 않음. /data/adb/vddropbear/state/daemon.log 를 확인하십시오. Enabled 가 켜져 있고 호스트 키가 생성될 수 있었는지 확인하십시오.
  • 키 거부됨. 공개 키 줄이 클라이언트가 제시하는 것과 정확히 같은지, 그리고 로그인하는 사용자명이 시스템이 해석하는 것(보통 root)인지 확인하십시오.
  • 다른 기기에서 연결할 수 없음. 아마 아직 루프백에만 바인드되어 있을 것입니다. 필요한 인터페이스를 켜고 재시작하십시오.
  • SFTP/scp는 실패하지만 셸은 동작함. 함께 제공되는 sftp-server 가 여러분의 ABI용으로 배포되었는지 확인하십시오; WebUI 상태에 감지된 ABI가 표시됩니다.

이 문서는 Claude (Anthropic)로 생성되었으며 VD171이 유지 관리합니다. 수정 및 개선을 환영합니다. CONTRIBUTING.md를 참조하세요.

Clone this wiki locally