Windows
다운로드 페이지에서 Clash Plus, Clash Verge Rev 등을 확인할 수 있습니다. 처음 사용하는 경우 Windows 시스템 요구 사항을 확인한 뒤 설정을 가져오고 시스템 프록시를 활성화하세요. TUN이 필요할 때 서비스 권한을 설정하면 됩니다. 설치 단계에서 모든 기능을 한꺼번에 켤 필요는 없습니다.
다운로드 페이지로 이동Clash Verge Rev 설치부터 시작해 시스템 프록시와 mihomo 규칙 기반 라우팅을 알아보고, 필요에 따라 구독, DNS, YAML 설정을 조정하세요.
시스템 설정은 트래픽이 들어오는 경로만 처리합니다. 구독, 라우팅, 도메인 조회는 클라이언트와 커널이 함께 처리해야 합니다.
Windows 시스템 프록시는 모든 앱에 적용되는 통합 스위치가 아닙니다. 일부 명령줄 도구, 게임, 자체 네트워크 스택을 사용하는 프로그램은 시스템 프록시 설정을 따르지 않습니다. 별도로 프록시를 설정하거나 TUN 모드 사용을 검토해야 합니다.
클라이언트를 종료하기 전에 프록시 주소를 원래대로 복원하지 않으면 브라우저가 중지된 로컬 포트에 계속 연결을 시도할 수 있습니다. 문제를 확인할 때는 네트워크 장애와 로컬 포트의 수신 중단을 먼저 구분하세요. 서둘러 시스템을 재설치할 필요는 없습니다.
원격 설정을 다시 받으면 로컬에서 임시로 추가한 규칙이 사라질 수 있습니다. 같은 내용을 반복해서 수정하면 변경 사항을 추적하기 어렵고 YAML 들여쓰기나 정책 그룹 이름을 잘못 바꿀 위험도 있습니다.
설정 화면에서 시스템 프록시와 TUN을 각각 관리하세요. 먼저 시스템 프록시로 기본 연결을 확인한 다음, 더 많은 앱의 트래픽을 처리해야 할 때 가상 네트워크 어댑터를 활성화하세요. 여러 설정을 한꺼번에 바꾸지 않는 것이 좋습니다.
규칙 모드는 도메인, 주소, 규칙 세트를 순서대로 확인하고, 정책 그룹은 규칙에 일치한 트래픽의 아웃바운드를 결정합니다. 연결 화면과 로그에서 실제 경로를 확인하세요. 스위치가 켜져 있는지만 봐서는 알 수 없습니다.
클라이언트가 지원하는 오버라이드 또는 병합 기능으로 필요한 필드를 저장하세요. 구독은 기본 설정을 제공하고 로컬 설정은 규칙을 보완합니다. 업데이트 후에는 최종 적용 결과를 다시 확인하세요.
# 설정 구조 예시이며 프록시 노드는 포함하지 않습니다
mixed-port: 7897
mode: rule
proxy-groups:
- name: 기본 아웃바운드
type: select
proxies:
- DIRECT
rules:
- MATCH,기본 아웃바운드
YAML 필드 설명 보기 →
먼저 트래픽이 어디로 들어오는지 확인한 다음 어떤 규칙을 적용할지 정하세요. 아래 설정 조각은 필드를 설명하기 위한 것으로, 완전한 구독 설정을 대신하지 않습니다.
규칙 모드는 모든 연결을 하나의 아웃바운드로 보내는 기능이 아닙니다. mihomo는 규칙을 위에서부터 확인해 처음 일치하는 규칙에 해당하는 정책을 적용합니다. 따라서 구체적인 도메인 규칙은 포괄적인 규칙보다 앞에, 최종 대체 규칙은 맨 뒤에 배치해야 합니다. 클라이언트에서 정책 그룹을 확인하고 선택지를 바꿀 수는 있지만, 잘못된 규칙 순서를 자동으로 고쳐 주지는 않습니다. 특정 웹사이트의 연결 경로가 예상과 다르면 연결 상세 화면에서 일치한 규칙을 확인한 뒤 그룹 이름이 설정과 일치하는지 살펴보세요. 시스템 프록시만 변경하는 것보다 LAN 트래픽은 직접 연결하고 나머지는 별도로 처리하는 기준을 명확하게 설정할 수 있습니다.
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,기본 아웃바운드
규칙 문법 보기 →
TUN 모드는 가상 네트워크 어댑터와 라우팅을 사용해 트래픽을 처리하므로 더 많은 앱의 연결을 제어해야 할 때 유용합니다. 규칙 모드와는 담당 계층이 다릅니다. TUN은 트래픽이 커널에 들어오는 방식을 정하고, 규칙 모드는 커널에 들어온 트래픽의 아웃바운드를 정합니다. Windows에서는 클라이언트 서비스에 적절한 권한이 필요한 경우가 많으므로 활성화 전에 서비스가 설치되어 있는지 확인하세요. 다른 VPN이나 가상 네트워크 어댑터 도구를 함께 사용한다면 라우팅 충돌도 점검해야 합니다. TUN을 모든 연결 문제를 해결하는 만능 기능으로 여기지 마세요. 기본 구독이 작동하지 않는다면 트래픽 제어 범위를 넓혀도 원격 연결 문제가 해결되지는 않습니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
단계별로 연결 확인하기 →
구독 관리는 구독 주소 저장, 설정 가져오기, 현재 사용할 설정 파일 선택을 담당합니다. 가져오기에 성공해도 노드가 반드시 작동하는 것은 아니며, 업데이트 실패가 구독 주소가 만료되었다는 뜻도 아닙니다. 먼저 구독 주소가 로그인 페이지나 오류 메시지, 다른 형식의 구독이 아니라 클라이언트가 지원하는 설정을 반환하는지 확인하세요. 업데이트 후에는 활성 항목이 바뀌었는지, 로컬 오버라이드가 계속 적용되는지도 살펴보세요. 구독 주소에는 접근 정보가 포함될 수 있으므로 로그, 스크린샷, 설정을 공유하기 전에 해당 정보를 삭제해야 합니다. 클라이언트마다 구독을 저장하는 방식이 다를 수 있으니 이전하기 전에 별도로 백업하는 것이 좋습니다.
# 설정에 다음 최상위 필드가 있는지 확인
# 구체적인 노드와 그룹 내용은 구독 제공자가 지정합니다
proxies: []
proxy-groups: []
rules:
- MATCH,DIRECT
구독 가져오기 가이드 보기 →
시스템 프록시는 로컬 수신 주소를 Windows 프록시 설정에 기록해 해당 설정을 따르는 앱에서 사용하도록 합니다. 시작 시 자동 실행은 로그인 후 클라이언트를 실행할지 결정할 뿐, 구독이 작동하거나 프록시가 자동으로 활성화된다는 뜻은 아닙니다. 처음 설정할 때는 커널이 실행 중인지 확인한 다음 시스템 프록시를 켜고 브라우저에서 연결을 테스트하세요. 프로그램이 비정상적으로 종료된 뒤 웹페이지에 접속할 수 없다면 시스템 프록시가 수신이 중단된 로컬 포트를 가리키는지 확인하세요. LAN 연결 허용은 별도의 설정입니다. 한 대의 기기만 사용한다면 보통 켤 필요가 없으며, 다른 기기와 공유해야 한다면 방화벽과 접근 범위도 함께 고려해야 합니다.
# 커널 수신 설정이며 시스템 프록시 전환은 클라이언트에서 관리합니다
mixed-port: 7897
allow-lan: false
bind-address: "127.0.0.1"
Windows 시작 가이드 보기 →
DNS 유출 방지는 옵션 하나를 켠다고 보장되는 결과가 아닙니다. 시스템 리졸버, 브라우저의 보안 DNS, 앱 자체의 DNS 조회, TUN의 DNS 가로채기 설정에 따라 요청이 실제로 지나가는 경로가 달라질 수 있습니다. mihomo에서 DNS 조회 방식과 업스트림 서버를 설정할 수 있지만, 현재 트래픽 유입 경로와 함께 검증해야 합니다. fake-ip를 사용한다면 실제 주소가 필요한 LAN 서비스에 주의하세요. 호환성 문제가 생기면 DNS 설정 전체를 무작정 복사하지 말고 해당 도메인에 필터를 지정하세요. 문제를 조사할 때는 도메인 조회와 연결 아웃바운드 기록을 따로 남겨 두어 서로 다른 문제를 혼동하지 않도록 하세요.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
DNS 필드와 검증 범위 보기 →
원격 구독은 노드와 기본 정책을 관리하는 데 적합하고, 로컬 오버라이드는 포트, LAN 옵션, 개인 규칙을 저장하는 데 적합합니다. 두 설정을 나누면 구독을 업데이트할 때 원본 파일을 매번 직접 수정하지 않아도 됩니다. 단, 클라이언트마다 병합 방식이 다릅니다. 맵 필드는 재귀적으로 병합될 수 있지만 목록은 통째로 교체될 수 있습니다. 아래 예시는 오버라이드할 필드만 보여 주며 모든 클라이언트에서 같은 메뉴를 사용한다는 뜻은 아닙니다. 저장 전에 원본 설정을 백업하고, 저장 후에는 최종 생성 파일과 로그를 확인해 이후 설정에서 필드가 덮어써지지 않았는지 살펴보세요. 이전 클라이언트의 스크립트를 옮길 때는 특히 실행 시점을 확인해야 합니다.
# 로컬 오버라이드 예시
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info
오버라이드 및 병합 설명 보기 →
데스크톱과 모바일은 트래픽을 제어하는 방식이 다릅니다. 먼저 운영체제를 선택한 다음 클라이언트, 프로세서 아키텍처, 설치 방법을 비교하세요.
다운로드 페이지에서 Clash Plus, Clash Verge Rev 등을 확인할 수 있습니다. 처음 사용하는 경우 Windows 시스템 요구 사항을 확인한 뒤 설정을 가져오고 시스템 프록시를 활성화하세요. TUN이 필요할 때 서비스 권한을 설정하면 됩니다. 설치 단계에서 모든 기능을 한꺼번에 켤 필요는 없습니다.
다운로드 페이지로 이동Apple Silicon 또는 Intel 프로세서에 맞는 설치 패키지를 선택하세요. 네트워크 확장, 시스템 프록시, 백그라운드 권한은 클라이언트 안내에 따라 설정해야 합니다. ClashX Meta 다운로드를 찾고 있다면 보수 상태를 먼저 비교한 뒤 아카이브된 클라이언트를 사용할지 결정할 수 있습니다.
다운로드 페이지로 이동Clash Plus, Clash Meta for Android, FlClash 등을 비교해 보세요. 모바일 클라이언트는 보통 시스템 VPN 권한으로 트래픽을 제어하므로 사용 전에 다른 VPN이 실행 중인지 확인해야 합니다. 백그라운드 배터리 제한으로 연결이 오래 유지되지 않을 수도 있습니다.
다운로드 페이지로 이동Clash iOS 클라이언트 페이지에는 Clash Plus의 App Store 페이지와 공식 웹사이트 clashplus.io가 안내되어 있습니다. 설정을 가져온 뒤 시스템 안내에 따라 네트워크 연결을 허용하세요. 데스크톱 클라이언트의 스크립트와 플랫폼 전용 필드가 모바일에서도 그대로 작동한다고 가정해서는 안 됩니다.
다운로드 페이지로 이동데스크톱에서는 Clash Verge Rev와 FlClash부터 살펴보고, 배포판에 맞는 패키지 형식을 선택하세요. 서버와 라우터에서는 커널 안내를 확인해 서비스 시작 방식, 수신 주소, 권한을 별도로 구성해야 합니다. 로컬 프록시 포트가 인터넷에 직접 노출되지 않도록 주의하세요.
다운로드 페이지로 이동Clash for Windows에서 이전할 때는 먼저 기존 설정과 규칙을 백업한 다음 새 클라이언트에서 구독 파싱, 정책 그룹 선택, 시스템 프록시 복원을 확인하세요. 설정 파일 확장자가 같아도 커널마다 지원하는 필드가 모두 같은 것은 아닙니다. 클라이언트를 비교하려면 먼저 클라이언트 비교를 읽고 다운로드 페이지로 돌아와 설치 패키지를 선택하세요.
전체 클라이언트 보기 →각 구성 요소의 역할을 이해하면 스위치 하나만 확인하는 것보다 문제를 찾기 쉽습니다. 이 사이트는 다운로드 경로와 설정 안내를 정리하며, 소프트웨어 동작은 프로젝트 구현과 실제 설정에 따라 달라집니다.
Clash 생태계의 GUI 클라이언트는 보통 창, 트레이 메뉴, 구독 저장, 시스템 연동을 담당하고, 커널은 프록시 프로토콜, 규칙 매칭, 도메인 조회를 처리합니다. mihomo는 Clash Meta의 기술 계보를 이어받아 관련 설정 기능을 지원합니다. Clash Verge Rev는 mihomo를 사용하는 클라이언트 중 하나입니다. 화면에 보이는 모든 기능이 커널 설정 필드인 것은 아닙니다. 예를 들어 시작 시 자동 실행은 클라이언트와 운영체제가 함께 처리하므로 공통 YAML 조각을 복사한다고 모든 시스템에서 활성화되는 것은 아닙니다.
동작을 확인해야 한다면 프로젝트 문서, 릴리스 노트, 이슈 기록을 먼저 살펴본 다음 소스 코드에서 관련 부분을 찾으세요. mihomo 공개 저장소는 MetaCubeX 조직에서 관리하며 설정 필드 지원, 프로토콜 처리, 알려진 문제를 확인하는 데 유용합니다. 별 수나 다운로드 수를 기술적 판단의 근거로 삼지 않습니다. 수치가 정확하더라도 특정 설정이 현재 네트워크에 적합한지는 알 수 없습니다. 문제를 제보할 때는 운영체제, 재현 단계, 민감한 정보를 삭제한 로그를 제공해 다른 사람도 같은 문제를 확인할 수 있도록 하세요.
GUI와 커널은 각각 별도로 업데이트될 수 있습니다. 클라이언트를 업데이트한 뒤 기존 설정에서 오류가 발생하면 로그에 표시된 필드나 줄 번호를 확인하고 해당 커널의 문서와 대조하세요. 이전 과정에서 기존 스크립트, DNS 설정, 오버라이드 규칙을 한꺼번에 옮기지 마세요. 먼저 기본 구독이 작동하는지 확인한 뒤 로컬 설정을 하나씩 복원하고 각 단계마다 검증하세요. 그러면 구독 내용, 병합 순서, 시스템 네트워크 환경 중 어디에서 문제가 생겼는지 파악하기 쉽습니다.
클라이언트는 설정 및 연결 도구이며 네트워크 서비스 자체가 아닙니다. 노드, 구독 주소, 접근 권한은 사용자가 직접 선택하고 관리해야 하며 이 사이트는 구독 계정을 제공하지 않습니다. 다운로드 전에는 소프트웨어 출처와 구독 출처를 구분하고, 수신 주소를 변경하기 전에 접근 범위를 이해하세요. 거주 지역의 법률과 사용 중인 네트워크의 관리 규정을 준수하세요. 회사 기기나 공유 네트워크를 사용하는 경우 권한을 먼저 확인한 뒤 시스템 프록시, 가상 네트워크 어댑터, 라우팅을 설정하세요.
구독 형식부터 기존 클라이언트 이전까지, 문제에 맞는 절차를 확인하세요. 작동하는 설정을 먼저 보존하고 달라진 부분을 하나씩 살펴보세요.
커널 버전, 인터페이스와 사용 편의성, TUN 지원, 구독 관리, 업데이트 현황을 기준으로 주요 Windows 클라이언트를 비교하고 사용 목적에 맞는 선택지를 안내합니다.
노트 읽기 →기존 클라이언트의 지원 종료 후 고려할 대안을 소개하고, 구독, 사용자 규칙, Parsers 오버라이드, 시스템 프록시 설정을 새 클라이언트로 옮기는 절차를 안내합니다.
노트 읽기 →구독 파싱 실패나 빈 노드가 표시되면 링크 만료 여부, 응답 형식, YAML 들여쓰기 오류, User-Agent 인식 문제를 차례로 확인하세요.
노트 읽기 →