MIHOMO CORE · RULE ROUTING

Clash Meta 공식 사이트
전 플랫폼 클라이언트 및 규칙 분할

공식 Clash 다운로드 사용 문서 보기

mihomo 코어를 중심으로 Windows, macOS, Android, iOS 및 Linux 클라이언트 링크를 정리하고, 구독 가져오기, 규칙 분할과 네트워크 진단을 위한 실제 설정 경로를 기록합니다.

  • 영구 무료
  • 오픈 소스
  • 중국어 문서

TEST BENCH / ROUTING

mihomo 코어 기능 기록

아래 항목은 로컬 포트로 들어온 연결이 출구를 결정하기까지의 순서에 따라 정리했습니다. 실험 항목을 전환하면 규칙, DNS, TUN, 구독 설정이 각각 어떤 문제를 처리하는지와 설정 중 확인할 결과를 살펴볼 수 있습니다.

RULE-SET / GEOIP / MATCH

연결 출구는 규칙 순서로 결정됩니다

규칙 모드는 위에서 아래로 도메인, IP, 프로세스와 독립 규칙 집합을 확인하며, 처음 일치한 결과가 연결을 직접 연결, 프록시 또는 거부 정책으로 보냅니다. 사용할 때는 범위가 좁고 의도가 분명한 규칙을 먼저 배치하고, 일반 규칙과 MATCH는 마지막에 두세요. 전역 스위치만 제공하는 클라이언트와 달리 mihomo는 로컬 네트워크, 업무 시스템, 미디어 서비스와 일반 웹페이지를 나누어 처리할 수 있습니다. 문제를 확인할 때도 연결 기록으로 실제로 어떤 규칙이 적용됐는지 확인할 수 있어, 페이지가 열리는지만으로 판단할 필요가 없습니다.

PLATFORM ACCESS

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

다운로드 페이지에는 플랫폼별 그래픽 클라이언트, 시스템 요구 사항과 설치 링크가 정리되어 있습니다. 설치 파일을 직접 배포하지 않으며, 플랫폼 링크를 통해 해당 분류로 이동해 같은 운영체제의 여러 클라이언트를 비교할 수 있습니다.

P-01 / DESKTOP

Windows

트레이 상주, 시스템 프록시 전환과 TUN 연결이 필요한 데스크톱 환경에 적합합니다. 다운로드 페이지에는 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu와 보관된 클라이언트가 함께 정리되어 있어 유지보수 상태와 UI 사용 습관에 따라 선택할 수 있습니다. 설치 후 먼저 구독을 가져오고 시스템 프록시 스위치와 수신 포트를 확인하세요.

다운로드 페이지로 이동

P-02 / DESKTOP

macOS

Apple Silicon 및 Intel Mac에 적합합니다. 설치 전에 프로세서 아키텍처를 확인하고, 처음 실행할 때 시스템 안내에 따라 네트워크 확장 또는 보조 서비스 권한을 허용하세요. 브라우저 트래픽만 필요하다면 먼저 시스템 프록시를 사용하고, 터미널이나 프록시 설정을 읽지 않는 앱은 필요할 때 TUN을 활성화하세요.

다운로드 페이지로 이동

P-03 / MOBILE

Android

Android 클라이언트는 시스템 VPN 인터페이스를 통해 앱 연결을 처리하므로, 설정을 가져온 뒤 연결 권한을 명확히 허용해야 합니다. 기기별 백그라운드 제한은 장시간 실행에 영향을 줄 수 있습니다. 화면을 잠근 뒤 연결이 끊기면 노드나 규칙을 먼저 바꾸기보다 배터리 정책, 백그라운드 활동 권한과 시스템 VPN 상태를 확인하세요.

다운로드 페이지로 이동

P-04 / MOBILE

iOS

iPhone과 iPad는 시스템 네트워크 확장으로 프록시 연결을 구성합니다. 설정은 구독 가져오기, 정책 그룹 선택과 시스템 VPN 권한 허용에 집중되며, 연결 후에는 클라이언트 기록에서 도메인 매칭 결과를 확인할 수 있습니다. 다운로드 페이지에는 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io가 제공되어 제품 정보를 확인하기 쉽습니다.

