오픈 소스 프로젝트 · 모든 플랫폼 클라이언트 지속 업데이트

Clash 다운로드 공식 사이트
모든 플랫폼 클라이언트
규칙 설정 및 구성

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

모든 플랫폼 클라이언트, mihomo 코어 및 한국어 설정 문서를 한곳에서 확인하세요. 구독 가져오기부터 규칙 모드, 시스템 프록시, DNS, TUN 설정까지 단계별로 안내합니다.

영구 무료 오픈 소스 규칙 기반 한국어 문서
5개 데스크톱 및 모바일 플랫폼 MIT 오픈 소스 생태계 mihomo 활발한 코어 YAML 설정 및 규칙
분산된 작업

수동 프록시 설정은 어디에서 꼬이기 쉬울까요?

브라우저, 명령줄, 데스크톱 앱이 각각 프록시 매개변수를 저장하면 네트워크 전환, 주소 업데이트, 연결 문제 해결 때마다 같은 작업을 반복해야 합니다. 규칙이 여러 프로그램에 흩어져 있으면 특정 요청이 최종적으로 어디로 향했는지도 확인하기 어렵습니다.

  • 앱마다 프록시를 따로 수정
    포트나 네트워크가 바뀌면 기존 설정을 하나씩 확인해야 합니다.
  • 규칙 순서를 한곳에서 관리하기 어려움
    도메인, 주소 대역, 기본 정책을 중앙에서 관리하기 어렵습니다.
  • 기기마다 별도의 설정을 관리
    변경 내용을 동기화하기 어렵고 문제 해결 절차도 제각각입니다.
중앙 집중 설정

규칙, 구독, 시스템 연결을 한곳에서 관리

Clash 클라이언트는 동일한 유형의 YAML 설정을 읽어 프록시 그룹, 규칙, DNS, 네트워크 연결을 하나의 제어 화면에 담습니다. 일상적인 전환은 설정 파일과 실행 모드 중심으로 이루어지므로 앱마다 반복해서 수정할 필요가 없습니다.

  • 규칙 순서에 따라 자동으로 트래픽 분기
    도메인, 프로세스, 주소 대역이 일치하면 지정된 정책으로 전달됩니다.
  • 여러 플랫폼에서 하나의 구독 사용
    호환 클라이언트에 같은 구독을 가져온 뒤 각각 활성화할 수 있습니다.
  • 필요에 따라 시스템 프록시와 TUN 전환
    앱의 시스템 프록시 준수 여부에 따라 연결 방식을 선택합니다.
mode: rule
mixed-port: 7890
rules:
  - GEOSITE,cn,DIRECT
  - GEOIP,CN,DIRECT,no-resolve
  - MATCH,PROXY
핵심 기능

구독 가져오기부터
규칙 일치까지
각 설정 단계를 파악하세요

먼저 기능 색인에서 핵심 내용을 확인한 다음, 아래 네 가지 화면 예시로 관련 설정을 이해해 보세요. 예시는 실제 필드와 규칙 문법을 사용하며 노드 정보나 속도 측정 결과는 포함하지 않습니다.

정책 그룹은 규칙이 일치한 뒤 사용할 출구를 결정합니다.

자동 선택, 장애 조치, 수동 선택 중 사용 방식에 맞게 선택하며, 규칙 자체에는 정책 그룹 이름만 참조합니다.

01 · PROXY-GROUPS

정책 그룹 선택기: 규칙과 실제 출구를 분리

정책 그룹은 규칙과 프록시 설정 사이의 중간 계층입니다. 규칙에 PROXY, Auto 또는 사용자 지정 그룹 이름을 입력하면, 일치 후 정책 그룹이 실제 선택 방식을 결정합니다. 따라서 정책을 바꿀 때 전체 규칙을 다시 작성할 필요가 없습니다. 일상적인 사용에서는 수동 선택 그룹 하나를 유지하고 필요에 따라 url-test, fallback 또는 select 유형을 추가할 수 있습니다. 설정을 변경한 뒤에는 그룹 이름과 규칙의 참조가 완전히 일치하는지 먼저 확인하세요. 이름에 공백이나 한글이 포함되어도 원문 그대로 유지해야 규칙이 마지막 기본 항목으로 빠지는 일을 막을 수 있습니다.

각 규칙에 실제 출구를 직접 적는 방식보다 정책 그룹이 장기적인 관리에 적합합니다. 하나의 그룹을 도메인 규칙, 프로세스 규칙, 주소 대역 규칙에서 함께 참조할 수 있어 한 번만 전환해도 관련 트래픽 전체에 적용됩니다.

