문제 해결 아카이브

Clash는 규칙 기반 네트워크 프록시 도구를 통칭하는 이름입니다. 핵심 로직은 코어가 담당합니다: 설정 파일을 읽고, 분기 규칙을 매칭하며, 트래픽을 전달합니다. 원조 Clash 코어는 2023년에 개발이 중단되었고, 현재 커뮤니티 주류 코어는 mihomo(이전 명칭 Clash Meta)로, 기존 설정 형식과 호환되면서 더 많은 프로토콜을 확장했습니다.

일상적으로 사용하는 Clash Plus, Clash Verge Rev 등은 GUI 클라이언트로, 화면 표시와 구독 관리, 시스템 프록시 설정을 담당하며 내부적으로는 모두 mihomo 코어를 호출합니다. 클라이언트를 선택할 때 코어가 mihomo인지 확인하면, 현재의 프로토콜 지원 능력을 얻을 수 있습니다.

구독 링크는 서비스 제공업체가 호스팅하는 설정 파일을 가리키는 URL로, 노드 목록과 분기 규칙이 담겨 있습니다. 클라이언트가 이 링크를 주기적으로 가져오면, 노드 변경 사항이 자동으로 동기화되어 일일이 수동으로 입력할 필요가 없습니다.

구독 링크는 사용 중인 프록시 서비스 제공업체의 사용자 패널에서 제공되며, 보통 「Clash 구독」이나 「Clash 설정」으로 표시됩니다. 본 사이트는 클라이언트 설치 파일과 사용 문서만 제공하며 어떠한 구독 서비스도 제공하지 않습니다. 링크를 받은 후에는 보안에 유의하세요 — 링크가 유출되면 계정 공유와 마찬가지로 타인이 해당 노드의 트래픽을 그대로 사용할 수 있습니다.

세 가지 모드는 트래픽의 흐름 전략을 결정합니다. 규칙 모드는 설정 파일 속 규칙을 순서대로 매칭합니다: 직결 규칙에 해당하는 트래픽은 프록시를 거치지 않고, 프록시 규칙에 해당하는 트래픽은 선택된 노드를 경유하며, 일상적으로 권장되는 모드입니다. 글로벌 모드는 모든 규칙을 무시하고 전체 트래픽이 예외 없이 현재 노드를 경유하며, 노드 연결 상태를 임시로 테스트하거나 규칙 이상 시 긴급 대응에 적합합니다. 직결 모드는 전체 트래픽이 프록시를 거치지 않아 임시 비활성화와 동일한 효과를 냅니다.

대부분의 구독에는 완비된 분기 규칙이 포함되어 있으므로 규칙 모드를 유지하면 됩니다. 특정 웹사이트가 규칙 모드에서 접속되지 않으면 일시적으로 글로벌 모드로 전환해 확인해 보세요: 글로벌 모드에서 접속이 되면 규칙 문제이고, 글로벌 모드에서도 안 되면 노드 문제입니다.

Clash for Windows는 2023년 11월 개발이 중단되고 저장소가 삭제되었으며, 현재 남아 있는 설치 파일은 커뮤니티 아카이브 버전입니다. 단기적으로는 프로그램이 계속 실행되지만, 두 가지 지속적으로 확대되는 문제가 있습니다: 첫째, 내장 코어가 오래되어 새로운 프로토콜과 새로운 설정 필드를 인식하지 못해 일부 구독이 파싱 실패할 수 있습니다; 둘째, 더 이상 보안 패치가 제공되지 않습니다.

여전히 유지보수 중인 클라이언트, 예를 들어 Clash Plus나 Clash Verge Rev로 이전하는 것을 권장합니다. 두 클라이언트 모두 mihomo 코어를 사용하며, 구독 링크를 그대로 재사용할 수 있고 화면 조작 논리가 Clash for Windows와 유사해 이전 비용이 낮습니다.

프록시류 소프트웨어는 시스템 네트워크 설정을 수정하고 가상 네트워크 카드 드라이버를 설치해야 하는데, 이러한 동작이 일부 악성 소프트웨어의 특징과 겹쳐 백신 프로그램의 휴리스틱 오탐을 유발하기 쉬운, 이런 종류의 도구에서 흔한 현상입니다.

처리 절차: 첫째, 설치 파일이 본 사이트 다운로드 페이지 또는 클라이언트 공식 배포 채널에서 온 것인지 확인하고 출처가 불분명한 재배포 파일을 사용하지 않습니다; 둘째, 백신 프로그램의 격리 구역에서 삭제된 파일을 복원합니다; 셋째, 클라이언트 설치 디렉터리를 신뢰 구역이나 제외 목록에 추가해 실행 중 핵심 파일이 다시 삭제되는 것을 방지합니다; 넷째, Windows Defender의 SmartScreen 경고는 「추가 정보」를 클릭한 후 「실행」을 선택하면 됩니다.

