증상을 이렇게 나눠 적어 두면 빨라집니다

Windows 11에서 Clash·Mihomo 계열 클라이언트는 켜져 있고, 같은 PC의 브라우저로는 구독·규칙이 기대대로 동작합니다. 그런데 WSL2(Ubuntu 등) 터미널로 들어가면 sudo apt update가 특정 미러에서만 멈추거나, git clone·curl이 프록시를 전혀 타지 않는 것처럼 보입니다. 또 다른 패턴은 HTTP는 되는데 이름 해석만 이상하게 실패해 패키지 목록조차 못 받는 경우입니다. 둘 다 흔하고, 원인 후보가 겹치기 때문에 DNS와 프록시를 한 세트로 생각하는 편이 수습이 빠릅니다.

이 글의 전제는 간단합니다. Windows 호스트에서 Clash가 이미 리스닝하고 있고, 사용자는 WSL2 셸에서 그 경로로 트래픽을 넘기고 싶다는 것입니다. Hyper-V 가상 스위치 뒤에 있는 WSL2는 기본 설정에서 127.0.0.1이 Windows의 루프백과 같지 않으므로, 브라우저에서 잘 되던 http://127.0.0.1:7890 같은 주소를 그대로 복사해 오면 실패하는 일이 반복됩니다. 아래 순서는 재부팅 후에도 다시 적용하기 쉽게, 확인 명령과 설정 위치를 묶어 두었습니다.

왜 WSL2만 Clash와 엇갈릴까

WSL2는 경량 VM에 가까운 자체 네트워크 인터페이스를 가집니다. Windows 쪽 TUN 모드가 시스템 트래픽을 잘 가로채도, WSL2가 만든 소켓이 항상 같은 경로로 나간다고 가정하면 안 됩니다. 그래서 실무에서는 (1) WSL2가 Windows 호스트의 LAN 주소로 HTTP·SOCKS 포트에 붙는 방식, (2) Windows에서 포트를 열어 WSL2 대역으로 포워딩하는 방식, (3) 비교적 최신 빌드에서 선택 가능한 네트워킹 모드 변경을 동시에 알아 두는 것이 안전합니다. TUN과의 관계는 TUN 모드 가이드와 함께 읽으면 큰 그림이 잡힙니다.

Windows 11의 일부 채널에서는 WSL의 mirrored 네트워킹 옵션을 켜 localhost 공유를 단순화할 수 있습니다. 그러나 조직 정책·빌드·배포판마다 기본값이 다르므로, 이 글에서는 가장 널리 쓰이는 NAT형 WSL2를 기준으로 설명하고, mirrored를 쓰는 경우 어떤 단계가 생략될 수 있는지만 곁다리로 적습니다. 핵심은 항상 「지금 이 배포판에서 127.0.0.1이 무엇을 가리키는가」를 먼저 확인하는 것입니다.

1단계: WSL2에서 Windows 호스트 IP 확인하기

가장 무난한 방법 중 하나는 기본 게이트웨이를 읽는 것입니다. Ubuntu 계열에서 아래와 비슷한 한 줄이 자주 쓰입니다. ip 출력에서 기본 경로의 next hop이 Windows 호스트 쪽 가상 어댑터를 가리키는지 확인하세요.

ip route show | grep -i default | awk '{ print $3}' | head -n1

또 다른 관행은 /etc/resolv.conf 안의 nameserver 줄을 읽는 것입니다. WSL이 자동 생성하는 경우가 많아, 그 값이 Windows 호스트를 가리키는지 확인한 뒤 프록시 URL을 만들면 됩니다. 다만 systemd 기반 배포판이나 사용자 정의 resolv.conf가 끼어 있으면 이 가정이 깨질 수 있으니, 위 ip route 결과와 교차 검증하는 습관이 좋습니다.

호스트 IP 문자열을 변수로 고정해 두면 이후 단계가 편합니다. 예를 들어 export WIN_HOST=$(ip route show | grep -i default | awk '{ print $3}' | head -n1)처럼 셸에 저장하고, mixed 포트가 7890이라면 http://$WIN_HOST:7890 형태로 이어갑니다. 포트 번호는 실제 Clash 프로필의 mixed-port·port·socks-port와 반드시 일치해야 합니다.

2단계: Windows 측 Clash에서 LAN·바인딩 점검

WSL2 가상 NIC는 Windows 입장에서 「다른 기기에서 오는 연결」과 유사하게 취급될 수 있습니다. Clash가 127.0.0.1에만 바인딩되어 있으면 호스트 IP로 들어오는 SYN을 받지 못합니다. 클라이언트 설정에서 Allow LAN 또는 이에 상응하는 옵션을 켜고, 필요하면 바인딩 주소를 0.0.0.0으로 두는 방식을 검토하세요. 보안 측면에서는 공용 와이파이처럼 신뢰할 수 없는 네트워크에서 LAN 허용을 켜는 것은 위험할 수 있으니, 사용 환경을 구분하는 것이 좋습니다.