프록시 그룹 type: select
PROXY 규칙 기본 정책
선택됨
DIRECT 직접 연결
선택
Auto type: url-test
선택 
proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - Auto
      - DIRECT
02 · RULES

규칙 목록: 구체적인 일치부터 범위 및 기본값 순서로 배치

Clash는 설정 파일에 적힌 순서대로 규칙을 하나씩 확인하고 첫 번째 일치 항목에서 검사를 멈춥니다. 따라서 단일 도메인, 프로세스 이름, 로컬 네트워크 주소는 보통 앞에 두고, 적용 범위가 넓은 GEOSITE, GEOIP는 뒤에 배치하며, 마지막에는 MATCH로 일치하지 않은 연결을 처리합니다. no-resolve는 일부 IP 규칙이 일치를 위해 추가 도메인 조회를 수행하지 않도록 할 수 있지만, 모든 규칙에 붙이는 고정 접미사는 아닙니다. 필드 유형과 DNS 구성에 따라 사용하세요.

트래픽 분기를 점검할 때 정책 그룹의 현재 선택만 보지 말고 연결 상세에서 일치한 규칙도 확인하세요. 결과가 예상과 다르면 먼저 위쪽에 범위가 더 넓은 규칙이 있어 요청을 먼저 가로챘는지 확인하는 것이 좋습니다.

규칙 위에서 아래로 일치
  1. DOMAIN-SUFFIX,github.com,PROXYcustom
  2. IP-CIDR,192.168.0.0/16,DIRECT,no-resolvelan
  3. GEOSITE,cn,DIRECTgeosite
  4. GEOIP,CN,DIRECT,no-resolvegeoip
  5. MATCH,PROXYfallback
03 · TUN

TUN 모드: 시스템 프록시를 따르지 않는 연결 처리

시스템 프록시는 브라우저와 운영체제 프록시 설정을 적극적으로 읽는 앱에 적합합니다. 게임 런처, 일부 명령줄 프로그램, 자체 네트워크 스택을 사용하는 소프트웨어는 이를 우회할 수 있습니다. TUN 모드는 가상 네트워크 인터페이스로 더 넓은 범위의 트래픽을 인계한 뒤 규칙 시스템에 전달해 경로를 판단합니다. 처음 활성화할 때 데스크톱 운영체제에서 관리자 권한이나 네트워크 구성 요소 설치를 요구할 수 있습니다. 먼저 네트워크를 동시에 인계하는 다른 도구를 종료하고 DNS와 라우팅 설정을 확인해 인터페이스 충돌과 순환 전달을 줄이세요.

모든 상황에서 TUN을 계속 켜 둘 필요는 없습니다. 브라우저와 일반 데스크톱 앱만 사용한다면 시스템 프록시가 보통 더 직관적입니다. 특정 프로그램이 Clash를 통과하지 않을 때 TUN으로 전환하고 로그에서 연결이 인계되었는지 확인하세요.

네트워크 및 TUN 설정
TUN 모드가상 네트워크 인터페이스 활성화
자동 라우팅auto-route
인터페이스 자동 감지auto-detect-interface
엄격한 라우팅strict-route
tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
04 · PROFILES

구독 업데이트: 원격 설정과 로컬 오버라이드 구분

구독 링크는 보통 서비스 제공자가 생성하며, 클라이언트가 이를 다운로드해 설정 파일로 저장합니다. 가져온 뒤 설정이 정상적으로 파싱되는지 확인하고 프록시 그룹, 규칙, DNS 필드가 모두 있는지 점검하세요. 구독으로 생성된 파일을 직접 수정하면 다음 업데이트에서 내용이 바뀔 수 있습니다. 장기간 유지할 규칙, DNS 매개변수, 정책 그룹 변경은 클라이언트가 지원하는 오버라이드, 병합 설정 또는 별도의 로컬 파일에 두는 편이 좋으며, 업데이트 후 참조 관계를 다시 확인해야 합니다.

자동 업데이트 간격이 수동 확인을 대신해서는 안 됩니다. 네트워크 환경이 바뀌거나 구독 주소가 만료되거나 원격 형식에 문제가 생기면 업데이트 시간과 실행 로그를 확인하세요. 필요하다면 먼저 사용 가능한 이전 설정으로 되돌린 뒤 다운로드 실패인지 파싱 실패인지 구분해 원인을 찾습니다.

설정 파일 config.yaml
YAML
원격 구독 설정 업데이트 간격: 24시간
MERGE
로컬 오버라이드 설정 규칙 및 DNS 변경 사항 보존
활성화됨
플랫폼 입구

기기에 맞는 Clash 클라이언트 선택

