오픈 소스 생태계 · 모든 플랫폼 클라이언트

Clash 안드로이드와 모든 플랫폼 클라이언트

공식 Clash 다운로드 가이드 보기

Clash Android 클라이언트, 구독 설정 단계 및 프로토콜 선택 안내를 한곳에서 확인하세요. 최초 연결은 시스템 VPN 권한 승인부터 시작하며, 이후 설정을 가져오고 정책을 선택한 다음 프록시 상태를 확인합니다.

영구 무료 오픈 소스 한국어 문서 mihomo 코어 참고

PLATFORM ENTRY

SYSTEM CAPABILITIES

시스템 트래픽 제어, 구독 및 규칙 분기

Android VPN 권한 승인부터 시작해 Clash 클라이언트가 담당하는 네트워크 작업을 단계별로 이해합니다. 왼쪽에서 기능을 선택하면 오른쪽에서 용도, 설정 위치와 주요 매개변수를 확인할 수 있습니다.

VPN 권한

Android 클라이언트는 시스템에서 제공하는 VpnService를 통해 로컬 가상 네트워크 인터페이스를 생성합니다. 프록시를 처음 시작하면 시스템에 연결 요청이 표시됩니다. 확인을 누르면 앱 트래픽이 Clash 코어로 전달되어 매칭됩니다. 권한 승인은 클라이언트가 네트워크 인터페이스를 제어하도록 허용하는 절차일 뿐, 사용 가능한 노드가 선택되었다는 뜻은 아닙니다. 연결 후에는 현재 Profile, 정책 그룹 선택 및 DNS 상태를 확인해야 합니다. 화면 상단에 VPN 표시가 없다면 클라이언트로 돌아가 서비스를 다시 시작한 뒤, 제조사 시스템의 백그라운드 실행 제한 여부를 확인하세요.

interface: VpnService · permission: user-confirmed · scope: local traffic

PLATFORM DOWNLOADS

5개 플랫폼 클라이언트 다운로드

설치 파일과 클라이언트 선택지는 운영체제별로 분류되어 있습니다. 먼저 기기 플랫폼과 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 해당 클라이언트, 시스템 요구 사항과 설치 방법을 확인하세요.

Windows

데스크톱에서 일상적으로 사용하기 좋습니다. 다운로드 페이지에는 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 및 보관된 클라이언트가 정리되어 있습니다. 설치 전에 시스템 아키텍처를 확인하고, 처음 실행한 뒤 구독을 가져와 시스템 프록시를 활성화하세요.

다운로드하기

macOS

Apple Silicon 및 Intel 기기용 다운로드 경로를 각각 제공합니다. 설치 후 처음 실행이 시스템에서 차단되면 개인정보 보호 및 보안 설정에서 허용 여부를 확인하세요. 메뉴 막대 클라이언트는 상시 실행에 적합하며, 정책과 구독은 계속 클라이언트 내부에서 관리합니다.

다운로드하기

Android

설치 후 먼저 시스템 VPN 권한을 승인하고 구독을 가져온 다음 정책 그룹을 선택하세요. 제조사별 시스템의 백그라운드 제한은 다르므로 장시간 사용할 때는 배터리 최적화, 백그라운드 활동 및 VPN 상시 실행 상태를 확인해야 합니다.

다운로드하기

iOS

앱 스토어에서 Clash Plus 페이지로 이동합니다. 설치 후 앱 안에서 설정을 추가하고 연결을 시작하면 시스템에 VPN 요청이 표시됩니다. 정책 전환, 연결 상태 및 설정 업데이트는 모두 클라이언트 화면에서 처리합니다.

다운로드하기

Linux

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

다운로드하기
모든 클라이언트 보기 →

QUICK START

최초 연결 3단계

