문제 해결
Clash 노드 시간 초과로 연결이 안 될 때 확인하는 순서: 구독부터 포트, 프로토콜까지
모든 노드가 시간 초과된다고 해서 노드가 실제로 문제 있는 것은 아닙니다. 구독 유효성, 로컬 포트 점유, 시스템 프록시 스위치, 프로토콜과 커널 일치 여부, DNS 오염까지 다섯 단계로 확인해 설정 문제인지 경로 문제인지 파악합니다.
전체 보기 →DOWNLOADS
플랫폼별 다운로드
5개 플랫폼별로 관리 중인 클라이언트 목록을 제공합니다. 사용 중인 기기에 맞는 항목을 선택하면 다운로드 페이지가 해당 플랫폼 탭으로 자동 전환됩니다.
Windows
설치 파일과 포터블 버전 중 선택할 수 있고, 시스템 프록시와 TUN 모드를 지원하며 Windows 10 이상 64비트 시스템에서 사용할 수 있습니다.
다운로드 바로가기 →Android
arm64와 armv7 아키텍처용 APK를 바로 설치할 수 있으며, VpnService 기반으로 전체 프록시를 구현해 루트 권한이 필요 없습니다.
다운로드 바로가기 →FEATURES
핵심 기능
왼쪽에서 설정 항목을 선택하면 오른쪽에서 해당 기능의 용도, 사용법, 관련 설정 예시를 확인할 수 있습니다. 모든 예시는 그대로 사용할 수 있는 실제 문법입니다.
규칙 분기: 도메인과 지역에 따라 트래픽 경로 결정
규칙은 Clash의 핵심입니다. 설정 파일의 rules 목록은 위에서부터 순서대로 매칭되며, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP 등의 조건에 해당하는 요청은 규칙에 지정된 정책에 따라 프록시 또는 직접 연결로 처리되고, 아무 조건에도 해당하지 않으면 MATCH가 마지막에 처리합니다. 중국 본토 도메인과 IP는 직접 연결로, 나머지 트래픽은 프록시로 보내면 되므로 매번 수동으로 전환할 필요가 없습니다. 전체·직접 연결 두 가지뿐인 기존 프록시 도구와 달리 규칙 분기는 연결마다 개별적으로 판단해 직접 연결 트래픽은 우회하지 않고 프록시 트래픽은 빠짐없이 처리합니다. 규칙은 구독으로 관리하거나 클라이언트에서 직접 추가·수정할 수 있습니다.
rules:
- DOMAIN-SUFFIX,github.com,노드 선택
- DOMAIN-SUFFIX,bilibili.com,DIRECT
- GEOIP,CN,DIRECT
- MATCH,노드 선택
TUN 모드: 시스템 프록시를 사용하지 않는 프로그램 처리
일부 프로그램(커맨드라인 도구, 게임, 일부 클라이언트 소프트웨어)은 시스템 프록시 설정을 읽지 않아 일반 HTTP/SOCKS 포트가 적용되지 않습니다. TUN 모드는 시스템에 가상 네트워크 카드를 만들어 기기의 모든 아웃바운드 트래픽을 Clash 커널로 유입시키고 동일한 규칙으로 분기하므로, 네트워크 계층에서 시스템 프록시가 놓치는 부분을 보완합니다. 활성화하려면 관리자 권한(Windows) 또는 네트워크 확장 권한(macOS)이 필요하며, dns-hijack과 함께 사용하면 DNS 조회도 처리해 결과 오염을 막을 수 있습니다. 평소에는 시스템 프록시를 사용하고, 프록시를 거치지 않는 프로그램이 있을 때만 TUN을 켜는 것이 좋습니다.
tun:
enable: true
stack: system
auto-route: true
dns-hijack:
- any:53
구독 관리: 노드 목록을 자동으로 최신 상태로 유지
구독은 원격 설정을 가리키는 URL입니다. 클라이언트는 proxy-providers의 interval 주기에 따라 가져오며, 노드 추가·삭제나 주소 변경이 자동으로 로컬에 반영되어 서버 정보를 일일이 관리할 필요가 없습니다. 여러 구독을 동시에 사용하면서 각각 독립적으로 업데이트하고, 정책 그룹으로 통합해 구성할 수 있습니다. 구독 가져오기가 실패해도 이전 캐시를 그대로 사용해 기존 연결에는 영향이 없습니다. 가져오는 방법은 클라이언트마다 동일합니다: 구독 링크를 복사해 설정 또는 구독 페이지에 붙여넣으면 되고, URL 형식의 구독은 구독 변환 서비스를 거쳐 전체 규칙이 포함된 Clash 설정으로 만들 수도 있습니다.
proxy-providers:
main:
type: http
url: "https://example.com/sub.yaml"
interval: 86400
path: ./providers/main.yaml
정책 그룹: 자동 속도 측정, 장애 전환, 수동 대비
정책 그룹은 여러 노드를 규칙에서 참조할 수 있는 하나의 묶음으로 구성합니다. url-test는 주기적으로 모든 구성원의 속도를 측정해 지연이 가장 낮은 노드를 자동으로 선택하고, fallback은 목록 순서대로 가용성을 보장해 우선 노드가 장애가 나면 다음 노드로 자동 전환하며, load-balance는 연결을 여러 노드에 분산시키고, select는 수동으로 고른 항목을 유지합니다. 네 가지 유형은 서로 중첩할 수 있어, 예를 들어 수동 그룹의 후보로 여러 자동 측정 그룹을 두면 편리함과 제어력을 동시에 확보할 수 있습니다. tolerance 값을 조정하면 지연이 비슷한 노드끼리 자꾸 전환되는 현상을 줄일 수 있습니다.
proxy-groups:
- name: 자동 선택
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
tolerance: 50
QUICKSTART
3단계로 시작하기
설치부터 프록시 동작 확인까지 전체 과정은 보통 10분 안에 끝납니다. 아래는 입문 가이드의 요약판입니다.
1
클라이언트 다운로드 및 설치
다운로드 페이지에서 기기에 맞는 플랫폼의 클라이언트를 선택하고 안내에 따라 설치합니다. Windows와 macOS는 처음 실행할 때 시스템 안내에 따라 네트워크 권한을 허용하고, Android는 APK 설치 후 VPN 연결 생성을 허용하며, iOS는 App Store에서 바로 받을 수 있습니다.
2
구독 또는 설정 파일 가져오기
서비스 제공업체가 제공한 구독 링크를 복사해 클라이언트의 「설정」 또는 「구독」 페이지에 붙여넣어 가져오거나, 로컬 config.yaml 파일을 직접 가져올 수도 있습니다. 가져오기가 완료되면 노드 목록과 규칙이 함께 로드됩니다.
3
프록시 켜고 확인하기
「시스템 프록시」 스위치를 켜고 프록시 페이지에서 정책 그룹의 노드를 선택한 뒤 해외 사이트에 접속해 연결을 확인합니다. 일부 프로그램에서 작동하지 않으면 TUN 모드를 활성화해 전체 트래픽을 처리하도록 합니다. 연결 페이지에서는 각 요청이 어떤 규칙에 매칭됐는지 실시간으로 볼 수 있습니다.
OPEN SOURCE
오픈소스 생태계 신뢰성
Clash는 폐쇄형 소프트웨어가 아니라 커널, 규칙, 여러 클라이언트로 구성된 오픈소스 생태계입니다. 코드가 공개되어 있어 누구나 확인하고 직접 빌드할 수 있습니다.
프로젝트 역사
Clash는 2018년 무렵 오픈소스 프로젝트로 등장해 YAML 설정과 규칙 분기 설계로 이 분야의 사실상 표준으로 빠르게 자리 잡았습니다. 원본 커널 저장소가 보관 처리된 뒤에는 커뮤니티가 이어받아 관리하고 있으며, 설정 문법과 규칙 형식은 호환성을 유지해 오랫동안 쌓인 구독·규칙 자료를 계속 사용할 수 있습니다.
커널과 프로토콜
현재 활발히 관리되는 커널은 MetaCubeX 팀이 유지하는 mihomo(즉 Clash Meta 커널)로, GPL 오픈소스 라이선스로 배포되며 기존 설정과 호환을 유지하면서 더 많은 프록시 프로토콜, DNS 정책, TUN 스택 구현을 추가했습니다. 데스크톱과 모바일의 주요 클라이언트들이 이 커널을 내장하고 있습니다.
클라이언트 생태계
Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 등의 클라이언트는 각기 다른 팀이 독립적으로 개발하지만 동일한 커널과 설정 형식을 공유합니다. 클라이언트를 바꿔도 설정을 다시 만들 필요 없이 구독과 규칙을 그대로 옮길 수 있으며, 선택에 따라 달라지는 것은 인터페이스와 플랫폼 지원뿐이고 분기 동작에는 영향이 없습니다.
업데이트 방식
이 사이트는 각 클라이언트와 커널의 배포 채널을 추적하며, 다운로드 페이지 링크는 현재 배포 버전을 가리키고 페이지의 버전 번호는 배포에 따라 갱신됩니다. 유지 관리가 중단된 클라이언트(Clash for Windows, ClashX Meta 등)는 명확히 표시하고 여전히 활발히 관리되는 대안을 함께 안내합니다.
git clone https://github.com/MetaCubeX/mihomo.git
FAQ
자주 묻는 질문 모음
자주 나오는 질문 네 가지에 대한 한 줄 답변입니다. 자세한 설명과 더 많은 항목은 개념 사전과 전체 문서에서 확인하세요.
설정 파일은 어디에 있나요?
각 클라이언트의 설정 페이지에는 「설정 폴더 열기」 메뉴가 있습니다. 직접 찾을 경우 Windows는 보통 사용자 폴더의 클라이언트 데이터 폴더에, macOS는 ~/.config 또는 애플리케이션 지원 폴더에 있습니다.
시스템 프록시와 TUN 모드 중 무엇을 선택해야 하나요?
일상적인 웹서핑은 시스템 프록시로 충분하며, 커맨드라인 도구나 게임처럼 시스템 프록시를 읽지 않는 프로그램은 TUN 모드로 처리해야 합니다. 두 방식을 같은 포트 설정에 동시에 의존하지 않는 것이 좋습니다.
TUN 모드 항목 보기 →구독을 가져왔는데 노드가 보이지 않아요
먼저 구독 링크가 만료되지 않았는지, 응답이 Clash 형식인지 확인하세요. 그런 다음 클라이언트 로그에 가져오기 실패 기록이 있는지 확인하고, 필요하면 브라우저로 구독 주소를 직접 열어 내용을 확인합니다.
전체 문서에서 단계별로 확인하기 →시작할 때 자동 실행은 어떻게 설정하나요?
데스크톱 클라이언트의 일반 설정에 「시작 시 실행」 스위치가 있으며 「조용히 시작」도 함께 켜는 것을 권장합니다. Windows에서 보안 소프트웨어가 차단하면 해당 소프트웨어의 허용 목록에 클라이언트를 추가해야 합니다.
입문 가이드에서 단계 확인하기 →BLOG
사용 후기
문제 해결 기록, 플랫폼 가이드, 고급 설정 작성법을 주제별로 꾸준히 업데이트합니다.
플랫폼 가이드
macOS에서 Clash 클라이언트 설치 권한 완전 정리: 네트워크 확장 권한과 키체인 팝업 처리
macOS에서 Clash 클라이언트를 처음 실행하면 네트워크 확장, 키체인 접근, 손쉬운 사용 권한 팝업이 차례로 나타납니다. 각 팝업의 역할, 올바르게 허용하는 방법, 권한이 실패했을 때 복구하는 방법을 하나씩 설명합니다.
전체 보기 →
고급 설정
Clash 정책 그룹 url-test, fallback, load-balance 차이와 설정 작성법
세 가지 자동 정책 그룹이 각각 해결하는 문제: url-test는 가장 빠른 노드를 고르고, fallback은 가용성을 보장하고, load-balance는 트래픽을 분산합니다. 매개변수 의미를 하나씩 풀어 설명하고 바로 적용할 수 있는 YAML 설정 예시를 제공합니다.
전체 보기 →