FIELD MANUAL · 전 플랫폼 다운로드 및 설정
Clash 전 플랫폼 클라이언트 다운로드와 규칙 분기 설정 가이드
Windows, macOS, Android, iOS, Linux 5개 플랫폼의 클라이언트 다운로드부터 설정까지 단계별로 정리했습니다. 구독 가져오기, 규칙 분기, TUN 모드를 항목별로 설명하며, Mihomo 코어의 버전 업데이트도 지속적으로 반영합니다.
- Clash Plus · 전 플랫폼 추천
- Mihomo 코어
- YAML 구독
- GPL-3.0 오픈소스
- 한국어 문서
DOWNLOAD PORTS · 다운로드 입구
플랫폼을 선택하면 해당 다운로드 섹션으로 바로 이동합니다
5개 플랫폼은 각각 독립된 설치 파일과 다운로드 입구를 갖추고 있습니다. 플랫폼 카드를 클릭하면 다운로드 페이지에서 해당 플랫폼의 클라이언트 목록으로 자동 이동하며, 각 플랫폼마다 시스템 요구 사항과 클라이언트별 차이점을 정리해두었습니다.
SELECTION NOTE · 선택 가이드
어떤 클라이언트를 골라야 할지 모르겠다면 전 플랫폼 공통으로 Clash Plus를 추천합니다. 5개 플랫폼이 동일한 인터페이스와 사용 방식을 공유하고 Mihomo 코어가 내장되어 있어 기기를 바꿔도 다시 배울 필요가 없습니다. 오픈소스 데스크톱 방식을 원한다면 Clash Verge Rev도 선택할 수 있습니다. 다운로드 페이지에서는 플랫폼별 모든 후보 클라이언트의 시스템 요구 사항, 관리 상태, 차이점을 정리해두었으며, 보관된 클라이언트도 기존 사용자가 찾을 수 있도록 링크를 남겨두었습니다.
TRUNK SECTION · 핵심 기능 개요
한눈에 보는 Clash의 5가지 핵심 기능
메인 라인을 따라 5개의 기능 노드가 배치되어 있습니다. 노드를 클릭하면 아래 패널에 해당 기능이 어떤 문제를 해결하는지, 어떻게 사용하는지, 관련 설정 항목을 한 줄로 정리해 보여줍니다.
규칙 분기
규칙 분기는 Clash가 기존의 전체 프록시 도구와 다른 핵심 기능입니다. 설정 파일에 있는 규칙은 위에서 아래로 순서대로 매칭됩니다. 로컬 도메인이나 IP 대역에 해당하는 요청은 직접 연결하고, 해외 서비스 요청은 프록시 노드로 넘기며, 광고나 트래킹 도메인은 바로 차단할 수 있습니다. 평소에는 규칙 모드를 유지하기만 하면 되고 프록시를 켜고 끄며 오가는 번거로움이 없습니다. 접속하는 사이트마다 트래픽이 자동으로 올바른 경로로 흘러갑니다. 구독으로 받는 규칙 세트는 대부분 주요 사이트를 이미 다루고 있지만, 설정 파일에 직접 항목을 추가해 특정 도메인을 지정 출구에 고정할 수도 있습니다.
rules: DOMAIN-SUFFIX,youtube.com,PROXY · GEOIP,CN,DIRECT · MATCH,PROXY
구독 관리
구독 링크는 서비스 제공자가 노드와 규칙을 전달하는 방식입니다. 클라이언트에 구독 URL을 붙여넣으면 노드 전체를 한 번에 가져올 수 있고, 이후 설정에서 자동 업데이트를 켜두면 노드 변경이나 갱신 후 설정 반영을 클라이언트가 백그라운드에서 알아서 처리합니다. 구독 갱신이 실패하는 경우 대부분 링크 만료, 구독 서버에 직접 접속할 수 없는 네트워크 환경, 형식 호환 문제가 원인이니 먼저 브라우저로 링크를 확인한 뒤 클라이언트 설정을 점검하면 됩니다. 대부분의 클라이언트는 여러 구독을 동시에 관리할 수 있어 서비스 제공자별 가용성을 비교하거나 메인 구독 장애 시 대체 설정으로 빠르게 전환하기에도 편리합니다.
proxy-providers: type: http · interval: 86400 · health-check: enable
시스템 프록시와 TUN 모드
시스템 프록시는 브라우저와 대부분의 데스크톱 앱에 적합합니다. 클라이언트가 한 번의 클릭으로 OS 프록시 설정을 반영해줍니다. 다만 일부 CLI 도구나 게임 클라이언트는 시스템 프록시를 인식하지 못하는데, 이때 TUN 모드를 켜면 클라이언트가 가상 네트워크 어댑터를 만들어 모든 아웃바운드 트래픽을 처리하고 규칙 분기와 결합해 진정한 전역 트래픽 제어가 가능합니다. 두 방식은 필요에 따라 전환하면 됩니다. 일상적인 브라우징은 시스템 프록시로 충분하고, 모든 프로세스를 커버해야 할 때 TUN을 켜면 됩니다. Windows에서는 TUN 모드를 처음 켤 때 관리자 권한이 필요하고, macOS에서는 시스템 확장을 승인해야 한다는 점에 주의하세요.
tun: enable: true · stack: system · auto-route: true · dns-hijack: any:53
정책 그룹과 속도 테스트
정책 그룹은 여러 노드를 용도별로 묶어 관리합니다. url-test 그룹은 그룹 내 노드에 주기적으로 지연 시간 테스트를 수행해 가장 빠른 노드를 자동으로 선택하고, fallback 그룹은 우선 노드가 실패하면 순서대로 대체 노드로 전환하며, select 그룹은 수동으로 직접 선택할 수 있습니다. 구독으로 받은 지역별 그룹과 함께 사용하면 영상 트래픽은 특정 지역으로 고정하고 나머지는 자동으로 최적 노드를 고르는 방식도 구현할 수 있습니다. 지연 시간 값은 클라이언트 화면에서 클릭 한 번으로 새로고침되며 노드를 바꿔도 재시작이 필요 없습니다. 속도 문제를 점검할 때는 먼저 그룹 내 테스트 결과를 확인하면 원인이 노드에 있는지 로컬 설정에 있는지 빠르게 판단할 수 있습니다.
proxy-groups: type: url-test · interval: 300 · tolerance: 50
YAML 설정 파일
Clash의 모든 동작은 하나의 YAML 설정 파일로 정의됩니다. 포트, DNS, 노드, 정책 그룹, 규칙이 각각 섹션으로 나뉘어 있어 구조가 명확하고 읽고 수정하기 쉽습니다. GUI 클라이언트는 자주 쓰는 옵션을 화면 스위치로 만들어두었지만, 설정 구조를 이해하면 화면에 노출되지 않은 고급 기능—커스텀 DNS 분기, 규칙 세트 구독, 설정 오버라이드 등—을 텍스트 편집으로 직접 구현할 수 있습니다. 수정 후 다시 불러오면 즉시 반영되며, 문법 오류가 있으면 클라이언트가 줄 번호를 알려줘 문제를 빠르게 찾을 수 있습니다. 같은 설정 파일은 다른 클라이언트에서도 그대로 재사용할 수 있습니다.
mixed-port: 7897 · allow-lan: false · mode: rule · log-level: info
PROVENANCE · 오픈소스 근거
공개된 코드, 계속 이어지는 버전 관리
초기 코어부터 오늘날의 Mihomo와 여러 GUI 클라이언트까지, 생태계 전체의 소스 코드와 커밋 기록, 릴리스 내역이 모두 공개 저장소에 남아 있어 누구나 직접 확인할 수 있습니다.
HISTORY · 프로젝트 히스토리
Clash는 원래 커뮤니티 개발자가 공개한 오픈소스 규칙 프록시 코어로, 명확한 YAML 설정 방식과 유연한 분기 규칙 덕분에 동종 도구의 표준으로 자리 잡았습니다. 원본 저장소가 아카이브된 이후에도 커뮤니티는 같은 프로토콜과 설정 형식을 바탕으로 발전을 이어갔고, 오늘날 Mihomo를 대표로 하는 후속 버전이 그 흐름을 계승하고 있습니다. 설정 생태계와 사용 방식이 그대로 이어져 기존 사용자의 구독과 규칙도 거의 수정 없이 계속 사용할 수 있습니다.
CORE · 코어와 클라이언트의 관계
코어는 프로토콜 핸드셰이크, 규칙 매칭, 트래픽 포워딩을 담당하며 GUI 클라이언트는 그 위에 얹힌 조작 화면일 뿐입니다. 본 사이트에서 소개하는 Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트는 모두 Mihomo 코어를 내장하고 있어 같은 구독을 다른 클라이언트에서도 그대로 재사용할 수 있습니다. 클라이언트를 바꾸는 것은 결국 화면만 바뀌는 것으로, 분기 동작과 설정 형식은 완전히 동일해 새로 배울 필요가 없습니다.
ECOSYSTEM · 오픈소스 생태계
코어와 주요 GUI 클라이언트의 소스 코드는 모두 공개 저장소에 호스팅되어 있어 커밋 기록, 이슈 논의, 릴리스 내역을 누구나 확인할 수 있습니다. 문제가 생기면 먼저 해당 저장소의 이슈 탭을 검색해보세요. 흔한 문제는 대부분 커뮤니티에 이미 답이 나와 있습니다. 개발 지식이 있다면 소스 코드를 직접 읽고 특정 옵션이나 규칙의 구현 방식을 확인할 수도 있어, 출처가 불분명한 설명에 의존할 필요가 없습니다.
RELEASE · 업데이트 방식
각 클라이언트는 코어 버전 업데이트에 맞춰 설치 파일을 배포하며, 업데이트 내용은 대부분 버그 수정과 프로토콜 대응입니다. 본 사이트의 다운로드 링크는 페이지 로드 시 최신 릴리스 목록을 자동으로 확인해 항상 현재 배포된 설치 파일을 가리키므로, 각 저장소의 릴리스 페이지를 일일이 확인할 필요가 없습니다. 이전 버전 사용자는 그냥 새 버전을 덮어 설치하면 업그레이드가 완료되며, 설정과 구독에는 영향이 없습니다.
git clone https://github.com/MetaCubeX/mihomo.git
QUICK ANSWERS · 자주 묻는 질문
시작 전에 가장 많이 묻는 4가지
핵심 답변만 먼저 확인하고, 자세한 설명과 단계별 방법은 헬프 센터와 전체 문서에서 확인할 수 있습니다.
Clash와 Mihomo는 어떤 관계인가요?
Mihomo는 현재 계속 유지 관리되고 있는 Clash 계열 코어로, 주요 GUI 클라이언트가 기본 코어로 채택하고 있으며 기존 Clash 설정과도 하위 호환됩니다.
개념 정리 보기 →구독 링크는 어디서 받나요?
구독 링크는 이용 중인 프록시 서비스 제공자가 발급하며, 클라이언트의 구독 입력란에 붙여넣기만 하면 됩니다. 본 사이트는 클라이언트와 설정 가이드만 제공하며 노드 서비스는 제공하지 않습니다.
헬프 센터 →iPhone에서는 어떻게 설치하나요?
Clash Plus는 App Store에 등록되어 있어 스토어에서 바로 설치할 수 있습니다. 설치 후 구독 링크를 붙여넣으면 바로 사용할 수 있으며, 자세한 절차는 다운로드 페이지의 iOS 섹션과 사용 가이드에서 확인할 수 있습니다.
iOS 다운로드 바로가기 →프록시를 켰는데 웹사이트가 안 열려요
노드 상태, 구독 상태, 시스템 프록시 설정 순서로 점검하면 됩니다. 전체 문서의 해당 섹션에 각 단계별 구체적인 확인 방법이 정리되어 있습니다.
전체 문서 보기 →FIELD NOTES · 기술 노트
최신 실전 노트 3편
프록시 모드, 클라이언트 선택, 구독 관리에 관한 실전 기록을 주제별로 계속 채워가고 있습니다.
Clash 규칙 모드·전역 모드·직접 연결 모드 차이 정리: 평소엔 뭘 써야 할까
트래픽 흐름을 기준으로 세 가지 프록시 모드의 실제 동작 차이를 분석하고, 규칙 모드가 왜 기본 선택인지, 전역 모드와 직접 연결 모드는 각각 언제 써야 하는지 설명합니다.
전체 읽기 →
주요 Clash 클라이언트 비교: 플랫폼과 사용 습관에 맞는 선택 가이드
Clash Plus, Clash Verge Rev, FlClash 등 주요 클라이언트를 인터페이스, 코어, 지원 플랫폼, 관리 상태 기준으로 비교하고 플랫폼별 추천안을 제시합니다.
전체 읽기 →
Clash 구독 업데이트 실패 해결법: 흔한 원인 점검과 자동 업데이트 설정
구독 갱신 실패의 흔한 원인—링크 만료, 네트워크 환경, UA 제한, 형식 비호환—을 정리하고, 클라이언트에서 정기 자동 업데이트를 설정해 노드 만료를 막는 방법을 설명합니다.
전체 읽기 →