Windows
데스크톱에서 일상적으로 사용하기 좋습니다. 다운로드 전에 시스템 아키텍처를 확인하고 설치 후 트레이 메뉴에서 기본 화면을 연 다음 시스템 프록시를 활성화할 수 있습니다.
다운로드 페이지로 이동다양한 운영체제에 맞는 클라이언트를 한곳에서 찾고, 단계별로 구독 가져오기, 규칙 분기 및 TUN 모드를 설정하세요. 다운로드와 사용법을 나누어 구성해 처음 사용하는 경우에도 고급 설정을 찾기 쉽습니다.
먼저 지금 해결하려는 문제를 선택한 다음 관련 설정을 확인하세요. 각 항목은 진입 경로, 작업 결과, 헷갈리기 쉬운 차이를 중심으로 설명합니다.
구독 메뉴에서는 서비스 제공자가 전달한 설정 주소를 읽어 노드, 프록시 그룹, 규칙을 클라이언트에 불러옵니다. 처음 가져올 때는 링크가 완전한지 확인하고 알아보기 쉬운 이름을 지정하세요. 가져오기가 끝났다고 트래픽이 바로 가로채지는 않습니다. 해당 설정을 선택한 뒤 시스템 프록시나 TUN 모드를 활성화해야 합니다. 구독을 업데이트하면 클라이언트가 원격 내용을 다시 읽으므로 로컬에서 임시로 수정한 내용이 덮어써질 수 있습니다. 오래 유지할 규칙은 오버라이드 설정에 넣는 편이 좋습니다. 노드를 하나씩 수동으로 추가하는 것보다 정기적으로 설정을 동기화해야 하는 경우 구독 관리가 적합하며, 클라이언트 간 마이그레이션도 편리합니다.
https://example.com/subscription
규칙 모드에서는 설정에 정의된 순서대로 도메인, IP, 프로세스 또는 규칙 세트를 확인하고 연결을 지정된 프록시 그룹으로 전달합니다. 일반적으로 더 구체적인 규칙을 앞에 두고 마지막에 기본 규칙을 배치합니다. 분기 오류를 확인할 때는 연결 기록에서 대상 도메인이 어떤 규칙과 매칭됐는지 먼저 확인한 뒤 해당 규칙이 가리키는 프록시 그룹을 점검하세요. 노드를 계속 바꿔 보는 것만으로는 해결되지 않습니다. 글로벌 모드는 대부분의 트래픽을 현재 프록시 정책으로 통일하고, 직접 연결 모드는 프록시를 우회합니다. 두 모드는 임시 확인에는 적합하지만 장기적인 분기 설정을 대신할 수는 없습니다. 실행 모드, 규칙, 프록시 그룹을 구분하면 연결은 성공했지만 앱의 접속 경로가 예상과 다른 문제를 줄일 수 있습니다.
DOMAIN-SUFFIX,example.com,代理
GEOIP,CN,直连
MATCH,代理
시스템 프록시는 브라우저처럼 운영체제의 프록시 설정을 읽는 앱에 적합하며, 활성화가 간단해 클라이언트가 정상적으로 연결되는지 빠르게 확인하기 좋습니다. 일부 게임, 명령줄 도구 또는 자체 네트워크 스택을 사용하는 소프트웨어는 시스템 프록시를 읽지 않습니다. 이때는 TUN 모드를 고려할 수 있습니다. TUN은 가상 네트워크 인터페이스를 만들고 더 많은 트래픽을 mihomo 코어로 전달하므로 대개 시스템 권한이 필요하며, 다른 VPN, 가상 네트워크 어댑터 또는 보안 프로그램과 충돌할 수 있습니다. 먼저 시스템 프록시로 기본 연결을 확인한 뒤 구독, 노드, 규칙이 정상인지 확인하고 앱 범위에 따라 TUN을 켜세요. 인터넷이 끊기면 먼저 TUN을 끄고 가상 어댑터, DNS, 라우팅 설정을 점검하세요.
Clash의 DNS 모듈은 도메인 해석 과정을 규칙 판단에 포함합니다. Fake-IP 모드에서는 먼저 로컬 매핑 주소를 반환하고 연결을 설정할 때 원래 도메인을 복원하므로, 규칙 엔진이 도메인 기준으로 정확하게 트래픽을 분기할 수 있습니다. 이는 원격 서버의 실제 주소가 아니므로 해석 결과를 판단하는 데 직접 사용해서는 안 됩니다. 로컬 네트워크 기기, 게임 로그인 또는 일부 앱의 호환성 문제가 발생하면 먼저 Fake-IP 필터 목록을 확인하고 상위 DNS에 연결할 수 있는지 점검하세요. DNS를 조정하기 전에는 현재 설정을 보존하고 한 번에 하나의 옵션만 변경해야 문제가 DNS 서버, 강화 모드, TUN 가로채기 중 어디에서 발생했는지 판단할 수 있습니다. 복잡한 설정은 사용 중인 클라이언트 코어가 지원하는 필드를 우선 참고하세요.
dns:
enable: true
enhanced-mode: fake-ip
respect-rules: true
다운로드 페이지에는 각 플랫폼에서 사용할 수 있는 여러 클라이언트가 정리되어 있습니다. 먼저 운영체제를 확인한 뒤 프로세서 아키텍처, 인터페이스 선호도, 유지 관리 상태를 기준으로 설치 패키지를 선택하세요.
데스크톱에서 일상적으로 사용하기 좋습니다. 다운로드 전에 시스템 아키텍처를 확인하고 설치 후 트레이 메뉴에서 기본 화면을 연 다음 시스템 프록시를 활성화할 수 있습니다.
다운로드 페이지로 이동Apple Silicon과 Intel 프로세서용 옵션을 각각 제공합니다. 처음 실행할 때 시스템 안내에 따라 네트워크 확장 또는 보조 서비스 권한을 허용한 뒤 구독을 가져오세요.
다운로드 페이지로 이동스마트폰과 태블릿에 적합합니다. 설치 후 클라이언트가 VPN 연결을 만들도록 허용하고, 기기 제조사의 백그라운드 정책에 따라 필요한 실행 권한을 유지하세요.
다운로드 페이지로 이동App Store에서 사용 가능한 클라이언트를 확인하세요. 설치 후 앱에서 구독을 가져오고 시스템 안내에 따라 VPN 설정을 추가합니다.
다운로드 페이지로 이동데스크톱 Linux, 개발 환경, 시스템 서비스를 익숙하게 다루는 사용자에게 적합합니다. 그래픽 클라이언트와 mihomo 코어는 용도가 다르므로 인터페이스 관리가 필요한지에 따라 선택하세요.
다운로드 페이지로 이동이 부분에서는 처음 실행할 때 필요한 핵심 흐름만 다룹니다. 권한, DNS 또는 규칙 문제가 발생하면 전체 가이드에서 해당 점검 항목을 확인하세요.
먼저 다운로드 페이지에서 현재 운영체제 분류로 이동해 아직 유지 관리되고 프로세서 아키텍처에 맞는 클라이언트를 선택하세요. Windows는 보통 설치 프로그램을 바로 실행하면 됩니다. macOS에서는 Apple Silicon과 Intel 아키텍처를 확인하고 시스템 설정의 안내에 따라 네트워크 확장 또는 보조 서비스를 허용하세요. Android와 iOS는 처음 연결할 때 VPN 권한을 요청합니다. 설치가 끝나면 기본 화면을 열어 설정, 구성 또는 구독 메뉴에 정상적으로 들어갈 수 있는지 확인하세요. 이때 다른 프록시 도구나 VPN을 동시에 켜지 말아야 포트, 가상 네트워크 어댑터, 시스템 프록시 상태가 서로 덮어쓰는 일을 피할 수 있습니다.
구독 또는 설정 페이지에 전체 주소를 붙여 넣고 알아보기 쉬운 이름을 지정한 뒤 가져오기나 업데이트를 실행하세요. 성공하면 설정 목록에 새 항목이 나타나며, 이를 수동으로 현재 설정으로 지정해야 합니다. 이어서 프록시 또는 정책 페이지에서 프록시 그룹에 선택 가능한 항목이 표시되는지 확인하세요. 해석 실패가 표시되면 주소에 문자가 빠지지 않았는지, 웹 공유 링크를 구독 링크로 잘못 사용하지 않았는지 먼저 확인합니다. 가져오기는 성공했지만 목록이 비어 있다면 클라이언트를 반복해서 재설치하지 말고 서비스 제공자에게 구독 내용을 확인하세요. 규칙을 수정해야 한다면 구독 업데이트 후 복구할 수 있도록 원본 설정 사본을 먼저 저장하세요.
처음 확인할 때는 규칙 모드를 선택하고 시스템 프록시를 활성화한 다음 브라우저로 자주 이용하는 사이트에 접속하는 것이 좋습니다. 연결되면 클라이언트의 연결 기록을 열어 도메인이 예상한 규칙 및 프록시 그룹과 매칭됐는지 확인하세요. 브라우저는 되지만 특정 앱에 트래픽이 없다면 해당 앱이 시스템 프록시를 읽지 않을 가능성이 있으므로 필요에 따라 TUN 모드를 테스트합니다. 처음부터 노드, DNS, TUN, 규칙을 동시에 변경하지 마세요. 여러 변수가 함께 바뀌면 원인을 파악하기 어렵습니다. 가장 안정적인 순서는 설정 유효성 확인, 노드 검증, 규칙 점검, 특정 앱의 가로채기 범위 처리입니다.
첫째, 현재 설정이 실제로 선택되어 있는지 확인합니다. 둘째, 시스템 프록시 또는 TUN이 켜져 있는지 봅니다. 셋째, 프록시 그룹에서 사용 가능한 항목을 선택했는지 확인합니다. 넷째, 연결 기록에 대상 앱의 요청이 나타나는지 확인합니다. 브라우저 기록이 전혀 없다면 트래픽이 아직 클라이언트에 들어오지 않은 경우가 많습니다. 기록은 있지만 거부된다면 규칙과 정책을 점검하고, 모든 요청이 시간 초과되면 사용 가능한 항목으로 바꾸고 로컬 네트워크를 확인하세요. 이 순서로 점검하는 편이 계속 재설치하는 것보다 원인을 찾기 쉽습니다.
전체 가이드 보기 →Clash는 널리 사용되는 설정 구조를 형성했습니다. 프록시 항목은 연결 방식을 설명하고, 프록시 그룹은 여러 선택지 중 하나를 고르며, 규칙은 각 트래픽을 어떤 정책으로 보낼지 결정합니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 기존 설정 관행을 바탕으로 호환 구현을 계속 발전시켰고, mihomo는 많은 최신 클라이언트가 채택하는 코어가 되었습니다. 데스크톱과 모바일에서 보는 그래픽 인터페이스는 코어 자체가 아닙니다. 설치, 설정 관리, 시스템 권한, 화면 표시를 담당하며 실제 규칙 매칭, DNS 처리, 연결 전달은 코어가 수행합니다.
그래픽 클라이언트와 코어의 관계를 이해하면 문제가 어느 계층에서 발생했는지 판단하기 쉽습니다. 인터페이스가 실행되지 않거나 트레이 아이콘이 사라지고 시스템 서비스 설치가 실패한다면 대개 클라이언트 계층의 문제입니다. 설정 필드를 인식하지 못하거나 규칙 동작이 달라지고 DNS 모드가 예상과 다르다면 코어의 기능이나 설정 문법과 관련됐을 가능성이 큽니다. 클라이언트를 바꿀 때 양쪽이 같은 설정 필드를 지원한다면 구독과 대부분의 규칙을 계속 사용할 수 있습니다. 다만 TUN, 스크립트, 오버라이드, 외부 컨트롤러 등의 메뉴 위치는 달라질 수 있으므로 마이그레이션 후 하나씩 확인해야 합니다.
오픈 소스 프로젝트의 업데이트는 보통 코드 커밋, 이슈 토론, 릴리스 기록으로 구성됩니다. 이 사이트는 모든 변화를 단순히 “업데이트됨”으로 뭉뚱그리지 않고 다운로드, 기본 가이드, 고급 설정, 문제 해결로 나누어 설명합니다. 클라이언트를 업데이트할 때는 먼저 릴리스 노트를 읽고 설정 마이그레이션, 권한 변경, 코어 전환 여부를 확인하세요. 설정을 업데이트할 때는 로컬 오버라이드 내용을 보존하고, 규칙 데이터 업데이트 후 매칭 결과가 달라지면 연결 기록에서 매칭 항목을 다시 확인해야 합니다. 이러한 유지 관리 순서를 따르면 클라이언트 파일, 코어 동작, 구독 내용을 분리해 처리할 수 있습니다.
일상적인 사용만 필요한 경우 그래픽 클라이언트에서 구독 업데이트, 모드 전환, 정책 선택, 로그 확인 등을 처리할 수 있으므로 코어 명령을 직접 실행할 필요가 없습니다. 서버, 라우터 또는 자동화 배포 환경에는 mihomo를 직접 사용하고 설정 파일과 외부 제어 인터페이스로 관리하는 방식이 더 적합합니다. 두 방식은 많은 개념을 공유하지만 설치 경로, 권한 모델, 문제 확인 방법은 다릅니다. 선택하기 전 장치 유형과 관리 방식을 먼저 정하는 편이 단순히 인터페이스 외관을 비교하는 것보다 효과적입니다.
일부 앱은 운영체제의 프록시 설정을 읽지 않습니다. 먼저 브라우저에서 연결 기록이 정상적으로 생성되는지 확인한 다음 대상 앱에 TUN 모드가 필요한지 판단하세요. TUN을 활성화하기 전에는 다른 VPN이나 가상 네트워크 어댑터 도구를 종료해 트래픽 가로채기 경로의 충돌을 피해야 합니다. 자세한 점검 절차는 자주 묻는 질문 페이지에서 확인할 수 있습니다.
구독 업데이트는 보통 원격 설정을 다시 기록하므로 로컬에서 직접 수정한 내용이 덮어써질 수 있습니다. 오래 유지할 규칙은 클라이언트가 지원하는 오버라이드 기능에 넣거나 독립적인 설정 조각으로 관리하세요. 수정하기 전에 복구 가능한 사본을 저장하는 것이 좋습니다.
일상적인 사용은 보통 규칙 모드로 시작해 각 트래픽을 설정에 따라 분배합니다. 글로벌 모드는 프록시 경로를 임시로 확인할 때, 직접 연결 모드는 문제가 프록시 경로에서 비롯됐는지 판단할 때 적합합니다. 테스트가 끝나면 실제 용도에 맞는 모드로 돌아가세요.
Fake-IP는 클라이언트 DNS 모듈이 생성하는 로컬 매핑으로, 도메인 정보를 유지하고 규칙 판단에 참여하도록 합니다. 원격 서버의 실제 주소가 아니므로 매핑 주소를 해석 오류로 간주해서는 안 됩니다. 특정 앱의 호환성 문제가 발생하면 필터 목록과 DNS 설정을 확인하세요.
마이그레이션, 시스템 권한, 트래픽 가로채기, 모바일 백그라운드 정책을 중심으로 바로 실행할 수 있는 점검 절차를 정리했습니다.
지연 시간 측정 빈도, 규칙 복잡도, 상시 TUN 실행, 제조사 백그라운드 제한을 차례로 확인해 모바일 배터리 소모 원인을 찾고 안정적인 연결에 필요한 실행 권한을 유지합니다.
전체 글 읽기 →설치 차단, 네트워크 확장 권한, 보조 프로그램, 키체인 안내를 차례로 처리하고, 삭제 후에도 팝업이 반복될 때 확인해야 할 잔여 항목의 위치를 설명합니다.
전체 글 읽기 →트래픽이 클라이언트로 들어오는 경로를 바탕으로 두 모드를 설명하고, 시스템 프록시를 따르는 앱과 가상 네트워크 어댑터로 가로채야 하는 환경을 구분해 전환 순서를 제시합니다.
전체 글 읽기 →