오픈 소스 프로젝트 · Android 클라이언트 지속 업데이트

Clash Android 버전
클라이언트 및 설정 가이드

Clash 다운로드 가이드 보기

Clash Meta for Android, mihomo 코어, 구독 및 규칙 설정을 한곳에서 확인하세요. 먼저 플랫폼에 맞는 클라이언트를 선택한 뒤 가이드에 따라 설정을 가져오고 정책과 트래픽 제어를 구성하면 됩니다.

영구 무료 오픈 소스 한국어 문서 규칙 기반 분할 라우팅

플랫폼 바로가기

기기에 맞는 Clash 클라이언트 선택

운영체제마다 설치 형식과 트래픽 제어 인터페이스가 다릅니다. 여기서는 플랫폼별 다운로드 경로와 선택 기준만 안내하며, 클라이언트 목록·지원 상태·시스템 요구 사항·설치 파일은 다운로드 페이지에서 한곳에 확인할 수 있습니다. 기존 구성 파일은 여러 기기에서 재사용할 수 있지만 시스템 프록시, TUN 권한, 부팅 시 자동 시작은 각 기기에서 별도로 설정해야 합니다.

Windows

데스크톱에서 일상적으로 사용하기 좋으며 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu와 보관된 클라이언트 중에서 선택할 수 있습니다. 그래픽 클라이언트는 트레이 제어, 시스템 프록시, 구성 전환, 로그 확인을 담당합니다.

다운로드 페이지로 이동

macOS

Intel 및 Apple Silicon 기기에 적합합니다. 설치 전에 프로세서 아키텍처를 확인하고 알맞은 빌드를 선택하세요. 클라이언트에서 메뉴 막대 상태, 시스템 프록시, 구성 구독을 관리할 수 있으며, 처음 트래픽 제어 기능을 켤 때 시스템 권한을 확인해야 합니다.

다운로드 페이지로 이동

Android

휴대전화와 태블릿에 적합합니다. 시스템 VPN 인터페이스로 프록시를 실행하거나 TUN을 켜서 앱 트래픽을 제어할 수 있습니다. 구독을 가져온 뒤 유효한 구성을 선택하고 정책 그룹을 확인한 다음 홈으로 돌아가 서비스를 시작하세요.

다운로드 페이지로 이동

iOS

App Store에서 Clash Plus를 받고 시스템 네트워크 확장으로 연결을 구성합니다. 구독, 정책 그룹, 규칙을 중심으로 하는 설정 방식은 다른 플랫폼과 같지만, 권한 확인과 백그라운드 실행은 iOS가 관리합니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 그래픽 인터페이스가 있는 클라이언트를 선택할 수 있고, 서버와 라우터 환경에서는 mihomo 코어를 직접 실행하는 방식이 더 적합합니다. 설치 전에 배포판 패키지 형식, 프로세서 아키텍처, 서비스 관리 방식을 확인해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →

설정 기능

구독 가져오기부터 트래픽 제어까지

Clash 설정은 프록시 노드 하나를 선택하는 데서 끝나지 않습니다. 전체 흐름은 구성 출처, 정책 그룹 결정, 규칙 매칭, DNS 해석, 시스템 트래픽 진입점으로 이어집니다. 아래 네 가지 탭에서 각 모듈의 역할을 빠르게 확인한 뒤 실제 설정 순서에 맞춰 자세히 살펴보세요.

정책 선택 계층

정책 그룹으로 프록시 선택 로직 구성

select는 수동 선택에, url-test는 후보 프록시 자동 테스트에, fallback은 순서에 따른 사용 가능한 항목 전환에, load-balance는 여러 후보에 연결을 분배하는 데 적합합니다. 규칙은 특정 노드가 아니라 정책 그룹 이름을 참조하므로 구독을 바꾸거나 선택 방식을 조정해도 전체 규칙을 다시 작성할 필요가 없습니다.

정책 그룹

노드 선택과 규칙 참조를 분리

정책 그룹은 구성 파일의 의사 결정 계층입니다. 규칙은 트래픽을 안정적인 그룹 이름으로 전달하고, 그룹 내부에서 사용할 프록시와 자동 테스트 여부를 결정하거나 기본 항목이 실패할 때 순서대로 대체합니다. 이렇게 하면 “어떤 요청을 이곳으로 보낼지”와 “현재 이곳에서 무엇을 선택할지”를 별개의 문제로 나눌 수 있습니다.

