mihomo 커널 · 전 플랫폼 클라이언트

Clash 커널 허브
전 플랫폼 클라이언트

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

mihomo 커널을 중심으로 사용 가능한 클라이언트, 설정 가이드와 규칙 매뉴얼을 정리했습니다. 먼저 기기에 맞는 그래픽 클라이언트를 선택한 뒤 구독을 가져오고, 정책 그룹과 시스템 프록시 또는 TUN 연결을 설정하세요.

영구 무료 오픈 소스 한국어 문서 규칙 분할
기기 선택

5개 플랫폼 다운로드

그래픽 클라이언트는 구독 관리, 노드 선택, 시스템 프록시와 로그 확인을 담당합니다. 운영체제마다 설치 형식, 권한 방식, 네트워크 연결 방식이 다르므로 먼저 해당 플랫폼으로 이동한 뒤 소프트웨어 목록에서 선택하세요. 다운로드 페이지에는 유지 관리 상태, 지원 아키텍처와 기본 시스템 요구 사항을 함께 표시해 커널 압축 파일을 데스크톱 앱으로 잘못 받는 일을 방지합니다.

Windows

데스크톱에서 일상적으로 사용하기 좋습니다. 그래픽 인터페이스가 있는 클라이언트로 구독, 규칙 모드와 시스템 프록시를 관리할 수 있으며, 포트 충돌이 발생하면 실행 로그를 확인하고 수신 포트를 바로 변경할 수 있습니다.

다운로드하기

macOS

Intel 또는 Apple Silicon 아키텍처에 맞는 설치 패키지를 선택하세요. 처음 실행할 때 네트워크 확장, 시스템 프록시 또는 백그라운드 서비스 권한을 허용해야 할 수 있으며, 완료 후 구독 설정을 가져오면 됩니다.

다운로드하기

Android

시스템 VPN 인터페이스를 통해 앱 트래픽을 연결하며 스마트폰과 태블릿에 적합합니다. 구독을 가져온 뒤 클라이언트에서 정책 노드를 선택하고 시스템 VPN 연결을 허용하세요.

다운로드하기

iOS

App Store에서 호환되는 클라이언트를 받으세요. 설치 후 시스템 네트워크 확장이 연결을 처리하며, 구독, 정책 그룹과 규칙 모드는 앱에서 설정합니다.

다운로드하기

Linux

데스크톱 환경에서는 그래픽 클라이언트를 사용할 수 있고, 서버·소프트 라우터·컨테이너 환경에서는 mihomo 커널을 직접 배포하는 경우가 많습니다. 선택하기 전에 프로세서 아키텍처와 패키지 형식을 확인하세요.

다운로드하기

그래픽 클라이언트와 커널 선택 방법

대부분의 사용자는 그래픽 클라이언트부터 시작하는 것이 좋습니다. 설정 업데이트, 정책 그룹 전환, 시스템 프록시, 연결 로그와 커널 실행을 하나의 화면에서 관리해 일상적인 유지 관리가 간편합니다. mihomo 커널 패키지는 주로 서버, 라우터, 컨테이너와 자동화 환경을 대상으로 하며 설정 파일, 실행 인자와 데몬을 직접 준비해야 합니다. 둘은 서로 대체하는 다른 프로토콜이 아닙니다. 그래픽 클라이언트는 보통 인터페이스와 시스템 통합을 담당하고, mihomo는 설정을 해석해 실제 트래픽을 처리합니다.

전체 클라이언트 보기 →
핵심 작업 흐름

규칙, DNS 및 멀티플랫폼 연결

Clash 클라이언트의 가치는 특정 노드에 연결하는 데만 있지 않습니다. 실제 사용 경험을 좌우하는 것은 규칙 매칭, 도메인 해석, 그리고 시스템 트래픽이 커널로 들어가는 방식입니다. 아래 세 항목은 설정 파일에서 결과에 가장 큰 영향을 주는 부분이며, 탭으로 전환해 확인할 수 있습니다.

01 / RULES

목적지에 따라 트래픽 출구 결정

규칙 모드는 설정 파일의 순서에 따라 연결 대상을 하나씩 판단합니다. 도메인은 DOMAIN, DOMAIN-SUFFIX와 규칙 세트로 매칭할 수 있고, IP 주소는 IP-CIDR, GEOIP 등의 규칙으로 처리할 수 있습니다. 마지막에는 MATCH가 아직 일치하지 않은 트래픽을 받습니다. 매칭 결과가 특정 노드로 바로 연결되는 것은 아니며, 먼저 정책 그룹에 들어간 뒤 정책 그룹이 직접 연결, 거부 또는 프록시 회선을 결정합니다.

실제 설정에서는 범위가 더 구체적인 규칙을 포괄적인 규칙보다 앞에 배치하고, 사용자 지정 항목이 앞의 일반 규칙에 가로채이지 않는지 확인해야 합니다. 단일 전역 스위치만 제공하는 도구와 달리 Clash의 규칙 체인은 업무 사이트, 로컬 네트워크, 업데이트 서비스와 프록시가 필요한 도메인을 각각 처리할 수 있습니다. 이를 통해 트래픽 경계를 명확히 유지하면서 로그에서 특정 연결이 최종적으로 어떤 규칙에 일치했는지도 추적할 수 있습니다.

