안드로이드 클라이언트 / 구독 및 트래픽 분기
먼저 클라이언트를 선택한 다음 구독을 가져오세요. 안드로이드 설정, 규칙 기반 트래픽 분기, 전체 플랫폼 설치 안내를 확인할 수 있습니다.
Android / 설정
규칙 모드는 rules 순서대로 일치 항목을 찾습니다.
평소에는 규칙 모드를 선택해 설정에 지정된 도메인, 주소 또는 규칙 집합에 따라 연결 경로를 정하세요. 홈 화면에서 프록시 모드를 열고 규칙을 선택한 다음, 프록시 화면에서 정책 그룹에 선택된 노드를 확인합니다. 전역 모드는 모든 연결을 전역 정책 그룹으로 보내므로 임시 비교나 문제 해결에 적합하며, 직접 연결 모드에서는 프록시를 사용하지 않습니다. 세 모드는 속도 설정이 아니며 구독의 유효성에도 영향을 주지 않습니다. 모드를 바꾼 뒤 대상 웹페이지를 다시 열고 새 연결의 규칙 적용 결과를 확인해야 설정이 제대로 작동하는지 판단할 수 있습니다.
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT규칙은 위에서 아래로 확인하며, 먼저 일치한 항목이 해당 연결의 처리 방식을 결정합니다. 아래 예시에서는 지정한 도메인과 하위 도메인을 직접 연결로 설정하고 마지막 줄도 기본값으로 직접 연결을 사용합니다. 문법을 설명하기 위한 예시일 뿐입니다. 실제로 프록시를 사용하려면 설정에 이미 존재하는 정책 그룹 이름을 지정해야 하며, 낯선 이름을 그대로 복사해서는 안 됩니다. 세부 규칙은 기본 규칙보다 앞에 추가하고 YAML 들여쓰기를 일관되게 유지하세요. 저장 후 설정을 불러올 수 있는지 먼저 확인하고, 연결 기록에서 규칙 적용 결과를 확인해 문법 오류를 노드 문제로 오해하지 않도록 하세요.
앱 이름은 선택 방식을 보여 주며, 스위치는 정적인 예시입니다.
앱 접근 제어는 먼저 어떤 앱의 트래픽을 클라이언트의 VPN 처리 대상으로 삼을지 정합니다. 그다음 규칙 모드가 대상 연결의 출구를 결정합니다. 설정에서 앱 접근 제어를 열고 선택한 앱만 허용하는 방식인지, 선택한 앱을 우회하는 방식인지 먼저 확인한 뒤 앱을 선택하세요. 두 방식을 혼동하면 안 됩니다. 브라우저는 정상인데 특정 앱만 계속 직접 연결된다면 노드를 계속 바꾸기보다 해당 앱이 제외되어 있는지 먼저 확인하세요. 적용 범위를 바꾼 뒤에는 클라이언트 안내에 따라 서비스를 다시 시작하고, 대상 앱도 완전히 종료한 다음 다시 실행해야 기존 연결이 이전 네트워크 경로를 계속 사용하는 일을 막을 수 있습니다.
설정 재정의 기능을 사용하면 프록시 모드, 로그 수준, LAN 접근 방식처럼 기기별로 선호하는 설정을 원격 구독과 분리해 저장할 수 있습니다. 먼저 원본 설정을 가져와 정상 작동하는지 확인한 다음 재정의 항목을 하나씩 바꾸고 서비스가 제대로 시작되는지 살펴보세요. 재정의는 보통 설정을 불러올 때 적용되므로 화면에 표시되는 값이 구독 원문과 다를 수 있습니다. 문제를 해결할 때는 두 곳을 모두 확인하세요. 클라이언트마다 지원하는 재정의 항목이 다르므로 설정을 옮기기 전에 해당 클라이언트의 안내를 확인해야 합니다. 자동 업데이트되는 구독 내용을 반복해서 직접 수정하지 마세요. 다음 업데이트 때 변경 사항이 덮어써져 문제를 재현하기 어려워질 수 있습니다.
구독에는 보통 노드, 정책 그룹, 트래픽 분기 규칙이 포함되고, 기기 설정은 VPN 트래픽 처리, 앱 접근 제어, 백그라운드 실행을 담당합니다. 웹페이지가 열리지 않으면 먼저 설정이 선택되어 있는지, 서비스에 시스템 권한이 부여되었는지 확인한 뒤 적용된 정책 그룹을 살펴보세요. DNS, 규칙, 앱 목록을 한꺼번에 변경하지 마세요. 연결이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다. 전체 문서에서는 플랫폼별 설치 방법과 구독 가져오기를 비롯해 시스템 프록시와 TUN의 차이를 설명합니다. 기기를 바꾸거나 네트워크 설정을 조정할 때 항목별로 확인해 보세요.
전체 플랫폼 설치 및 설정 안내 →먼저 서비스 제공업체에서 받은 구독 링크를 준비하고, 선택한 클라이언트가 해당 설정 형식을 지원하는지 확인하세요. 설정 페이지에서 URL로 가져오기를 선택하고 저장한 다음, 해당 설정을 활성화하고 홈 화면으로 돌아가 서비스를 시작합니다. 안드로이드에서 처음 실행하면 VPN 권한 요청이 표시되므로 승인한 뒤 프록시 화면에서 사용할 수 있는 정책을 선택해야 합니다. 마지막으로 브라우저에서 새 연결을 열고 클라이언트 연결 기록을 확인해 트래픽 분기 결과를 살펴보세요. 빠른 시작 가이드에서는 이 순서에 따라 각 단계에서 확인할 상태를 안내하므로, 가져오기 완료와 서비스 실행, 네트워크 연결 여부를 구분하기 쉽습니다.
단계별 구독 가져오기 →다운로드 / 기기별 선택
운영체제에 맞는 다운로드 페이지로 이동한 뒤 클라이언트, 프로세서 아키텍처, 설치 형식을 확인하세요. 다운로드 페이지에서 선택 가능한 소프트웨어와 시스템 요구 사항을 함께 살펴볼 수 있습니다. 기존 설정을 새 클라이언트로 옮길 때도 원본 파일을 먼저 보관하는 것이 좋습니다.
새로 설치한다면 먼저 Clash Plus를 살펴본 다음 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. Clash for Windows는 유지 관리가 중단된 보관용 옵션으로 안내합니다. 데스크톱에서 시스템 프록시를 켜면 시스템 프록시를 따르는 앱에 주로 적용됩니다. TUN은 이와 다른 트래픽 처리 방식이므로, 트레이 아이콘이 표시된다고 해서 트래픽이 프록시를 통과하는 것은 아닙니다. 설치 후 구독을 가져오고 정책을 선택한 다음, 실제 사용하는 앱에 따라 TUN을 활성화할지 결정하세요.
Clash Plus, Clash Meta for Android, FlClash, Surfboard 순으로 선택 가능한 클라이언트를 살펴보세요. 설치 파일은 기기 아키텍처에 맞아야 합니다. 설치되지 않으면 시스템 요구 사항과 기존 앱의 서명을 먼저 확인하세요. 처음 실행할 때 VPN 권한을 승인하고 시스템의 백그라운드 실행 제한도 확인해야 합니다. Surfboard는 Clash YAML과 다른 설정 형식을 사용하므로 같은 구독 주소를 모든 클라이언트에서 바로 읽을 수 있는 범용 파일로 간주하면 안 됩니다.
시스템의 ‘이 Mac에 관하여’에서 Apple 칩과 Intel 프로세서 중 무엇을 사용하는지 확인한 다음 알맞은 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash를 선택할 수 있으며 ClashX Meta는 유지 관리가 중단된 보관용 프로젝트로 표시됩니다. 설치 후 클라이언트 안내에 따라 시스템 프록시를 설정하거나 네트워크 서비스 권한을 부여하세요. 브라우저는 정상인데 터미널 명령은 여전히 직접 연결된다면 메뉴 막대의 실행 상태만 확인할 것이 아니라 터미널 도구의 프록시 설정도 별도로 확인해야 합니다.
iPhone과 iPad에서는 다운로드 페이지에서 Clash Plus의 App Store 상세 페이지로 이동할 수 있습니다. 제품 공식 사이트는 clashplus.io입니다. 설치 후 앱 화면의 안내에 따라 설정을 가져오고, 시스템에서 VPN 구성을 추가하라는 메시지를 확인하세요. 처음 연결을 테스트할 때는 사용 가능한 것으로 확인된 정책 하나만 사용하고 여러 트래픽 분기 옵션을 동시에 바꾸지 마세요. 시스템에 VPN 표시가 나타나면 트래픽 처리가 설정된 것이지만, 웹페이지 접속 여부는 구독, 출구, DNS 설정에 따라 달라집니다.
데스크톱 환경에서는 Clash Verge Rev와 FlClash를 먼저 비교하고, 배포판의 패키지 관리 방식에 맞는 설치 형식을 선택하세요. 서버, 라우터 또는 데스크톱 환경이 없는 기기라면 다운로드 페이지에서 Mihomo 코어를 확인할 수 있습니다. 코어를 실행하려면 설정 파일, 서비스 관리 방식, 네트워크 트래픽 처리 방식을 직접 준비해야 합니다. 실행 파일이 시작되었다고 해서 시스템 프록시까지 설정된 것은 아닙니다. 원격으로 작업하기 전에는 기존 연결을 유지해 라우팅 변경으로 관리 접속이 끊기지 않도록 하세요.
오픈 소스 / 프로젝트 및 코어
인터페이스, 코어, 구독은 서로 다른 요소입니다. 클라이언트를 선택할 때는 유지 관리 현황, 설정 호환성 순으로 확인한 뒤 기기의 트래픽 처리 방식을 조정하세요.
Clash for Android는 많은 안드로이드 사용자가 익숙하게 알고 있는 클라이언트 이름으로, 주요 기능은 홈 화면, 설정, 구성 메뉴에서 이용할 수 있습니다. 원본 프로젝트는 유지 관리가 중단되었으므로 오래된 가이드나 설치 파일을 찾았다면 과거 인터페이스와 현재 선택 가능한 소프트웨어를 구분해야 합니다. 이 사이트에서는 안드로이드 설정 개념을 안내하고 다운로드 페이지에서 다른 클라이언트도 소개합니다. 서로 다른 프로젝트를 동일한 소프트웨어의 업데이트 버전으로 취급하지 않습니다. Clash Meta for Android, FlClash 등은 각각 별개의 클라이언트 구현이므로 옮겨 사용할 때 메뉴 위치와 기능 지원 여부를 다시 확인하세요.
안정적으로 사용 중인 기존 설정은 먼저 내보내거나 백업한 뒤 새 클라이언트에 별도로 가져와 테스트할 수 있습니다. 기존 파일을 바로 덮어쓰거나 앱 이름이 비슷하다는 이유만으로 덮어 설치하지 마세요. 안드로이드 앱을 덮어 설치할 수 있는지는 패키지 이름과 서명에도 영향을 받습니다. 설치 충돌이 발생했다고 해서 반드시 기기 아키텍처를 잘못 선택한 것은 아닙니다. 이전이 끝나면 정책 그룹 이름, 규칙 적용 결과, 백그라운드 실행을 확인해 새 환경이 정상 작동하는지 확인한 뒤 필요 없는 클라이언트를 정리하세요. 클라이언트 비교 가이드에서는 차이를 살펴보고, 빠른 시작 가이드에서는 실제 사용 방법을 안내하므로 필요에 따라 각각 확인할 수 있습니다.
그래픽 클라이언트는 설정 관리, 메뉴 조작, 시스템 프록시, 플랫폼 연동을 담당하고 코어는 설정을 해석하고 연결을 처리합니다. Mihomo는 Clash 생태계의 오픈 소스 코어 프로젝트지만, 이름에 Clash가 포함된 모든 클라이언트가 같은 코어를 사용하거나 동일한 설정 항목을 지원하는 것은 아닙니다. 한 기기에서는 불러올 수 있는 설정이 다른 기기에서 오류를 내는 경우 코어 기능 차이뿐 아니라 클라이언트의 설정 변환이나 재정의가 원인일 수 있습니다. 판단할 때는 앱 아이콘이나 가이드 화면이 비슷한지만 보지 말고 구체적인 오류 메시지를 먼저 확인하세요.
일반적인 데스크톱 및 모바일 사용자는 인터페이스가 있는 클라이언트를 이용하는 편이 권한 승인과 정책 선택을 쉽게 마칠 수 있습니다. 서버나 라우터에 배포하거나 서비스를 직접 관리해야 할 때만 코어를 직접 실행하면 됩니다. 아래 명령은 Mihomo 소스 코드 저장소를 가리키며 구현, 빌드 안내, 이슈 논의를 확인하는 데 적합합니다. 저장소를 복제해도 안드로이드 앱이 설치되거나 사용할 수 있는 구독이 만들어지지는 않습니다. 저장소 자료는 소프트웨어 동작을 이해하는 데 활용하고, 실제 연결에는 유효한 설정과 적절한 시스템 네트워크 설정이 필요합니다.
git clone https://github.com/MetaCubeX/mihomo.git복사한 명령은 Git이 설치된 터미널에서 실행할 수 있습니다.
Mihomo 오픈 소스 저장소 보기 →구독 업데이트는 노드, 정책 그룹, 규칙을 다시 가져오고 소프트웨어 업데이트는 클라이언트나 코어 자체를 변경합니다. 두 작업은 서로 대체할 수 없습니다. 구독 업데이트에 실패하면 링크가 유효한지, 응답 내용이 대상 클라이언트에서 지원하는 형식인지 확인한 다음 네트워크와 DNS 오류를 살펴보세요. 다른 클라이언트를 설치한다고 만료된 링크가 다시 유효해지는 것은 아닙니다. 반대로 새 설정 항목을 인식하려면 최신 코어가 필요할 수 있습니다. 이때는 구독을 반복해서 새로고침하기보다 소프트웨어의 지원 여부를 확인하세요. 두 경로를 따로 점검하면 문제와 관계없는 변경을 줄일 수 있습니다.
변경하기 전에 현재 모드, 선택한 정책, 재정의 항목을 기록하고 업데이트 후 같은 대상으로 다시 테스트하세요. 원격 구독이 직접 수정한 로컬 내용을 덮어쓸 수 있으므로 계속 유지할 설정은 클라이언트가 지원하는 재정의 또는 병합 기능을 사용해야 합니다. 앱마다 구현 방식이 다르므로 스위치 이름이 같다고 효과까지 같다고 단정하지 마세요. 다운로드 페이지에서는 클라이언트 상세 정보에 확인 가능한 업데이트 정보만 표시합니다. 유지 관리 상태가 불분명한 프로젝트는 프로젝트의 릴리스 안내와 사용 중인 시스템과의 호환성을 함께 고려해 계속 사용할지 결정하세요.
VPN 표시, 서비스 실행 알림, 웹페이지 접속 성공은 각각 서로 다른 상태를 나타냅니다. 서비스가 시작되었다는 것은 로컬 서비스가 실행되었다는 뜻일 뿐, 노드가 작동하거나 모든 앱의 트래픽이 처리된다는 뜻은 아닙니다. 확인할 때는 먼저 기기 자체에서 네트워크에 정상적으로 접속할 수 있는지 살펴보고, 대상 웹페이지를 연 다음 연결 기록에 해당 연결이 표시되는지, 어떤 규칙이 적용되었는지, 어떤 정책 그룹을 선택했는지 확인하세요. 특정 앱만 문제가 있다면 접근 제어를 먼저 확인하고, 모든 도메인에 접속할 수 없다면 노드와 DNS를 차례로 살펴보세요. 일부 문제 때문에 설정 전체를 다시 만들 필요는 없습니다.
구독 링크에는 계정 관련 정보가 포함되는 경우가 많으므로 비밀번호처럼 안전하게 보관하세요. 전체 링크를 공개된 문의 게시판에 붙여 넣거나 설정 QR 코드, 인증 정보, 계정 정보가 보이는 화면을 공유하지 마세요. 다른 사람에게 문제를 설명할 때는 클라이언트 이름, 시스템 환경, 재현 단계, 민감한 정보를 삭제한 오류 메시지를 제공하면 됩니다. 오픈 소스 저장소에서는 구현을 살펴보고 문제를 논의할 수 있지만 구독을 제공하는 곳은 아닙니다. 이 사이트는 다운로드 링크와 설정 자료를 정리하며, 링크 만료, 사용량 초과, 노드 점검 등 계정 관련 문제는 서비스 제공업체에 문의해야 합니다.
먼저 서비스 제공업체에서 호환되는 구독 링크를 받은 다음 설정 페이지를 열고 URL에서 가져오기를 선택하세요. 이름과 링크를 입력해 저장한 뒤 다운로드가 완료되면 해당 설정을 선택합니다. 링크를 붙여 넣을 때는 중간에 공백이나 줄바꿈이 들어가지 않도록 전체를 복사하세요. 클라이언트가 노드를 자동으로 제공하지는 않습니다. 홈 화면으로 돌아가 서비스를 시작하고, 화면 조작 방법은 빠른 시작 가이드에서 확인하세요.
현재 설정과 정책 그룹이 선택되어 있는지 먼저 확인한 뒤 VPN 권한, 노드 상태, 앱 접근 제어, DNS를 살펴보세요. 테스트할 때는 설정을 한 번에 하나씩만 바꾸고 새 연결로 결과를 확인합니다. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 노드를 바꾼 뒤에는 대상 페이지를 다시 여세요. 시스템 절전 설정이 백그라운드 서비스를 중단할 수도 있습니다. 자세한 점검 방법은 안드로이드 연결 문제 해결 체크리스트를 확인하세요.
구독 형식, 코어에서 지원하는 설정 항목, 서비스 제공업체의 기기 제한을 먼저 확인하세요. Clash YAML은 모든 프록시 소프트웨어에서 쓸 수 있는 범용 형식이 아닙니다. 특히 Surfboard와 같은 클라이언트는 별도의 설정 요구 사항을 확인해야 합니다. 설정을 가져올 수 있더라도 시스템 프록시와 VPN 트래픽 처리 방식은 플랫폼마다 다릅니다. 이전하기 전에 원본 설정을 보관하고 전체 문서에서 플랫폼별 설정을 다시 확인하세요.
노트 / 설정 기록
링크 만료, 형식 비호환, 네트워크 차단, YAML 문법 오류의 네 가지 원인을 정리하고 클라이언트와 브라우저에서 구독 링크를 확인하는 구체적인 절차를 안내합니다.
노트 읽기 →코어 버전, 인터페이스, 구독 관리, TUN 지원, 유지 관리 현황의 다섯 가지 기준으로 주요 Clash 클라이언트를 비교하고 사용 환경별 선택 방법을 안내합니다.
노트 읽기 →VPN 권한, 프록시 모드, 노드 상태, DNS 하이재킹, 앱 접근 제어, 시스템 절전 설정을 차례로 확인해 연결됨으로 표시되지만 인터넷이 되지 않는 실제 원인을 찾습니다.
노트 읽기 →