mihomo 커널오픈 소스 클라이언트 지속 업데이트

Clash Meta다운로드와 설정

Clash 다운로드 가이드 보기

mihomo 커널 기반으로 구독 가져오기부터 규칙 기반 트래픽 분리까지, 설정 항목별로 프록시·DNS·TUN을 알아봅니다.

커널 소스 공개중국어 설정 문서YAML 설정

CONFIGURATION INSPECTOR

mihomo 설정 검사기

설정 하나가 트래픽의 진입, DNS 확인, 규칙 매칭과 출구를 차례로 결정합니다. 먼저 요청이 커널에 들어오는지 확인한 다음, 어떤 규칙과 프록시 그룹이 선택됐는지 살펴보세요. 여러 설정을 한꺼번에 바꾸기보다 관련 항목별로 나누어 확인하면 원인을 찾기 쉽습니다.

RULES / FIRST MATCH

먼저 일치하는 규칙이 우선 적용

규칙은 위에서 아래로 평가되며, 일치하는 항목을 찾으면 지정된 정책으로 요청을 전달합니다. 도메인 접미사 규칙은 특정 사이트 집합을 지정할 때, 지리 정보 규칙은 IP 주소의 위치를 판별할 때 유용합니다. 마지막의 MATCH는 앞선 규칙에 걸리지 않은 요청을 처리합니다. 사이트가 잘못된 출구로 연결된다면 연결 기록에서 도메인, 매칭된 규칙, 최종 정책을 확인하세요. 현재 선택된 노드만 살펴봐서는 부족합니다. Rule 모드는 이 규칙 목록을 따르고, Global 모드는 전역 정책을 사용합니다. 모드를 바꾼다고 규칙 오류가 해결되지는 않습니다. 예시의 PROXY 프록시 그룹을 먼저 정의해야 하며, GEOIP 규칙에는 사용 가능한 지리 정보 데이터도 필요합니다.

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

CLIENT ENTRY POINTS

Clash 클라이언트 플랫폼별 안내

먼저 운영체제를 고른 다음 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 설정 관리와 시스템 트래픽 처리를 담당하고, 커널은 규칙을 해석해 요청을 전달합니다. 설치 파일의 실행 가능 여부, TUN 권한, 설정 형식의 호환성을 각각 확인해야 합니다. 클라이언트 이름만 보고 판단하지 마세요.

Windows

Clash Plus 같은 GUI 클라이언트부터 시작해 보세요. 첫 연결에서는 시스템 프록시가 작동하는지 확인하고, 앱에 필요할 때 TUN을 활성화하세요. 포트 충돌이나 서비스 권한 안내가 나타나면 구독을 계속 바꾸기보다 먼저 로컬 환경을 점검하세요.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 시스템 프록시와 네트워크 확장 권한은 설정 위치가 다르므로 설치 후 시스템 안내를 확인해야 합니다. 절전 모드에서 깨어나거나 네트워크를 바꾼 뒤에는 출구와 DNS 확인이 정상인지 다시 점검하세요.

다운로드 페이지로 이동

Android

기기 아키텍처와 설치 권한을 확인하고, 구독을 가져온 뒤 VPN 연결을 허용하세요. 백그라운드 절전 설정이 서비스를 중단할 수 있습니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 제한과 다른 VPN 앱이 트래픽 처리 경로를 점유하는지 확인하세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하세요. 공식 사이트는 clashplus.io입니다. 가져오기 전에 설정 형식이 호환되는지 확인하고, 처음 실행할 때 시스템 안내에 따라 VPN을 허용한 뒤 규칙과 출구를 점검하세요.

다운로드 페이지로 이동

Linux

데스크톱에서는 GUI 클라이언트를, 서버와 라우터에서는 커널 안내를 확인할 수 있습니다. 설치 전에 배포판 패키지 형식, 프로세서 아키텍처, 서비스 실행 계정을 확인하세요. 데스크톱 프록시 설정이 기기 전체의 트래픽을 처리한다고 착각하지 않도록 주의해야 합니다.

다운로드 페이지로 이동