이는 App Store를 통해 배포되지 않은 앱에 대한 macOS Gatekeeper의 기본 차단입니다. 「시스템 설정 → 개인정보 보호 및 보안」을 열면 페이지 하단에 방금 차단된 앱의 기록이 나타나며, 「그래도 열기」를 클릭하고 비밀번호를 입력하면 됩니다.

「앱이 손상되었습니다」라는 메시지가 뜬다면 대개 다운로드 파일에 격리 속성이 붙어 있는 경우로, 터미널에서 xattr -cr /Applications/앱이름.app을 실행해 격리 표시를 지운 후 다시 실행하면 됩니다. 또한 칩 아키텍처를 구분해야 합니다: Apple Silicon 기종은 ARM 버전을, Intel 기종은 x64 버전을 다운로드해야 하며, 잘못된 아키텍처를 설치하면 변환 계층을 통해 실행되어 성능이 저하되고 가상 네트워크 카드 이상이 발생할 수 있습니다.

클라이언트별 입구 명칭은 약간 다르지만 논리는 동일합니다: 구독 또는 설정 관리 페이지를 찾아 링크를 붙여넣고 가져옵니다. Clash Verge Rev는 좌측 「구독」 페이지 상단 입력란에 링크를 붙여넣은 뒤 「가져오기」를 클릭하면, 성공 후 설정 카드가 목록에 나타나고 좌클릭으로 카드를 클릭해 활성화합니다; Clash Plus는 「설정 / 구독」 탭에서 「구독 추가」를 선택해 링크를 붙여넣습니다; Clash Meta for Android는 먼저 「설정」 페이지에서 새 설정을 만들고 유형을 URL로 선택한 뒤 링크를 입력해 저장하고, 메인 화면으로 돌아가 시작을 클릭합니다.

가져온 후에는 반드시 해당 설정이 선택된 상태인지 확인한 다음 시스템 프록시를 켜야 하며, 그렇지 않으면 코어가 여전히 빈 설정을 사용하게 됩니다. 전체 절차는 설정 튜토리얼을 참고하세요.

TUN 모드는 가상 네트워크 카드를 생성해 시스템 계층에서 트래픽을 인수하는 방식으로, 네트워크 카드 생성은 특권 작업에 속합니다. Windows에서는 관리자 권한으로 클라이언트를 실행하거나 클라이언트의 안내에 따라 시스템 서비스를 설치해 서비스 프로세스가 권한을 대신 보유하도록 해야 하며, 이후에는 일반 실행으로도 TUN을 켤 수 있습니다; macOS는 처음 켤 때 인증 대화상자가 나타나며 비밀번호를 입력해 네트워크 확장 또는 보조 도구를 승인해야 합니다; Linux는 root 권한이 필요하거나 실행 파일에 해당 capability를 설정해야 합니다.

서비스 설치가 실패하면 먼저 클라이언트를 완전히 종료(트레이 프로세스 포함)한 후 관리자 권한으로 다시 실행해 서비스를 설치해 보고, 그래도 실패하면 다른 프록시 소프트웨어가 남긴 가상 네트워크 카드나 서비스 점유가 있는지 확인해 충돌 항목을 먼저 제거한 후 다시 시도합니다.

클라이언트의 프록시 페이지에는 보통 지연 테스트 버튼이 있으며, 클릭하면 각 노드에 대해 HTTP 탐색을 한 번 실행해 왕복 소요 시간을 밀리초 단위로 기록합니다. 이 수치는 해당 노드를 경유해 테스트 주소에 접속할 때의 핸드셰이크 소요 시간을 반영하는 것으로, 수치가 작을수록 응답이 빠릅니다. 다만 대역폭과 같은 개념은 아닙니다 — 지연이 낮은 노드가 반드시 다운로드 속도가 빠른 것은 아니며, 지연은 타임아웃 노드를 제외하고 응답 품질을 대략 선별하는 데에만 적합합니다. 테스트 결과가 「타임아웃」으로 표시되면 해당 노드는 현재 사용할 수 없다는 뜻입니다.

노드를 선택하기 전에 전체 그룹의 지연을 한 번 테스트해 수치가 안정적인 노드를 우선 선택하는 것을 권장하며, 자동 선택 정책 그룹을 사용해 클라이언트가 지연 결과에 따라 자동으로 전환하도록 할 수도 있습니다.

