오픈 소스 클라이언트 · mihomo 코어

Clash 클라이언트 다운로드전 플랫폼 라우팅 규칙

Clash 다운로드 사용 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 mihomo 코어로 프로토콜 지원을 확인하세요. 라우팅 규칙으로 연결 경로를 관리하고, 한국어 설정 가이드를 참고해 처음 설정을 마칠 수 있습니다.

규칙 설정오픈 소스 코어한국어 문서
PLATFORMS
Windows Android iOS macOS Linux
CORE / 규칙 엔진

mihomo

Clash.Meta의 개발을 이어받은 코어 프로젝트로, 규칙과 프로토콜, DNS를 처리합니다.

LICENSE / 코어 라이선스

GPL-3.0

mihomo 소스 코드의 라이선스입니다. GUI 클라이언트 라이선스는 각 프로젝트에서 확인하세요.

PROTOCOLS
SSVMessTrojanVLESSHysteria2TUIC

Clash 규칙과 코어 기능
연결 진입부터 아웃바운드 정책까지

클라이언트는 조작 화면을, 코어는 연결 처리를 담당합니다. 먼저 둘의 역할을 구분한 뒤 설정을 옮길 수 있는지, 프로토콜을 사용할 수 있는지, 트래픽이 실제로 규칙 엔진을 통과하는지 확인하세요.

라우팅 규칙

규칙은 위에서 아래로 순서대로 매칭되며, 일치하는 규칙이 있으면 해당 정책을 적용하고 이후 일반 규칙은 확인하지 않습니다. 도메인 접미사는 사이트별 분류에, IP 대역은 로컬 네트워크 대상 처리에 적합합니다. 규칙 세트는 많은 조건을 한곳에서 관리할 때 유용합니다. 설정할 때는 구체적인 예외를 먼저 작성하고, 범위가 넓은 규칙을 뒤에 둔 다음 마지막에 MATCH 기본 규칙을 추가하세요. 연결 결과가 예상과 다르면 노드를 바꾸기 전에 실제로 일치한 규칙과 아웃바운드 정책을 확인하세요. 규칙 적용 순서는 노드만 바꿔서는 해결되지 않습니다.

mihomo 코어

mihomo는 Clash.Meta의 개발 방향을 이어받아 Clash 설정 체계의 주요 개념을 유지하면서 프로토콜, DNS, 규칙 기능을 확장합니다. 코어 이름과 클라이언트 이름은 다르며, 같은 GUI에서 코어를 선택할 수도 있습니다. 설정을 옮기기 전에 대상 클라이언트에 탑재된 코어와 지원하는 항목을 확인하세요. 설정 호환성은 항목별로 점검해야 합니다. 특히 새 프로토콜 매개변수와 실험적 옵션은 파일 확장자만으로 호환 여부를 판단할 수 없습니다.

다양한 프로토콜 지원

SS, VMess, Trojan, VLESS와 QUIC 기반 프로토콜은 전송 방식, 인증 항목, 실행 조건이 서로 다릅니다. 노드 유형은 서버 설정과 일치해야 하며, 프로토콜 이름만 바꾼다고 변환되지는 않습니다. 먼저 네트워크에서 필요한 전송 방식을 허용하는지, 서버가 올바르게 설정됐는지 확인한 뒤 연결 상태를 비교하세요. UDP 지원, 인증서 검증, 기기 성능도 결과에 영향을 줍니다. 한 번의 속도 측정만으로 프로토콜의 우열을 정하기는 어렵습니다.

구독 가져오기

구독 링크로 설정이나 노드 정보를 가져올 수 있지만, 가져온 뒤에는 형식과 프록시 그룹, 규칙이 온전한지 확인해야 합니다. 전체 설정에는 보통 규칙과 DNS 설정이 포함되지만 노드만 있는 구독은 기본 설정으로 바로 사용할 수 없을 수 있습니다. 구독을 업데이트하기 전에 로컬 오버라이드가 별도로 저장되는지 확인해 수동 수정 내용이 원격 설정으로 덮어쓰이지 않도록 하세요. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 로그, 온라인 변환 도구에 올리지 마세요.

TUN 모드

