Clash Meta for Android · 오픈 소스 mihomo 코어

Clash 안드로이드판Android 클라이언트 다운로드 및 설정

기기에 맞는 클라이언트를 선택한 다음 구독 가져오기, VPN 권한, 규칙 기반 라우팅을 설정하세요.

  • YAML 규칙 예제
  • 중국어 설정 문서
설정 문서 읽기

운영체제별 Clash 클라이언트 다운로드

먼저 기기의 운영체제를 선택한 뒤 프로세서 아키텍처와 설치 파일 형식을 확인하세요. 클라이언트를 바꾸기 전에 구독 주소나 설정 파일을 보관해 두면 다시 가져오기 편합니다.

설치 파일 선택 방법

휴대전화 프로세서가 64비트를 지원한다고 해서 운영체제가 모든 64비트 앱을 설치할 수 있는 것은 아닙니다. 다운로드 페이지에서 여러 아키텍처의 패키지를 제공한다면 운영체제가 실제로 지원하는 앱 아키텍처에 맞춰 선택하세요. 확실하지 않다면 해당 클라이언트에 범용 패키지가 있는지 먼저 확인하세요. 휴대전화 모델명에 표시된 숫자만으로 판단하면 안 됩니다. 같은 이름의 앱이 이미 설치되어 있어 충돌한다는 메시지가 나오면 먼저 설정을 백업하고 두 앱이 같은 배포 경로에서 제공되었는지 확인하세요.

기존 클라이언트에서 이전하는 방법

유지 관리가 중단된 Clash for Windows에서 옮길 때는 현재 활성화된 설정과 수동으로 선택한 정책 그룹을 먼저 기록하세요. 그런 다음 기존 구독이나 로컬 파일을 새 클라이언트로 가져오면 됩니다. 앱 데이터 폴더 전체를 그대로 복사하지 마세요. 기존 클라이언트가 남긴 시스템 프록시가 예전 포트를 가리킬 수 있으므로 전환 전에 기존 클라이언트의 트래픽 처리를 중지하세요. 같은 브라우저에서 새 요청을 보내고 새 클라이언트의 연결 기록에 요청이 표시되는지 확인하세요.

클라이언트의 라우팅 및 설정 기능

시스템 트래픽 처리, 규칙 매칭, 아웃바운드 선택을 각각 구분하세요. 한 단계가 정상이라고 해서 다음 단계도 정상인 것은 아닙니다.

먼저 트래픽이 클라이언트로 들어오는지 확인하세요

처음 연결할 때 Android 시스템 팝업에서 VPN 요청을 승인하세요. 권한을 허용하면 트래픽 처리 범위에 포함된 앱의 연결이 클라이언트로 전달되므로 앱마다 프록시 주소를 입력할 필요가 없습니다. 시스템에서 이미 다른 앱에 VPN 권한을 부여했을 수 있고, 업무 프로필에는 별도 제한이 적용될 수도 있습니다. 일부 앱에서만 적용되지 않는다면 먼저 클라이언트의 앱 트래픽 처리 범위를 확인한 다음 연결 기록을 살펴보세요. 전체 트래픽 처리란 트래픽이 클라이언트로 들어오는 방식을 뜻하며, 반드시 전역 프록시 모드를 사용해야 한다는 의미는 아닙니다. 규칙 모드에서는 트래픽을 규칙에 따라 직접 연결할 수도 있습니다.