사용자 정의 규칙을 통해 구현합니다. Clash 규칙은 위에서 아래로 순서대로 매칭되며 먼저 일치한 것이 먼저 적용되므로, 사용자 정의 규칙을 구독 규칙보다 앞에 배치하면 기본 동작을 재정의할 수 있습니다. 흔히 쓰는 작성법: DOMAIN-SUFFIX,example.com,DIRECT는 해당 도메인과 서브도메인이 직결됨을 의미합니다; 끝의 DIRECT를 프록시 정책 그룹 이름으로 바꾸면 강제로 프록시를 거치도록 합니다; IP 대역으로 제어할 때는 IP-CIDR을 사용할 수 있고, 프로세스로 제어할 때는 일부 플랫폼에서 PROCESS-NAME을 사용할 수 있습니다.

Clash Verge Rev는 「전역 확장 설정」의 prepend 방식으로 규칙을 추가하는 것을 지원해 구독 업데이트로 덮어써지지 않으며, 구독 파일을 직접 수정하는 방법은 다음 구독 업데이트 시 사라지므로 권장하지 않습니다. 규칙 문법에 관한 자세한 설명은 규칙 분기 실전 글을 참고하세요.

GeoIP는 IP 주소와 국가/지역을 대응시키는 데이터베이스로, 설정 속 GEOIP,CN,DIRECT와 같은 규칙이 이를 참조해 대상 IP의 소속을 판단하며, 중국 본토 IP 직결·기타 지역 프록시 경유와 같은 분기 효과를 구현합니다. 이와 함께 GeoSite 데이터베이스도 있으며 도메인 기준으로 분류합니다.

데이터베이스는 IP 대역 변경에 따라 점차 오래되며, 지나치게 오래된 데이터는 일부 트래픽의 분기 오류를 초래할 수 있습니다. 대부분의 클라이언트는 설정 페이지에서 Geo 데이터 업데이트 버튼을 제공하므로 한두 달에 한 번씩 수동으로 업데이트하는 것을 권장하며, 일부 클라이언트는 자동 업데이트 주기 설정을 지원합니다. 업데이트 실패는 대부분 다운로드 소스에 접속할 수 없는 경우이므로, 먼저 프록시를 켠 후 업데이트를 실행해 볼 수 있습니다.

DNS 유출이란 트래픽 자체는 프록시를 경유하지만 도메인 이름 해석 요청은 여전히 로컬 통신사 DNS로 전송되어, 해석 기록이 접속 대상을 노출시키는 현상을 말합니다. 방지 요점: 첫째, Clash 설정의 dns 항목에서 enhanced-mode: fake-ip를 켜서 클라이언트가 해석을 인수하도록 하면, 앱은 가상 IP를 받게 되고 실제 해석은 프록시 쪽에서 완료됩니다; 둘째, nameserver에 암호화 DNS(예: DoH 주소)를 사용합니다; 셋째, TUN 모드를 켜고 DNS 하이재킹 기본 설정을 유지하면, 앱이 시스템 프록시를 우회해 53번 포트로 직접 보내는 해석 요청을 차단할 수 있습니다.

설정을 완료한 후 브라우저로 DNS 유출 탐지 사이트에 접속해 확인할 수 있으며, 결과에 로컬 통신사의 해석 서버가 나타나지 않아야 합니다. 항목별 상세 설정 예시는 DNS 설정 상세 가이드를 참고하세요.

순서대로 세 가지를 확인합니다. 첫째, 구독을 가져와 설정이 활성화 상태인지 확인합니다 — 코어가 빈 설정 상태에서 시스템 프록시를 켜면 모든 요청이 전달될 곳이 없어져 전체 인터넷 단절로 나타납니다. 둘째, 글로벌 모드로 전환하고 지연이 정상인 노드를 수동으로 선택해 테스트합니다: 접속이 가능하면 규칙이나 노드 선택 문제이고, 여전히 접속이 안 되면 해당 그룹 노드의 지연을 테스트해 모두 타임아웃이면 구독 실효로 처리합니다. 셋째, 포트 일치성을 확인합니다: 시스템 프록시가 가리키는 포트는 클라이언트의 혼합 포트와 일치해야 하며, 포트 설정을 수정한 적이 있다면 시스템 프록시를 끄고 다시 켜서 재작성하도록 합니다.

네트워크를 임시로 복구하는 방법은 먼저 시스템 프록시와 TUN을 끄고 순수 연결이 정상인지 확인한 후, 위 순서에 따라 항목별로 원인을 찾는 것입니다.

