📡 강의 홈 › Module 9
💚

Module 9: 헬스체크 + 트러블슈팅

시스템이 정상인지 진단하고, 문제가 생겼을 때 해결하는 방법

⏱️ 10분 🔍 자가진단 도구 🛠️ 문제해결 9가지

1 헬스체크 실행

healthcheck.py가 시스템 5가지 핵심 조건을 자동 검사합니다.

$ 헬스체크 실행
# 5개 DoD 조건 검사
python3 ~/termux-bridge/healthcheck.py

헬스체크 DoD (Definition of Done) 조건 5개:

🔄
C1: autossh 단일 PID
autossh 프로세스가 정확히 1개만 실행 중인가
pgrep -a autossh
🔌
C2: SSH 터널 포트 LISTEN
:2222 포트가 열려서 WSL 연결을 기다리는가
ss -tlnp | grep 2222
⚙️
C3: MCP API 서버 LISTEN
:8787 포트에서 MCP 서버가 실행 중인가
ss -tlnp | grep 8787
📱
C4: 폰 위젯 모델 확인
폰 위젯 2번(wsl_aider)에 deepseek-chat 모델이 포함되어 있는가
ssh -p 8022 폰IP "cat ~/.shortcuts/2.wsl_aider.sh \| grep deepseek"
📦
C5: 5개 레포 dirty == 0
DiffSinger, OrbitPrompt, phoneparis, dtslib-cloud-appstore, termux-bridge 미커밋 0
git -C ~/repo status --porcelain

2 0번 위젯: 인스톨러 + 헬스체크

Module 2의 0번 위젯(Setup)이 통합 헬스체크를 제공합니다.

$ 0.setup.sh 실행
# 위젯 0번 — 헬스체크 후 인스톨러 실행 선택
bash ~/.shortcuts/0.setup.sh

0번 위젯이 확인하는 항목:

3 문제 해결: 상황별 진단

자주 발생하는 문제와 해결 방법

❌ WSL에 SSH 접속 안 됨

1. Windows에서 WSL 실행 중인지 확인
2. WSL에서 sudo service ssh start
3. Tailscale 연결 확인: tailscale status
4. 위젯 1번이 자동으로 WSL 깨우기 시도 (최대 90초 대기)

❌ ADB 연결 끊김

1. adb revive.sh all 실행 (자동 복구)
2. 폰 개발자 옵션 → 무선 디버깅 ON 확인
3. 폰 Wi-Fi 연결 확인
4. 위젯 8번 다시 실행

❌ DeepSeek API 오류

1. API 키 유효성 확인: cat ~/__d_.env
2. DeepSeek 계정 잔액 확인: platform.deepseek.com
3. API 키 재발급 후 source ~/.bashrc
4. ds 실행 시 glibc proot 로딩 10~15초 대기

❌ Tailscale 연결 안 됨

1. 모든 장치에서 Tailscale 실행 확인
2. 같은 계정으로 로그인되었는지 확인
3. tailscale ping 100.x.x.x로 통신 테스트
4. 폰/태블릿 IP 파일 업데이트: echo "새IP" > ~/.phone_ip

❌ RustDesk 연결 안 됨

1. PC에서 RustDesk 실행 확인
2. PC RustDesk 비밀번호 확인 (설정에서 영구 비밀번호 권장)
3. 위젯 5번 실행 → 자동 복구 시도
4. PC 상태 확인: ssh pc ~/bin/check-rustdesk.sh

❌ pip / npm 설치 실패

1. Termux 저장소 업데이트: pkg update
2. proot Ubuntu 업데이트: proot-distro login ubuntu -- apt update
3. 저장소 변경: termux-change-repo
4. 재시도: pip install aider-chat

❌ 위젯 안 보임

1. INSTALL.sh 실행했는지 확인
2. Termux:Widget 앱 설치 확인 (F-Droid)
3. 홈화면에서 위젯 다시 추가
4. ls ~/.shortcuts/에 스크립트 있는지 확인

❌ proot Ubuntu 실행 안 됨

1. proot-distro 설치 확인: which proot-distro
2. Ubuntu 설치 확인: proot-distro info ubuntu
3. 재설치: proot-distro remove ubuntu && proot-distro install ubuntu

❌ MCP 서버 오류

1. 포트 충돌 확인: ss -tlnp | grep 8787
2. 의존성 설치: pip install mcp httpx
3. 수동 실행 테스트: python3 ~/termux-bridge/mcp_server.py

4 자주 쓰는 진단 명령어

$ 전체 헬스체크
# 5개 DoD 조건 한 번에 검사
python3 ~/termux-bridge/healthcheck.py
$ Tailscale 상태
# 연결된 장치 목록과 IP
tailscale status
$ ADB 연결 확인
# 연결된 ADB 장치
adb devices
$ tmux 세션 확인
# 실행 중인 tmux 세션 목록
tmux ls
$ 위젯 목록 확인
# 설치된 위젯 스크립트 목록
ls ~/.shortcuts/

5 전체 재설치

처음부터 다시 설치해야 한다면?

원클릭 재설치
# 최신 버전으로 재설치
cd ~/termux-bridge && git pull && bash go.sh
Module 1: Baptism (초보자)
# 처음부터 다시
curl -fsSL https://raw.githubusercontent.com/dtslib1979/termux-bridge/main/install/baptism/baptism.sh | bash
Module 3: AI 에이전트 재설치
# DeepSeek + Aider 재설치
bash ~/termux-bridge/install/install-agent.sh --api-key "sk-..."

🩺 건강 체크 완료!

← 이전: TTS 다음: Termius CPR → 📡 강의 홈