먼저 Clash 로컬 프록시 포트를 확인하세요

클라이언트의 ‘시스템 프록시’ 스위치는 대개 로컬 프록시 주소를 운영체제 설정에 등록합니다. 브라우저가 이 설정을 사용할 수도 있지만, 확장 프로그램이나 수동 설정, 관리 정책이 대신 적용될 수도 있습니다. 명령줄 도구는 각기 다른 설정을 참조하므로, 브라우저에서 접속되더라도 같은 컴퓨터의 터미널이 동일한 포트를 사용한다는 보장은 없습니다.

  1. 먼저 클라이언트에 표시된 커널 실행 상태와 현재 포트를 확인하세요. Clash 또는 mihomo 커널을 사용하는 클라이언트에서 mixed-port는 HTTP와 SOCKS 연결을 모두 받는 혼합 포트입니다. port는 HTTP 프록시 포트이고, socks-port는 SOCKS 프록시 포트입니다. 아래 예시는 HTTP 또는 혼합 포트 7890을 기준으로 합니다. 실행 화면에 7897이 표시된다면 명령어의 포트도 바꿔 주세요.
  2. 주소는 127.0.0.1을 사용하세요. 단, 클라이언트와 테스트 프로그램이 같은 시스템 환경에서 실행 중이어야 합니다. 컨트롤러 포트(예: 9090)를 프록시 포트로 착각하지 마세요. WSL, 가상 머신, 컨테이너의 127.0.0.1은 호스트에 연결되지 않을 수 있으니, 먼저 호스트 터미널에서 연결을 확인한 다음 각각 문제를 살펴보세요.
  3. 클라이언트의 연결 기록이나 로그를 열고 테스트 요청을 다시 보내세요. 대상 도메인이 표시되면 어떤 규칙에 일치했는지, 최종적으로 DIRECT로 연결됐는지 프록시 노드를 거쳤는지 확인합니다. 규칙 모드에서 DIRECT에 일치했다는 것은 해당 요청이 Clash를 통해 직접 연결됐다는 뜻이지, 앱이 Clash를 사용하지 않았다는 뜻은 아닙니다.

브라우저에서 프록시가 작동하지 않을 때: 시스템 주소, 확장 프로그램, 예외 목록 확인

클라이언트 스위치가 켜져 있는지만 보지 말고 시스템 프록시 주소를 확인하세요

  • Windows 11: ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’로 이동해 ‘수동 프록시 설정’에서 ‘프록시 서버 사용’의 주소와 포트가 클라이언트 설정과 일치하는지 확인하세요. ‘설정 스크립트 사용’도 켜져 있다면 회사나 기관에서 배포한 설정인지 먼저 확인하고, 바로 삭제하지 마세요.
  • macOS 13 이상: ‘시스템 설정’ → ‘네트워크’ → 현재 사용하는 네트워크 서비스 선택 → ‘세부사항’ → ‘프록시’로 이동하세요. Wi-Fi와 유선 네트워크 설정은 따로 확인해야 합니다. HTTP와 HTTPS에 해당하는 프록시 항목을 확인하고, 테스트할 도메인이 프록시 우회 목록에 있는지도 살펴보세요.
  • Firefox: ‘설정’ → ‘일반’ → 페이지 아래쪽의 ‘네트워크 설정’ → ‘설정’을 선택하세요. 운영체제 설정을 따르려면 ‘시스템 프록시 설정 사용’이 선택되어 있는지 확인하세요. ‘프록시 사용 안 함’, 이전 수동 주소 또는 다른 자동 프록시 설정이 선택되어 있지 않은지도 살펴보세요.

같은 주소로 테스트해 설정이 덮어쓰인 위치를 찾으세요

Chrome의 chrome://extensions/ 또는 Edge의 edge://extensions/에서 직접 설치한 프록시 전환 확장 프로그램을 일시 중지한 뒤 새 탭에서 https://example.com/에 접속하고, 해당 시점의 Clash 연결 기록과 비교하세요. 시크릿 창으로 대신 테스트하지 마세요. 시크릿 모드에서 허용된 확장 프로그램은 계속 작동할 수 있습니다. 브라우저에 조직에서 관리한다고 표시되면 chrome://policy/ 또는 edge://policy/에서 프록시 정책을 확인하세요. 관리되는 설정은 관리자에게 문의해야 합니다.

특정 웹사이트에서만 문제가 생긴다면 해당 도메인으로 다시 테스트하세요. 메인 페이지, 로그인 리디렉션, 이미지가 서로 다른 도메인에서 제공될 수 있으므로 연결 기록에서 실패한 요청을 찾아야 합니다. 대상이 기록에 있으면 규칙의 연결 대상과 노드 오류를 먼저 확인하세요. 기록에 없다면 시스템 예외 목록, 브라우저 프록시 설정, 페이지가 캐시에서만 로드된 것은 아닌지 살펴보세요.

터미널에서 프록시가 작동하지 않을 때: curl에 프록시를 지정해 비교하세요

아래 두 명령은 같은 HTTPS 주소를 요청합니다. 첫 번째는 curl이 프록시를 사용하지 않게 하고, 두 번째는 로컬 HTTP 프록시에 직접 연결합니다. 기존 NO_PROXY=* 설정 때문에 프록시를 우회하지 않도록 이번 요청의 예외 주소는 로컬 주소 두 개로 제한했습니다. 두 명령 모두 연결 시간 제한은 8초, 전체 실행 시간 제한은 15초입니다. Windows PowerShell에서는 이전 버전이 curl을 다른 명령으로 해석하지 않도록 curl.exe라고 입력하세요.

