YAML 
# 기본 구조 예제, 트래픽은 기본적으로 직접 연결mixed-port: 7890allow-lan: falsemode: rulelog-level: infodns:  enable: true  enhanced-mode: fake-ip  nameserver:    - https://dns.alidns.com/dns-queryrules:  - MATCH,DIRECT
mihomo · 설정 구조 예제UTF-8 / 2칸 들여쓰기
YAML 매뉴얼의 구조 개요부터 보기 →

mihomo 커널 · YAML 설정 참고

Clash 클라이언트 다운로드및 YAML 설정 문서

Clash 다운로드 사용법 보기

플랫폼에 맞는 클라이언트를 선택하고 실제 YAML 예제로 규칙 라우팅과 프록시 그룹을 이해한 뒤, 연결 로그에서 설정이 어떻게 적용됐는지 확인하세요.

오픈 소스 코드한국어 문서옵션 참고

운영체제별 설치 안내

Windows Android iOS macOS Linux

CONFIGURATION / MIHOMO

트래픽 유입부터 출구까지

클라이언트는 설정을 불러오고 연결 정보를 표시하며 시스템 인터페이스를 호출합니다. 커널은 설정 항목을 해석하고 DNS를 처리한 뒤 라우팅을 수행합니다. 문제를 진단할 때는 먼저 트래픽이 커널에 들어오는지 확인하고, 그다음 적용된 규칙과 최종 출구를 점검하세요. 아래 다섯 가지 설정은 일상적으로 자주 조정하는 항목을 다룹니다. 예제는 구조를 설명하기 위한 것으로, 실제 프록시 노드는 포함하지 않습니다.

규칙 라우팅은 연결에 어떤 출구를 사용할지 결정합니다. 커널은 목록 순서대로 규칙을 확인해 처음 일치하는 규칙을 적용하므로, 정확한 도메인 규칙은 범위가 넓은 규칙보다 앞에 두고 최종 대체 규칙은 맨 끝에 둬야 합니다. 규칙을 직접 작성하거나 규칙 세트로 모아 관리할 수 있습니다. 전역 출구만 바꾸는 방식과 달리, 규칙 모드에서는 대상마다 다른 정책을 적용할 수 있습니다. 수정한 뒤에는 연결 화면에서 대상 도메인, 적용된 규칙, 정책 체인을 확인하세요. 브라우저에서 페이지가 열리는지만으로 트래픽 분류 결과를 판단하면 안 됩니다.

rulesrule-providersMATCH
# 구체적인 규칙을 먼저, 대체 규칙은 마지막에
rules:
  - DOMAIN,example.com,DIRECT
  - DOMAIN-SUFFIX,example.org,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

옵션 유형, 규칙 문법, 병합 예제 보기 →

OPEN SOURCE / PROJECT BOUNDARIES

Clash, mihomo, 클라이언트의 역할

먼저 프로젝트의 구조를 이해한 다음 설치와 설정 방법을 선택하세요. 오픈 소스 저장소에서는 코드와 릴리스 기록, 이슈 논의를 확인할 수 있습니다. 클라이언트의 인터페이스 이름이 비슷하더라도 내장 커널, 시스템 연동, 설정 병합 방식까지 모두 같은 것은 아닙니다.

프로젝트의 역사: 원본과 후속 포크 구분하기

원본 Clash 프로젝트의 유지보수 상태는 달라졌으며 현재 생태계는 여러 독립 프로젝트가 이어가고 있습니다. mihomo는 Clash.Meta에서 발전한 커널 포크 중 하나로, 현재도 활발히 개발되고 있습니다. 검색 결과에는 오래된 튜토리얼, 클라이언트, 설정 화면이 여전히 남아 있을 수 있으므로 글에서 다루는 커널이 현재 사용하는 소프트웨어와 같은지 먼저 확인하세요. 이름에 Clash가 들어간다고 해서 특정 설정 항목을 지원한다고 단정할 수 없으며, 프로젝트 간 공식적인 소속 관계를 뜻하지도 않습니다.

