Clash Verge Windows 설치 설정 전체 과정: 설치 패키지 다운로드부터 서비스 모드까지 흔한 함정 7가지
설치, 구독 가져오기, 시스템 프록시 켜기, TUN 전환 순서로 Windows 전체 설정을 진행하며, WebView2 누락, 서비스 설치 실패, 방화벽 차단 등 초보자가 가장 자주 겪는 문제를 하나씩 풀어 설명합니다.
전문 읽기 →mihomo 코어
mihomo 코어 기반 오픈소스 프록시 클라이언트로, 구독 관리, 규칙 분기, TUN 모드를 내장했으며 한국어 설정 문서와 멀티 플랫폼 설치 패키지를 제공합니다.
Clash Verge는 mihomo 코어 기반 오픈소스 프록시 클라이언트로 Windows, macOS, Linux, Android, iOS를 지원합니다. 클라이언트는 구독 관리, 설정 생성, 인터페이스 표시를 담당하고 트래픽 전달은 코어가 처리하며, 설정 형식은 Clash 생태계와 호환됩니다. 다운로드 페이지에는 플랫폼별 클라이언트, 설치 패키지 형식, 시스템 요구 사항이 정리되어 있고, 설치 패키지는 공식 배포 채널과 동기화됩니다. 아래 링크는 해당 플랫폼의 다운로드 카드로 바로 이동합니다.
Win10 / Win11 x64 및 ARM64. Clash Verge Rev, FlClash 등 설치 패키지 제공.
다운로드로 이동Intel 및 Apple Silicon 듀얼 아키텍처. Clash Plus, Clash Verge Rev, FlClash 선택 가능.
다운로드로 이동Android 8.0 이상. Clash Meta for Android, FlClash, Surfboard APK 제공.
다운로드로 이동iPhone 및 iPad 공용. App Store에서 등록된 클라이언트를 설치하며 Clash Plus를 지원합니다.
다운로드로 이동Clash Verge는 mihomo 코어 기반 오픈소스 프록시 클라이언트로 Windows, macOS, Linux, Android, iOS를 지원합니다. 클라이언트는 구독 관리, 설정 생성, 인터페이스 표시를 담당하고 트래픽 전달은 코어가 처리하며, 설정 형식은 Clash 생태계와 호환됩니다. 다운로드 페이지에는 플랫폼별 클라이언트, 설치 패키지 형식, 시스템 요구 사항이 정리되어 있고, 설치 패키지는 공식 배포 채널과 동기화됩니다. 아래 링크는 해당 플랫폼의 다운로드 카드로 바로 이동하며, 각 플랫폼의 지원 OS 버전, 추천 클라이언트, 설치 시 주의사항이 함께 표시됩니다.
Win10 / Win11 x64 및 ARM64. Clash Verge Rev, FlClash, Clash Nyanpasu 등 설치 패키지 제공. 최초 설치 시 WebView2 런타임이 필요합니다.
다운로드로 이동Intel 및 Apple Silicon 듀얼 아키텍처. Clash Plus, Clash Verge Rev, FlClash 등 클라이언트 제공. ARM 칩은 Apple Silicon 패키지를 우선 선택하세요.
다운로드로 이동Android 8.0 이상. Clash Meta for Android, FlClash, Surfboard APK 제공. V2Ray 및 Trojan 프로토콜을 지원합니다.
다운로드로 이동iPhone 및 iPad 공용. App Store에서 등록된 클라이언트를 설치하며 Clash Plus를 지원합니다. 설정 파일 형식은 데스크톱 버전과 동일합니다.
다운로드로 이동.deb 및 .rpm 설치 패키지 제공. x64와 ARM64를 지원하며 Debian/Ubuntu 및 Fedora 계열 배포판에 적합합니다. mihomo 코어 바이너리도 별도로 제공됩니다.
다운로드로 이동Clash Verge는 프록시 클라이언트의 주요 기능을 바로 사용할 수 있는 설정 항목으로 제공합니다. 구독을 가져오면 전체 설정이 자동 생성되고, 규칙 분기는 도메인과 IP를 기준으로 정책 그룹을 매칭하며, TUN 모드는 시스템 트래픽을 처리하고, DNS 섹션에서는 해석 경로를 세밀하게 제어할 수 있습니다. 아래 네 개 패널은 클라이언트 설정 페이지의 실제 모듈에 해당하며, 각 항목은 사용 문서와 고급 사용법 페이지에서 관련 설정 설명과 문제 해결 단계를 확인할 수 있습니다.
구독 관리는 서비스 제공자의 구독 링크를 클라이언트로 가져와 proxies, proxy-groups, rules 세 구간으로 자동 파싱합니다. 여러 구독을 동시에 유지할 수 있고 각 프로필마다 업데이트 주기와 활성화 상태를 별도로 설정할 수 있습니다. 업데이트 시에는 원격 변경 사항만 가져오며 로컬 오버레이 레이어는 덮어쓰지 않습니다. YAML을 직접 편집하는 방식과 비교하면 구독 관리는 노드 추가·삭제와 정책 그룹 조정을 한 번의 가져오기로 처리합니다. 링크가 만료되면 패널에 파싱 오류 메시지가 표시되어 링크 만료, 형식 불일치, 네트워크 차단 중 어떤 문제인지 파악하기 쉽습니다.
TUN 모드는 가상 네트워크 카드를 통해 시스템 차원에서 모든 IP 트래픽을 처리하므로 앱이 프록시 설정을 직접 읽을 필요가 없습니다. 시스템 프록시 모드에서는 명령줄 도구, 게임, UDP 앱이 우회되는 경우가 많은데, TUN을 켜면 이런 트래픽도 모두 코어로 들어와 규칙에 따라 전달됩니다. 설정 페이지에는 TUN 모드 스위치, 스택 유형, DNS 가로채기 옵션이 있으며 Fake-IP와 함께 사용하면 해석 지연을 줄일 수 있습니다. Windows에서 처음 켤 때는 서비스 설치와 방화벽 허용이 필요하며, 실패하면 로그 페이지에서 서비스 설치 오류 코드를 확인할 수 있습니다.
규칙 분기는 서로 다른 도메인과 IP가 서로 다른 정책 그룹을 사용하도록 합니다. 규칙은 위에서 아래로 순서대로 매칭되며, 일치하면 즉시 중단됩니다. DOMAIN-SUFFIX는 하위 도메인, DOMAIN-KEYWORD는 키워드, GEOIP는 지역별 분기, MATCH는 최종 폴백으로 자주 사용됩니다. 구독에서 생성된 규칙 집합은 주요 스트리밍 서비스와 광고 도메인을 포함하며, 고급 사용자는 오버레이 레이어에 사용자 규칙을 추가해 국내 직접 연결, 해외 프록시, 특정 사이트 전용 노드 같은 분기 전략을 구성할 수 있습니다. 규칙 순서를 바꾸면 즉시 적용되며 코어를 재시작할 필요가 없습니다.
DNS 섹션은 도메인 해석 결과가 코어로 들어오는 방식을 결정합니다. nameserver는 일반 해석을 담당하고, fallback은 민감한 도메인의 2차 해석에 사용되며, fallback-filter는 어떤 도메인이 폴백에 참여할지 제어합니다. TUN 모드에서 DNS 가로채기를 켜면 해석 요청이 모두 코어를 거쳐 유출을 방지합니다. Fake-IP 모드는 도메인에 가상 IP를 할당해 연결이 수립되기 전에 규칙 매칭을 완료하므로 첫 패킷 지연을 줄입니다. 설정 오류는 특정 사이트가 열리지 않는 형태로 나타나는 경우가 많으므로 문서를 보며 필드별로 점검하면 됩니다.
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 모드, 구독 문제 해결에 대한 실무 기록을 최신순으로 세 편 표시합니다. 전체 목록은 기술 노트 페이지에서 확인할 수 있습니다.
설치, 구독 가져오기, 시스템 프록시 켜기, TUN 전환 순서로 Windows 전체 설정을 진행하며, WebView2 누락, 서비스 설치 실패, 방화벽 차단 등 초보자가 가장 자주 겪는 문제를 하나씩 풀어 설명합니다.
전문 읽기 →dns 섹션의 enable, listen부터 시작해 nameserver와 fallback의 역할 분담, fallback-filter의 필터링 로직, TUN 모드에서 DNS 가로채기가 Fake-IP와 함께 켜져야만 동작하는 이유를 필드별로 설명합니다.
전문 읽기 →시스템 프록시가 앱이 프록시 설정을 직접 읽어야 하는 방식과 TUN이 가상 네트워크 카드로 모든 IP 트래픽을 처리하는 방식의 차이를 비교하고, 명령줄 도구, 게임, UDP 앱이 두 모드에서 다르게 동작하는 이유와 각각 적합한 사용 사례를 설명합니다.
전문 읽기 →아래 질문은 설치 및 설정 과정에서 자주 접수되는 문의입니다. 전체 분류별 답변은 자주 묻는 질문 페이지에서 확인할 수 있습니다.
먼저 프록시 포트가 다른 프로그램에 점유되지 않았는지 확인하고, 시스템 프록시 스위치가 실제로 적용되었는지 점검하세요. 일부 브라우저 확장 프로그램이 시스템 프록시 설정을 덮어쓸 수 있으므로 확장 프로그램에서 직접 연결로 두고 시스템 프록시만 사용해 보는 방법도 있습니다.
구독 링크 만료 여부, 서비스 제공자가 반환한 내용이 Clash 형식 YAML인지, 네트워크에서 링크에 직접 접근 가능한지, 코어 버전이 설정의 새 필드를 지원하는지 순서대로 확인하세요.
가능하지만 보통은 필요 없습니다. TUN이 모든 트래픽을 처리하는 상태에서 시스템 프록시를 추가로 켜면 전달 단계가 하나 더 생깁니다. 명령줄 도구와 UDP 트래픽을 프록시로 보내야 한다면 TUN만 켜고, 일반 웹 브라우징만 한다면 시스템 프록시만 켜는 것이 더 효율적입니다.
업데이트 주기가 아직 되지 않았는지, 구독 링크가 서비스 제공자 측에서 제한되고 있지 않은지, 클라이언트가 프록시 자체의 네트워크 문제로 구독 주소에 접근하지 못하는지 확인하세요. 설정 페이지에서 수동으로 업데이트를 한 번 실행하고 로그를 확인해 보는 방법도 있습니다.