01 빠른 시작 3단계
빠르게 사용해보고 싶다면 먼저 이 3단계를 확인하세요. 이후 섹션에서 각 플랫폼별로 더 자세한 설명을 이미지와 함께 제공합니다.
http로 시작하는 링크)를 붙여넣은 다음 업데이트를 누르면 클라이언트가 자동으로 노드와 규칙 설정을 가져옵니다.
02 플랫폼별 설치 방법
운영체제마다 권한 설정과 클라이언트 선택에 약간의 차이가 있습니다. 아래에서 플랫폼별로 설명합니다.
Windows 설치 방법
macOS 설치 방법
Android 설치 방법
iOS 설치 방법
Linux 설치 방법
~/.config/clash/ 디렉터리에 배치하세요. 커맨드라인 코어는 기본적으로 이 경로를 읽습니다../mihomo -d ~/.config/clash를 실행하면 시작됩니다. 백그라운드에서 상시 실행하려면 systemd로 서비스 유닛을 작성해 부팅 시 자동 실행되도록 설정하는 것을 추천합니다.03 구독 링크 등록 방법
구독 링크(Subscription URL)는 프록시 서비스가 제공하는 원격 주소로, 내용은 보통 Base64로 인코딩되거나 YAML 형식의 설정 파일이며 여러 노드 정보를 포함합니다. 클라이언트가 이 주소에 정기적으로 접속하면 노드 목록이 자동으로 업데이트되어 매번 수동으로 입력할 필요가 없습니다.
04 설정 파일 구조 상세 설명
Clash의 핵심은 config.yaml이라는 텍스트 파일로, YAML 형식으로 포트, 노드, 프록시 그룹, 규칙을 정의합니다. 이 구조를 이해하면 구독 내용을 파악하거나 규칙을 직접 조정하는 데 도움이 됩니다. 아래는 간단한 예시입니다:
# 기본 리스닝 포트와 동작 모드
mixed-port: 7890
mode: rule
log-level: info
# 노드 목록: 각 노드는 하나의 프록시 서버에 해당
proxies:
- { name: "HK-01", type: vmess, server: example.com, port: 443 }
# 프록시 그룹: 노드를 분류하고 선택 방식을 지정
proxy-groups:
- { name: "PROXY", type: url-test, proxies: ["HK-01"], url: "http://www.gstatic.com/generate_204", interval: 300 }
# 규칙: 각 요청의 최종 경로를 결정
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY주요 필드 설명
| 필드 | 역할 |
|---|---|
| mixed-port | HTTP와 SOCKS5 프로토콜을 모두 지원하는 로컬 리스닝 포트로, 브라우저나 시스템 프록시는 보통 이 포트를 지정합니다. |
| mode | 동작 모드: rule(규칙에 따라 분기, 가장 일반적), global(모든 트래픽을 동일 노드로), direct(모두 직접 연결, 프록시를 일시적으로 끌 때 사용). |
| proxies | 노드 목록으로, 각 항목은 하나의 프록시 서버 연결 방식(프로토콜 종류, 주소, 포트, 암호화 방식 등)을 설명합니다. |
| proxy-groups | 여러 노드를 하나의 그룹으로 묶고 선택 방식을 지정합니다: select(수동 선택), url-test(지연 시간이 가장 낮은 노드 자동 선택), fallback(장애 조치), load-balance(부하 분산). |
| rules | 규칙 목록으로, 위에서 아래로 순서대로 매칭되며 일치하면 즉시 적용되므로 순서가 중요합니다. |
proxies와 proxy-groups를 자동으로 생성하므로, 일반 사용자는 rules 부분만 조정하면 개인화된 분기 요구를 충족할 수 있습니다. 각 필드의 전체 값과 설명은 설정 문서 센터를 참고하세요.05 규칙 문법 전체 대조표
규칙의 작성 방식은 유형,매칭 내용,목표 정책으로 통일되어 있으며, 목표 정책은 프록시 그룹 이름이거나 DIRECT(직접 연결) 또는 REJECT(차단)일 수 있습니다.
| 규칙 유형 | 예시 | 설명 |
|---|---|---|
| DOMAIN | DOMAIN,ad.example.com,REJECT | 완전한 도메인 이름에 정확히 일치(서브도메인 미포함). |
| DOMAIN-SUFFIX | DOMAIN-SUFFIX,github.com,PROXY | 해당 도메인과 모든 서브도메인에 일치. 가장 많이 사용되는 규칙 유형. |
| DOMAIN-KEYWORD | DOMAIN-KEYWORD,ad-track,REJECT | 도메인에 지정된 키워드가 포함되면 일치. 광고나 통계 도메인을 일괄 차단할 때 주로 사용. |
| GEOIP | GEOIP,CN,DIRECT | 목표 IP가 속한 국가나 지역으로 일치. 중국 본토 IP 직접 연결에 가장 흔히 사용되는 방법. |
| IP-CIDR | IP-CIDR,192.168.0.0/16,DIRECT | IP 주소 대역으로 일치. LAN이나 내부 네트워크 주소 직접 연결에 주로 사용. |
| DST-PORT | DST-PORT,443,PROXY | 목표 포트 번호로 일치. 포트별로 트래픽 유형을 구분할 때 사용. |
| PROCESS-NAME | PROCESS-NAME,chrome.exe,PROXY | 요청을 보낸 프로세스 이름으로 일치. 데스크톱(Windows/macOS/Linux)만 지원. |
| MATCH | MATCH,PROXY | 기본 규칙으로, 앞의 어떤 규칙에도 매칭되지 않은 모든 트래픽에 적용되며 규칙 목록의 마지막 줄에 두어야 합니다. |
GEOIP,CN,DIRECT나 MATCH 같은 포괄적인 기본 규칙은 마지막에 둡니다. Rule Provider 등 고급 사용법은 고급 설정 가이드를 참고하세요.06 자주 발생하는 문제 해결
아래는 초보자가 가장 자주 겪는 세 가지 문제입니다. 전체 문제 해결 목록(설치, 연결, 구독, 설정, 계정 보안 관련 20개 이상의 문제)은 별도의 자주 묻는 질문 페이지를 참고하세요.
Clash 연결 후 인터넷에 접속되지 않으면 어떻게 하나요?+
구독 업데이트가 실패하거나 서버에 연결할 수 없다고 나오면 어떻게 하나요?+
Clash 클라이언트 자체는 무료인가요?+
07 용어 설명
Clash를 처음 접할 때 자주 마주치는 전문 용어가 몇 가지 있습니다. 여기서는 가장 기본적인 것들만 소개합니다. 전체 용어 사전(프로토콜, 규칙, 네트워크 모드 등 30개 이상의 항목)은 별도의 용어 설명 페이지를 참고하세요.