오픈소스 프로젝트 · mihomo 코어

Clash Verge
전 플랫폼 클라이언트 다운로드

mihomo 코어 기반 오픈소스 프록시 클라이언트로, 구독 관리, 규칙 분기, TUN 모드를 내장했으며 한국어 설정 문서와 멀티 플랫폼 설치 패키지를 제공합니다.

다운로드 플랫폼: Windows macOS Linux

플랫폼별다운로드

Clash Verge는 mihomo 코어 기반 오픈소스 프록시 클라이언트로 Windows, macOS, Linux, Android, iOS를 지원합니다. 클라이언트는 구독 관리, 설정 생성, 인터페이스 표시를 담당하고 트래픽 전달은 코어가 처리하며, 설정 형식은 Clash 생태계와 호환됩니다. 다운로드 페이지에는 플랫폼별 클라이언트, 설치 패키지 형식, 시스템 요구 사항이 정리되어 있고, 설치 패키지는 공식 배포 채널과 동기화됩니다. 아래 링크는 해당 플랫폼의 다운로드 카드로 바로 이동합니다.

플랫폼별다운로드

Clash Verge는 mihomo 코어 기반 오픈소스 프록시 클라이언트로 Windows, macOS, Linux, Android, iOS를 지원합니다. 클라이언트는 구독 관리, 설정 생성, 인터페이스 표시를 담당하고 트래픽 전달은 코어가 처리하며, 설정 형식은 Clash 생태계와 호환됩니다. 다운로드 페이지에는 플랫폼별 클라이언트, 설치 패키지 형식, 시스템 요구 사항이 정리되어 있고, 설치 패키지는 공식 배포 채널과 동기화됩니다. 아래 링크는 해당 플랫폼의 다운로드 카드로 바로 이동하며, 각 플랫폼의 지원 OS 버전, 추천 클라이언트, 설치 시 주의사항이 함께 표시됩니다.

핵심기능

Clash Verge는 프록시 클라이언트의 주요 기능을 바로 사용할 수 있는 설정 항목으로 제공합니다. 구독을 가져오면 전체 설정이 자동 생성되고, 규칙 분기는 도메인과 IP를 기준으로 정책 그룹을 매칭하며, TUN 모드는 시스템 트래픽을 처리하고, DNS 섹션에서는 해석 경로를 세밀하게 제어할 수 있습니다. 아래 네 개 패널은 클라이언트 설정 페이지의 실제 모듈에 해당하며, 각 항목은 사용 문서와 고급 사용법 페이지에서 관련 설정 설명과 문제 해결 단계를 확인할 수 있습니다.

구독 관리

구독 관리는 서비스 제공자의 구독 링크를 클라이언트로 가져와 proxies, proxy-groups, rules 세 구간으로 자동 파싱합니다. 여러 구독을 동시에 유지할 수 있고 각 프로필마다 업데이트 주기와 활성화 상태를 별도로 설정할 수 있습니다. 업데이트 시에는 원격 변경 사항만 가져오며 로컬 오버레이 레이어는 덮어쓰지 않습니다. YAML을 직접 편집하는 방식과 비교하면 구독 관리는 노드 추가·삭제와 정책 그룹 조정을 한 번의 가져오기로 처리합니다. 링크가 만료되면 패널에 파싱 오류 메시지가 표시되어 링크 만료, 형식 불일치, 네트워크 차단 중 어떤 문제인지 파악하기 쉽습니다.

오픈소스생태계

Clash Verge의 클라이언트와 코어는 모두 공개 저장소에 호스팅되어 버전 릴리스, Issue 토론, 커밋 기록을 추적할 수 있습니다. 아래 정보는 프로젝트의 유지 관리 상태와 업데이트 주기를 파악하는 데 도움이 됩니다.

프로젝트 역사

Clash Verge는 원래 Clash for Windows의 대안으로 등장해, 원 클라이언트가 유지 관리를 중단한 뒤 Windows와 macOS 사용자가 쓸 통합 진입점이 사라진 문제를 해결했습니다. 인터페이스 레이어는 Tauri로 다시 작성되었고 설정 생성과 트래픽 전달은 코어에 맡겨 인터페이스와 코어가 분리되었습니다. 따라서 코어를 업그레이드해도 인터페이스를 다시 만들 필요가 없고, 인터페이스가 업데이트되어도 이미 생성된 설정에는 영향을 주지 않습니다.

코어 관계

mihomo는 Clash 생태계에서 현재 활발히 유지 관리되는 코어로, Clash 설정 파일 형식과 호환되며 규칙 집합, 도메인 스니핑, 추가 전송 프로토콜을 지원합니다. Clash Verge는 mihomo를 내장하고 있어 구독 가져오기로 생성된 config.yaml을 다른 Clash 계열 클라이언트에서도 바로 읽을 수 있어 마이그레이션 비용이 낮고 ClashX Meta, Clash for Android와 설정을 주고받을 수 있습니다.

업데이트 메커니즘

