Windows
데스크톱 사용자는 Clash Plus, Clash Verge Rev 등의 클라이언트부터 살펴보세요. 먼저 시스템 설정에서 기기의 아키텍처를 확인하고, 설치 후 구독을 가져와 시스템 프록시를 활성화한 다음 브라우저에서 연결을 확인하세요. TUN이 필요하다면 클라이언트 안내에 따라 서비스와 권한을 설정하세요.
다운로드 페이지로 이동 →CONFIGURATION / 설정 경로
규칙, 프록시 및 설정 관리
그래픽 인터페이스는 설정을 가져오고 전환하거나 확인하는 역할을 하며, 코어는 설정 파일을 해석하고 연결을 처리합니다. 두 구성 요소의 역할을 먼저 파악한 뒤 설정을 조정하면, 구독 내용과 클라이언트 옵션, 시스템 네트워크 환경 중 어디에서 문제가 발생했는지 구분하기 쉽습니다.
규칙 순서가 매칭 결과를 결정합니다
규칙 모드는 설정 파일에 적힌 순서대로 연결을 확인합니다. 첫 번째로 일치하는 규칙의 정책을 적용하고, 뒤에 있는 예외 규칙은 더 이상 확인하지 않습니다. LAN 도메인, 특정 사이트, 차단 규칙은 실제 사용 목적에 맞게 배치하고, 나머지 연결은 MATCH를 마지막에 두어 처리하세요. 하나의 출구만 사용하는 전역 모드와 달리 규칙 모드에서는 대상마다 다른 경로를 지정할 수 있습니다. 수정 전에는 정책 그룹 이름이 실제로 있는지 확인하고, 연결 상세 정보에서 어떤 규칙이 적용됐는지 살펴보세요. 구독에 포함된 규칙은 클라이언트의 오버라이드 기능으로 추가하면 업데이트 후에도 변경 사항을 유지할 수 있습니다.
rules:
- DOMAIN-SUFFIX,local,DIRECT
- DOMAIN-SUFFIX,github.com,Proxy
- MATCH,Proxy먼저 트래픽이 코어에 전달되는 경로를 확인하세요
시스템 프록시는 운영체제의 프록시 설정을 변경합니다. 이 설정을 따르는 브라우저와 데스크톱 앱에 적합하지만, 모든 프로그램의 트래픽을 처리한다고 보장할 수는 없습니다. TUN 모드는 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시를 사용하지 않는 앱에 적합하며, 활성화할 때 서비스 모드나 관리자 권한이 필요할 수 있습니다. 두 기능은 트래픽이 들어오는 경로를 설정하는 것으로, 노드 선택이나 규칙 설정을 대신하지는 않습니다. 처음에는 시스템 프록시부터 테스트하고 필요한 경우 TUN을 활성화하세요. 다른 VPN이나 네트워크 가속 프로그램을 함께 사용 중이라면 하나를 먼저 끈 뒤 라우팅과 DNS 설정을 차례로 확인하세요.
시스템 프록시: 클라이언트 설정 → 시스템 프록시
TUN 모드: 클라이언트 설정 → TUN 모드
코어 설정 항목: tun.enable구독 가져오기와 정기 업데이트
구독은 설정을 가져오는 출처이며, 구독을 추가했다고 프록시 연결이 자동으로 설정되는 것은 아닙니다. 제공업체가 안내한 Clash 호환 주소를 복사해 클라이언트 설정 페이지에서 원격 프로필을 추가하세요. 가져오기가 끝나면 해당 프로필을 선택하고 활성화해야 합니다. 로컬 YAML 파일은 오프라인으로 옮길 때 유용하고, 원격 구독은 노드와 규칙을 새로고침하기 편리합니다. 자동 업데이트 간격, 업데이트에 사용할 프록시, 실패 알림은 클라이언트에서 관리하므로 항목과 단위는 현재 화면을 기준으로 확인하세요. 구독 주소에 접근 인증 정보가 포함될 수 있으니 문제를 문의할 때 전체 링크를 공개하지 마세요. 업데이트 전에는 로컬 오버라이드를 저장하고, 업데이트 후에는 프록시 그룹이 바뀌었는지 확인하세요.
설정 출처: 원격 구독 / 로컬 YAML
진행 순서: 가져오기 → 활성화 → 프록시 그룹 선택
업데이트 설정: 간격, 업데이트 프록시, 실패 알림코어 기능을 기준으로 설정 호환성을 확인하세요
Clash는 코어와 클라이언트 생태계를 통칭하는 이름이며, Clash Meta는 관련 포크에서 사용되던 과거 명칭입니다. mihomo는 이 기술 계보를 이어갑니다. 그래픽 인터페이스의 이름이 다르다고 해서 설정 문법까지 완전히 다른 것은 아니지만, 같은 YAML 파일을 모든 코어가 처리할 수 있는 것도 아닙니다. 프로토콜, DNS 옵션, 규칙 기능이 현재 코어에서 지원되는지 확인하세요. 멀티 코어 호환성은 생태계의 설정 및 기능 차이를 뜻하며, 모든 클라이언트에 코어 전환 버튼이 있다는 의미는 아닙니다. 클라이언트를 선택할 때는 프로젝트 이름만 보지 말고 필요한 프로토콜을 먼저 확인한 다음 인터페이스를 비교하세요.
인터페이스: Clash Verge Rev / FlClash
코어: mihomo
주요 설정: 프록시 유형, DNS 항목, 규칙 지원연결 상세 정보에서 라우팅 결과를 확인하세요
연결 페이지에서는 대상 주소와 적용된 규칙, 최종 정책을 확인할 수 있고, 로그 페이지에서는 설정 로드와 파싱, 연결 오류를 살펴볼 수 있습니다. 페이지가 열리지 않는다면 먼저 연결 기록이 생성됐는지 확인하세요. 기록은 있는데 출구가 예상과 다르면 규칙 순서와 프록시 그룹 선택을 점검합니다. 예시의 info 로그 수준은 평소 확인에 적합하며, 문제를 진단할 때는 필요에 따라 상세 수준을 높이고 확인이 끝나면 원래 설정으로 돌리세요. 로그에 도메인, 주소, 구독 관련 정보가 포함될 수 있으므로 공유 전에 민감한 내용을 삭제하세요. 지연 시간 테스트는 특정 요청의 결과일 뿐 실제 접속을 대신하지 않으며 다운로드 속도와도 다릅니다.
log-level: info
확인 순서:
연결 기록이 있는가 → 어떤 규칙이 적용됐는가 → 어떤 정책을 사용했는가규칙은 공유하고 기기별 연결 경로는 따로 설정하세요
데스크톱과 모바일 클라이언트에서 호환되는 구독을 함께 사용할 수 있지만, 시스템 프록시와 가상 네트워크 인터페이스, 권한 요청 방식은 서로 다릅니다. 기기를 옮길 때는 설정을 가져온 뒤 로컬 포트와 파일 경로, 코어별 설정 항목을 확인하세요. 다른 기기의 설정 디렉터리 전체를 그대로 복사하지 마세요. 규칙에서 참조하는 프록시 그룹 이름은 실제 이름과 정확히 일치해야 하며, 외부 규칙 세트도 정상적으로 가져올 수 있어야 합니다. 노드 정보만 동기화하는 것과 달리 전체 설정을 옮기면 DNS와 규칙 동작도 확인해야 합니다. 기존 기기의 설정을 참고용으로 보관하고 새 기기에서 자주 사용하는 사이트, LAN 접속, 클라이언트 종료 후 네트워크 복구 상태를 점검하세요.
재사용 가능: 호환되는 구독, 프록시 그룹 구성, 라우팅 규칙
다시 확인할 항목: 권한, 포트, 파일 경로, 시스템 트래픽 처리 방식
검증 항목: 외부 네트워크 접속, LAN 접속, 종료 후 복구mihomo
Clash Meta의 기술 계보를 잇는 프록시 코어
GPL-3.0
mihomo 코어의 오픈소스 라이선스
5개 플랫폼
데스크톱과 모바일 기기에 맞는 클라이언트를 선택하세요
CLIENT SHELF / 설치 안내
운영체제에 맞는 Clash 클라이언트 선택
운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 이름이 비슷한 클라이언트는 유지보수 상태, 코어 지원 여부, 시스템 요구 사항을 비교하는 것이 중요합니다. 다운로드 페이지에서 플랫폼별로 선택 가능한 프로젝트를 확인하고, 각 카드에서 버전 정보도 미리 살펴볼 수 있습니다.
macOS
설치 전에 Apple Silicon과 Intel 모델을 구분해 알맞은 빌드를 선택하세요. 처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용합니다. 기존 설정을 옮겼다면 수신 포트와 로컬 경로를 확인하세요. 메뉴 막대의 스위치, 시스템 프록시, TUN 설정 위치는 클라이언트마다 다릅니다.
다운로드 페이지로 이동 →Android
기기 아키텍처에 맞는 클라이언트 설치 파일을 선택하고, 처음 연결할 때 시스템 VPN 권한을 승인하세요. 백그라운드 실행이 중단되면 배터리 최적화와 백그라운드 활동 권한을 확인하세요. 데스크톱에서 사용하던 구독도 형식 호환성을 확인해야 합니다. 링크가 열린다는 이유만으로 가져오기가 성공한다고 볼 수는 없습니다.
다운로드 페이지로 이동 →iOS
다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 호환되는 설정을 가져오고 VPN 구성 권한을 승인하세요. 모바일 데이터와 Wi-Fi를 전환한 뒤 연결 상태와 프록시 그룹 선택을 다시 확인할 수 있습니다.
다운로드 페이지로 이동 →Linux
데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택한 뒤 배포판에 맞는 패키지 형식을 고르세요. 시스템 프록시의 적용 범위는 데스크톱 환경과 앱 구현에 따라 다릅니다. 서버와 라우터에서는 다운로드 페이지에서 mihomo 코어를 찾아 환경에 맞게 설정과 서비스를 관리할 수 있습니다.
다운로드 페이지로 이동 →설치 후 확인 순서
설치는 첫 단계일 뿐입니다. 먼저 설정이 활성화되어 있고 파싱 오류가 없는지 확인한 다음, 프록시 그룹에서 사용할 출구를 선택하고 필요한 프록시 기능을 켜세요. 기존 연결의 영향을 피하려면 새 브라우저 요청으로 테스트하세요. 프록시가 여전히 작동하지 않으면 클라이언트 알림과 적용된 규칙을 기록한 뒤 도움말 센터에서 문제를 확인하세요. 한 번에 설정 하나만 바꾸면 어떤 변경이 영향을 줬는지 파악하기 쉽습니다.
OPEN SOURCE / 프로젝트 및 코어
오픈소스 출처와 유지보수 범위
Clash, Meta, mihomo의 관계
Clash는 처음에 프록시 코어와 설정 방식을 제공했으며, 이후 여러 플랫폼에서 이를 활용하는 그래픽 클라이언트가 만들어졌습니다. 원본 Clash의 유지보수가 중단된 뒤에도 생태계의 후속 프로젝트들은 계속 발전했습니다. Clash Meta는 예전 가이드와 설정 설명에서 자주 볼 수 있는 이름이며, mihomo는 해당 포크의 기술 계보를 이어갑니다. 자료를 읽을 때는 프로젝트의 과거 명칭과 현재 사용하는 코어를 구분하세요. Clash라는 단어가 들어간 설치 파일을 모두 같은 프로젝트로 간주해서는 안 됩니다.
코어는 프로토콜 처리, DNS, 규칙 매칭, 연결 전달을 담당하고 그래픽 클라이언트는 설정 화면과 설정 관리, 시스템 연동, 로그 표시를 담당합니다. Clash Verge Rev 같은 클라이언트는 코어를 호출해 동작하지만, 인터페이스 업데이트와 코어 업데이트는 별개의 유지보수 항목입니다. 특정 기능을 사용할 수 있는지는 클라이언트에 해당 설정이 있는지와 함께 제공되는 코어가 해당 항목을 지원하는지 모두 확인해야 합니다. 인터페이스만 교체한다고 모든 설정 호환 문제가 해결되지는 않습니다.
공개 코드로 확인할 수 있는 내용
공개 저장소에서는 소스 코드와 커밋 기록, 이슈 논의, 릴리스 노트를 확인할 수 있습니다. 설정 항목이 변경됐거나 특정 프로토콜을 지원하지 않는 경우, 출처를 알 수 없는 설정 조각을 반복해서 시도하기보다 해당 프로젝트의 문서와 릴리스 기록을 먼저 살펴보세요. mihomo 코어는 GPL-3.0을 사용합니다. 다른 클라이언트의 코드 라이선스와 배포 조건, 타사 의존성은 각 프로젝트의 파일을 기준으로 확인해야 하며, 코어의 라이선스를 모든 그래픽 클라이언트에 그대로 적용할 수는 없습니다.
오른쪽 명령은 mihomo 소스 코드를 가져옵니다. 구현 내용을 살펴보거나 개발에 참여하려는 사용자에게 적합합니다. 저장소를 복제해도 데스크톱 클라이언트가 설치되거나 시스템 프록시 서비스가 자동으로 만들어지지는 않습니다. 일반 사용자는 설치 파일 페이지에서 그래픽 클라이언트를 선택하면 됩니다. 설정 동작을 확인하려면 공식 문서에서 문법과 기본 동작을 살펴보세요. 이 사이트는 중국어 다운로드 안내와 사용 설명을 제공하며, 각 상위 프로젝트 개발팀을 대표하지 않습니다.
업데이트 전후에 확인할 항목
클라이언트와 코어, 원격 구독, 규칙 세트는 각각 업데이트 출처가 다릅니다. 클라이언트 업데이트는 설정 메뉴 위치에 영향을 줄 수 있고, 코어 업데이트는 프로토콜을 추가하거나 설정 항목을 변경할 수 있습니다. 구독 업데이트는 프록시와 그룹을 바꿀 수 있으며, 규칙 세트 업데이트는 라우팅 적용 범위를 변경합니다. 각 항목은 서로 다른 기능이므로 문제가 생겼을 때 한꺼번에 모두 변경하지 마세요. 먼저 오류가 발생한 계층을 확인한 뒤 업데이트하거나 이전 버전으로 되돌리고 설정을 수정하세요.
업데이트 전에는 로컬 오버라이드와 자주 사용하는 프록시 그룹 선택, 필요한 설정 기록을 보관하세요. 업데이트 후에는 설정이 정상적으로 로드됐는지 확인한 다음 DNS와 LAN 접속, 자주 사용하는 앱을 점검합니다. 이전에는 정상적으로 열리던 사이트에 접속할 수 없다면 새 설정과 이전 설정, 릴리스 노트를 비교하고 변경된 항목부터 확인하세요. 재현 절차와 민감한 정보를 삭제한 로그를 보관하면 프로젝트 커뮤니티에서 문제를 더 정확히 판단할 수 있습니다. 단순히 연결이 실패했다고만 설명하는 것보다 도움이 됩니다.
처음 설정할 때 헷갈리기 쉬운 항목
구독을 가져온 뒤에도 프록시 그룹을 선택해야 하나요?
구독에는 사용할 수 있는 프록시와 라우팅 정책이 정의되어 있고, 프록시 그룹에서 실제로 사용할 출구를 선택합니다. 가져온 뒤 새 설정이 활성화되어 있는지 확인하고, 규칙에서 참조하는 그룹 이름과 현재 선택된 항목을 살펴보세요. 프록시 그룹 용어 설명 보기 →
시스템 프록시를 켜면 모든 앱에 적용되나요?
일부 앱은 시스템 프록시를 사용하지 않거나 별도의 네트워크 설정을 제공할 수 있습니다. 먼저 브라우저에서 확인한 뒤 해당 앱의 프록시 설정을 살펴보세요. 다른 트래픽까지 처리해야 한다면 TUN 모드를 검토하세요. 시스템 프록시 문제 해결 안내 보기 →
TUN을 켜면 DNS 문제도 해결되나요?
TUN은 트래픽을 처리하는 방식이며, DNS 동작은 코어의 해석 설정과 시스템의 DNS 경로, 앱 자체 설정에도 영향을 받습니다. 이름 해석 오류가 발생하면 로그를 함께 확인해야 하며, 스위치가 켜져 있는지만 확인해서는 안 됩니다. DNS 및 프로토콜 참고 자료 보기 →
직접 수정한 규칙이 업데이트 후 바뀌는 이유는 무엇인가요?
원격 구독을 새로고침하면 원본 파일이 교체될 수 있습니다. 로컬 규칙은 클라이언트에서 제공하는 오버라이드나 병합 설정에 추가하고, 적용 시 삽입되는 위치도 확인하세요. 규칙 내용이 맞더라도 순서가 잘못되면 매칭되지 않을 수 있습니다. 설정 가져오기 및 사용 가이드 보기 →
READING / 설정 가이드
구독 가져오기, 첫 연결, 규칙 작성
아래 세 글은 게시 날짜가 최신인 순서로 정렬되어 있습니다. 처음 사용하는 경우 구독 가져오기부터 살펴본 뒤 연결 상태를 확인하세요. 라우팅 범위를 조정하려면 규칙 문법과 매칭 순서에 관한 글을 읽어보세요. 글에 나오는 설정 이름은 작업 경로를 설명하기 위한 것이므로 실제 위치는 선택한 클라이언트 화면에서 확인하세요.
Clash 구독 링크 가져오기 가이드: URL, 로컬 YAML 파일, 주요 구독 형식 비교
데스크톱 클라이언트에서 구독을 가져오는 세 가지 방법을 소개하고 Clash YAML과 Base64 노드 목록 등 자주 쓰이는 구독 형식의 차이와 형식이 호환되지 않을 때의 변환 방법을 설명합니다.
글 읽기 →Clash PC 버전 첫 연결 가이드: 노드 선택, 지연 시간 측정, 프록시 작동 확인
클라이언트를 막 설치한 사용자를 위해 프록시 그룹에서 노드를 바꾸는 방법, 지연 시간 테스트 결과를 이해하는 법, 시스템 프록시를 켜는 방법을 차례로 설명합니다. 브라우저와 연결 로그를 통해 트래픽이 프록시를 통과하는지도 확인합니다.
글 읽기 →Clash 사용자 지정 규칙 작성법: DOMAIN-SUFFIX, IP-CIDR, GEOIP 및 위에서 아래로 적용되는 순서
자주 사용하는 규칙 유형의 작성법과 용도를 하나씩 살펴보고, 규칙이 위에서 아래로 적용되어 일치하는 항목에서 중단되는 방식과 rule-providers 및 기본 처리 규칙 MATCH의 배치 위치를 설명합니다.
글 읽기 →