일상적으로는 먼저 프록시 페이지에서 정책 그룹을 확인한 다음 해당 그룹에서 프록시나 하위 정책을 선택합니다. 고정 선택이 필요하면 select를, 후보 중 클라이언트가 자동으로 판단하게 하려면 url-test를, 사용 가능 순서를 중시하면 fallback을 사용하세요. 정책 그룹을 너무 깊게 중첩하지 말고, 이름은 안정적으로 유지하며 용도를 바로 알 수 있게 정하는 것이 좋습니다.

proxy-groups config.yaml
  • select프록시 또는 하위 정책 수동 선택
  • url-test테스트 결과에 따라 후보 선택
  • fallback구성 순서에 따라 차례로 대체
  • load-balance후보 간 연결 분배

규칙 설정

순서대로 요청 분할 라우팅 구성

규칙 엔진은 첫 줄부터 판단하며 일치하면 아래 규칙을 더 이상 확인하지 않습니다. 도메인 접미사 규칙은 같은 사이트의 여러 하위 도메인을 처리하는 데 적합하고, 정확한 도메인 규칙은 특정 호스트를 개별 처리합니다. IP 및 GEOIP 규칙은 주소가 확인된 연결을 다루며, 마지막으로 MATCH가 앞에서 일치하지 않은 트래픽을 받습니다.

사용자 지정 규칙을 관리할 때는 범위가 좁고 우선순위가 높은 항목을 먼저 작성한 뒤 지역 규칙과 대체 규칙을 배치하세요. 규칙 오른쪽에는 반드시 기존 정책 그룹 이름을 참조해야 합니다. 구독을 가져온 뒤 “구성은 시작되지만 특정 사이트의 연결 경로가 이상한” 경우에는 노드를 반복해서 바꾸기보다 먼저 규칙 순서와 그룹 이름을 확인하세요.

rules 위에서 아래로 매칭 
DOMAIN,example.org,수동 선택
DOMAIN-SUFFIX,example.net,자동 선택
GEOIP,CN,DIRECT
MATCH,수동 선택

정확한 매칭을 포괄적인 매칭보다 앞에 두고, 마지막에는 대체 규칙 하나를 남겨 두세요.

TUN 및 DNS

시스템 프록시가 처리하지 못하는 트래픽 제어

일부 Android 앱은 기존 시스템 프록시 설정을 읽지 않으며, UDP 요청에도 더 완전한 트래픽 진입점이 필요할 수 있습니다. TUN 모드는 시스템 VPN 인터페이스로 가상 네트워크 카드를 만들어 앱 연결을 먼저 클라이언트로 전달하고, mihomo가 규칙에 따라 처리하게 합니다. 활성화하면 시스템에 VPN 권한 확인 창이 표시되며, 이는 Android가 네트워크 제어 권한을 제공하는 표준 절차입니다.

DNS와 TUN은 함께 점검해야 합니다. Fake-IP는 매핑 주소로 도메인 정보를 유지하고, DNS 하이재킹은 지정 포트의 해석 요청을 코어로 전달하며, 자동 라우팅은 필요한 경로를 추가하고 엄격한 라우팅은 우회 트래픽을 줄입니다. 연결 후 일부 앱만 이상하다면 로그에서 요청이 TUN으로 들어왔는지 확인하고 기기에서 동시에 실행 중인 다른 VPN 서비스도 점검하세요.

트래픽 제어 Android VPN API
TUN 모드
자동 라우팅
엄격한 라우팅
DNS 하이재킹
Fake-IP

구독 업데이트

원격 구성과 로컬 오버라이드의 역할 분리

구독은 원격 구성 배포를 담당하고 로컬 오버라이드는 기기별 조정을 담당합니다. 구독을 가져온 뒤 일정한 간격으로 원격 내용을 확인하면서 기기별 DNS, TUN, 포트, 규칙 수정은 오버라이드 계층에 유지할 수 있습니다. 따라서 구독이 업데이트될 때 원격 파일에서 생성된 본문을 직접 편집할 필요가 없습니다.