최초 VPN 권한 설정 단계 보기 →
라우팅에 문제가 생기면 유입, 규칙, 아웃바운드 순으로 확인하세요
증상먼저 확인할 항목재현 및 확인 방법
연결 기록에 요청이 표시되지 않음시스템에서 권한을 허용했는지, 대상 앱이 트래픽 처리 범위에 포함되는지 확인하세요. 데스크톱에서는 앱이 시스템 프록시를 사용하는지도 확인해야 합니다.앱에서 현재 열려 있는 페이지를 닫고 다시 여세요. 전후 로그를 비교해 해당 대상 주소가 표시되는지 확인하세요.
기록은 있지만 규칙이 예상과 다름현재 실행 모드가 규칙 모드인지 확인하세요. 구체적인 규칙이 앞의 일반 규칙에 가려지지 않았는지, 설정을 다시 불러왔는지도 확인해야 합니다.같은 앱으로 같은 대상에 접속하되 네트워크와 정책 그룹은 그대로 두고, 새 연결 기록에 표시된 규칙 이름을 확인하세요.
규칙은 일치하지만 연결에 실패함도메인 조회 실패, 아웃바운드 연결 실패, 앱 응답 시간 초과를 구분하세요. 규칙이 일치했다는 것은 아웃바운드가 선택되었다는 뜻이지 데이터가 목적지에 도달했다는 뜻은 아닙니다.트래픽 처리 방식과 규칙은 그대로 두고 해당 정책 그룹의 아웃바운드만 바꿔 오류가 달라지는지 확인하세요.

오픈 소스 프로젝트 및 설정 자료

업스트림 소스 코드와 변경 기록, 클라이언트 문서를 참고해 기능을 확인하세요. 다운로드 경로, 코어 지원 기능, 구독 서비스는 서로 별개의 항목입니다.

기존 Clash, Clash.Meta 및 mihomo

초기 Clash는 지금도 볼 수 있는 여러 설정 방식을 정립했습니다. 노드를 한곳에 정의하고, 정책 그룹으로 아웃바운드를 구성하며, 규칙에서 순서대로 정책을 참조하는 방식입니다. Clash.Meta는 이 기반을 확장했으며 이후 mihomo라는 이름으로 유지 관리되고 있습니다. 오래된 가이드에는 앞의 두 이름이 계속 등장합니다. 같은 설정 키가 나온다면 기본 용도를 이해하는 데 참고할 수 있지만 기본값, 지원 범위, 적용 조건까지 완전히 같다고 가정해서는 안 됩니다. 문제를 해결할 때는 현재 클라이언트에서 사용하는 코어 종류를 확인한 뒤 해당 프로젝트의 자료를 찾아보세요.

클라이언트와 코어의 역할

Clash Meta for Android는 설정 관리와 Android의 VPN 연결을 담당하고, mihomo는 설정을 파싱하고 규칙을 매칭하며 아웃바운드 연결을 처리합니다. 설정 파일을 저장할 수 있다는 것은 파일이 클라이언트에 들어갔다는 뜻일 뿐입니다. 설정을 불러올 수 있는지, 규칙이 일치하는지는 코어 실행 기록도 확인해야 합니다. 반대로 시스템 권한이 허용되지 않았거나 배터리 절약 기능이 백그라운드 서비스를 종료했다면 YAML의 아웃바운드를 수정해도 해결되지 않을 수 있습니다. 문제를 제보하기 전에 이 두 계층을 구분하세요. 설치, 시스템 권한 팝업, 화면 관련 문제는 클라이언트 프로젝트를 확인하고, 필드, 규칙, 연결 파싱 문제는 코어 자료를 확인하세요.

커뮤니티 자료 확인 방법

업스트림 저장소에서 소스 코드와 커밋 기록을 확인하고 이슈에서 같은 오류를 검색할 수 있습니다. 검색할 때는 구체적인 필드 이름과 오류 유형을 유지하고, 먼저 해당 논의의 플랫폼과 실행 방식을 확인하세요. 예를 들어 데스크톱에서 시스템 프록시가 정상 작동한다고 해서 Android VPN 트래픽 처리 설정까지 올바르다는 뜻은 아닙니다. 문제를 재현할 때는 최소 설정, 작업 순서, 민감 정보를 가린 오류 일부를 남기세요. 공개 기록을 올리기 전에 구독 주소, 프록시 인증 정보, 개인 도메인을 삭제하세요. 연결 로그의 대상 정보도 실제 방문 내용을 드러낼 수 있습니다.

