mihomo 코어 · 데스크톱 및 모바일 클라이언트

Clash 클라이언트다운로드 스테이션

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기와 규칙별 라우팅으로 연결을 관리하세요. 한국어 설정 문서도 확인할 수 있습니다.

오픈 소스YAML 설정한국어 가이드

GPL-3.0 오픈 소스mihomo / Clash Meta 코어YAML 설정

규칙과 메뉴는 정적 화면 예시입니다. 실제 설정 명칭은 선택한 클라이언트에 따라 다를 수 있습니다.

Clash 설정 및 연결 관리

구독부터 아웃바운드 정책까지, 설정 항목별 구성 방법을 살펴보세요.

Clash는 설정 파일로 프록시, 정책 그룹, 라우팅 규칙을 정의하는 도구 생태계입니다. GUI 클라이언트는 설정을 표시하고 구독을 관리하며, 코어는 설정 파일을 해석하고 연결을 처리해 트래픽을 분기합니다. 클라이언트를 설치한 뒤에는 코어와 호환되는 구독 또는 로컬 설정을 준비하고 아웃바운드 모드를 선택해야 합니다. 앱 창이 열려 있다고 해서 앱 트래픽이 프록시를 통과하는 것은 아닙니다.

처음에는 규칙 모드와 시스템 프록시부터 설정하는 것이 좋습니다. 먼저 설정을 불러올 수 있는지 확인한 다음 정책 그룹에서 사용할 수 있는 아웃바운드가 선택됐는지 살펴보고, 마지막으로 연결 기록에서 규칙이 적용됐는지 확인하세요. 시스템 프록시를 따르지 않는 앱도 연결해야 한다면 TUN을 고려할 수 있습니다. 아래 다섯 가지 설정은 일반적인 사용 흐름을 다룹니다. 예시는 각 필드의 용도만 설명하며 그대로 사용할 수 있는 완전한 설정은 아닙니다.

rules · 규칙 모드
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-KEYWORD,google,PROXY
  - GEOSITE,category-ads-all,REJECT
  - GEOIP,LAN,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

규칙별 라우팅을 사용하면 대상에 따라 서로 다른 아웃바운드 정책을 적용할 수 있어 개발 도구, 웹사이트, LAN 서비스를 함께 다루기 좋습니다. 규칙은 위에서부터 순서대로 평가되며, 처음 일치한 규칙의 정책이 적용됩니다. 따라서 구체적인 도메인 규칙을 앞에 두고 MATCH는 마지막 기본 규칙으로 남겨 두는 것이 일반적입니다. 예시의 PROXY는 전체 설정에서 정책 그룹으로 정의해야 하며, DIRECT와 REJECT는 내장 정책입니다. 변경 후에는 전역 모드를 계속 바꿔 보기보다 연결 화면에서 적용된 규칙을 확인하는 편이 원인을 파악하기 쉽습니다. 도메인 집합 규칙은 해당 규칙 리소스를 사용할 수 있어야 작동합니다.

기능 이름이 비슷해도 클라이언트마다 설정 방법이 같은 것은 아닙니다. Clash Verge Rev, FlClash 같은 GUI 클라이언트는 일부 필드를 설정 화면에 제공하지만, 나머지는 YAML에서 관리해야 할 수 있습니다. 모바일에서는 시스템 VPN 인터페이스와 백그라운드 정책의 영향도 받습니다. 화면에서 특정 옵션을 찾을 수 없다면 클라이언트 문서와 코어 지원 범위를 먼저 확인하세요. 다른 플랫폼의 설정 경로를 그대로 적용하지 마세요. 단계별 설정은 Clash 설정 가이드에서, 프로토콜 호환성과 코어 차이는 프로토콜 상세 안내에서 확인할 수 있습니다.

운영체제별 Clash 클라이언트 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 다음 설치 파일을 선택하세요.

Windows데스크톱 프록시 및 규칙 관리다운로드하기 → macOS칩 종류에 맞는 설치 파일 선택다운로드하기 → Android구독 관리 및 VPN 연결다운로드하기 → iOSClash Plus 스토어 페이지다운로드하기 → Linux데스크톱 클라이언트 및 코어 안내다운로드하기 →

전체 클라이언트 보기 →

설치 파일 및 실행 환경

Windows: 처음 설치한다면 Clash Plus를 먼저 살펴보고, 설정 관리 방식에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 설치 후에는 구독을 가져오고 시스템 프록시를 설정합니다. TUN이나 서비스 모드가 필요한 경우에만 안내에 따라 관련 권한을 설정하세요. 브라우저는 연결되는데 특정 앱만 연결되지 않는다면 먼저 해당 앱의 프록시 연결 방식을 확인하세요. 스토어 앱을 사용한다면 Clash UWP 루프백 설정도 참고할 수 있습니다.

