오픈 소스 데스크톱 클라이언트 · 구독 및 오버라이드 설정

Clash Verge Rev 공식 사이트모든 플랫폼 클라이언트 다운로드 및 설정

Clash 다운로드 가이드 보기

Mihomo 코어 기반 데스크톱 프록시 클라이언트로 구독, 규칙, 로컬 오버라이드를 한곳에서 관리합니다. 시스템별 데스크톱 설정과 모바일 클라이언트 선택 방법을 확인하세요.

Mihomo 코어·GPL-3.0 오픈 소스·Tauri 데스크톱 프레임워크

CONFIGURATION DESK

Mihomo, TUN, 구독 오버라이드

설정 소스부터 연결 기록까지 처리 순서에 따라 클라이언트 구조를 살펴봅니다. 이 화면은 설정 구조를 보여주는 예시입니다. 실제 토글과 권한 안내, 사용 가능한 항목은 설치한 클라이언트와 코어 문서를 기준으로 확인하세요.

실행 구성 요소 / Core

클라이언트는 설정을 관리하고, 코어는 설정을 해석해 연결을 처리합니다.

코어와 클라이언트의 역할

Mihomo는 설정을 읽고 규칙을 매칭하며 도메인을 해석해 프록시 연결을 설정합니다. Clash Verge Rev는 구독 관리와 데스크톱 설정 화면을 제공합니다. 특정 프로토콜이나 설정 항목을 사용할 수 없다면 먼저 화면의 옵션과 코어의 기능을 구분한 뒤 런타임 설정과 시작 로그를 확인하세요. 정적 파일만 편집하는 방식과 달리 데스크톱 클라이언트에서는 설정 선택, 모드 전환, 오류 안내를 한곳에서 관리할 수 있습니다. 그렇다고 클라이언트마다 확장 문법을 그대로 바꿔 쓸 수 있는 것은 아닙니다. 이전하기 전에 기존 설정을 보관하고 코어에서 지원하는 항목을 하나씩 확인하세요.

고급 사용법 보기 →

설정 계층을 확인한 뒤 수정

실행 중인 설정은 원격 구독, 로컬 파일, 전역 확장, 구독별 확장에서 비롯될 수 있습니다. 편집기에서 보이는 내용이 코어에 최종 전달되는 설정과 반드시 같지는 않습니다. 저장한 설정이 적용되지 않는다면 먼저 현재 선택된 구독을 확인하고 런타임 설정에서 해당 항목을 살펴보세요. 토글 위치만 보고 결과를 판단하지 말고, 구독 업데이트로 덮어써질 파일에 임시 변경 사항을 저장하지 마세요.

처음 설정할 때는 시스템 프록시와 규칙 모드만 활성화하는 것이 좋습니다. 브라우저 접속을 확인한 뒤 필요에 따라 TUN, 규칙 세트, DNS 설정을 추가하세요. 한 번에 설정 계층 하나만 변경하고 변경 전후의 동작을 기록하면 해석 실패, LAN 접속 문제, 특정 앱의 네트워크 오류가 생겼을 때 빠르게 정상 상태로 되돌릴 수 있습니다. 정책 그룹, 규칙 제공자, 도메인 스니핑을 포함한 전체 예시는 고급 설정 가이드에서 확인하세요.

CLIENT SELECTION

시스템별 Clash 클라이언트 선택

Clash Verge Rev는 데스크톱 운영체제용입니다. 스마트폰과 태블릿에서는 해당 플랫폼용 클라이언트를 선택해야 하며 데스크톱 설치 파일을 직접 실행할 수 없습니다. 클라이언트마다 화면 구성과 확장 설정 메뉴도 다를 수 있습니다.

Windows

시스템 프록시, 서비스 모드, TUN을 사용하려는 데스크톱 사용자에게 적합합니다. 운영체제와 CPU 아키텍처에 맞는 설치 파일을 선택하고, 설치 후 클라이언트가 정상적으로 실행되는지 확인한 다음 설정을 가져오세요. 다른 프록시 프로그램을 사용 중이라면 시스템 프록시와 가상 네트워크 인터페이스 처리를 먼저 끄세요. 여러 클라이언트가 동시에 네트워크 설정을 변경하는 것을 방지할 수 있습니다. 다운로드 센터에서 Clash Plus, Clash Verge Rev 등 여러 옵션을 확인할 수 있으며, 지원이 종료된 프로그램은 유지 관리 상태가 별도로 표시됩니다.

다운로드 페이지로 이동

macOS