설치와 설정을 먼저 마친 뒤 시스템 트래픽 제어를 시작하세요. 각 단계에서 하나의 상태만 처리하면 문제가 발생했을 때 어느 단계에서 멈췄는지 쉽게 판단할 수 있습니다.

  1. 01

    클라이언트 설치 및 필요한 권한 승인

    다운로드 페이지에서 해당 플랫폼으로 이동해 기기 아키텍처에 맞는 클라이언트를 선택하세요. Android는 처음 연결할 때 시스템 VPN 요청이 표시되며, Windows와 macOS에서는 방화벽, 네트워크 확장 또는 시스템 프록시 권한을 확인해야 할 수 있습니다. 이 단계에서는 시스템 권한만 처리하고 모드 전환이나 DNS 변경은 서두르지 마세요.

  2. 02

    구독 가져오기 및 Profile 선택

    설정 또는 Profiles 페이지를 열고 사용할 수 있는 구독 주소를 붙여 넣은 뒤 다운로드를 실행하세요. 설정이 표시되면 반드시 선택한 다음 프록시 그룹으로 이동해 목표 정책을 고릅니다. 업데이트에 실패하면 먼저 구독 주소에 접속할 수 있는지, 시스템 시간이 정확한지, 현재 네트워크에서 클라이언트 연결을 허용하는지 확인하세요.

  3. 03

    연결 시작 및 분기 상태 확인

    일반적인 시작점으로 규칙 모드를 유지하고 시스템 프록시 또는 VPN 서비스를 시작한 다음 연결 로그에서 트래픽이 들어오는지 확인하세요. 웹 페이지에 접속할 수 없다면 노드, DNS, 규칙 매칭 및 시스템 시간을 순서대로 점검합니다. 한 번에 하나만 변경하고 변경 후 다시 테스트해 여러 설정이 동시에 바뀌지 않도록 하세요.

전체 가이드 보기 →

OPEN SOURCE CONTEXT

Clash 생태계와 mihomo 코어

클라이언트 UI, 프록시 코어와 설정 데이터는 서로 다른 계층입니다. 이 세 계층의 관계를 이해하면 기능이 어느 부분에서 제공되는지 판단할 수 있고, 플랫폼 간 설정을 옮기기도 쉬워집니다.

프로젝트 역사

Clash는 프록시 노드, 정책 그룹, 규칙, DNS와 트래픽 제어 설정을 포함한 널리 사용되는 YAML 설정 구조를 만들어 왔습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티의 클라이언트와 코어는 이 구조를 계속 사용하고 확장했습니다. 현재 소프트웨어는 이름이 비슷해도 유지 관리자, UI 구현 방식과 코어 조합이 완전히 같지 않으므로 다운로드할 때 클라이언트 이름과 하위 코어를 구분해 확인해야 합니다.

오픈 소스 생태계

오픈 소스 저장소에서는 프로토콜 구현, 설정 파싱, 이슈 기록과 릴리스 과정을 공개적으로 확인할 수 있습니다. 데스크톱 및 모바일 클라이언트는 주로 설치, 구독 관리, 시스템 프록시, VPN 권한 승인과 시각적 조작을 담당하고, 코어는 연결, DNS, 규칙 매칭과 트래픽 전달을 담당합니다. 클라이언트에서 보이는 설정 항목은 최종적으로 코어가 읽을 수 있는 설정으로 변환됩니다.

코어 관계

mihomo는 Clash Meta의 기능 방향을 이어받아 프로토콜 지원, 규칙 세트, DNS, TUN과 설정 기능을 계속 발전시키고 있습니다. GUI 클라이언트마다 내장 코어가 다를 수 있으며 코어 교체를 허용하는 경우도 있습니다. 설정 호환성이 있다고 해서 모든 필드가 모든 클라이언트에서 같은 UI로 제공되는 것은 아니므로, 이전하기 전에 지원 필드, 오버라이드 방식과 구독 처리 방법을 확인해야 합니다.

업데이트 방식

클라이언트 업데이트, 코어 업데이트와 구독 업데이트는 서로 독립된 경로입니다. 클라이언트 업데이트는 UI와 플랫폼 연동을 바꾸고, 코어 업데이트는 프로토콜과 규칙 처리를 변경하며, 구독 업데이트는 원격에서 제공하는 노드와 정책 내용을 교체합니다. 업데이트 문제를 해결할 때는 먼저 어느 계층에서 실패했는지 확인하세요. 구독을 반복해서 새로 고치는 것만으로는 클라이언트 권한 문제나 코어 시작 실패를 해결할 수 없습니다.