다운로드 페이지로 이동

P-05 / DESKTOP

Linux

데스크톱 사용자는 그래픽 인터페이스가 있는 클라이언트를 선택할 수 있고, 서버·소프트 라우터·컨테이너 환경에는 mihomo 코어를 직접 실행하는 방식이 더 적합합니다. 설정 전에 서비스 사용자, 설정 디렉터리와 시작 방식을 정하고 로그는 시스템 서비스 관리에 맡기세요. 그래픽 클라이언트와 코어 패키지는 용도가 다르므로 일반적인 데스크톱 환경에서는 전자를 우선 선택하는 편이 좋습니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

THREE-STAGE SETUP

구독 가져오기부터 연결 확인까지

처음부터 모든 고급 옵션을 동시에 수정할 필요는 없습니다. 먼저 반복해서 확인할 수 있는 기본 경로를 만드세요. 구독이 클라이언트에서 정상적으로 해석되는지 확인하고, 규칙 모드와 정책 그룹을 선택한 다음 연결 기록으로 적용 결과를 검증합니다. 기본 경로가 안정된 뒤 TUN, DNS 또는 사용자 지정 규칙을 조정하세요.

이 순서를 따르면 문제를 한 단계로 좁힐 수 있습니다. 가져오기 단계에서 이미 오류가 발생했다면 시스템 프록시를 확인할 필요가 없습니다. 설정은 정상적으로 로드됐지만 앱에 트래픽이 없다면 권한, 포트와 연결 방식을 점검하세요. 전체 튜토리얼에서 각 화면의 진입 경로와 자주 나타나는 상태를 확인할 수 있습니다.

전체 튜토리얼 보기 →
  1. 01

    구독 또는 설정 파일 가져오기

    클라이언트의 설정 또는 구독 페이지에서 서비스 제공자가 전달한 링크를 추가하고 업데이트를 실행한 뒤 정책 그룹, 노드와 규칙이 표시되는지 확인하세요. 빈 설정만 보이거나 해석 실패가 표시되면 시스템 프록시를 켜기 전에 링크가 클라이언트가 지원하는 콘텐츠를 반환하는지 먼저 확인하세요.

  2. 02

    규칙 모드와 정책 선택

    일상적인 사용에는 보통 규칙 모드를 선택한 다음 주요 프록시 그룹에서 사용할 정책을 지정합니다. 전역 모드는 대부분의 연결을 현재 정책으로 통일하고, 직접 연결 모드는 프록시를 우회하므로 둘 다 임시 테스트에 더 적합합니다. 전환한 뒤에는 사용 중인 연결을 새로 만들어야 합니다.

  3. 03

    연결을 활성화하고 기록 확인

    먼저 시스템 프록시를 활성화하고 테스트 페이지를 연 다음, 클라이언트 연결 목록에 새 기록이 나타나는지와 규칙 열의 결과가 예상과 일치하는지 확인하세요. 대상 프로그램이 시스템 프록시를 읽지 않는다면 그때 TUN을 검토합니다. 확인할 때는 웹페이지 접속뿐 아니라 로컬 네트워크 기기와 자주 사용하는 앱도 함께 점검해 단일 페이지로 결론 내리지 않도록 하세요.

OPEN SOURCE RECORD

mihomo 오픈 소스 생태계와 유지보수 범위

프로젝트 관계.Clash Meta라는 이름은 일반적으로 Meta 브랜치에서 형성된 기능 생태계를 가리키며, 현재 핵심 프로젝트는 mihomo라는 이름으로 계속 개발되고 있습니다. 그래픽 클라이언트는 설정 관리, 시스템 서비스, 트레이 상호작용과 로그 표시를 담당하고, mihomo 코어는 프로토콜 처리, 규칙 매칭, DNS, 인바운드 및 아웃바운드 연결을 담당합니다. 이 관계를 이해하면 문제가 UI, 시스템 권한, 설정 파일 또는 코어 실행 단계 중 어디에서 발생했는지 판단하기 쉽습니다.

