Clash 시스템 프록시가 작동하지 않을 때: 브라우저 확장 프로그램 충돌과 터미널 환경 변수 점검
Clash 시스템 프록시가 작동하지 않나요? 브라우저 확장 프로그램과 시스템 설정, 터미널의 http_proxy 변수 및 명령줄 도구 설정을 점검하세요.
먼저 로컬 프록시 포트를 테스트한 뒤 앱 설정을 확인하세요
클라이언트의 ‘시스템 프록시’ 옵션은 운영체제의 프록시 설정을 변경합니다. 모든 프로세스의 연결을 Clash로 보내는 기능은 아닙니다. 문제를 점검할 때는 연결을 두 단계로 나눠 보세요. 앱이 로컬 프록시 인바운드에 연결되는지, 요청이 코어에 들어온 뒤 어떤 아웃바운드로 전달되는지 확인합니다. 브라우저에서 페이지가 열리지 않거나, 터미널 명령이 시간 초과되거나, 출구 IP가 바뀌지 않는 문제는 각각 다른 단계에서 발생할 수 있습니다.
먼저 클라이언트의 포트 설정에서 현재 리슨 포트를 확인하세요. 아래에서는 mihomo의 mixed-port: 7890을 예로 듭니다. 이 포트는 HTTP와 SOCKS 프록시 요청을 모두 받습니다. 7890은 예시일 뿐, 모든 클라이언트의 기본값은 아닙니다. 설정에서 port와 socks-port를 따로 사용한다면 아래 명령에는 HTTP 인바운드인 port 값을 사용하세요. 컨트롤 인터페이스인 external-controller의 포트를 입력하면 안 됩니다.
curl -v --connect-timeout 5 --max-time 15 --noproxy "" --proxy http://127.0.0.1:7890 https://example.com/
Windows에서는 curl.exe를 사용하는 것이 좋습니다. 구버전 Windows PowerShell에서는 curl이 별칭으로 처리될 수 있습니다. 또한 외부 프로그램에 전달된 빈 문자열 인수가 제거될 수 있습니다. 명령에서 인수 오류가 나면 명령 프롬프트에서 실행하고, 맨 앞에 curl.exe를 입력하세요. 여기서 --noproxy ""는 이번 테스트에 상속된 프록시 우회 목록을 비우는 옵션입니다.
127.0.0.1:7890에 연결하자마자 거부된다면 먼저 코어 프로세스와 리슨 포트를 확인하고, 명령을 실행하는 환경이 클라이언트와 같은 네트워크인지 살펴보세요. 호스트와 컨테이너는 각각 별도의 루프백 주소를 사용합니다.- 상세 출력에 로컬 포트 연결과
CONNECT example.com:443요청이 표시되면 이번 요청이 HTTP 프록시에 도달한 것입니다. 이후 실패는 단계별로 확인하세요. CONNECT 단계에서 실패하면 코어 로그를 살펴보고, 터널 연결 후 인증서 검증에 실패하면 시계, 인증서 체인, 네트워크 중간 장비를 점검하세요. 문제를 가리기 위해 인증서 검증을 끄지 마세요. - 요청이 성공하면 클라이언트의 연결 기록에서 대상 도메인과 아웃바운드를 확인하세요.
DIRECT에 매칭됐더라도 요청은 프록시 인바운드를 거친 것입니다. 코어가 직접 연결하도록 결정한 것뿐이므로 출구 IP가 그대로라고 해서 시스템 프록시가 작동하지 않는다고 단정할 수 없습니다.
브라우저: 프록시 확장 프로그램부터 점검하고 시스템 주소 확인
프록시 설정은 한 곳에서만 관리하세요
Chrome에서는 chrome://extensions/, Edge에서는 edge://extensions/를 여세요. 프록시 전환, 도메인별 연결 경로 지정, PAC 설정을 담당하는 확장 프로그램을 먼저 일시 중지합니다. 확장 프로그램의 ‘직접 연결’은 보통 연결을 직접 연결로 지정하는 옵션이며, ‘시스템 설정 사용’과는 다릅니다. 확장 프로그램을 계속 사용하려면 시스템 프록시 모드를 선택하고 다른 확장 프로그램이 설정을 함께 관리하지 않는지 확인하세요.
테스트할 때 대상 페이지를 새로고침하고 클라이언트 연결 기록에 새 요청이 남는지 확인하세요. 이전 연결이 재사용되지 않도록 브라우저를 완전히 종료한 뒤 다시 실행하는 것도 좋습니다. 시크릿 창만으로 확장 프로그램이 제외됐다고 판단하지 마세요. 일부 확장 프로그램은 시크릿 모드에서도 실행되며, 기기 정책은 창을 바꿔도 적용됩니다. 설정에 ‘조직에서 관리’라고 표시되면 chrome://policy/ 또는 edge://policy/에서 적용 중인 정책을 확인하세요. 관리 기기는 관리자에게 문의하세요.
운영체제와 Firefox의 별도 설정 확인
- Windows 11: ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 여세요. ‘수동 프록시 설정’의 주소와 포트를 확인합니다. 설정 스크립트가 켜져 있거나 대상 도메인이 예외 목록에 있다면 해당 조건도 기록해 두세요. 특정 도메인만 연결되지 않는다면 클라이언트를 다시 설치하기 전에 예외 목록부터 확인하는 편이 좋습니다.
- macOS: ‘시스템 설정’ → ‘네트워크’ → 현재 연결된 서비스 → ‘세부사항’ → ‘프록시’를 여세요. 해당 서비스의 웹 프록시, 보안 웹 프록시, 자동 프록시 구성, 우회 목록을 확인합니다. Wi-Fi와 유선 네트워크를 전환했다면 이전 서비스의 설정을 현재 설정으로 착각하지 않도록 주의하세요.
- Firefox: ‘설정’ → ‘일반’ → ‘네트워크 설정’ → ‘설정…’을 여세요. 시스템 프록시를 확인하려면 ‘시스템 프록시 설정 사용’을 선택합니다. ‘수동 프록시 설정’이나 ‘자동 프록시 구성 URL’을 선택했다면 해당 설정의 주소, 스크립트, 예외 항목을 확인해야 합니다. 시스템 프록시 옵션만 확인해서는 안 됩니다.
시스템 주소를 입력하자마자 원래 값으로 돌아간다면 옵션을 켜기 전후의 값을 기록하고, 다른 프록시 클라이언트나 네트워크 관리 프로그램, 조직 정책이 값을 변경하는지 확인하세요. 먼저 설정을 변경하는 주체를 찾으세요. 여러 클라이언트를 동시에 켜 둔 채 규칙 모드를 계속 바꾸지 마세요.
터미널: 기본 요청과 프록시를 명시한 요청 비교
브라우저는 정상인데 터미널에서 실패한다면, 같은 터미널과 같은 대상에 위의 프록시 명시 명령을 실행한 뒤 curl -v https://example.com/도 실행해 보세요. 프록시 명시 요청은 성공하지만 기본 요청이 대상 주소에 직접 연결된다면 도구가 환경 변수를 읽는 방식을 우선 확인하세요. 다음은 POSIX 셸에서 임시로 설정하는 방법입니다. 현재 셸과 이후 실행되는 하위 프로세스에만 적용됩니다.
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
curl -v https://example.com/
대상 URL은 HTTPS지만 프록시 주소는 http://로 시작합니다. 앞부분은 대상에 접속할 때 사용하는 프로토콜이고, 뒷부분은 로컬 프록시에 연결할 때 사용하는 프로토콜입니다. curl은 HTTP 요청에 소문자 http_proxy를 사용하고, HTTPS 요청에는 대문자 HTTPS_PROXY도 지원합니다. 대소문자 버전을 모두 설정한 적이 있다면 두 값이 일치하는지 확인하세요. 도구마다 값이 충돌할 때 같은 쪽을 선택한다고 가정하지 마세요.
$env:http_proxy = 'http://127.0.0.1:7890'
$env:https_proxy = 'http://127.0.0.1:7890'
curl.exe -v https://example.com/
위 내용은 Windows PowerShell에서 현재 프로세스에 설정하는 방법입니다. 이미 실행 중인 IDE, 백그라운드 서비스, 컨테이너, 다른 터미널에는 변경 사항이 적용되지 않습니다. 터미널의 curl은 정상인데 IDE에서 가져오기가 계속 실패한다면 실제 작업을 실행하는 환경의 프록시 설정을 확인하세요. Git을 사용한다면 git config --show-origin --get-all http.proxy로 별도 설정이 있는지, 어느 파일에서 가져온 설정인지 확인할 수 있습니다. 계정이나 비밀번호가 포함된 프록시 변수 또는 전체 로그를 공개 게시물에 그대로 올리지 마세요.
특정 도메인만 연결되지 않을 때: 우회 목록과 코어 규칙 구분
no_proxy 또는 NO_PROXY는 앱 쪽에서 적용됩니다. 예를 들어 curl이 localhost,127.0.0.1,example.com을 읽으면 example.com 요청은 설정된 프록시를 우회합니다. 같은 URL로 일반 요청과 --noproxy ""를 지정한 테스트를 비교하세요. 일반 요청만 로컬 포트를 건너뛴다면 환경 변수와 도구 자체의 예외 설정을 확인합니다. 도메인 하나의 문제를 해결하려고 회사 내부망 우회 목록을 계속 비워 두지 마세요.
코어 규칙은 요청이 Clash에 들어온 뒤 적용됩니다. 연결 기록에서 요청 시간, 도메인, 매칭된 규칙, 아웃바운드 경로를 함께 확인하세요. DIRECT에 매칭됐다면 해당 규칙이 예상한 규칙보다 앞에 있는지 살펴보세요. 프록시 정책 그룹에 매칭됐지만 연결이 실패한다면 그룹에서 현재 선택된 항목과 해당 아웃바운드의 연결 상태를 확인하세요. 규칙 모드에서는 보통 목록 순서대로 매칭하므로 범위가 지나치게 넓은 규칙을 위쪽에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다.
수정 후 재테스트: 같은 대상으로 두 경로 확인
- 확인한 로컬 포트는 그대로 두고 문제가 있었던 URL을 하나 선택하세요. 브라우저에서는 평소 설정으로 접속하고, 터미널에서는
--proxy없이 명령을 실행합니다. 두 요청 모두 클라이언트 연결 기록과 대조하세요. 페이지가 열리는지만 확인해서는 안 됩니다. - 브라우저 기록만 없다면 확장 프로그램, 정책, 시스템 스크립트, 브라우저 예외 설정을 다시 확인하세요. 터미널 기록만 없다면 환경 변수, 도구 설정, 프로세스 실행 위치를 점검하세요. 두 요청 모두 기록이 있다면 아웃바운드나 대상 서비스에서 원인을 찾으세요.
- 임시 테스트 터미널을 닫으면 이번에 설정한 환경 변수를 버릴 수 있습니다. 영구 설정을 변경했다면 기록해 둔 내용을 참고해 불필요한 변경을 되돌리세요. 실제로 사용하는 터미널과 브라우저를 다시 열어 테스트하고, 오래된 창에 의존하지 않아도 문제가 해결됐는지 확인하세요.
재테스트 후에도 실패하면 운영체제, 클라이언트와 코어 버전, 인바운드 유형과 포트, 실패 단계가 로컬 연결·CONNECT·TLS·대상 응답 중 어디인지 기록하세요. 설정 항목의 의미는 설정 항목 문서에서 확인할 수 있습니다. 도움을 요청할 때 이 정보를 함께 제공하면 ‘켜도 연결이 안 돼요’라고만 설명하는 것보다 문제를 파악하기 쉽습니다.