오픈소스 생태계 자료 · 전체 플랫폼 사용 가이드

Clash 리소스 허브
전체 플랫폼 클라이언트 및 설정 가이드

공식 Clash 다운로드 가이드 보기

클라이언트 선택부터 규칙 적용까지 전체 플랫폼 다운로드 경로, 한국어 설정 안내와 규칙 분기 방법을 한곳에 정리했습니다. 먼저 작동하는 연결을 만든 뒤 프록시 모드, 정책 그룹과 설정 파일을 단계적으로 이해해 보세요.

영구 무료 오픈소스 한국어 문서 규칙 기반
플랫폼 선택
Windows Android iOS macOS Linux
주요 경로 표시
미국 일본 홍콩 싱가포르 한국
PLATFORMS / WINDOWS · MACOS · ANDROID · IOS · LINUX CORE / MIHOMO · CLASH CONFIG / YAML · RULE PROVIDERS LICENSE / OPEN SOURCE
핵심 기능

먼저 트래픽이 어떻게 판단되고 전달되는지 이해하기

Clash의 핵심은 버튼을 반복해서 전환하는 것이 아니라 구독, 정책 그룹, 규칙과 시스템 적용 방식을 설명 가능한 처리 흐름으로 구성하는 데 있습니다. 아래 자료에서는 먼저 전체 개요를 제공하고, 뒤의 상세 장에서 구체적인 구조를 살펴봅니다.

매칭 순서

규칙은 위에서 아래로 하나씩 판단

도메인, 대상 IP, 프로세스와 지리 정보는 각각 매칭 조건이 될 수 있습니다. 요청이 적용 가능한 첫 번째 규칙과 일치하면 해당 정책 그룹으로 전달되므로, 구체적인 규칙은 범위가 넓은 규칙보다 앞에 배치해야 합니다. 마지막에는 MATCH가 일치하지 않은 트래픽을 처리합니다. 순서를 이해하면 중국 본토 직결, 특정 서비스 프록시와 LAN 우회를 명확하고 유지 관리하기 쉬운 설정으로 작성할 수 있습니다.

rules:
  - DOMAIN-SUFFIX,example.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
규칙 엔진

구체적인 조건에서 최종 예외 처리까지

규칙 모드는 설정의 규칙 목록을 읽고 작성된 순서대로 현재 연결을 확인합니다. 도메인 접미사를 예로 들면 DOMAIN-SUFFIX는 특정 사이트와 하위 도메인을 함께 처리하는 데 적합하고, 단일 도메인을 정확히 매칭하려면 DOMAIN을 사용할 수 있습니다. 대상이 이미 IP 주소로 표시된다면 IP-CIDR 또는 GEOIP를 함께 활용할 수 있습니다. 규칙 자체는 연결을 담당하지 않고 요청을 DIRECT, REJECT 또는 특정 정책 그룹으로 전달할 뿐입니다.

규칙을 구성할 때는 LAN 주소, 전용 서비스와 명확한 도메인을 먼저 작성하고, 지리적 범위가 넓은 조건을 뒤에 배치한 다음 MATCH를 마지막에 남겨 두세요. 범용 규칙을 앞에 쓰면 뒤의 세부 조건이 적용될 기회를 잃습니다. 문제를 확인할 때는 클라이언트 로그를 열어 요청이 어떤 규칙과 정책 그룹에 매칭되었는지 살펴보세요. 웹페이지가 열리는지만 보고 설정 상태를 추측하지 않는 것이 좋습니다.

config.yaml / rules 순서대로 매칭 
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-SUFFIX,example.cn,DIRECT
  - DOMAIN-SUFFIX,example.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

정책 이름은 proxy-groups에 지정된 이름과 정확히 일치해야 합니다. 수정한 뒤 먼저 설정 검사를 실행하고 클라이언트를 다시 로드하세요.

구독 업데이트

상위 설정을 보존하고 로컬 오버라이드를 분리

구독 링크는 보통 서비스 제공자가 관리하며 프록시 노드, 정책 그룹과 기본 규칙을 함께 포함할 수 있습니다. 업데이트의 본질은 상위 콘텐츠를 다시 가져오는 것이므로, 교체될 파일에 장기적인 사용자 설정을 직접 작성하는 것은 적합하지 않습니다. 오버라이드 또는 병합을 지원하는 클라이언트는 구독과 별도로 로컬 설정을 저장할 수 있고, 명령줄 환경에서는 독립 파일과 자동화 스크립트로 같은 계층화를 구현할 수 있습니다.