규칙과 정책 그룹 고급 설정 보기 →
오픈 소스 생태계

커널, 클라이언트와 문서의 역할

Clash 생태계는 커널, 그래픽 클라이언트, 설정 형식, 규칙 세트와 커뮤니티 문서로 구성됩니다. 각 부분의 역할을 이해하는 것이 특정 소프트웨어 이름만 기억하는 것보다 장기적인 설정 유지 관리에 도움이 됩니다.

Clash 설정 체계에서 mihomo까지

Clash는 규칙, 정책 그룹, 프록시 노드와 DNS를 조합해 사용하는 설정 방식을 확립했습니다. mihomo는 이 체계를 기반으로 네트워크 처리 기능을 지속적으로 구현하며 여러 활성 클라이언트가 채택하는 핵심으로 자리 잡았습니다. 설정 파일의 proxies, proxy-groups, rules, dns는 각각 다른 역할을 담당합니다. 노드는 연결 매개변수를 설명하고, 정책 그룹은 전환 가능한 출구를 제공하며, 규칙은 연결이 들어갈 정책 그룹을 결정하고, DNS는 도메인과 대상 간의 연결을 유지합니다.

따라서 클라이언트 이름이 바뀌었다고 설정 로직 전체가 달라지는 것은 아닙니다. 마이그레이션할 때는 커널이 지원하는 필드, 클라이언트가 시스템 기능을 감싸는 방식, 기존 규칙 세트가 계속 정상적으로 업데이트되는지를 확인하는 것이 더 중요합니다. 사이트 문서는 현재 널리 사용되는 mihomo 설정 동작을 중심으로 하면서 Clash의 기본 개념도 함께 설명합니다.

그래픽 클라이언트는 시스템 통합을 담당합니다

그래픽 클라이언트에는 일반적으로 설정 구독 업데이트, 정책 그룹 전환, 연결 기록, 로그 확인, 시스템 프록시 제어와 커널 프로세스 관리 기능이 포함됩니다. 별도의 규칙 문법을 새로 만드는 것이 아니라 Windows, macOS, Android, iOS 또는 Linux의 네트워크 메커니즘에 하위 기능을 연결합니다. 클라이언트마다 다른 점은 주로 화면 구성, 업데이트 주기, 시스템 서비스, 설정 오버라이드와 멀티플랫폼 지원 범위에 있습니다.

다운로드 페이지에서는 현재 유지 관리되는 클라이언트와 보관 프로젝트를 구분해 표시하고 플랫폼별 사용 가능한 경로를 제공합니다. 선택할 때는 운영체제 지원 여부, 프로세서 아키텍처와 필요한 기능을 우선 고려해야 하며, 인터페이스 스크린샷만 보고 판단해서는 안 됩니다. 일반 데스크톱 사용자는 보통 그래픽 클라이언트가 필요하고, 명령줄·서비스 관리·라우팅 설정에 익숙한 사용자라야 커널을 직접 배포하는 편이 적합합니다.

업데이트는 세 가지로 나누어 확인하세요

클라이언트 업데이트, 커널 업데이트와 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 시스템 호환성에 변화를 줄 수 있고, 커널 업데이트는 프로토콜 구현, 규칙 기능과 DNS·TUN 동작에 영향을 줍니다. 구독 업데이트는 노드, 정책 그룹 또는 원격 설정 내용을 새로 고칩니다. 특정 노드가 작동하지 않을 때는 클라이언트를 다시 설치하기보다 먼저 구독을 업데이트하고 정책 그룹을 확인하는 편이 보통 더 빠릅니다. 로그에 커널 실행 실패, 지원되지 않는 설정 필드 또는 시스템 통합 이상이 표시될 때만 클라이언트와 커널 상태를 추가로 점검하세요.

사이트 콘텐츠는 이 경계에 따라 구성되어 있습니다. 다운로드 페이지에서는 소프트웨어를 선택하고, 사용 가이드에서는 첫 설치와 연결을 다루며, 고급 설정에서는 규칙, DNS, TUN과 오버라이드를 설명합니다. 자주 묻는 질문 페이지에서는 포트 충돌, 노드 시간 초과, 시스템 프록시 미적용과 같은 현상을 집중적으로 다룹니다.

오픈 소스로 구현을 직접 확인할 수 있습니다

mihomo의 소스 코드와 개발 기록은 공개되어 있어 설정 필드, 동작 변화와 문제 수정 내용을 확인하는 데 활용할 수 있습니다. 출처가 불분명한 설정 제안을 접했을 때는 다른 사람의 설명보다 공개 문서, 코드 설명과 실제 로그를 확인하는 편이 신뢰할 수 있습니다. 릴리스 노트를 읽을 때는 커널 기능과 클라이언트 기능도 구분해야 합니다. 커널에서 이미 구현된 기능이 모든 클라이언트의 해당 화면에 제공된다는 뜻은 아니며, 클라이언트가 추가한 스위치도 기존 설정 항목을 시각화한 것에 불과할 수 있습니다.

