Clash 클라이언트/다운로드 및 설정

Clash, Clash Meta, mihomo의 관계

Clash는 YAML 설정, 정책 그룹, 규칙 기반 라우팅을 중심으로 한 사용 방식으로 시작했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티에서 호환 생태계가 이어졌습니다. mihomo는 Clash Meta의 프로젝트 방향을 이어받아 프록시 프로토콜, 규칙 세트, 도메인 스니핑, 네트워크 연결 방식 등을 계속 발전시켰습니다. 따라서 예전 가이드의 Clash Meta와 현재 문서의 mihomo는 같은 코어 개발 흐름을 가리키는 경우가 많지만, 예전 설정 항목이 모두 현재 구현과 일치한다고 볼 수는 없습니다.

클라이언트는 화면을 갖춘 앱이고, 코어는 실제 네트워크 연결을 처리하는 프로그램입니다. 클라이언트에 특정 코어가 포함될 수도 있고 사용자가 코어를 바꿀 수도 있습니다. 특정 기능을 사용할 수 있는지 판단하려면 코어의 지원 여부, 클라이언트에서 해당 설정을 제공하는지, 현재 시스템이 필요한 권한을 충족하는지를 함께 확인해야 합니다. 앱 이름만으로는 실행 환경을 알 수 없으므로 설정을 그대로 사용할 수 있는지 판단하기 어렵습니다. iOS 등 일부 플랫폼은 별도의 네트워크 연결 방식을 사용하므로 데스크톱 구현을 그대로 적용하지 마세요.

공개 문서에서 설정 항목 확인하기

설정 항목을 확인하려면 먼저 mihomo 설정 문서를 살펴본 뒤 mihomo 소스 코드 저장소에서 설명, 릴리스 기록, 이슈 논의를 확인하세요. 공개 소스 코드는 구현 방식을 이해하고 문제를 찾는 데 도움이 되지만, 모든 GUI 클라이언트가 같은 이름의 옵션을 제공한다는 뜻은 아닙니다. 이 사이트에서는 자주 쓰는 개념을 용어별로 설명하고 전체 설정 절차는 고급 가이드에 정리해 버튼 경로와 내부 설정값을 하나의 고정된 절차처럼 섞지 않습니다.

예시를 읽을 때는 전체 파일과 일부 설정을 구분하세요. rules에 지정한 정책 이름은 설정에 실제로 정의되어 있어야 합니다. rule-providers가 참조하는 파일도 실제로 있어야 하며 DNS 수신 포트와 제어 인터페이스 포트가 다른 프로그램에서 사용 중인지 확인해야 합니다. YAML은 공백으로 계층을 표현하므로 들여쓰기에 탭을 사용하지 마세요. 저장하기 전에 클라이언트의 설정 검사 기능을 실행하고 다시 불러온 뒤 로그에서 성공 여부를 확인하세요. 화면에 이전 설정이 계속 표시되면 같은 링크를 다시 가져오기보다 현재 활성화된 설정을 먼저 확인하세요.

설정 업데이트와 로컬 수정의 범위

앱 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 영역에 영향을 줍니다. 앱 업데이트는 화면과 서비스 구성 요소를 바꿀 수 있고, 코어 업데이트는 프로토콜 구현이나 설정 항목의 동작을 바꿀 수 있으며, 구독 업데이트는 서버, 정책 그룹, 규칙을 교체할 수 있습니다. 업그레이드 전에 현재 사용할 수 있는 설정과 로컬 오버라이드를 보존하고 관련 릴리스 안내를 읽으세요. 업그레이드 후에는 기존 연결을 먼저 확인한 다음 새 기능을 하나씩 활성화하세요. ‘구독 업데이트 성공’이 서버 사용 가능을 보장하지 않으며, ‘설치 완료’가 모든 앱의 트래픽을 시스템 프록시로 전달한다는 뜻도 아닙니다.

