구독, 시스템 프록시, TUN을 데스크톱에서 관리하기에 적합합니다. 기기 아키텍처와 시스템 요구 사항을 확인한 뒤 클라이언트 안내에 따라 설치하세요. 브라우저는 시스템 프록시를 사용할 수 있지만 터미널이나 일부 게임은 그렇지 않을 수 있습니다. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN 권한과 라우팅 설정을 확인하세요. Clash for Windows는 유지 관리가 중단되어 다운로드 페이지에서 보관용 선택지로 별도 표시합니다.
mihomo 코어 · 모든 플랫폼용 클라이언트
Clash 정품 공식 사이트 클라이언트 다운로드 및 규칙 설정
구독 가져오기부터 규칙 기반 라우팅까지, 플랫폼에 맞는 클라이언트를 선택하고 연결 경로에 따라 설정을 확인하세요.
오픈소스 코어
한국어 문서
단계별 문제 해결
CLIENT SELECTION
Clash 플랫폼별 다운로드
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. 다운로드 페이지에서 설치 링크와 시스템 요구 사항, 유지 관리 상태를 한눈에 확인할 수 있습니다.
데스크톱과 모바일은 화면과 조작 방식이 다르지만 설정 흐름은 비슷합니다. 사용 가능한 구독을 가져오고 해당 설정을 활성화한 다음, 프록시 그룹을 선택하고 트래픽 처리 방식을 지정하세요. 처음 설치한다면 Clash Plus 플랫폼별 안내부터 확인해 보세요. Linux 사용자는 Clash Verge Rev와 FlClash를 비교할 수 있습니다. 현재 클라이언트가 정상적으로 작동한다면 이름이 다르다는 이유만으로 설정을 옮길 필요는 없습니다.
Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택하세요. 처음 실행할 때는 시스템에서 요구하는 권한을 허용한 뒤 구독을 가져오세요. 권한 문제를 노드 오류로 오해하지 않도록 주의해야 합니다. 시스템 프록시를 사용한다면 네트워크 위치나 다른 네트워크 도구가 설정을 덮어쓰지 않는지 확인하세요. 클라이언트를 종료한 뒤에는 시스템 프록시가 원래대로 복구되었는지도 살펴보세요. ClashX Meta는 유지 관리가 중단되었으므로 향후 호환성도 고려해야 합니다.
설치 전에 프로세서 아키텍처를 확인하고, 처음 실행할 때 VPN 연결을 허용하세요. Android는 일반적으로 VPN 서비스를 통해 트래픽을 처리하므로 데스크톱의 시스템 프록시 설정을 그대로 적용할 수 없습니다. 화면을 잠근 뒤 연결이 끊긴다면 노드를 바꾸기 전에 배터리 최적화, 백그라운드 실행 권한, 다른 VPN 앱과의 충돌부터 확인하세요. 앱별로 트래픽을 분리하려면 클라이언트가 해당 옵션을 제공하는지도 살펴보세요.
다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하고 공식 사이트 clashplus.io도 확인하세요. 설치한 뒤 시스템 안내에 따라 VPN 설정 추가를 허용하고 클라이언트와 호환되는 구독을 가져오세요. 앱마다 지원하는 규칙 문법이 다를 수 있으므로 설정 파일 확장자만으로 호환성을 판단할 수 없습니다. 가져오기 오류가 발생하면 구독 형식과 구체적인 오류 메시지부터 확인하세요.
데스크톱 환경에서는 먼저 그래픽 클라이언트를 선택하고, 서버나 라우터에서는 mihomo를 별도로 설치하는 방법을 고려하세요. 설치할 때는 배포판의 패키지 형식, 프로세서 아키텍처, 권한 요구 사항을 확인해야 합니다. 명령줄 프로그램은 데스크톱 시스템 프록시를 사용하지 않을 수 있습니다. systemd로 실행한다면 설정 디렉터리, 실행 사용자, 로그 위치도 데스크톱 앱과 다르므로 실제 서비스 환경을 기준으로 문제를 해결하세요.
RULE ENGINE
Clash 규칙 기반 라우팅
먼저 구체적인 도메인 규칙을 작성하고, 그다음 지역별 규칙과 기본 정책을 배치하세요. mihomo는 일반적으로 규칙을 위에서부터 확인하고, 일치하는 규칙을 찾으면 지정된 정책으로 트래픽을 보냅니다. 구체적인 도메인 규칙을 포괄적인 규칙보다 앞에 두어야 먼저 가로채이는 일을 막을 수 있습니다. 설정에 적은 정책 이름은 정의된 프록시 그룹과 일치해야 합니다. YAML 문법이 맞더라도 이름이 다르면 설정을 불러오지 못할 수 있습니다.
평소에는 작동하는 설정을 하나 유지하고 필요한 대상만 변경하세요. 수정한 뒤에는 모드 버튼이 켜져 있는지만 보지 말고 연결 기록에서 일치한 규칙과 최종 출구를 확인해야 합니다. Fake-IP는 도메인 매핑을 유지하기 위해 합성 주소를 사용하며 모든 요청을 강제로 프록시하는 기능은 아닙니다. 실제 연결 경로는 규칙, DNS, 트래픽 처리 범위에 따라 결정됩니다. 오른쪽 예시는 규칙 순서만 보여 주며 기존 전체 설정에 추가해서 사용해야 합니다.
규칙 설정 단계 보기 →config.yaml / rules
# PROXY는 전체 설정에서 정의해야 합니다
rules:
- DOMAIN-SUFFIX,example.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY도메인 규칙 → 지역 규칙 → 기본 정책
PROXY GROUPS
프록시 그룹과 노드 선택
규칙은 트래픽을 어느 그룹으로 보낼지 정하고, 프록시 그룹은 어떤 출구를 사용할지 결정합니다. 수동 선택 그룹은 특정 지역을 고정하거나 서비스 세션을 유지할 때 적합합니다. 자동 테스트 그룹은 측정 결과에 따라 경로를 선택하고, 장애 조치 그룹은 설정된 순서대로 사용 가능한 출구를 찾습니다. 각 자동 전환 방식에는 고유한 조건이 있으며, 어떤 상황에서든 가장 빠른 노드를 고른다는 뜻은 아닙니다.
먼저 수동 그룹으로 노드가 작동하는지 확인한 뒤 자동 정책을 설정하면 설정 오류와 속도 측정 문제를 구분하기 쉽습니다. 노드를 비교할 때는 출구 지역, 트래픽 배수, 대상 서비스 접속 가능 여부, 실제 전송 품질을 함께 확인하세요. 한 번 측정한 지연 시간은 측정 주소와 네트워크 상태에 따라 달라지므로 모든 사이트의 속도를 대표하지 않습니다. 로그인 세션이 중요한 앱에서는 지연 시간이 가장 낮은 노드를 계속 쫓기보다 안정적인 출구를 선택하는 편이 낫습니다. 검증된 대체 노드도 하나 마련해 두세요.
자동 프록시 그룹 3가지 비교 →먼저 출구 하나를 확인한 다음 자동 선택 방식을 설정하세요.
TRAFFIC CAPTURE
TUN 및 시스템 프록시 설정
시스템 프록시는 해당 설정을 사용하는 앱에 적합합니다. 설정이 간단하고 요청이 코어로 들어오는 경로도 확인하기 쉽습니다. TUN은 가상 네트워크 인터페이스를 통해 라우팅 범위에 포함된 트래픽을 처리합니다. 시스템 프록시를 사용하지 않는 프로그램에도 적용할 수 있지만 권한, DNS, 라우팅, 다른 네트워크 소프트웨어와의 영향을 고려해야 합니다. 두 방식은 트래픽이 들어오는 경로이며 규칙 모드나 전역 모드와 같은 종류의 모드가 아닙니다.
처음 설정할 때는 시스템 프록시로 브라우저 연결을 확인한 다음 필요에 따라 TUN을 활성화하세요. 브라우저는 정상인데 터미널이 직접 연결된다면 설정이나 구독을 바꾸거나 클라이언트를 다시 설치하기 전에 터미널이 프록시 환경 변수를 읽는지 확인하세요. TUN을 켠 뒤 로컬 네트워크에 접속할 수 없다면 노드를 반복해서 바꾸지 말고 라우팅 제외 항목과 DNS 설정을 확인해야 합니다. 오른쪽은 트래픽 처리 경로를 설명하는 정적인 설정 예시이며 현재 기기의 작동 상태를 나타내지 않습니다.
시스템 프록시가 작동하지 않을 때 →TRAFFIC / 설정 예시
시스템 프록시켜짐 예시
TUN 모드꺼짐 예시
작동 모드rule
먼저 앱의 트래픽이 코어로 들어오는지 확인한 다음 규칙이 적용되었는지 살펴보세요.
PROFILE MAINTENANCE
구독 업데이트 및 설정 관리
구독을 가져온 뒤 해당 설정이 선택되어 있는지 확인하고 노드와 프록시 그룹이 표시되는지 살펴보세요. 업데이트 성공은 내용을 가져와 처리했다는 뜻일 뿐 모든 노드에 연결할 수 있다는 의미는 아닙니다. 노드를 선택한 뒤 원하는 대상에 접속되는지 확인해야 합니다. 자동 업데이트 간격은 서비스 제공자의 정책, 기기 배터리, 네트워크 환경을 고려해 설정하세요. 즉시 반영하려고 반복해서 요청하는 것은 피하는 편이 좋습니다.
원격 설정, 로컬 오버라이드, 규칙 세트는 각각 별도로 업데이트될 수 있습니다. 중요한 변경 사항은 클라이언트가 제공하는 영구 오버라이드 기능에 저장해 다음 구독 갱신 때 수동 편집 내용이 덮어쓰이지 않도록 하세요. 업데이트 후 알 수 없는 필드나 누락된 정책이 나타나면 오류 메시지와 가장 최근에 작동한 백업을 보관하고 호환성을 하나씩 확인하세요. 아래 네 가지 옵션은 작동 방식을 설명합니다. 앞의 세 항목은 매칭 정책을 정하고 TUN은 트래픽 처리 범위를 바꾸며, 실제 인터페이스에서는 보통 각각 따로 설정합니다.
구독 가져오기 및 연결 확인 보기 →PROFILE / 설정 항목 안내
자동 업데이트 간격필요에 따라 설정
로컬 오버라이드별도 관리
규칙: 일상적인 트래픽 분리
요청은 설정에 적힌 규칙을 순서대로 확인한 뒤 해당 프록시 그룹이나 직접 연결 경로로 전달됩니다. 로컬 서비스는 직접 연결하고 지정한 대상은 프록시로 보내는 일상적인 환경에 적합합니다. 연결 기록에서 규칙 유형, 정책 이름, 최종 노드를 확인하세요. 요청이 코어로 들어오지 않으면 규칙을 수정해도 적용되지 않습니다. 전역 모드보다 대상별로 세밀하게 설정할 수 있지만 규칙 순서와 도메인 정보에 더 많은 영향을 받습니다. 구독의 기본 규칙을 유지한 채 필요한 사용자 규칙을 하나씩 추가하면 변경 원인을 파악하기 쉽습니다.
전역: 출구를 한곳에서 확인
코어로 들어오는 요청을 전역 정책 하나로 처리하므로 규칙 분리로 생긴 차이를 일시적으로 확인할 때 적합합니다. 전환한 뒤에도 전역 그룹이 어떤 출구를 선택했는지 확인해야 합니다. 기기의 모든 앱이 자동으로 트래픽 처리 대상이 되는 것은 아닙니다. 전역 모드에서는 접속되지만 규칙 모드에서 실패한다면 일치한 규칙과 프록시 그룹을 비교하세요. 두 모드 모두 실패한다면 노드, 구독, 네트워크 환경을 확인해야 합니다. 테스트가 끝나면 규칙 모드로 되돌려 로컬 네트워크나 원래 직접 연결해야 하는 서비스가 프록시 출구를 계속 사용하지 않도록 하세요.
직접 연결: 기본 네트워크 확인
코어로 들어오는 요청을 직접 연결로 처리하므로 기본 네트워크가 작동하는지 확인하거나 프록시 출구와 로컬 출구의 차이를 비교할 때 적합합니다. 직접 연결 모드에서도 클라이언트가 꺼지는 것은 아니며 가상 네트워크 인터페이스가 종료되지 않을 수도 있습니다. DNS 요청은 현재 코어 설정의 영향을 받을 수 있습니다. 클라이언트를 종료했을 때는 정상인데 직접 연결 모드에서 문제가 생긴다면 노드만 확인하지 말고 DNS와 라우팅도 살펴보세요. 로컬 네트워크에서 원래 접속할 수 있는 대상을 선택해 테스트하고, 완료한 뒤에는 기존 모드로 복구해야 이후 진단에 영향을 주지 않습니다.
TUN: 트래픽 처리 범위 확대
TUN은 가상 네트워크 인터페이스를 통한 트래픽 처리 방식입니다. 규칙 모드와 함께 사용할 수 있지만 네 번째 규칙 매칭 정책은 아닙니다. 라우팅 범위에 포함된 앱의 트래픽을 처리할 수 있으며, 실제 동작은 시스템 권한, 자동 라우팅, DNS 하이재킹, 제외 항목에 따라 달라집니다. 활성화 전에 일반 프록시 연결을 확인하고, 활성화한 뒤에는 웹 브라우저, 터미널, 로컬 네트워크 기기를 각각 점검하세요. 충돌이 발생하면 다른 VPN이나 유사한 트래픽 처리 도구를 먼저 비활성화하세요. 관리자 권한이 필요하면 클라이언트 안내에 따라 진행하고 모든 네트워크 문제를 구독 설정 탓으로 돌리지 마세요.
OPEN SOURCE / MIHOMO CORE
오픈소스 코어와 클라이언트 생태계
인터페이스, 코어, 서비스 제공자를 구분해야 기능의 출처와 업데이트 영향을 정확히 파악할 수 있습니다.
Clash 정품 공식 사이트
클라이언트 다운로드 및 기술 자료
Clash, mihomo, 그래픽 클라이언트
Clash 생태계에는 기존 프로젝트, 계속 발전하는 코어 포크, 코어를 기반으로 만든 그래픽 클라이언트가 함께 있습니다. mihomo는 이 생태계의 오픈소스 프록시 코어로 네트워크 연결, 규칙 매칭, DNS, 정책 처리를 담당합니다. Clash Verge Rev 같은 클라이언트는 구독 관리, 트레이 조작, 시스템 프록시, 권한 연동 기능을 제공합니다. 인터페이스 이름이 다르다고 해서 기반 규칙이 반드시 다른 것은 아니지만, 화면 구성이 비슷해도 같은 기능을 지원한다고 볼 수는 없습니다.
가이드를 읽을 때는 코어 설정 항목을 다루는지 클라이언트 버튼을 설명하는지 먼저 확인하세요. 코어가 지원하는 매개변수도 클라이언트가 제대로 전달해야 적용됩니다. 클라이언트의 편의 기능은 해당 앱에만 있을 수 있습니다. iOS 등은 플랫폼별 네트워크 인터페이스와 앱 구현의 제약을 받으므로 데스크톱 기능 목록을 모든 플랫폼에 적용되는 보장으로 받아들여서는 안 됩니다. 클라이언트 선택 가이드는 이런 차이를 기준으로 비교하며 소프트웨어 이름만 나열하지 않습니다.
공개 소스로 기능 범위 확인
오픈소스 프로젝트는 저장소의 코드, 문서, 이슈, 변경 기록을 통해 기능 변화를 추적할 수 있습니다. 새 필드를 불러오지 못한다면 현재 클라이언트에서 사용하는 코어와 해당 버전의 문서를 먼저 확인한 뒤 업그레이드가 필요한지 판단하세요. 이 사이트는 확인할 수 없는 다운로드 수나 평점을 추천 근거로 사용하지 않습니다. 클라이언트를 선택할 때는 유지 관리 상태, 플랫폼 지원, 설정 호환성, 실제 사용 절차가 더 유용한 기준입니다.
아래 명령은 mihomo 소스 코드를 가져오는 용도이며 구현을 읽거나 연구하려는 사용자를 위한 것입니다. 클라이언트를 설치할 때 필요한 과정은 아닙니다. 저장소를 복제해도 네트워크가 자동으로 설정되거나 사용할 수 있는 구독이 생성되지 않습니다. 일반 사용자는 다운로드 페이지를 확인하세요. 개발하거나 직접 빌드하려면 저장소의 빌드 요구 사항과 라이선스 안내를 읽어 보세요.
업데이트 전에 복구 가능한 설정 보관
클라이언트, 코어, 구독, 규칙 세트는 업데이트 주기가 서로 다릅니다. 클라이언트 업데이트는 인터페이스와 시스템 연동 문제를 해결하고, 코어 업데이트는 프로토콜과 규칙 동작에 영향을 줍니다. 구독 업데이트는 노드와 정책 내용을 바꾸며 규칙 세트 업데이트는 대상 매칭 범위를 바꿉니다. 한 번에 한 항목씩 변경하고 결과를 기록해야 소프트웨어를 재설치하거나 DNS를 초기화하고 구독까지 바꾸는 것보다 원인을 쉽게 찾을 수 있습니다.
업그레이드 전에 현재 작동하는 설정과 로컬 오버라이드를 저장하고 선택한 프록시 그룹, 시스템 프록시 또는 TUN 상태를 기록하세요. 업데이트 후에는 먼저 설정이 불러와지는지, 그다음 자주 사용하는 대상과 로컬 네트워크에 접속되는지 확인합니다. 문제를 제보할 때는 운영체제, 클라이언트 이름, 재현 단계, 민감 정보를 제거한 로그를 제공하면 됩니다. 구독 URL, 인증 정보, 개인 도메인 등 민감한 내용은 삭제하세요. 전체 설정을 공개하지 말고 문제 해결을 위해 상세 로그를 장기간 켜 두지 마세요.
사용 환경별 클라이언트 비교 →CONFIGURATION NOTES
Clash 설정 및 배포 가이드
프록시 그룹과 노드 선택부터 Linux 서비스 배포까지, 필요한 주제를 이어서 확인하세요.
먼저 기본 연결을 확인한 다음 자동 전환과 백그라운드 실행을 설정하세요. 문서의 설정 예시는 매개변수 간 관계를 설명하기 위한 것이므로 기존 프록시 그룹 이름, 시스템 경로, 권한에 맞게 조정해야 합니다. 원격 설정 전체를 그대로 덮어쓰지 마세요.
Clash 프록시 그룹 url-test·fallback·load-balance 차이와 설정 방법
세 가지 자동 프록시 그룹의 전환 방식과 속도 측정 매개변수, 사용 환경을 비교하고 바로 수정해 쓸 수 있는 proxy-groups 설정 예시를 제공합니다.
프록시 그룹 안내 보기 →Clash 노드 선택법: 지연 시간·트래픽 배수·지역·프로토콜 비교
속도 측정에서 지연 시간이 낮다고 항상 사용하기 좋은 것은 아닙니다. 트래픽 배수, 출구 지역, 프로토콜, 사용 환경을 고려해 주 노드와 대체 노드를 고르는 방법을 안내합니다.
노드 선택 방법 보기 →Linux에 mihomo 코어 설치: 데스크톱 클라이언트와 systemd 명령줄 방식
Ubuntu·Debian·Arch에 그래픽 클라이언트를 설치하거나 systemd로 mihomo 코어가 부팅 시 자동 실행되도록 설정하는 방법을 디렉터리 구조와 권한 안내와 함께 설명합니다.
Linux 설치 단계 보기 →