TUN은 가상 네트워크 인터페이스를 통해 라우팅 조건에 맞는 트래픽을 코어로 전달하므로 시스템 프록시 설정을 따르지 않는 앱에 유용합니다. 활성화하기 전에 권한, 라우팅, DNS 설정을 확인하세요. 다른 VPN이나 가상 네트워크 인터페이스와 함께 사용하면 라우팅 충돌이 생길 수 있습니다. TUN을 켠다고 모든 연결이 프록시를 통과하는 것은 아니며, 최종 경로는 모드와 규칙에 따라 결정됩니다. 시스템 프록시만으로 필요한 앱을 처리할 수 있다면 간단한 설정을 유지하고, 앱별 트래픽을 더 폭넓게 처리해야 할 때 TUN을 활성화하세요.

프록시 그룹 정책

프록시 그룹은 여러 아웃바운드 경로를 하나의 고정된 이름으로 묶어 규칙에서 그룹 이름만 참조하도록 합니다. 수동 선택은 특정 경로를 고정할 때 적합합니다. 자동 지연 테스트 그룹은 측정 결과에 따라 노드를 고르고, 장애 조치 그룹은 연결 가능한 경로를 우선 유지합니다. 테스트 주소와 간격, 허용 오차에 따라 전환 방식이 달라집니다. 지연 시간이 짧다고 다운로드 속도가 빠른 것은 아닙니다. 설정할 때 정책 그룹 이름과 규칙의 참조 이름이 같은지, 그룹에 등록된 구성원이 실제로 존재하는지 확인하세요. 노드를 업데이트한 뒤 잘못된 참조가 남을 수 있습니다.

크로스 플랫폼 클라이언트

GUI 클라이언트는 구독, 노드, 로그를 조작하기 쉬운 화면으로 정리하지만 플랫폼마다 네트워크 권한과 백그라운드 동작 방식이 다릅니다. 설정을 옮길 때 규칙 구성 방식은 재사용할 수 있어도 시스템 프록시, 서비스 설치, 시작 시 자동 실행 옵션이 같다고 가정해서는 안 됩니다. 데스크톱에서는 프로세서 아키텍처를, 모바일에서는 VPN 권한과 백그라운드 제한을 먼저 확인하세요. 비슷한 화면만 보고 고르기보다 기기에 맞고 지속적으로 관리되는 클라이언트를 선택하는 편이 문제 해결에 유리합니다.

Clash 설정 항목 예제규칙, 프록시 그룹, DNS

config.yaml · rules
mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,Proxy
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
mode: rule
규칙 모드를 활성화합니다. 전역 또는 직접 연결 모드에서는 일반 규칙 목록에 따라 연결 경로가 결정되지 않습니다.
DOMAIN-SUFFIX
지정한 도메인과 하위 도메인에 매칭됩니다. 예제의 Proxy는 설정에서 정의해야 하는 정책 그룹 이름입니다.
IP-CIDR / no-resolve
로컬 네트워크 IP 대역에 매칭됩니다. no-resolve는 이 IP 규칙을 위해 도메인 조회를 별도로 시작하지 않는다는 뜻이지, 모든 DNS를 끈다는 의미가 아닙니다.
GEOIP / MATCH
지리적 IP 정보를 먼저 적용한 뒤 나머지 연결을 처리합니다. 예제는 순서를 설명하기 위한 것이며, 모든 상황에 그대로 적용할 수 있는 완성된 설정은 아닙니다.

전 플랫폼 Clash 다운로드
운영체제와 프로세서 아키텍처에 맞춰 선택

데스크톱과 모바일은 설치 방법이 다릅니다. 다운로드 페이지에서 클라이언트와 아키텍처별 설치 파일, 시스템 요구 사항을 확인할 수 있습니다. 먼저 기기 플랫폼을 선택한 뒤 해당 목록으로 이동하세요. Linux를 제외한 플랫폼에서는 Clash Plus를 우선 살펴보고, 사용 환경이나 필요한 기능에 따라 다른 클라이언트도 비교해 보세요.

Windows

데스크톱 브라우저와 개발 도구, 일반 앱에서 규칙 기반 프록시를 사용하려는 경우에 적합합니다. 먼저 Clash Plus를 확인하고 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. 설치 전 운영체제와 프로세서 요구 사항을 확인하세요. TUN이 필요하다면 클라이언트 안내에 따라 서비스를 설치하고 권한을 부여해야 합니다. Clash for Windows 설정을 옮길 때는 구독과 규칙을 따로 백업하고 기존 프로그램 폴더 전체를 그대로 복사하지 마세요. 시스템 프록시와 시작 시 자동 실행은 별개의 설정이므로 각각 확인해야 합니다.

다운로드 페이지로 이동 →

