문제 해결

Clash for Windows 자주 묻는 질문과 문제 해결

구독 가져오기부터 프록시 모드, TUN, DNS, UWP 루프백까지 문제 증상에 따라 원인을 찾을 수 있습니다. 각 답변에는 바로 실행할 수 있는 점검 순서가 정리되어 있습니다.

Basics

기본 이해

클라이언트, 구독, 설정, 프록시 모드의 관계를 먼저 파악한 뒤 이전할지 설정을 조정할지 결정하세요.

Clash for Windows 지원이 종료된 후에도 계속 사용할 수 있나요?

이미 설치된 Clash for Windows는 대체로 기존 설정을 불러오고 프록시 트래픽을 처리할 수 있습니다. 하지만 원 프로젝트의 유지 관리가 중단되었으므로 기능 업데이트와 버그 수정은 더 이상 제공되지 않습니다. 현재 환경에서 안정적으로 작동한다면 설정을 백업한 뒤 계속 사용할 수 있습니다. 새 운영체제 호환성, 코어 업데이트 또는 TUN 지원 문제가 발생하면 계속 관리되는 Clash Plus, Clash Verge Rev, FlClash 같은 그래픽 클라이언트로 전환하는 편이 좋습니다. 마이그레이션할 때는 보통 구독을 다시 가져오면 되며, 기존 설정 폴더를 직접 덮어쓰지 마세요.

규칙 모드, 전역 모드, 직접 연결 모드는 어떻게 다른가요?

규칙 모드는 설정의 rules를 순서대로 매칭해 도메인이나 IP를 지정된 정책 그룹으로 전달하므로 일반적인 사용에 적합합니다. 전역 모드는 프록시 가능한 대부분의 트래픽을 GLOBAL 정책으로 보내 규칙 때문에 접속 문제가 생겼는지 임시로 확인할 때 유용합니다. 직접 연결 모드는 프록시를 우회하므로 로컬 네트워크를 복구하거나 비교 테스트를 할 때 사용합니다. 모드를 바꿔도 구독 내용은 수정되지 않지만 트래픽의 출구가 즉시 바뀌므로, 문제 해결 후에는 원래 모드로 되돌려야 합니다.

구독, 설정 파일, 노드는 어떤 관계인가요?

구독 주소는 설정 내용을 업데이트하는 원본이며, 클라이언트는 이를 통해 YAML 설정을 가져옵니다. 설정 파일에는 노드뿐 아니라 정책 그룹, 분할 라우팅 규칙, DNS 및 포트 설정도 포함될 수 있습니다. 노드는 그중 프록시 서버에 연결하는 구성 요소입니다. 구독을 업데이트하면 원격 내용으로 로컬 설정이 갱신되므로 수동으로 변경한 내용이 업데이트 후 덮어써질 수 있습니다. 장기간 유지해야 하는 로컬 규칙은 클라이언트의 오버라이드 기능을 사용하거나 별도의 로컬 설정으로 관리하는 것이 좋습니다.

Windows 사용자는 어떤 Clash 클라이언트를 선택해야 하나요?

깔끔한 그래픽 인터페이스와 자주 쓰는 설정 메뉴가 필요하다면 먼저 Clash Plus를 살펴보세요. Mihomo 기능과 규칙 관리가 더 폭넓게 필요하다면 Clash Verge Rev를 비교해 볼 수 있습니다. 여러 데스크톱 운영체제에서 함께 사용하려면 FlClash도 고려할 만합니다. 기존 Clash for Windows는 인터페이스에 익숙하고 이전 설정을 유지해야 하는 사용자에게 더 적합합니다. 선택하기 전에 시스템 아키텍처와 설치 패키지 유형을 확인하고, 다운로드 페이지에서 해당 클라이언트 항목으로 이동하세요.

Setup

설치 및 설정

구독 가져오기, 설정 활성화, 시스템 프록시, Windows 앱 루프백 등 처음 설정할 때 발생하는 문제를 다룹니다.

구독 주소를 가져오지 못하거나 요청 오류가 표시되면 어떻게 해야 하나요?

먼저 구독 주소를 브라우저에 붙여 넣어 접속되는지 확인하고, 복사 과정에서 공백·줄바꿈·끝의 문장 부호가 포함되지 않았는지 점검하세요. 브라우저에서도 열리지 않는다면 구독 만료 여부, 남은 트래픽, 서버의 일시적인 장애를 확인해야 합니다. 브라우저에서는 열리지만 클라이언트에서 실패한다면 시스템 프록시를 끈 뒤 다시 시도하거나 클라이언트에서 구독 업데이트에 사용할 프록시 방식을 변경해 보세요. 구독 웹페이지 주소나 사용자 센터 주소를 실제 설정 구독 주소와 혼동하지 마세요.

구독 업데이트가 성공했는데 노드가 보이지 않는 이유는 무엇인가요?