기존 설정을 옮길 때는 노드, 프록시 그룹, 규칙의 구조를 우선 유지하고 커널 지원 여부를 항목별로 확인하세요. “파일을 가져올 수 있음”이 “모든 설정 항목이 적용됨”을 의미하지는 않습니다. 일부 클라이언트는 시작 전에 포트, 제어 인터페이스, TUN 설정을 다시 작성할 수 있어 실제 실행 설정이 구독 원문과 다를 수 있습니다. 차이가 발생하면 클라이언트에서 내보낸 실행 설정과 커널 로그를 기준으로 문제를 진단하세요.

오픈 소스 생태계: 인터페이스와 네트워크 처리는 별도 관리

Clash Verge Rev, FlClash 같은 GUI 클라이언트는 설정 관리, 정책 선택, 연결 목록, 시스템 프록시 기능을 제공합니다. mihomo는 프로토콜 연결, 규칙 매칭, DNS 등 하위 네트워크 작업을 처리합니다. 클라이언트는 설치 파일에 커널을 포함할 수도 있고 별도의 업데이트 기능을 제공할 수도 있습니다. 클라이언트 화면 업데이트와 커널 업데이트가 항상 같은 것은 아닙니다. 프로젝트 안내를 확인할 때는 클라이언트 릴리스 기록과 커널 변경 사항을 함께 살펴보세요. 특히 새 설정 항목, 기본값 변경, 플랫폼 서비스 관련 변경에 주의해야 합니다.

코드가 공개되어 있으면 구현을 살펴볼 수 있고, 이슈 논의를 통해 특정 시스템 환경의 호환성 차이를 파악할 수도 있습니다. 그렇다고 모든 기기에서 같은 설정을 사용할 수 있는 것은 아닙니다. 이 사이트는 클라이언트 다운로드 경로와 한국어 사용 안내를 정리하며, 프로젝트 관리자의 공식 발표를 대신하거나 프록시 노드 및 구독 서비스를 제공하지 않습니다. 소프트웨어 다운로드, 설정 출처, 네트워크 서비스는 서로 별개의 요소이므로 문제가 생기면 각각 확인해야 합니다.

커널의 작동 방식: 설정에서 실제 연결까지

일반적으로 연결은 시스템 프록시나 가상 네트워크 어댑터를 통해 커널에 들어갑니다. 이후 대상 정보와 DNS 결과를 바탕으로 규칙을 확인하고, 마지막으로 프록시 그룹에서 출구를 선택합니다. 프록시 설정은 노드 프로토콜을 설명하고, 프록시 그룹은 출구 후보를 구성하며, 규칙은 트래픽을 어디로 보낼지 결정합니다. 이 세 계층의 관계를 이해하면 노드를 바꿔도 모든 규칙을 다시 작성할 필요가 없고, 규칙을 수정해도 클라이언트를 다시 설치할 필요가 없습니다. 노드 서비스의 사용 가능 여부는 인증 정보, 서버 상태, 로컬 네트워크를 따로 확인해야 합니다.

설정 카드의 직접 연결 예제는 YAML 구조만 보여 주며 프록시 연결을 만들지는 않습니다. 실제로 사용하려면 신뢰할 수 있는 출처에서 실제 노드가 포함된 설정을 가져오고, 규칙에서 참조하는 그룹 이름이 존재하는지 확인해야 합니다. YAML 들여쓰기는 공백을 사용하고 목록 항목의 계층을 일관되게 유지하세요. 도메인, 노드, 프록시 그룹 이름의 철자도 확인해야 합니다. 수정 후에는 클라이언트의 설정 검사 기능을 사용한 다음 다시 불러오세요. 문법 오류와 네트워크 장애를 함께 진단하는 일을 줄일 수 있습니다.

