터널 닥터 (Tunnel Doctor)

무엇을 해주나

macOS에서 Tailscale과 프록시/VPN 도구(Shadowrocket, Clash, Surge, OrbStack/Docker)가 동시에 켜져 있을 때 발생하는 네트워크 장애를 계층별로 분해해 진단합니다.

• 5개 충돌 계층 구분: 라우팅 테이블 하이재킹, http_proxy 환경변수, 시스템 프록시(브라우저 503), SSH ProxyCommand 이중 터널, VM/컨테이너 프록시 전파
• 증상 → 단계 매핑표: "tailscale ping은 되는데 SSH만 타임아웃", "브라우저는 503인데 curl은 200", "git push만 간헐적 실패", "docker build의 apk add가 즉시 Connection refused" 등을 해당 해결 단계로 바로 연결
• TUN 계측 오염 경고: TUN이 켜진 상태에서 nc -z가 0.00초로 뜨거나 ping RTT가 비정상적으로 낮게 나오는 것처럼, 신뢰할 수 없는 측정값을 구분해 잘못된 가설로 빠지지 않게 합니다.
• DNS 계열 함정 처리: 198.18.x.x 페이크 IP 하이재킹, nslookup은 즉시인데 ssh/curl이 60초 멈추는 리졸버 스톨, DIRECT 경로만 전부 깨지는 split-brain 상황
• scripts/quick_diagnose.py 자동 점검 스크립트로 프록시 예외·TLS 신뢰·경로 소유권을 한 번에 확인

이런 분께 추천

• Tailscale로 원격 개발 서버(맥미니, WSL 박스)에 접속하면서 프록시 도구도 상시 켜두는 개발자
• 중국·회사망 등 프록시가 필수인 환경에서 Docker/OrbStack 빌드가 자주 깨지는 분
• "어제는 됐는데 오늘 안 되는" 네트워크 문제를 감이 아니라 근거로 좁혀 나가고 싶은 분
• Tailscale SSH를 WSL에 붙이려다 kex_exchange_identification 같은 에러에 막힌 분

활용 예시

1. 브라우저만 503: curl은 200인데 브라우저에서 Tailscale IP가 503 → 스킬이 Layer 3(시스템 프록시)로 판정하고 Shadowrocket [General]의 skip-proxy에 100.64.0.0/10 추가를 안내합니다.
2. git push만 실패: ssh -T git@github.com은 성공하지만 push에서 failed to begin relaying via HTTP → SSH ProxyCommand 이중 터널로 진단, ProxyCommand=none 검증 후 ssh.github.com:443 구성으로 전환.
3. docker build 실패: 호스트 curl은 되는데 RUN apk add가 0.2초 만에 Connection refused → OrbStack 투명 프록시 + TUN 충돌로 판정하고 --network host 또는 docker.json에 host.internal 프록시 설정을 제시합니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 tunnel-doctor 폴더를 내 ~/.claude/skills/tunnel-doctor/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.