Windows 방화벽이 Clash 실행 파일이나 해당 포트에 대한 인바운드를 막고 있으면 WSL2에서도 타임아웃이 납니다. 제어판이나 고급 보안이 포함된 Windows Defender 방화벽에서 인바운드 규칙을 확인하고, 테스트할 때만 잠시 차단을 풀어 원인 분리를 하는 방법도 있습니다. UWP 루프백 예외처럼 다른 Windows 특수 케이스는 UWP 루프백 글에서 다루는 축과 겹치지 않지만, 같은 PC에서 여러 정책이 겹칠 수 있다는 점은 기억해 두세요.

3단계: netsh 포트 프록시가 필요한 경우

Clash를 127.0.0.1에만 붙여 두고 싶거나, 특정 빌드 조합에서 LAN 바인딩이 기대와 다를 때는 Windows에서 포트 프록시로 우회할 수 있습니다. 관리자 권한 PowerShell 또는 CMD에서 netsh interface portproxy로 외부 인터페이스의 포트를 로컬 루프백의 Clash 포트로 넘깁니다. 조직마다 그룹 정책으로 막혀 있을 수 있으니, 명령이 실패하면 IT 정책을 먼저 확인하세요.

예시는 환경마다 주소가 달라지므로 그대로 복사하기보다, netsh interface portproxy show all로 현재 표를 확인하고 추가·삭제하는 흐름을 익히는 편이 낫습니다. 재부팅 후에도 유지되는지, 업데이트 후 초기화되는지는 환경에 따라 다르므로, 팀 위키에 「WSL2 프록시 복구 체크리스트」를 남겨 두면 재발 대응이 빨라집니다.

4단계: WSL2 셸 환경 변수와 git

브라우저와 달리 apt·curl·대부분의 CLI는 Windows 시스템 프록시를 자동으로 물려받지 않습니다. http_proxy·https_proxy·필요 시 all_proxy를 소문자·대문자 쌍으로 맞춰 두면 호환성이 좋습니다. Clash mixed 포트가 HTTP와 SOCKS를 함께 받는다면 export http_proxy=http://$WIN_HOST:7890 형태가 전형적입니다. SOCKS만 쓸 때는 socks5h://처럼 스킴을 명시해야 하는 도구도 있으니, 한 번에 모든 변수를 뭉뚱그리기보다 실패하는 명령 하나를 골라 최소 설정으로 검증하세요.

Git은 git config --global http.proxy 등 저장된 값이 환경 변수보다 우선할 때가 있습니다. 오래된 회사 프록시가 남아 있으면 증상이 꼬이므로, git config --global --get http.proxy로 확인하고 필요 없으면 비웁니다. SSH 원격은 HTTP CONNECT와 다른 경로이므로, git이 SSH를 쓰는 경우 프록시 환경 변수만으로는 설명이 안 되는 「안 되는 것」이 남을 수 있습니다. macOS 터미널에서 같은 환경 변수 축을 다룬 macOS 터미널 가이드와 대조해 보면, 플랫폼만 다르고 디버깅 순서는 상당 부분 공유됩니다.

영구 반영은 ~/.bashrc·~/.zshrc 등에 넣되, 호스트 IP가 바뀌는 환경이라면 로그인 때마다 다시 계산하는 작은 함수로 감싸 두는 편이 덜 깨집니다. CI나 컨테이너 내부까지 같은 패턴을 확장할지는 별도 결정이지만, 「WSL2 세션 한정」이라는 주석을 남기면 이후 자신에게도 도움이 됩니다.

5단계: WSL2 DNS와 Clash DNS를 동시에 보기

프록시는 통과하는데 apt만 이상하다면 DNS 쪽을 의심합니다. WSL2는 /etc/resolv.conf가 자동 생성되는 경우가 많고, Windows 쪽 DNS 클라이언트·회사 VPN·보안 에이전트가 끼면 해석 결과가 CLI에서만 달라지는 일이 생깁니다. 테스트로 공인 DNS를 잠시 지정해 보거나, systemd-resolve·resolvectl 상태를 출력해 현재 스택을 확인하세요.