업데이트하기 전에 현재 설정이 정상적으로 로드되는지 확인하고 사용 중인 정책 그룹을 기억해 두세요. 업데이트가 끝나면 설정 파싱 결과, 정책 그룹 이름, 규칙 제공자 상태와 DNS 관련 필드를 차례로 확인합니다. 상위 설정에서 그룹 이름을 바꿨는데 로컬 규칙이 이전 이름을 계속 가리키면 문법 검사는 통과해도 예상대로 분기되지 않을 수 있습니다. 업데이트와 전환을 두 작업으로 나누면 문제를 더 쉽게 찾을 수 있습니다.

설정 구조

YAML을 확인 가능한 계층으로 나누기

일반적인 Clash 설정은 공통 포트, 실행 모드, DNS, 프록시 노드, 정책 그룹과 규칙으로 구성됩니다. 설정을 읽을 때 첫 줄부터 끝까지 순서대로 볼 필요는 없습니다. 먼저 mode, mixed-port와 DNS를 확인하고, proxies가 정책 그룹에서 참조되는지 살핀 뒤 규칙 대상이 존재하는지 확인하세요. 들여쓰기 오류를 글자 단위로 찾는 것보다 참조 관계를 따라 점검하는 편이 효과적입니다.

YAML은 공백 계층에 민감하므로 목록 항목, 객체 필드와 문자열의 구조를 명확하게 유지해야 합니다. 정책 이름에 특수 문자가 포함되면 따옴표를 사용하고, 포트는 숫자로 작성하며 불리언 값은 설정에서 허용하는 형식을 사용하세요. 복잡한 설정은 rule-providers와 proxy-providers로 나누고 메인 파일에는 참조 관계만 남기는 것이 좋습니다. 이후 규칙 집합을 업데이트할 때 전체 설정을 다시 작성하지 않아도 됩니다.

설정 파일 레퍼런스 전체 보기 →
클라이언트 다운로드

기기에 맞는 다운로드 경로 선택

운영체제마다 설치 방식, 권한 모델과 백그라운드 제한이 다릅니다. 먼저 기기에 맞는 다운로드 페이지를 선택하고, 구체적인 클라이언트 차이, 시스템 요구 사항과 설치 패키지 유형은 해당 플랫폼 탭에서 확인하세요.

Windows

그래픽 인터페이스, 시스템 프록시 전환 기능과 설정 관리가 필요한 데스크톱 사용자에게 적합합니다. 다운로드 전에 CPU 아키텍처와 설치 패키지 형식을 확인하고, 처음 실행한 뒤 구독을 가져와 시스템 프록시를 활성화하세요.

다운로드 페이지로 이동

macOS

Intel 및 Apple Silicon 기기에 적합합니다. 설치할 때 시스템 안내에 따라 앱 권한을 승인해야 하며, TUN을 사용하는 경우 네트워크 확장 또는 가상 네트워크 장치 관련 권한도 확인해야 합니다.

다운로드 페이지로 이동

Android

Android 클라이언트는 시스템 VpnService를 통해 연결을 인계받습니다. 처음 활성화하면 시스템 권한 승인 안내가 표시됩니다. 백그라운드에서 자주 중단된다면 클라이언트를 배터리 절전 예외 목록에 추가하고 백그라운드 실행을 허용하세요.

다운로드 페이지로 이동

iOS

iPhone과 iPad에서는 시스템 네트워크 확장으로 프록시 도구를 실행합니다. 다운로드 페이지에서 App Store로 이동할 수 있으며, 구독 가져오기, 네트워크 권한 승인과 필요 시 연결 같은 기본 절차도 안내합니다.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 그래픽 클라이언트를 사용할 수 있고, 서버와 라우터 환경에서는 Mihomo 코어를 직접 실행하는 방식이 더 적합합니다. 배포 전에 아키텍처, 파일 권한, 서비스 관리 방식과 TUN 지원 여부를 확인하세요.

다운로드 페이지로 이동

전체 클라이언트 보기 →

빠른 시작

설치부터 연결까지 세 단계로 완료하기

