Windows
운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 시스템 프록시는 브라우저 등에서 사용할 수 있습니다. 스토어 앱은 UWP 루프백 제한이 있을 수 있으므로 별도로 확인해야 합니다.
다운로드 Windows 클라이언트먼저 운영체제를 확인한 다음 칩 아키텍처를 선택하세요. 다운로드 페이지에서 클라이언트와 지원 아키텍처, 설치 경로를 한눈에 확인할 수 있습니다. 클라이언트마다 메뉴 위치는 다를 수 있지만 구독 설정, 프록시 그룹, 트래픽 진입점의 기본 관계는 같습니다.
운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 시스템 프록시는 브라우저 등에서 사용할 수 있습니다. 스토어 앱은 UWP 루프백 제한이 있을 수 있으므로 별도로 확인해야 합니다.
다운로드 Windows 클라이언트‘이 Mac에 관하여’에서 Apple Silicon과 Intel 중 어떤 칩인지 확인하세요. 설치 후 설정을 가져오고 시스템 프록시를 켜면 됩니다. TUN 모드를 사용할 때는 클라이언트 안내에 따라 서비스와 권한을 설정하세요.
다운로드 macOS 클라이언트기기 아키텍처에 맞는 설치 파일을 선택하세요. 처음 연결할 때 VPN 권한을 승인해야 할 수 있습니다. 다른 VPN 앱을 사용 중이라면 충돌 여부를 먼저 확인한 뒤 앱별 프록시와 백그라운드 실행 권한을 설정하세요.
다운로드 Android 클라이언트다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하세요. 설치 후 호환되는 설정을 가져오고 시스템 VPN 권한을 승인하면 됩니다. 클라이언트 정보는 공식 사이트 clashplus.io에서 확인할 수 있습니다.
다운로드 iOS 클라이언트데스크톱 사용자는 배포판에 맞는 패키지를 선택하고, 서버 사용자는 별도 코어를 고려하세요. 데스크톱 프록시 설정, 서비스 권한, 라우팅 관리는 서로 별개이므로 설치 후 각각 확인해야 합니다.
다운로드 Linux 클라이언트클라이언트 설치 파일은 구독 서비스를 포함하지 않습니다. 사용할 권한이 있는 설정 소스를 준비하고, 사용 가능한 프록시 노드와 프록시 그룹, 규칙이 포함되어 있는지 확인하세요. 기기를 옮길 때는 스크린샷만 보고 설정을 재구성하지 말고 원본 구독이나 설정 백업을 사용하세요.
모든 클라이언트 보기 →시스템 프록시는 앱이 요청을 클라이언트에 전달하는 방식을 정하고, 아웃바운드 모드는 전달된 요청을 처리하는 방식을 정합니다. 두 단계를 구분해야 모든 옵션을 무작정 켜지 않고 필요한 설정만 바꿀 수 있습니다.
일상적인 사용은 규칙 모드부터 시작하세요.
규칙 모드는 설정의 매칭 순서에 따라 아웃바운드를 선택하므로 로컬 서비스와 원격 리소스를 함께 이용할 때 적합합니다. 전역 모드는 보통 코어에 들어온 요청을 전역 프록시 그룹으로 보내며, 임시 비교 테스트에 쓸 수 있습니다. 직접 연결 모드에서는 프록시를 거치지 않은 결과를 확인할 수 있습니다. 모드를 바꿔도 노드가 새로 만들어지거나 클라이언트에 들어오지 않은 앱 트래픽까지 자동으로 처리되지는 않습니다. 먼저 프록시 그룹에 사용할 수 있는 항목이 있는지 확인하고 새 요청을 보낸 뒤 연결 페이지에서 실제 아웃바운드를 확인하세요. 기존 장기 연결은 변경 전 경로를 계속 사용할 수 있습니다.
시스템 프록시를 켜면 시스템 네트워크 설정이 클라이언트의 로컬 수신 주소를 가리킵니다. 해당 설정을 따르는 브라우저와 데스크톱 앱에 적합합니다. 사용 전에 코어를 실행하고 유효한 설정을 선택하세요. 혼합 포트는 클라이언트에 표시된 값을 따릅니다. 일부 명령줄 도구, 게임, 자체 프록시 설정을 사용하는 앱은 이 경로를 자동으로 이용하지 않으므로 별도 설정이나 TUN 모드를 검토해야 합니다. 클라이언트를 종료한 뒤 네트워크에 문제가 생기면 시스템 프록시가 중지된 로컬 서비스를 가리키는지 먼저 확인하세요. 구독을 수정하거나 앱을 반복해서 재설치하지 마세요.
TUN 모드는 가상 네트워크 인터페이스와 라우팅으로 트래픽을 처리하므로 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. 그래도 유효한 설정과 사용 가능한 아웃바운드, 올바른 DNS 처리가 필요하며 모든 요청이 프록시를 거치는 것은 아닙니다. 사용 전에 선택한 클라이언트의 서비스 설치 안내를 읽고 관리자 권한, 다른 VPN, 가상 네트워크 어댑터, 보안 소프트웨어의 영향을 확인하세요. 로컬 기기에 연결할 수 없거나 도메인 이름이 확인되지 않으면 TUN을 끄고 비교한 뒤 라우팅 제외와 DNS 설정을 점검하세요. 원인을 찾기 쉽도록 한 번에 하나씩 바꾸세요.
rules:
- DOMAIN-SUFFIX,apple.com,DIRECT
- GEOIP,LAN,DIRECT
- MATCH,Proxy
규칙은 일반적으로 위에서 아래로 확인하며, 처음 일치한 항목이 해당 요청의 아웃바운드를 결정합니다. 도메인 접미사 규칙은 관련 도메인에, 프로세스 규칙은 앱 식별에 사용하고, 규칙 모음은 다수의 항목을 별도 리소스로 관리합니다. 편집할 때는 정책 이름이 프록시 그룹과 일치하는지 확인하고 구체적인 규칙을 기본 규칙보다 앞에 두세요. 예시의 Proxy는 실제 프록시 그룹에 대응해야 하며 모든 설정에 그대로 복사해서는 안 됩니다. 변경 후 설정이 정상적으로 로드되는지 확인하고 연결 상세 정보에서 일치한 규칙을 점검하세요. 페이지가 열리는지만으로 규칙이 올바르다고 판단하지 마세요.
연결 페이지에서는 요청 대상, 매칭 규칙, 아웃바운드 경로를 확인할 수 있고 로그 페이지에서는 설정 로드, 파싱, 연결 과정의 오류를 추적할 수 있습니다. 문제를 진단할 때는 오류가 발생한 앱과 작업 시간을 기록한 뒤 요청을 다시 보내 확인할 범위를 좁히세요. 연결 페이지에 해당 요청이 없다면 먼저 트래픽 진입점을 확인합니다. 요청은 있지만 연결에 실패했다면 DNS, 노드, 대상 서비스 순으로 살펴보세요. 로그 수준을 일시적으로 높이면 단서를 더 얻을 수 있습니다. 확인이 끝나면 평소 사용하는 수준으로 되돌리세요. 기록을 공유하기 전에 구독 주소, 노드 인증 정보, 개인적인 접속 내역을 삭제하세요.
설정 페이지에서 구독 주소, 로컬 파일, 현재 활성화된 설정을 관리합니다. 가져오기에 성공한 뒤 해당 항목을 선택하고 프록시 페이지에 예상한 프록시 그룹이 표시되는지 확인하세요. 구독 링크를 저장하는 것만으로 코어 설정이 전환되지는 않습니다. 원격 업데이트는 구독 파일에 직접 작성한 변경 사항을 덮어쓸 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 오버라이드나 병합 기능을 사용하세요. 구독 변환은 원본 설정을 변환 서비스에 전달하는 과정이므로 처리 범위와 신뢰성을 먼저 확인해야 합니다. 소스를 바꾸기 전에 복구 가능한 설정 사본을 보관하되 인증 정보가 포함된 파일을 공개 저장소에 올리지 마세요.
먼저 최소한의 설정으로 재현 가능한 연결을 한 번 만든 뒤 규칙과 트래픽 처리 범위를 넓히세요. 그러면 문제가 생겨도 처음부터 원인을 추측할 필요 없이 마지막으로 확인된 설정으로 되돌아갈 수 있습니다.
기기 아키텍처에 맞는 클라이언트를 설치한 뒤 설정 페이지에서 URL 또는 로컬 파일 가져오기를 선택하세요. 파싱이 끝나면 해당 항목을 선택하고 프록시 페이지에서 예상한 프록시 그룹이 표시되는지 확인합니다. 가져오기에 실패하면 주소에 접속할 수 있는지, 응답이 설정 파일인지, 현재 코어가 해당 필드를 지원하는지 먼저 살펴보세요.
구독 주소에는 접속 인증 정보가 포함될 수 있습니다. 복사할 때 불필요한 공백을 넣지 말고 전체 주소를 공개 게시판에 올리지 마세요. 기존 클라이언트 설정이 있다면 먼저 사본을 저장하세요. 구독 소스 변경과 트래픽 진입점 변경을 나눠 진행하면 여러 항목을 한꺼번에 바꿔 원인을 파악하기 어려워지는 상황을 피할 수 있습니다.
프록시 페이지에서 사용할 아웃바운드를 선택하고 규칙 모드를 유지한 다음 현재 운영체제에 적합한 트래픽 진입점을 켜세요. 데스크톱 앱은 먼저 시스템 프록시를 사용해 볼 수 있습니다. 다른 앱까지 처리해야 한다면 안내에 따라 TUN을 설정하세요. 모바일 기기에서는 시스템 안내에 따라 VPN 권한을 승인하고, 다른 연결이 관련 기능을 사용 중인지 확인하세요.
노드 지연 시간은 특정 속도 측정 요청의 결과일 뿐 다운로드 속도나 모든 웹사이트의 이용 품질을 나타내지는 않습니다. 먼저 연결을 정상적으로 설정할 수 있는 아웃바운드를 선택하고 실제로 이용할 서비스에 접속해 확인한 뒤 자동 선택 정책을 검토하세요. 지연 시간이 낮게 표시된다는 이유만으로 규칙이 제대로 적용되었다고 판단하지 마세요.
대상 페이지나 앱을 다시 열고 연결 페이지에서 해당 요청을 찾아 대상, 매칭 규칙, 실제 아웃바운드를 확인하세요. 로컬 서비스에 계속 접속할 수 있는지도 점검해야 합니다. 클라이언트가 실행 중이라는 사실만으로 앱이 프록시를 사용한다고 볼 수 없습니다. 진입점, 규칙, 아웃바운드가 서로 맞아야 설정이 의도대로 작동하는지 확인할 수 있습니다.
연결에 실패하면 현재 오류 기록을 보존한 뒤 설정, 진입점, DNS, 노드를 하나씩 확인하세요. 프록시를 끈 뒤 시스템 네트워크가 복구되는지도 확인해야 합니다. 원격 근무나 LAN 기기 접속이 필요하다면 인트라넷 도메인과 주소를 처리하는 규칙도 점검하세요. 일상 업무 중 라우팅 충돌이 발생하는 일을 예방할 수 있습니다.
Clash는 설정, 규칙, 아웃바운드를 기반으로 하는 프록시 도구 생태계이며, 클라이언트마다 서로 다른 프로젝트입니다. 기능 지원 여부를 판단하려면 인터페이스 프로젝트, 사용 중인 코어, 현재 설정을 함께 확인해야 합니다. 이름이 비슷하다는 이유만으로 결론을 내려서는 안 됩니다.
원본 Clash의 규칙 설정 방식은 여러 데스크톱·모바일 클라이언트에 영향을 주었습니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티에서 코어와 인터페이스 프로젝트를 독립적으로 이어 왔습니다. 이 과정에서 프로토콜 지원, DNS 동작, 설정 필드, 시스템 연동에 차이가 생겼습니다. 오래된 가이드는 기본 개념을 익히는 데 도움이 되지만, 다운로드 경로와 권한 설정 절차, 메뉴 화면은 현재 사용하는 클라이언트와 다를 수 있습니다.
따라서 클라이언트를 선택할 때는 먼저 유지 관리 상태와 운영체제 지원 여부를 확인하고 필요한 프로토콜을 지원하는지 살펴보세요. 보관된 클라이언트 정보는 기존 환경과의 호환성을 확인할 때 참고할 수 있지만, 가이드 화면이 익숙하다는 이유만으로 새 설치에 우선 사용해서는 안 됩니다. 오래된 설정을 불러오지 못하면 원본 파일을 보관하고 오류 내용을 확인한 뒤 현재 코어의 필드 설명에 따라 옮기세요. 인식할 수 없는 항목을 모두 삭제하는 방식은 피해야 합니다.
그래픽 클라이언트는 설정 관리, 메뉴 막대·트레이 진입점, 시스템 프록시 전환, 권한 연동을 담당합니다. 코어는 설정을 파싱하고 규칙을 매칭하며 아웃바운드 연결을 만듭니다. mihomo는 Clash Meta의 후속 프로젝트에서 사용하는 이름이며 코드와 설정 문서를 공개적으로 확인할 수 있습니다. 어떤 클라이언트가 이 코어를 사용하더라도 코어의 모든 기능이 그래픽 설정 화면에 노출된다는 뜻은 아닙니다. 기본 설정에서 관련 기능이 활성화되어 있다는 의미도 아닙니다.
예를 들어 프로세스 매칭에는 운영체제와 권한이 필요하고, 규칙 모음을 사용하려면 올바른 리소스 주소와 정책 참조가 필요합니다. DNS 동작은 설정과 트래픽 처리 방식에 따라 달라집니다. 기능 이름을 발견하면 먼저 클라이언트 설정인지 코어 필드인지 구분한 다음 해당 문서를 확인하세요. 이렇게 하면 인터페이스에 버튼이 없다고 코어가 지원하지 않는다고 오해하거나 다른 클라이언트 전용 오버라이드 형식을 그대로 적용하는 일을 피할 수 있습니다.
클라이언트를 설치하면 로컬 도구를 사용할 준비가 끝납니다. 노드 인증 정보, 프록시 그룹, 규칙은 선택한 설정에서 제공되며 실제 연결은 서비스 상태, 로컬 네트워크, 대상 사이트, 라우팅의 영향을 받습니다. 이 사이트는 클라이언트 다운로드 경로와 설정 안내를 제공하지만 구독 제공업체의 계정을 관리하지 않으며 화면에 표시된 지연 시간 하나로 접속 품질을 보장하지 않습니다. 설정을 사용하기 전에 출처와 사용 권한, 유효 기간을 확인하세요.
Clash 구독을 변환하면 원본 주소가 변환 서비스에 노출될 수 있습니다. 클라이언트에서 직접 읽을 수 있는 호환 설정이라면 먼저 바로 가져오기를 시도하세요. 변환이 꼭 필요하다면 서비스의 신뢰성, 지원 필드, 규칙 처리 방식을 확인하세요. 문제를 공유할 때는 필요한 부분만 민감 정보를 가려서 제공하고 노드 비밀번호, 구독 주소, 개인 접속 기록이 담긴 전체 로그는 공개하지 마세요.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 주로 인터페이스와 시스템 연동을 바꾸고, 코어 업데이트는 프로토콜 지원과 설정 파싱에 영향을 줄 수 있습니다. 구독 업데이트는 노드, 프록시 그룹, 규칙을 교체합니다. 문제를 처리할 때는 마지막으로 변경한 계층을 기록하고 복구 가능한 설정을 보관하세요. 모든 구성 요소를 한꺼번에 업데이트하는 것보다 원인을 파악하기 쉽습니다.
다른 기기로 옮길 때는 먼저 대상 운영체제의 아키텍처와 권한 요구 사항을 확인한 다음 호환되는 설정을 가져오세요. 사용자 지정 규칙은 클라이언트가 지원하는 오버라이드 방식으로 저장해야 원격 구독에 덮어쓰이지 않습니다. 업데이트가 끝나면 같은 대상을 기준으로 연결 경로와 로컬 네트워크 접속을 다시 확인하세요. 이전 설정을 보존할 수 있다고 해서 새 환경에서도 똑같이 작동하는 것은 아닙니다.
소스 코드 저장소에서 코어 구현, 설정 문서, 공개 이슈 기록을 확인할 수 있습니다. 아래 명령은 소스 코드만 가져오며 그래픽 클라이언트를 설치하거나 시스템 프록시를 자동 설정하지 않습니다. 일반 사용자는 위의 클라이언트 다운로드 경로를 이용하세요.
MetaCubeX / mihomo 저장소 방문 ↗git clone https://github.com/MetaCubeX/mihomo.git
첫 연결을 마친 뒤 트래픽이 클라이언트에 들어오는 과정, 속도 측정 결과의 의미, 코어별 설정 차이를 알아보세요. 실제로 마주친 문제에 맞춰 확인하면 됩니다. 첫 설치 때 모든 고급 옵션을 바꿀 필요는 없습니다.
mihomo(구 Clash Meta)의 프로토콜 지원, rule-providers, 스니핑, DNS 설정 확장 사항을 정리하고 기존 설정을 옮길 때 주의할 필드 차이를 안내합니다.
트래픽이 클라이언트에 들어오는 경로를 기준으로 앱의 시스템 프록시 설정 준수 여부와 네트워크 계층에서 트래픽을 처리하는 TUN의 차이를 비교합니다. 호환성, DNS 처리, 사용 사례도 다룹니다.
url-test 요청에서 시간을 측정하는 범위를 분석하고 핸드셰이크, 측정 URL, 동시 요청, 회선 혼잡이 표시값과 실제 체감 속도에 차이를 만드는 이유를 설명합니다. 노드를 합리적으로 판단하는 방법도 안내합니다.