Windows
그래픽 클라이언트로 설정, 시스템 프록시와 TUN을 관리하기 좋습니다. 다운로드 전에 x64와 ARM64를 구분하고, TUN을 처음 켤 때는 관리자 권한과 가상 네트워크 인터페이스 설치 안내를 확인하세요.
다운로드 페이지로 이동적합한 클라이언트를 선택한 뒤 모든 플랫폼에서 설치, 구독 가져오기, 라우팅 규칙 설정을 차례로 진행합니다. Mihomo 코어, 시스템 프록시, TUN, DNS와 로그의 관계도 설명하므로 증상에 따라 설정 문제를 찾을 수 있습니다.
Clash 사용 과정은 서로 연결된 네 단계의 실험 기록으로 나눌 수 있습니다. 먼저 클라이언트가 트래픽을 제대로 처리하게 한 뒤 규칙 매칭을 확인하고, DNS를 조정한 다음 연결 기록과 로그로 문제 범위를 좁힙니다.
클라이언트를 설치했다고 모든 프로그램이 Clash를 거치는 것은 아닙니다. 시스템 프록시는 일반적으로 운영체제 프록시 설정을 따르는 브라우저와 데스크톱 앱에 적용되며, TUN 모드는 가상 네트워크 인터페이스를 통해 더 광범위한 연결을 처리합니다. 처음 설정할 때는 한 가지 진입 방식을 선택하고 권한 요청을 처리한 다음, 연결 목록에서 요청이 코어로 들어오는지 확인하세요.
그래픽 클라이언트마다 메뉴 이름은 다를 수 있지만 확인 방법은 같습니다. 설정 프로필이 활성화되어 있어야 하고, 필요에 따라 시스템 프록시나 TUN 중 하나 이상을 켜야 하며, 연결 화면에 새 요청이 표시되어야 합니다. 이렇게 하면 ‘프로그램이 트래픽을 처리하지 못하는 문제’와 ‘규칙이 잘못된 정책을 선택한 문제’를 분리해 처음부터 노드를 반복해서 바꾸는 일을 피할 수 있습니다.
규칙 모드에서 중요한 것은 규칙 수가 아니라 순서와 대상 정책입니다. 하나의 도메인이 정확한 도메인, 도메인 접미사, 규칙 세트, 최종 규칙에 동시에 해당할 수 있습니다. 코어는 설정 순서대로 검사해 처음 일치한 결과를 적용합니다. 라우팅을 점검할 때는 웹페이지가 열리는지만 보지 말고 연결 상세 정보에서 일치한 규칙 유형, 정책 그룹 이름과 최종 노드를 기록해야 합니다.
정책 그룹은 규칙의 판단 결과를 실제 아웃바운드로 변환합니다. 수동 선택 방식은 고정된 아웃바운드에 적합하고, 상태 확인 방식은 여러 후보의 가용성을 지속적으로 판단할 때 적합합니다. 정책 그룹 이름은 규칙 대상과 일치해야 하며 그룹 안에도 정상 작동하는 후보가 있어야 합니다. 그렇지 않으면 규칙이 올바르더라도 사용할 수 없는 경로가 선택될 수 있습니다.
rules:
- DOMAIN,example.org,DIRECT
- DOMAIN-SUFFIX,example.net,PROXY
- GEOSITE,category-ads-all,REJECT
- MATCH,PROXY
DNS는 도메인이 어떤 결과로 먼저 조회되는지를 결정하며, 도메인 기반 규칙이 충분한 정보를 얻을 수 있는지에도 영향을 줍니다. 브라우저 내장 보안 DNS, 시스템 캐시, 공유기의 DNS와 Clash DNS가 동시에 작동할 수 있습니다. 한 계층만 변경하면 브라우저와 명령줄의 결과가 다르거나 일부 앱만 정상 작동하는 문제가 자주 발생합니다.
진단할 때는 먼저 요청에 사용된 도메인을 기록한 다음 클라이언트 로그에서 DNS 서버, 반환 주소와 일치한 규칙을 확인하세요. fake-ip를 사용하면 앱에는 매핑된 주소가 보이고 실제 DNS 조회와 아웃바운드 선택은 코어가 계속 처리하므로, 앱에 표시된 주소만으로 문제를 판단해서는 안 됩니다. LAN 장치나 특수 도메인에서 문제가 생길 때만 제외 범위를 별도로 설정하세요.
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip
nameserver:
- 1.1.1.1
- 8.8.8.8
‘인터넷이 안 됨’은 결과일 뿐 원인을 바로 판단할 수 있는 정보는 아닙니다. 안정적인 점검 순서는 요청이 Clash에 들어오는지 확인하고, 도메인 조회가 완료되는지 확인한 다음, 규칙이 어느 정책과 일치했는지 보고, 마지막으로 해당 정책의 아웃바운드가 연결을 맺을 수 있는지 확인하는 것입니다. 한 번에 변수 하나만 바꿔야 어떤 조정으로 문제가 해결됐는지 알 수 있습니다.
로그 수준을 항상 상세 모드로 유지할 필요는 없습니다. 문제를 재현하기 전에 일시적으로 로그 수준을 높이고 시간, 대상 도메인, 앱 이름과 현재 모드를 기록한 뒤 확인이 끝나면 기본 수준으로 복원하세요. 구독에는 서버 주소, 인증 정보와 정책 이름이 포함될 수 있으므로 전체 설정을 공개하지 않아야 합니다.
동일한 Mihomo 라우팅 규칙 기능을 여러 그래픽 클라이언트에서 사용할 수 있습니다. 운영체제, 프로세서 아키텍처와 유지 관리 상태를 먼저 확인한 뒤 UI 방식, TUN 권한과 설정 관리 방법을 비교하세요. 아래 항목은 다운로드 페이지의 해당 플랫폼으로 이동할 뿐 설치 파일로 직접 연결되지는 않습니다.
그래픽 클라이언트로 설정, 시스템 프록시와 TUN을 관리하기 좋습니다. 다운로드 전에 x64와 ARM64를 구분하고, TUN을 처음 켤 때는 관리자 권한과 가상 네트워크 인터페이스 설치 안내를 확인하세요.
다운로드 페이지로 이동Intel과 Apple Silicon에 맞는 설치 패키지를 선택해야 합니다. 시스템 프록시는 일반적인 데스크톱 앱에 적합하며 TUN에는 추가 시스템 권한이 필요합니다. 처음 실행할 때는 시스템 안내에 따라 앱 출처도 확인해야 합니다.
다운로드 페이지로 이동클라이언트는 일반적으로 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. 설정을 가져온 뒤 VPN 권한, 백그라운드 실행과 배터리 정책을 확인해 화면이 잠겼을 때 시스템이 서비스를 중단하거나 프로세스를 종료하지 않도록 하세요.
다운로드 페이지로 이동App Store에서 Clash Plus를 설치하고 시스템 VPN 설정으로 연결합니다. 처음 실행할 때 VPN 구성 추가를 허용한 다음 구독을 가져오고 정책 그룹 선택을 확인하세요.
다운로드 페이지로 이동데스크톱에서는 그래픽 클라이언트를 사용할 수 있고, 서버와 라우터 장치에서는 Mihomo 코어를 직접 실행하는 경우가 많습니다. 설치 전에 배포판 패키지 형식, CPU 아키텍처와 서비스 관리 방식을 구분하세요.
다운로드 페이지로 이동처음부터 복잡한 규칙을 수정할 필요는 없습니다. 반복해서 검증할 수 있는 기준 상태부터 만드세요. 설정이 업데이트되고, 트래픽이 코어에 들어가며, 대상 연결이 예상한 정책과 일치해야 합니다. 세 항목을 모두 확인한 뒤 DNS, TUN과 정책 그룹을 단계적으로 조정하세요.
클라이언트의 설정 또는 구독 화면에 서비스 제공업체가 제공한 구독 URL을 붙여 넣고 다운로드하거나 업데이트하세요. 정상적으로 가져오면 설정 목록에 새 항목이 표시되며 이를 현재 활성 설정으로 지정해야 합니다. 목록이 바뀌지 않으면 URL이 완전한지, 네트워크에서 접속할 수 있는지, 클라이언트 로그에 다운로드 오류가 있는지 먼저 확인하세요.
설정 이름이 표시되고 정책 그룹과 규칙이 클라이언트에 로드되며 업데이트 결과가 명확하게 표시됩니다.
첫 테스트에서는 규칙 모드를 우선 사용하고 주요 정책 그룹에서 사용 가능한 아웃바운드를 선택하세요. 데스크톱에서는 적용할 앱 범위에 따라 시스템 프록시 또는 TUN을 켜고, 모바일에서는 시스템의 VPN 연결 생성을 허용합니다. 활성화한 뒤 일반 웹페이지에 접속하면서 연결 화면에 도메인, 대상 주소, 일치한 규칙과 정책 이름이 표시되는지 확인하세요.
새 연결이 기록 화면에 계속 추가되고 정책 열에 DIRECT, PROXY 또는 구체적인 정책 그룹이 표시됩니다.
직접 연결될 것으로 예상되는 사이트와 프록시를 거칠 것으로 예상되는 사이트를 각각 테스트해 두 연결에 일치한 규칙과 최종 아웃바운드를 비교하세요. 페이지가 열리지 않으면 진입, DNS, 규칙, 아웃바운드 순서로 결과를 기록하세요. 모드, 노드와 DNS를 동시에 바꾸면 문제가 해결된 뒤에도 실제 원인을 찾기 어렵습니다. 기준 상태를 만든 다음 전체 가이드에서 플랫폼별 차이와 오류 해결 방법을 확인하세요.
두 요청 유형의 라우팅 결과가 예상과 일치하고 클라이언트를 종료하면 시스템 네트워크 설정이 정상적으로 복원됩니다.
Clash는 프록시 항목, 정책 그룹, 규칙, DNS와 트래픽 진입 방식을 핵심 개념으로 하는 널리 쓰이는 YAML 설정 구조를 만들었습니다. 초기 프로젝트의 업데이트가 중단된 뒤에도 생태계가 하나의 클라이언트로 고정되지는 않았습니다. 여러 개발자가 코어, 데스크톱 UI와 모바일 도구를 계속 개발하고 있으며 프로젝트의 변화에 따라 설정 호환 범위도 달라집니다. 따라서 클라이언트를 선택할 때는 코어의 출처와 유지 관리 상태를 함께 확인해야 합니다.
Mihomo는 현재 활발히 개발되는 Clash 호환 코어 중 하나로, 널리 쓰이는 설정 구조를 이어받아 규칙, 정책 그룹, TUN, DNS 등의 네트워크 기능을 계속 관리합니다. 그래픽 클라이언트는 설치 환경, 설정 관리, 시스템 권한과 상태 표시를 담당하고, 코어는 설정 해석, 연결 수립과 규칙 실행을 담당합니다. 역할이 서로 다르므로 UI 버전이 업데이트됐다고 코어 기능도 동시에 바뀌는 것은 아닙니다.
오픈 소스 저장소에서는 소스 코드, 릴리스 기록, 이슈 토론과 변경 사항을 확인할 수 있습니다. 문서를 읽을 때 기능 이름이나 설정 필드로 저장소를 검색하면 해당 옵션이 여전히 지원되는지 확인할 수 있습니다. 설정 파싱에 실패하면 로그의 필드 이름과 줄 번호가 UI 안내보다 구체적인 경우가 많습니다. 동작이 달라졌다면 클라이언트 버전, 코어 버전과 설정 업데이트 시점을 비교하세요.
이 사이트는 플랫폼별 진입 경로, 설치 단계, 설정 개념과 문제 증상을 구분해 업데이트합니다. 다운로드 페이지에는 클라이언트와 시스템 요구 사항을 정리하고, 가이드 페이지에는 순서대로 실행할 수 있는 핵심 절차를 제공합니다. 플랫폼별 설치 문서에는 권한과 고유 문제를 기록하며 블로그에서는 지연 시간 테스트, 정책 그룹, 모바일 백그라운드 실행, 라우터 배포 같은 개별 주제를 자세히 다룹니다.
각 글은 하나의 구체적인 문제를 중심으로 핵심 가이드에서 자세히 다루기 어려운 원리, 플랫폼별 차이와 문제 해결 과정을 설명합니다. 먼저 기본 설정을 마친 뒤 연결 기록을 참고해 실험을 재현해 보세요.
첫 실행, 구독 가져오기, 프록시 모드 선택과 시스템 권한 확인 과정을 정리하고 Windows, macOS와 모바일에서 놓치기 쉬운 초기 설정을 설명합니다.
전체 글 읽기 →탐지 요청, 연결 수립, 회선 혼잡과 앱 데이터 전송을 구분해 지연 시간 수치의 의미와 노드를 선택할 때 함께 확인해야 할 조건을 설명합니다.
전체 글 읽기 →상시 VPN, 규칙 매칭, 백그라운드 활성화와 시스템 절전 정책을 점검해 Android 및 iOS의 배터리 과소모 원인을 찾고 정상적인 상시 실행과 비정상 활동을 구분합니다.
전체 글 읽기 →