macOS

Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash를 주요 비교 대상으로 삼을 수 있습니다. 처음 실행할 때 시스템 권한 안내를 확인하세요. 시스템 프록시, 로그인 시 실행, 네트워크 확장 권한은 각각 별개의 설정입니다. 명령줄 도구를 사용한다면 해당 도구가 시스템 프록시를 읽는지도 확인해야 합니다. 브라우저에서만 연결된다고 터미널 트래픽도 클라이언트를 통과하는 것은 아닙니다. 보관된 클라이언트는 이전 설정을 확인할 때 참고하는 용도로 쓰고 기본 설치 대상으로 삼지 마세요.

다운로드 페이지로 이동 →

Android

Clash Plus를 먼저 확인하고 Clash Meta for Android, FlClash, Surfboard와 비교해 볼 수 있습니다. 설치 파일은 기기 아키텍처에 맞아야 하며, 구독을 가져온 뒤에는 시스템 VPN 권한도 허용해야 합니다. 백그라운드 절전 정책이 연결 유지에 영향을 줄 수 있지만 처음부터 모든 배터리 제한을 해제할 필요는 없습니다. 화면을 잠근 뒤 연결 상태를 확인하고 필요한 항목만 조정하세요. 코어에 따라 구독 형식이 다를 수 있으므로 특히 노드만 포함된 링크는 클라이언트가 지원하는 가져오기 방식을 확인해야 합니다.

다운로드 페이지로 이동 →

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있으며, 제품 공식 사이트는 clashplus.io입니다. 설치한 뒤 클라이언트 안내에 따라 구독을 가져오고 VPN 구성을 허용하세요. 모바일 운영체제의 네트워크 처리 방식은 데스크톱 시스템 프록시와 다르므로 데스크톱의 서비스 설치 절차를 그대로 적용하면 안 됩니다. Wi-Fi와 모바일 데이터를 전환한 뒤 연결 상태가 달라지면 먼저 현재 네트워크 조건과 노드에 접근할 수 있는지 확인하고, 그다음 프로토콜이나 DNS 설정을 조정할지 판단하세요.

다운로드 페이지로 이동 →

Linux

그래픽 데스크톱 클라이언트는 Clash Verge Rev와 FlClash를 우선 비교하고, 배포판에 맞는 패키지를 선택하세요. 서버나 라우터에서 실행하거나 서비스를 직접 관리해야 한다면 mihomo 코어 다운로드 페이지를 확인할 수 있습니다. 코어 프로그램만으로는 GUI 클라이언트가 완성되지 않으며 실행 디렉터리, 설정 경로, 권한, 서비스 관리도 직접 처리해야 합니다. TUN을 활성화하기 전에 기존 라우팅과 DNS 서비스를 확인하세요. 원격 기기에서는 관리 연결을 복구할 수단을 남겨 두어 잘못된 라우팅으로 연결이 끊기는 일을 방지해야 합니다.

다운로드 페이지로 이동 →

Clash 오픈 소스 생태계 안내
프로젝트 간 관계와 유지 관리 범위

다운로드 페이지, GUI 클라이언트, 프록시 코어, 구독 서비스는 각각 역할이 다릅니다. 모든 제품을 하나의 소프트웨어처럼 취급하기보다 역할과 경계를 이해해야 알맞은 제품을 고르고 문제를 해결하기 쉽습니다.

원본 Clash, Meta, mihomo

Clash는 규칙, 프록시 그룹, YAML 설정을 중심으로 사용하는 방식을 정립했습니다. Clash.Meta는 이 체계를 바탕으로 기능을 확장했고, 이후 mihomo라는 이름으로 개발을 이어 갔습니다. 역사와 설정 개념은 서로 이어져 있지만, 아무 프로그램이나 서로 바꿔 쓸 수 있는 것은 아닙니다. 원본 설정의 기본 규칙은 대체로 이해하고 옮기기 쉽지만, 새 프로토콜이나 DNS 확장, TUN 항목은 대상 코어의 문서를 확인해야 합니다. 이전 가이드의 모든 옵션을 현재 클라이언트에 그대로 적용하지 마세요.

가이드가 현재 환경에도 맞는지 확인하려면 먼저 GUI를 다루는 글인지 코어를 다루는 글인지 살펴보고, 설정 항목과 실행 환경이 지금 사용하는 버전과 일치하는지 확인하세요. 클라이언트의 스위치가 설정을 생성하거나 덮어쓸 수 있으므로 화면에 표시된 내용과 설정 파일을 함께 확인해야 합니다. 문제가 생기면 클라이언트 화면만 설명하기보다 코어 이름과 오류 로그, 재현 절차를 기록하는 편이 원인을 찾는 데 도움이 됩니다.

