Windows
Clash Plus, Clash Verge Rev 등 그래픽 클라이언트는 시스템 프록시와 TUN 가상 네트워크 어댑터 두 가지 방식을 지원하며, Windows 10 / 11의 x64 및 ARM64 아키텍처용 설치 파일을 모두 제공합니다.
다운로드 바로가기오픈소스 생태계 · mihomo 커널 클라이언트 지속 업데이트
Windows, macOS, Android, iOS, Linux용 Clash 클라이언트 다운로드 및 설정 가이드입니다: 클라이언트는 mihomo 커널 기반이며 규칙 기반 라우팅과 TUN 모드를 지원합니다. 다운로드 링크, 빠른 시작, 고급 설정을 각각 한 페이지에 정리했습니다.
5개 플랫폼은 각각 독립된 클라이언트와 설치 파일 형식을 유지합니다. 아래 항목을 클릭하면 다운로드 페이지의 해당 플랫폼 구역으로 바로 이동합니다. 다운로드 페이지에는 시스템 요구 사항과 유지보수가 종료된 클라이언트의 보관 안내도 함께 제공됩니다.
Clash Plus, Clash Verge Rev 등 그래픽 클라이언트는 시스템 프록시와 TUN 가상 네트워크 어댑터 두 가지 방식을 지원하며, Windows 10 / 11의 x64 및 ARM64 아키텍처용 설치 파일을 모두 제공합니다.
다운로드 바로가기Intel과 Apple Silicon 두 아키텍처용 설치 파일을 제공하며, 클라이언트는 메뉴 막대에 상주하며 전체 트래픽을 처리하는 향상된 모드를 지원합니다. 구형 기기에는 ClashX Meta 보관 버전을 사용할 수 있습니다.
다운로드 바로가기VpnService를 기반으로 루팅 없이 프록시를 사용할 수 있으며, 앱별 프록시 설정과 구독 자동 업데이트를 지원합니다. ARM64와 ARMv7 기기별로 각각 APK가 제공됩니다.
다운로드 바로가기Clash Plus는 App Store에 등록되어 있어 스토어에서 바로 설치할 수 있습니다. 구독 가져오기와 규칙 기반 라우팅 방식은 데스크톱 버전과 동일하며 별도의 설정 도구가 필요 없습니다.
다운로드 바로가기deb 설치 파일과 그래픽 클라이언트를 제공합니다. 서버나 공유기(라우터) 환경에서는 mihomo 커널 바이너리를 직접 배포해 systemd 서비스로 상주 실행할 수 있습니다.
다운로드 바로가기화면이 없는 커널 바이너리로 AMD64 / ARM64 / ARMv7 / MIPS 아키텍처를 지원하며 서버와 라우터 사용자를 위한 것입니다. 일반 데스크톱 사용자는 위의 그래픽 클라이언트를 사용하는 것을 권장합니다.
다운로드 바로가기아래는 사양표 형식으로 클라이언트의 핵심 기능을 하나씩 정리한 것입니다. 각 항목은 어떤 문제를 해결하는지, 어떻게 사용하는지를 설명하고 오른쪽에는 참고용 설정 코드를 함께 제공합니다. 전체 파라미터 설명은 고급 설정 페이지에서 확인할 수 있습니다.
도메인 접미사, IP 소속 국가, 프로세스 이름 등의 조건에 따라 트래픽을 서로 다른 출구로 나눕니다: 국내 사이트는 다이렉트 연결, 목표 서비스는 프록시를 경유, 광고 도메인은 바로 차단합니다. 규칙은 위에서 아래로 순서대로 매칭되며 첫 번째로 일치하는 규칙이 즉시 적용되고, 마지막에는 MATCH로 매칭되지 않은 트래픽을 처리합니다. 전체 트래픽을 프록시로 우회시키는 방식과 비교하면 규칙 기반 라우팅은 로컬 접속 속도를 떨어뜨리지 않고 전체 우회로 인한 추가 지연도 줄여줍니다. 규칙은 설정 파일에 직접 작성할 수도 있고, rule-providers를 통해 원격 규칙 세트를 참조해 매일 자동으로 업데이트할 수도 있습니다.
rules:
- DOMAIN-SUFFIX,openai.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
# config.yaml · rules
시스템 프록시는 프록시 설정을 따르는 애플리케이션에만 적용되며, 명령줄 도구·게임 클라이언트·일부 데스크톱 소프트웨어는 이를 그대로 우회합니다. TUN 모드는 시스템 계층에 가상 네트워크 어댑터를 생성해 기기의 모든 트래픽을 네트워크 계층에서 가로챈 뒤 커널이 동일한 규칙으로 처리하게 하므로, 애플리케이션이 프록시 설정을 따르는지에 더 이상 의존하지 않습니다. 데스크톱에서는 처음 활성화할 때 서비스 구성 요소 설치와 관리자 권한 부여가 필요하며, 모바일에서는 VpnService가 동일한 효과를 구현합니다. 일반적으로 DNS 왕복을 줄이기 위해 Fake-IP와 함께 사용됩니다.
tun:
enable: true
stack: system
auto-route: true
# config.yaml · tun
정책 그룹은 여러 노드를 하나의 그룹으로 묶고 선택 로직을 정의합니다: select는 수동으로 지정하고, url-test는 주기적으로 테스트 주소에 요청을 보내 지연이 가장 낮은 노드로 자동 전환하며, fallback은 목록 순서대로 대체 노드를 사용하고, load-balance는 연결을 여러 노드에 분산시킵니다. interval은 테스트 주기를 제어하고 tolerance는 전환 허용 오차를 설정해 지연이 비슷한 두 노드 사이에서 계속 전환되는 현상을 방지합니다. 정책 그룹은 서로 중첩할 수도 있어 '지역별 그룹 + 자동 선택'과 같은 구조를 만들 수 있습니다.
proxy-groups:
- name: AUTO
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
tolerance: 50
# config.yaml · proxy-groups
구독 링크는 서비스 제공업체가 생성하며, 클라이언트가 주기적으로 이를 가져오면 최신 노드 목록을 얻을 수 있습니다. proxy-providers는 노드 소스와 로컬 규칙을 분리합니다: 여러 구독을 하나의 정책 그룹으로 합칠 수 있으며, 노드를 업데이트해도 로컬에서 수정한 내용이 사라지지 않습니다. health-check는 주기적으로 노드 상태를 확인해 사용할 수 없는 노드를 제외합니다. 그래픽 클라이언트에는 오버라이드와 Merge 기능도 있어 개인 규칙과 DNS 설정을 구독 위에 덧씌울 수 있으므로, 구독을 바꿔도 설정 전체를 다시 작성할 필요가 없습니다.
proxy-providers:
main:
type: http
url: "구독 링크"
interval: 86400
# config.yaml · proxy-providers
DNS 해석 품질은 규칙 기반 라우팅의 정확도를 직접적으로 결정합니다. enhanced-mode를 fake-ip로 설정하면 커널이 각 도메인에 대해 예약된 대역의 가상 주소를 반환하며, 애플리케이션이 가상 주소에 연결할 때 커널이 도메인 기준으로 즉시 규칙을 매칭하므로 실제 해석을 기다릴 필요가 없어 연결이 더 빠르게 이루어지고 로컬 DNS 오염도 피할 수 있습니다. 실제 IP가 필요한 경우(LAN 프린터, 일부 게임 온라인 플레이 등)에는 fake-ip-filter 예외 목록에 추가하면 기존 방식의 해석으로 되돌릴 수 있습니다.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
# config.yaml · dns
커널에는 HTTP 제어 인터페이스가 내장되어 있어 노드 전환, 지연 테스트, 연결 목록, 실시간 로그를 모두 external-controller 주소를 통해 호출할 수 있습니다. 그래픽 클라이언트의 패널도 바로 이 인터페이스를 기반으로 만들어졌으며, metacubexd나 yacd 같은 웹 패널을 연동해 브라우저에서 실행 중인 커널을 원격으로 관리할 수도 있습니다. 특히 공유기(라우터), NAS, 서버에 배포된 화면 없는 인스턴스에 유용합니다.
external-controller: 127.0.0.1:9090
secret: "your-password"
# config.yaml · external-controller
설치부터 연결 확인까지 일반적인 과정은 3단계뿐입니다. 여기서는 요약만 소개하며, 각 단계의 화면 위치·플랫폼별 차이·자주 발생하는 오류는 전체 가이드 페이지에서 확인할 수 있습니다.
다운로드 페이지에서 현재 기기에 맞는 플랫폼의 설치 파일을 선택하세요. 모든 플랫폼에서 우선 추천하는 클라이언트는 Clash Plus이며, Windows / macOS 설치 시 안내에 따라 서비스 구성 요소 권한을 부여해야 이후 TUN 모드를 사용할 수 있습니다.
서비스 제공업체가 제공한 구독 링크를 복사한 뒤 클라이언트의 '구독 / 설정' 페이지에 붙여넣어 가져옵니다. 클라이언트가 노드 목록을 자동으로 가져와 설정을 생성하며, 가져오기가 완료되면 프록시 페이지에서 모든 정책 그룹을 확인할 수 있습니다.
프록시 페이지에서 정책 그룹과 노드를 선택하고 시스템 프록시(또는 TUN 모드)를 켠 뒤 목표 사이트에 접속해 연결을 확인합니다. 이어서 내장된 지연 테스트로 각 노드를 비교해 자주 사용하는 그룹을 수치가 가장 낮은 노드로 전환하세요.
프로젝트 히스토리. Clash는 원래 Go로 작성된 규칙 기반 프록시 커널로 시작했으며, 명확한 YAML 설정 형식과 유연한 분기 규칙을 바탕으로 완전한 클라이언트 생태계를 형성했습니다. 원본 저장소가 보관 처리된 이후 커뮤니티는 Meta 브랜치를 기반으로 mihomo라는 이름으로 유지보수를 이어가고 있으며, 설정 형식은 하위 호환을 유지하면서 도메인 스니핑, 더 많은 아웃바운드 프로토콜 등 새로운 기능을 계속 추가하고 있습니다.
커널과 클라이언트의 관계. 이 사이트에 수록된 Clash Plus, Clash Verge Rev, FlClash 등의 그래픽 클라이언트는 모두 mihomo 커널을 감싸고 있습니다: 커널은 프로토콜 구현, 규칙 매칭, DNS 처리를 담당하고, 클라이언트는 구독 관리, 화면 표시, 시스템 통합(시스템 프록시, TUN 서비스, 자동 시작)을 담당합니다. 커널 업그레이드는 클라이언트 버전에 함께 포함되므로 일반 사용자가 커널을 따로 업데이트할 필요는 없습니다.
업데이트 방식. 각 클라이언트는 오픈소스 플랫폼에서 버전별로 배포되며, 이 사이트 다운로드 페이지의 링크는 항상 최신 안정 버전을 가리키고 버전 번호를 표시합니다. 유지보수가 종료된 클라이언트(Clash for Windows, ClashX Meta)는 별도로 보관 처리되고 배지를 표시해, 기존 사용자가 이전 설치 파일을 받을 수는 있지만 신규 설치는 권장하지 않습니다.
커뮤니티 협업. 커널과 주요 클라이언트의 코드는 모두 공개되어 있어 검증이 가능하며, 문제 제보와 기능 개선은 issue와 PR을 통해 진행됩니다. 규칙 기반 라우팅에 필요한 GeoIP / GeoSite 데이터베이스 역시 커뮤니티 저장소에서 정기적으로 배포되며, 클라이언트 내에서 원클릭으로 업데이트할 수 있습니다.
git clone https://github.com/MetaCubeX/mihomo.git
가장 자주 나오는 질문 네 가지와 핵심 답변을 정리했습니다. 자세한 판단 절차와 스크린샷 설명은 문제 해결 페이지에서 확인하세요.
mihomo는 Clash Meta 브랜치를 이어가는 커널로 설정 형식은 하위 호환됩니다. 현재 주요 그래픽 클라이언트들은 모두 내부적으로 mihomo를 사용합니다. 자세히 보기 →
먼저 서비스 구성 요소가 정상적으로 설치되었는지, 관리자 권한이 부여되었는지 확인한 뒤 DNS가 활성화되어 있고 auto-route가 켜져 있는지 확인하세요. 해결 절차 보기 →
꼭 그렇지는 않습니다: 먼저 테스트 주소에 접속되는지, 로컬 네트워크가 정상인지 확인한 뒤 노드·경로·로컬 설정 세 단계로 나누어 원인을 찾아보세요. 원인 분석 방법 보기 →
대부분 구독이 Clash 형식이 아닌 내용을 반환한 경우입니다. 서비스 제공업체에 Clash / mihomo 전용 구독 링크를 요청하거나, 링크가 잘리지 않았는지 확인하세요. 해결 방법 보기 →
노드 선택, 정책 그룹 설정, 마이그레이션 방안을 다루는 실전 글을 최신 게시일 순으로 3편 소개합니다.
클라이언트 유지보수가 종료된 후의 마이그레이션 절차: 설정과 구독을 그대로 재사용할 수 있는지 확인하고, 로컬 오버라이드를 내보낸 뒤, 플랫폼별로 여전히 유지보수 중인 대체 클라이언트를 선택하고, 마이그레이션 후 다시 설정해야 할 항목을 정리합니다.
전체 글 읽기 →초보자를 위한 노드 선택 방법: 지연 수치를 읽는 법, 트래픽 배율이 사용량에 미치는 영향, 지역 선택과 접속 대상의 관계, 그리고 주요 프로토콜의 속도·안정성 차이를 다룹니다.
전체 글 읽기 →세 가지 자동 정책 그룹의 판정 로직과 주요 파라미터(url/interval/tolerance)를 분석하고, 저지연 우선·가용성 보장·트래픽 분산 등 적용 시나리오를 비교하며 설정 예시를 제공합니다.
전체 글 읽기 →