업데이트 방법: 되돌릴 수 있게 저장하고 변경 사항 검증하기

업그레이드 전에 현재 설정과 필요한 로컬 오버라이드를 저장하고 관련 프로젝트의 변경 사항을 확인하세요. 구독 업데이트는 보통 노드와 원격 규칙을 갱신하고, 클라이언트 업데이트는 인터페이스와 시스템 연동을 바꾸며, 커널 업데이트는 하위 동작을 변경합니다. 업데이트마다 적용 범위가 다릅니다. 업그레이드 후 연결 문제가 생기면 먼저 실행 설정이 바뀌었는지 확인한 뒤 권한, 서비스 상태, 로그를 점검하세요. 업데이트와 동시에 DNS와 라우팅 모드까지 바꾸면 차이가 어디서 생겼는지 파악하기 어렵습니다.

검증할 때는 새 연결 요청을 보내고 트레이 아이콘만 보지 말고 실제 적용된 규칙, 정책 체인, 출구를 확인하세요. 기존 연결은 연결을 만들 당시의 출구를 계속 사용할 수 있고, 브라우저 캐시가 설정 변경을 가릴 수도 있습니다. 로그를 공유하기 전에 구독 주소, 인증 정보, 개인 네트워크 정보를 삭제하세요. 문제를 논의할 때는 필요한 설정 일부, 시스템 환경, 재현 방법만 제공하면 됩니다. 개인 설정 전체를 공개하는 것은 피해야 합니다.

mihomo 소스 코드 보기

Git이 설치된 기기에서는 아래 명령으로 저장소를 복제할 수 있습니다. 소스 코드를 복제해도 클라이언트가 설치되거나 시스템 프록시가 자동으로 설정되지는 않습니다. 일반적인 사용자는 다운로드 페이지에서 GUI 클라이언트를 선택하면 됩니다.

git clone https://github.com/MetaCubeX/mihomo.git

mihomo 오픈 소스 저장소 열기 ↗ / 사이트 콘텐츠의 관리 범위 보기 →

CLIENTS / PLATFORM SELECTION

운영체제에 맞는 Clash 클라이언트 선택

기기 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 플랫폼의 설치 파일을 선택하세요. 데스크톱의 AMD64는 보통 x64를 뜻하며 특정 프로세서 제조사에만 해당하지 않습니다. ARM64는 이와 다른 아키텍처입니다. 다운로드 페이지에서 클라이언트 종류, 시스템 요구 사항, 설치 방법을 확인할 수 있습니다. 이 페이지의 링크는 올바른 플랫폼으로 안내합니다.

Windows 클라이언트

먼저 Clash Plus를 살펴보거나 기능을 비교해 Clash Verge Rev와 FlClash를 선택할 수 있습니다. 설치 전에 시스템 설정에서 아키텍처를 확인하세요. 처음 연결할 때는 시스템 프록시로 동작을 확인한 다음 TUN 서비스를 사용할지 결정하세요. 브라우저는 정상인데 특정 앱만 연결되지 않으면 해당 앱이 시스템 프록시를 사용하는지 확인하세요. UWP 앱은 루프백 제한과 관련된 문제도 발생할 수 있습니다.

다운로드 페이지로 이동 →

macOS 클라이언트

Apple Silicon과 Intel 기기는 각각 맞는 설치 파일을 선택해야 합니다. 클라이언트 인터페이스, 메뉴 막대 제어, 백그라운드 네트워크 서비스에는 서로 다른 권한이 필요하므로 설치 후 시스템 안내에 따라 권한을 허용하세요. 다른 VPN이나 네트워크 필터링 도구가 설치되어 있다면 각 프로그램이 네트워크를 처리하는 범위를 확인해 기본 라우팅을 여러 프로그램이 동시에 변경하지 않도록 하세요.

다운로드 페이지로 이동 →

Android 클라이언트

