Windows
데스크톱 브라우저, 개발 도구, 일상적인 업무에 적합합니다. 먼저 Clash Plus를 살펴보고 Clash Verge Rev, FlClash 등의 인터페이스와 설정 방식을 비교해 보세요. Clash for Windows 대체 프로그램을 찾는다면 기존 설정을 먼저 내보내고 사용자 지정 규칙과 포트를 기록해 두세요. 기존 폴더를 바로 덮어쓰지 않는 것이 좋습니다.
다운로드하기먼저 운영체제와 프로세서 아키텍처를 확인한 다음 GUI 클라이언트를 선택하세요. 다운로드 페이지에서 설치 경로, 지원 플랫폼, 유지 관리 상태를 한눈에 확인할 수 있습니다. 처음부터 명령줄 코어를 사용할 필요는 없습니다.
데스크톱 브라우저, 개발 도구, 일상적인 업무에 적합합니다. 먼저 Clash Plus를 살펴보고 Clash Verge Rev, FlClash 등의 인터페이스와 설정 방식을 비교해 보세요. Clash for Windows 대체 프로그램을 찾는다면 기존 설정을 먼저 내보내고 사용자 지정 규칙과 포트를 기록해 두세요. 기존 폴더를 바로 덮어쓰지 않는 것이 좋습니다.
다운로드하기먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon용과 Intel용 설치 파일을 구분하세요. 처음 실행할 때 네트워크 확장 프로그램이나 보조 서비스에 시스템 권한을 허용해야 할 수 있습니다. 일반적인 브라우저 연결에는 시스템 프록시를 먼저 사용하고, 다른 앱의 트래픽까지 처리해야 한다면 클라이언트 안내에 따라 TUN과 필요한 권한을 설정하세요.
다운로드하기모바일에서는 보통 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. 설치 후 설정을 가져오고 VPN 권한 요청을 승인하세요. 다른 VPN에 연결되어 있다면 먼저 인터페이스 충돌 여부를 확인해야 합니다. 화면을 잠근 뒤 연결이 끊긴다면 구독을 반복해서 가져오기보다 배터리 최적화, 백그라운드 실행 권한, 자동 시작 설정을 확인하세요.
다운로드하기다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하거나 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 처음 연결할 때 VPN 구성을 추가하도록 허용해야 합니다. 가져오기에 성공한 뒤에도 사용할 수 있는 프록시 그룹을 선택해야 합니다. 구독 내용, 노드 프로토콜, 클라이언트 지원 범위에 따라 설정의 정상 작동 여부가 달라집니다.
다운로드하기데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 사용하세요. 서버나 라우터 사용자는 Mihomo 코어 다운로드를 확인할 수 있습니다. 명령줄로 배포하려면 설정 경로, 서비스 권한, 프로세스 관리도 별도로 준비해야 합니다. 설치가 끝났다고 해서 트래픽이 이미 프록시를 통과하는 것은 아닙니다.
다운로드하기아래 예시는 mihomo 설정 문법을 기준으로 설정 항목 간 관계를 보여줍니다. 각 예시는 일부 설정만 담은 조각이며, 바로 연결할 수 있는 완전한 설정이 아닙니다. GUI 클라이언트에서 지원하는 필드와 덮어쓰기 방식은 각각 확인해야 합니다.
규칙 모드는 목록 순서대로 연결을 확인하고, 일치하는 규칙을 찾으면 해당 정책을 적용한 뒤 다음 규칙으로 넘어가지 않습니다. 도메인 접미사 규칙은 사이트와 하위 도메인을 함께 처리할 때 유용하고, 키워드 규칙은 매칭 범위를 주의해야 합니다. 먼저 구체적인 서비스 규칙을 배치하고, 다음에 주소 조건을 둔 뒤 마지막에 MATCH로 나머지를 처리하세요. 전역 모드와 달리 규칙 모드에서는 직접 연결과 프록시를 함께 사용할 수 있습니다. 예시의 PROXY는 설정에 실제로 존재하는 프록시 그룹 또는 프록시 이름이어야 합니다. 규칙만 추가하고 사용할 출구가 없다면 연결은 실패합니다.
rules:
- DOMAIN-SUFFIX,google.com,PROXY
- DOMAIN-KEYWORD,github,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
프록시 그룹을 사용하면 ‘어떤 연결을 프록시로 보낼지’와 ‘어떤 출구를 사용할지’를 두 단계로 나눌 수 있습니다. 규칙에서는 그룹 이름만 참조하므로 그룹 안의 선택 항목을 바꿀 때마다 규칙을 수정할 필요가 없습니다. select는 출구를 직접 선택할 때, url-test는 탐지 결과에 따라 선택할 때 적합합니다. 탐지에 성공했다고 모든 웹사이트에 접속할 수 있는 것은 아닙니다. 예시는 그룹 구성을 보여주기 위해 DIRECT와 REJECT를 사용합니다. 실제로 사용할 때는 설정에 존재하는 프록시 이름을 추가하세요. 그룹 이름은 규칙에서 참조하는 이름과 일치해야 합니다. 대소문자, 공백, 이름 변경으로도 참조 오류가 발생할 수 있습니다.
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
- REJECT
TUN은 가상 네트워크 인터페이스로 트래픽을 받아 프록시 주소를 직접 설정할 수 없는 앱을 처리합니다. 하지만 모든 네트워크 문제를 해결하는 기능은 아닙니다. 활성화하기 전에 설정과 출구가 정상인지 확인하고 클라이언트에 필요한 권한을 부여하세요. 자동 라우팅은 트래픽 경로를 바꾸므로 다른 VPN, 가상 머신 네트워크 어댑터, 보안 소프트웨어와 충돌할 수 있습니다. 아래는 자주 사용하는 필드 예시이며, 적용 가능 여부는 운영체제와 클라이언트에 따라 달라집니다. 연결 문제가 생기면 먼저 TUN을 끄고 비교한 뒤 라우팅과 DNS를 확인하세요. 여러 설정을 한꺼번에 바꾸지 않는 것이 좋습니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
구독 링크로 원격 설정을 가져온 다음 해당 설정 파일을 선택해야 클라이언트가 이를 불러옵니다. 원격 업데이트는 일반적으로 구독으로 생성된 내용을 교체하므로 다운로드된 파일을 직접 수정하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 계속 유지할 규칙은 클라이언트에서 지원하는 덮어쓰기 또는 병합 기능을 사용하고, 최종 적용 설정을 확인하세요. 예시 주소는 가져오기 필드를 설명하기 위한 것으로 프록시 서비스를 제공하지 않습니다. 가져오기에 실패하면 먼저 응답이 지원되는 설정 형식인지 확인하고, 네트워크 오류, 권한 만료, YAML 파싱 오류를 구분하세요.
가져오기 방법: URL에서 가져오기
구독 URL: https://example.com/profile.yaml
가져온 뒤: 설정 선택 → 파싱 결과 확인 → 적용
로컬 규칙: 클라이언트의 덮어쓰기 기능으로 별도 저장
Fake-IP 모드에서는 먼저 앱에 매핑 주소를 반환하고, 코어가 연결을 받으면 도메인을 복원해 출구를 선택합니다. 도메인 매칭 정보를 유지하는 데 도움이 되지만 DNS 조회와 연결이 모두 연동된 경로를 거쳐야 합니다. LAN 서비스, 일부 게임, 실제 조회 주소에 의존하는 앱에는 예외 설정이 필요할 수 있습니다. fake-ip-filter에는 가짜 주소를 사용하지 않을 도메인을 지정하며, 프록시 규칙 목록이 아닙니다. DNS 모드를 바꾼 뒤에도 문제가 계속되면 시스템과 앱의 캐시를 확인하고, 클라이언트의 DNS 경로를 우회하는 다른 암호화 DNS 서비스가 있는지 살펴보세요.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost"
nameserver:
- https://dns.alidns.com/dns-query
왼쪽에서 설정 항목을 선택한 뒤 오른쪽의 설정 조각을 확인하세요. 직접 전환하면 자동 재생이 중지됩니다. 전체 정의는 용어집에서, 증상별 해결 방법은 문제 해결에서 확인하세요.
먼저 최소한으로 연결을 구성한 뒤 규칙과 고급 기능을 추가하세요. 각 단계에서 확인 결과를 기록해 두면 문제가 생겼을 때 설치부터 다시 하지 않고 해당 단계로 돌아갈 수 있습니다.
클라이언트의 ‘구독’ 또는 ‘설정’ 화면에서 URL 가져오기를 선택하고 전체 링크를 붙여 넣은 뒤 저장하세요. 다운로드와 파싱이 끝나면 방금 가져온 설정을 선택하고, 구독 항목만 추가된 것이 아니라 프록시 그룹이나 규칙이 표시되는지 확인하세요. 로그인 페이지나 오류 메시지가 반환된다면 다른 클라이언트로 바꿔도 원본 링크 문제는 해결되지 않습니다.
로컬 파일을 가져올 때는 확장자와 텍스트 인코딩을 확인해 웹페이지를 YAML 파일로 잘못 저장하지 않도록 하세요. 처음 적용하기 전에 설정 이름을 기록하세요. 구독이 여러 개라면 현재 선택된 항목을 확인하고, 이후 업데이트도 같은 항목에 적용해야 합니다.
프록시 모드를 ‘규칙’으로 설정하고 설정에 있는 주요 프록시 그룹을 열어 사용 가능한 출구를 선택하세요. 데스크톱에서는 시스템 프록시를 활성화하고 모바일에서는 VPN 권한을 승인하세요. 전역 모드는 임시 비교에 사용할 수 있지만 작동하지 않는 노드를 복구하지는 않습니다. 직접 연결 모드라고 해서 클라이언트 프로세스가 종료되는 것도 아닙니다.
처음 연결할 때는 여러 프록시 프로그램을 동시에 켜지 마세요. 브라우저에 프록시 전환 확장 프로그램이 있다면 시스템 설정을 덮어쓰지 않는지 먼저 확인하세요. TUN, LAN 공유, 사용자 지정 DNS는 기본 연결이 정상 작동한 뒤 설정해 권한과 라우팅 변수를 줄이세요.
대상 웹사이트를 연 뒤 ‘연결’ 또는 ‘로그’ 화면에서 해당 도메인을 찾아 매칭 규칙, 프록시 그룹, 실제 출구를 확인하세요. 기록은 보이지만 접속이 실패한다면 출구와 DNS를 확인하세요. 기록이 전혀 없다면 먼저 앱이 시스템 프록시를 따르는지, 트래픽이 클라이언트에 들어오는지 확인해야 합니다.
일상적으로 직접 연결하는 사이트를 비교 대상으로 삼아 한 페이지의 결과만으로 전체 네트워크를 판단하지 마세요. 설정은 한 번에 하나씩 바꾸고, 변경한 뒤에는 연결을 다시 시도하세요. 문제가 생기면 단순히 ‘인터넷이 안 된다’고 설명하기보다 운영체제, 클라이언트 이름, 실행한 작업, 오류 메시지 원문을 기록하면 원인을 찾는 데 도움이 됩니다.
코어, GUI 클라이언트, 구독 서비스를 구분해야 기능을 제공하는 주체와 문제를 해결할 위치를 파악할 수 있습니다. 이 사이트는 다운로드 경로와 한국어 안내를 제공하며, 상위 프로젝트의 릴리스 기록이나 설정 문서를 대신하지 않습니다.
Clash는 이 계열의 규칙 기반 프록시 도구가 발전하는 데 중요한 출발점이었으며, 그 설정 형식을 중심으로 클라이언트와 규칙 생태계가 형성됐습니다. Clash Meta는 이를 기반으로 기능을 확장했고, 이후 코어는 mihomo라는 이름으로 유지 관리되고 있습니다. 검색 결과에 여러 이름이 함께 표시될 수 있지만 항상 같은 프로그램을 가리키는 것은 아닙니다. 파일명만으로 기능 범위를 판단해서도 안 됩니다.
오래된 가이드에 나온 필드, 실행 인자, 프로토콜 지원이 현재 클라이언트에서 작동하지 않을 수 있습니다. 지원하지 않는 필드가 있다면 실제로 불러온 코어와 해당 문서를 먼저 확인한 뒤 설정을 수정할지 클라이언트를 바꿀지 결정하세요. 모든 고급 옵션을 한꺼번에 옮기기보다 정상 작동하는 설정을 백업해 두는 편이 안전합니다.
GUI 클라이언트는 트레이 메뉴, 구독 관리, 프록시 선택, 시스템 연동 기능을 제공하고 코어는 설정 파싱, 규칙 매칭, 네트워크 연결 처리를 담당합니다. 같은 코어를 사용하는 클라이언트라도 덮어쓰기 순서, 권한 설치 방식, 설정 저장 위치가 다를 수 있습니다. 인터페이스의 스위치 이름이 비슷해도 생성되는 설정까지 동일하다는 보장은 없습니다.
따라서 다른 클라이언트로 옮길 때는 설정 내용과 시스템 설정을 각각 확인해야 합니다. 포트, 자동 시작, 시스템 프록시, TUN 권한은 구독을 복사하는 것만으로 동기화되지 않는 경우가 많습니다. 이 사이트의 다운로드 페이지에서는 유지 관리 상태와 플랫폼별 다운로드 경로를 함께 안내합니다. 지원이 중단된 클라이언트에는 보관 표시를 해 두어 오래된 가이드가 어떤 프로그램을 기준으로 작성됐는지 확인할 수 있습니다.
mihomo 코어는 GPL-3.0 오픈소스 라이선스를 사용합니다. 소스 코드, 이슈, 릴리스 기록을 통해 설정 동작과 변경 이유를 확인할 수 있습니다. 오픈소스 라이선스는 코드 사용과 배포 조건을 규정하는 것으로, 특정 구독 서비스의 품질을 보장하지 않으며 설정 출처를 확인하는 절차를 대신하지 않습니다. GUI 클라이언트의 라이선스는 각 프로젝트 문서에서 따로 확인하세요.
기능을 확인하려면 먼저 필드 문서를 살펴보고 관련 이슈에 재현 조건이 있는지 확인하세요. 문제를 제보할 때는 최소 설정 조각과 민감 정보를 가린 로그를 첨부하고, 필요한 맥락을 충분히 남기세요. 전체 구독 내용이나 계정 정보는 올리지 마세요. 재현 단계가 없는 스크린샷만으로는 설정 문제와 프로그램 결함을 구분하기 어렵습니다.
클라이언트를 업데이트하면 인터페이스, 코어, 시스템 보조 구성 요소가 함께 변경될 수 있습니다. 업데이트 전에 사용자 지정 규칙, 덮어쓰기 설정, 현재 적용 중인 설정을 저장하고 릴리스 노트에서 호환되지 않는 변경 사항을 확인하세요. 업데이트 후에는 기존에 정상 작동하던 연결부터 확인한 다음 새 기능을 단계적으로 활성화하세요. DNS 변경, TUN 전환, 설정 교체를 한 번의 테스트에서 동시에 하지 마세요.
구독 업데이트와 클라이언트 업데이트도 구분해서 확인해야 합니다. 전자는 원격 설정 내용을 바꾸고 후자는 프로그램 동작을 바꿉니다. 구독을 새로고침한 뒤에만 문제가 생겼다면 그룹 이름, 규칙 참조, 서비스 상태를 확인하세요. 프로그램 업데이트 후에만 문제가 생겼다면 릴리스 노트와 권한 상태를 비교하세요. 발생 순서를 정리하면 점검 범위를 줄일 수 있습니다.
아래 명령은 소스 코드를 복제할 뿐 클라이언트를 설치하거나 프록시 서비스를 실행하지 않습니다. 실행하려면 로컬에 Git이 설치되어 있어야 합니다. 일반 사용자는 저장소 문서를 바로 읽어도 됩니다.
mihomo 소스 코드 저장소 열기 ↗git clone https://github.com/MetaCubeX/mihomo.git
가져오기에 성공했다는 것은 클라이언트가 내용을 받아 파싱했다는 뜻일 뿐입니다. 설정이 적용됐는지, 프록시 그룹에서 사용 가능한 출구를 선택했는지, 앱 트래픽이 실제로 클라이언트에 들어오는지도 확인해야 합니다. 먼저 연결 기록을 살펴본 뒤 노드, 규칙, 시스템 프록시 문제를 구분하세요. 관련 개념은 구독 및 설정 용어를 참고하세요.
항상 둘 다 켜야 하는 것은 아닙니다. 시스템 프록시는 해당 설정을 따르는 앱에 적용되고, TUN은 가상 인터페이스로 트래픽을 처리합니다. 실제 처리 범위는 라우팅과 클라이언트 구현에 따라 달라집니다. 한 가지 방식으로 먼저 기준 상태를 만든 뒤 다른 방식이 필요한지 판단하세요. 정의는 네트워크 스택 용어에서 확인할 수 있습니다.
탐지 결과는 지정된 주소와 당시 연결 상태만 반영합니다. 대상 웹사이트의 DNS 조회, 규칙에 따른 출구, 필요한 프로토콜, 접근 제한은 다를 수 있으므로 실제 요청을 함께 확인해야 합니다. 탐지 결과만으로 판단하지 마세요. 자세한 설명은 프록시 및 프록시 그룹 용어를 참고하세요.
구독을 다운로드한 파일을 직접 수정했다면 새로고침 과정에서 파일이 다시 생성되어 변경 사항이 덮어써질 수 있습니다. 클라이언트에서 공식 지원하는 덮어쓰기 또는 병합 기능을 사용하고 최종 규칙 순서를 확인하세요. 로컬 규칙과 원격 설정의 차이는 설정 파일 용어에서 확인할 수 있습니다.
최신 글 세 편에서는 모바일 백그라운드 권한, Fake-IP DNS 처리 과정, 기기 간 설정 동기화를 다룹니다. 기본 연결을 마친 뒤 실제 상황에 맞는 글을 확인하세요. 한 플랫폼의 조작 방법을 다른 기기에 그대로 적용하지 마세요.
VpnService 권한 요청, VPN 항상 사용 옵션, 제조사별 배터리 최적화 및 자동 시작 예외 설정을 안내해 화면 잠금 후 시스템이 연결을 종료하는 문제를 줄입니다.
글 읽기 →가짜 주소 할당부터 연결 시 도메인 복원까지 Fake-IP의 전체 과정을 살펴보고, 첫 패킷 전송을 빠르게 하는 이유와 LAN·게임·인증 도메인을 필터 목록에 추가해야 하는 경우를 설명합니다.
글 읽기 →공유 구독 링크, 비공개 저장소를 통한 설정 관리, 내보내기·가져오기 방식의 세 가지 동기화 방법을 비교하고 업데이트 주기, 덮어쓰기 규칙, 플랫폼별 필드 차이를 다룹니다.
글 읽기 →