DEV 00 / WINDOWS
Windows 클라이언트
Windows 데스크톱 기기용입니다. 다운로드 페이지에서는 GUI 클라이언트별 현재 유지 관리 상태를 구분하고, 일반적인 x64 기기에 맞는 설치 항목을 제공합니다. 처음 설치한 뒤 설정을 가져오고 시스템 프록시를 활성화하세요. 더 많은 앱 트래픽을 제어해야 한다면 서비스 모드와 TUN 권한을 추가로 확인하세요.
[ Windows 다운로드 ]기기에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 정책 그룹 선택, 시스템 프록시 설정을 차례로 진행하세요. 사이트에서는 무료 클라이언트, 오픈 소스 코어, 한국어 설정 문서를 한곳에 정리해 설치 후에도 필드와 오류 상황을 쉽게 확인할 수 있습니다.
BIOS SETUP / CLIENT FUNCTIONS
왼쪽에서 기능을 선택하세요. 오른쪽에서는 처리 대상, 적용 상황, 작업 순서와 놓치기 쉬운 설정 범위를 설명합니다.
PROFILE INPUT / YAML
Clash 클라이언트는 보통 구독 주소에서 설정을 가져오며, 로컬 YAML 파일을 직접 불러올 수도 있습니다. 구독 주소는 설정을 가져오는 경로이고, YAML 파일에는 포트, 프록시 노드, 정책 그룹, 규칙, DNS 같은 구체적인 항목이 저장됩니다. 처음 사용할 때는 전체 주소를 설정 관리 화면에 추가하고 클라이언트가 파싱을 마칠 때까지 기다린 다음 새 설정을 현재 설정으로 지정하세요. 웹페이지 주소를 노드로 착각하거나 링크 일부가 누락된 경우, 또는 일반 텍스트를 가져온 경우에는 설정을 인식하지 못할 수 있습니다.
가져오기에 성공한 뒤 같은 주소를 곧바로 반복해서 추가하지 마세요. 먼저 설정 이름, 업데이트 시간, 프록시 그룹이 표시되는지 확인한 다음 정책 화면에서 노드를 선택하세요. 원격 설정을 업데이트하면 제공자가 관리하는 일부 내용이 교체되며, 로컬에서 직접 수정한 내용은 다음 업데이트 때 덮어써질 수 있습니다. 장기간 유지할 규칙은 클라이언트의 오버라이드, 병합 또는 스크립트 설정에 작성하는 편이 적합합니다. 전체 작업 순서는 사용 가이드에서 확인할 수 있습니다.
POLICY GROUP / PROXY
정책 그룹은 특정 연결을 어떤 노드나 하위 정책으로 처리할지 결정합니다. 일반적인 유형으로는 수동 선택, 자동 지연 시간 측정, 장애 조치, 부하 분산이 있습니다. 클라이언트 기본 화면에 표시되는 선택 항목이 모두 개별 서버인 것은 아니며, 다른 정책 그룹이 포함될 수도 있습니다. 처음 연결할 때는 주요 프록시 트래픽을 담당하는 선택 그룹을 찾고, 그룹 안에서 사용할 노드를 선택하세요. 설정 파일만 바꾸고 실제 출구 노드는 바뀌지 않는 상황을 피할 수 있습니다.
지연 시간 테스트는 해당 시점의 네트워크 환경에서 테스트 대상이 보인 응답만 반영하며, 다운로드 속도나 안정성, 모든 웹사이트의 접속 품질과 같지는 않습니다. 노드 지역, 회선 배율, 프로토콜 지원 여부와 서버 부하도 결과에 영향을 줍니다. 더 정확하게 판단하려면 후보 노드를 여러 개 테스트한 뒤 실제 웹페이지나 애플리케이션으로 연결을 확인하고, 실행 로그에서 시간 초과, 핸드셰이크 실패 또는 연결 거부가 발생하는지 살펴보세요. 노드 선택 방법은 사이트의 노드 선별 문서를 참고할 수 있습니다.
RULE ENGINE / MATCH ORDER
규칙 모드는 설정의 규칙 목록을 위에서부터 확인하고, 조건에 맞는 첫 번째 규칙이 발견되면 이후 매칭을 중단합니다. 일반적인 규칙 유형으로는 도메인, 도메인 접미사, 키워드, IP 주소 대역, 프로세스 이름, 최종 매칭 항목이 있습니다. 규칙 순서는 결과에 직접 영향을 줍니다. 범위가 지나치게 넓은 규칙을 앞에 두면 뒤의 규칙이 처리해야 할 연결을 먼저 가로챌 수 있으며, 최종 규칙이 없거나 대상 정책 그룹 이름이 일치하지 않으면 트래픽 동작이 예상과 달라질 수 있습니다.
사용자 지정 규칙을 추가할 때는 먼저 매칭 대상을 명확히 하고 대상 정책 그룹이 실제로 존재하는지 확인하세요. 도메인 규칙은 특정 호스트 이름에, 도메인 접미사 규칙은 같은 사이트의 여러 하위 도메인에 적합합니다. IP-CIDR은 알려진 주소 대역에 사용할 수 있지만 DNS 해석 건너뛰기 옵션을 활성화할 때는 그 영향을 이해해야 합니다. 사이트 이름만 보고 모든 연결 도메인을 추측하지 마세요. 브라우저 개발자 도구, DNS 조회 결과와 Clash 실행 로그를 활용하면 실제 요청을 파악하는 데 도움이 됩니다. 자세한 문법은 설정 참고에 정리되어 있습니다.
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- DOMAIN,api.example.net,Proxy
- IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
- MATCH,Proxy
DNS PIPELINE / FAKE IP
DNS 설정은 도메인을 누가 해석하는지, 해석 요청이 어떤 네트워크 경로를 거치는지, 규칙 엔진이 도메인 정보를 유지할 수 있는지에 영향을 줍니다. Fake IP 모드에서는 먼저 예약 주소를 반환한 뒤 코어가 연결을 원래 도메인에 매핑하므로 도메인 규칙으로 트래픽을 처리하기 쉽습니다. Redir Host는 실제 주소를 반환하는 기존 해석 방식에 더 가깝습니다. 두 모드에는 각각 호환성 범위가 있으며, LAN 기기, 게임, 프린터 서비스 또는 실제 주소에 의존하는 일부 앱은 별도로 제외해야 할 수 있습니다.
DNS 문제를 해결할 때는 시스템 DNS, 브라우저 보안 DNS, 클라이언트 수신 포트와 업스트림 리졸버를 구분해야 합니다. 이 중 한 곳만 수정해도 전체 경로가 바뀌지 않을 수 있습니다. 먼저 Clash DNS 모듈이 활성화되어 있는지 확인하고, 시스템 요청이 해당 포트로 들어오는지 점검한 다음 로그에서 조회와 연결 기록을 확인하세요. 도메인은 해석되지만 웹페이지가 열리지 않는다면 규칙 대상, 노드 연결과 IPv6 동작도 계속 점검해야 하며, 모든 연결 실패를 DNS 탓으로 돌려서는 안 됩니다.
NETWORK MODE / TUN
시스템 프록시는 주로 운영체제의 프록시 설정을 따르는 앱에 영향을 줍니다. 대부분의 브라우저와 데스크톱 소프트웨어가 여기에 해당합니다. 일부 게임, 명령줄 도구, 스토어 앱 또는 자체적으로 네트워크 연결을 생성하는 프로그램은 이 설정을 읽지 않습니다. TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 범위의 TCP, UDP와 DNS 트래픽을 처리하므로 통합 제어가 필요한 상황에 적합하지만, 관리자 권한, 라우팅 테이블, 네트워크 인터페이스와 보안 소프트웨어 호환성도 함께 고려해야 합니다.
처음 설정할 때는 시스템 프록시로 기본 연결을 먼저 확인하는 것이 좋습니다. 구독, 노드와 규칙이 정상인지 확인한 후 애플리케이션 요구 사항에 따라 TUN을 활성화하세요. TUN을 켠 뒤 인터넷이 끊기면 먼저 TUN을 끄고 네트워크를 복구한 다음 서비스가 정상적으로 시작되었는지, 가상 인터페이스가 생성되었는지, DNS 가로채기 설정이 현재 시스템과 일치하는지, 다른 VPN이나 가상 네트워크 카드와 충돌하지 않는지 확인하세요. Windows 서비스 모드, macOS 시스템 확장과 Linux 권한 설정은 처리 방식이 서로 다릅니다.
DEVICE DOWNLOAD MAP
홈페이지에서는 플랫폼만 안내합니다. 클라이언트 모델, 프로세서 아키텍처, 시스템 요구 사항과 설치 파일은 다운로드 센터에서 통합 제공합니다.
DEV 00 / WINDOWS
Windows 데스크톱 기기용입니다. 다운로드 페이지에서는 GUI 클라이언트별 현재 유지 관리 상태를 구분하고, 일반적인 x64 기기에 맞는 설치 항목을 제공합니다. 처음 설치한 뒤 설정을 가져오고 시스템 프록시를 활성화하세요. 더 많은 앱 트래픽을 제어해야 한다면 서비스 모드와 TUN 권한을 추가로 확인하세요.
[ Windows 다운로드 ]DEV 01 / MACOS
macOS 설치 파일은 Intel과 Apple Silicon을 구분해야 합니다. 먼저 ‘이 Mac에 관하여’에서 칩 유형을 확인한 뒤 맞는 파일을 선택하세요. 처음 실행할 때 시스템 설정에서 앱 권한을 허용해야 할 수 있으며, TUN이나 시스템 확장을 활성화할 때는 클라이언트 안내에 따라 승인을 완료해야 합니다.
[ macOS 다운로드 ]DEV 02 / ANDROID
Android 기기는 보통 ARM 아키텍처에 맞춰 설치 파일을 선택하며, 최근 기기라면 ARM64 버전을 먼저 확인하는 것이 좋습니다. 구독을 가져오면 시스템이 VPN 권한 대화상자를 통해 네트워크 연결을 확인합니다. 일정 시간 백그라운드에서 실행한 뒤 연결이 끊긴다면 배터리 절약 정책, 백그라운드 제한과 상시 VPN 설정을 확인하세요.
[ Android 다운로드 ]DEV 03 / IOS
iPhone과 iPad는 App Store에서 사용 가능한 클라이언트를 설치합니다. 구독을 추가하면 시스템에서 VPN 구성을 승인해야 합니다. 클라이언트와 시스템 VPN 설정에서 연결 상태를 서로 확인할 수 있습니다. 셀룰러 네트워크와 Wi-Fi의 동작이 다르다면 DNS, 로컬 네트워크 권한과 현재 정책을 각각 점검하세요.
[ iOS 다운로드 ]DEV 04 / LINUX
Linux 사용자는 배포판에 맞는 데스크톱 클라이언트를 선택하거나 Mihomo 코어를 직접 사용할 수 있습니다. GUI 클라이언트는 데스크톱 환경에, 코어는 서버, 컨테이너와 라우터 기기에 적합합니다. 파일을 선택할 때는 시스템 아키텍처와 패키지 형식을 모두 확인해야 합니다. 명령줄로 실행하려면 설정 경로, 서비스 권한과 부팅 시 시작 방식을 준비해야 합니다.
ARCHITECTURE CHECK
macOS에서는 Intel과 Apple Silicon을 구분해야 하며, Android에서는 ARM64와 ARM이 흔히 사용됩니다. Linux에는 AMD64, ARM64, ARMv7 또는 기타 기기 아키텍처가 사용될 수 있습니다. 파일 이름의 아키텍처 표기가 기기와 일치하는지 반드시 확인하세요.
CLIENT OR CORE
그래픽 클라이언트는 설정 관리, 정책 전환, 로그 확인과 시스템 프록시 제어 기능을 제공합니다. Mihomo 코어는 명령줄, 서비스 관리, 설정 경로와 네트워크 권한에 익숙한 서버나 라우터 기기에 더 적합합니다.
FIRST BOOT
클라이언트를 실행한 뒤에도 유효한 설정을 가져오고 정책 그룹과 노드를 선택한 다음 사용 환경에 맞게 시스템 프록시나 TUN을 활성화해야 합니다. 연결 확인에는 실제 접속, 외부 IP 상태와 실행 로그를 모두 포함해야 합니다.
OPEN SOURCE CONTEXT
클라이언트, 코어, 설정 제공자와 이 사이트의 문서는 서로 다른 계층에 속합니다. 경계를 이해하면 다운로드와 문제 해결을 더 직접적으로 진행할 수 있습니다.
Clash는 처음에 규칙 기반 프록시 코어와 설정 형식으로 널리 사용되기 시작했습니다. 핵심 기능을 바탕으로 커뮤니티에서는 데스크톱, 모바일과 명령줄 클라이언트가 차례로 발전했습니다. 서로 다른 클라이언트는 프록시 노드, 정책 그룹, 규칙, DNS와 시스템 프록시 같은 개념을 일부 공유하지만, 인터페이스 구조, 유지 관리 상태, 지원 플랫폼과 확장 기능은 완전히 같지 않습니다. 따라서 ‘Clash’는 일반적으로 모든 플랫폼을 하나의 설치 파일로 아우르는 제품이 아니라 설정과 사용 방식으로 이루어진 생태계를 의미합니다.
일부 초기 클라이언트는 이미 유지 관리가 중단되었지만, 오래된 튜토리얼과 기존 설정 때문에 여전히 검색될 수 있습니다. 클라이언트를 선택할 때는 화면 사용감보다 현재 유지 관리 상태, 시스템 지원 여부와 설정 호환성을 우선하세요. 다운로드 센터에서는 현재 유지 관리되는 클라이언트와 보관된 클라이언트를 구분해 표시하여, 오래된 문서의 이름을 현재 권장 항목으로 오해하지 않도록 합니다.
오픈 소스 코드를 통해 코어 동작, 설정 필드와 이슈 기록을 커뮤니티가 검토할 수 있으며, 여러 개발자가 플랫폼별 그래픽 인터페이스를 만들 수도 있습니다. 그래픽 클라이언트는 설정 관리, 시스템 프록시 전환, 트레이 조작, 로그 표시와 설치·업데이트를 담당합니다. 코어는 YAML을 읽고 네트워크 연결을 만들며 규칙 매칭을 실행하고 DNS와 TUN을 처리합니다. 문제가 발생하면 반복해서 재설치하기보다 오류가 인터페이스 계층, 설정 계층, 코어 또는 시스템 네트워크 계층 중 어디에 있는지 먼저 판단하는 편이 효과적입니다.
구독 서비스는 클라이언트 자체에 포함되지 않습니다. 클라이언트는 설정을 읽고 그 안의 노드, 정책 그룹과 규칙을 실행하며, 구독 내용은 해당 설정 제공자가 관리합니다. 노드 만료, 구독 권한이나 트래픽 상태는 설정 제공자 측에서 확인해야 합니다. YAML 파싱 실패, 포트 충돌, 시스템 프록시 미활성화와 TUN 권한 문제는 클라이언트 로그와 시스템 설정에서 확인하는 편이 적합합니다.
Mihomo는 현재 Clash 생태계에서 널리 사용되는 오픈 소스 코어 구현으로, 규칙, 정책 그룹, DNS와 프록시 프로토콜 같은 핵심 개념을 계승하면서 설정 필드와 실행 기능을 계속 확장하고 있습니다. 클라이언트가 Mihomo를 사용하는지, 어떤 필드를 지원하는지, 오버라이드를 어떻게 적용하는지는 해당 클라이언트의 안내를 기준으로 판단해야 합니다. 특정 코어가 지원하는 모든 필드를 오래된 임의의 클라이언트에 그대로 복사해도 설정이 정상적으로 파싱된다는 보장은 없습니다.
사이트의 설정 참고 자료는 일반적인 YAML 구조와 자주 사용되는 Mihomo 필드를 중심으로 하며, 필드 간 의존 관계도 설명합니다. 설정을 수정하기 전에는 복구 가능한 사본을 보관하고, 한 번에 관련 필드 한 그룹만 조정한 뒤 로그에서 설정이 로드되었는지 확인하세요. 포트, DNS, TUN, 규칙과 정책 그룹을 한꺼번에 바꾸면 오류 원인을 찾기 어려워집니다.
클라이언트 프로그램 업데이트와 구독 설정 업데이트는 서로 독립된 경로입니다. 프로그램 업데이트는 코어 변경, 인터페이스 조정과 시스템 호환성 수정을 포함할 수 있으며, 구독 업데이트는 주로 노드, 정책 그룹과 규칙 내용을 갱신합니다. 연결 문제가 발생했을 때 ‘구독 업데이트’와 ‘클라이언트 업그레이드’를 같은 단계로 취급해서는 안 됩니다. 먼저 현재 설정이 파싱되는지 확인하고, 클라이언트 유지 관리 상태와 시스템 호환 정보를 확인한 뒤 이전 여부를 결정하세요.
이 사이트의 다운로드 페이지는 통합 목록을 통해 현재 파일 항목을 파싱하며, 목록에 유효한 정보가 있을 때만 페이지의 버전 영역을 표시합니다. 홈페이지에는 버전 번호를 표시하지 않아 특정 클라이언트의 프로그램 버전을 Clash 생태계 전체의 통합 버전으로 오해하지 않도록 합니다. 문서는 설정 개념, 플랫폼 차이와 오류 유형별로 계속 정리하여 설치 후에도 필요한 내용을 쉽게 찾을 수 있도록 합니다.
CONFIG IMPORT
먼저 링크가 클라이언트에서 읽을 수 있는 설정을 반환하는지 확인한 다음, 해당 설정이 현재 항목으로 지정되었는지 점검하세요. 파싱 로그에 YAML 문법 오류가 표시된다면 들여쓰기, 필드 유형과 목록 계층부터 확인하세요.
설정 가져오기 문제 확인 →SYSTEM PROXY
시스템 프록시가 활성화되어 있는지, 브라우저가 별도의 프록시 설정을 사용하는지, 현재 정책 그룹에서 노드가 선택되어 있는지 확인하세요. 이후 로그에서 브라우저 연결이 Clash 수신 포트로 들어오는지 확인합니다.
연결 문제 해결 보기 →UWP LOOPBACK
일부 UWP 앱은 루프백 액세스 제한의 영향을 받습니다. 일반 데스크톱 앱이 프록시를 통해 연결되는 것을 확인한 뒤, 클라이언트에서 제공하는 UWP 루프백 설정을 점검하고 필요한 앱에만 해당 권한을 활성화하세요.
Clash UWP 루프백 확인 →DNS ROUTE
시스템 리졸버, 브라우저 보안 DNS, Clash DNS 모듈과 업스트림 서버를 각각 확인하세요. 도메인 해석이 성공한 뒤에도 연결되지 않는다면 규칙, 노드와 IPv6 라우팅을 추가로 점검해야 합니다.
DNS 및 네트워크 모드 보기 →LATEST TECH NOTES
최신 콘텐츠는 로그 분석, 노드 선택과 구독 가져오기를 중심으로 구성되어 있습니다. 각 문서는 반복해서 실행할 수 있는 하나의 점검 절차를 제공합니다.
로그 수준, 시간 순서와 핵심 필드를 바탕으로 설정 파싱, 포트 충돌, DNS, TUN과 연결 실패 등 일반적인 오류를 확인하는 방법을 설명합니다. 클라이언트는 실행되지만 연결 결과가 비정상일 때 단계별 점검에 적합합니다.
READ ARTICLE →지연 시간 테스트의 한계, 배율이 트래픽에 미치는 영향, 지역 선택 원칙과 일반적인 프로토콜 차이를 설명합니다. 한 번의 측정 결과만으로 장기간 사용할 노드를 결정하지 않도록 반복 가능한 노드 선별 절차를 제시합니다.
READ ARTICLE →구독 주소와 YAML 설정 파일의 차이를 정리하고, 클라이언트 가져오기, 수동 업데이트와 링크를 인식하지 못할 때의 점검 방법을 단계별로 설명합니다. 로컬 오버라이드와 원격 업데이트의 관계도 함께 다룹니다.
READ ARTICLE →