Windows
데스크톱 업무, 브라우저, 명령줄을 함께 사용하는 환경에 적합합니다. 설치 후에는 보통 먼저 구독을 가져온 다음 시스템 프록시를 켭니다. 더 많은 앱을 적용해야 한다면 권한 조건을 확인해 서비스 모드나 TUN을 활성화할 수 있습니다. 다운로드 페이지에는 그래픽 클라이언트와 보관된 클라이언트도 함께 정리되어 사용 방식에 따라 선택할 수 있습니다.
오픈 소스 코어 생태계 · 전 플랫폼 클라이언트
Android, iOS, Windows, macOS, Linux 클라이언트를 한곳에서 찾고, 단계별로 구독 가져오기, 규칙 분배 및 네트워크 트래픽 전달을 설정하세요. 설정 파일 구조, DNS 동작, 자주 발생하는 연결 문제도 함께 설명해 설치 후 바로 사용할 수 있도록 돕습니다.
터널 콘솔
Clash의 핵심은 단순한 연결 스위치 하나가 아닙니다. 규칙, 전략 그룹, DNS, TUN의 관계를 이해해야 다양한 네트워크 환경에서도 설정을 읽고 조정하며 문제를 추적할 수 있습니다.
RULE ENGINE
규칙 모드는 위에서 아래로 규칙을 읽고, 처음 일치한 항목을 해당 전략 그룹에 전달합니다. 도메인 규칙은 일반적인 사이트에 적합하고, IP 규칙은 대상 주소가 이미 해석된 연결에 사용하며, 프로세스 규칙은 특정 앱의 트래픽을 따로 분배할 수 있습니다. 전체 켜기/끄기만 가능한 시스템 프록시와 달리 Clash 설정은 판단 조건을 텍스트 파일에 기록하므로 결과를 검토하기 쉽고 휴대폰과 컴퓨터에서 재사용하기도 편합니다. 조정할 때는 우선순위가 높고 범위가 좁은 규칙을 앞에 배치한 뒤, 남은 트래픽을 MATCH로 처리하세요.
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- GEOIP,CN,DIRECT
- MATCH,Proxy
POLICY GROUP
전략 그룹은 규칙과 실제 노드 사이의 중간 계층입니다. 수동 선택 그룹은 출구를 직접 지정해야 할 때 적합하고, 자동 선택 그룹은 클라이언트가 지원하는 테스트 방식에 따라 사용 가능한 대상을 선택합니다. 장애 조치 그룹은 후보를 순서대로 확인하다 현재 대상이 unavailable하면 전환합니다. 규칙은 전략 그룹 이름만 참조하므로 노드를 바꿀 때 규칙을 하나씩 수정할 필요가 없습니다. 각 규칙에 노드를 직접 적는 방식보다 구독 업데이트에 적합하며, 설정 파일의 역할도 명확하게 유지됩니다.
proxy-groups:
- name: Proxy
type: select
proxies:
- Auto
- DIRECT
DNS PIPELINE
DNS 설정은 도메인을 어디서 해석할지, 결과를 규칙 엔진에 어떻게 전달할지, 로컬 네트워크에 문제가 있을 때 어떤 대체 경로를 사용할지 결정합니다. Fake-IP 모드는 먼저 매핑 주소를 반환한 뒤 코어가 원래 도메인을 복원해 매칭하므로 안정적인 도메인 규칙이 필요한 환경에 적합합니다. redir-host는 기존 DNS 흐름에 더 가깝습니다. 설정할 때는 시스템 암호화 DNS, 브라우저 자체 DNS, 클라이언트 설정이 동시에 작동하지 않는지도 확인해야 요청이 예상 경로를 우회하지 않습니다. 연결은 되지만 웹페이지가 열리지 않는다면 노드를 계속 바꾸기보다 DNS를 먼저 점검하는 편이 좋습니다.
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- system
NETWORK STACK
일부 게임, 명령줄 도구와 독립 실행 런타임은 시스템 프록시 설정을 읽지 않으므로 시스템 프록시만 켜서는 해당 연결을 처리할 수 없습니다. TUN 모드는 가상 네트워크 인터페이스로 더 많은 시스템 트래픽을 받은 뒤 Clash 코어에 DNS 및 규칙 판단을 맡깁니다. 적용 범위가 넓은 대신 시스템 권한, 라우팅 테이블, 다른 VPN 도구의 상태에 더 크게 의존합니다. 처음 활성화할 때는 유사한 네트워크 제어 프로그램을 끄고 권한 요청을 완료한 다음 브라우저, 터미널, 대상 앱을 차례로 테스트하세요. 그래야 권한 충돌을 노드 문제로 잘못 판단하지 않습니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
플랫폼 안내
플랫폼마다 설치 패키지, 권한 모델, 백그라운드 실행 방식이 다릅니다. 먼저 해당 플랫폼으로 이동한 뒤 그래픽 인터페이스, 시스템 아키텍처, 유지 관리 상태를 기준으로 클라이언트를 선택하세요.
데스크톱 업무, 브라우저, 명령줄을 함께 사용하는 환경에 적합합니다. 설치 후에는 보통 먼저 구독을 가져온 다음 시스템 프록시를 켭니다. 더 많은 앱을 적용해야 한다면 권한 조건을 확인해 서비스 모드나 TUN을 활성화할 수 있습니다. 다운로드 페이지에는 그래픽 클라이언트와 보관된 클라이언트도 함께 정리되어 사용 방식에 따라 선택할 수 있습니다.
Intel 및 Apple Silicon 기기용입니다. 처음 실행할 때 네트워크 확장 설치와 시스템 권한 승인이 필요할 수 있으며, 이후 메뉴 막대에서 연결 상태, 전략 그룹, 시스템 프록시를 관리할 수 있습니다.
다운로드 페이지로 이동시스템 VPN 인터페이스로 트래픽을 전달하므로 휴대폰과 태블릿에 적합합니다. 설치할 때 기기 아키텍처에 맞는 패키지를 선택하고 클라이언트를 백그라운드 실행 허용 목록에 추가하면 배터리 절약 정책으로 인한 예기치 않은 연결 끊김을 줄일 수 있습니다.
다운로드 페이지로 이동App Store에서 Clash Plus를 받고 시스템 VPN 설정으로 연결을 관리합니다. 구독을 가져온 뒤 규칙 모드와 전략 그룹을 전환할 수 있으며, 화면이 잠긴 상태에서는 시스템이 네트워크 확장 상태를 통합 관리합니다.
다운로드 페이지로 이동데스크톱 환경에서는 그래픽 클라이언트를 선택할 수 있고, 서버와 라우터 환경에서는 Mihomo 코어를 직접 사용하는 경우가 많습니다. 설치 전에 배포판, 프로세서 아키텍처, 패키지 형식을 확인하세요. 데스크톱 환경이 없다면 설정 디렉터리, 프로세스 감시, 로그 확인, 외부 제어 인터페이스의 접근 범위도 미리 계획해야 합니다.
다운로드 페이지에서 각 플랫폼의 클라이언트 설명, 시스템 요구 사항, 설치 패키지 링크, 자주 발생하는 다운로드 문제를 확인할 수 있습니다.
모든 클라이언트 보기 →빠른 시작
먼저 설정 출처가 유효한지 확인한 뒤 전략을 선택하고 연결을 검증하세요. 처음부터 복잡한 매개변수를 바꾸기보다 반복 가능한 기본 절차를 먼저 만드는 것이 좋습니다.
클라이언트의 설정, 구독 또는 Profiles 페이지를 열고 서비스 제공자가 안내한 구독 주소를 붙여 넣은 다음 업데이트를 실행하세요. 가져오기가 완료되면 설정 이름, 전략 그룹, 규칙 정보가 표시되어야 합니다. 형식 오류가 발생하면 복사한 내용에 불필요한 공백이 없는지 확인하고, 웹페이지 주소나 콘솔 주소를 구독 주소와 혼동하지 마세요. 설정이 아직 유효한데 업데이트에 실패한다면 현재 네트워크에서 구독 출처에 접속할 수 있는지 확인하세요.
대부분의 일상적인 환경에서는 먼저 규칙 모드를 사용해 도메인과 IP 조건에 따라 직접 연결 또는 프록시를 결정하게 하세요. 그런 다음 프록시 또는 전략 페이지에서 주요 전략 그룹의 자동 선택, 장애 조치 또는 특정 노드를 선택합니다. 전역 모드는 대부분의 연결에 같은 전략을 적용하므로 임시 문제 해결에 더 적합하며, 영향 범위를 모르는 상태에서 장기간 사용하는 것은 권장하지 않습니다. 전환 후 홈 화면으로 돌아가 현재 설정과 전략이 모두 선택되었는지 확인하세요.
시스템 프록시 또는 모바일 VPN 스위치를 켜고 시스템 권한 요청을 승인한 다음, 직접 연결되어야 하는 사이트와 프록시가 필요한 대상을 각각 테스트하세요. 브라우저는 작동하지만 다른 앱이 적용되지 않는다면 해당 앱이 시스템 프록시를 읽는지 확인하고, 필요할 때 TUN 모드를 검토하세요. 모든 대상이 열리지 않는다면 구독 상태, 노드 사용 가능 여부, DNS, 포트 사용 여부, 다른 VPN 도구 순서로 점검해야 하며 여러 설정을 동시에 바꾸지 않는 것이 좋습니다.
오픈 소스 생태계
Clash 생태계는 코어, 그래픽 클라이언트, 설정 제공자, 규칙 유지 관리 프로젝트가 함께 구성합니다. 버튼 위치 하나를 외우는 것보다 각 구성 요소의 경계를 이해하는 편이 중요합니다. 클라이언트는 인터페이스와 시스템 통합을 담당하고, 코어는 설정을 해석하고 트래픽을 처리하며, 구독은 노드와 전략을 제공하고, 규칙 세트는 매칭 조건을 정의합니다.
git clone https://github.com/MetaCubeX/mihomo.git
초기 Clash는 널리 쓰이는 설정 문법, 규칙 모델, 전략 그룹 개념을 정립했으며 이후 커뮤니티 코어와 클라이언트가 이를 바탕으로 계속 유지 관리하고 있습니다. 코어마다 지원하는 필드 범위가 완전히 같지는 않으므로 설정을 가져오기 전에 대상 클라이언트가 어떤 코어를 사용하는지와 해당 문법 안내를 확인해야 합니다. 알 수 없는 필드가 나오면 기능 전체를 바로 삭제하기보다 먼저 시작 로그와 설정 해석 오류를 확인하세요.
그래픽 클라이언트는 설치, 메뉴, 시스템 프록시, VPN 권한, 구독 업데이트, 화면 조작을 처리하고, Mihomo 같은 코어는 포트 수신, 규칙 실행, DNS 관리, 프록시 연결 수립을 담당합니다. 이름이 비슷한 클라이언트라도 기능이 완전히 같지는 않으므로 플랫폼 지원, 시스템 통합 방식, 코어 종류, 유지 관리 상태를 비교해 선택해야 합니다. 화면 모양만 보고 결정해서는 안 됩니다.
YAML 설정은 포트, DNS, 전략 그룹, 규칙을 읽을 수 있는 텍스트로 기록합니다. 문제가 발생하면 원인을 구독 내용, 규칙 순서, DNS 경로, 시스템 권한 중 하나로 좁힐 수 있습니다. 규칙 세트 구독은 많은 도메인 항목을 중앙에서 관리할 때 적합하고, 로컬 오버라이드는 기기별 설정을 보존할 때 유용합니다. 두 계층을 나누면 구독 업데이트가 개인 설정을 덮어쓸 가능성이 줄어듭니다.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 세트 업데이트는 서로 다른 네 가지 경로입니다. 클라이언트를 업그레이드한 뒤에는 시스템 권한과 설정 호환성을 확인하고, 구독 업데이트 후에는 전략 그룹 이름이 바뀌었는지 점검해야 합니다. 규칙 세트를 업데이트할 때는 참조 주소와 동작 차이도 살펴보세요. 모든 구성 요소를 한 번에 교체하기보다 계층별로 업데이트하고 검증하는 편이 문제 위치를 찾기 쉽고 여러 기기의 설정을 장기적으로 관리하기에도 적합합니다.
설정 문서
여러 기기 동기화부터 macOS 권한, Windows 설치 과정까지 실제 사용 흐름에 따라 핵심 선택과 중단되기 쉬운 지점을 정리했습니다.
휴대폰, 컴퓨터, 태블릿에 클라이언트를 각각 설치한 뒤에는 설정 일관성이 규칙과 전략에 직접 영향을 줍니다. 구독 링크를 통한 중앙 배포, WebDAV 백업, 수동 가져오기와 내보내기의 차이를 비교하고, 동기화하기 좋은 항목과 기기에만 보관해야 할 설정을 설명합니다.
본문 읽기처음 실행할 때 네트워크 확장, 시스템 설정, 키체인 안내가 연이어 나타날 수 있습니다. 각 팝업의 용도를 승인 순서에 따라 설명하고, 권한이 적용되지 않거나 확장이 중복 설치되거나 시스템 프록시를 전환할 수 없을 때의 초기화 방법을 정리했습니다.
본문 읽기설치 패키지 선택, Windows 보안 경고 처리, 구독 가져오기, 시스템 프록시 활성화, 규칙 매칭 확인까지 Windows 설정의 전체 흐름을 안내합니다. 포트 충돌, 권한 부족, 중복 프록시 도구를 점검하는 순서도 설명합니다.
본문 읽기문서 목록에는 Android 백그라운드 배터리 소모와 연결되었지만 인터넷이 되지 않을 때의 단계별 점검표도 포함되어 있습니다.
모든 문서 보기 →