먼저 현재 활성화된 설정이 방금 업데이트한 파일인지, 목록의 다른 오래된 설정이 아닌지 확인하세요. 그런 다음 정책 그룹에 선택 가능한 항목이 있는지 살펴보고 설정 내용에 proxies 또는 proxy-providers가 존재하는지 확인합니다. 일부 구독은 웹페이지 안내, 로그인 페이지 또는 오류 메시지를 반환하므로 클라이언트가 다운로드는 완료해도 노드를 파싱하지 못할 수 있습니다. 문제가 있는 설정을 삭제한 뒤 다시 가져오세요. 설정이 원격 provider에 의존한다면 provider도 수동으로 업데이트하고 로그에서 다운로드 또는 파싱 오류를 확인해야 합니다.

시스템 프록시를 켰는데도 브라우저가 계속 직접 연결되면 어떻게 해야 하나요?

먼저 Clash 코어가 실행 중인지 확인하고 HTTP 또는 혼합 포트가 다른 프로그램에서 사용 중이지 않은지 점검하세요. 이후 Windows 프록시 설정에서 수동 프록시가 로컬 주소와 클라이언트에 표시된 포트를 가리키는지 확인합니다. 일부 브라우저, 다운로드 도구, 개발 프로그램은 자체 프록시 설정을 사용하므로 시스템 프록시를 읽지 않을 수 있습니다. 앱에서 시스템 프록시 사용을 선택하거나 주소를 직접 입력해야 합니다. 프록시 확장 프로그램을 사용 중이라면 시스템 프록시와 중복으로 요청을 가로채지 않도록 설정하세요.

Microsoft Store 앱이 프록시를 사용하지 못할 때 Clash UWP 루프백은 어떻게 설정하나요?

Windows UWP 앱은 기본적으로 로컬 프록시 포트에 접근하지 못할 수 있으므로 브라우저가 정상이라고 해서 스토어 앱도 연결된다는 뜻은 아닙니다. 관리자 권한으로 클라이언트에서 제공하는 UWP Loopback 도구를 열고 프록시가 필요한 앱을 선택한 뒤 저장한 다음 해당 앱을 다시 시작하세요. 문제 해결이 어려워질 수 있으므로 모든 시스템 구성 요소를 한꺼번에 선택하지 마세요. 앱 업데이트 후 다시 작동하지 않으면 루프백 권한을 다시 부여하고 시스템 프록시 포트가 바뀌지 않았는지 확인하세요.

Usage

사용 팁

연결 시간 초과, TUN 가로채기, DNS 점검, 로컬 네트워크 공유를 위한 반복 가능한 점검 방법을 소개합니다.

노드 지연 시간 테스트는 정상인데 웹사이트가 계속 시간 초과되면 어떻게 해야 하나요?

지연 시간 테스트는 보통 특정 주소에 연결할 수 있는지만 확인하므로 대상 웹사이트에 반드시 접속할 수 있다는 뜻은 아닙니다. 먼저 정책 그룹에서 다른 노드로 바꾼 뒤 규칙 모드와 전역 모드를 각각 테스트하세요. 전역 모드에서 작동한다면 문제는 대개 규칙 매칭이나 정책 그룹 선택에 있습니다. 모든 노드에서 시간 초과가 발생하면 로컬 네트워크, 구독 유효 상태, 시스템 시간, 클라이언트 로그를 확인해야 합니다. 로그의 timeout, connection refused, TLS 오류는 각각 연결 시간 초과, 포트 거부, 핸드셰이크 이상을 의미하므로 해결 방향이 서로 다릅니다.

TUN 모드를 활성화할 때 관리자 권한이 필요한 이유는 무엇인가요?

TUN 모드는 가상 네트워크 인터페이스를 만들고 라우팅을 조정하며 시스템 프록시를 읽지 않는 앱의 트래픽을 가로채야 하므로 일반 사용자 권한을 넘어서는 작업이 필요합니다. Windows에서는 클라이언트 안내에 따라 해당 서비스를 설치하거나 처음 활성화할 때 관리자 권한을 사용한 뒤, 가상 네트워크 어댑터와 관련 서비스가 정상적으로 로드되었는지 확인하세요. 권한 확인 창을 취소하면 TUN 스위치가 처리된 것처럼 보여도 인터페이스가 생성되지 않을 수 있습니다. 조직 정책으로 관리되는 PC에서는 드라이버나 서비스 설치가 제한될 수 있으므로 장치 관리자가 처리해야 합니다.

Clash의 DNS 누출을 확인하고 줄이는 방법은 무엇인가요?

먼저 프록시 연결 전후에 DNS 테스트 페이지를 사용해 확인되는 DNS 서버가 바뀌는지 살펴보고, 클라이언트 로그를 통해 도메인 요청이 Clash DNS로 들어가는지 확인하세요. 설정에서는 dns 활성화 여부, 현재 네트워크에 맞는 nameserver와 fallback, enhanced-mode가 fake-ip인지 redir-host인지 중점적으로 점검합니다. TUN을 활성화했다면 DNS 하이재킹 규칙도 적용되었는지 확인해야 합니다. 변경 후에는 시스템 DNS 캐시를 지우고 브라우저를 다시 시작한 다음 재검사하여 기존 캐시가 판단에 영향을 주지 않게 하세요.