macOS: Apple Silicon과 Intel은 아키텍처가 다르므로 설치 파일도 구분됩니다. 다운로드 전에 시스템의 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요. Clash Plus, Clash Verge Rev, FlClash는 각 안내에 따라 구독을 설정할 수 있습니다. 메뉴 막대에서 관리하는 방식을 선호한다면 클라이언트의 유지 관리 상태와 권한 안내도 확인하세요. 강화 모드에는 추가 서비스가 필요할 수 있습니다. 앱 설치 허용과 네트워크 인터페이스 생성 허용은 별개의 권한입니다.

Android: Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 앞의 세 앱과 Surfboard는 설정 문법이 서로 다르므로 가져오기 전에 제공된 설정 형식을 확인하세요. 처음 연결할 때 시스템에서 VPN 권한을 요청합니다. 다른 VPN 앱이 실행 중이라면 먼저 연결 충돌을 해결해야 합니다. 백그라운드에서 연결이 끊긴다면 구독 업데이트 주기를 늘리기보다 시스템의 배터리 최적화와 백그라운드 실행 제한을 확인하는 것이 효과적입니다.

iOS: 다운로드 페이지에서 Clash Plus의 App Store 페이지와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 앱 화면에서 호환되는 설정을 가져오고 시스템 네트워크 권한을 승인한 다음 규칙과 정책 그룹을 확인하세요. 데스크톱의 서비스 설치나 시스템 프록시 포트 설정을 휴대폰에 그대로 적용해서는 안 됩니다. 설정 필드 지원 범위는 각 앱의 안내를 확인하세요.

Linux: 데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 배포판의 패키지 체계에 맞는 설치 파일을 사용하세요. 서버와 라우터에서는 mihomo 코어를 직접 실행하고 설정 파일, 서비스 시작, 로그를 관리할 수 있습니다. GUI 클라이언트는 일상적인 조작에 적합하고, 코어를 직접 배포하려면 파일 권한과 네트워크 라우팅을 이해해야 합니다. 자세한 비교는 클라이언트 선택 가이드를 참고하세요.

기존 클라이언트에서 이전하기

Clash for Windows와 ClashX Meta의 보관 페이지는 기존 환경과의 호환을 위한 것입니다. 새로 설치할 계획이라면 현재 유지 관리 중인 클라이언트를 우선 고려하세요. 이전하기 전에 구독 출처, 정책 그룹 선택, 로컬 오버라이드 내용을 기록하고 새 클라이언트에서 다시 가져온 뒤 설정이 정상적으로 해석되는지 확인하세요. 기존 UI에서 인식하던 필드가 더 이상 권장되는 방식이 아닐 수 있으며, 새 프로토콜에는 최신 코어 지원이 필요할 수도 있습니다. 지원이 종료된 클라이언트의 차이는 보관된 클라이언트 안내를 확인하세요.

여러 클라이언트를 동시에 실행하면 시스템 프록시, 수신 포트, TUN 라우팅을 두고 충돌할 수 있습니다. 새 클라이언트를 시험하기 전에 기존 클라이언트를 종료하고 프록시 설정이 원래대로 복구됐는지 확인한 다음 새 설정을 하나씩 활성화하세요. 시작 시 자동 실행이 필요하다면 실제로 사용할 항목만 남겨 두세요. 자세한 절차는 Clash 시작 프로그램 설정에서 확인할 수 있습니다. 이렇게 하면 로그인 후 프록시 대상이 잘못 지정되거나 포트가 이미 사용 중인 문제를 줄일 수 있습니다.

Clash 오픈 소스 생태계와 mihomo 코어

클라이언트, 코어, 설정 출처를 구분하고 프로젝트 문서에서 호환성을 확인하세요.

코어 계열 및 프로젝트 출처

Clash 생태계에는 원본 코어와 이후 파생된 코어, 그리고 이를 기반으로 개발된 GUI 클라이언트가 포함됩니다. Clash Meta는 발전 과정에서 중요한 분기였으며, mihomo는 관련 코어 개발을 이어가고 있습니다. 과거 명칭은 클라이언트 제목이나 설정 문서, 구독 형식 옵션에 계속 등장할 수 있습니다. 따라서 프로토콜 지원 여부를 판단할 때는 앱 이름만 보지 말고 실제 사용 중인 코어를 확인해야 합니다.

mihomo 소스 코드와 문서는 공개 프로젝트를 통해 제공되며, 저장소에서 빌드, 설정, 문제 제보 관련 자료를 확인할 수 있습니다. 코드는 GPL-3.0 라이선스를 따릅니다. 공개 코드를 통해 기능 구현과 변경 배경을 살펴볼 수 있지만, GUI 클라이언트마다 인터페이스, 출시 주기, 권한 관리 방식은 다릅니다. 이 사이트는 생태계 링크와 한국어 안내를 정리합니다. 클라이언트의 배포 주체와 구체적인 라이선스 조건은 각 프로젝트의 자료를 확인하세요.