자동 업데이트가 업데이트 후 점검을 생략해도 된다는 뜻은 아닙니다. 구독 구조가 크게 바뀔 때마다 현재 구성이 계속 선택되어 있는지, 자주 쓰는 정책 그룹이 존재하는지, 로컬 오버라이드가 참조하는 필드가 유효한지 확인하세요. 업데이트에 실패하면 같은 주소를 반복해서 가져오기보다 구독 주소, 네트워크 연결, 구성 문법, 저장소 권한 순서로 점검하는 편이 원인을 찾기 쉽습니다.

구성 관리 구독 설정
구성 자동 업데이트 사용 설정됨
업데이트 간격 1440분
오버라이드 적용 순서 구독 → 로컬 오버라이드
업데이트 방식 자동 및 수동

시작하기

설치 후 완료할 세 단계

처음부터 모든 고급 매개변수를 수정할 필요는 없습니다. 구성 가져오기, 정책 확인, 서비스 시작 순서로 기본 흐름을 완료하고 정상적으로 연결되는지 확인한 뒤, 앱 적용 범위에 따라 TUN, DNS 하이재킹 또는 사용자 지정 규칙을 활성화하세요.

  1. 01

    구독 또는 로컬 구성 가져오기

    클라이언트의 “구성” 메뉴를 열고 URL에서 구독을 가져오거나 기기에 있는 YAML 구성 파일을 읽으세요. 가져오기가 끝나면 구성 목록에서 해당 항목을 눌러 현재 구성으로 지정해야 합니다. 파싱에 실패하면 오류 메시지에 표시된 필드와 줄 번호부터 확인하고, 문법을 확인하기 전에는 반복해서 시작하지 마세요.

  2. 02

    정책 그룹 및 실행 모드 확인

    “프록시” 페이지에서 구성에 제공된 정책 그룹을 확인하고, 수동 선택이 필요한 그룹에는 프록시 또는 하위 정책을 지정하세요. 규칙 모드는 대부분의 일상적인 구성에 적합하며 규칙에 따라 트래픽 경로를 결정합니다. 전역 모드는 제어 가능한 트래픽을 하나의 정책으로 모으고, 직접 연결 모드는 설정의 영향을 임시로 제외할 때 사용합니다.

  3. 03

    서비스 시작 후 로그 확인

    홈으로 돌아가 “시작”을 누르고 처음 실행할 때 Android VPN 권한을 확인하세요. 그런 다음 인터넷이 필요한 앱을 열어 연결을 테스트합니다. 일부 요청만 이상하다면 로그 페이지에서 연결 대상, 일치한 규칙, 사용된 정책 그룹을 확인할 수 있습니다. 이를 바탕으로 문제가 DNS, 규칙, 정책 선택, 원격 연결 중 어디에 있는지 판단하세요.

전체 가이드 보기 →

오픈 소스 생태계

Clash 설정 체계와 mihomo 코어

Clash 생태계에는 프록시, 정책 그룹, 규칙, DNS, 트래픽 스니핑, 외부 제어 등을 포함한 널리 사용되는 YAML 구성 구조가 자리 잡았습니다. 그래픽 클라이언트마다 화면 배치는 다를 수 있지만 핵심 작업 흐름은 대체로 같습니다. 클라이언트는 구성 관리와 시스템 연동을 담당하고, 코어는 구성을 해석하고 연결을 받아 분할 라우팅을 실행합니다.

mihomo는 Clash Meta의 코어 기능을 계승하고 확장했습니다. Android, Windows, macOS, Linux의 여러 클라이언트가 이 코어를 기반으로 그래픽 인터페이스를 제공하므로, 특정 화면의 버튼 위치를 외우기보다 정책 그룹, 규칙 순서, DNS와 TUN의 관계를 이해하는 편이 오래 도움이 됩니다. 클라이언트를 바꿔도 대부분의 설정 지식은 계속 활용할 수 있습니다.

프로젝트 코드, 이슈 기록, 변경 논의는 코드 호스팅 플랫폼에 공개되어 있습니다. 구성 필드가 바뀌면 먼저 현재 코어 문서와 클라이언트 설명을 확인하세요. 클라이언트 화면 문제는 해당 클라이언트의 유지 관리 정보를 확인해야 합니다. 코어와 그래픽 클라이언트는 서로 다른 프로젝트이므로 업데이트 주기, 지원 필드, 시스템 연동 방식을 혼동해서는 안 됩니다.