Clash 쪽에서 fake-ip나 도메인 규칙을 쓰는 경우, Windows 호스트에서 Clash가 제공하는 DNS 리스너를 WSL2가 질의할 수 있어야 합니다. 이 때도 마찬가지로 호스트 IP + 허용된 포트 조합이 전제입니다. redir-host·fake-ip 선택과 캐시 동작은 프로필 전체와 연결되므로, 로그에서 어떤 도메인이 어떤 정책에 맞았는지부터 확인하는 것이 빠릅니다. DNS 전용 이슈를 규칙만으로 때려 맞추려 하면 시간이 길어지기 쉽습니다.

IPv6만 우선 시도했다가 이상하게 실패하는 사례도 있으니, 임시로 IPv4 우선이나 IPv6 비활성 테스트를 해 볼 가치가 있습니다. 조직 정책과 충돌할 수 있으니 장기 설정으로 고정하기 전에 네트워크 관리자와 합의하는 것이 안전합니다.

6단계: 짧은 검증 시나리오

설정 후에는 세 가지만 빠르게 확인합니다. 첫째, WSL2에서 curl -I로 프록시를 경유해야 하는 HTTPS 엔드포인트에 연결이 되는지. 둘째, 같은 셸에서 env | grep -i proxy로 기대한 문자열이 있는지. 셋째, sudo apt update가 동일 네트워크 조건에서 재현되는지입니다. 한 단계만 실패하면 어느 축(방화벽·바인딩·DNS·환경 변수)을 다시 볼지 바로 갈립니다.

문제가 간헐적이라면 Windows 측 Clash를 재시작한 직후와 WSL2를 wsl --shutdown 후 재기동한 직후를 비교해 보세요. 가상 스위치와 NAT 테이블이 엇갈리면 재시작 한 번으로 사라지는 증상이 나올 수 있습니다.

흔한 실수 메모

첫째, Windows 브라우저에서 검증한 127.0.0.1 주소를 WSL2에 그대로 복사하는 일입니다. 둘째, mixed 포트와 SOCKS 포트를 혼동해 http_proxy에 잘못된 스킴을 넣는 일입니다. 셋째, LAN 허용은 켰지만 방화벽에서 여전히 막는 일입니다. 넷째, git·npm·pip 등 도구별 별도 프록시 설정이 남아 충돌하는 일입니다. 다섯째, 회사 VPN이 켜진 상태에서만 재현되는지 여부를 기록하지 않아 나중에 같은 토론을 반복하는 일입니다.

네트워크 프록시 도구는 합법적인 개인정보 보호·개발·원격 업무에 활용될 수 있지만, 관할 법령·서비스 약관·고용 계약을 위반하는 용도로 사용해서는 안 됩니다. 회사 장비에서는 IT 정책을 따르세요.
오픈소스 코어와 GUI는 GitHub 등에서 이슈와 릴리스 노트를 확인할 수 있습니다. 설치 패키지를 받는 주 경로는 본 사이트 다운로드 페이지를 우선 참고하고, 라이선스·기여 방법은 저장소를 별도로 열람하는 편이 혼선이 적습니다.

정리

WSL2가 Windows Clash를 「안 탄다」는 말은 대부분 루프백 해석 차이, LAN 바인딩·방화벽, 포트 프록시 필요 여부, 리졸버·프로필 DNS, 셸 환경 변수와 도구별 설정이 한데 얽힌 결과입니다. 위 순서대로 호스트 IP를 구하고 Windows 측에서 포트를 실제로 열었는지 확인한 뒤, WSL2에서 프록시 URL과 DNS 질의를 각각 검증하면 재현 조건을 짧게 적어 두기 좋습니다. 네트워킹 모드가 바뀌거나 Clash 클라이언트를 갈아타면 포트 번호와 LAN 옵션도 같이 바뀌므로, 팀 단위로는 포트·LAN·DNS 값을 한 페이지에 모아 두면 온보딩 비용이 줄어듭니다.

장기적으로는 Mihomo 기반 클라이언트 하나로 코어와 포트 정책을 통일하고, 규칙·DNS 설계는 문서 허브의 고급 파트와 함께 정리해 두는 편이 운영 부담을 줄이는 경우가 많습니다. 브라우저만 쓸 때와 WSL2 개발을 같이 할 때는 요구되는 네트워크 축이 달라지므로, 둘 다에서 같은 로그 패턴을 볼 수 있게 점검 순서를 맞춰 두면 이후 트러블슈팅이 한결 수월해집니다.

Windows와 Linux가 한 머신에 공존하는 환경에서 Clash는 여전히 손에 익으면 규칙 기반 제어와 안정성 면에서 체감 차이가 큰 편입니다. 무료로 클라이언트를 받아 위 순서대로만 다시 맞춰 보아도, apt와 git이 동시에 살아나는 경우가 많습니다.

→ Clash를 무료로 내려받고 WSL2·Windows 워크플로를 같이 정리해 보기