설정 호환성 및 기능 범위

설정 파일은 보통 프록시 항목, 정책 그룹, 규칙, DNS 등으로 구성됩니다. 코어가 특정 프로토콜을 인식하더라도 클라이언트 화면에서 편집 기능을 제공한다는 뜻은 아닙니다. 반대로 화면에 옵션이 있더라도 실제 코어가 이를 지원해야 합니다. 가져오기에 실패하면 먼저 로그에서 필드명이나 프로토콜명을 확인하고 구독의 출력 형식을 살펴보세요. YAML 문법 오류, 만료된 링크, 네트워크 연결 실패를 한꺼번에 다루지 않는 것이 좋습니다.

설정을 옮길 때 도메인 규칙의 기본 원칙은 대체로 유지할 수 있지만, 프록시 공급자, 지리 데이터, 네트워크 스택, DNS 필드는 서로 다를 수 있습니다. 작동하는 원본 설정을 보관하고 로컬 변경 사항을 하나씩 옮기면 문제를 찾기 쉽습니다. SS, VMess, Trojan, VLESS, Hysteria2, TUIC 중 무엇을 사용할지는 서버 지원, 네트워크 환경, 단말기 성능을 고려해야 합니다. 자세한 내용은 프로토콜 및 코어 기술 참고 자료를 확인하세요.

업데이트 방식 및 연결 확인

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 리소스 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 UI와 시스템 연동을 바꿀 수 있고, 코어 업데이트는 설정 해석과 프로토콜 구현에 영향을 줍니다. 구독 업데이트는 제공자에게서 설정을 다시 가져오며, 규칙 리소스 업데이트는 도메인이나 주소 목록을 변경합니다. 특정 사이트의 라우팅에 문제가 생기면 소프트웨어를 바로 재설치하기보다 현재 적용된 규칙과 실제 사용 중인 리소스를 먼저 확인하세요.

업데이트 전에 현재 설정을 기록해 두고, 업데이트 후 같은 순서로 다시 확인하세요. 설정을 불러올 수 있는지, 정책 그룹이 있는지, 앱 트래픽이 클라이언트에 들어오는지, 대상 연결에 어떤 규칙이 적용됐는지 점검합니다. 웹페이지 하나가 열리는지만 보는 것보다 변경 전후의 로그와 최종 설정을 비교하는 편이 정확합니다. 문제를 신고할 때는 운영체제, 클라이언트 이름, 재현 절차, 민감 정보를 가린 로그를 제공하세요. 구독 링크와 인증 정보는 공유 전에 삭제해야 합니다.

자주 쓰이는 개념은 용어 안내서에서 확인할 수 있습니다. GeoIP와 도메인 목록은 용도가 다르고 업데이트 경로도 클라이언트별로 관리될 수 있습니다. 관련 내용은 Clash GeoIP 업데이트를 참고하세요. 구독을 계속 사용할 수 있는지, 서버에 접속할 수 있는지는 설정 출처와 네트워크 환경에 달려 있습니다. 클라이언트를 설치한다고 사용 가능한 아웃바운드가 자동으로 만들어지는 것은 아닙니다.

Clash 가이드 및 코어 참고 자료

일반 설정부터 코어별 차이까지, 문제에 맞는 가이드를 찾아보세요.

입문 가이드

Clash 초보자가 자주 묻는 10가지: 구독 링크, 프록시 모드, 노드 선택, 시작 시 자동 실행

구독은 어디서 받는지, 규칙 모드와 전역 모드 중 무엇을 선택할지, 노드가 연결되지 않는 이유, 시작 시 자동 실행과 코어 업데이트 방법 등 초보자가 자주 묻는 10가지 질문에 답합니다.

글 읽기 →
선택 비교

Clash 원본, Clash Meta, mihomo 코어의 차이: 기능 및 설정 호환성 비교

원본, Meta, mihomo 세 코어의 계보와 관계를 살펴보고 프로토콜 지원, 규칙 유형, 설정 필드 호환성을 비교합니다. 기존 설정을 옮길 때 확인해야 할 변경 사항도 안내합니다.

글 읽기 →
플랫폼

라우터와 보조 라우터에서 mihomo 코어 실행하기: 배포 방식, 하드웨어 요구 사항, 설정 요약

OpenWrt 라우터나 보조 라우터에서 mihomo 코어를 직접 실행하는 여러 방법을 소개합니다. 하드웨어 아키텍처와 메모리 요구 사항을 비교하고, 투명 프록시와 DNS, LAN 기기 연결 방식을 설명합니다.

글 읽기 →

전체 글 보기 →

Clash 다운로드