이 사이트는 “다운로드 경로, 빠른 가이드, 개념 빠른 참조, 고급 설정, 문제 해결” 순서로 내용을 정리했습니다. 다운로드 페이지에서는 플랫폼과 클라이언트를 확인하고, 시작하기 페이지에서는 첫 연결을 완료합니다. 개념 빠른 참조에서는 용어를 설명하며, 고급 설정에서는 정책 그룹, 규칙 집합, DNS, TUN, Fake-IP, 스니핑, 로컬 오버라이드의 관계를 다룹니다.

자주 묻는 질문

설치와 설정 전에 확인할 개념

처음 설정할 때 발생하는 대부분의 문제는 설치 파일 자체보다 현재 구성, 정책 그룹 선택, 시스템 제어 방식, DNS 설정이 완전한 흐름을 이루지 못해서 생깁니다. 아래 네 가지 질문은 가장 자주 확인하는 판단 기준을 정리한 것입니다.

Clash와 mihomo는 어떤 관계인가요?

Clash는 일반적으로 구성 체계와 클라이언트 생태계를 가리키고, mihomo는 지속적으로 유지 관리되는 코어 프로젝트 중 하나입니다. 그래픽 클라이언트는 코어를 호출해 연결을 처리하며 구독 관리, 정책 선택, 로그, 시스템 권한 메뉴를 제공합니다.

핵심 개념 보기 →

구독을 가져온 뒤 왜 연결되지 않나요?

가져오기는 구성 저장만 완료한 상태입니다. 해당 구성을 현재 구성으로 지정하고 정책 그룹에 사용할 수 있는 선택지가 있는지 확인한 다음 홈으로 돌아가 서비스를 시작해야 합니다. Android에서는 처음 시작할 때 시스템 VPN 권한도 확인해야 합니다.

가져오기 단계 보기 →

시스템 프록시와 TUN 모드는 어떻게 선택하나요?

시스템 프록시는 프록시 설정을 읽는 앱을 주로 처리하고, TUN은 가상 네트워크 카드를 통해 더 폭넓은 트래픽을 받습니다. Android 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 제어하므로, 활성화하기 전에 해당 인터페이스를 사용 중인 다른 서비스를 종료해야 합니다.

트래픽 제어 용어 보기 →

구성을 업데이트한 뒤 규칙이 왜 작동하지 않나요?

원격 구성에서 정책 그룹 이름, 규칙 집합 참조, DNS 필드를 변경했을 수 있습니다. 로컬 오버라이드가 이전 이름을 계속 참조하면 업데이트는 성공했지만 동작이 달라질 수 있습니다. 로그와 새 구성을 대조해 참조 관계를 항목별로 확인하세요.

고급 설정 보기 →

설정 문서

최근 Clash Android 사용 가이드

문서는 문제 해결, 클라이언트 전환, 화면 조작을 각각 나누어 설명합니다. 연결 문제가 생기면 먼저 문제 해결 순서를 확인하고, 클라이언트 구조를 이해해야 할 때 화면 및 코어 관련 문서를 읽으세요. 로그 근거 없이 여러 매개변수를 동시에 바꾸는 일은 피하는 것이 좋습니다.

문제 해결

Clash Android 버전에서 속도가 느릴 때 해결하는 법: 노드·회선·로컬 설정 3단계 점검

노드 품질, 회선 혼잡, 휴대전화 로컬 설정을 차례로 점검하고 정책 그룹 전환과 DNS 확인을 병행해 Android에서 속도가 달라지는 실제 원인을 찾습니다.

전체 글 읽기
문제 해결

Clash는 연결됐지만 인터넷이 안 될 때: Android 단계별 점검 목록

구독 상태, 정책 그룹 선택, DNS 해석, 시스템 프록시와 TUN 충돌, 앱별 분할 라우팅 설정 순서로 확인해 연결은 시작됐지만 웹페이지가 열리지 않는 문제를 해결합니다.

전체 글 읽기
클라이언트 선택

Clash for Windows 지원 종료 후 대처법: mihomo 코어 클라이언트로 이전하는 완벽 가이드

지원 종료 이후의 클라이언트 선택지를 정리하고 구성 파일과 구독을 이전하는 방법, 조정이 필요한 필드, 데스크톱과 Android 기기에서 설정 로직을 일관되게 유지하는 방법을 설명합니다.

전체 글 읽기
전체 글 보기 →