mihomo 커널 · 모든 플랫폼에서 클라이언트 시작하기먼저 클라이언트를 선택한 뒤 구독을 가져오고, 규칙 모드와 시스템 프록시를 설정하세요.
클라이언트, 설정, 트래픽 진입 경로를 따로 확인하면 문제를 순서대로 진단할 수 있습니다.
클라이언트의 설정 또는 구독 화면을 열고 서비스 제공자가 안내한 전체 URL을 붙여 넣은 뒤 저장하고 업데이트하세요. 구독 URL은 노드와 설정을 가져오는 주소이지 일반 웹페이지 주소가 아닙니다. 설정 이름이 표시되면 현재 사용할 설정으로 선택해야 합니다. URL을 저장하는 것만으로 설정이 활성화되지는 않습니다.
먼저 구독이 유효한지 확인한 다음 클라이언트 설정을 살펴보세요. URL에 계정 정보가 포함될 수 있으므로 스크린샷을 공유할 때는 주소를 가리고, 출처를 알 수 없는 온라인 변환 사이트에도 붙여 넣지 마세요.
설정 → 새로 만들기 → 가져오기 → 활성화실행 모드를 규칙으로 설정한 다음 프록시 그룹에서 사용할 출구를 선택하세요. 프록시 그룹은 여러 노드를 묶어 관리하는 설정입니다. 그룹 이름은 구독에 따라 다르므로 가이드의 스크린샷과 일치하지 않을 수 있습니다. 규칙은 요청을 프록시로 보낼지 직접 연결할지 결정하고, 프록시 그룹은 실제로 사용할 출구를 정합니다.
우선 구독에 포함된 트래픽 분기 설정을 그대로 사용하고, 연결이 성공한 뒤 수정하세요. 전역 모드는 잠시 비교하며 문제를 진단할 때 유용합니다. 첫 연결을 위해 규칙 전체를 다시 작성할 필요는 없습니다.
mode: rule데스크톱 클라이언트에서 시스템 프록시를 켠 다음 브라우저로 원하는 페이지에 접속하고, 연결 기록에 해당 도메인이 표시되는지 확인하세요. 시스템 프록시는 앱에 프록시 주소를 제공하는 운영체제 설정이므로 모든 프로그램이 이를 사용하는 것은 아닙니다. 터미널 명령이나 일부 게임은 별도로 설정해야 할 수 있습니다.
테스트가 끝나면 시스템 프록시를 끄는 위치를 확인해 두세요. 클라이언트를 종료하기 전에 시스템 프록시를 끄면 프로그램이 로컬 포트 수신을 중단한 뒤에도 앱이 기존 주소로 요청을 보내는 상황을 방지할 수 있습니다.
앱 → 로컬 포트 → 규칙 → 출구운영체제와 프로세서 아키텍처를 확인한 다음 다운로드 페이지에서 설치 파일을 선택하세요.
그래픽 인터페이스가 있는 클라이언트를 선택하면 버튼을 눌러 설정을 가져오고, 프록시 그룹을 전환하고, 로그를 확인할 수 있습니다. mihomo 커널은 실제 네트워크 처리를 담당하는 프로그램이며, 직접 실행하려면 설정 파일을 준비해야 합니다. 일반적인 데스크톱 및 모바일 사용자는 클라이언트부터 시작하고, 서버나 라우터 사용자는 다운로드 페이지에서 커널을 살펴보세요. 클라이언트마다 메뉴 위치는 다를 수 있지만 설정, 모드, 프록시, 로그를 기준으로 원하는 기능을 찾을 수 있습니다.
일상적인 데스크톱 사용에 적합합니다. 먼저 시스템 정보에서 시스템 종류를 확인하고 알맞은 아키텍처의 클라이언트를 선택하세요. 설치 후에는 시스템 트레이에서 실행 상태를 확인하세요. 포트 충돌이 발생하면 다른 프록시 프로그램이 동시에 실행 중인지 살펴보세요.
다운로드먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel인지 확인한 뒤 알맞은 설치 파일을 선택하세요. 처음 실행할 때 시스템 권한이 필요하면 안내를 하나씩 확인하세요. 네트워크를 바꾼 뒤 연결에 문제가 생기면 현재 네트워크 서비스의 프록시 설정부터 점검하세요.
다운로드기기 아키텍처에 맞는 앱을 설치하고, 처음 연결할 때 운영체제의 VPN 권한 요청을 승인하세요. VPN 인터페이스는 기기의 트래픽을 처리하는 데 사용됩니다. 다른 앱이 이미 이 인터페이스를 사용 중이라면 해당 앱을 중지한 뒤 현재 클라이언트를 실행하세요.
다운로드다운로드 페이지에서 Clash Plus 스토어 페이지로 이동해 설치하고, 호환되는 설정을 가져온 뒤 시스템 안내에 따라 VPN 설정 추가를 허용하세요. 모바일에서는 앱 안의 연결 버튼을 기준으로 상태를 확인하세요. 지원 기능과 설정 범위는 클라이언트 설명을 참고하세요.
다운로드데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택한 뒤 배포판에 맞는 패키지 형식을 고르세요. 서버에서는 mihomo를 직접 실행할 수도 있지만 설정 디렉터리, 프로세스 권한, 서비스 시작 방법을 직접 관리해야 합니다.
다운로드각 설정이 담당하는 부분을 먼저 파악한 뒤 변경 여부를 결정하세요.
먼저 규칙 모드를 사용해 설정된 조건에 따라 요청이 출구를 선택하도록 하세요. 전역 모드는 커널로 들어온 트래픽을 전역 프록시 그룹으로 보내므로, 트래픽 분기 규칙이 문제인지 잠시 확인할 때 유용합니다. 직접 연결 모드에서는 커널로 들어온 요청이 대상에 바로 연결됩니다. 세 모드는 커널의 트래픽 처리 방식을 바꾸는 것으로, 모든 앱의 트래픽이 클라이언트로 들어온다는 뜻은 아닙니다. 모드를 전환한 뒤 요청을 다시 보내고 연결 기록을 확인하세요. 기존 연결은 이전 출구를 계속 사용할 수 있습니다. 아래에서 설명을 전환해 볼 수 있으며, 기기 설정은 변경되지 않습니다.
mode: rule규칙을 위에서 아래로 확인하고, 일치하는 규칙의 정책이나 프록시 그룹을 사용합니다.
mode: global커널로 들어온 트래픽을 전역 프록시 그룹으로 보내는 모드로, 짧은 비교 테스트에 적합합니다.
mode: direct커널로 들어온 요청을 직접 연결해 프록시 사용 전후의 연결 결과를 비교합니다.
전체 설정 구독과 노드 제공자를 구분하세요. 전체 설정에는 프록시 그룹, 규칙, DNS 설정이 포함될 수 있지만, 노드 제공자는 보통 노드만 제공하며 기본 설정에서 이를 참조합니다. 클라이언트의 구독 업데이트 버튼과 커널의 노드 제공자 업데이트는 서로 다른 작업일 수 있습니다. 가져온 뒤 업데이트 시간, 설정 활성화 여부, 프록시 그룹에 선택 가능한 출구가 표시되는지 확인하세요. 자동 업데이트 간격은 필요에 맞게 설정하세요. 사용자 규칙을 유지하려면 원격 업데이트가 직접 수정한 내용을 덮어쓰지 않도록 클라이언트의 덮어쓰기 기능을 사용하는 편이 좋습니다.
https://example.com/subscriptioninterval: 3600연결 기록에서 실제로 적용된 규칙을 확인한 뒤 규칙 순서를 조정하세요. 도메인 접미사 규칙은 도메인으로 일치 여부를 판단하고, GeoIP 규칙은 대상 IP의 지역 정보를 기준으로 판단하며, MATCH는 앞선 규칙에 일치하지 않은 요청을 처리합니다. 커널은 일반적으로 규칙을 위에서 아래로 확인해 처음 일치하는 항목을 적용하므로 구체적인 조건을 포괄적인 조건보다 앞에 배치해야 합니다. 예시의 PROXY는 설정에 실제로 존재하는 프록시 그룹 이름이어야 합니다. 규칙을 복사하기 전에 그룹 이름을 확인하고, 지역 판정에 사용하는 데이터 파일도 정상적으로 사용할 수 있는지 점검하세요.
DOMAIN-SUFFIX,google.com,PROXYGEOIP,CN,DIRECTMATCH,PROXY먼저 시스템 프록시를 켜 브라우저 연결을 확인하고, 그다음 TUN을 고려하세요. 시스템 프록시는 앱에 프록시 주소를 제공하지만 앱이 이를 사용하지 않을 수도 있습니다. TUN은 가상 네트워크 인터페이스로, 라우팅 설정과 함께 더 많은 트래픽을 처리할 수 있지만 별도의 권한이 필요하고 DNS 및 네트워크 경로에도 영향을 줍니다. 두 기능은 같은 연결 스위치가 아닙니다. 처음 설정할 때는 한 번에 하나만 변경하고 연결 기록을 확인한 뒤 다음 단계로 넘어가세요. 사내 네트워크, 다른 VPN, 가상 머신 네트워크 인터페이스를 사용하는 경우 모든 트래픽 처리 옵션을 한꺼번에 켜기보다 라우팅 충돌부터 확인하세요.
로컬 수신 포트와 제어 인터페이스를 구분해서 이해하세요. 혼합 포트는 앱의 프록시 요청을 받고, 제어 인터페이스는 실행 상태를 확인하고 설정을 관리하는 데 사용됩니다. 두 기능은 서로 바꿔 쓸 수 없습니다. 홈 화면 터미널의 코드는 항목을 알아보기 위한 예시일 뿐, 노드와 프록시 그룹, 규칙을 모두 포함한 완전한 연결 설정이 아닙니다. 처음 사용할 때는 유효한 설정을 가져온 뒤 클라이언트에 표시된 실제 포트에 맞춰 설정하세요.
다운로드 횟수로 판단하지 말고 프로젝트 소스 코드와 릴리스 안내를 확인하세요.
커널과 인터페이스를 두 층으로 나누어 보면 여러 클라이언트에 비슷한 설정이 있는 이유를 이해하기 쉽습니다. Clash 생태계는 설정 해석, 규칙 기반 트래픽 분기, 프록시 연결 전달을 중심으로 구성됩니다. 원본 Clash와 이후 파생 프로젝트는 동일한 소프트웨어가 계속 업데이트되는 관계가 아닙니다. Clash Meta는 이후 mihomo로 이름이 바뀌었지만 기존 가이드와 설정에는 이전 이름이 남아 있을 수 있습니다. 오래된 문서를 참고할 때는 먼저 어떤 커널과 클라이언트를 다루는지 확인한 뒤 해당 절차가 지금도 적용되는지 판단하세요.
클라이언트의 정보 화면, 커널 설정, 릴리스 안내를 확인하세요. 그래픽 클라이언트는 설정 관리, 시스템 트레이 제어, 시스템 프록시 등의 기능을 제공하고 커널은 연결을 처리합니다. 인터페이스 이름이 비슷해도 기능이 완전히 같지는 않습니다. 프로토콜 지원, 설정 항목, 업데이트 방식은 프로젝트에 따라 달라질 수 있습니다. 특히 특정 데스크톱 클라이언트의 메뉴 경로를 모든 모바일 앱에 그대로 적용해서는 안 됩니다. 이 사이트는 시작을 돕는 정보와 다운로드 경로를 제공하며, 모든 상위 프로젝트의 공식 배포처를 뜻하지는 않습니다.
클라이언트, 커널, 구독 데이터를 각각 확인하세요. 클라이언트 업데이트는 인터페이스나 시스템 연동 문제를 해결할 수 있고, 커널 업데이트는 프로토콜과 설정 지원에 영향을 줄 수 있으며, 구독 업데이트는 서비스 제공자가 배포한 노드와 규칙을 갱신합니다. GeoIP, GeoSite와 같은 지역 및 도메인 분류 데이터베이스도 별도의 업데이트 방식이 있습니다. 문제가 생기면 변경이 어느 계층에서 발생했는지 먼저 기록하세요. 모든 항목을 한꺼번에 업데이트하면 원인을 파악하기 어려워집니다.
조정하기 전에 현재 작동하는 설정, 덮어쓰기 내용, 주요 옵션을 저장하세요. mihomo를 직접 실행하는 경우 설정을 테스트해 통과한 뒤 서비스를 시작할 수 있습니다. 그래픽 클라이언트에서는 내장 설정 검사와 로그 화면을 우선 사용하세요. 공개적으로 문제를 제보할 때는 필요한 오류 정보만 남기고 구독 URL, 노드 인증 정보, 계정 내용은 가리세요. 개인 설정을 노출하지 않고도 문제를 설명할 수 있습니다.
먼저 클라이언트가 실행 중인지, 현재 설정이 활성화되어 있는지 확인한 다음 앱의 요청이 연결 기록에 나타나는지 살펴보세요. 기록이 전혀 없다면 시스템 프록시, 앱 자체 설정, TUN 처리 여부부터 확인하세요. 기록은 있지만 연결에 실패한다면 적용된 규칙, 프록시 그룹 선택, 노드 상태를 점검하세요. 브라우저는 정상인데 터미널에서 실패하는 경우 명령줄 도구의 프록시 설정을 별도로 확인해야 할 수 있습니다. 브라우저 연결만으로 모든 앱의 상태를 판단하지 마세요.
오류 메시지를 빠짐없이 저장하고 문제가 생기기 전에 변경한 내용을 기록하세요. 반복해서 재설치하는 것보다 원인을 좁히는 데 도움이 됩니다. 클라이언트를 종료한 뒤에도 인터넷이 연결되지 않으면 먼저 시스템 프록시 설정을 복원하세요. 특정 도메인만 실패한다면 DNS 조회와 규칙을 확인하세요. 기본 용어는 용어집에서, 자주 묻는 질문은 FAQ에서 확인할 수 있습니다. 여러 단계를 이어서 진단하려면 문제 진단 페이지를 이용하세요.
첫 연결을 마친 뒤 실제로 겪은 문제에 맞춰 더 자세히 알아보세요.
dns 섹션의 enhanced-mode, nameserver, fallback, fallback-filter, dns-hijack를 항목별로 설명하고 상황별 설정 예시를 제공합니다.
DNS 설정 안내 읽기커널과 그래픽 인터페이스를 구분하고, 원본 Clash에서 Clash Meta가 mihomo로 이름을 바꾸기까지의 과정과 플랫폼별 주요 클라이언트가 어떤 커널을 사용하는지 정리합니다.
프로젝트 관계 정리 읽기커널 로그 확인부터 시작해 설정 구문 오류, 포트 충돌, 권한 및 서비스 모드 문제를 차례로 진단하고 설정 파일을 안전하게 백업하고 복원하는 방법을 안내합니다.
실행 직후 종료 문제 해결 방법 보기