다운로드 페이지에서 플랫폼별 클라이언트, 아키텍처, 시스템 요구 사항을 확인할 수 있습니다. 다른 클라이언트를 사용 중이라면 전환하기 전에 설정을 내보내고 로컬 규칙, 오버라이드, 정책 선택을 기록해 두세요. 같은 구독이라도 도구마다 변환 과정이 다를 수 있으며, 화면 구성이 비슷하다고 설정 처리 방식까지 같은 것은 아닙니다.

Clash for Windows 지원이 중단된 뒤에도 오래된 설치 파일이 튜토리얼 화면에 등장할 수 있습니다. 새로 설치할 때는 계속 유지 관리되는 대안을 우선 검토하고, 보관된 클라이언트는 호환성 요구가 분명한 경우에만 사용하세요. 전환을 마치면 이전 도구의 시작 프로그램과 시스템 프록시 설정을 끄세요. 두 프로세스가 포트를 두고 충돌하거나 시스템 설정을 번갈아 덮어쓸 수 있습니다.

전체 클라이언트 보기 →

FIRST CONNECTION

구독 가져오기와 첫 연결

클라이언트를 설치했다고 트래픽이 자동으로 프록시를 거치는 것은 아닙니다. ‘설정 불러오기 → 정책 선택 → 트래픽 처리 및 확인’ 순서로 진행하면 구독 다운로드, 노드 연결, 로컬 트래픽 처리 문제를 구분할 수 있습니다. 아래 화면은 설정 항목을 설명하기 위한 예시이며, 메뉴 이름은 사용하는 클라이언트에 따라 다를 수 있습니다.

01

구독 설정 가져오기

설정 또는 구독 페이지를 열고 원격 설정을 추가한 뒤 기존 링크를 붙여 넣으세요. 다운로드가 완료되면 해당 설정을 선택하고 프록시 그룹이 표시되는지 확인합니다. 주소만 저장하고 설정을 활성화하지 않으면 현재 연결에는 반영되지 않습니다.

웹페이지, 로그인 안내 또는 빈 화면이 반환되면 구독 제공자에게 링크와 계정 상태를 먼저 확인하세요. 계정 정보가 포함된 주소를 공개 변환 사이트에 입력하거나 구독 내용을 공개 게시물에 붙여 넣지 마세요.

02

규칙과 출구 선택

처음 사용할 때는 Rule 규칙 모드를 선택하고, 규칙에서 실제로 참조하는 프록시 그룹에서 노드를 지정한 다음 테스트하세요. 지연 시간 테스트는 특정 대상에 대한 응답 결과일 뿐, 모든 웹사이트의 접속 속도를 나타내지는 않습니다.

테스트 시간 초과가 노드를 사용할 수 없다는 뜻은 아닙니다. 테스트 대상이나 DNS 경로에 문제가 있을 수도 있습니다. 실제 웹사이트 접속과 로그를 함께 확인하고, 먼저 하나의 출구로 연결을 검증한 뒤 자동 테스트와 대체 정책을 설정하세요.

03

트래픽 처리 후 연결 확인

먼저 시스템 프록시로 브라우저 연결을 확인하세요. 프록시 설정을 따르지 않는 앱은 필요에 따라 TUN을 활성화하면 됩니다. 대상 사이트를 열고 연결 기록에서 매칭된 규칙, 프록시 그룹, 최종 출구가 예상한 대로인지 확인하세요.

확인할 때는 브라우저, 터미널, 기타 앱을 구분하세요. 터미널 도구는 프록시 환경 변수를 별도로 설정해야 할 수 있습니다. IP 조회 결과는 해당 조회 요청의 출구만 보여 주며, 모든 요청이 같은 경로를 거친다는 뜻은 아닙니다.

전체 가이드 보기 →

SOURCE & MAINTENANCE

오픈 소스 커널과 클라이언트의 역할

Clash Meta와 mihomo의 관계