처음부터 복잡한 규칙을 수정할 필요는 없습니다. 먼저 클라이언트가 유효한 설정을 로드하고 시스템 연결을 인계받도록 한 뒤, 실제 접속 결과에 따라 DNS, TUN 또는 사용자 지정 분기를 조정하세요.

  1. 01

    클라이언트 설치 및 구독 가져오기

    다운로드 페이지에서 운영체제와 CPU 아키텍처에 맞는 클라이언트를 선택하세요. 설치가 끝나면 구독 관리 화면을 열고 서비스 제공자가 안내한 구독 주소를 붙여 넣은 뒤 다운로드 또는 업데이트를 실행합니다. 설정이 정상적으로 로드되면 보통 선택 가능한 정책 그룹이 표시됩니다. 즉시 파싱 오류가 나오면 링크가 완전한지, 네트워크에 접속할 수 있는지, 설정 내용이 YAML 구조에 맞는지부터 확인하세요.

  2. 02

    규칙 모드와 사용 가능한 정책 선택

    일상적인 사용에는 규칙 모드를 우선 선택해 도메인과 IP 조건에 따라 직결 또는 프록시를 결정하도록 하세요. 프록시 또는 정책 화면에서 주요 정책 그룹에 사용할 수 있는 출구를 지정합니다. 이때 많은 규칙을 한꺼번에 수정하지 않는 것이 좋습니다. 연결 실패는 노드뿐 아니라 시스템 프록시, DNS 또는 권한 문제에서도 발생할 수 있으므로 변수를 줄여야 원인을 직접적으로 찾을 수 있습니다.

  3. 03

    시스템 프록시 활성화 및 경로 확인

    데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 안내에 따라 시스템 네트워크 연결 권한을 허용한 다음 유형이 다른 웹사이트 몇 곳에 접속해 결과를 확인하세요. 브라우저는 되지만 명령줄 도구가 프록시를 거치지 않는다면 해당 프로그램이 시스템 프록시 설정을 읽지 않을 수 있습니다. 환경 변수를 직접 설정하거나 권한을 확인한 뒤 TUN을 사용해 보세요. 확인이 끝나면 시작 시 자동 실행과 자동 업데이트를 설정합니다.

전체 가이드 보기 →

오픈소스 생태계

Clash 코어부터 지속적으로 유지 관리되는 구현까지

Clash는 처음에 YAML 설정, 정책 그룹과 규칙 목록을 기반으로 사용하는 방식을 정립했고, 이후 데스크톱, 모바일과 명령줄 환경을 위한 여러 클라이언트 프로젝트가 등장했습니다. 프로젝트마다 비슷한 설정 개념을 공유할 수 있지만 그래픽 인터페이스, 코어 선택, 업데이트 주기와 시스템 통합 방식은 완전히 같지 않습니다. 클라이언트를 선택할 때는 화면 디자인만 비교하지 말고 대상 플랫폼, 유지 관리 상태와 필요한 기능을 함께 살펴보세요.

Mihomo는 Clash 코어 생태계를 이어받아 확장했으며, 흔히 사용하는 그래픽 클라이언트는 코어 기능을 구독 관리, 정책 전환, 시스템 프록시, TUN, 로그와 오버라이드 설정 같은 조작 화면으로 제공합니다. 코어는 설정 파싱과 트래픽 처리를 담당하고 그래픽 클라이언트는 시스템 통합과 상호작용을 담당하므로 서로 다른 계층입니다. 문제가 생기면 설정 파싱, 코어 실행, 클라이언트 권한과 운영체제 네트워크 설정 중 어느 계층의 문제인지 먼저 판단하면 범위를 더 빠르게 좁힐 수 있습니다.

오픈소스 저장소에서는 커밋 기록, 릴리스 안내, 이슈 토론과 설정 문서를 직접 확인할 수 있습니다. 자료를 읽을 때는 프로젝트 이름과 유지 관리 브랜치를 확인하세요. 오래된 가이드의 필드가 변경되었거나 일부 클라이언트가 코어 구현을 교체했을 수 있습니다. 이 사이트는 안정적인 개념과 사용 경로를 주제별로 정리하고, 구체적인 설치 패키지와 플랫폼 차이는 다운로드 페이지에, 긴 필드 설명은 설정 레퍼런스 페이지에 모았습니다.

업데이트 메커니즘도 계층별로 이해해야 합니다. 클라이언트 업데이트는 인터페이스와 시스템 호환성 문제를 해결하고, 코어 업데이트는 프로토콜, 규칙과 네트워크 스택 기능을 개선하며, 구독 업데이트는 노드 또는 서비스 제공자의 설정을 교체합니다. 이 세 가지 업데이트는 서로 독립적입니다. 수정 전 정상적으로 로드되는 설정을 보관하고 업데이트 후 설정, 정책 그룹과 시스템 적용 상태를 차례로 확인하면 여러 변화가 동시에 발생해 문제를 찾기 어려워지는 상황을 줄일 수 있습니다.

