Windows
일반적인 데스크톱 사용에는 Clash Plus를 먼저 살펴보고 Clash Verge Rev와 FlClash도 비교해 보세요. 설치 전에 운영체제 지원 범위를 확인하세요. 시스템 프록시를 켜면 브라우저는 보통 설정을 따르지만, 일부 게임이나 스토어 앱은 TUN, 루프백 접근, 방화벽 조건을 추가로 확인해야 합니다.
다운로드 페이지로 이동IOS · MACOS · MIHOMO CORE
기기에 맞는 클라이언트를 선택한 다음 구독 가져오기, 규칙 기반 라우팅, 시스템 권한 설정을 완료하고 실제 연결 출구를 확인하세요.
CONFIGURATION INDEX
Clash 설정에서 노드, 정책 그룹, 규칙은 각각 연결 출구 정의, 출구 선택, 연결 매칭을 담당합니다. 먼저 현재 코어가 설정을 파싱할 수 있는지 확인한 뒤 시스템 트래픽 처리 방식을 조정하면 설정 오류와 권한 부족을 구분해 점검할 수 있습니다. Apple 플랫폼에서는 클라이언트의 지원 범위도 확인해야 합니다. 화면 이름이 비슷하다는 이유만으로 설정 항목이 호환된다고 판단하지 마세요.
RULES / FIRST MATCH
규칙은 위에서 아래로 확인되며, 일치하는 규칙이 나오면 지정된 정책 그룹으로 연결을 전달합니다. 따라서 특정 도메인 규칙은 기본 처리 규칙보다 앞에 두세요. 클라이언트에서 규칙 모드를 선택한 뒤 연결 기록에서 일치한 항목을 확인합니다. 파일만 수정하고 다시 불러오지 않으면 실행 중인 설정에는 반영되지 않습니다. Apple 플랫폼에서 규칙이 적용되려면 연결이 클라이언트를 통과해야 합니다. 시스템 프록시가 적용되지 않은 앱에는 규칙이 작동하지 않습니다. 전역 모드와 달리 규칙 모드에서는 LAN과 지정한 사이트에 직접 연결을 유지할 수 있습니다. 구독에 규칙이 이미 있다면 다음 업데이트 때 덮어쓰지 않도록 클라이언트의 오버라이드 기능으로 추가하는 편이 좋습니다.
# 이 예시는 내장 정책만 사용합니다
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,REJECT
예시에서는 나머지 연결을 REJECT로 차단해 기본 규칙의 순서를 설명합니다. 실제로 사용할 때는 정의된 프록시 정책 그룹으로 바꾸세요.
PROXY GROUPS / SELECTION
정책 그룹은 노드를 묶어 연결 출구를 전환할 수 있게 합니다. 수동 그룹은 특정 회선을 고정해 사용할 때 적합하고, 자동 테스트 그룹은 지정한 URL의 테스트 결과에 따라 후보를 선택합니다. 테스트 시간만으로 모든 사이트의 실제 접속 속도를 알 수 있는 것은 아닙니다. Apple 클라이언트의 프록시 화면에서 정책 그룹을 펼치면 현재 선택 항목을 확인하고 테스트를 실행할 수 있습니다. 지원되는 설정 항목은 사용 중인 코어를 기준으로 확인하세요. 노드를 하나씩 직접 선택하는 대신 정책 그룹을 중첩하면 수동 선택과 자동 선택을 쉽게 전환할 수 있습니다. 그룹 이름을 바꿀 때는 규칙에서 참조하는 이름도 함께 확인해야 설정을 불러올 때 정책을 찾지 못하는 오류를 방지할 수 있습니다.
# DIRECT는 내장 정책입니다. 실제 노드를 설정한 뒤 후보 목록에 추가하세요
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXY
TUN / NETWORK STACK
시스템 프록시는 프록시 설정을 따르는 앱에 주로 적용됩니다. TUN은 가상 네트워크 인터페이스로 더 많은 연결을 받아 시스템 프록시를 사용하지 않는 앱에 적합합니다. macOS 클라이언트는 구현 방식에 따라 서비스 설치나 네트워크 확장 승인을 요구할 수 있습니다. iOS는 일반적으로 시스템 VPN 설정으로 터널을 구성하므로 데스크톱의 모든 TUN 항목을 그대로 사용할 수 있는 것은 아닙니다. 전환하기 전에 네트워크 트래픽을 처리하는 다른 도구를 비활성화하고 기존 설정을 보관하세요. 활성화 후 LAN 접속에 문제가 생기면 노드를 계속 바꾸기보다 라우팅과 제외 항목을 확인하세요.
# 클라이언트 지원 및 해당 시스템 권한이 필요합니다
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
DNS / RESOLUTION
도메인 이름 확인 실패와 프록시 연결 시간 초과는 서로 다른 문제입니다. 먼저 로그에서 대상 주소를 확인할 수 있는지 살펴보고, DNS 요청이 어떤 네트워크 출구를 거치는지 확인하세요. 브라우저 오류만으로는 노드 문제인지 판단하기 어렵습니다. 지원되는 클라이언트에서는 mihomo의 DNS 설정을 별도로 사용할 수 있습니다. Apple 모바일 클라이언트에서 해당 항목을 제공하는지는 제품 안내를 확인하세요. 시스템 DNS를 그대로 사용하는 것보다 별도 설정으로 DNS 경로를 제어하기 쉽지만, 업스트림 서버 연결 가능 여부와 캐시, 규칙 매칭도 함께 고려해야 합니다. 수정한 뒤에는 설정을 다시 불러오고 새 연결을 만들어 오래된 캐시의 영향을 피하세요.
# 현재 네트워크에서 접속할 수 있는 업스트림을 선택하세요
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-query
SUBSCRIPTION / LIFECYCLE
클라이언트 구독은 보통 전체 설정을 가져오며, 노드 제공자는 노드 목록만 추가합니다. 서로 다른 종류의 입력 경로입니다. 설정 화면에 링크를 붙여 넣은 뒤 다운로드가 완료되고 해당 설정이 선택되었는지 확인한 다음 정책 그룹이 표시되는지 살펴보세요. Apple 플랫폼에서는 가져오기 버튼 이름이 다를 수 있지만 확인 순서는 같습니다. 원격 설정을 직접 수정하는 것보다 별도의 오버라이드를 사용하면 개인 규칙을 보존하기 쉽습니다. 구독을 업데이트하기 전에는 직접 추가한 내용을 기록해 두세요. 구독 주소에 접근 자격 정보가 포함될 수 있으니 신뢰할 수 있는 클라이언트에 저장하고, 로그나 스크린샷을 공유할 때 전체 주소를 가리세요.
proxy-providers:
local-nodes:
type: file
path: ./providers/local.yaml
proxy-groups:
- name: PROXY
type: select
use:
- local-nodes
rules:
- MATCH,PROXY
유효한 proxies 목록을 포함한 로컬 파일을 먼저 준비하세요. 이 예시 자체에는 프록시 노드가 포함되어 있지 않습니다.
CLIENT SHELF
먼저 운영체제를 확인하고 프로세서 아키텍처와 클라이언트의 코어 및 설정 형식을 차례로 확인하세요. 같은 구독 주소를 여러 기기에 가져올 수는 있지만 시스템 권한, 프록시 포트, 네트워크 트래픽 처리 옵션을 그대로 복사할 수는 없습니다. 다운로드 페이지에서 플랫폼별 설치 경로, 보관 여부, 지원 조건을 확인하고 버전 정보는 클라이언트 상세 페이지에서 살펴보세요.
일반적인 데스크톱 사용에는 Clash Plus를 먼저 살펴보고 Clash Verge Rev와 FlClash도 비교해 보세요. 설치 전에 운영체제 지원 범위를 확인하세요. 시스템 프록시를 켜면 브라우저는 보통 설정을 따르지만, 일부 게임이나 스토어 앱은 TUN, 루프백 접근, 방화벽 조건을 추가로 확인해야 합니다.
다운로드 페이지로 이동‘이 Mac에 관하여’에서 Apple Silicon 또는 Intel을 확인하고 맞는 설치 파일을 선택하세요. 처음 실행할 때는 클라이언트 안내에 따라 필요한 권한을 승인합니다. 시스템 프록시, 백그라운드 서비스, 네트워크 확장은 각각 용도가 다르므로 모든 권한 요청을 같은 네트워크 설정으로 여기지 마세요.
다운로드 페이지로 이동설정 요구 사항에 따라 Clash Plus, Clash Meta for Android 등의 클라이언트를 선택하고 다운로드할 때 ARM64와 다른 아키텍처를 구분하세요. VPN 연결을 설정한 뒤 백그라운드 실행과 배터리 제한을 확인하세요. 화면이 꺼진 뒤 연결이 끊겨도 구독이 만료된 것은 아닐 수 있으며, 시스템 백그라운드 정책이 원인일 수 있습니다.
다운로드 페이지로 이동Clash Plus의 App Store 링크를 먼저 확인하고 제품 정보는 clashplus.io에서 살펴보세요. 지원되는 구독을 가져온 뒤 시스템 안내에 따라 VPN 설정을 추가하고 클라이언트로 돌아와 연결합니다. 데스크톱 설정 항목을 사용할 수 있는지는 모바일 클라이언트의 실제 지원 범위를 확인하세요.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판의 패키지 형식을 먼저 확인하세요. 서버나 라우터에서는 mihomo 코어를 별도로 고려할 수 있습니다. 명령줄 실행, 서비스 관리, 방화벽과 라우팅을 각각 설정해야 하며, 그래픽 클라이언트를 설치한다고 터미널에도 프록시가 자동 적용되는 것은 아닙니다.
다운로드 페이지로 이동QUICKSTART / THREE CHECKPOINTS
처음 설정할 때는 클라이언트의 기본 네트워크 옵션을 유지하고 ‘설정 유효성 → 출구 연결 가능 여부 → 앱의 프록시 적용 여부’ 순서로 점검하세요. 한 번에 조건 하나만 바꾸고 로그 결과를 확인하면 DNS, 규칙, TUN을 동시에 수정하는 것보다 문제를 찾기 쉽습니다. 시작하기 전에 지원되는 설정 파일이나 구독 링크를 준비하세요. 클라이언트를 다운로드하는 것만으로 사용할 수 있는 프록시 서비스가 생기지는 않습니다.
01 / IMPORT
설정 또는 구독 화면을 열고 원격 설정을 추가한 뒤 전체 링크를 붙여 넣으세요. 업데이트 성공 안내가 나타날 때까지 기다린 다음 해당 설정을 현재 항목으로 지정합니다. 이어서 프록시 화면에서 정책 그룹과 후보 노드가 표시되는지 확인하세요. 가져오기에 실패했다면 링크 만료 여부, 응답 형식의 지원 여부, 현재 네트워크에서 구독 주소에 접속할 수 있는지를 먼저 확인하세요. 일반 웹페이지 주소나 로그인 페이지를 구독 링크로 가져오지 마세요.
02 / CONNECT
정책 그룹에서 연결 가능한 노드를 선택한 다음 시스템 프록시 또는 클라이언트의 VPN 연결을 활성화하세요. macOS에서 서비스를 처음 켜거나 iOS에서 VPN 설정을 처음 추가할 때는 시스템 권한을 승인한 뒤 클라이언트로 돌아와 연결 상태를 확인합니다. 다른 VPN이나 프록시 도구가 실행 중이라면 라우팅과 포트 충돌을 피하도록 하나를 먼저 비활성화하세요. 규칙 모드는 직접 연결이 필요한 경우에 적합하고, 전역 모드는 짧은 비교 테스트에만 사용하세요.
03 / VERIFY
접속이 허용된 페이지를 열고 클라이언트 연결 기록에서 대상 도메인, 일치한 규칙, 실제 출구를 확인하세요. 연결은 보이지만 요청이 실패한다면 노드와 DNS를 더 점검해야 합니다. 연결 자체가 보이지 않으면 해당 앱이 시스템 프록시를 따르는지 또는 터널에 포함되는지 확인하세요. 설정 적용 여부를 확인할 때는 페이지를 다시 열거나 연결을 새로 만드세요. 기존의 장기 연결은 전환 전 출구를 계속 사용할 수 있으므로 새 설정의 적용 여부를 판단하는 근거로 삼지 마세요.
OPEN SOURCE / PROJECT BOUNDARIES
원래 Clash 프로젝트의 유지보수가 중단된 뒤에도 생태계의 설정 형식과 사용 방식은 여러 커뮤니티 프로젝트에서 이어지고 있습니다. 클라이언트를 계속 사용할 수 있는지 판단하려면 이름에 Clash가 들어가는지만 보지 말고 자체 유지보수 상태, 사용하는 코어, 현재 운영체제 호환 안내를 확인하세요. 보관된 클라이언트는 기존 설정을 이해하는 데 도움이 될 수 있지만, 새 프로토콜이나 시스템 네트워크 변경까지 자동으로 지원하리라 기대해서는 안 됩니다.
mihomo는 Clash Meta 포크에서 발전했으며 프로토콜 처리, 규칙 매칭, 정책 그룹, 네트워크 스택 등의 기능을 담당합니다. 그래픽 클라이언트는 이를 바탕으로 설정 관리, 시스템 프록시, 권한 안내, 로그 화면을 제공합니다. 코어가 특정 설정 항목을 인식하더라도 모든 그래픽 클라이언트에서 해당 옵션을 사용할 수 있는 것은 아닙니다. 클라이언트를 업데이트해도 내장 코어가 함께 교체된다는 보장은 없습니다. 설정 문서를 볼 때는 이 두 계층을 구분하세요.
macOS 데스크톱 클라이언트는 시스템 프록시, 백그라운드 서비스, 네트워크 확장 등으로 서로 다른 범위의 트래픽을 처리할 수 있습니다. iOS는 시스템 앱과 터널 인터페이스의 제약을 받습니다. 제품마다 구현 방식이 다를 수 있으므로 ‘Clash 설정 지원’을 ‘mihomo 코어 사용’과 동일하게 볼 수는 없습니다. 클라이언트를 고를 때 구독 형식, 필요한 프로토콜, 규칙 기반 라우팅 기능을 먼저 확인한 뒤 기기의 시스템 권한 설정 절차를 살펴보면 가져오기는 성공했지만 기능이 맞지 않는 상황을 줄일 수 있습니다.
업데이트 전에 복구할 수 있는 설정을 저장하고 직접 추가한 규칙, 포트, 네트워크 설정을 기록하세요. 클라이언트와 코어의 변경 사항을 읽고 설정 항목의 폐기, 기본 동작, 권한 절차 변경을 확인합니다. 업데이트 후에는 같은 대상으로 규칙 적용과 연결 출구를 다시 검증하세요. 프로젝트 소스 코드, 릴리스 기록, 이슈 토론은 구현을 확인하는 데 도움이 되지만 실제 기기의 네트워크 테스트를 대신하거나 임의의 타사 구독이 작동함을 보장하지는 않습니다.
git clone https://github.com/MetaCubeX/mihomo.git
이 명령은 소스 코드만 다운로드합니다. 빌드와 실행에는 별도의 개발 환경이 필요합니다.
READING / RECENT NOTES
기본 연결을 마친 뒤 현재 겪는 문제에 맞는 안내를 확인하세요. 화면별 사용법은 설정 위치를 찾는 데, 생태계 설명은 기능이 어디에 속하는지 확인하는 데, 플랫폼별 문제 해결은 운영체제 자체의 네트워크 제약을 살펴보는 데 도움이 됩니다. 수정 전에 현재 상태를 기록하고 안내의 적용 조건을 하나씩 확인하세요. 다른 플랫폼의 해결 방법을 그대로 적용하지 마세요.
화면별로 정책 그룹 전환, 구독 관리, 로그 수준 필터링 방법을 안내합니다. 처음 사용할 때는 설정 선택 메뉴를 찾고 프록시 화면에서 현재 출구를 확인한 다음 로그에서 설정 불러오기와 연결 오류를 확인하세요.
전체 글 읽기 →원래 코어, Meta 포크, mihomo를 구분하고 그래픽 인터페이스와 코어의 의존 관계를 설명합니다. 프로토콜과 설정 지원 범위를 확인하고 클라이언트 이름, 지원 형식, 실제 코어 구현을 혼동하지 않도록 도와줍니다.
전체 글 읽기 →UWP 앱의 로컬 루프백 접근 제한과 CheckNetIsolation 명령 및 클라이언트 도구를 이용한 해결 방법을 안내합니다. 먼저 앱 유형과 로컬 프록시 수신 설정을 확인하고, 필요한 경우 예외를 설정한 뒤 복구 방법도 기록해 두세요.
전체 글 읽기 →