공개 협업.mihomo의 소스 코드, 커밋 기록, 이슈 논의와 릴리스 노트는 모두 공개 저장소에서 관리됩니다. 사용자는 설정 필드의 구현 변화를 확인할 수 있고, 클라이언트 유지관리자는 같은 코어를 기반으로 여러 플랫폼의 프런트엔드를 만들 수 있습니다. 이 사이트는 이러한 공개 자료와 실제 설정 동작을 바탕으로 한국어 설명을 정리하며, 특정 UI 명칭을 코어 기능으로 단정하거나 서드파티 클라이언트의 조작 차이를 하나의 결론으로 섞어 설명하지 않습니다.

업데이트 방식.코어, 그래픽 클라이언트, 구독 콘텐츠와 규칙 집합은 서로 다른 네 가지 업데이트 경로입니다. 클라이언트 업데이트는 UI와 시스템 서비스를 바꿀 수 있고, 코어 업데이트는 설정 필드나 네트워크 동작을 조정할 수 있습니다. 구독 업데이트는 주로 노드와 정책에 영향을 주며, 규칙 집합 업데이트는 연결 매칭 범위를 바꿉니다. 문제를 확인할 때는 최근 변경된 계층을 기록하고 먼저 단일 변수를 되돌리세요. 모든 항목을 동시에 업데이트하면 원인을 특정하기 어렵습니다.

문서 원칙.설정 문서는 관찰 가능한 결과를 우선 설명합니다. 파일이 로드되는지, 포트가 수신 대기 중인지, 시스템 프록시가 올바른 주소를 가리키는지, 연결에 어떤 규칙이 적용됐는지, DNS 요청을 어느 리졸버가 처리하는지를 확인합니다. 운영체제마다 권한과 네트워크 스택이 다르므로 같은 스위치라도 플랫폼별 사전 조건이 다를 수 있습니다. 플랫폼 차이가 있는 경우 모든 환경을 하나의 스크린샷으로 설명하지 않고 단계별로 나누어 안내합니다.

SOURCE COMMAND

mihomo 소스 코드 보기

아래 명령은 공개 저장소를 복제하며, 설정 구현을 읽거나 이슈를 추적하거나 개발에 참여하려는 사용자에게 적합합니다. 일반적인 클라이언트 설치에는 이 명령을 실행할 필요가 없습니다.

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

OBS-01

설정 로드

YAML이 정상적으로 해석되는지, 외부 규칙 집합을 읽을 수 있는지, 정책 그룹 참조 이름이 일치하는지 확인하세요. 해석 단계에서 실패했다면 네트워크 연결은 아직 시작되지 않았으므로 들여쓰기, 필드 호환성 또는 원격 콘텐츠 접근성부터 처리해야 합니다.

OBS-02

시스템 트래픽 연결

시스템 프록시는 프록시 설정을 따르는 프로그램에 적용되고, TUN은 더 넓은 네트워크 트래픽을 처리합니다. 둘 다 시스템 권한과 라우팅이 관련되므로 전환한 뒤 연결을 새로 만들고 로컬 네트워크 접속을 확인하세요.

OBS-03

규칙 적용 결과

연결에 성공했다고 해서 분할 처리가 올바른 것은 아닙니다. 대상 도메인, 최종 IP, 적용된 규칙과 선택된 정책을 확인해 프록시 사용 불가, 규칙 순서 오류와 DNS 결과 이상을 구분해야 합니다.

OBS-04

변경 기록

설정을 조정할 때는 한 번에 한 종류의 항목만 변경하고 정상 작동하던 이전 설정을 보관하세요. 문제가 발생하면 빠르게 되돌릴 수 있고, 규칙·DNS·구독·클라이언트 설정 중 무엇이 변화를 일으켰는지도 명확해집니다.

