Windows 10/11용 Clash Verge Rev 설치 및 설정 가이드
Windows 설치 파일 선택부터 첫 실행 권한 설정, 구독 가져오기, 시스템 프록시·서비스 모드 설정까지 안내합니다. 백신 차단과 포트 충돌 해결법도 확인하세요.
설치 전 확인: Windows 버전, 아키텍처, 설정 파일 출처
Clash Verge Rev는 그래픽 클라이언트이며, 일반적으로 mihomo 코어가 프록시 연결, DNS, 규칙 기반 트래픽 분배를 처리합니다. 클라이언트 설치는 실행 환경을 준비하는 단계일 뿐입니다. 프록시 노드를 이용하려면 유효한 구독이나 직접 관리하는 설정 파일이 필요합니다. 클라이언트 설치 파일, 구독 주소, 노드 서비스는 서로 다른 항목입니다.
이 가이드는 Windows 10 및 Windows 11 데스크톱 환경을 대상으로 합니다. 최소 시스템 요구 사항, 설치 프로그램 이름, 설정 메뉴 구성은 버전에 따라 달라질 수 있으므로 다운로드 전에 해당 버전의 릴리스 노트를 확인하세요. 아래에서는 화면의 메뉴를 ‘구독’, ‘프록시’, ‘설정’으로 표기합니다. 영어 인터페이스에서는 각각 Profiles, Proxies, Settings로 표시될 수 있습니다.
설치 파일 선택
- Windows에서 ‘설정’ → ‘시스템’ → ‘정보’를 열고 ‘시스템 종류’를 확인하세요. Intel 또는 AMD 기반 일반 데스크톱은 보통 x64 설치 파일을 선택합니다. ARM 기기라면 배포처에서 제공하는 ARM64 패키지를 우선 사용하세요.
- 클라이언트 다운로드 페이지에서 Clash Verge Rev의 Windows 다운로드 항목을 찾은 다음, 해당 릴리스가 지원하는 Windows 버전과 프로세서 아키텍처를 확인하세요.
- 설치 파일을 저장한 뒤 실행하세요. 설치 프로그램에서 WebView2 Runtime이 없다는 메시지가 표시되면 안내에 따라 Microsoft Edge WebView2 런타임을 설치한 후 클라이언트를 다시 실행하세요.
첫 실행: 설치 및 권한 확인
설치 파일을 두 번 클릭하고 설치 마법사의 안내에 따라 설치 폴더를 선택하세요. 첫 실행은 일반 사용자 권한으로 진행하면 됩니다. ‘항상 관리자 권한으로 실행’을 기본값으로 설정할 필요는 없습니다. 구독 관리와 시스템 프록시 사용에는 보통 클라이언트 전체를 계속 관리자 권한으로 실행할 필요가 없습니다.
- Clash Verge Rev를 실행해 메인 창이 정상적으로 표시되고 시스템 트레이에 클라이언트 아이콘이 나타나는지 확인하세요.
- ‘설정’을 열어 현재 버전, 혼합 포트, 서비스 모드 상태를 기록해 두세요. 문제가 생겼을 때 확인하기 쉽습니다.
- ‘로그’를 열고 설정 파일 파싱 오류나 포트 수신 대기 실패가 계속 발생하지 않는지 확인하세요.
- Windows 방화벽에서 네트워크 액세스 허용 여부를 묻는 메시지가 표시되면 실제 사용 범위에 맞게 선택하세요. 이 PC에서만 사용할 경우 프록시 공유를 위해 공용 네트워크 액세스를 추가로 허용할 필요는 없습니다.
Windows SmartScreen의 평판 경고와 보안 소프트웨어의 악성 프로그램 탐지는 서로 다른 문제입니다. 경고가 표시되면 먼저 다운로드 출처, 게시자 정보, 해당 릴리스의 안내를 확인하세요. 출처를 확인할 수 없다면 실행을 중단하세요. 보안 소프트웨어가 파일을 격리했다면 실시간 보호를 바로 끄지 말고 ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’에서 감지 항목을 확인하세요.
창은 열리지만 화면이 비어 있는 경우
먼저 시스템 트레이에서 클라이언트를 종료한 다음 다시 실행하세요. 여전히 빈 화면이면 WebView2 런타임이 정상인지, Windows 업데이트가 완료됐는지, 보안 소프트웨어가 인터페이스 구성 요소를 차단했는지 확인하세요. 여러 버전을 연달아 재설치하지 마세요. 설정을 백업한 뒤 해당 버전의 문제 해결 안내에 따라 실행 환경을 복구하세요.
구독 가져오기: 설정을 선택한 뒤 노드 선택
구독 주소에는 계정 토큰이 포함되는 경우가 많으므로 비밀번호처럼 안전하게 보관하세요. 전체 주소를 공개 로그나 스크린샷에 노출하거나 온라인 설정 변환 사이트에 붙여 넣지 마세요. 구독 제공자가 Clash 또는 mihomo 설정 형식을 지원하는지 확인한 뒤 클라이언트로 가져오세요.
- ‘구독’ 페이지에서 구독 링크 입력란에 전체 주소를 붙여 넣고 ‘가져오기’를 누르세요. 일부 버전에서는 ‘새로 만들기’ 메뉴 안에서 가져올 수 있습니다.
- 원격 콘텐츠 다운로드가 끝날 때까지 기다린 뒤 설정 카드가 생성됐는지 확인하세요. 가져오기에 실패하면 시스템 프록시를 바로 변경하지 말고 HTTP 상태 코드와 파싱 오류부터 확인하세요.
- 설정 카드를 클릭해 현재 사용할 설정으로 지정하세요. 목록에 설정이 표시된다고 해서 코어에서 이미 사용 중인 것은 아닙니다.
- ‘프록시’ 페이지에서 실행 모드를 ‘규칙’으로 설정하세요. 그런 다음 외부 서비스에 사용할 정책 그룹을 펼쳐 사용 가능한 노드를 선택하세요.
- 지연 시간 테스트를 실행한 뒤 실제로 이용하려는 웹사이트에 접속하고, ‘연결’ 페이지에서 적용된 규칙과 아웃바운드 경로를 확인하세요.
지연 시간 테스트 성공은 테스트 대상에 연결할 수 있다는 뜻일 뿐, 모든 웹사이트와 스트리밍 서비스 또는 UDP 트래픽이 작동한다는 보장은 아닙니다. 테스트 결과가 표시되는데 웹페이지가 열리지 않으면 정책 그룹 선택, DNS, 대상 사이트의 연결 로그를 추가로 확인하세요.
업데이트 실패 시 확인 순서
- 401 또는 403: 구독 토큰, 유효 기간, 서비스 제공자의 제한을 확인하세요. 업데이트를 반복해서 눌러도 인증 문제는 해결되지 않습니다.
- 시간 초과 또는 도메인 확인 실패: PC의 네트워크 연결과 구독 도메인을 확인하세요. 프록시를 통해 업데이트하도록 설정했다면 현재 노드에 연결할 수 있는지도 확인하세요.
- YAML 파싱 오류: 응답 내용이 실제 설정 파일인지 확인하세요. 로그인 페이지, 오류 페이지 또는 지원되지 않는 노드 목록일 수 있습니다.
구독을 업데이트하면 원격 설정 내용이 바뀔 수 있습니다. 사용자 지정 규칙을 계속 유지해야 한다면 현재 클라이언트가 지원하는 오버라이드 또는 확장 설정 기능을 사용하고 관련 안내를 먼저 확인하세요. 원격 설정 본문을 직접 수정하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다.
시스템 프록시: 브라우저로 먼저 확인
처음 설정할 때는 시스템 프록시만 사용하고 TUN, 브라우저 프록시 확장 프로그램, 다른 VPN을 동시에 켜지 않는 것이 좋습니다. 변수를 줄이면 ‘코어가 실행되지 않음’, ‘앱이 프록시를 사용하지 않음’, ‘노드를 사용할 수 없음’을 구분하기 쉽습니다.
- 클라이언트에서 ‘시스템 프록시’를 켜고 실행 모드는 ‘규칙’으로 유지하세요.
- Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 열고 수동 프록시가 로컬 수신 주소를 가리키는지 확인하세요.
- 클라이언트 화면에 표시된 포트를 기준으로 확인하세요. 예를 들어 혼합 포트가
7897이면 주소는 보통127.0.0.1, 포트는7897입니다. 다른 가이드의7890을 그대로 사용하지 마세요. - 브라우저의 프록시 관리 확장 프로그램을 잠시 끄고 브라우저를 완전히 닫았다가 다시 열어 대상 페이지에 접속하세요.
- 클라이언트의 ‘연결’ 페이지로 돌아가 해당 요청이 표시되는지 확인하고, 최종적으로 직결 또는 프록시 노드 중 어느 경로를 사용했는지 확인하세요.
터미널에서 별도 확인
일부 명령줄 프로그램은 Windows 시스템 프록시 설정을 따르지 않습니다. PowerShell에서 프록시를 명시해 앱과 로컬 수신 포트 사이의 연결을 테스트할 수 있습니다. 아래 예시에서는 혼합 포트 7897을 사용합니다. 실제 테스트 전에는 설정 페이지에 표시된 포트로 바꾸세요.
Test-NetConnection 127.0.0.1 -Port 7897
curl.exe --proxy http://127.0.0.1:7897 --head --max-time 15 https://example.com/
TcpTestSucceeded : True는 해당 포트로 TCP 연결을 맺을 수 있다는 뜻이지, 원격 노드가 반드시 작동한다는 뜻은 아닙니다. 두 번째 명령에서 HTTP 오류 상태가 반환되더라도 요청이 프록시를 거쳤는지 클라이언트 연결 기록과 함께 확인하세요. 시간 초과가 발생하면 노드와 규칙을 추가로 점검해야 합니다. 이 명령은 연결 여부만 확인하며 실제 속도를 측정하지 않습니다.
서비스 모드와 TUN: 필요한 경우에만 활성화
시스템 프록시는 시스템 프록시 설정을 따르는 앱에 적합합니다. 게임, 일부 런처, 명령줄 도구 또는 자체적으로 네트워크 연결을 만드는 프로그램은 시스템 프록시를 우회할 수 있습니다. TUN 모드는 가상 네트워크 인터페이스를 통해 라우팅 조건에 맞는 트래픽을 처리하므로 적용 범위가 넓지만, 라우팅·DNS 및 다른 VPN과의 호환성도 고려해야 합니다.
서비스 모드 설치 절차
- ‘설정’에서 ‘서비스 모드’ 항목을 찾으세요. 현재 버전에서 하위 메뉴에 있다면 해당 버전의 화면을 기준으로 진행하세요.
- 서비스 설치 버튼을 누르세요. Windows 사용자 계정 컨트롤 창이 표시되면 프로그램 출처를 확인한 뒤 권한을 허용하세요.
- 상태가 서비스 설치 완료 및 실행 중으로 표시될 때까지 기다린 다음 ‘서비스 모드’를 켜세요. 설치 후 자동으로 활성화되는 버전도 있으므로 상태를 기준으로 확인하세요.
- TUN이 필요하다면 ‘TUN 모드’를 켜고 로그에서 가상 인터페이스, 라우팅, DNS 초기화 오류가 있는지 확인하세요.
서비스 모드는 백그라운드 서비스에서 코어 관리 등 더 높은 권한이 필요한 작업을 처리하는 기능입니다. 시스템 프록시와 같은 기능이 아니며 TUN이 자동으로 활성화되는 것도 아닙니다. 서비스 설치에 성공했다는 이유만으로 모든 앱의 트래픽이 처리된다고 판단하지 마세요.
| 사용 목적 | 우선 설정 | 확인 위치 |
|---|---|---|
| 브라우저에서 웹페이지 접속 | 시스템 프록시 및 규칙 모드 | Windows 프록시 설정, 클라이언트 연결 페이지 |
| 터미널에서 한 번만 요청 | 프로그램의 프록시 옵션 직접 지정 | 명령 출력, 로컬 혼합 포트 |
| 시스템 프록시를 따르지 않는 앱 | 필요한 경우 TUN 활성화 | 코어 로그, 라우팅, DNS |
| 높은 권한이 필요한 기능을 계속 사용 | 서비스 모드 설치 및 활성화 | 클라이언트의 서비스 상태 |
TUN을 켠 뒤 사내 네트워크, 프린터 또는 LAN 서비스에 연결할 수 없다면 먼저 TUN을 끄고 비교한 다음, 우회할 네트워크 대역 규칙과 다른 VPN을 확인하세요. 기존 설정을 파악하지 않은 채 시스템 라우팅을 제어하는 프로그램을 여러 개 동시에 실행하지 마세요. UDP 사용 가능 여부는 노드 프로토콜, 서버 지원, 규칙에 따라 달라집니다. TUN 스위치만으로 이 조건을 충족할 수는 없습니다.
Windows 시작 시 자동 실행: 인터페이스·코어·프록시를 각각 확인
‘시작 시 자동 실행’은 일반적으로 Windows에 로그인한 뒤 클라이언트를 실행하는 기능이며, 백그라운드 서비스가 시작되는 시점과는 다릅니다. 서비스가 실행 중이어도 그래픽 인터페이스에서 선택한 설정이 로드됐다는 보장은 없습니다. 자동 실행을 설정한 뒤에는 실제로 PC를 재시작해 확인해야 합니다.
- ‘설정’에서 ‘시작 시 자동 실행’을 켜세요. 바탕 화면에 창이 표시되지 않도록 하려면 현재 버전에서 제공하는 자동 시작 또는 시작 시 최소화 옵션도 함께 설정할 수 있습니다.
- Windows ‘설정’ → ‘앱’ → ‘시작 앱’을 열어 클라이언트의 시작 항목이 비활성화되지 않았는지 확인하세요. 작업 관리자의 ‘시작 앱’에서도 확인할 수 있습니다.
- 정상 작동을 확인한 설정과 정책 그룹 선택을 유지하세요. TUN을 사용하는 경우 서비스 모드 상태가 정상인지 확인하세요.
- PC를 재시작하고 로그인한 뒤 바탕 화면과 시스템 트레이가 완전히 로드될 때까지 기다리세요. 클라이언트가 실행됐는지, 코어가 작동하는지, 설정이 적용됐는지 확인하세요.
- 대상 웹페이지에 접속해 ‘연결’ 페이지에서 아웃바운드 경로를 확인하세요. 시스템 프록시를 사용하는 경우 Windows의 프록시 주소와 포트도 점검하세요.
시작 항목은 있지만 실행되지 않는다면 먼저 보안 소프트웨어 기록, 설치 폴더 변경 여부, 클라이언트 로그를 확인하세요. 처음부터 작업 스케줄러를 추가하지 마세요. 인스턴스가 두 개 실행되면서 포트 충돌이 발생할 수 있습니다. Windows의 ‘다시 시작 가능한 앱’ 기능은 이전에 닫지 않은 창을 복원할 수도 있으므로 클라이언트의 자동 실행과 구분하세요.
자주 발생하는 문제: 로그를 기준으로 확인하고 설정을 겹쳐 켜지 않기
포트 충돌: address already in use 오류
먼저 다른 프록시 클라이언트를 종료한 다음 로컬 포트의 수신 상태를 확인하세요. 아래 예시에서는 7897을 사용하며, 명령을 실행하면 해당 포트를 사용 중인 프로세스 ID가 표시됩니다.
Get-NetTCPConnection -LocalPort 7897 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
작업 관리자의 ‘세부 정보’에서 PID로 해당 프로세스를 찾으세요. 용도를 확인한 뒤 관련 프로그램을 정상적으로 종료하거나 Clash Verge Rev 설정에서 혼합 포트를 변경하고 시스템 프록시를 다시 활성화하세요. 정체를 모르는 시스템 프로세스를 강제로 종료하지 마세요. 명령 결과에 수신 기록이 없더라도 포트 예약이나 권한 오류가 있는지 추가로 확인해야 합니다. 결과가 비어 있다는 이유만으로 코어가 정상이라고 판단할 수는 없습니다.
클라이언트를 종료한 뒤 브라우저에서 인터넷에 연결되지 않는 경우
먼저 Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 확인하세요. 수동 프록시가 여전히 127.0.0.1을 가리키는데 클라이언트가 종료됐다면 수동 프록시를 끄세요. 정상적으로 종료하려면 클라이언트의 ‘시스템 프록시’를 먼저 끈 뒤 시스템 트레이에서 종료하세요. 비정상 종료로 프록시 설정이 남는 일을 방지할 수 있습니다.
서비스 설치 실패 또는 TUN 시작 불가
서비스를 설치할 때 표시된 오류를 기록하고 계정에 관리자 권한이 있는지, 보안 소프트웨어가 서비스 구성 요소를 격리했는지, 다른 VPN이 실행 중인지 확인하세요. 먼저 시스템 프록시가 작동하도록 복구한 뒤 서비스 모드와 TUN을 각각 따로 테스트하세요. 서비스를 제거해야 한다면 알 수 없는 서비스를 직접 삭제하지 말고 클라이언트 설정의 서비스 제거 기능을 우선 사용하세요.
문제 해결 정보를 전달하기 전 정리
- Windows 버전, 클라이언트 버전, 코어 버전, 설치 파일 아키텍처를 기록하세요.
- 실행 모드, 혼합 포트, 시스템 프록시, 서비스 모드, TUN의 활성화 상태를 기록하세요.
- 오류가 발생하기 직전과 직후의 관련 로그만 캡처하고 구독 토큰, 계정 정보, 노드 인증 정보는 가리세요.
- 문제가 재현되는지, TUN을 끄거나 다른 프록시 프로그램을 종료했을 때 결과가 어떻게 달라지는지 적으세요.
기본 사용이 확인된 뒤 사용자 지정 DNS, 규칙 오버라이드, LAN 공유를 하나씩 추가하세요. 한 번에 한 항목만 변경하고 되돌릴 방법을 마련하면 여러 스위치를 동시에 바꾸는 것보다 원인을 찾기 쉽습니다. 일반적인 점검 절차는 문제 해결 가이드에서 확인하세요. 정책 그룹, 규칙, TUN의 차이를 확인하려면 용어 빠른 확인을 참고하세요.