자주 묻는 질문

먼저 문제가 발생한 계층을 확인하세요

설치, 설정, 시스템 적용과 대상 웹사이트 상태는 서로 영향을 줍니다. 계속 노드를 바꾸거나 클라이언트를 반복 설치하는 것보다 계층별로 확인하는 편이 원인을 찾기 쉽습니다.

구독을 가져온 뒤 정책 그룹이 보이지 않으면 어떻게 하나요?

먼저 구독 업데이트가 성공했는지 확인한 다음 클라이언트 로그에서 설정 파싱 결과를 확인하세요. YAML을 로드하지 못하면 정책 그룹이 표시되지 않습니다. 설정은 정상인데 그룹이 비어 있다면 프록시 제공자가 정상적으로 가져와졌는지 확인해야 합니다. 전체 점검 절차는 문제 해결 페이지의 '설치 및 설정' 분류에서 확인할 수 있습니다.

설치 및 설정 문제 보기 →

규칙 모드, 전체 모드와 직결 모드 중 무엇을 선택해야 하나요?

규칙 모드는 설정에 따라 항목별로 판단하므로 일상적인 사용에 적합합니다. 전체 모드는 연결을 지정한 정책으로 일괄 전달하므로 출구를 임시로 테스트할 때 유용합니다. 직결 모드는 프록시를 우회해 장애가 프록시 경로와 관련 있는지 확인할 때 사용할 수 있습니다. 전환 후에는 연결을 새로 시작해야 하며 기존 연결의 경로가 즉시 바뀌지 않을 수 있습니다.

기본 개념 문제 보기 →

브라우저는 되는데 다른 프로그램은 왜 프록시를 거치지 않나요?

일부 프로그램은 시스템 프록시를 읽지 않거나 독립적인 네트워크 스택을 사용합니다. 먼저 프로그램 자체가 HTTP, HTTPS 또는 SOCKS 프록시를 지원하는지 확인하세요. 더 많은 트래픽을 인계받아야 한다면 TUN 모드의 권한, 라우팅과 DNS 설정을 점검하세요. 원인이 분명하지 않은 상태에서 여러 프록시 도구를 동시에 켜지는 마세요.

문제 해결 가이드 보기 →

구독 업데이트 후 사용자 지정 규칙이 사라지면 어떻게 하나요?

원격 구독을 업데이트하면 원본 설정이 교체될 수 있으므로 장기적으로 사용할 규칙은 클라이언트의 오버라이드, 병합 설정 또는 독립 규칙 제공자에 저장해야 합니다. 복구하기 전에 현재 설정과 백업을 비교하고 정책 그룹 이름이 여전히 존재하는지 확인한 뒤 로컬 변경 사항을 단계별로 추가하세요. 이전 참조 때문에 로드가 실패하는 문제를 피할 수 있습니다.

사용 팁 문제 보기 →
최근 글

플랫폼 설정과 규칙 활용

구체적인 기기, 프록시 모드와 분기 상황을 바탕으로 기본 가이드에서 다루지 못한 사용 방법을 보완합니다.

규칙 분기

Clash 중국 본토·해외 트래픽 분기 규칙 실전: 도메인 규칙, GEOIP와 최종 예외 처리

중국 본토는 직결하고 해외는 프록시를 사용하는 대표적인 요구를 예로 들어 규칙 순서, 정책 그룹 연결과 MATCH 최종 처리를 이해합니다.

전체 글 읽기
안드로이드 가이드

Android에서 Clash 클라이언트 안정적으로 실행하기: VpnService 권한과 배터리 절전 예외 설정

시스템 네트워크 권한, 백그라운드 제한과 배터리 최적화의 관계를 설명하고, 자주 발생하는 연결 중단 문제의 점검 순서를 안내합니다.

전체 글 읽기
입문 가이드

Clash 규칙·전체·직결 프록시 모드 선택법: 상황별 비교와 전환 핵심

일상적인 접속, 임시 문제 해결과 전체 트래픽 테스트 상황을 비교해 세 가지 모드의 전달 방식 차이를 이해합니다.

전체 글 읽기

전체 글 보기 →