전체 노드 그룹이 동시에 타임아웃되는 경우, 원인은 대개 개별 노드에 있지 않습니다. 순서대로 확인합니다: 첫째, 본체의 순수 연결 네트워크가 정상인지, 프록시를 끈 상태에서 일반 웹페이지를 열 수 있는지 확인합니다; 둘째, 구독이 만료되었거나 트래픽이 소진되었는지, 서비스 제공업체 패널에 로그인해 계정 상태를 확인합니다 — 이것이 가장 흔한 원인입니다; 셋째, 구독을 한 번 업데이트합니다 — 서비스 제공업체가 노드 주소를 변경하면 기존 설정 속 노드가 집단으로 실효됩니다; 넷째, 시스템 시간을 확인합니다 — 일부 프로토콜은 시간 편차에 민감해 몇 분만 차이 나도 핸드셰이크가 실패하므로 자동 시간 동기화를 켜고 다시 시도합니다; 다섯째, 네트워크 환경을 바꿔 테스트합니다(예: 휴대폰 테더링으로 전환), 현재 네트워크가 프록시 포트를 방해하는지 판단합니다.

항목별로 배제한 후에도 전부 타임아웃이면 서비스 제공업체에 문의해 서버 상태를 확인합니다.

먼저 네트워크 문제인지 내용 문제인지 구분합니다. 네트워크 문제: 구독 주소 자체가 현재 네트워크에서 차단되었을 수 있으므로, 클라이언트에서 「프록시를 사용해 구독 업데이트」 옵션을 켜거나 사용 가능한 노드에 임시로 연결한 후 다시 업데이트할 수 있습니다; 브라우저에서 구독 링크를 직접 열어 설정 텍스트가 보이면 경로가 정상적으로 연결됨을 알 수 있습니다.

내용 문제: 오류에 yaml이나 parse라는 단어가 포함되어 있으면 설정 파싱 실패를 의미하며, 흔히 구독 형식이 Clash 전용 형식이 아닌 경우에 발생합니다 — 서비스 제공업체 패널로 돌아가 복사한 것이 Clash 구독인지, 다른 클라이언트 형식의 링크가 아닌지 확인합니다; 링크가 중간에 잘렸거나 공백이 추가로 복사된 경우에도 404나 파싱 오류가 발생할 수 있으니 다시 전체를 복사합니다.

시스템 프록시는 앱에 프록시 주소를 「알려주는」 것일 뿐, 이를 따를지는 앱이 스스로 결정합니다. 브라우저는 대체로 이를 따르지만, 많은 데스크톱 프로그램, 명령줄 도구, 게임은 자체 네트워크 스택을 사용해 시스템 프록시를 그대로 무시합니다.

상황별 처리: Windows의 UWP 앱은 네트워크 격리 제한을 받아 기본적으로 본체 루프백 주소에 연결하는 것이 금지되어 있으므로, 클라이언트의 UWP 루프백 예외 도구에서 해당 앱의 제한을 해제해야 합니다; 명령줄 도구는 http_proxy와 https_proxy 환경 변수를 본체의 혼합 포트로 수동 설정해야 합니다; 어떤 프록시 설정도 읽지 않는 프로그램의 경우 TUN 모드를 켜서 네트워크 카드 계층에서 인수하는 것이 일반적인 해결책으로, 하나씩 설정할 필요가 없습니다.

권장 순서: 첫째, 노드를 바꿔 봅니다. 같은 라인이라도 노드마다 부하 차이가 뚜렷하므로 같은 지역의 다른 노드를 먼저 시도합니다; 둘째, 프로토콜과 포트를 확인합니다. 일부 네트워크 환경은 특정 프로토콜에 간섭이 있으므로 서비스 제공업체가 제공하는 다른 프로토콜 입구로 바꿔 볼 수 있습니다; 셋째, 로컬 대역폭을 측정합니다. 프록시를 끄고 속도를 측정해 병목이 로컬 네트워크에 있지 않은지 확인합니다; 넷째, 규칙을 확인합니다. 대용량 트래픽 앱이 잘못된 규칙으로 저속 노드에 배치되지 않았는지 확인하고, 일시적으로 글로벌 모드로 바꿔 속도를 비교할 수 있습니다; 다섯째, 클라이언트가 프록시를 경유해 대용량 파일을 다운로드하고 있는지 확인합니다 — 구독 업데이트, Geo 데이터 업데이트 등의 동작도 노드 대역폭을 점유합니다.

피크 시간대에 전체적으로 느려지는 것은 대개 서버 측 혼잡으로, 서비스 제공업체 쪽 문제에 속하니 시간대나 라인을 바꿔 확인해 보면 됩니다.