로컬에서 코드를 확인하려면 아래 Git 명령으로 공개 저장소를 받을 수 있습니다. 이 명령은 코드 열람과 문제 파악에만 사용되며, 클라이언트만 설치하려는 사용자는 실행할 필요가 없습니다.

자주 묻는 질문

설치 전 확인할 네 가지

처음 사용할 때 발생하는 많은 문제는 노드 자체보다 다운로드 플랫폼, 구독 형식, 프록시 모드 또는 시스템 권한이 서로 맞지 않아서 생깁니다. 아래 순서에 따라 확인하고, 자세한 단계는 사용 가이드와 자주 묻는 질문 페이지에서 이어서 확인하세요.

Clash 클라이언트와 mihomo 커널은 어떻게 다른가요?

mihomo는 설정, 규칙, DNS와 연결을 처리하는 커널이고, 그래픽 클라이언트는 설치 화면, 설정 관리, 시스템 프록시, 네트워크 권한과 커널 프로세스를 담당합니다. 일반 사용자는 운영체제에 맞는 그래픽 클라이언트를 다운로드하고, 서버나 라우터에 배포할 때는 보통 커널 패키지를 직접 사용합니다.

구독을 가져온 뒤 노드가 보이지 않으면 무엇부터 확인해야 하나요?

먼저 웹페이지 주소나 단일 노드 설명이 아닌 완전한 구독 주소를 가져왔는지 확인하세요. 그런 다음 설정을 수동으로 업데이트하고 업데이트 로그에 네트워크 오류, 형식 오류 또는 인증 상태 이상이 나타나는지 확인합니다. 설정이 업데이트되었는데 정책 그룹이 비어 있다면 현재 활성화된 설정 파일이 올바른지도 점검하세요.

규칙 모드, 전역 모드와 직접 연결 모드는 어떻게 선택하나요?

일상적인 사용에는 보통 규칙 모드를 선택하며, 규칙이 각 연결의 경로를 결정합니다. 전역 모드는 대부분의 트래픽을 하나의 프록시 정책으로 보내 임시 테스트에 적합하고, 직접 연결 모드는 문제가 프록시 경로와 관련 있는지 판단할 때 주로 사용합니다. 모드를 바꾼 뒤에는 정책 그룹에서 사용 가능한 노드가 선택되어 있는지도 확인해야 합니다.

클라이언트는 실행 중인데 브라우저에서 여전히 인터넷에 연결되지 않으면 어떻게 하나요?

시스템 프록시가 활성화되어 있는지, 수신 포트에 충돌이 없는지, 정책 그룹에 정상 노드가 선택되어 있는지, DNS 요청이 클라이언트로 들어오는지를 순서대로 확인하세요. 일부 프로그램만 시스템 프록시를 사용하지 않는다면 규칙을 대량으로 수정하기보다 TUN 모드가 필요한지 먼저 검토하세요. 전체 점검 절차는 자주 묻는 질문 페이지에서 확인할 수 있습니다.

자주 묻는 질문 전체 보기 → 구독 가져오기부터 시작 →
설정 기록

최근 Clash 가이드

글은 실제 사용 중 발생하는 문제를 기준으로 나누었습니다. 각 글은 하나의 명확한 주제만 다루며, 확인 순서와 설정 위치, 검증 방법을 제시해 같은 현상이 발생했을 때 바로 참고할 수 있습니다.

문제 해결

Clash 포트가 사용 중일 때: 충돌 프로세스 확인과 수신 포트 변경 전체 과정

시작 로그에 bind: address already in use가 나타난다면 일반적으로 다른 프로세스가 해당 수신 포트를 사용 중이라는 뜻입니다. Windows와 macOS, Linux에서 충돌 프로세스를 찾는 명령과 mixed-port 등의 설정을 변경한 뒤 확인하는 방법을 설명합니다.

전체 글 읽기
고급 설정

Clash 사용자 지정 규칙 작성법: DOMAIN 계열 문법과 매칭 우선순위

도메인 정확히 일치, 도메인 접미사, IP 대역과 GEOIP를 차례로 살펴보며 규칙 매개변수, 위에서 아래로 적용되는 매칭 순서, 사용자 지정 규칙을 설정의 어느 위치에 배치해야 하는지 설명합니다.

전체 글 읽기
입문 가이드

Clash 첫 연결 가이드: 노드 선택, 지연 시간 측정, 프록시 적용 확인

구독을 가져온 뒤 정책 그룹에서 노드를 선택하고, 시간 초과 결과를 확인하며, 올바른 시스템 연결 방식을 활성화하세요. 대상 주소와 로그를 통해 트래픽이 커널로 들어갔는지도 확인할 수 있습니다.

전체 글 읽기
전체 글 보기 →