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

Clash 안드로이드다운로드 및 설정

구독 가져오기부터 규칙 분기까지, Android 시스템 설정에 따라 권한을 허용한 뒤 프록시 서비스에 연결하세요.

오픈 소스 코드규칙 설정한국어 문서
ClashVPN 사용 중
규칙 모드Rule
구독자동 업데이트
배터리 최적화제한 없음

Clash Meta for Android
프록시 서비스 실행 중

설정 예시 · 실제 메뉴 위치는 클라이언트와 시스템에 따라 다릅니다

설정 형식 YAML 규칙 커널 mihomo Android 인터페이스 VpnService

규칙 분기와 시스템 연결

먼저 트래픽이 클라이언트로 들어오는 방식을 파악한 다음, 설정에 따라 어떤 출구로 전달되는지 확인하세요. 서비스 실행, 노드 사용 가능 여부, 규칙 일치는 서로 다른 단계입니다.

규칙 모드: 연결별 출구 선택

규칙 분기 · mihomo 커널

클라이언트에서 모드 선택을 열고 먼저 Rule을 선택하세요. 설정의 규칙을 순서대로 검사한 뒤 연결을 직접 연결, 프록시 정책 그룹 또는 차단으로 처리합니다. 정책 그룹은 여러 출구를 묶은 것입니다. 특정 노드를 선택해도 모든 연결이 그 노드를 통과하는 것은 아닙니다. 규칙 적용 여부를 확인하려면 상태 표시줄의 VPN 아이콘만 보지 말고 연결 기록에서 대상 도메인, 일치한 규칙, 최종 출구를 확인하세요.

자주 이용하는 사이트는 직접 연결로 두고, 프록시가 필요한 연결은 해당 정책 그룹으로 보내면 됩니다. 사용자 지정 규칙은 적절한 위치에 추가하고, 기존 LAN 규칙을 임의로 건너뛰지 마세요. 특정 앱에서만 문제가 생긴다면 먼저 연결 기록을 확인한 뒤 해당 도메인이나 앱 설정을 조정하세요. 모든 연결을 프록시로 바꾸면 LAN 기기 접근에도 문제가 생길 수 있습니다.

일치한 결과에서 규칙 찾기

연결 페이지에서 방금 연 사이트를 찾아 규칙 이름과 정책 경로를 확인하세요. 최종 기본 규칙에 일치했다면 앞선 항목에서 대상과 일치하지 않았을 가능성이 큽니다. 도메인 규칙과 IP 규칙은 검사 대상이 다르며 DNS 해석 방식도 결과에 영향을 줍니다. 수정 전 기존 항목을 기록하고 한 번에 하나씩 바꾼 뒤 다시 연결해 보세요. 기존 연결은 이전 출구를 계속 사용할 수 있으므로 정책을 바꾼 후에는 페이지를 다시 열어 확인해야 합니다. 노드를 계속 바꾸는 것보다 규칙 문제와 원격 연결 문제를 구분하기 쉽습니다.

VpnService 권한

Android 시스템 기능 · 로컬 VPN 인터페이스

처음 시작을 누르면 Android VPN 연결 요청이 표시됩니다. 앱 이름을 확인한 뒤 연결을 허용해야 클라이언트가 기기 트래픽을 받을 수 있습니다. 여기서 VPN은 시스템이 제공하는 로컬 인터페이스를 뜻하며 원격 서비스가 자동으로 제공되는 것은 아닙니다. 유효한 설정을 가져오고 사용할 수 있는 출구를 선택해야 합니다. 일반적으로 같은 사용자 공간에서는 VPN 서비스를 하나만 실행할 수 있어 다른 VPN 앱과 충돌할 수 있습니다. 권한 창이 반복해서 뜬다면 다른 서비스가 연결을 제어 중인지 먼저 확인하세요.

구독 가져오기와 업데이트

설정 관리 · URL 가져오기

설정 페이지에서 URL 가져오기를 선택하고 구성 제공자가 안내한 구독 주소를 붙여 넣으세요. 저장한 뒤 다운로드가 완료될 때까지 기다리고 해당 설정을 현재 설정으로 선택합니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 스크린샷, 댓글, 공개 저장소에 올리지 마세요. 자동 업데이트는 새 콘텐츠를 가져오는 기능일 뿐 구독이 계속 유효하다는 보장은 아닙니다. 정책 그룹이 갑자기 비었다면 업데이트 결과와 만료 여부를 확인한 다음 현재 커널이 설정 형식을 지원하는지 살펴보세요.

