ClashVerge 사용 문서

처음 사용하는 분을 위한 가이드입니다. 설치, 구독 가져오기, 프록시 모드 선택, 기본 문제 해결을 다룹니다. 화면 문구는 버전에 따라 조금 다를 수 있습니다.

빠른 시작

  1. 1. 플랫폼에 맞는 설치 파일 받기

    다운로드 페이지에서 OS와 칩에 맞는 Stable을 선택하세요.

  2. 2. ClashVerge 설치 및 실행

    설치 후 클라이언트를 실행하세요. 첫 실행 시 방화벽·서비스 설치 등 권한을 요청할 수 있습니다.

  3. 3. 구성 가져오기 및 프록시 켜기

    구독 또는 로컬 YAML을 가져온 뒤 시스템 프록시(또는 TUN)를 켜고 노드를 선택한 다음 지연 테스트를 실행하세요.

설치

Windows

64비트(x64) 설치 파일 x64-setup.exe를 실행하세요. WebView2가 없으면 fixed WebView2 패키지 또는 Microsoft WebView2 Runtime을 사용하세요.

macOS

DMG를 열고 앱을 응용 프로그램으로 드래그하세요. 개발자를 확인할 수 없다고 나오면 시스템 설정 → 개인정보 보호 및 보안에서 허용하세요. 칩과 패키지가 일치하는지 확인하세요.

Linux

Debian / Ubuntu는 DEB, Fedora / RHEL은 RPM을 사용하세요. Releases에서 배포판에 맞는 다른 형식도 찾을 수 있습니다.

구독 / 구성 가져오기

  1. 클라이언트의 Profiles(구성) 화면을 엽니다.
  2. 새로 만들기 / 가져오기를 선택하고 HTTPS 구독 URL을 붙여넣거나 로컬 YAML을 불러옵니다.
  3. 가져오기를 기다립니다. 실패하면 네트워크, URL 유효성, HTTPS를 확인하세요.
  4. 구성을 활성화한 뒤 프록시 그룹과 규칙이 로드되었는지 확인합니다.

안내: 본 사이트는 구독이나 노드를 제공하지 않습니다. 합법적으로 확보한, 현지 법규에 맞는 구성만 사용하세요.

시스템 프록시와 TUN

시스템 프록시

시스템 프록시를 따르는 브라우저·앱에 적합합니다. 일상 사용의 기본 선택입니다.

TUN 모드

가상 NIC로 더 넓은 트래픽을 제어합니다. CLI나 시스템 프록시를 무시하는 앱에 유용하며, 서비스와 높은 권한이 필요할 수 있습니다.

규칙 / 전역 / 직접 모드도 이해하세요. 일상에는 규칙 모드를 권장합니다.

노드 선택과 지연 테스트

  • Proxies 화면에서 프록시 그룹과 노드를 선택합니다.
  • Delay Test로 사용 가능한 노드를 빠르게 걸러냅니다.
  • 지연이 높거나 시간 초과되면 노드를 바꾸고, 구독 만료 여부와 로그를 확인하세요.

문제 해결

구독 업데이트 실패

URL, 네트워크, 인증서를 확인하고 캐시를 지운 뒤 다시 시도하세요. 필요하면 구성을 수동으로 받아 로컬로 가져오세요.

프록시를 켠 뒤 인터넷이 안 됨

먼저 직접 모드로 전환해 기기 네트워크를 확인한 뒤, 노드·규칙·DNS·TUN 서비스 상태를 점검하세요.

포트 충돌

혼합/HTTP/SOCKS/제어 포트가 사용 중이면 설정에서 포트를 바꾸고, 그 포트에 의존하는 외부 도구도 함께 수정하세요.

설치 파일이 필요하면 다운로드 페이지로 이동하세요. 소스와 릴리스 노트는 GitHub 저장소에서 확인할 수 있습니다.