Windows
브라우저와 업무용 앱, 데스크톱 프로그램에 적합합니다. 먼저 시스템 프록시로 기본 연결을 확인하고, 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때 TUN, 즉 가상 네트워크 인터페이스 모드를 고려하세요. 다운로드 전에 프로세서 아키텍처를 확인하고, 새 프록시를 켜기 전에 기존 클라이언트를 종료해 여러 프로그램이 시스템 설정을 반복해서 바꾸지 않도록 하세요.
다운로드 페이지로 이동구독 가져오기부터 규칙 분기까지, 휴대폰 운영체제에 맞춰 권한과 백그라운드 설정을 완료하세요. 데스크톱 설정도 확인할 수 있습니다.
01 / CLIENTS
먼저 기기의 운영체제를 확인한 다음 클라이언트가 지원하는 코어와 설정 형식을 살펴보세요. Clash는 생태계의 이름이며, 인터페이스가 다르다고 기능까지 같은 것은 아닙니다. 새 기기에 같은 구독을 가져온 뒤에도 정책 그룹 이름, DNS 설정, 시스템 트래픽 처리 방식을 확인해야 합니다. 처음 사용하는 경우 Clash Plus부터 가이드를 따라 해 보세요. 기존 설정이 있다면 먼저 백업한 후 교체 여부를 결정하세요.
브라우저와 업무용 앱, 데스크톱 프로그램에 적합합니다. 먼저 시스템 프록시로 기본 연결을 확인하고, 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때 TUN, 즉 가상 네트워크 인터페이스 모드를 고려하세요. 다운로드 전에 프로세서 아키텍처를 확인하고, 새 프록시를 켜기 전에 기존 클라이언트를 종료해 여러 프로그램이 시스템 설정을 반복해서 바꾸지 않도록 하세요.
다운로드 페이지로 이동휴대폰에서는 먼저 VpnService 권한을 허용해야 합니다. VpnService는 Android가 제공하는 VPN 시스템 인터페이스로, 클라이언트가 트래픽을 처리할 수 있게 합니다. 원격 노드에 연결됐다는 뜻은 아닙니다. 구독을 가져온 뒤에는 백그라운드 실행도 허용하세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 자동 시작 권한, 다른 VPN 앱과의 충돌을 확인하세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus의 스토어 페이지로 이동하고 공식 웹사이트 clashplus.io도 확인할 수 있습니다. 설정을 가져온 뒤 클라이언트 안내에 따라 VPN 구성을 추가하고 시스템 인증을 진행하세요. 여기서 말하는 시스템 VPN 구성은 수동 설치가 필요한 프로파일과 다릅니다. 출처가 낯선 프로파일은 사용 목적과 출처를 먼저 확인하세요.
다운로드 페이지로 이동먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel인지 확인한 다음 해당 설치 파일을 선택하세요. 시스템 프록시와 TUN은 필요한 권한이 다르므로 보조 서비스를 설치할 때는 앱 출처를 확인해야 합니다. 클라이언트를 바꾼 뒤 웹페이지가 열리지 않으면 프록시 설정을 계속 추가하기보다 네트워크 설정에 이전 포트가 남아 있는지 먼저 살펴보세요.
다운로드 페이지로 이동데스크톱 환경에서는 그래픽 클라이언트를 우선 선택하고, 서버와 라우터에는 mihomo 코어를 별도로 배포하는 방식을 고려하세요. 설치 파일 형식과 프로세서 아키텍처, 서비스 권한이 운영체제에 맞아야 합니다. 명령줄 도구는 데스크톱 프록시 설정을 사용하지 않을 수 있으므로 환경 변수를 따로 확인하세요. TUN을 켜기 전에는 라우팅과 DNS가 처리되는 범위도 알아두세요.
다운로드 페이지로 이동02 / SETTINGS
각 스위치가 무엇을 바꾸는지 먼저 파악한 뒤 설정을 조정하세요. 자주 쓰는 항목을 기준으로 설명합니다. 규칙은 트래픽의 목적지를 정하고, 정책 그룹은 사용할 출구를 선택하며, TUN과 시스템 권한은 코어로 전달되는 트래픽을 결정합니다. 아래 설정 조각은 문법 예시일 뿐 노드가 포함된 완전한 설정이 아닙니다. 클라이언트 인터페이스의 스위치 이름은 다를 수 있습니다.
규칙 모드는 위에서 아래로 도메인과 주소 등의 조건을 확인하고, 조건에 맞으면 지정된 정책으로 처리합니다. 직접 연결할 특정 도메인은 앞쪽에, 기본 처리용 MATCH는 마지막에 두세요. 정책 이름은 설정에 이미 존재해야 합니다. 전역 모드와 달리 모든 연결에 같은 출구를 사용할 필요가 없습니다. 휴대폰에서 특정 앱만 이상하다면 연결 기록에서 어떤 규칙이 적용됐는지 확인한 뒤 해당 항목을 수정하세요. 구독을 업데이트하면 직접 편집한 규칙이 덮어써질 수 있으므로, 계속 유지할 변경 사항은 클라이언트가 지원하는 재정의 또는 병합 기능에 추가하세요.
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
이 설정 조각은 기본 경로를 직접 연결로 지정하며, 규칙 적용 순서만 보여줍니다. 실제 프록시 정책은 현재 설정에 있는 이름을 사용해야 합니다.
구독 링크는 서비스 제공자가 발급한 설정 주소이지 웹페이지 공유 링크가 아닙니다. 설정 페이지에서 URL 가져오기를 선택하고 저장한 뒤 해당 설정이 활성화되어 있는지 확인하세요. 전체 Clash YAML과 노드만 포함된 구독은 서로 다르므로, 가져오기에 성공했다고 규칙까지 갖춰졌다고 볼 수는 없습니다. 업데이트 전에 로컬 변경 사항이 덮어써지는지 확인하고 중요한 재정의 설정은 따로 백업하세요. 구독을 사용하면 노드를 일일이 입력하지 않고 변경 사항을 동기화할 수 있지만, 링크에는 계정 정보가 포함되는 경우가 많으므로 스크린샷과 로그에서 전체 주소를 가리세요.
설정 → 새 설정 추가 → URL에서 가져오기
설정 저장 → 현재 설정으로 지정
구독 업데이트 → 규칙 및 정책 그룹 확인
구독 가져오기 단계 보기 →
TUN은 트래픽을 코어로 전달하는 가상 네트워크 인터페이스입니다. Android 클라이언트는 보통 VpnService를 사용해 로컬 VPN 터널을 만듭니다. 처음 연결할 때 시스템 권한을 허용해야 합니다. 상태 표시줄에 VPN 아이콘이 나타나도 터널이 만들어졌다는 뜻일 뿐, 노드를 사용할 수 있다는 의미는 아닙니다. TUN은 앱 프록시 설정만 사용하는 것보다 더 많은 트래픽을 처리하며 시스템 권한과 백그라운드 실행 상태에 더 크게 좌우됩니다. 휴대폰에서는 일반 VPN 터널 두 개를 동시에 실행할 수 없는 경우가 많으므로 시작 전에 충돌하는 앱을 끄세요. 화면을 잠근 뒤 연결이 끊기면 노드를 계속 바꾸기보다 배터리 최적화를 확인하세요.
Android 시스템 VPN: 연결 허용
앱 배터리 설정: 백그라운드 실행 허용
다른 VPN 앱: 먼저 연결을 끊고 테스트
화면 잠금 후: 클라이언트 실행 상태 확인
Android 권한 및 배터리 설정 보기 →
정책 그룹은 출구 선택기입니다. select는 사용자가 직접 선택하고, url-test는 테스트 결과에 따라 선택하며, fallback은 순서대로 장애 전환을 우선하고, load-balance는 여러 연결을 분산합니다. 처음 설정할 때는 수동 그룹으로 출구 하나가 작동하는지 확인한 뒤 자동 선택을 고려하세요. 자동 테스트는 실제 다운로드 속도 측정이 아니며, 출구를 바꿔도 기존 연결이 즉시 이동한다고 보장할 수 없습니다. 고정 노드 하나만 쓰는 것보다 정책 그룹으로 여러 출구를 관리하기 편하지만, 그룹 참조 이름과 규칙 대상, 구독 노드 이름은 서로 일치해야 합니다.
proxy-groups:
- name: 수동 출구
type: select
proxies:
- DIRECT
rules:
- MATCH,수동 출구
예시에는 내장 직접 연결 출구만 있습니다. 프록시를 사용하려면 설정에 실제로 존재하는 노드나 정책 이름을 추가하세요.
노드 지연 시간 테스트는 보통 지정한 출구를 통해 테스트 주소에 요청을 보냅니다. 결과는 핸드셰이크, 이름 조회, 대상 사이트, 현재 네트워크 상태에 따라 달라집니다. 기본적인 연결 상태를 확인하는 데는 유용하지만 대역폭이나 동영상 재생 품질, 모든 앱의 사용 가능 여부를 직접 나타내지는 않습니다. 비교할 때는 테스트 주소와 네트워크를 동일하게 유지하고 Wi-Fi와 모바일 데이터를 섞어 비교하지 마세요. 시간 초과가 발생하면 구독이 유효한지, 노드를 사용할 수 있는지 먼저 확인한 다음 실제 접속을 테스트하세요. 휴대폰에서 불필요하게 여러 노드를 자주 테스트하면 백그라운드 네트워크 사용량이 늘어날 수 있습니다.
동일한 테스트 주소 선택
같은 네트워크에서 직접 테스트
대상 앱으로 실제 접속 확인
네트워크를 바꾼 뒤 다시 확인
연결 및 테스트 관련 자주 묻는 질문 보기 →
DNS는 도메인 이름을 주소로 변환합니다. 재정의는 로컬 설정으로 구독의 조회 설정을 대체하거나 병합하는 기능입니다. 주소로는 연결되는데 웹페이지가 열리지 않는다면 먼저 DNS 로그를 확인하세요. 시스템 비공개 DNS, 클라이언트 DNS, 라우터 설정을 한꺼번에 바꾸면 문제 원인을 찾기 어렵습니다. fake-ip는 가상 주소를 사용해 도메인 매핑을 유지하는 방식으로, 모든 앱에 그대로 적용하기 적합한 것은 아닙니다. DNS 서버를 바꾸는 것보다 요청이 어떤 경로로 처리되는지 파악하는 것이 중요합니다. 모바일에서는 VPN이 처리하는 범위와 앱 호환성도 확인하세요.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 1.1.1.1
필드 형식 예시이며 일반적인 권장 설정은 아닙니다. 변경 전에 기존 설정을 보관하고 현재 네트워크에서 선택한 DNS 서버에 접속할 수 있는지 확인하세요.
03 / QUICK START
처음 사용할 때는 전체 연결 과정을 한 번에 확인하세요. 사용할 수 있는 설정을 준비하고, 시스템 터널을 만들고, 대상 앱에서 정상적으로 접속할 수 있어야 합니다. 우선 구독에 포함된 DNS와 규칙을 그대로 두고 여러 가이드의 설정 조각을 한꺼번에 섞지 마세요. 한 항목씩 바꿀 때마다 확인하면 나중에 문제 원인을 찾기 쉽습니다.
신뢰할 수 있는 서비스에서 구독 주소를 복사한 다음 클라이언트 설정 페이지에서 URL로 가져와 현재 설정으로 지정하세요. 형식 오류가 표시되면 로그인 페이지나 만료 안내가 아니라 클라이언트가 지원하는 설정이 반환되는지 먼저 확인하세요. 구독 주소를 공개 게시판에 올리지 마세요.
규칙 모드를 사용하고 정책 그룹에서 작동하는 출구를 선택한 뒤 연결을 시작하세요. 휴대폰에서는 시스템 안내에 따라 VPN 구성을 허용하고, Android에서는 백그라운드 실행 권한도 확인하세요. 시스템 프록시, TUN, 규칙 모드는 서로 다른 설정이므로 '안전하게' 쓰려고 모든 스위치를 켤 필요는 없습니다.
먼저 자주 사용하는 서비스에 접속한 뒤 연결 기록에서 예상한 정책이 적용됐는지 확인하세요. 그런 다음 Wi-Fi와 모바일 데이터 사이를 한 번 전환하고, 화면을 잠갔다가 다시 켜서 테스트하세요. 화면을 잠글 때만 연결이 끊긴다면 배터리 제한을 먼저 확인하세요. 특정 도메인만 문제가 있다면 규칙과 DNS를 살펴보고 클라이언트를 서둘러 재설치하지 마세요.
04 / OPEN SOURCE
클라이언트를 고를 때는 인터페이스만 보기보다 프로젝트 이름, 코어, 설정 출처를 구분하는 편이 유용합니다. 이 사이트는 다운로드 경로와 중국어 사용 자료를 정리하며, 상위 프로젝트의 릴리스 안내를 대신하거나 프록시 노드를 제공하지 않습니다. 클라이언트의 기능은 사용하는 코어와 시스템 제한, 실제 설정에 따라 달라집니다.
원본 Clash는 규칙 기반 프록시의 기본 설정 방식을 제공했습니다. Clash.Meta는 이를 확장했고 관련 코어는 이후 mihomo라는 이름으로 발전했습니다. 따라서 'Clash 설정 지원'이 모든 필드를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 최신 프로토콜과 규칙 유형, 네트워크 스택 옵션은 코어의 지원 여부를 확인해야 합니다.
기존 설정을 이전할 때는 먼저 구독 원본을 보관하고 시작 로그에서 오류가 발생한 필드를 확인하세요. 기본 설정이 정상적으로 불러와지는지 확인한 다음 사용자 지정 규칙을 복원하세요. 오류 하나를 없애려고 DNS나 라우팅 설정 전체를 지우지 마세요. 프로그램은 시작되더라도 기존 트래픽 경로가 달라질 수 있습니다.
코어별 차이 안내 보기 →그래픽 클라이언트는 구독 가져오기, 정책 선택, 시스템 프록시, 권한 제어를 인터페이스로 제공합니다. mihomo 같은 코어는 네트워크 설정을 실행합니다. 하나의 코어가 여러 인터페이스와 함께 사용될 수 있고, 클라이언트도 업데이트하면서 코어나 기본 옵션을 변경할 수 있습니다. 스크린샷만으로 동작이 완전히 같다고 판단할 수는 없습니다.
휴대폰에는 별도의 시스템 제약도 있습니다. Android의 배터리 관리가 백그라운드 서비스를 종료할 수 있고, iOS의 VPN 구성에는 시스템 인증이 필요하며, 데스크톱은 보조 서비스에 의존할 수 있습니다. 문제가 생기면 '인터페이스가 시작되지 않음', '코어 설정 오류', '시스템 터널 미생성' 중 어디에 해당하는지 먼저 구분하면 진단이 쉬워집니다.
네트워크 및 시스템 용어 보기 →mihomo 프로젝트는 GPL-3.0 라이선스를 따르며 공개 저장소에서 코드와 이슈 논의, 릴리스 기록을 확인할 수 있습니다. 오픈 소스 라이선스는 코드 사용과 배포 조건을 규정하며, 해당 코어를 사용하는 모든 클라이언트가 동일한 인터페이스와 기능, 유지보수 주기를 갖는다는 뜻은 아닙니다. 코드를 수정하거나 재배포하려면 해당 프로젝트의 라이선스 파일을 확인하세요.
일반 사용자는 소스 코드를 직접 빌드하지 않아도 됩니다. 설정 동작을 살펴보거나 문제를 재현하고 개발에 참여하려는 경우에 저장소를 복제하면 됩니다. 문제를 제보하기 전 구독 주소와 노드 비밀번호, 개인 네트워크 정보를 제거하고 재현에 필요한 최소 설정과 로그만 남기세요.
mihomo 프로젝트 저장소 보기 ↗클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 시스템 연동을 바꿀 수 있고, 코어 업데이트는 필드 동작에 영향을 줄 수 있으며, 구독 업데이트는 노드와 규칙을 대체할 수 있습니다. 문제가 생기면 최근에 어느 계층을 바꿨는지 먼저 확인하세요. 앱을 되돌리고 네트워크를 초기화하고 모든 설정을 다시 가져오는 일을 한꺼번에 하지 마세요.
평소 사용 가능한 설정과 별도의 재정의 기록을 보관하고, 업그레이드 후에는 시작, DNS 조회, 정책 그룹, 대상 앱 순으로 확인하세요. 오랫동안 유지보수가 중단된 클라이언트는 새 기기의 기본 선택지보다 이전 작업의 출발점으로 보는 편이 좋습니다. 이전을 마치고 안정성을 확인한 뒤 기존 앱과 남은 프록시 설정을 정리하세요.
업데이트가 중단된 클라이언트의 이전 경로 보기 →Git이 로컬에 설치되어 있어야 합니다. 이 명령은 소스 코드만 다운로드하며 그래픽 클라이언트를 설치하거나 프록시 설정을 자동으로 만들지 않습니다. 빌드 방법과 개발 의존성은 저장소 문서를 확인하세요.
git clone https://github.com/MetaCubeX/mihomo.git
05 / NOTES
기본 연결이 작동한다면 클라이언트 선택과 이전, 정책 그룹 설정을 이어서 살펴보세요. 각 글은 구체적인 문제 하나를 다뤄 일부 이상을 해결하려고 전체 설정을 다시 만들지 않도록 돕습니다. 작업 전에 기존 설정을 보관하고, 글에 나온 예시는 자신의 클라이언트와 코어, 구독에 맞게 조정하세요.
기존 클라이언트의 업데이트가 중단되면 먼저 구독과 재정의 설정을 내보낸 다음 기기와 사용 목적에 맞는 유지보수 중인 대체 클라이언트를 선택하세요. 마지막으로 규칙과 DNS, 시스템 권한을 확인해 새 클라이언트와 기존 설정의 차이를 점검하세요.
노트 읽기 →select, url-test, fallback, load-balance 네 가지 정책 그룹의 작동 방식을 살펴보고 interval과 tolerance의 의미를 설명합니다. YAML 예시를 통해 자동 선택과 장애 전환의 차이도 알아봅니다.
노트 읽기 →코어, 구독 가져오기, 규칙 편집, TUN 지원, 인터페이스 사용성을 기준으로 모바일 클라이언트를 비교합니다. 처음 설정하는지 기존 구독을 이전하는지 먼저 정한 뒤 실제 사용 환경에 맞춰 선택하세요.
노트 읽기 →