클라이언트마다 화면과 코어 통합 방식에는 조금씩 차이가 있지만 기본 흐름은 같습니다. 앱 설치, 구독 가져오기, 정책 그룹 선택, 시스템 프록시 또는 TUN 활성화 순서입니다. 다운로드 센터에서 플랫폼별 클라이언트, 지원 아키텍처, 설치 방법을 확인할 수 있습니다.

Windows

일반적인 데스크톱 사용에 적합합니다. 설치 후 트레이 메뉴에서 시스템 프록시를 전환하고 설정 화면에서 시작 시 실행, TUN, 구독 업데이트를 관리할 수 있습니다. 다운로드하기 전에 기기가 일반적인 x64 아키텍처인지 확인하세요.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel 기기에 맞는 빌드를 각각 제공합니다. 처음 실행할 때 시스템 설정에서 앱 권한을 확인해야 할 수 있으며, TUN을 활성화하려면 해당 네트워크 확장도 허용해야 합니다.

다운로드 페이지로 이동

Android

휴대폰과 태블릿에 적합합니다. 구독을 가져온 뒤 시스템에서 VPN 연결 생성을 허용해야 합니다. 배터리 절약 정책이 백그라운드 실행을 제한할 수 있으므로 기기 설정에서 클라이언트가 네트워크 연결을 계속 처리하도록 허용하세요.

다운로드 페이지로 이동

iOS

App Store에서 Clash 설정과 호환되는 클라이언트를 받을 수 있습니다. 처음 연결할 때 시스템 안내에 따라 VPN 설정을 추가한 뒤 구독을 가져오고 규칙 모드를 선택하세요. 모바일 네트워크와 Wi-Fi에서 같은 설정을 사용할 수 있습니다.

다운로드 페이지로 이동

Linux

그래픽 클라이언트를 선택하거나 mihomo 코어를 직접 실행할 수 있습니다. 데스크톱 사용자는 GUI를 우선 사용하고, 서버와 라우터 환경에서는 프로세서 아키텍처, 서비스 관리 방식, 설정 경로에 맞춰 배포해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →
빠른 시작

가져오기, 선택, 연결

처음 설정할 때는 가장 짧은 기본 흐름부터 완료하고 DNS, 오버라이드, 복잡한 규칙 수정은 서두르지 마세요. 기본 연결이 정상인지 확인한 뒤 설정을 하나씩 추가하면 어느 단계에서 문제가 생겼는지 더 쉽게 파악할 수 있습니다.

  1. 01

    구독 또는 YAML 파일 가져오기

    클라이언트의 설정, 구독 또는 Profiles 페이지를 열고 구독 주소를 붙여 넣어 다운로드하거나 로컬 YAML 파일을 선택하세요. 가져온 뒤 화면에 설정 이름과 프록시 그룹이 표시되는지 확인합니다. 파싱 실패 메시지가 나오면 먼저 링크가 완전한지 확인하고 로그에서 필드 위치를 살펴보세요. 같은 주소를 연속으로 반복 가져오지는 마세요.

  2. 02

    규칙 모드와 정책 그룹 선택

    실행 모드를 Rule로 전환한 다음 프록시 페이지에서 주요 정책 그룹을 선택하세요. 규칙 모드는 설정의 rules 순서에 따라 연결을 판단합니다. Global은 대부분의 트래픽을 하나의 정책으로 보내고 Direct는 직접 연결합니다. 일반적으로 Rule부터 시작하면 로컬 네트워크와 지정 사이트의 직접 연결 규칙을 유지하기 쉽습니다.

  3. 03

    시스템 프록시 활성화 및 일치 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, 모바일에서는 시스템 안내에 따라 VPN 연결을 허용하세요. 그런 다음 접속할 사이트를 열고 연결 또는 로그 페이지에서 요청이 표시되는지, 어떤 규칙과 일치했는지, 어느 정책 그룹으로 들어갔는지 확인합니다. 대상 프로그램에 연결 기록이 없다면 여러 네트워크 옵션을 동시에 변경하기보다 TUN 활성화를 고려하세요.

전체 가이드 보기 →

자주 묻는 질문

구독을 가져온 뒤 선택할 정책이 없으면 어떻게 하나요? 설정이 정상적으로 파싱되었는지 확인한 다음 프록시 그룹 필드와 구독 내용이 완전한지 점검하세요. 시스템 프록시를 켜도 연결되지 않는 프로그램이 있으면 어떻게 하나요? 해당 프로그램이 시스템 프록시를 사용하지 않을 수 있으므로 충돌이 없는지 확인한 뒤 TUN 모드를 시도해 보세요. Fake-IP와 Redir-Host는 어떻게 다른가요? 도메인 조회와 연결 매핑을 처리하는 방식이 다릅니다. DNS 용어 설명부터 살펴보세요. 규칙 모드가 예상대로 트래픽을 분기하지 않는 이유는 무엇인가요? 규칙 순서와 연결 상세를 확인하세요. 범위가 넓은 규칙이 위에서 먼저 일치했을 수 있습니다.
오픈 소스 생태계