로컬 네트워크의 휴대폰이나 다른 컴퓨터에서 Clash 프록시를 사용하려면 어떻게 하나요?

클라이언트에서 로컬 네트워크 연결 허용을 활성화하고 수신 주소가 127.0.0.1로만 제한되어 있지 않은지 확인하세요. 그런 다음 Clash가 실행 중인 컴퓨터의 로컬 네트워크 IPv4 주소를 확인하고, 다른 기기의 Wi-Fi 프록시 설정에 해당 주소와 Clash의 HTTP 또는 혼합 포트를 입력합니다. 호스트 방화벽은 전용 네트워크에서 해당 프로그램과 포트를 허용해야 합니다. 공유하는 동안 두 기기를 신뢰할 수 있는 동일한 로컬 네트워크에 두고, 사용이 끝나면 로컬 네트워크 접근을 끄는 것이 좋습니다.

Troubleshooting

문제 해결

포트, YAML, 가상 네트워크 어댑터, 시스템에 남은 설정부터 점검해 클라이언트와 기본 네트워크를 복구합니다.

Clash가 시작되지 않고 포트가 사용 중이라고 표시되면 어떻게 해야 하나요?

포트 충돌은 보통 다른 Clash 인스턴스, 이전 코어 프로세스, 프록시 도구 또는 개발 서비스 때문에 발생합니다. 먼저 관련 프로그램을 완전히 종료하고 작업 관리자에서 남아 있는 코어 프로세스가 끝났는지 확인하세요. 그래도 충돌하면 시스템 네트워크 명령으로 해당 포트를 사용하는 프로세스 번호를 조회한 뒤 프로세스를 종료하거나 Clash의 mixed-port, port, socks-port를 변경할지 결정합니다. 포트를 바꾼 후에는 시스템 프록시와 프록시를 수동 설정한 앱도 함께 수정해야 합니다. 그렇지 않으면 코어는 실행되지만 요청이 들어오지 않을 수 있습니다.

YAML을 수정한 후 설정 파싱 오류가 발생할 때 원인을 찾는 방법은 무엇인가요?

YAML은 들여쓰기, 콜론, 목록 기호에 매우 민감하므로 먼저 오류 메시지에 표시된 줄 번호를 확인한 뒤 같은 수준의 위쪽 구문을 점검하세요. 들여쓰기는 공백만 사용하고 탭을 섞지 마세요. 키 이름 뒤의 콜론 다음에는 공백을 남기고, 특수 문자가 포함된 텍스트는 따옴표로 감쌀 수 있습니다. 규칙 항목은 목록 형식을 유지해야 하며, 정책 그룹이 참조하는 이름도 기존 노드 또는 그룹 이름과 정확히 일치해야 합니다. 수정 전 정상 작동하는 사본을 보관하고, 완료 후 먼저 설정 검사를 실행한 다음 코어를 다시 불러오세요.

TUN을 켠 후 모든 네트워크에 접속할 수 없을 때 복구하는 방법은 무엇인가요?

먼저 TUN 모드를 끄고 클라이언트를 종료한 뒤 기본 네트워크가 복구되는지 확인하세요. 복구되지 않으면 물리 네트워크 어댑터를 비활성화했다가 다시 활성화하고 시스템에 수동 프록시가 남아 있는지 점검합니다. TUN을 다시 켜기 전에 가상 네트워크 어댑터, 서비스 모드, DNS 하이재킹, 라우팅 설정이 모두 정상적으로 로드되었는지 확인하고, 비교를 위해 다른 VPN이나 가상 네트워크 어댑터 프로그램을 잠시 종료하세요. 특정 네트워크에서만 문제가 발생한다면 TUN 네트워크 스택을 바꾸거나 MTU를 조정할 수 있지만, 한 번에 한 항목만 변경하고 결과를 기록해야 합니다.

Clash를 종료한 후 컴퓨터에서 인터넷이 되지 않을 때 남은 프록시를 어떻게 정리하나요?

대개 클라이언트 종료 시 시스템 프록시가 복원되지 않았거나 TUN 서비스와 라우팅이 남아 있기 때문에 발생합니다. 먼저 Windows 네트워크 및 인터넷 설정을 열어 수동 프록시를 끄고 자동 구성 스크립트를 확인하세요. 그런 다음 Clash, 관련 코어, 서비스 프로세스가 모두 종료되었는지 확인합니다. 이전에 TUN을 사용했다면 클라이언트를 다시 열어 TUN을 정상적으로 끈 뒤 종료하세요. 마지막으로 DNS 캐시를 지우고 네트워크 어댑터를 다시 시작합니다. 그래도 복구되지 않을 때만 시스템을 재부팅하고, 정체를 알 수 없는 네트워크 드라이버는 직접 삭제하지 마세요.