Windows
데스크톱 브라우저, 업무용 소프트웨어와 시스템 프록시가 필요한 일반적인 환경에 적합합니다. 다운로드 전에 시스템 아키텍처를 확인하고, 설치 후 설정을 가져온 다음 시스템 프록시를 켜세요. Microsoft Store 앱이 인터넷에 연결되지 않으면 UWP 루프백과 로컬 포트 사용 여부를 추가로 점검할 수 있습니다.
오픈 소스 생태계 · 크로스 플랫폼 클라이언트와 한국어 설정 메모
Clash 클라이언트 다운로드 및 설정 안내서
적합한 클라이언트부터 시작해 설치 권한, 구독 가져오기, 규칙 분할을 차례로 설정하세요. 기기 설치 순서에 맞춰 자주 쓰는 경로를 정리했으며 DNS, TUN, 시스템 프록시와 연결 오류 점검 방법도 함께 제공합니다.
영구 무료
오픈 소스
5개 플랫폼
한국어 문서
설정 및 문제 해결
처음 사용한다면 먼저 안내서를 읽고 확인 가능한 연결 경로를 완성하세요. 특정 클라이언트를 골라야 할 때는 운영체제에 맞는 다운로드 페이지로 이동하면 됩니다. 이렇게 하면 코어, 그래픽 클라이언트와 설정 파일을 하나의 설치 패키지로 혼동하는 일을 피할 수 있습니다.
플랫폼별 다운로드
현재 기기에 맞는 다운로드 페이지 선택
홈페이지는 기기를 해당 플랫폼 목록으로 안내하는 역할을 합니다. 다운로드 페이지에서는 선택 가능한 클라이언트, 지원 아키텍처와 시스템 요구 사항을 확인할 수 있습니다. 한 플랫폼에 데스크톱 그래픽 클라이언트, 모바일 앱, 서버용 코어 패키지가 함께 제공될 수 있으므로 설치 전에 기기 유형을 먼저 확인하세요.
macOS
Intel과 Apple Silicon은 각각 맞는 설치 패키지를 선택해야 합니다. 처음 실행할 때 시스템 보안 정책으로 차단되면 시스템 설정에서 앱 출처와 권한을 확인하세요. 더 많은 앱 트래픽을 처리하려면 클라이언트 안내에 따라 강화 모드 또는 TUN을 활성화하면 됩니다.
Android
휴대폰, 태블릿과 일부 Android 기반 TV 기기에 적합합니다. 구독을 가져온 뒤 시스템에서 VPN 연결을 생성하도록 허용해야 합니다. 일정 시간 후 백그라운드에서 자동으로 연결이 끊기면 배터리 최적화, 백그라운드 실행 제한과 상시 알림 권한을 확인하세요.
iOS
iPhone과 iPad에서는 App Store에서 Clash Plus를 받을 수 있습니다. 처음 연결할 때 VPN 구성 확인 창이 나타나며, 허용해야 기기 트래픽을 처리할 수 있습니다. 규칙 모드, 정책 그룹과 구독 업데이트는 앱에서 설정할 수 있으므로 평소 사용 전에 현재 설정의 유효 기간을 확인하는 것이 좋습니다.
Linux
데스크톱 배포판에서는 그래픽 클라이언트를 선택할 수 있으며, 서버·소프트 라우터·컨테이너 환경에서는 보통 Mihomo 코어를 직접 사용합니다. 먼저 deb, rpm과 압축 패키지를 구분한 뒤 AMD64, ARM64 등의 아키텍처를 확인하세요. 서비스로 실행할 때는 설정 경로, 실행 사용자와 로그 디렉터리 권한도 별도로 설정해야 합니다.
그래픽 클라이언트와 코어 중 무엇을 선택해야 할지 모르겠나요?
일반적인 데스크톱과 모바일 사용자는 화면이 있는 클라이언트를 우선 선택하세요. 서버, 라우터와 기존 관리 패널이 있는 환경에서는 Mihomo 코어를 고려하면 됩니다. 클라이언트 비교 페이지에서 플랫폼 지원 범위와 조작 방식의 차이를 확인할 수 있습니다.
설정 패널
연결에서 안정적인 트래픽 분할까지
Clash의 주요 설정은 서로 연결된 네 단계로 나눌 수 있습니다. 먼저 트래픽 매칭 방식을 정하고, 클라이언트 실행 모드를 선택한 다음 시스템 연동을 설정하고, 마지막으로 구독과 설정을 관리합니다. 데스크톱에서는 왼쪽 목차로 장을 전환할 수 있으며 좁은 화면에서는 장이 순서대로 펼쳐집니다.
Rule routing
규칙은 순서대로 매칭되고 정책 그룹이 처리합니다
규칙 모드는 도메인, IP, 네트워크 유형 또는 규칙 세트에 따라 요청을 지정된 정책 그룹으로 보냅니다. 설정 파일은 보통 위에서 아래로 검사하며 일치하는 순간 이후 매칭을 중단합니다. 따라서 구체적인 규칙을 포괄적인 규칙보다 앞에 두고 최종 대체 항목은 맨 뒤에 배치해야 합니다. 특정 웹사이트가 잘못된 경로를 사용할 때는 모든 노드를 반복해서 바꾸기보다 먼저 연결 기록에서 일치한 규칙을 확인한 다음 해당 정책 그룹의 현재 선택을 점검하세요.
글로벌 프록시와 달리 규칙 분할을 사용하면 로컬 서비스, LAN 기기와 프록시가 필요한 요청을 각각 처리할 수 있습니다. 일상적인 관리에서는 규칙 세트를 최신 상태로 유지하고 중복 적용을 피하며 사용자 지정 규칙 뒤에 명확한 최종 정책을 남기는 것이 중요합니다. 수정 전 원본 설정을 저장하고 수정 후에는 명확한 대상 한두 개만 테스트하면 원인을 더 빠르게 찾을 수 있습니다.
- 먼저 요청이 어떤 규칙과 일치했는지 확인한 뒤 정책 그룹의 선택을 살펴보세요.
- 사용자 지정 도메인 규칙은 일반 규칙 세트보다 앞에 배치하세요.
- MATCH 같은 최종 대체 항목을 남겨 요청이 갈 곳을 잃지 않도록 하세요.
Proxy modes
규칙·글로벌·직접 연결은 점검 단계에 따라 다르게 사용합니다
규칙 모드는 장기간 사용하기에 적합하며 설정에 따라 트래픽 유형별 경로가 결정됩니다. 글로벌 모드는 처리 가능한 대부분의 요청을 하나의 정책으로 보내므로 문제가 규칙 매칭에서 비롯되는지 확인할 때 유용합니다. 직접 연결 모드는 프록시를 잠시 우회해 로컬 네트워크 자체가 정상인지 확인할 때 사용합니다. 모드 전환은 진단 도구이므로 모든 오류를 글로벌 모드로 해결하려 해서는 안 됩니다.
규칙 모드에서는 접속되지 않지만 글로벌 모드에서 정상이라면 규칙 순서, 규칙 세트 업데이트와 정책 그룹을 확인하세요. 글로벌 모드에서도 문제가 있으면 구독, 노드 사용 가능 여부, 시스템 프록시와 DNS를 점검해야 합니다. 테스트가 끝나면 일상 사용에 적합한 모드로 되돌리고, 수동으로 선택한 정책 그룹이 사용 불가 노드에 남아 있지 않은지 확인하세요.
- 규칙 모드는 일상적인 트래픽 분할에 사용합니다.
- 글로벌 모드는 규칙 문제의 범위를 좁힐 때 사용합니다.
- 직접 연결 모드는 로컬 네트워크와 대상 서비스를 확인할 때 사용합니다.
System takeover
TUN은 더 많은 트래픽을 처리하지만 더 많은 시스템 조건이 필요합니다
시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에 주로 영향을 줍니다. 일부 게임, 명령줄 도구와 자체 네트워크 스택을 구현한 소프트웨어는 이를 우회할 수 있습니다. TUN은 가상 네트워크 인터페이스를 만들어 더 낮은 계층에서 트래픽을 처리하므로 일반적으로 적용 범위가 더 넓습니다. 활성화하기 전에 클라이언트 권한, 가상 네트워크 어댑터 드라이버, 라우팅 설정과 DNS 구성을 확인해야 하며 데스크톱 운영체제에서는 관리자 승인이 필요할 수도 있습니다.
TUN을 켠 뒤 인터넷이 끊겨도 여러 옵션을 동시에 바꾸지 마세요. 먼저 TUN을 끄고 시스템 프록시가 작동하는지 확인한 다음 포트 충돌, DNS 수신, 라우팅 제외 항목과 다른 VPN 소프트웨어를 점검하세요. LAN 기기 접속에 문제가 있으면 사설 주소가 계속 직접 연결되도록 설정되어 있는지도 확인해야 합니다. 기본 프록시 경로가 정상인 것을 확인한 뒤 TUN 계층의 문제를 처리하세요.
- 먼저 시스템 프록시를 정상화한 다음 TUN을 활성화하세요.
- 관리자 권한, 가상 인터페이스와 DNS 수신 상태를 확인하세요.
- LAN과 로컬 서비스에는 적절한 우회 규칙을 남겨 두세요.
Configuration care
구독 업데이트와 로컬 수정은 분리해 관리해야 합니다
구독은 설정 콘텐츠를 제공하고 클라이언트는 이를 읽고 업데이트하며 실행합니다. 가져온 뒤 설정이 선택되어 있는지 확인하고 정책 그룹과 규칙이 완전한지도 살펴보세요. 구독 주소를 업데이트할 수 있다고 해서 로컬 편집 내용까지 보존되는 것은 아닙니다. 일부 클라이언트는 새로 고칠 때 구독 파일에 직접 입력한 변경 사항을 덮어쓰므로 장기적으로 사용할 규칙은 클라이언트가 지원하는 오버라이드, 스크립트 또는 병합 설정에 두는 편이 좋습니다.
일상적인 관리는 일정한 순서로 진행할 수 있습니다. 현재 사용 가능한 설정을 기록하고 구독을 업데이트한 뒤 정책을 다시 선택하세요. 직접 연결 대상과 프록시 대상 하나씩을 테스트하고 마지막으로 DNS와 연결 로그를 확인하면 됩니다. 업데이트 후 갑자기 작동하지 않으면 먼저 이전의 정상 설정으로 되돌린 다음 차이를 비교하세요. 연결되지 않는 상태에서 여러 필드를 연속으로 수정하는 일은 피해야 합니다.
- 업데이트가 완료되었는지 확인한 뒤 현재 활성화된 설정 이름을 확인하세요.
- 장기적으로 사용할 사용자 지정 내용은 오버라이드 또는 병합 계층에 두세요.
- 최근 정상적으로 작동한 설정을 하나 보관해 복구 기준으로 삼으세요.
출처 및 관리
Clash 생태계의 클라이언트·코어·설정
오픈 소스라는 사실은 코드와 협업 방식을 확인할 수 있다는 뜻일 뿐입니다. 실제 사용에서는 프로젝트 관계, 배포 출처와 유지 관리 상태를 구분해야 합니다. 다운로드 페이지에서는 그래픽 클라이언트와 Mihomo 코어를 나누어 소개하고, 홈페이지에서는 이 구성 요소들이 어떻게 결합되는지 설명해 설치 전에 필요한 항목을 판단할 수 있도록 했습니다.
프로젝트 역사: Clash 개념은 여러 클라이언트로 이어졌습니다
Clash는 설정 파일, 규칙 매칭, 정책 그룹과 로컬 프록시 포트라는 일반적인 사용 방식을 처음 확립했습니다. 원 프로젝트의 상태가 바뀐 뒤에도 커뮤니티는 호환 설정과 사용 습관을 중심으로 여러 분기를 계속 관리했으며, Mihomo는 현재 널리 사용되는 코어 구현 중 하나입니다. 데스크톱과 모바일 클라이언트는 보통 코어 외에도 구독 관리, 정책 전환, 로그 확인, 시스템 프록시와 업데이트 기능을 제공합니다.
따라서 ‘Clash 클라이언트’는 하나의 설치 패키지만을 가리키지 않습니다. 비슷한 인터페이스라도 서로 다른 코어를 사용할 수 있고, 하나의 코어가 여러 그래픽 클라이언트에서 호출될 수도 있습니다. 선택할 때는 플랫폼 지원, 유지 관리 상태, 설정 호환성과 시스템 연동 방식을 함께 확인해야 하며 이름만으로 판단해서는 안 됩니다.
오픈 소스 생태계: 저장소에서 코드와 릴리스 기록 확인
공개 저장소에서는 소스 코드, 라이선스, 이슈 기록, 커밋 이력과 릴리스 설명을 확인할 수 있습니다. 기능이 변경되었다면 해당 클라이언트와 코어의 릴리스 기록을 먼저 살펴 설정 필드가 조정되었는지 확인하세요. 반복적으로 재현되는 오류가 있다면 기존 이슈를 검색하는 편이 화면 안내만 보고 추측하는 것보다 대체로 효과적입니다.
프로젝트마다 담당 유지 관리자가 다르므로 업데이트 주기와 플랫폼 지원 범위도 서로 다릅니다. 이 사이트는 클라이언트 이름과 운영체제에 따라 경로를 정리하며 모든 구성 요소를 하나의 프로젝트처럼 설명하지 않습니다. 보관된 클라이언트는 다운로드 페이지에 유지 관리 상태를 표시하고, 계속 업데이트되는 프로젝트는 버전 목록에 제공된 최신 정보를 기준으로 합니다.
코어 관계: Mihomo가 연결을 처리하고 인터페이스가 조작을 담당합니다
코어는 설정을 읽고 프록시 연결을 수립하며 규칙을 실행하고 DNS를 처리한 뒤 실행 로그를 출력합니다. 그래픽 클라이언트는 그 위에 클릭 가능한 설정 화면을 제공합니다. 화면에 연결됨으로 표시되는 것은 클라이언트가 특정 작업을 완료했다는 뜻일 뿐이며, 실제 접속 가능 여부는 설정의 유효성, 정책 선택, 시스템 연동, DNS와 대상 네트워크에 달려 있습니다.
문제를 해결할 때 인터페이스 계층과 코어 계층을 나누어 보면 더 명확합니다. 구독을 다운로드할 수 없다면 먼저 구독 주소와 로컬 네트워크를 확인하고, 모든 노드를 사용할 수 없다면 설정 내용과 네트워크 제한을 점검하세요. 특정 앱만 프록시를 사용하지 않으면 시스템 프록시 또는 TUN을 확인하고, 일부 도메인만 문제가 있을 때는 규칙 매칭과 DNS 조회를 우선 살펴보세요.
업데이트 방식: 변경 사항을 읽은 뒤 설정과 클라이언트를 업데이트하세요
클라이언트 업데이트, 코어 업데이트, 규칙 세트 업데이트와 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 시스템 호환성에 변화를 줄 수 있고, 코어 업데이트는 설정 필드와 네트워크 동작에 영향을 줍니다. 규칙 세트 업데이트는 매칭 결과를 바꾸며 구독 업데이트의 내용은 설정 제공자가 결정합니다. 한 번에 한 종류의 업데이트만 처리해야 문제가 생겼을 때 원인을 쉽게 찾을 수 있습니다.
일상적인 사용에서 모든 릴리스를 계속 따라갈 필요는 없습니다. 현재 설정이 안정적이라면 먼저 변경 사항을 읽고 필요한 수정이 포함되어 있는지 확인한 뒤 업데이트를 진행하세요. 작업 전 현재 클라이언트 이름, 시스템 버전, 설정 이름과 주요 스위치를 기록하고, 작업 후 직접 연결 대상·프록시 대상·LAN 접속을 각각 확인하면 반복 가능한 점검 절차를 만들 수 있습니다.
Source checkout
Mihomo 소스 코드 확인
다음 명령은 공개 저장소를 복제할 때 사용하며 구현, 빌드 안내 또는 커밋 기록을 읽어야 하는 사용자에게 적합합니다. 그래픽 클라이언트만 설치하려는 경우 명령을 실행할 필요 없이 다운로드 페이지로 바로 이동하면 됩니다.
git clone https://github.com/MetaCubeX/mihomo.git
설치 메모
처음 사용할 때 확인할 네 가지
다운로드 후 무엇을 먼저 해야 하나요?
클라이언트를 실행하고 시스템 안내에 따라 필요한 권한을 부여한 다음 유효한 구독 또는 로컬 설정을 가져오세요. 설정을 선택한 뒤 정책을 하나 고르고 시스템 프록시를 활성화합니다. 처음부터 TUN을 켜고 DNS를 변경하며 사용자 지정 규칙까지 추가하지 마세요. 최소 연결 경로를 먼저 완성해야 각 단계가 정상인지 쉽게 판단할 수 있습니다.
처음 설정 단계 보기연결됨으로 표시되는데 웹페이지가 열리지 않으면 무엇부터 확인해야 하나요?
먼저 현재 설정이 활성화되어 있는지, 정책 그룹에서 사용 가능한 항목을 선택했는지 확인한 다음 시스템 프록시가 켜져 있는지 점검하세요. 이후 직접 연결 모드와 글로벌 모드를 각각 테스트해 문제가 로컬 네트워크, 규칙 또는 프록시 연결 중 어디에 있는지 판단합니다. 그래도 문제가 계속되면 DNS, 포트 충돌과 TUN 권한을 확인하세요.
전체 문제 해결 순서 보기시스템 프록시가 정상이라면 TUN도 켜야 하나요?
브라우저와 일상적인 소프트웨어가 예상대로 작동한다면 시스템 프록시를 계속 사용해도 됩니다. 일부 앱이 시스템 프록시를 읽지 않거나 더 많은 네트워크 트래픽을 처리해야 할 때, 또는 해당 앱의 네트워크 동작을 정확히 알고 있을 때만 TUN을 고려하세요. 활성화한 뒤에는 LAN 접속, DNS와 다른 VPN 소프트웨어와의 충돌 여부를 다시 확인해야 합니다.
시스템 연동 안내 보기구독 업데이트 후 사용자 지정 규칙이 사라졌다면 어떻게 해야 하나요?
구독에서 생성된 설정을 직접 편집하면 새로 고칠 때 새 콘텐츠로 덮어써질 수 있습니다. 먼저 이전의 정상 설정을 복구한 뒤 장기적으로 사용할 규칙을 클라이언트가 지원하는 오버라이드, 병합 또는 스크립트 계층으로 옮기세요. 수정 후 규칙 위치와 최종 대체 항목을 확인하고 연결 기록을 통해 사용자 지정 규칙이 실제로 일치했는지 검증하세요.
규칙 및 구독 관리 장 읽기최근 메모
설치·규칙·연결 문제 해결
각 글은 하나의 명확한 작업을 중심으로 구성되어 설치가 막히거나 규칙이 일치하지 않거나 연결 상태에 문제가 있을 때 필요한 내용을 찾아보기 좋습니다. 전체 사용 흐름은 안내서와 사용 매뉴얼을 기준으로 확인하세요.
Clash 처음 설치 설정 체크리스트: 크로스 플랫폼 초기화 단계와 흔한 실수
설치 출처와 시스템 권한부터 구독 가져오기, 첫 연결 확인까지 모든 플랫폼에 공통되는 단계와 놓치기 쉬운 초기 설정을 정리했습니다. 처음 실행할 때 항목별로 확인하거나 재설치 후 설정을 복원할 때 활용할 수 있습니다.
전체 글 읽기Clash 사용자 지정 규칙 문법 해설: 매칭 순서·우선순위·규칙 오버라이드
자주 사용하는 규칙 유형, 위에서 아래로 진행되는 매칭 방식, 대체 규칙의 위치와 사용자 지정 규칙이 예상대로 작동하지 않을 때의 점검 방법을 설명합니다. 수정 전후 연결 기록으로 실제 매칭 결과를 확인할 수 있습니다.
전체 글 읽기Windows에 Clash 설치하는 전체 과정: 시스템 프록시·구독 설정·루프백 점검
Windows 클라이언트 설치, 설정 가져오기, 시스템 프록시 활성화와 연결 확인을 다루며 권한, 로컬 포트와 UWP 루프백 문제도 함께 해결합니다. 처음 설치하는 실제 순서에 맞춰 단계를 구성했습니다.
전체 글 읽기인증서 오류, DNS 문제 또는 연결 후 인터넷이 되지 않는 문제가 있다면 글 목록에서 문제 해결 분류를 계속 확인하세요.
사용 경험 살펴보기