Clash 설정부터 mihomo 코어까지

Clash는 널리 사용되는 YAML 설정 구조를 발전시켰으며, 핵심 개념은 프록시, 정책 그룹, 규칙, DNS, 실행 모드입니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환 설정을 중심으로 계속 발전했고, 데스크톱과 모바일 클라이언트도 새로운 코어 분기를 점차 채택했습니다. 특정 화면의 위치를 외우는 것보다 설정 구조를 이해하는 편이 중요합니다. 클라이언트를 바꿔도 규칙 순서, 정책 그룹 참조, DNS 로직을 그대로 활용할 수 있기 때문입니다.

mihomo는 Clash Meta 이후 사용되는 코어 이름으로, 기존 규칙 모델을 바탕으로 프로토콜, 규칙 세트, DNS, TUN 기능을 계속 확장합니다. GUI 클라이언트는 설정 관리, 시스템 권한, 트레이 작업, 업데이트 진입점을 담당하고 코어는 설정 파싱, 연결 수립, 트래픽 분기를 실행합니다. 두 영역의 역할이 다르므로 문제를 해결할 때는 먼저 UI 계층이 설정을 제대로 기록하지 못한 것인지, 코어 계층의 파싱 또는 실행이 실패한 것인지 판단해야 합니다.

오픈 소스 저장소에서는 설정 필드, 변경 기록, 이슈 논의를 공개적으로 확인할 수 있습니다. 익숙하지 않은 필드는 먼저 현재 코어 문서와 대조해 해당 필드의 계층, 사용 가능한 값, 플랫폼 제한을 확인한 뒤 로컬 설정에 작성하세요. 흩어진 조각만 복사하면 들여쓰기, 의존 항목, 사전 설정을 빠뜨리기 쉽습니다. 특히 TUN, DNS, 규칙 세트 제공자는 전체 맥락을 함께 확인해야 합니다.

클라이언트와 코어의 업데이트 주기는 완전히 같지 않습니다. 다운로드 페이지는 플랫폼별 진입점을 정리하고, 가이드는 안정적인 사용 절차에 집중하며, 기술 노트는 규칙 문법, 로그, 코어 차이를 기록합니다. 업그레이드 전에 현재 정상 작동하는 설정을 보관하고, 업그레이드 후 구독 로드, 정책 그룹, 기본 연결을 먼저 검증한 다음 새 기능을 확인하면 변경 범위를 명확한 단계 안에 관리할 수 있습니다.

기술 노트

규칙, 플랫폼 및 코어 안내

아래 글은 구체적인 문제에서 출발해 홈페이지에서 다루지 않은 문법 세부 사항, 플랫폼 설치 절차, 코어 차이를 보완합니다. 자신의 설정 파일과 클라이언트 로그를 함께 보며 항목별로 확인해 보세요.

규칙 설정

Clash 사용자 지정 규칙 작성법: DOMAIN, IP-CIDR, GEOSITE 문법과 일치 순서

Clash 규칙 필드의 작성법과 적용 상황을 유형별로 설명하고, 규칙이 위에서 아래로 검사되며 첫 번째 일치에서 중지되는 원칙을 다룹니다. 또한 no-resolve, MATCH 기본 처리, 규칙 세트 순서가 실제 트래픽 분기 결과에 미치는 영향도 살펴봅니다.

전체 글 읽기 →
플랫폼 가이드

iPhone에서 Clash 사용하기: App Store 클라이언트 설치부터 구독 가져오기까지

iOS 사용자를 대상으로 호환 클라이언트를 스토어에서 설치하고, 구독을 가져오며, VPN 설정을 허용하고, 규칙 일치를 확인하는 전체 과정을 안내합니다. 권한 승인 실패, 설정 미로드, 연결 미적용 시 점검 순서도 정리했습니다.

전체 글 읽기 →
코어 선택

Clash 코어 버전 비교: 기본 Premium, Clash Meta, mihomo의 차이

다양한 코어 분기의 관계를 정리하고 프로토콜 지원, 규칙 필드 확장, GEOSITE, TUN 기능을 비교합니다. 그래픽 클라이언트와 코어의 역할 경계도 설명해 플랫폼과 설정 요구 사항에 맞는 선택을 돕습니다.

전체 글 읽기 →
전체 글 보기 →