오래 사용하려면 구독은 원격 설정을 관리하고 로컬 오버라이드는 개인 설정을 유지하도록 나누는 것이 좋습니다. 예를 들어 업무용 도메인 몇 개에만 규칙을 추가하거나 로컬 수신 주소와 DNS 기본 설정을 보존할 수 있습니다. 클라이언트마다 오버라이드, 병합 방식, 실행 순서가 다르므로 편집기에서 보이는 일부 설정만 보지 말고 최종 생성된 설정을 확인하세요. 여러 구독을 병합해야 한다면 이름이 겹치는 정책 그룹, 중복 규칙, 출구 의존성도 처리해야 합니다. 관련 절차는 고급 설정 가이드에서 확인할 수 있으며, 첫 연결 단계에서 한꺼번에 진행하는 것은 권장하지 않습니다.

연결 기록으로 문제 원인 찾기

‘인터넷에 연결할 수 없음’ 문제는 먼저 트래픽 유입, DNS 해석, 규칙, 출구의 네 단계로 나눠 살펴보세요. 브라우저가 시스템 프록시를 사용하는지, 코어에 연결 기록이 남는지, 도메인이 예상대로 해석되는지, 연결에 어떤 정책이 적용됐는지 확인하는 편이 설정을 반복해서 바꾸는 것보다 진단에 도움이 됩니다. 코어에 연결 기록이 없다면 트래픽 유입 방식을 먼저 확인하세요. 기록은 있지만 정책이 잘못됐다면 규칙 순서와 그룹 내 선택을 살펴보세요. 정책이 맞는데도 실패하면 구독 상태, 노드 프로토콜, 출구 네트워크를 확인하세요. 원인을 결과로 판단할 수 있도록 설정은 한 번에 하나씩만 바꾸세요.

지연 시간 테스트는 특정 테스트 대상, 프로토콜, 당시 네트워크 조건에서 측정한 결과일 뿐 실제 서비스 동작을 보장하지 않습니다. 웹페이지, 동영상, 명령줄 도구는 DNS, 연결 재사용, 전송 프로토콜이 서로 다를 수 있습니다. 확인할 때는 먼저 대상 앱 하나를 정하고 연결 기록을 살펴본 뒤 출구가 규칙의 예상과 일치하는지 확인하세요. 문제 해결 자료를 공유할 때는 오류 유형과 필요한 항목만 남기고 구독 주소의 접근 매개변수, 서버 비밀번호, 개인 네트워크 식별 정보는 삭제하세요. 자세한 방법은 자주 묻는 질문에서 확인할 수 있습니다.

처음 사용할 때 권장하는 설정 순서

사용 가능한 구독이 있다면 시스템 아키텍처에 맞는 클라이언트를 설치한 뒤 설정 화면에서 구독을 가져와 현재 설정으로 지정하세요. 다음으로 Rule 모드를 선택하고 실제 사용할 정책 그룹에서 노드를 고른 뒤 시스템 프록시 또는 모바일 VPN 연결을 활성화하세요. 자주 사용하는 앱이 연결되는지 먼저 확인하고 규칙이 예상대로 적용되는지 살펴보세요. 이 순서대로 설정 유효성, 트래픽 유입, 출구 선택을 따로 확인하면 문제가 어느 단계에서 발생했는지 쉽게 파악할 수 있습니다. 네트워크 옵션을 모두 켠 뒤 하나씩 추측하는 일을 줄일 수 있습니다.

대상 프로그램이 시스템 프록시를 따르지 않거나 더 넓은 범위의 트래픽을 처리해야 할 때만 TUN을 살펴보세요. 활성화하기 전에 경로를 변경할 수 있는 다른 VPN을 끄고 현재 DNS와 프록시 설정을 기록한 다음 클라이언트 안내에 따라 서비스를 설치하거나 권한을 허용하세요. 네트워크 문제가 발생하면 방금 적용한 변경 사항을 취소하고 정상 작동이 확인된 상태로 되돌리세요. 시작 가이드에서는 설정 가져오기, 선택, 연결, 확인 순서에 따라 전체 과정을 안내합니다. 용어집에서는 용어를 찾아볼 수 있습니다. 두 자료는 고급 가이드와 목적이 다릅니다.