Clash Meta는 이 커널 분기가 초기에 사용하던 이름이며, 현재 커널 프로젝트는 mihomo라는 이름으로 유지 관리되고 있습니다. 검색 결과와 설정 가이드, 일부 클라이언트 이름에는 여전히 Meta가 남아 있습니다. 문서가 현재 환경에 맞는지 판단할 때는 창 제목보다 실제 실행 중인 커널과 지원 설정 항목을 확인하세요. 오래된 화면에 나온 버튼 이름도 바뀌었을 수 있습니다.

mihomo는 설정 해석, 프로토콜 처리, 규칙 판단, DNS 등의 기능을 제공합니다. GUI 클라이언트는 구독 관리, 트레이 메뉴, 시스템 프록시, 서비스 관리 기능을 더합니다. 클라이언트 업데이트와 커널 업데이트는 별개입니다. 설정 키가 인식되지 않는다면 무엇을 업데이트할지 결정하기 전에 실제 커널 정보와 로드 로그부터 확인하세요.

소스 코드와 문서로 동작 확인하기

공개 저장소의 코드, 라이선스, 이슈와 릴리스 노트는 실제 동작을 확인하는 데 중요한 자료입니다. 가이드와 실제 화면이 다르면 해당 프로젝트의 문서와 릴리스 기록을 확인해 설정 이름이나 기본값이 바뀌었는지, 추가 권한이 필요한지 살펴보세요. 이 사이트는 중국어로 된 사용 안내를 제공하며, 상위 프로젝트가 공식적으로 설명하는 기능 범위를 대신하지 않습니다.

mihomo 공식 저장소 보기 ↗ · 사이트에서 다루는 내용 →

설정과 프록시 서비스는 별도로 관리

프록시 커널과 클라이언트는 프록시 서비스 자체가 아닙니다. 구독에 포함된 노드, 회선 상태, 데이터 사용량, 계정 만료일은 서비스 제공자가 관리합니다. 새 클라이언트를 다운로드해도 만료된 구독이 복구되지는 않습니다. 이른바 Clash 프록시 구독은 보통 서비스 제공자가 전달하는 설정 링크를 뜻합니다. 사용 전에 출처, 프로토콜 지원 여부와 서비스 약관을 확인하고, 커널에 네트워크 리소스가 포함된 것으로 오해하지 마세요.

규칙 목록, 지리 정보 데이터, 프록시 구독은 각각 업데이트 주기가 다릅니다. Clash GeoIP 데이터를 업데이트할 때는 설정에서 사용하는 데이터 형식과 파일 위치부터 확인하세요. 구독을 갱신할 때는 노드 목록과 로컬 오버라이드가 유지됐는지 살펴보세요. 작업을 나눠 진행해야 문제가 생겼을 때 확인된 이전 상태로 쉽게 되돌릴 수 있습니다.

업데이트 전 기록하고, 업데이트 후 확인

현재 작동하는 설정, 주요 오버라이드, 시작 옵션을 보관하고 변경 내역을 읽은 뒤 업데이트하세요. 업데이트 후에는 실행과 YAML 로드 여부를 먼저 확인하고 DNS, 자주 사용하는 사이트, 트래픽 처리가 필요한 앱도 점검합니다. 문제가 생기면 개인정보를 제거한 오류 정보를 보관하세요. 문의할 때는 운영체제, 아키텍처, 클라이언트와 커널 환경을 알려 주되 실제 구독 URL, 비밀번호, 계정 정보를 첨부하지 마세요.

SOURCE / GIT CLONE

구현을 살펴보고 변경 내역을 추적하려면 소스 코드를 내려받으세요. clone은 저장소 파일만 가져오며 클라이언트를 자동 설치하지 않습니다. 일반 데스크톱 사용자는 다운로드 페이지에서 설치 파일을 받을 수 있습니다.

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

CONFIGURATION NOTES

연결 확인 및 문제 해결 글

기본 설정을 마친 뒤에는 증상에 맞는 가이드를 확인하세요. 시스템 프록시 미작동, 규칙 오매칭, 노드 연결 불가는 서로 다른 단계의 문제입니다. 현재 상태를 보존하고 요청이 어느 단계에서 예상과 달라지는지 찾은 다음, 관련 설정만 조정하세요.

전체 글 보기 →