Clash Meta / mihomo 코어

Clash Meta
클라이언트 다운로드 및 설정

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

기기에 맞는 클라이언트를 선택하고 구독 가져오기부터 규칙 분기까지, mihomo 코어 설정 방법과 문제 해결 절차를 확인하세요.

  • 오픈 소스
  • YAML 설정
  • 한국어 문서

지원 플랫폼

Windows Android iOS macOS Linux

Clash 설정 블록

설정 항목을 살펴보며 연결 경로를 이해하세요. 주제를 선택하면 용도와 활성화 방법, YAML 예제를 확인할 수 있습니다. 예제는 일부 구조만 보여 주므로 기존 설정에 병합해야 합니다. 프록시 그룹 이름과 규칙 대상은 일치해야 합니다.

위에서부터 규칙을 확인하고 정책에 따라 연결

규칙 모드에서는 rules를 위에서부터 확인하며, 조건에 맞는 항목을 찾으면 해당 정책을 적용하고 다음 규칙은 확인하지 않습니다. 도메인 접미사 규칙은 같은 서비스의 하위 도메인을 처리할 때, IP 규칙은 알려진 주소 대역을 지정할 때 유용합니다. MATCH는 나머지 연결을 처리합니다. 별도로 처리할 규칙을 먼저 배치한 뒤 지역 규칙과 최종 정책을 추가하세요. mihomo는 기존 Clash 규칙 문법을 이어받으면서 규칙 기능을 확장했습니다. 이전 설정을 옮길 때는 사용 중인 규칙 유형과 데이터 파일이 여전히 호환되는지 확인하세요. 아래 예제의 PROXY는 프록시 그룹 이름이므로 설정에 먼저 정의해야 합니다. 규칙만 복사해서 바로 실행할 수는 없습니다.

config.yaml · rules
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

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

GUI 클라이언트는 구독 관리, 시스템 프록시 설정, 일상적인 조작을 담당하고 코어는 프로토콜, DNS 해석, 규칙 실행을 처리합니다. 기기에 적합한 클라이언트를 선택한 다음 CPU 아키텍처, 시스템 요구 사항, 설정 지원 범위를 확인하세요.

모든 클라이언트 보기 →

Windows

Clash Plus처럼 꾸준히 관리되는 GUI 클라이언트부터 살펴보세요. 설치 후 구독을 가져오고 시스템 프록시를 켠 다음 브라우저 연결을 확인하세요. 게임이나 스토어 앱까지 트래픽을 처리해야 한다면 TUN과 루프백 제한도 알아보세요.

Clash for Windows에서 옮길 때는 구독, 사용자 지정 규칙, 오버라이드를 먼저 백업하세요. 새 클라이언트는 설정 디렉터리와 서비스 모드가 다를 수 있으므로 기존 디렉터리 전체를 그대로 덮어쓰지 않는 것이 좋습니다. 시스템 프록시 포트도 새 클라이언트에 표시된 값을 기준으로 설정하세요.

다운로드 페이지로 이동

macOS

먼저 Apple Silicon과 Intel 프로세서를 구분한 뒤 해당 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev 등의 클라이언트에서 구독과 규칙을 관리할 수 있습니다. 설치 후 네트워크 권한은 시스템 안내에 따라 설정하세요.

시스템 프록시와 TUN은 권한을 부여하는 방식이 다릅니다. 브라우저는 인터넷에 연결되지만 터미널은 연결되지 않는다면 명령줄 프로그램이 프록시 환경 변수를 읽는지 먼저 확인하세요. 투명 프록시 처리가 필요한 경우에만 TUN을 활성화하고, 기존 VPN과 기본 경로를 동시에 변경하지 않도록 주의하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android 등의 클라이언트를 선택할 수 있습니다. 설정을 가져온 뒤 VPN 연결 생성을 허용하고 앱의 접속을 확인하세요. 설치 파일의 아키텍처는 기기에 맞아야 하므로, 잘 모르겠다면 먼저 기기 프로세서 정보를 확인하세요.

백그라운드에서 연결이 끊겼다고 해서 구독이 만료된 것은 아닐 수 있습니다. 먼저 시스템의 배터리 최적화, 백그라운드 실행, 자동 시작 권한을 확인한 뒤 무선 네트워크를 전환했을 때 연결이 복구되는지 살펴보세요. 한 번에 설정 하나씩 변경하면 시스템의 앱 종료와 연결 경로 변경 중 무엇이 원인인지 파악하기 쉽습니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 클라이언트가 지원하는 형식으로 구독을 가져오고 VPN 설정 추가를 허용한 다음, 시스템 설정에서 연결 상태를 확인하세요.

같은 구독이라도 클라이언트마다 지원하는 필드가 다를 수 있습니다. 가져오기에 실패하면 링크가 전체 설정을 반환하는지 프록시 목록을 반환하는지 확인한 뒤 구체적인 오류 메시지를 살펴보세요. 데스크톱의 수신 주소, 파일 경로, TUN 설정을 모바일에 그대로 옮기지 마세요.

다운로드 페이지로 이동

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를, 서버와 라우터에서는 mihomo 코어 패키지를 사용할 수 있습니다. 설치 전에 배포판의 패키지 형식과 CPU 아키텍처를 확인하고 설정 디렉터리와 실행 권한을 지정하세요.