기기 아키텍처에 맞는 설치 파일을 선택하세요. 설정을 가져온 다음 시스템 VPN 연결 권한을 허용해야 합니다. 연결을 계속 유지하려면 배터리 최적화와 백그라운드 실행 설정도 확인하세요. Clash Android 클라이언트의 앱별 설정과 규칙 라우팅은 역할이 다릅니다. 앱별 설정은 어떤 앱의 트래픽을 처리할지 정하고, 규칙 라우팅은 커널에 들어온 연결의 목적지를 결정합니다.

다운로드 페이지로 이동 →

iOS 클라이언트

다운로드 페이지에서 Clash Plus의 App Store 다운로드 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치한 다음 설정을 가져오고 시스템 안내에 따라 VPN 구성을 허용하세요. 클라이언트마다 지원하는 설정 형식과 항목이 다를 수 있습니다. 기존 YAML 파일을 사용한다면 먼저 호환 여부를 확인한 뒤 프록시 그룹과 규칙이 제대로 가져와졌는지 점검하세요.

다운로드 페이지로 이동 →

Linux 클라이언트

데스크톱 사용자는 Clash Verge Rev와 FlClash를 살펴보고 배포판에 맞는 패키지 형식을 선택할 수 있습니다. 서버나 라우터에서는 다운로드 페이지의 커널 섹션에서 mihomo를 확인하세요. 명령줄에서 커널을 실행하려면 설정 파일 경로, 권한, 서비스 관리 방법을 직접 지정해야 합니다. GUI 클라이언트의 시스템 프록시 설정은 시스템 전체 트래픽을 처리하는 것과 같지 않습니다.

다운로드 페이지로 이동 →

모든 클라이언트 보기 → 인터페이스, 플랫폼, 유지보수 상태를 먼저 비교하고 싶으신가요? 클라이언트 비교 보기.

설치 후 먼저 확인할 세 가지

첫째, 설정이 정상적으로 불러와졌는지 확인하세요. 주소를 가져오는 데 성공해도 노드가 유효하다는 뜻은 아닙니다. 설정 검사 결과와 프록시 그룹 내용을 확인하세요. 둘째, 트래픽이 커널에 들어오는지 확인하세요. 시스템 프록시를 켠 뒤 해당 설정을 지원하는 브라우저에서 새 요청을 보내고 연결 목록에 기록이 나타나는지 확인합니다. 셋째, 트래픽 경로가 예상과 맞는지 확인하세요. 연결 기록에서 적용된 규칙과 정책 체인을 확인하는 것이 지연 시간 숫자 하나를 보는 것보다 실제 결과를 잘 설명합니다.

전역 모드를 선택하면 연결은 보통 GLOBAL 정책으로 전달됩니다. 규칙 모드에서는 규칙 목록에 따라 목적지가 결정됩니다. 모드를 바꿔도 노드 인증 오류가 해결되지는 않으며 DNS나 시스템 권한 설정을 대신하지도 않습니다. 처음 사용할 때는 설정을 간단하게 유지하고 트래픽 처리 방식을 하나만 켜세요. 정상 동작을 확인한 다음 앱별 설정, TUN, 사용자 지정 규칙을 추가하면 됩니다. 자세한 절차는 사용 가이드에서, 설정 항목은 YAML 매뉴얼에서 확인하세요.

READING / PRACTICAL NOTES

연결 확인, 지연 시간 테스트, 플랫폼별 문제 해결

사용 팁은 구체적인 작업별로 살펴보세요. 먼저 반복해서 확인할 수 있는 방법을 만들고, 테스트 수치와 시스템 연동의 한계를 이해하는 것이 좋습니다. Clash에서 인터넷이 연결되지 않으면 클라이언트를 계속 바꾸기보다 연결 기록을 바탕으로 유입 경로, DNS 조회, 출구를 확인하는 편이 문제 범위를 좁히는 데 도움이 됩니다.

모든 글 보기 →