TUN과 트래픽 처리

가상 네트워크 인터페이스 · 시스템 프록시 외 방식

TUN은 시스템 프록시 설정을 따르지 않는 연결을 받아 처리할 때 쓰는 가상 네트워크 인터페이스입니다. 데스크톱에서 활성화하려면 관리자 권한이나 서비스 구성 요소가 필요할 수 있습니다. Android 클라이언트는 보통 VpnService로 기기 트래픽을 연결하므로 화면에 같은 이름의 스위치가 없을 수도 있습니다. 먼저 기본 설정으로 동작을 확인한 뒤 필요한 경우 조정하세요. TUN을 켜도 작동하지 않는 노드가 자동으로 복구되지는 않습니다. 라우팅, DNS, LAN 접근이 예상대로 작동하는지도 확인해야 합니다.

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

먼저 운영체제를 확인한 다음 설치 파일의 아키텍처를 선택하세요. 여기서는 플랫폼별 다운로드 페이지로 이동하며, 구체적인 클라이언트와 시스템 요구 사항, 유지 관리 상태는 다운로드 페이지에서 확인할 수 있습니다.

Windows

데스크톱 GUI, 정책 그룹 선택, 시스템 프록시 설정이 필요한 사용자에게 적합합니다. Clash Plus, Clash Verge Rev 등의 클라이언트를 선택할 수 있습니다. 설치 후 설정을 가져온 다음 시스템 프록시를 켜세요. 터미널이나 특정 앱에서만 작동하지 않는다면 해당 프로그램이 시스템 프록시 설정을 읽는지 확인해야 합니다. 브라우저에서 접속된다는 이유만으로 모든 프로그램이 연결됐다고 판단하지 마세요.

다운로드 페이지로 이동 Windows 클라이언트

macOS

다운로드 전에 ‘이 Mac에 관하여’에서 칩 종류를 확인하고 Apple Silicon용과 Intel용 설치 파일을 구분하세요. 처음 실행할 때 시스템 안내에 따라 권한을 처리한 뒤 클라이언트에서 설정을 가져옵니다. 시스템 프록시와 TUN은 서로 다른 트래픽 처리 방식입니다. 프린터, 개발 서버 등 LAN 기기에 접근해야 한다면 활성화한 뒤 해당 주소에 정상적으로 연결되는지도 확인하세요.

다운로드 페이지로 이동 macOS 클라이언트

Android

최근 출시된 스마트폰은 대부분 ARM64 아키텍처를 사용합니다. 구형 기기는 프로세서와 시스템 요구 사항을 먼저 확인하세요. Clash Plus, Clash Meta for Android, FlClash 등을 선택할 수 있습니다. 설치 후 구독, VPN 권한, 배터리 제한을 차례로 설정하세요. 백그라운드 관리 메뉴는 제조사별로 다르므로 화면을 잠근 뒤 연결이 끊기면 앱 정보의 배터리 및 백그라운드 네트워크 설정부터 확인하세요.

다운로드 페이지로 이동 Android 클라이언트

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하거나 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 클라이언트 안내에 따라 설정을 추가하고 시스템 VPN 권한을 허용하세요. 휴대폰과 컴퓨터에서 같은 설정 출처를 사용할 수 있지만, 구성 제공자가 허용하는 기기 수와 동시 연결 제한을 확인해야 합니다. 데스크톱의 스크립트나 로컬 파일 경로를 휴대폰에서 그대로 사용할 수는 없습니다.

다운로드 페이지로 이동 iOS 클라이언트

Linux

데스크톱에서는 Clash Verge Rev와 FlClash부터 살펴보고 배포판에 맞는 설치 형식을 선택하세요. 서버나 라우터에서 사용할 경우 독립형 mihomo 커널을 고려할 수 있으며, 설정과 서비스 실행, 권한은 직접 관리해야 합니다. GUI 클라이언트의 시스템 프록시 설정이 명령줄 프로그램에 적용되지 않을 수도 있습니다. 문제를 확인할 때는 데스크톱 앱, 터미널 환경 변수, 네트워크 라우팅을 각각 점검하세요.

다운로드 페이지로 이동 Linux 클라이언트

Android 첫 연결: 세 단계 점검

