클라이언트는 설정을 가져오고 스위치를 표시하며 연결을 관리합니다. mihomo 커널은 규칙을 해석하고 프록시 연결을 구성하며 DNS를 처리합니다. 먼저 두 역할을 구분한 뒤 어느 계층을 조정할지 판단하세요. 아래 예시는 문법을 이해하기 위한 것으로, 구독 설정을 그대로 대체할 수 있는 완성된 구성은 아닙니다.
규칙 모드에서는 도메인, 주소 또는 규칙 집합을 처리 정책에 연결합니다. 커널은 위에서 아래로 규칙을 확인하고 처음 일치하는 규칙에서 검사를 멈춥니다. 따라서 구체적인 도메인을 포괄적인 규칙보다 앞에 두고, 기본 규칙은 맨 마지막에 배치하는 것이 일반적입니다. DIRECT는 직접 연결, REJECT는 연결 거부를 뜻합니다. 프록시 정책은 설정에 실제로 존재하는 노드나 정책 그룹을 참조해야 합니다. 전역 모드와 달리 규칙 모드에서는 서비스별로 출구를 다르게 지정할 수 있습니다. 사이트 접속 경로가 예상과 다르면 연결 기록에서 적용된 규칙을 먼저 확인하고, 여러 조건을 한꺼번에 바꾸지 말고 규칙 순서를 조정하세요.
mode: rule
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- DOMAIN,blocked.example,REJECT
- MATCH,DIRECT정책 그룹은 규칙에서 참조할 안정적인 대상을 제공합니다. 그룹에는 노드를 넣거나 다른 정책 그룹을 참조할 수 있습니다. 수동 선택은 출구를 고정해서 사용할 때, 자동 테스트는 테스트 결과에 따라 연결 가능한 경로를 고를 때 적합합니다. 지연 시간 테스트는 지정한 주소로 한 번 요청한 결과일 뿐, 다운로드 대역폭이나 모든 사이트의 접속 속도를 나타내지는 않습니다. 구독을 가져온 뒤에는 그룹에 사용할 수 있는 항목이 있는지 확인하고, 규칙이 해당 그룹을 참조하는지도 점검하세요. 아래 예시는 수동 그룹 구조만 보여줍니다. 실제로 사용할 때는 설정에 있는 노드 이름으로 직접 연결 항목을 바꾸고 이름을 정확히 일치시켜야 합니다.
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXYDNS는 도메인 이름을 주소로 변환하고, 규칙은 연결에 사용할 출구를 결정합니다. 두 항목을 함께 점검해야 합니다. 커널 DNS를 켜더라도 시스템과 모든 앱이 이를 사용하는 것은 아닙니다. 브라우저의 보안 DNS, 시스템 DNS 캐시, 다른 네트워크 도구가 실제 조회 경로를 바꿀 수 있습니다. fake-ip 모드는 도메인 정보를 유지하기 위해 매핑된 주소를 사용하며, 호환성 문제는 해당 앱을 기준으로 살펴봐야 합니다. 예시는 로컬 수신 대기와 기본 조회만 활성화합니다. 설정을 바꾸기 전에 기존 값을 기록하고, 변경 후 연결을 다시 설정해 DNS 요청이 예상한 경로에 도달하는지 확인하세요. 웹페이지가 열리는지만 확인해서는 부족합니다.
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5시스템 프록시는 프록시 설정을 따르는 앱에 적용됩니다. TUN은 가상 네트워크 인터페이스와 라우팅을 통해 더 많은 연결을 처리합니다. 앱 트래픽을 한곳에서 관리할 때 유용하지만 시스템 권한, 네트워크 어댑터, DNS 경로도 영향을 받습니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 클라이언트에 필요한 서비스 권한을 부여하세요. 자동 라우팅이 모든 환경에 맞는 것은 아닙니다. 기존 VPN, 가상 머신 네트워크, 별도 라우터를 사용한다면 라우팅 충돌을 특히 주의해서 확인하세요. 인터넷이 끊기면 노드를 계속 바꾸지 말고 먼저 TUN을 꺼서 기존 경로를 복구한 다음 로그를 확인하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53YAML은 들여쓰기로 계층을 표현하므로 키 이름, 목록 기호, 정책 참조가 잘못되면 설정을 불러오지 못할 수 있습니다. 구독을 업데이트하면 설정이 다시 생성되는 경우가 많아 생성된 파일을 직접 수정하면 다음 업데이트에서 변경 사항이 사라질 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 오버라이드 기능을 우선 사용하세요. 문제를 해결할 때는 오류가 난 줄, 현재 설정, 문제가 발생한 동작을 먼저 기록한 뒤 항목을 하나씩 되돌려 보세요. 평소에는 로그 수준을 적절하게 유지하고, 문제를 확인하려고 로그 수준을 높였다면 확인 후 원래대로 돌리세요. 로그를 공유하기 전에는 구독 주소, 인증 정보, 개인 접속 기록을 삭제하고 문제 파악에 필요한 내용만 남기세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false먼저 운영체제와 프로세서 아키텍처를 확인한 다음 클라이언트의 화면 구성과 기능을 비교하세요. 이름이 비슷해도 설치 파일, 설정 확장 기능, 업데이트 방식은 다를 수 있습니다. 처음 설치한다면 Clash Plus를 비교 대상으로 살펴보세요. Linux 데스크톱 사용자는 Clash Verge Rev를 우선 확인할 수 있습니다. 설치 파일 정보는 다운로드 페이지에서 확인하고, 홈페이지에서는 플랫폼별 안내를 제공합니다.
먼저 시스템 정보에서 프로세서 종류를 확인하세요. 설치 후 구독을 가져와 정책 그룹을 사용할 수 있는지 확인한 다음 시스템 프록시를 켜세요. 더 많은 앱의 트래픽을 처리해야 할 때만 서비스 모드와 TUN을 설정하세요. 방화벽 알림, 포트 사용 중, 남아 있는 프록시 설정은 각각 따로 점검해야 합니다. 보관용 클라이언트는 이전 환경과의 호환을 위한 것이므로 지원이 중단된 소프트웨어를 새 기기의 기본 선택으로 삼지 마세요.
다운로드 페이지로 이동‘이 Mac에 관하여’에서 Apple 칩 또는 Intel 프로세서를 확인한 뒤 해당 빌드를 다운로드하세요. 처음 실행할 때는 시스템 안내에 따라 네트워크 관련 기능을 허용하고, 메뉴 막대 상태와 현재 설정을 확인하세요. 잠자기에서 깨어난 뒤나 네트워크를 바꾼 뒤 연결에 문제가 생기면 프록시와 네트워크 서비스 상태부터 확인하세요. ClashX Meta 보관용 다운로드와 현재 유지 관리 중인 클라이언트는 다운로드 페이지에서 구분해 표시합니다.
다운로드 페이지로 이동기기의 아키텍처에 맞는 설치 파일을 우선 선택하세요. 연결을 시작할 때 시스템 VPN 권한을 허용해야 합니다. 일반적으로 같은 사용자 환경에서 VPN 서비스를 여러 개 동시에 실행할 수 없습니다. 백그라운드 연결이 끊기면 배터리 최적화, 백그라운드 활동, 제조사별 절전 제한을 확인하세요. 앱별 프록시와 기기 전체 트래픽 처리는 서로 다른 설정이므로 변경 후 해당 앱에서 직접 확인해야 합니다.
다운로드 페이지로 이동Clash Plus는 App Store에서 설치할 수 있으며, 공식 웹사이트는 clashplus.io입니다. 서비스 제공업체가 지원하는 설정을 가져온 뒤 시스템 VPN 권한과 정책 선택을 확인하세요. 연결 여부는 구독 유효성, 노드 접속 가능 여부, 현재 네트워크에도 영향을 받습니다. 시스템에 VPN 표시가 나타나도 모든 요청이 예상대로 분기된다는 뜻은 아닙니다.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에서 사용하는 패키지 형식을 확인하세요. 시스템 프록시 설정의 적용 여부는 데스크톱 환경과 앱의 지원 여부에 따라 달라집니다. 명령줄 도구는 별도로 설정해야 할 수도 있습니다. 서버와 라우터 사용자는 mihomo 커널 다운로드 안내를 확인하고 서비스 관리, 설정 디렉터리, 권한을 직접 구성할 수 있습니다. 데스크톱 인터페이스를 설치할 필요는 없습니다.
다운로드 페이지로 이동클라이언트 자체가 프록시 서비스는 아닙니다. 시작하기 전에 유효한 구독 주소나 설정 파일을 준비하고, 서비스 제공업체가 선택한 클라이언트의 설정 형식을 지원하는지 확인하세요. 익숙하지 않은 변환 사이트에 구독 주소를 입력하지 마세요. 주소에는 계정 리소스에 접근할 수 있는 인증 정보가 포함될 수 있습니다.
클라이언트의 설정 또는 구독 페이지에서 링크로 가져오기나 로컬 파일 가져오기를 선택하세요. 저장한 뒤 설정이 로드될 때까지 기다리고 프록시 그룹과 노드가 표시되는지 확인하세요. 파싱 오류가 표시되면 먼저 다운로드한 파일이 설정 텍스트인지 확인하세요. 로그인 페이지, 오류 메시지 또는 다른 클라이언트 형식일 수 있습니다. 이 단계에서는 시스템 프록시를 켜지 마세요.
프록시 그룹에서 사용할 수 있는 출구를 선택하고, 일반적인 사용에는 규칙 모드를 적용하세요. 데스크톱에서는 시스템 프록시를 켜고 모바일에서는 안내에 따라 VPN 연결을 허용하세요. TUN이 필요할 때만 별도로 활성화하고 권한을 확인하세요. 설정은 한 번에 하나씩 바꾸고 복구할 수 있도록 기존 상태를 기록해 두면 노드 문제와 기기의 라우팅 문제를 구분하기 쉽습니다.
실제로 사용할 웹사이트나 앱에 접속하면서 연결 페이지에서 적용된 규칙과 출구를 확인하세요. 직접 연결되어야 하는 대상도 하나 더 테스트해 트래픽이 전부 같은 경로로 흐르지 않는지 확인합니다. 지연 시간 테스트는 통과했는데 페이지가 열리지 않는다면 DNS, 대상 서비스, 앱의 프록시 지원 여부를 추가로 살펴보세요. 클라이언트를 종료하기 전에 시스템 프록시를 꺼서 연결되지 않는 로컬 프록시 주소가 남지 않도록 하세요.
클라이언트를 고를 때는 프로젝트 이름, 커널 기능, 서비스 제공업체를 구분하세요. 같은 이름의 스위치도 클라이언트마다 구현 방식이 다를 수 있습니다. 특정 설정을 지원하는지는 실제로 사용하는 커널과 해당 프로젝트의 문서를 확인하세요.
Clash 생태계에는 프록시 커널, 그래픽 클라이언트, 설정 도구 등 서로 다른 프로젝트가 있습니다. 원래 Clash 프로젝트의 공개 유지 관리가 중단된 뒤에도 커뮤니티는 호환 설정과 새로운 기능을 지원하는 구현을 개발해 왔습니다. mihomo는 Clash Meta의 커널 개발 흐름을 이어갑니다. 이름에 Clash가 들어간 클라이언트라고 해서 같은 팀이 관리하거나 같은 커널을 사용하는 것은 아닙니다. 프로젝트의 상태를 확인하려면 이름만 비교하지 말고 해당 프로젝트의 릴리스 내역, 이슈 토론, 문서를 살펴보세요.
mihomo 코드는 GPL-3.0 라이선스로 공개되어 있으며 저장소에서 소스 코드, 이슈 추적, 릴리스 내역을 확인할 수 있습니다. 이 자료는 기능 변경을 파악하고 알려진 문제를 찾거나 설정 문법을 확인할 때 유용합니다. 커널의 오픈 소스 라이선스가 모든 그래픽 클라이언트, 스토어 앱, 구독 서비스에도 같은 라이선스가 적용된다는 뜻은 아닙니다. 코드를 사용, 수정 또는 배포하려면 해당 프로젝트의 라이선스 조건을 확인하세요. 일반 사용자는 직접 빌드하지 않아도 공개 문서를 문제 해결에 참고할 수 있습니다.
그래픽 클라이언트는 조작을 설정으로 변환하고 로그, 연결 상태, 정책 선택을 표시합니다. 커널은 실제 트래픽을 처리하고 구독 서비스는 노드와 관련 설정을 제공합니다. 클라이언트 설치가 끝났다고 구독이 유효한 것은 아니며, 노드 테스트를 통과해도 특정 서비스가 반드시 작동하는 것은 아닙니다. 문제가 생기면 설정 다운로드, 설정 해석, 네트워크 연결, 원격 서버 연결 중 어느 단계에서 실패했는지 먼저 확인하세요. 계정 만료, 대상 사이트의 제한, 기기 설정 문제를 혼동하지 않는 데 도움이 됩니다.
클라이언트, 커널, 구독, 규칙 데이터베이스 업데이트는 서로 다른 작업입니다. 업데이트하기 전에 정상 작동하는 설정과 사용자 지정 오버라이드를 저장하고 변경 사항을 확인한 뒤 기존 규칙과 자주 사용하는 앱을 테스트하세요. 새 설정을 불러오지 못하면 먼저 이전에 작동하던 설정으로 복구하세요. 특정 사이트만 문제가 있다면 클라이언트 전체를 바로 다시 설치하지 말고 적용된 규칙부터 확인하세요. 오래 유지할 사용자 지정 설정은 클라이언트가 명시적으로 지원하는 오버라이드 기능에 넣어 구독 갱신 때 덮어쓰이지 않도록 하세요.
먼저 기본 연결을 완료한 다음 문제에 맞는 글을 확인하세요. 지연 시간, 시스템 프록시 상태, 규칙 적용 기록은 서로 다른 단계를 나타냅니다. 하나의 지표만으로 전체 연결이 정상인지 판단할 수 없습니다.
URL Test의 핸드셰이크 과정, 테스트 주소 선택, 시간 초과 처리 방식을 살펴봅니다. 지연 시간이 낮다고 대역폭이 높은 것은 아닌 이유와 웹 요청, 파일 전송, 실제 서비스 이용을 함께 확인해 노드 품질을 판단하는 방법을 설명합니다.
글 읽기 →설치 파일 선택부터 서비스 모드 권한 부여, 시스템 프록시 적용까지 단계별로 설명합니다. 보안 소프트웨어 차단, 포트 충돌, UWP 루프백 문제를 정리하고 오류가 발생한 위치에 따라 점검 범위를 좁힙니다.
글 읽기 →geodata 파일 출처, 자동 업데이트 설정 항목, 수동 교체 방법을 소개합니다. GEOIP와 GEOSITE의 매칭 용도를 살펴보고 데이터베이스 로드 여부와 규칙 순서를 각각 확인하는 방법을 설명합니다.
글 읽기 →