다운로드 / 운영체제별 선택
Clash Verge Rev는 데스크톱 운영체제용이며, 모바일에서는 같은 생태계의 앱을 사용할 수 있습니다. 5개 플랫폼의 다운로드 링크에는 서로 다른 프로젝트가 포함되어 있어 모든 클라이언트가 모든 운영체제를 지원하는 것은 아닙니다. 먼저 기기 운영체제를 확인한 뒤 CPU 아키텍처와 설치 방식을 선택하세요.
일반적인 데스크톱 사용에는 Clash Plus를 시작점으로 삼거나, Clash Verge Rev에서 구독을 관리하고 연결 및 규칙을 확인할 수 있습니다. 설치 전에 시스템 정보에서 CPU 종류를 확인하세요. 바탕 화면 바로가기 이름만으로 아키텍처를 판단하면 안 됩니다.
처음 실행한 뒤 설정을 가져오고 시스템 프록시를 켜세요. 특정 앱의 연결 기록이 보이지 않으면 해당 앱이 시스템 프록시 설정을 따르는지 확인하세요. UWP 앱이라면 가이드에 따라 루프백 접근 제한을 처리하고, 노드를 계속 바꾸는 방식으로 해결하려 하지 마세요.
다운로드 Windows 클라이언트‘이 Mac에 관하여’에 표시된 칩에 맞춰 Apple Silicon 또는 Intel 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스와 설정 관리 방식이 서로 다릅니다. 기존 설정을 가져올 때는 먼저 프로토콜과 규칙 지원 여부를 확인하세요.
처음 실행할 때 네트워크 관련 작업을 허용하라는 시스템 안내가 표시될 수 있습니다. 시스템 프록시와 TUN은 필요한 권한이 다릅니다. 먼저 시스템 프록시로 브라우저 연결을 확인한 뒤, 다른 앱에도 가상 네트워크 인터페이스를 통한 트래픽 처리가 필요한지 판단하세요.
다운로드 macOS 클라이언트모바일에서는 Clash Plus, Clash Meta for Android, FlClash 등을 사용할 수 있습니다. 비교적 최신 기기는 대부분 ARM64를 사용하지만 기기 정보로 직접 확인하는 것이 좋습니다. 아키텍처가 맞지 않으면 같은 파일을 반복 설치하지 말고 다운로드 페이지에서 올바른 설치 파일을 선택하세요.
처음 연결할 때는 시스템 VPN 권한을 허용해야 하는 경우가 많습니다. 화면을 잠근 뒤 한동안 지나면 연결이 끊길 경우 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 시스템 네트워크를 제어하는 VPN 앱은 한 번에 하나만 사용하는 것이 충돌을 피하는 데 좋습니다.
다운로드 Android 클라이언트iPhone과 iPad에서는 다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 제품 안내는 공식 사이트 clashplus.io에서도 확인할 수 있습니다. 설치를 마친 뒤 클라이언트가 지원하는 구독을 가져오고, 시스템 안내에 따라 VPN 구성을 추가하세요.
다른 클라이언트에서 옮길 때는 노드 프로토콜, 라우팅 규칙, 정책 그룹을 각각 확인하세요. 구독 주소를 읽을 수 있다고 해서 모든 클라이언트 전용 설정까지 그대로 옮겨지는 것은 아닙니다. 파싱 오류가 발생하면 연결 설정을 바꾸기 전에 구독 형식부터 확인하세요.
다운로드 iOS 클라이언트데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고, 배포판의 패키지 형식에 맞는 설치 파일을 사용하세요. 사용 전에 데스크톱 의존성과 권한 설정을 확인하세요. 서버나 라우터처럼 데스크톱 환경이 없는 기기에는 mihomo 코어를 별도로 배포하는 편이 적합합니다.
그래픽 인터페이스는 설정을 관리하고 백그라운드 코어는 연결을 처리하므로 두 구성 요소의 실행 상태를 각각 확인해야 합니다. TUN을 켤 때는 서비스 권한과 라우팅 변경도 확인하세요. 권한 부족을 구독이나 노드 문제로 오해하지 않도록 주의해야 합니다.
다운로드 Linux 클라이언트작업 공간 / 설정과 라우팅
구독 가져오기부터 규칙 적용까지, 실제 사용 흐름에 따라 클라이언트 기능을 살펴보세요. 아래 이미지는 정적인 인터페이스 예시이며 온라인 제어판이 아닙니다. 카드를 클릭하면 기능 설명을 펼쳐 볼 수 있습니다. 실제 메뉴와 옵션은 설치한 클라이언트에 따라 다를 수 있습니다.
구독은 노드와 규칙을 업데이트 가능한 설정 하나로 묶어 서버 측 변경 사항을 주기적으로 동기화할 때 유용합니다. 설정 페이지에 서비스 제공자가 안내한 주소를 붙여 넣어 가져오세요. 가져오기가 끝나면 해당 설정을 현재 사용 항목으로 선택해야 합니다. 업데이트는 구독 내용을 다시 가져오는 작업이며, 로컬에서 수정한 내용을 자동으로 복구하지는 않습니다. 단일 노드 관리에 초점을 둔 도구와 달리 Clash Verge Rev는 전체 설정과 로컬 확장을 함께 관리할 수 있습니다. 사용자 지정 규칙을 오래 유지하려면 지원되는 오버라이드 위치에 추가해 다음 업데이트에서 덮어쓰이지 않도록 하세요. 구독 주소에는 접근 정보가 포함될 수 있으므로 공개적으로 공유하거나 스크린샷에 노출하지 마세요.
규칙은 목록의 위에서 아래 순서로 검사되며, 처음 일치한 규칙이 연결에 사용할 정책을 결정합니다. 규칙 페이지에서는 현재 불러온 규칙을 확인하고, 연결 페이지에서는 각 요청에 실제로 적용된 규칙을 확인할 수 있습니다. 규칙을 수정하려면 화면 표시만 바꾸지 말고 설정 또는 오버라이드 메뉴로 이동하세요. 전역 포워딩만 제공하는 클라이언트와 달리 로컬 네트워크, 특정 도메인, 나머지 요청을 각각 다르게 처리할 수 있습니다. 규칙에서 참조하는 정책 그룹이 실제로 존재해야 하며 기본 규칙은 마지막에 두세요. GeoIP와 GeoSite는 데이터베이스도 필요합니다. 데이터베이스가 로드되지 않았다면 파일이나 업데이트 문제부터 해결하세요.
코어는 프로토콜 파싱, DNS, 규칙 처리 기능을 결정하고 그래픽 인터페이스는 설정을 코어에 전달합니다. 새 기능을 사용하거나 호환성 문제를 확인하려면 설정에서 현재 코어 정보를 먼저 살펴보세요. 코어 버전을 전환할 수 있는 빌드에서는 안정 버전이나 Alpha 테스트 버전을 선택할 수 있지만, 전환 전에 설정을 백업해야 합니다. 코어와 인터페이스를 구분하면 오류가 어느 쪽에서 발생했는지 파악하기 쉽습니다. 테스트 버전이 모든 네트워크에서 더 빠른 것은 아니며 설정 항목의 동작이 달라질 수도 있습니다. 일상적인 사용에는 안정 버전을 권장하며, 특정 신기능이 필요할 때만 테스트하고 복구할 수 있도록 설정을 보관하세요.
시스템 프록시는 시스템 설정을 따르는 앱에 주로 적용되고, TUN은 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 처리합니다. 처음 설정할 때는 설정 페이지에서 시스템 프록시를 켜고 브라우저 연결을 확인한 다음, 처리되지 않는 앱이 있는지 살펴보세요. 프록시 포트만 제공하는 도구와 달리 TUN은 라우팅과 DNS를 함께 처리할 수 있지만, 서비스 권한과 네트워크 충돌도 점검해야 합니다. 사용 전에 다른 VPN이나 가상 네트워크 인터페이스의 상태를 확인하고, 문제가 생기면 기존 스위치 상태로 되돌린 뒤 원인을 찾아보세요. 시작 시 자동 실행은 프로그램의 실행 시점만 정합니다. 구독이 유효하거나 모든 앱이 프록시를 사용한다는 뜻은 아닙니다.
연결 페이지에서는 현재 발생하는 요청을 살펴보고 로그 페이지에서는 설정 로드 및 코어 오류를 확인할 수 있습니다. 두 페이지를 함께 활용하세요. 웹사이트에 접속한 뒤 연결 페이지에서 도메인을 필터링하고 적용된 규칙과 정책 그룹을 확인한 다음, 프록시 페이지에서 그룹 내 선택 항목을 살펴보세요. 연결 스위치만 표시하는 클라이언트와 달리, 이 기록을 활용하면 ‘요청이 코어에 전달되지 않음’과 ‘코어에 전달됐지만 포워딩 실패’를 구분할 수 있습니다. 문제를 확인할 때만 로그 수준을 높이고 작업이 끝나면 평소 수준으로 되돌리세요. 기록을 공유하기 전에 구독 주소, 인증 정보, 사적인 도메인을 삭제하세요. 규칙 적용 기록은 라우팅 선택만 보여 줄 뿐, 원격 서버에 성공적으로 접속했다는 증거는 아닙니다.
이 다섯 가지 위치를 이해하면 같은 흐름을 따라 문제를 진단할 수 있습니다. 설정이 로드됐는지, 요청이 코어에 전달됐는지, 규칙이 예상대로 적용됐는지, 정책 그룹에서 사용할 수 있는 노드를 선택했는지 차례로 확인하세요. 여러 계층을 한꺼번에 바꾸면 연결을 복구하더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다. 프로토콜과 코어의 관계는 코어 기술 참고에서 더 자세히 확인할 수 있습니다.
빠른 시작 / 첫 연결
설치는 준비 단계일 뿐입니다. 연결 대상과 트래픽 전달 방식을 설정하려면 사용할 수 있는 구독이나 직접 관리하는 설정이 필요합니다. 아래에서는 첫 연결에 필요한 흐름을 간단히 안내합니다. 운영체제별 차이와 문제 해결 방법은 입문 가이드에서 확인하세요.
설정 페이지를 열고 구독 주소를 붙여 넣은 뒤 가져오기를 실행하세요. 설정 카드가 표시되면 정상적으로 로드됐는지 확인하고 현재 설정으로 선택하세요. 파싱 오류가 표시되면 주소가 클라이언트에서 지원하는 설정 파일을 반환하는지 확인하세요. 로그인 페이지, 만료 안내, 일반 웹페이지 주소를 입력한 것은 아닌지 살펴보세요.
우선 DNS, 포트, TUN 매개변수를 직접 수정하지 마세요. 구독의 기본 설정을 유지한 채 작동하는 기준 상태부터 만드세요. 기존에 사용자 지정 설정이 있다면 옮기기 전에 별도 파일로 백업해 규칙과 노드 정보가 한꺼번에 덮어써지지 않게 하세요.
프록시 페이지에서 규칙 모드를 선택한 다음 실제 규칙이 참조하는 정책 그룹에서 노드를 하나 고르세요. 정책 그룹이 다른 그룹을 포함할 수 있으므로 그룹 이름을 따라가며 최종 노드까지 확인해야 합니다. 사용되지 않는 그룹만 바꾸면 대상 웹사이트의 연결 경로는 보통 달라지지 않습니다.
노드 테스트는 후보를 추리는 데 도움이 되지만 테스트에 성공해도 모든 앱에 접속할 수 있다는 뜻은 아닙니다. 현재 선택을 유지한 채 시스템 프록시를 켜세요. 다른 프록시 프로그램이 실행 중이라면 포트나 시스템 설정이 서로 덮어쓰지 않도록 해당 프로그램의 트래픽 처리 기능을 먼저 끄세요.
확인할 웹사이트를 열고 연결 페이지에 해당 도메인이 표시되는지 확인한 뒤 적용된 규칙과 정책 그룹을 살펴보세요. 기록이 없다면 먼저 앱의 프록시 설정을 확인하세요. 기록은 있는데 접속이 실패한다면 노드, DNS, 코어 로그를 확인하세요.
외부로 나가는 IP를 확인하려면 신뢰할 수 있는 IP 조회 서비스를 이용할 수 있습니다. 브라우저 캐시, 연결 재사용, 분할 라우팅 정책도 고려하세요. 스위치 색상만 보고 연결이 적용됐다고 판단하면 안 됩니다. 확인을 마친 뒤 사용자 지정 규칙을 하나씩 추가하고, 변경할 때마다 같은 방법으로 다시 점검하세요.
오픈 소스 / 프로젝트와 코어
클라이언트를 선택할 때는 인터페이스뿐 아니라 프로젝트 출처, 코어 기능, 업데이트 범위도 확인해야 합니다. 오픈 소스 저장소에서는 코드, 라이선스, 이슈 기록을 살펴볼 수 있습니다. 출처가 불분명한 다운로드 수나 평점보다 이런 자료가 판단에 더 도움이 됩니다.
Clash Verge Rev는 기존 Clash Verge 프로젝트를 바탕으로 이어서 개발된 커뮤니티 프로젝트입니다. 검색 결과에는 기존 프로젝트, 후속 유지 관리 포크, 오래된 설치 파일이 함께 표시될 수 있습니다. 이름이 비슷하다고 유지 관리 상태까지 같은 것은 아닙니다. 가이드를 읽을 때 클라이언트의 전체 이름을 확인하고 현재 프로젝트 안내를 기준으로 판단하세요.
Rev의 데스크톱 인터페이스는 Tauri 프레임워크를 사용하며 네트워크 처리는 mihomo에 의존합니다. 인터페이스는 구독 관리, 설정 메뉴, 상태 표시를 맡고 코어는 설정을 실행합니다. 따라서 일부 기능은 코어 업데이트가 필요하지만 다른 인터페이스 문제는 클라이언트 자체의 수정이 필요한 이유를 알 수 있습니다.
mihomo는 Clash Meta의 기술 방향을 이어받아 Clash 설정 체계를 바탕으로 프로토콜, 규칙, DNS 기능을 확장합니다. YAML 구조가 비슷하더라도 모든 코어가 같은 설정 항목을 지원하는 것은 아닙니다. 설정을 복사하기 전에 사용하는 코어가 해당 프로토콜 유형과 매개변수를 지원하는지 확인하세요.
클라이언트마다 오버라이드, 스크립트, 설정 병합 방식이 다를 수 있습니다. 마이그레이션할 때는 공통 코어 설정과 클라이언트 전용 설정을 나눠 확인하세요. 설정을 불러오는 단계에서 오류가 발생하면 로그에서 문제가 된 항목을 찾으세요. 인터페이스에 노드가 표시된다는 이유만으로 모든 기능이 호환된다고 판단하면 안 됩니다.
Clash Verge Rev 프로젝트는 GPL-3.0 라이선스로 배포됩니다. 저장소의 소스 코드, 라이선스 파일, 릴리스 노트, 이슈 논의를 통해 구현과 유지 관리 상황을 확인할 수 있습니다. 검증되지 않은 별점, 기여자 수, 사용자 수는 표시하지 않으며 서로 다른 커뮤니티 프로젝트를 하나의 공식 팀처럼 소개하지 않습니다.
문제를 제보할 때는 운영체제, 클라이언트 이름, 코어 정보, 재현 단계, 민감 정보를 제거한 로그를 함께 제공하세요. 먼저 기존 이슈를 검색하고 최소한의 재현 절차를 정리하세요. 명확한 오류 내용은 ‘모든 사이트가 열리지 않는다’는 설명보다 유지 관리자가 원인을 파악하는 데 도움이 됩니다.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트, Geo 데이터베이스 업데이트는 서로 다른 작업입니다. 구독을 업데이트하면 설정 내용을 다시 가져오지만 데스크톱 프로그램은 업그레이드되지 않습니다. 데이터베이스 업데이트는 일부 규칙의 데이터 기준을 바꾸지만 노드 인증 정보가 갱신된다는 뜻은 아닙니다.
업데이트 전에 해당 릴리스 노트를 읽고 현재 설정과 로컬 확장을 보관하세요. 업데이트를 마친 뒤 설정이 로드됐는지, 정책 그룹에서 예상한 항목을 선택했는지, 시스템 프록시가 기존 설정대로인지 확인하세요. 문제가 발생하면 업데이트 대상별로 하나씩 되돌리거나 진단해 여러 변경 사항을 한꺼번에 섞지 마세요.
이 명령은 프로젝트 소스 코드만 가져오며 클라이언트를 설치하거나 실행하지 않습니다. 프로그램을 설치하려면 다운로드 페이지를 이용하세요.
git clone https://github.com/clash-verge-rev/clash-verge-rev.git참고 / 사용 팁
첫 연결을 마친 뒤에는 실제 문제에 맞춰 더 읽어 보세요. 정책 그룹은 노드 선택 방식을 결정하고, 연결 확인 가이드는 트래픽을 살펴보는 방법을 설명합니다. 시간 초과 문제는 로컬 설정부터 원격 매개변수까지 차례로 점검합니다. 한 번에 한 가지 문제만 다루고 변경 전후의 결과를 기록하세요.
select, url-test, fallback, load-balance 네 가지 정책 그룹의 작동 방식을 비교하고 interval, tolerance 등의 매개변수를 설명합니다. 사용 상황에 맞는 조합도 안내합니다.
정책 그룹 가이드 읽기 →구독을 가져온 뒤 처음 연결하는 방법을 안내합니다. 노드 선택과 지연 시간 테스트, 시스템 프록시 활성화, 연결 페이지와 IP 조회 페이지를 통한 프록시 경유 여부 확인 방법을 설명합니다.
연결 확인 가이드 읽기 →로컬 시스템 프록시와 포트 사용 여부부터 시작해 구독 만료, DNS 설정, 코어 로그 오류, 노드 프로토콜 매개변수를 차례로 확인합니다. 순서대로 점검해 노드 시간 초과의 실제 원인을 찾으세요.
시간 초과 문제 해결 단계 보기 →