DESKTOP / WINDOWS
Windows
일상적인 데스크톱 사용에 적합합니다. 다운로드 페이지에는 그래픽 인터페이스를 제공하는 주요 클라이언트와 지속적으로 유지 관리되는 프로젝트 및 이전 버전 아카이브가 구분되어 있습니다. 설치 후에는 보통 설정을 가져오고 정책 그룹을 선택한 다음 시스템 프록시를 켜야 합니다. 더 많은 앱의 트래픽을 처리해야 한다면 권한 조건을 확인해 TUN 모드를 설정하세요.
다운로드로 이동설치 파일 아카이브 · 설정 문서 계속 업데이트
플랫폼별로 Clash 클라이언트 설치 경로와 이전 버전 아카이브를 정리하고, 설정 필드·규칙 분기·시스템 프록시·TUN 및 DNS 문제 해결 방법을 안내합니다. 설치 전에 플랫폼별 차이를 확인하고, 연결 후 설정 문제를 빠르게 파악할 수 있습니다.
Platform · 설치 경로
동일한 Clash 설정을 여러 그래픽 클라이언트나 코어 프로그램에서 읽을 수 있지만, 설치 형식·시스템 프록시 처리 방식·권한 모델은 서로 다릅니다. 먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 클라이언트를 비교하면 잘못된 설치 파일을 받거나, 가져온 뒤 실행되지 않거나, 시스템 프록시가 적용되지 않는 문제를 줄일 수 있습니다.
DESKTOP / WINDOWS
일상적인 데스크톱 사용에 적합합니다. 다운로드 페이지에는 그래픽 인터페이스를 제공하는 주요 클라이언트와 지속적으로 유지 관리되는 프로젝트 및 이전 버전 아카이브가 구분되어 있습니다. 설치 후에는 보통 설정을 가져오고 정책 그룹을 선택한 다음 시스템 프록시를 켜야 합니다. 더 많은 앱의 트래픽을 처리해야 한다면 권한 조건을 확인해 TUN 모드를 설정하세요.
다운로드로 이동DESKTOP / MACOS
다운로드 전에 기기가 Apple Silicon인지 Intel 프로세서인지 확인해야 합니다. 아키텍처가 다른 설치 파일은 함께 사용할 수 없으며, 처음 실행할 때 시스템 보안 확인·네트워크 확장 권한·프록시 권한이 필요할 수 있습니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash, ClashX Meta 등의 경로를 한곳에 정리했습니다.
다운로드로 이동MOBILE / ANDROID
Android 클라이언트는 일반적으로 로컬 VPN 인터페이스를 통해 트래픽을 처리하며, 활성화하면 시스템 상태 표시줄에 VPN 아이콘이 나타납니다. 여러 프로세서 아키텍처와 범용 설치 파일의 다운로드 경로를 제공합니다. 구독을 가져오기 전에 출처를 확인하고, 백그라운드 실행·배터리 최적화·VPN 항상 켜기 설정에도 유의하세요.
다운로드로 이동MOBILE / IOS
iPhone과 iPad는 시스템에서 제공하는 네트워크 확장 기능으로 연결을 처리합니다. 다운로드 영역에서 Clash Plus의 App Store 페이지와 공식 사이트 정보를 바로 확인할 수 있습니다. 설치 후 사용 문서에 따라 구독을 가져오고 VPN 설정 추가를 허용한 다음, 정책 그룹에서 사용할 노드나 자동 테스트 그룹을 선택하세요.
다운로드로 이동DESKTOP / SERVER
데스크톱 환경에서는 그래픽 클라이언트를 선택할 수 있고, 서버·소프트 라우터·컨테이너 환경에서는 Mihomo 코어를 직접 실행하는 편이 적합합니다. 다운로드 전에 배포판, CPU 아키텍처, 설치 형식을 확인해야 합니다. 서비스로 실행할 때는 설정 디렉터리·로그 경로·수신 주소·실행 권한도 별도로 계획하세요.
다운로드로 이동Config Timeline · 핵심 기능
Clash의 작동 과정은 수신 포트, 규칙 매칭, 정책 그룹 선택, DNS 해석, 최종 연결 단계로 나눌 수 있습니다. 왼쪽 눈금은 자주 사용하는 설정 영역을 나타내며, 전환하면 각 필드의 용도·실제 사용법·문제 해결 핵심을 확인할 수 있습니다.
규칙 모드는 설정 파일에 작성된 순서대로 요청을 하나씩 매칭합니다. 흔히 사용하는 조건에는 도메인 접미사, 도메인 키워드, IP 대역, GeoIP, 규칙 세트, 프로세스 이름이 있으며, 일치하면 지정된 정책 그룹으로 전달됩니다. 실제로 사용할 때는 범위가 구체적인 규칙을 앞에 두고 최종 대체 규칙은 뒤에 배치해야 하며, 규칙이 참조하는 정책 그룹 이름이 실제로 존재하는지도 확인해야 합니다. 전역 스위치만 제공하는 단순 프록시 도구와 달리 Clash는 업무용 사이트, 직접 연결 서비스, 로컬 네트워크 주소 및 기타 트래픽을 각각 처리할 수 있습니다. 잘못된 분기를 점검할 때도 규칙 순서에 따라 최초 일치 항목을 찾을 수 있습니다.
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- IP-CIDR,192.168.0.0/16,DIRECT
- MATCH,Final
정책 그룹은 규칙과 실제 프록시 노드 사이에 있습니다. 수동 선택 그룹은 고정된 출구에 적합하고, 자동 테스트 그룹은 설정된 주소와 주기에 따라 후보를 확인하며, 장애 조치 그룹은 현재 항목을 사용할 수 없을 때 다음 항목을 순서대로 시도합니다. 설정할 때는 그룹 유형·멤버 출처·중첩 관계를 명확히 해 정책 그룹끼리 순환 참조가 생기지 않도록 해야 합니다. 클라이언트 화면에서 노드를 바꾸는 작업은 보통 정책 그룹의 현재 선택만 수정할 뿐 규칙 자체를 변경하지 않습니다. 이 구조를 이해하면 노드 테스트는 정상인데 웹사이트가 계속 직접 연결되는 이유를 설명할 수 있고, 여러 업무 규칙을 하나의 관리 가능한 출구 그룹으로 모을 수도 있습니다.
proxy-groups:
- name: Proxy
type: select
proxies:
- Auto
- DIRECT
Clash의 DNS 모듈은 클라이언트의 조회 요청을 한곳에서 받은 뒤 설정에 따라 업스트림 해석기를 선택할 수 있습니다. Fake-IP 모드는 예약 주소를 반환하고 도메인 매핑을 유지하므로, 대상 주소만 포함한 연결에서도 원래 도메인을 복원해 도메인 규칙 매칭을 계속 수행할 수 있습니다. 이는 단순히 시스템 DNS를 바꾸는 기능이 아니며, 수신 포트·업스트림 해석·필터 목록·트래픽 처리 방식이 함께 맞아야 합니다. 일부 도메인이 열리지 않거나 로컬 네트워크 기기 검색이 이상하거나 브라우저와 명령줄 결과가 다르다면 DNS 활성화 여부, 요청의 Clash 진입 여부, 업스트림 접근 가능 여부, 대상 도메인의 필터 범위를 차례로 확인하세요.
dns:
enable: true
enhanced-mode: fake-ip
listen: 0.0.0.0:1053
시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에 주로 적용되며, 브라우저와 대부분의 데스크톱 프로그램은 바로 사용할 수 있습니다. 시스템 프록시를 읽지 않는 프로그램, 일부 게임, 독립 네트워크 스택은 이를 우회할 수 있습니다. TUN 모드는 가상 네트워크 인터페이스를 통해 처리 범위를 넓히지만 관리자 권한·라우팅 테이블·DNS 가로채기·다른 VPN 소프트웨어와의 관계도 함께 고려해야 합니다. 처음에는 시스템 프록시로 노드와 설정이 정상인지 확인한 뒤 필요할 때 TUN을 켜는 것이 좋습니다. 연결 후 전체 네트워크가 끊기면 먼저 처리를 중지해 네트워크를 복구하고, 포트 사용 여부·가상 인터페이스 권한·라우팅 충돌·DNS 설정을 점검하세요. 설정 파일만 반복해서 바꾸지는 마세요.
mixed-port: 7890
tun:
enable: true
stack: system
Profile은 노드 목록만 담는 것이 아니라 포트·DNS·정책 그룹·규칙 제공자·스크립트 등을 포함한 전체 설정일 수 있습니다. 원격 구독을 업데이트하면 클라이언트가 업스트림 내용을 다시 가져오는 경우가 많으므로, 구독에서 생성된 파일을 직접 수정하면 다음 업데이트 때 덮어써질 수 있습니다. 원본 구독은 보존하고, 로컬 포트·DNS 예외·규칙 변경은 클라이언트가 지원하는 재정의 또는 병합 계층에 넣으며, 정상 작동이 확인된 설정은 별도 백업으로 보관하는 것이 안전합니다. 여러 설정을 함께 사용할 때는 용도별로 이름을 정하고 가져온 출처와 수정 범위를 기록하세요. 문제가 생기면 먼저 정상 작동이 확인된 설정으로 되돌린 뒤 필드 차이를 비교합니다.
profile:
store-selected: true
store-fake-ip: true
Open Source · 프로젝트 관계
Clash 생태계는 코어, 그래픽 클라이언트, 규칙 데이터, 사용자 설정으로 구성됩니다. 현재 기기에 적합한 다운로드 경로인지 판단할 때는 이름이 비슷한지만 볼 것이 아니라 프로젝트 유지 상태·코어 관계·플랫폼 아키텍처·설정 호환 범위를 확인해야 합니다.
HISTORY
Clash는 처음에 규칙 기반 네트워크 프록시 코어로 널리 사용되었으며, 설정 파일은 YAML 형식으로 프록시 노드·정책 그룹·규칙·DNS를 하나의 구조로 관리했습니다. 원본 프로젝트의 업데이트가 중단된 뒤에도 커뮤니티는 호환성·신규 프로토콜·규칙 기능·플랫폼 지원을 중심으로 관련 분기를 계속 유지했습니다. 현재 많은 데스크톱 및 모바일 클라이언트가 Mihomo를 실행 코어로 사용하지만, 화면 이름·설정 재정의 방식·시스템 통합 기능은 각 클라이언트 프로젝트가 결정합니다. 따라서 “Clash 설정 지원”이 모든 클라이언트의 메뉴 위치·필드 확장·마이그레이션 방식까지 완전히 같다는 뜻은 아닙니다.
ECOSYSTEM
코어는 설정을 읽고 연결을 구축하며 규칙을 실행하고 제어 인터페이스를 제공합니다. 그래픽 클라이언트는 이를 바탕으로 설치·구독 업데이트·정책 전환·로그 확인·시스템 프록시·TUN 권한·시작 시 실행을 처리합니다. Windows·macOS·Android·iOS는 권한 모델이 서로 다르므로 같은 기능도 구현 방식이 달라집니다. 클라이언트를 선택할 때는 먼저 플랫폼 지원 여부를 확인한 다음 유지 관리 상태·코어 유형·필요한 기능을 살펴보세요. 서버 전달이나 라우터 배포만 필요하다면 Mihomo 코어를 직접 실행하는 편이 적합하고, 메뉴 막대 조작·시스템 알림·설정 관리가 필요하다면 그래픽 클라이언트가 더 편리합니다.
ARCHIVE
구형 시스템·구형 프로세서·고정 배포 환경에서는 이전 설치 파일이 필요할 수 있지만, 아카이브 파일을 출시일순으로만 정렬해 임의로 설치해서는 안 됩니다. 먼저 운영체제의 최소 요구 사항과 CPU 아키텍처를 확인하고, 다음으로 해당 클라이언트가 계속 유지 관리되는지 살핀 뒤, 설정 필드가 호환되는지 확인하세요. 유지 관리가 중단된 클라이언트는 다운로드 페이지에 별도로 표시해 아카이브임을 쉽게 알 수 있도록 했습니다. 새 기기에서는 계속 유지 관리되고 플랫폼 지원이 명확한 클라이언트를 우선 선택하세요. 기존 안정 환경을 업그레이드할 때는 설정을 백업하고 현재 시스템 프록시·TUN·DNS 상태를 기록해 차이가 생겼을 때 되돌릴 수 있도록 하세요.
UPDATE
이 사이트는 클라이언트 프로젝트와 플랫폼별로 다운로드 경로를 구성하며, 버전 정보와 파일 세부 사항은 설치 파일 페이지에서 집중적으로 제공합니다. 홈페이지는 제품 관계와 선택 경로를 설명하는 데 초점을 둡니다. 정리 과정에서는 업스트림 프로젝트 상태, 설치 경로 접근 가능 여부, 플랫폼 키 일치 여부, 문서 설명이 현재 클라이언트 동작과 맞는지를 중점적으로 확인합니다. 설정 튜토리얼은 특정 화면의 일시적인 배치를 일반적인 결론으로 삼지 않고 시스템 프록시·규칙·정책 그룹·DNS 같은 안정적인 개념을 먼저 설명합니다. 클라이언트 화면이 다를 때는 해당 플랫폼에서의 조작 위치를 추가로 안내합니다.
Checklist · 자주 묻는 질문
“이 Mac에 관하여”에서 칩 정보를 확인하세요. Apple 칩 이름이 표시되면 Apple Silicon 또는 ARM 아키텍처 패키지를 선택하고, Intel 프로세서가 표시되면 x64 또는 Intel 패키지를 선택합니다. 아키텍처가 맞지 않으면 앱이 열리지 않거나 별도의 호환 변환 계층이 필요할 수 있습니다. 전체 플랫폼 안내는 macOS 다운로드 영역에서 확인하세요.
먼저 설정이 활성화되었는지 확인한 뒤, 정책 그룹에서 사용 가능한 노드를 선택했는지, 시스템 프록시가 켜져 있는지, 프록시 포트를 다른 프로그램이 사용 중인지 점검하세요. 이어서 직접 연결 사이트와 프록시 사이트를 테스트해 노드 문제·규칙 문제·DNS 문제를 구분합니다. 네트워크를 처리하는 여러 프로그램을 동시에 켜면 라우팅과 프록시 설정이 서로 덮어쓸 수 있으니 피하세요. 문제 해결의 순서에 따라 계속 점검할 수 있습니다.
구체적인 동작은 클라이언트 구현에 따라 다릅니다. 처음 설정할 때는 먼저 시스템 프록시를 사용해 설정·노드·규칙이 정상인지 확인한 뒤, 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때 TUN을 활성화하는 것이 좋습니다. TUN을 켠 뒤 네트워크 문제가 생기면 가상 인터페이스 권한·DNS 가로채기·라우팅 충돌·다른 VPN 프로그램을 확인하세요. 관련 단계는 사용 문서에서 확인할 수 있습니다.
원격 구독으로 생성된 설정을 직접 편집하면 업데이트 과정에서 새 내용으로 교체될 수 있습니다. 클라이언트가 제공하는 재정의·병합·스크립트 기능을 우선 사용해 로컬 규칙과 업스트림 구독을 분리해 관리하세요. 수정하기 전에 정상 작동이 확인된 설정을 보관하고 새 필드가 어느 계층에 추가되었는지 기록하세요. 필드 구조와 병합 방식은 설정 필드 참고에서 확인할 수 있습니다.
Notes · 최신 글
글은 실제 작업 흐름에 따라 문제를 나누어 설명하며, 먼저 판단 조건을 제시한 뒤 확인 방법과 해결 절차를 안내합니다. 설정을 다룰 때는 시스템 프록시·코어 필드·클라이언트 화면·업스트림 구독을 구분해 서로 다른 계층의 문제를 섞지 않습니다.
시스템 프록시 스위치·포트 사용 여부·노드 상태부터 DNS 오염과 규칙 매칭까지, 연결은 됐지만 인터넷이 되지 않는 실제 원인을 순서대로 찾습니다. 각 단계에서 관찰할 현상·확인 방법·해결 절차를 제시하므로 노드를 계속 바꿔도 해결되지 않을 때 유용합니다.
전체 글 읽기 →지연 시간 테스트는 특정 테스트 주소로 한 번 요청을 보낸 경로만 반영하는 경우가 많아 페이지 로딩·동영상 전송·장시간 연결 품질과 같지 않습니다. 이 글에서는 URL Test의 측정 기준을 분석하고 패킷 손실·대역폭·서버 위치·혼잡 시간대 안정성을 함께 고려해 노드 품질을 판단하는 방법을 설명합니다.
전체 글 읽기 →Profile과 구독 링크·로컬 YAML·클라이언트 재정의의 관계를 설명하고, 설정 업데이트·전환·백업의 기본 원리를 정리합니다. 여러 구독을 함께 사용할 때의 이름 지정 방식, 수정 범위, 복구 절차도 안내합니다.
전체 글 읽기 →