SHORT ANSWERS

자주 묻는 질문

이 질문들은 문제를 어디서부터 확인할지 정하는 데 도움이 됩니다. 설정 필드의 의미가 궁금하다면 용어집을, 전체 작업 절차가 필요하다면 사용 문서를 확인하세요.

Clash Meta와 mihomo는 어떤 관계인가요?

Clash Meta는 이 브랜치와 생태계에서 널리 사용되는 이름이며, 현재 핵심 프로젝트는 mihomo라는 이름으로 유지보수됩니다. 여러 그래픽 클라이언트가 mihomo 코어를 호출할 수 있지만, UI와 시스템 서비스, 릴리스 일정은 각 프로젝트가 담당합니다. 자세한 내용은 용어집의 코어 및 아키텍처 분류에서 확인할 수 있습니다.

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

일상적인 설정에는 보통 규칙 모드를 사용해 도메인, IP와 규칙 집합에 따라 연결을 서로 다른 정책으로 보냅니다. 전역 모드는 특정 프록시 정책이 작동하는지 임시로 확인할 때, 직접 연결 모드는 프록시 요인을 제외할 때 적합합니다. 모드를 바꾼 뒤에는 기존 연결이 이전 경로를 계속 사용할 수 있으므로 대상 앱의 연결을 종료하고 다시 테스트하세요.

시스템 프록시를 켰는데도 일부 앱에 트래픽이 없는 이유는 무엇인가요?

일부 앱은 시스템 프록시를 읽지 않거나 자체 네트워크 스택을 사용할 수 있습니다. 먼저 브라우저 트래픽이 클라이언트로 들어오는지 확인한 뒤 대상 앱의 프록시 지원 여부를 점검하세요. 적용 범위가 필요할 때 TUN을 활성화하고 관리자 권한, 가상 네트워크 카드, 라우팅과 DNS 연결 상태를 확인합니다.

구독 업데이트에 실패하면 무엇부터 확인해야 하나요?

먼저 구독 주소에 접근할 수 있는지와 응답 내용이 여전히 유효한 설정인지 확인한 다음, 클라이언트 로그에서 HTTP 상태, 해석 메시지와 필드 오류를 살펴보세요. 수동 접근은 정상인데 클라이언트 업데이트가 실패한다면 업데이트 요청이 현재 프록시 규칙에 의해 순환되는지도 확인해야 합니다. 자세한 절차는 구독 업데이트 문제 해결 기록에서 확인하세요.

FIELD NOTES

최근 설정 기록

문서는 구체적인 문제를 중심으로 트리거 조건, 확인 순서와 수정 후 검증 방법을 기록합니다. 날짜는 콘텐츠를 정리한 시점을 표시하며, 설정하기 전에는 현재 클라이언트 UI와 코어 문서를 함께 확인해 필드를 점검해야 합니다.

시작 가이드

Clash 구독 업데이트 실패 해결: 원인 점검과 자동 업데이트 간격 설정

링크 만료, 요청 차단, 프록시 순환과 형식 변경 순서로 확인하고, 자동 업데이트 간격의 설정 위치와 수동 강제 업데이트 후 확인할 상태를 설명합니다.

전체 글 읽기
시작 가이드

Clash 프록시 모드 선택 가이드: 규칙·전역·직접 연결의 차이

연결 흐름을 기준으로 세 모드의 동작 차이를 설명하고, 일상적인 접속·임시 테스트·사설망 디버깅 상황별 선택법과 전환 후 재연결이 필요한 이유를 기록합니다.

전체 글 읽기
시작 가이드

Clash 구독 링크 가져오기: 클라이언트별 가져오기 절차와 일반적인 구독 형식

클라이언트별 구독 메뉴를 정리하고 표준 YAML, Base64와 범용 공유 링크의 차이를 설명하며, 가져온 후 노드·정책 그룹·규칙이 정상적으로 로드됐는지 확인하는 방법을 안내합니다.

전체 글 읽기

전체 글 보기 →