Windows
데스크톱에서 일상적으로 사용한다면 Clash Plus를 먼저 살펴보고, Clash Verge Rev와 FlClash도 비교해 보세요. 처음 설치할 때 시스템 아키텍처를 확인하고, 서비스나 TUN을 활성화할 때는 안내에 따라 관리자 권한을 허용하세요. 권한 문제를 설정 오류로 오해하지 않도록 주의해야 합니다.
다운로드 페이지로 이동 →mihomo 코어 · 오픈 소스 클라이언트 지속 업데이트
Clash 코어 사이트에서 플랫폼별 클라이언트, 구독 가져오기, 규칙 분류를 확인하고 설정 순서에 따라 하나씩 적용하세요.
아웃바운드 유형별로 표시한 것으로, 설정 파일의 나열 순서를 뜻하지 않습니다. 실제 규칙은 위에서부터 매칭되므로 MATCH는 마지막에 두세요.
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 그래픽 클라이언트를 선택하세요. 설치 파일, 시스템 요구 사항, 유지 관리 상태는 다운로드 페이지에서 확인할 수 있습니다.
데스크톱에서 일상적으로 사용한다면 Clash Plus를 먼저 살펴보고, Clash Verge Rev와 FlClash도 비교해 보세요. 처음 설치할 때 시스템 아키텍처를 확인하고, 서비스나 TUN을 활성화할 때는 안내에 따라 관리자 권한을 허용하세요. 권한 문제를 설정 오류로 오해하지 않도록 주의해야 합니다.
다운로드 페이지로 이동 →Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하고, 처음 실행할 때 권한을 허용한 다음 시스템 프록시를 설정하세요. 더 많은 앱의 연결을 처리하려면 TUN을 추가로 설정할 수 있습니다. 보조 서비스와 권한 허용 절차는 클라이언트마다 다르므로 각각의 안내를 확인하세요.
다운로드 페이지로 이동 →모바일에서는 Clash Plus, Clash Meta for Android, FlClash를 비교해 보세요. 설정을 가져온 뒤 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 끊긴다면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 구독을 반복해서 삭제할 필요는 없습니다.
다운로드 페이지로 이동 →다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동해 개발자 정보를 확인하세요. 지원되는 설정을 가져오고 VPN 권한을 허용한 뒤 프록시 그룹을 확인하면 됩니다. 모바일 운영체제의 네트워크 처리 방식은 데스크톱 시스템 프록시와 다르므로 클라이언트 안내를 따르세요.
다운로드 페이지로 이동 →데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 받으세요. 서버와 라우터에서 사용할 경우 mihomo 코어 섹션을 확인하고 설정 디렉터리, 서비스 권한, 시작 방식을 직접 관리할 수 있습니다. 그래픽 클라이언트와 코어 패키지는 설치 대상이 서로 다릅니다.
다운로드 페이지로 이동 →클라이언트는 설정 가져오기, 연결 제어, 인터페이스 조작을 담당하고 코어는 연결을 처리합니다. 클라이언트를 바꾸기 전 사용자 지정 규칙을 내보내고 새 클라이언트가 기존 설정 항목을 지원하는지 확인하세요. 보관된 프로젝트는 과거 사용법을 살펴보는 데 참고하고, 새로 선택할 때는 지속적으로 관리되는 프로젝트를 우선하세요.
전체 클라이언트 보기 →모든 스위치를 한꺼번에 켜기보다 기능별로 설정을 이해하세요. 아래 내용은 기존 설정에 합쳐야 하는 항목 예시입니다. Proxy는 프록시 그룹 이름일 뿐, 기본 제공 프록시 노드가 아닙니다.
규칙 모드에서는 설정된 순서대로 하나씩 매칭하며, 일치하는 규칙을 찾으면 보통 그 아래는 확인하지 않습니다. 특정 사이트에는 도메인 접미사 규칙을, 로컬 네트워크 주소에는 IP 대역 규칙을 사용할 수 있습니다. 지역별 데이터 규칙을 쓰려면 해당 데이터베이스도 사용할 수 있어야 합니다. 모든 연결의 아웃바운드를 하나로 고르는 전역 모드와 달리, 규칙 모드에서는 한국 내 서비스를 직접 연결하면서 지정한 사이트만 프록시 그룹으로 보낼 수 있습니다. 문제를 확인할 때는 먼저 로그에서 매칭된 규칙을 확인하고, 다음으로 프록시 그룹의 현재 선택 항목을 살펴보세요. 노드만 바꾸고 규칙 순서를 바로잡지 않으면 문제가 해결되지 않을 수 있습니다. 마지막의 MATCH는 그 밖의 연결을 처리합니다.
rules:
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- DOMAIN-SUFFIX,github.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy
이 예시는 기존 Proxy 프록시 그룹과 사용 가능한 GEOIP 데이터에 의존합니다.
규칙 매칭 순서 보기 →프록시 그룹을 사용하면 규칙과 실제 노드를 별도로 관리할 수 있습니다. 규칙에는 그룹 이름만 지정하면 되므로 노드를 바꿀 때 규칙을 하나씩 수정하지 않아도 됩니다. select 그룹은 직접 선택할 때 적합하며, 자동 테스트나 장애 조치 그룹은 테스트 주소와 업데이트 간격을 함께 설정해야 합니다. 각 규칙에 노드 이름을 직접 쓰는 것보다 그룹을 사용하면 관리가 쉽고 구독에서 이름이 바뀌어도 영향을 줄일 수 있습니다. 아래 예시는 직접 연결 옵션만 포함한 구조입니다. 기존 설정에 합칠 때는 프록시 아웃바운드를 선택할 수 있도록 기존 노드 이름을 추가하거나 정의된 프록시 제공자를 참조해야 합니다.
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
TUN은 가상 네트워크 인터페이스로 연결을 처리하므로 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. 트래픽이 코어로 들어오는 경로를 바꾸는 기능이며 규칙, 노드, DNS 설정을 대체하지는 않습니다. 시스템 프록시만 설정하는 경우와 달리 TUN은 라우팅과 더 높은 권한이 필요합니다. 먼저 일반 프록시가 작동하는지 확인한 뒤 서비스를 설치하거나 시스템 권한을 허용하세요. 로컬 네트워크 접속에 문제가 생기면 라우팅 제외 항목과 DNS 가로채기 범위를 확인하세요. 운영체제마다 네트워크 스택 지원이 다르므로 아래 설정은 플랫폼 문서에 맞춰 조정해야 합니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
DNS는 도메인을 IP 주소로 변환할 뿐 아니라 코어가 도메인 기반 규칙을 매칭하는 데도 영향을 줍니다. fake-ip 모드는 가상 주소와 요청 도메인을 연결하므로 TUN과 함께 쓰기 좋지만, 일부 로컬 네트워크 장치나 앱은 예외 설정이 필요할 수 있습니다. 시스템 DNS를 그대로 쓰는 것보다 코어 DNS를 사용하면 이름 해석을 한곳에서 관리할 수 있지만, 업스트림 DNS와 트래픽 처리 경로를 올바르게 설정해야 합니다. 웹페이지가 열리지 않을 때는 먼저 DNS 해석 실패인지 연결 실패인지 구분한 다음 설정을 조정하세요. 아래 예시는 기본 항목만 보여 주므로 기존의 전체 DNS 정책을 덮어쓰면 안 됩니다.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query
클라이언트에서 가져오는 전체 설정 구독과 코어의 proxy-providers가 관리하는 노드 목록은 서로 다른 계층입니다. 전체 설정 구독에는 규칙, 그룹, DNS가 포함될 수 있지만 프록시 제공자는 보통 프록시 그룹에서 참조할 노드만 제공합니다. 전체 구독에서 생성된 파일을 직접 수정하면 업데이트 때 변경 사항이 덮어써질 수 있습니다. 계속 유지할 수정 사항은 클라이언트가 지원하는 재정의 또는 병합 기능에 넣으세요. 노드를 반복해서 수동으로 가져오는 대신 예약 업데이트를 활용할 수 있지만, 출처와 업데이트 로그는 확인해야 합니다. 아래 예시는 로컬 파일을 사용하며 원격 구독 주소는 포함하지 않습니다.
proxy-providers:
local-nodes:
type: file
path: ./providers/local.yaml
로컬 파일이 존재하고 유효한 proxies 목록을 포함해야 합니다. 프록시 그룹에서는 use를 통해 local-nodes를 참조해야 합니다.
구독 및 재정의 관리 보기 →시스템 프록시를 켜면 시스템 설정을 따르는 앱이 로컬 프록시로 연결됩니다. mixed-port는 코어가 HTTP 및 SOCKS 요청을 받는 포트를 지정합니다. 두 설정은 서로 일치해야 하며, 설정 파일의 포트만 바꾼다고 시스템 설정까지 변경되는 것은 아닙니다. TUN을 통한 네트워크 계층 처리와 달리 일부 명령줄 도구는 프록시 매개변수를 별도로 설정해야 합니다. 처음 사용할 때는 클라이언트의 기본 포트를 유지하고 다른 프록시 도구는 꺼 두세요. 아래 예시는 개인용 데스크톱에 적합하도록 로컬에서만 수신합니다. 로컬 네트워크에 공개하기 전에는 인증과 방화벽 제한을 별도로 검토해야 합니다.
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
검증 가능한 연결 하나를 먼저 만든 다음 복잡한 규칙을 추가하세요. 시작 과정에는 꼭 필요한 작업만 담고, 세부 설정과 플랫폼별 차이는 전체 문서에서 안내합니다.
클라이언트의 설정 또는 구독 화면을 열고 URL 가져오기를 선택한 다음, 신뢰할 수 있는 출처에서 받은 구독 주소를 붙여 넣고 저장하세요. 로컬 파일을 사용하는 경우 파일 가져오기를 선택하고 클라이언트에서 지원하는 형식인지 확인하세요. 가져오기에 성공한 뒤에는 해당 설정을 선택해 현재 설정으로 활성화해야 합니다. 목록에 항목이 표시되더라도 설정이 실제로 적용되었다는 뜻은 아닙니다.
이어서 로드 결과와 프록시 그룹 목록을 확인하세요. 지원하지 않는 항목, 들여쓰기 오류, 다운로드 실패가 표시되면 먼저 메시지를 기록하고 원본 파일을 바로 덮어쓰지 마세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 스크린샷이나 문의를 남기기 전에 전체 주소를 가리고, 낯선 변환 서비스에 제출하지 마세요.
모드 메뉴에서 규칙 모드를 선택한 뒤 설정에서 참조하는 프록시 그룹으로 이동해 사용할 수 있는 아웃바운드를 고르세요. 그룹 이름은 설정에 따라 다르며 반드시 Proxy인 것은 아닙니다. 데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 시스템 대화상자에서 VPN 권한을 허용하세요. 이 단계에서는 기본 DNS와 라우팅 설정을 유지해 동시에 바뀌는 항목을 줄이세요.
전역 모드에서는 보통 모든 연결을 전역 프록시 그룹으로 전달합니다. 임시 비교나 문제 확인에는 유용하지만 모든 앱의 트래픽이 코어로 들어온다는 뜻은 아닙니다. 시스템 프록시를 따르지 않는 앱은 프록시 매개변수를 별도로 설정하거나, 일반 연결이 확인된 뒤 TUN을 활성화해야 합니다.
직접 연결되어야 하는 서비스와 프록시를 사용해야 하는 사이트에 각각 접속하면서 연결 기록이나 실행 로그를 확인하세요. 대상 도메인, 매칭 규칙, 최종 아웃바운드가 예상과 일치하는지 살펴보세요. 노드 테스트 성공은 테스트 주소에 연결할 수 있다는 뜻일 뿐, 웹페이지, 동영상, 특정 앱이 정상 작동하는지 대신 확인해 주지는 않습니다.
문제가 한 앱에서만 발생한다면 별도 프록시나 암호화 DNS를 사용하는지 먼저 확인하세요. 모든 연결이 실패하면 구독, 노드, 시스템 시간, 로컬 네트워크를 점검하세요. 기본 흐름이 안정적으로 작동하는 것을 확인한 뒤 현재 설정을 백업하고 규칙 세트, DNS 재정의, TUN 설정을 추가하세요.
Clash 클라이언트와 프록시 서비스는 서로 다른 것입니다. 클라이언트를 설치해도 사용할 수 있는 노드가 자동으로 생기지 않으며, 설정에 포함된 서버 정보도 제공자가 계속 관리해야 합니다. 사용하기 전에 서비스의 이용 범위와 트래픽 제한, 현지 네트워크 이용 규정을 확인하세요. 이 사이트의 문서는 설치와 설정 방법을 안내하며 계정, 구독 유효 기간, 노드 사용 가능 여부에 관한 서비스 제공자의 안내를 대신하지 않습니다.
설정을 업데이트할 때는 검증된 백업본을 보관하세요. 클라이언트 업그레이드, 코어 업데이트, 구독 새로고침, 규칙 세트 업데이트는 각각 다른 부분에 영향을 줍니다. 문제를 확인하는 동안 이 작업을 한꺼번에 실행하지 않는 것이 좋습니다. 오류가 발생하면 발생 시간, 사용 중인 네트워크, 직전에 변경한 내용을 기록한 뒤 로그를 따라 단계별로 살펴보세요. 반복해서 재설치하는 것보다 원인을 빠르게 좁힐 수 있습니다.
과거 프로젝트, 프록시 코어, 그래픽 클라이언트를 구분해야 다운로드 파일, 설정 호환성, 업데이트 안내를 올바르게 이해할 수 있습니다.
Clash의 규칙과 설정 형식은 여러 후속 프로젝트에서 이어져 익숙한 항목 이름이 다양한 클라이언트에 나타납니다. 원본 프로젝트, 커뮤니티 포크, 새로운 그래픽 인터페이스는 동일한 릴리스 이력을 공유하지 않습니다. 가이드를 참고할 때는 먼저 어떤 코어와 클라이언트를 대상으로 하는지 확인한 다음 설정을 적용하세요. 과거 클라이언트는 이전 설정 방식을 유지하고 있을 수 있으며 최신 항목을 지원하지 않을 수도 있습니다. 오래된 스크린샷의 버튼 이름을 현재 인터페이스에 그대로 적용하면 안 됩니다.
mihomo는 널리 사용되는 Clash 설정 생태계의 코어 중 하나로, 프로토콜 처리, 규칙 매칭, DNS 등을 담당합니다. Clash Verge Rev와 FlClash 같은 그래픽 클라이언트는 이를 바탕으로 설정 관리, 시스템 프록시, 사용자 인터페이스를 제공합니다. 인터페이스가 업데이트되더라도 코어가 함께 바뀌는 것은 아닙니다. 클라이언트에서 파일을 가져올 수 있다고 해서 코어가 그 안의 모든 항목을 지원하는 것도 아닙니다. 호환성을 판단할 때는 프로그램 이름만 보지 말고 클라이언트에서 사용하는 코어, 항목 지원 여부, 플랫폼 권한을 함께 확인해야 합니다.
mihomo 저장소는 GPL-3.0 라이선스를 따릅니다. 구체적인 권리와 의무는 프로젝트의 라이선스 전문을 확인하세요. 다른 클라이언트와 해당 의존성은 서로 다른 라이선스를 사용할 수 있으므로 코어의 라이선스가 모든 소프트웨어에 공통으로 적용되는 것은 아닙니다. 소스 코드를 읽거나 문제를 제보하거나 재배포할 때는 각 저장소의 안내를 따로 확인하세요. Clash 코어 사이트는 다운로드 링크와 한국어 자료를 정리한 사이트이며 각 프로젝트의 개발자를 대표하지 않습니다. 프로젝트 이름은 소프트웨어와 설정 간의 관계를 식별하기 위한 것이며 공동 개발이나 공식 제휴를 의미하지 않습니다.
앱 업데이트는 주로 인터페이스, 시스템 통합, 패키지 의존성을 바꿉니다. 코어 업데이트는 프로토콜 지원과 설정 항목의 동작에 영향을 줄 수 있고, 구독이나 규칙 세트 새로고침은 설정 데이터를 갱신합니다. 업데이트 안내가 표시되면 먼저 어느 계층에 해당하는지 확인하고 변경 사항을 읽은 뒤 백업을 보관하세요. 업데이트 후 문제가 생기면 모든 사용자 설정을 바로 지우지 말고 변경 전후의 설정과 로그를 먼저 비교하세요. 다운로드 페이지에서 클라이언트 링크와 관리 상태를 확인할 수 있습니다. 이 문서는 특정 릴리스의 요구 사항이 앞으로도 계속 적용된다고 가정하지 않습니다.
설정 항목의 동작을 확인하거나 코어 문제를 제보하려면 프로젝트 저장소에서 자세한 내용을 살펴보세요. 복제 명령은 소스 코드를 가져올 뿐 그래픽 클라이언트를 설치하거나 기기의 프록시를 설정하지 않습니다. 일반 사용자는 다운로드 페이지에서 클라이언트를 선택하면 됩니다. 개발과 빌드 방법은 저장소 문서를 참고하세요.
mihomo 오픈 소스 저장소 보기 ↗git clone https://github.com/MetaCubeX/mihomo.git
기본 연결을 설정한 뒤 권한, 모바일 설정 가져오기, 규칙 매칭 등 필요한 주제를 살펴보세요. 각 문서는 한 가지 상황을 중심으로 설명하므로 구체적인 문제를 해결하면서 이어서 읽기 좋습니다.
처음 실행할 때 표시되는 Gatekeeper 안내, 네트워크 확장 및 시스템 프록시 승인, 키체인 대화상자 처리 방법을 정리합니다. 권한 대상부터 구분한 뒤 권한 문제를 확인하면 기존 설정을 중단시키는 재설치를 반복하지 않아도 됩니다.
글 읽기 →App Store에서 클라이언트를 받는 단계부터 구독 링크 가져오기, 설정 활성화, VPN 승인, 첫 연결까지 순서대로 안내합니다. 설정 가져오기 성공과 실제 연결 성공의 차이를 중심으로 후속 확인 방법을 설명합니다.
글 읽기 →규칙 매칭 순서부터 GEOIP, GEOSITE, DOMAIN-SUFFIX, rule-providers를 활용한 규칙 구성까지 설명합니다. 도메인과 로컬 네트워크 대역을 예로 들어 직접 연결, 프록시, 마지막 기본 처리 규칙의 관계를 알아봅니다.
글 읽기 →