클라이언트를 설치해도 설정이 완료된 것은 아닙니다. 신뢰할 수 있는 출처의 구독 주소를 준비하고 가져오기, 권한 허용, 연결 확인 순서로 진행하세요. 메뉴 이름은 클라이언트마다 조금씩 다를 수 있습니다.

  1. 설정을 가져와 선택

    ‘설정’ 페이지를 열고 항목을 추가한 뒤 URL 또는 원격 가져오기를 선택하세요. 알아보기 쉬운 이름을 입력하고 구독 주소를 붙여 넣어 저장합니다. 다운로드가 끝나면 해당 설정을 선택해 현재 설정으로 적용됐는지 확인하고, 프록시 페이지에 정책 그룹이 표시되는지 살펴보세요.

    가져오기에 실패하면 주소에 불필요한 공백이 있는지, 반환된 내용이 로그인 페이지가 아닌 설정 파일인지 먼저 확인하세요. 아직 노드 연결 단계에 들어가지 않았으므로 프록시 모드를 반복해서 바꿀 필요는 없습니다. 클라이언트는 구독 서비스를 제공하지 않으므로 신뢰할 수 있는 제공자에게서 설정을 받아야 합니다.

  2. 모드 선택 및 권한 허용

    처음 사용할 때는 Rule을 선택한 다음 주요 프록시 정책 그룹에서 출구를 고르세요. 홈 화면으로 돌아가 시작을 누르고 시스템 VPN 요청에서 앱 이름을 확인한 뒤 연결을 허용합니다. 상단에 VPN 표시가 나타나면 시스템 인터페이스가 만들어진 것입니다. 이것만으로 원격 서비스가 사용 가능하다는 뜻은 아닙니다.

    백그라운드에서 계속 실행해야 한다면 시스템의 앱 정보에서 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 처음부터 모든 고급 설정을 켜지 마세요. 정상 작동이 확인된 설정으로 기본 연결을 먼저 테스트한 다음 자동 실행이나 앱별 분기 설정을 하나씩 추가하세요.

  3. 사이트와 연결 기록 확인

    직접 연결해야 하는 사이트와 프록시를 사용해야 하는 사이트를 각각 열고, 클라이언트 연결 기록에서 적용된 규칙과 출구를 확인하세요. 접속할 수 없다면 먼저 서비스를 잠시 중지해 기기 자체의 인터넷 연결을 확인합니다. 그런 다음 구독 상태, 노드 연결, DNS를 점검하세요. DNS는 도메인 이름을 IP 주소로 변환하는 과정입니다.

    설정 후 화면을 잠근 채 잠시 기다렸다가 다시 연결해 자주 사용하는 앱과 LAN 기기도 확인하세요. 화면을 켜면 복구되지만 잠금 후 작동하지 않는다면 백그라운드 제한 설정을 다시 살펴보세요. 특정 사이트만 실패한다면 해당 연결 기록을 확인하세요. 한 번에 하나씩 변경하고 이전 설정을 보관하면 필요할 때 되돌릴 수 있습니다.

Clash 오픈 소스 생태계와 유지 관리 범위

클라이언트 인터페이스, 프록시 커널, 구독 설정은 각각 다른 역할을 합니다. 특정 기능을 사용할 수 있는지 판단하려면 앱 이름만 보지 말고 이 세 가지를 함께 확인해야 합니다.

원본 프로젝트와 이후 생태계

원본 Clash의 공개 유지 관리는 중단됐으며 이후 생태계는 여러 커뮤니티 프로젝트가 이어 가고 있습니다. 이름에 Meta나 mihomo가 포함된 프로젝트와 각종 GUI 클라이언트는 서로 다른 제품입니다. mihomo는 설정 해석, 프로토콜 연결, 규칙 판단을 담당하고 GUI 클라이언트는 설정 가져오기, 정책 선택, 로그 확인, 시스템 연결을 위한 인터페이스를 제공합니다. 따라서 인터페이스가 비슷한 앱도 사용하는 커널이나 설정 처리 방식은 다를 수 있습니다.

클라이언트를 선택할 때는 유지 관리 상태, 기기 호환성, 실제 기능을 먼저 확인하세요. 보관된 앱은 이전 가이드를 이해하는 데 도움이 될 수 있지만 새 기기나 새 설정과 호환되지 않을 수 있습니다. 이 사이트는 플랫폼별 다운로드 링크를 다운로드 페이지에 모으고 이전 프로젝트의 유지 관리 상태를 따로 표시합니다. 프로토콜 지원, 설정 항목, 권한 동작은 프로젝트 문서와 실제 로그를 함께 확인하세요.