시스템 정보에서 기기가 Apple Silicon인지 Intel 프로세서인지 확인한 뒤 해당 빌드를 선택하세요. 일반적인 브라우저 사용에는 시스템 프록시를, TUN 사용에는 서비스 권한과 네트워크 트래픽 처리 설정을 확인해야 합니다. 처음 실행할 때 보안 경고가 표시되면 설치 출처를 확인하고 안내 내용을 읽으세요. 특정 앱 하나 때문에 시스템 보안 설정을 장기간 낮추지 마세요. 기존 클라이언트의 구독은 옮길 수 있지만 전용 스크립트와 단축 설정은 다시 확인해야 합니다.

다운로드 페이지로 이동

Android

모바일 클라이언트는 시스템 VPN 인터페이스로 트래픽을 처리하며, 활성화할 때 권한 팝업을 승인해야 합니다. 백그라운드 실행, 앱별 프록시, 배터리 절약 설정은 연결 안정성에 영향을 줄 수 있습니다. 먼저 앱을 열어 접속을 테스트한 뒤 실제 연결 끊김 여부에 따라 백그라운드 제한을 조정하세요. 다운로드 센터에서 Clash Plus, Clash Meta for Android, FlClash, Surfboard를 확인할 수 있습니다. 설정을 가져오기 전에 각 앱이 지원하는 설정 형식과 규칙 기능을 살펴보세요.

다운로드 페이지로 이동

iOS

다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 프로젝트 공식 사이트는 clashplus.io입니다. 설치 후 유효한 설정을 가져오고 시스템 안내에 따라 VPN 구성을 추가하도록 허용하세요. 데스크톱의 전역 확장 스크립트와 설정 항목을 모바일 기능 목록과 동일하게 볼 수는 없습니다. 이전할 때는 먼저 구독을 정상적으로 해석할 수 있는지 확인한 뒤 규칙, DNS, 필요한 프로토콜을 하나씩 테스트하세요. 데스크톱 확장 설정을 한꺼번에 복사하지 마세요.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 배포판의 패키지 형식에 맞춰 Clash Verge Rev 또는 FlClash를 선택하고 설치 전에 관련 의존성 안내를 읽으세요. 그래픽 인터페이스 실행, 시스템 프록시, TUN 서비스 권한은 각각 확인해야 할 항목입니다. 화면이 정상적으로 열렸다고 해서 트래픽까지 처리되고 있다고 볼 수는 없습니다. 서버나 라우터 사용자는 다운로드 센터의 Mihomo 코어 섹션을 참고해 설정, 프로세스, 로그를 별도로 관리하세요. 데스크톱 조작 과정을 원격 환경에 그대로 적용하지 않는 것이 좋습니다.

다운로드 페이지로 이동

기존 클라이언트를 옮기기 전에 플랫폼 지원, 유지 관리 상태, 설정 방식을 비교해 보세요.

모든 클라이언트 보기 →
FIRST CONNECTION

구독 가져오기부터 연결 확인까지, 세 단계 점검

클라이언트 자체는 프록시 서비스를 제공하지 않습니다. 시작하기 전에 사용할 수 있는 구독 주소나 로컬 설정 파일을 준비하고, 작업에 실패했을 때 복구할 수 있도록 현재 네트워크 설정을 보관하세요.

  1. 구독을 가져와 설정 선택

    구독 페이지에서 주소를 추가하거나 로컬 YAML 파일을 가져오세요. 해석이 완료되면 해당 설정이 선택되어 있는지 확인한 뒤 프록시 페이지에서 정책 그룹을 살펴보세요. 구독 카드가 표시된다고 설정이 정상적으로 로드된 것은 아닙니다. 해석 오류가 표시되면 파일 내용과 클라이언트가 지원하는 형식을 먼저 확인하고 네트워크 토글을 추가로 켜지 마세요.

  2. 규칙 모드와 출구 선택

    일반적인 사용에는 규칙 모드를 선택하고 구독에 정의된 정책 그룹에서 사용할 출구를 고르세요. 시스템 프록시를 켠 뒤 브라우저에서 새 연결을 만드세요. 규칙 모드는 요청에 적용할 정책을 정하고, 시스템 프록시는 앱의 요청을 클라이언트로 보낼지 결정합니다. 서로 대신할 수 있는 기능이 아닙니다. 우선 TUN은 끈 상태로 두고 가장 간단한 연결 경로부터 확인하세요.

  3. 연결 페이지에서 요청 확인

    확인이 필요한 사이트에 접속한 뒤 연결 페이지에 해당 요청이 표시되는지, 적용된 규칙이 예상과 일치하는지 살펴보세요. 기록이 없으면 앱의 프록시 설정을 확인하고, 기록이 있지만 실패한다면 DNS, 정책 그룹, 출구를 점검하세요. 브라우저 접속이 확인된 뒤 시스템 프록시를 따르지 않는 앱에 TUN이 필요한지 검토하고 같은 방법으로 다시 확인하세요.