COMMON QUESTIONS

연결 전후 주요 확인 사항

용어와 상태를 먼저 파악한 뒤 어떤 항목을 변경할지 결정하세요. 다음 질문은 처음 사용할 때 가장 자주 발생하는 오해를 다룹니다.

처음 시작할 때 연결 요청이 표시되는 이유

이는 Android VpnService의 시스템 권한 승인 단계입니다. 확인하면 클라이언트가 로컬 VPN 인터페이스를 생성하고 앱 트래픽을 코어로 전달할 수 있습니다. 권한 승인에 성공해도 노드를 사용할 수 있다는 뜻은 아니며, 설정과 정책 그룹을 선택하고 연결을 시작해야 합니다. 관련 용어는 용어집에서 확인할 수 있습니다.

구독을 가져온 뒤에도 프록시 트래픽이 없는 이유

구독 다운로드가 완료된 뒤에도 해당 Profile이 선택되었는지, 정책 그룹에 명확한 선택이 있는지, 시스템 프록시 또는 VPN 서비스가 실행 중인지 확인해야 합니다. 로그에 연결 기록이 없다면 문제는 대개 시스템 트래픽 제어 단계에 있습니다. 기록은 있지만 요청이 실패한다면 노드, DNS와 규칙 매칭을 확인하세요.

규칙 모드, 글로벌 모드와 직접 연결 모드 선택 방법

규칙 모드는 설정에 따라 트래픽별 출구를 결정하므로 일상적인 시작점으로 적합합니다. 글로벌 모드는 대부분의 트래픽을 선택한 정책으로 보내 단기 확인에 사용하고, 직접 연결 모드는 프록시를 거치지 않아 문제가 프록시 경로에서 발생했는지 판단할 때 유용합니다. 모드 정의와 매칭 순서는 용어집에서 더 확인할 수 있습니다.

연결됨으로 표시되지만 웹 페이지가 열리지 않을 때 먼저 확인할 항목

다음 순서로 확인하세요. 노드를 사용할 수 있는지, 시스템 시간이 정확한지, DNS가 정상적으로 해석되는지, 규칙이 예상한 정책에 매칭되는지, 다른 VPN이 시스템 인터페이스를 점유하고 있지 않은지 점검합니다. 한 번에 하나만 변경하고 다시 테스트하세요. 전체 과정은 8단계 문제 해결 체크리스트에서 확인할 수 있습니다.

LATEST GUIDES

설정 및 문제 해결 기록

시스템 프록시, Profile 구조와 클라이언트 비교를 중심으로 정리한 최신 글입니다. 제목이 구체적인 문제와 직접 연결되어 있어 현재 상태에 맞는 내용을 이어서 확인하기 쉽습니다.

문제 해결

시스템 프록시가 작동하지 않을 때: 브라우저는 프록시를 사용하지만 터미널은 사용하지 않는 원인과 확인 방법

시스템 프록시, 환경 변수와 TUN 모드는 서로 다른 트래픽 제어 경로입니다. 이 글에서는 브라우저와 터미널의 확인 방법을 각각 설명하고, 언제 더 포괄적인 트래픽 제어로 전환해야 하는지 안내합니다.

전체 글 읽기 →
입문 가이드

Clash 설정 파일이란? Profile 구조 분석과 여러 설정 전환 관리

노드, 정책 그룹, 규칙과 DNS 필드를 통해 Profile을 이해하고, 구독 업데이트, 여러 설정 공존, 오버라이드 항목 및 설정 전환 후 다시 확인해야 할 상태를 설명합니다.

전체 글 읽기 →
클라이언트 비교

안드로이드 Clash 클라이언트 추천: 주요 5개 클라이언트 비교 및 선택 가이드

코어, 구독 호환성, UI 조작, 플랫폼 지원 범위와 유지 관리 상태를 기준으로 주요 클라이언트를 비교해 Android 사용자가 실제 사용 환경에 맞는 선택 범위를 정할 수 있도록 돕습니다.

전체 글 읽기 →
모든 글 보기 →