클라이언트와 코어는 각각 별도 버전으로 릴리스됩니다. 인터페이스 업데이트는 설정 페이지 레이아웃, 구독 관리, TUN 동작을 다루고 코어 업데이트는 프로토콜 구현과 보안 수정을 다룹니다. 다운로드 페이지에서 각 플랫폼 설치 패키지를 제공하며, 업데이트 시 로컬 설정이 유지되므로 구독을 다시 가져올 필요가 없습니다. 코어 바이너리도 별도로 제공되어 서버와 라우터 사용자에게 적합합니다.

오픈소스 라이선스 및 커뮤니티

프로젝트는 GPL-3.0 라이선스로 공개되어 있으며 소스 코드, 빌드 스크립트, 릴리스 노트가 모두 공개 저장소에 있습니다. Issue 영역에서 접수된 문제와 수정 진행 상황을 확인할 수 있습니다. 커뮤니티가 유지 관리하는 문서는 설치, 구독 가져오기, 규칙 작성, 문제 해결을 다루며 문제가 생기면 키워드로 기존 토론을 검색할 수 있습니다.

터미널
git clone https://github.com/clash-verge-rev/clash-verge-rev.git

저장소에는 클라이언트 소스 코드, 빌드 스크립트, 릴리스 노트가 포함되어 있으며 라이선스는 GPL-3.0입니다. 클론한 뒤 README의 빌드 단계를 따라 하면 해당 플랫폼의 설치 패키지를 로컬에서 컴파일할 수 있습니다.

기술노트

설치 설정, DNS 해석, TUN 모드, 구독 문제 해결에 대한 실무 기록을 최신순으로 세 편 표시합니다. 전체 목록은 기술 노트 페이지에서 확인할 수 있습니다.

Clash Verge Windows 설치 설정 전체 과정: 설치 패키지 다운로드부터 서비스 모드까지 흔한 함정 7가지

설치, 구독 가져오기, 시스템 프록시 켜기, TUN 전환 순서로 Windows 전체 설정을 진행하며, WebView2 누락, 서비스 설치 실패, 방화벽 차단 등 초보자가 가장 자주 겪는 문제를 하나씩 풀어 설명합니다.

전문 읽기 →

Clash DNS 설정 상세: nameserver, fallback, DNS 가로채기 세 구간 채우는 법

dns 섹션의 enable, listen부터 시작해 nameserver와 fallback의 역할 분담, fallback-filter의 필터링 로직, TUN 모드에서 DNS 가로채기가 Fake-IP와 함께 켜져야만 동작하는 이유를 필드별로 설명합니다.

전문 읽기 →

TUN 모드와 시스템 프록시의 작동 방식 비교: 트래픽이 어느 계층에서 처리되는가

시스템 프록시가 앱이 프록시 설정을 직접 읽어야 하는 방식과 TUN이 가상 네트워크 카드로 모든 IP 트래픽을 처리하는 방식의 차이를 비교하고, 명령줄 도구, 게임, UDP 앱이 두 모드에서 다르게 동작하는 이유와 각각 적합한 사용 사례를 설명합니다.

전문 읽기 →

자주 묻는질문

아래 질문은 설치 및 설정 과정에서 자주 접수되는 문의입니다. 전체 분류별 답변은 자주 묻는 질문 페이지에서 확인할 수 있습니다.

시스템 프록시를 켜도 브라우저에서 접속이 안 됩니다.

먼저 프록시 포트가 다른 프로그램에 점유되지 않았는지 확인하고, 시스템 프록시 스위치가 실제로 적용되었는지 점검하세요. 일부 브라우저 확장 프로그램이 시스템 프록시 설정을 덮어쓸 수 있으므로 확장 프로그램에서 직접 연결로 두고 시스템 프록시만 사용해 보는 방법도 있습니다.

구독 가져오기에서 파싱 오류가 나면 어떻게 하나요?

구독 링크 만료 여부, 서비스 제공자가 반환한 내용이 Clash 형식 YAML인지, 네트워크에서 링크에 직접 접근 가능한지, 코어 버전이 설정의 새 필드를 지원하는지 순서대로 확인하세요.

TUN 모드와 시스템 프록시를 동시에 켤 수 있나요?

가능하지만 보통은 필요 없습니다. TUN이 모든 트래픽을 처리하는 상태에서 시스템 프록시를 추가로 켜면 전달 단계가 하나 더 생깁니다. 명령줄 도구와 UDP 트래픽을 프록시로 보내야 한다면 TUN만 켜고, 일반 웹 브라우징만 한다면 시스템 프록시만 켜는 것이 더 효율적입니다.

구독을 업데이트했는데 노드 목록이 그대로입니다.

업데이트 주기가 아직 되지 않았는지, 구독 링크가 서비스 제공자 측에서 제한되고 있지 않은지, 클라이언트가 프록시 자체의 네트워크 문제로 구독 주소에 접근하지 못하는지 확인하세요. 설정 페이지에서 수동으로 업데이트를 한 번 실행하고 로그를 확인해 보는 방법도 있습니다.