잘못된 설정이 매번 실행될 때 적용되지 않도록 연결을 확인한 뒤 시작 시 자동 실행과 백그라운드 실행을 설정하세요.

전체 가이드 보기 →
SOURCE & MAINTENANCE

오픈 소스 프로젝트와 설정 관리

소스 코드, 릴리스 노트, 실행 로그를 통해 소프트웨어 동작을 살펴보세요. 클라이언트, 프록시 코어, 구독 서비스는 서로 다른 구성 요소이므로 유지 관리와 문제 해결도 구분해야 합니다.

Clash Verge Rev 프로젝트 구성

Clash Verge Rev는 Clash Verge의 데스크톱 설정 관리 방식을 이어받아 Tauri로 데스크톱 인터페이스를 만들고 Mihomo를 프록시 코어로 사용합니다. 프로젝트 소스 코드는 GPL-3.0 라이선스로 공개되어 있습니다. 화면의 구독, 연결, 규칙, 로그 페이지는 코어 기능을 관리하는 인터페이스입니다. 프로토콜 지원, DNS 처리, 규칙 문법은 Mihomo 문서를 함께 참고해야 합니다. 기능 지원 여부를 확인할 때는 프로그램 이름만 보지 말고 해당 프로젝트의 릴리스 노트와 실제 설정을 확인하세요.

커뮤니티 협업과 문제 재현

오픈 소스 저장소에서 소스 코드, 이슈 논의, 변경 기록을 확인할 수 있습니다. 문제를 신고할 때는 운영체제, 설치 방법, 재현 단계, 오류가 발생한 위치를 설명하고 필요한 부분만 가린 로그를 첨부하세요. 연결이 안 된다는 설명만으로는 설정 해석, 라우팅, 원격 출구 중 어디에서 문제가 생겼는지 파악하기 어렵습니다. 전체 구독을 올리는 대신 재현에 필요한 최소 설정만 공유하면 인증 정보와 접속 기록이 공개될 위험도 줄어듭니다.

클라이언트 업데이트와 코어 업데이트

데스크톱 인터페이스와 프록시 코어는 변경되는 부분이 다릅니다. 클라이언트를 업데이트한다고 모든 로컬 오버라이드를 다시 작성할 필요는 없습니다. 업데이트 전에 구독 소스와 확장 설정을 저장하고 시스템 프록시, 서비스 모드, 설정 병합 관련 변경 사항을 확인하세요. 업데이트 후에는 기존의 최소 설정부터 테스트하고 고급 기능을 차례로 복구하세요. 특정 확장을 켠 뒤에만 오류가 생긴다면 구독, 코어, DNS를 한꺼번에 바꾸기보다 해당 확장부터 줄여 보세요.

구독과 로컬 설정을 따로 백업

원격 구독을 업데이트하면 프록시와 규칙이 바뀔 수 있고, 로컬 오버라이드에는 개인 설정이 저장됩니다. 백업할 때는 구독 소스, 정책 그룹 선택, 포트 설정, 확장 내용을 각각 기록하세요. 임시 런타임 파일 하나만 저장하는 것으로는 충분하지 않습니다. 런타임 설정은 병합 결과를 확인하는 데 유용하지만 다음에 가져올 설정 소스로 적합하지 않을 수 있습니다. 다른 클라이언트로 옮길 때는 먼저 공통으로 사용할 수 있는 구독을 가져온 뒤 클라이언트 전용 설정을 다시 구성하고, 되돌릴 수 있도록 이전 기록을 남겨 두세요.

GPL-3.0소스 코드 공개

Clash Verge Rev 소스 코드 보기

아래 명령은 소스 코드만 다운로드합니다. 데스크톱 클라이언트를 실행하려면 다운로드 센터의 설치 링크를 이용하세요. 직접 빌드하려면 프로젝트에 필요한 도구 체인을 별도로 준비해야 합니다.

git clone https://github.com/clash-verge-rev/clash-verge-rev.git
프로젝트 저장소 열기 ↗

RECENT NOTES

클라이언트 사용 및 이전 가이드

처음 설정을 가져오는 방법부터 기존 설정 이전까지, 필요한 작업 안내를 확인하세요. 모바일 백그라운드 설정과 데스크톱 오버라이드는 별도로 다뤄 현재 시스템에 맞지 않는 방법을 혼동하지 않도록 구성했습니다.

모든 글 보기 →