소스 코드 라이선스와 클라이언트의 차이

mihomo 소스 코드는 GPL-3.0 라이선스를 따릅니다. 개발 내역과 이슈 논의, 설정 구현은 프로젝트 저장소에서 확인할 수 있습니다. 오픈 소스 라이선스는 소스 코드의 사용, 수정, 배포 조건을 정하며, 모든 타사 GUI 클라이언트가 같은 라이선스를 사용한다는 뜻은 아닙니다. 각 클라이언트 프로젝트가 화면과 패키징 방식, 플랫폼 서비스를 관리하며, 특정 기능의 제공 여부는 해당 제품 문서를 확인해야 합니다. 이 사이트는 다운로드 경로와 기술 정보를 정리하며, 사이트 이름이 모든 상위 프로젝트와의 제휴나 소속을 뜻하지는 않습니다.

클라이언트는 로컬 규칙과 연결을 처리하지만, 설치만으로 사용할 수 있는 구독이 자동 제공되지는 않습니다. 구독은 사용자가 직접 설정해야 하며 계정 정보는 해당 서비스 제공자가 관리합니다. 문제를 확인할 때 민감한 항목을 제거한 설정 구조와 오류 메시지를 공유할 수 있지만, 구독 전체 주소와 인증 정보, 문제와 무관한 개인 네트워크 데이터는 반드시 가리세요.

업데이트 전후 설정 점검

클라이언트 업데이트와 구독 업데이트는 별개의 과정입니다. 전자는 GUI나 코어, 시스템 연동을 변경하고 후자는 원격 설정과 노드 정보를 변경합니다. 클라이언트를 업데이트하기 전에는 설정과 로컬 오버라이드를 저장하세요. 구독을 업데이트한 뒤에는 프록시 그룹 구성원, 규칙 출처, 실제 아웃바운드 경로를 확인해야 합니다. 설정이 더 이상 적용되지 않는다면 코어 로그에서 항목 변경, 리소스 불러오기 실패, 참조 대상 누락을 먼저 확인한 뒤 이전 버전으로 되돌리거나 설정을 수정하세요. 업데이트 후 여러 항목을 한꺼번에 바꾸면 문제의 원인을 찾기 어렵습니다.

오래 사용할 계획이라면 설정을 변경한 목적과 관련 항목만 간단히 기록하고 인증 정보는 저장하지 마세요. 기기를 바꿀 때는 시스템 프록시와 네트워크 권한, 시작 방식을 다시 확인해야 합니다. 이런 항목은 대개 기기별 설정이라 구독만으로 자동 이전되지 않습니다. 보관된 클라이언트의 오래된 가이드는 개념을 참고하되, 해당 프로그램을 기본 설치 대상으로 삼지 마세요.

소스 코드 확인과 문제 재현

특정 설정 항목의 동작을 확인하려면 MetaCubeX/mihomo 프로젝트 저장소에서 문서와 커밋 기록, 이슈 논의를 살펴보세요. 기존 보고를 읽기 전에 실행 환경을 확인하고, 재현할 때는 설정 범위를 단계적으로 줄이세요. 필요한 인바운드와 사용 가능한 아웃바운드 하나, 최소한의 규칙만 남긴 뒤 DNS, 규칙 세트, TUN을 차례로 추가하면 구독 내용과 클라이언트가 생성한 설정, 코어 동작 중 무엇이 영향을 주는지 구분할 수 있습니다.

아래 명령은 소스 코드를 가져오는 용도이며 GUI 클라이언트를 설치하거나 시스템 프록시를 만들지는 않습니다. 일반 사용자는 다운로드 페이지에서 클라이언트를 선택하면 됩니다. 개발자는 빌드하거나 수정하기 전에 저장소의 빌드 요구 사항과 라이선스 파일을 확인하세요. 이슈를 제보할 때는 재현 가능한 절차를 작성하고, 개인 구독 정보가 포함된 설정 파일 전체를 공개하지 마세요.

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

Clash 기술 노트
TUN, 코어, 라우팅 실전 가이드

문제별로 동작 원리와 설정 선택 기준을 살펴보세요. 처음 사용한다면 먼저 기본 연결을 확인한 뒤 현재 문제에 맞는 주제를 읽으세요. 고급 옵션을 기본 필수 설정으로 오해하지 않도록 주의하세요.

전체 글 보기 →