명령줄에서 실행할 때는 먼저 포그라운드로 실행해 로그를 확인하고 설정이 정상적으로 로드되는지 확인한 뒤 서비스 관리자를 사용하세요. 일반 사용자에게 필요한 권한은 포트 수신, TUN 장치 생성, 라우팅 변경에 따라 다릅니다. 문제를 찾을 때는 설정 오류와 권한 오류를 구분해 처리하세요.

다운로드 페이지로 이동

mihomo 코어와 오픈 소스 생태계

코어, 클라이언트, 설정 출처를 구분해 이해하세요. 프로젝트 소스 코드는 구현 방식을 보여 주고 릴리스 노트는 변경 사항을 기록합니다. 실제 조작 방법은 클라이언트 인터페이스에 따라 달라집니다.

Clash Meta와 mihomo의 관계

Clash Meta는 이 코어 프로젝트에서 초기에 사용한 이름이며, 현재 프로젝트는 mihomo라는 이름으로 개발을 이어가고 있습니다. 튜토리얼을 검색하면 이전 이름과 저장소 경로, 클라이언트별로 다른 스크린샷을 볼 수 있습니다. 설정이 호환되는지 판단할 때는 클라이언트 이름에 Meta가 들어 있는지가 아니라 실제 실행 중인 코어와 해당 문서를 확인하세요. GUI와 코어 업데이트 시점도 서로 다를 수 있습니다.

클라이언트와 구독 서비스는 다릅니다

mihomo는 프록시 프로토콜, DNS 해석, 분기 규칙을 실행하며 GUI 클라이언트는 그 위에 설정 관리, 시스템 연동, 사용자 인터페이스를 제공합니다. 구독은 사용자가 직접 선택한 서비스나 자체 구축한 설정에서 가져옵니다. 클라이언트를 설치해도 사용할 수 있는 연결 출구가 자동으로 생기지는 않으며, 소스 코드가 공개되어 있다고 구독 정보까지 공개되는 것도 아닙니다. 이 사이트는 다운로드 목록과 한국어 사용 안내를 제공하며, 각 프로젝트의 개발과 배포, 문의 대응은 해당 프로젝트의 관리자가 담당합니다.

소스 코드와 릴리스 노트에서 변경 사항 확인

코어 소스 코드는 MetaCubeX/mihomo 저장소에서 확인할 수 있으며, 라이선스는 저장소의 LICENSE 파일을 기준으로 합니다. 커밋 기록, 이슈 논의, 릴리스 노트를 살펴보면 특정 필드의 지원 여부나 동작 변경을 확인하는 데 도움이 됩니다. 아래 명령을 복사하면 읽기용 소스 코드를 내려받을 수 있습니다. 일반 사용자가 GUI 클라이언트를 설치하는 데 필요한 절차는 아니며, 구독 가져오기나 네트워크 설정을 대신하지도 않습니다.

업데이트 전에 설정을 기록하고 이후 연결 경로를 확인

클라이언트나 코어를 업데이트하기 전에 현재 설정과 로컬 오버라이드를 백업하고 변경 사항을 확인하세요. 업데이트 후에는 설정이 정상적으로 로드되는지 확인한 다음 DNS, 규칙 적용, 연결 출구를 각각 점검하세요. 문제가 발생하면 운영체제, 클라이언트 이름, 코어 정보, 최소 재현 절차를 기록하세요. 로그를 공유하기 전에는 구독 주소, 인증 정보, 개인 도메인을 삭제해야 합니다. 설정 전체를 캡처하는 것보다 재현 절차를 명확히 정리하는 편이 문제를 찾는 데 도움이 됩니다.

소스 코드 공개

MetaCubeX / mihomo

코어 구현, 설정 변경, 커뮤니티 논의를 확인하세요. 데스크톱과 모바일 클라이언트의 기능 지원은 각각 따로 확인해야 합니다.

코어 소스 코드 저장소 열기 ↗
터미널 · 소스 코드 가져오기
git clone https://github.com/MetaCubeX/mihomo.git

문제에 맞는 안내 보기

처음 사용할 때는 구독 가져오기, 규칙 모드 선택, 프록시 활성화, 연결 확인 순서로 진행하세요. 네트워크 기능을 한꺼번에 모두 켤 필요는 없습니다. 브라우저 연결을 확인한 뒤 터미널, 스토어 앱, 로컬 네트워크 기기 사용을 위한 설정을 추가하세요.

구독, 모드, 포트 입문 가이드 →

인터넷에 연결되지 않으면 구독 가져오기 실패, 설정 로드 실패, 연결 출구 실패를 먼저 구분하세요. 각각 문제가 발생하는 경로가 다르므로 로그에서 처음 나타난 유효한 오류부터 확인해야 합니다.

증상별 문제 해결 방법 보기 →

규칙 모드와 전역 모드, 시스템 프록시와 TUN, HTTP 포트와 컨트롤 포트는 혼동하기 쉽습니다. 설정을 바꾸기 전에 각 항목이 어느 계층을 담당하는지 확인하세요. 트래픽 처리 범위를 넓혀 기존 문제를 가리지 않도록 주의해야 합니다.

문제 해결 가이드 보기 →

설정 및 문제 해결 기록

자주 겪는 상황별로 새 사용자 설정, 기존 클라이언트 이전, Windows 앱의 루프백 제한을 안내합니다. 각 문서에서 설정 순서와 적용 조건을 함께 확인할 수 있습니다.

모든 글 보기 →