공개 소스 코드와 문제 제보

mihomo의 소스 코드, 릴리스 안내, 문제 논의는 공개 저장소에서 확인할 수 있습니다. 오픈 소스는 구현을 살펴보고 커뮤니티가 구체적인 문제를 함께 해결할 수 있다는 뜻입니다. 그렇다고 모든 서드파티 설정, 설치 경로, 원격 노드를 똑같이 신뢰할 수 있는 것은 아닙니다. 클라이언트 다운로드와 설정 출처 선택은 각각 따로 판단해야 합니다.

문제를 제보할 때는 기기와 운영체제, 클라이언트 이름, 재현 단계, 주요 오류 메시지를 구체적으로 작성하세요. 로그를 공유하기 전 구독 주소, 접속 정보, 공개할 필요가 없는 네트워크 정보를 삭제해야 합니다. ‘작동하지 않는다’는 설명만으로는 네트워크, 설정, 권한 문제를 구분하기 어렵습니다. 서비스를 중지하면 인터넷에 연결되는지, 화면 잠금 상태에서만 문제가 생기는지도 덧붙이면 원인을 좁히는 데 도움이 됩니다.

업데이트 전에 사용 가능한 설정 보관

클라이언트 업데이트, 커널 업데이트, 구독 업데이트는 서로 별개의 변경입니다. 앱을 업그레이드하면 권한이나 인터페이스가 바뀔 수 있고, 커널 업데이트는 지원하는 설정 항목에 영향을 줄 수 있으며, 구독 업데이트는 노드와 규칙 내용을 바꿉니다. 문제가 생기면 최근에 바꾼 항목이 어느 단계인지 먼저 확인하고 해당 기록을 살펴보세요. 클라이언트 재설치, 구독 교체, DNS 변경을 한꺼번에 하면 무엇이 문제를 해결했거나 새로 일으켰는지 알기 어렵습니다.

업그레이드 전에 로컬 오버라이드와 필요한 설정을 백업하고, 업그레이드 후 현재 설정과 모드, 정책 그룹을 다시 확인하세요. 구독 파일에 직접 수정한 내용은 원격 업데이트로 덮어써질 수 있으므로 계속 유지할 규칙은 클라이언트가 지원하는 영구 설정에 추가해야 합니다. 기기를 옮길 때는 로컬 경로와 스크립트 지원 여부도 확인하세요. 데스크톱 설정 파일 하나가 모든 플랫폼에서 그대로 작동하는 것은 아닙니다.

설정 출처와 이용 범위

이 사이트는 클라이언트 다운로드 링크, 용어 설명, 설정 방법을 제공하며 프록시 노드나 구독 서비스는 제공하지 않습니다. 구독 사용 가능 여부는 설정 제공자와 원격 서비스에 따라 달라지므로 클라이언트가 정상적으로 시작됐다는 사실만으로 서비스 상태를 판단할 수 없습니다. 구독을 변환 도구에 입력하기 전에 주소와 설정 내용을 어떻게 처리하는지 확인하세요. 확실하지 않다면 클라이언트가 직접 읽을 수 있는 원본 형식을 사용하는 것이 좋습니다.

네트워크 트래픽의 경로는 규칙, DNS, 앱 동작, 시스템 연결 방식에 따라 달라집니다. ‘연결됨’ 표시 하나만으로 판단할 수 없습니다. 회사 네트워크나 관리 대상 기기를 사용하는 경우 먼저 해당 네트워크 규정을 따르세요. 용어는 용어집에서 확인할 수 있으며, 자주 발생하는 연결 끊김과 인터넷 접속 문제는 FAQ 순서에 따라 하나씩 점검하세요.

클라이언트 관리와 연결 문제 해결

기기 마이그레이션 선택부터 구체적인 오류까지, 문제가 발생한 단계에 맞는 안내를 확인하세요. 먼저 증상을 기록하고 순서대로 점검해 여러 설정을 한꺼번에 바꾸지 않도록 합니다.

Clash 노드 시간 초과 및 전체 연결 실패: 문제 해결 순서

기기 네트워크, 구독 유효성, DNS 확인, 시스템 시간, 프로토콜과 포트 순서로 원인을 좁혀 보세요. 로그에 자주 나타나는 오류의 의미와 함께 확인하면 노드 연결이 실패하는 실제 단계를 찾을 수 있습니다.

클라이언트 다운로드