업데이트 전에 정상 작동하는 설정 보관

클라이언트 설치 파일, 코어 변경 사항, 구독 내용은 각각 다른 주기로 업데이트됩니다. 클라이언트 업데이트로 코어가 바뀔 수 있고, 구독을 새로고침하면 노드 이름, 정책 그룹, 규칙 순서가 달라질 수 있습니다. 업데이트 후 라우팅이 달라졌다면 현재 파일을 먼저 백업하고 이전에 정상 작동하던 사본도 보관하세요. 변경 내역과 설정 차이를 비교하고 클라이언트 재설치, 구독 새로고침, DNS 변경을 동시에 하지 마세요. 한 번에 한 항목만 변경한 뒤 같은 네트워크와 앱, 대상 주소로 다시 테스트하면 문제 범위를 좁힐 수 있습니다.

설치 및 설정 FAQ

설치를 마쳤는데 정책 그룹이 비어 있는 이유는 무엇인가요?
설치 파일에는 클라이언트가 포함되며 정책 그룹은 현재 사용 중인 설정에서 가져옵니다. 먼저 구독을 정상적으로 가져왔고 활성화했는지 확인하세요. 파일을 목록에 가져오기만 해서는 현재 실행 중인 설정이 바뀌지 않습니다.
VPN 아이콘이 표시되는데 일부 요청이 직접 연결되는 이유는 무엇인가요?
VPN 아이콘은 시스템에서 VPN 연결이 설정되었다는 뜻입니다. 클라이언트로 들어온 요청도 DIRECT 규칙에 일치하면 직접 연결됩니다. 먼저 요청이 연결 기록에 표시되는지 확인한 다음 일치한 정책을 살펴보세요.
Wi-Fi를 바꾼 뒤에만 문제가 생기면 무엇을 먼저 확인해야 하나요?
먼저 새 네트워크에서 인증이 필요한지, 도메인 조회가 정상인지 확인한 다음 클라이언트가 연결을 다시 설정했는지 살펴보세요. 기존 규칙을 그대로 둔 채 다시 테스트하면 네트워크 변경과 설정 변경을 구분할 수 있습니다.
포트를 바꿨는데 터미널에서 계속 예전 주소를 사용하는 이유는 무엇인가요?
이미 열려 있는 터미널이 이전 프록시 환경 변수를 계속 사용하고 있을 수 있습니다. 해당 터미널 세션과 명령 자체의 프록시 설정을 확인하세요. 시스템 프록시의 새 포트가 터미널에 자동으로 반영되지는 않을 수 있습니다.

기술 노트

실제 증상에 따라 백그라운드 전환 후 연결 끊김, 데스크톱 앱의 프록시 우회, 예상과 다른 도메인 조회 경로를 확인하세요.

Clash Meta for Android 백그라운드 실행 유지: VpnService 권한 및 배터리 절약 예외 설정

VpnService 권한 팝업의 의미, 제조사별 배터리 절약 기능이 백그라운드 연결을 종료하는 이유, 배터리 최적화 예외 및 자동 시작 설정 방법을 항목별로 설명합니다.

백그라운드 실행 유지 설정 보기 →

시스템 프록시를 켰는데 작동하지 않을 때: 브라우저와 명령줄 터미널 따로 점검하기

브라우저 확장 프로그램의 프록시 설정 간섭, 시스템 프록시를 사용하지 않는 터미널, 포트 불일치가 흔한 원인입니다. 브라우저와 터미널을 나눠 점검 순서와 환경 변수 설정 방법을 안내합니다.

시스템 프록시 문제 해결 방법 보기 →

Clash DNS 누출 테스트 방법과 fake-ip, nameserver-policy 설정으로 DNS 누출 방지

먼저 테스트 페이지에서 DNS 요청 경로를 확인한 뒤 enhanced-mode, fallback, nameserver-policy 설정을 조정하세요. 바로 비교할 수 있는 YAML 예제를 제공합니다.

DNS 설정 문제 해결 방법 보기 →