curl --noproxy "*" -v -I --connect-timeout 8 --max-time 15 https://example.com/
curl --proxy http://127.0.0.1:7890 --noproxy "localhost,127.0.0.1" -v -I --connect-timeout 8 --max-time 15 https://example.com/
두 번째 명령의 결과다음 단계
127.0.0.1:7890 연결이 거부됨커널이 실행 중인지, 포트를 잘못 입력하지 않았는지, 터미널과 커널이 같은 시스템 환경에 있는지 확인하세요. 아직 대상 웹사이트에는 연결되지 않은 상태입니다.
로컬 포트에 연결됐지만 CONNECT 실패HTTP 또는 혼합 포트를 사용 중인지 확인한 다음 Clash 로그에서 규칙, 노드 연결, 대상 주소 해석 오류를 살펴보세요.
CONNECT가 성립된 뒤 TLS 오류 발생터널 연결 성공과 대상 사이트의 인증서 검증 성공은 별개입니다. 시스템 시간, 대상 도메인, 도구의 인증서 신뢰 설정을 확인하세요. 인증서 검증을 끄는 것은 해결 방법이 아닙니다.
대상 사이트에서 HTTP 응답을 받음이번 요청에는 명시적 프록시가 사용됐습니다. 연결 기록에서 프록시 노드를 거쳤는지 DIRECT로 연결됐는지 확인하세요. 두 명령이 모두 성공하는 것도 정상일 수 있습니다.

실제 설정에 SOCKS 포트만 열려 있다면(예: 1080), 두 번째 명령의 프록시 옵션을 --proxy socks5h://127.0.0.1:1080로 바꿀 수 있습니다. 그러면 curl이 대상 호스트 이름 해석을 SOCKS 프록시에 맡깁니다. 같은 포트에서 프로토콜을 번갈아 바꿔 가며 시험하지 말고, 먼저 해당 포트가 어떤 항목에 설정됐는지 확인하세요.

명시적 프록시가 작동하면 환경 변수와 도구 설정을 확인하세요

--proxy를 지정하면 작동하고 빼면 실패하는 경우, 먼저 도구가 어떤 설정을 읽는지 확인하세요. curl에서는 현재 터미널에 http_proxy와 https_proxy를 임시로 설정할 수 있습니다. 변수 이름은 대상 URL의 프로토콜에 따라 다릅니다. HTTPS 사이트에 접속하더라도 로컬 프록시가 HTTP라면 변수 값은 http://로 시작해야 합니다. curl은 HTTP 대상에 소문자 http_proxy만 사용합니다. 대소문자를 구분하는 시스템에서는 HTTP_PROXY만 설정하지 마세요.

Bash 또는 zsh: 명령 한 번에만 변수 전달

http_proxy=http://127.0.0.1:7890 \
https_proxy=http://127.0.0.1:7890 \
no_proxy=localhost,127.0.0.1 \
curl -v -I --connect-timeout 8 --max-time 15 https://example.com/

PowerShell: 새 창에서 임시로 설정

$env:http_proxy = 'http://127.0.0.1:7890'
>$env:https_proxy = 'http://127.0.0.1:7890'
>$env:no_proxy = 'localhost,127.0.0.1'
>curl.exe -v -I --connect-timeout 8 --max-time 15 https://example.com/

PowerShell 설정은 현재 프로세스와 이후 실행되는 하위 프로세스에만 적용됩니다. 테스트가 끝나면 테스트 창을 닫으세요. curl은 작동하지만 Git이나 npm이 실패한다면 도구에 이전 주소가 저장돼 있는지 확인하세요. Git에서는 git config --show-origin --get-regexp '^http\..*proxy$'로 설정 출처를 확인할 수 있습니다. npm에서는 npm config get proxy와 npm config get https-proxy를 각각 실행하세요. 출력에 프록시 인증 정보가 포함될 수 있으니 공개 질문 게시물에 그대로 붙여 넣지 마세요.

편집기의 통합 터미널에서만 실패한다면 먼저 별도의 터미널에서 같은 테스트를 해 보세요. 이미 실행 중인 편집기는 다른 창에서 임시로 설정한 변수를 자동으로 받지 않습니다. 실제 명령을 실행하는 터미널에서 설정하거나, 영구 설정을 변경한 뒤 편집기를 다시 시작하세요. 먼저 임시 설정으로 확인한 후 시작 파일에 저장할지 결정하세요. 클라이언트를 종료한 뒤에도 도구가 연결할 수 없는 로컬 포트를 계속 찾는 상황을 방지할 수 있습니다.

시스템 프록시와 터미널을 확인한 뒤 TUN을 살펴볼 때

브라우저와 --proxy를 지정한 curl은 모두 Clash를 거치지만, 특정 프로그램에 프록시 옵션이 없고 시스템 프록시나 환경 변수도 사용하지 않는 경우에만 클라이언트의 TUN 지원을 확인해 보세요. TUN은 시스템 라우팅 계층에서 트래픽을 처리하며, 적용 범위는 커널, 권한, 라우팅 및 DNS 설정에 따라 달라집니다. 로컬 포트 연결 실패, 잘못된 규칙 대상, 노드 연결 시간 초과를 해결하는 스위치는 아닙니다.

마무리하기 전에 처음 실패했던 프로그램과 도메인만 다시 테스트해 요청이 Clash에 전달되는지, 최종 연결 경로가 예상과 일치하는지 확인하세요. 추가로 도움을 요청할 때는 운영체제, 클라이언트 및 커널 버전, 실제 포트와 프로토콜, 실패한 curl 명령, 해당 시점의 규칙 또는 오류 메시지를 기록하세요. 구독 주소와 인증 정보를 제거한 뒤 공유하면 ‘시스템 프록시가 켜져 있음’이라는 스크린샷보다 문제를 찾는 데 훨씬 유용합니다.