DESKTOP
Windows
그래픽 인터페이스로 구독, 정책 그룹과 시스템 프록시를 관리하려는 경우에 적합합니다. 다운로드 전 시스템 아키텍처와 클라이언트 유지 관리 상태를 확인하고, 설치 후 구독을 가져온 다음 수신 포트를 점검하세요.
다운로드 페이지로 이동CLIENT PROOF · 2026
클라이언트 선택부터 시작해 구독, 포트, 프록시 모드와 규칙 순서를 차례로 확인하세요. 이 사이트는 영구 무료, 오픈 소스, 중국어 문서를 기준으로 Clash 그래픽 클라이언트와 mihomo 코어의 실제 설정 경로를 정리합니다.
COMPOSING / 01
Clash 사용 과정을 교정, 편집, 인쇄로 나눕니다. 먼저 설정 출처를 확인하고, 필드 관계를 대조한 뒤, 시스템 트래픽을 인계해 결과를 점검합니다.
첫 단계부터 시스템 프록시를 서둘러 켜기보다 클라이언트가 완전한 설정을 읽어오는지 확인해야 합니다. 원격 구독에는 보통 노드, 정책 그룹, 규칙과 DNS 설정이 포함되며, 로컬 YAML은 수동 수정 내용을 유지하기에 적합합니다. 가져온 뒤에는 업데이트 시간, 정책 그룹 이름과 노드 목록이 표시되는지 먼저 확인하고, 구독 주소·네트워크 권한·형식 문제를 점검하세요.
그래픽 클라이언트마다 메뉴 이름은 Profiles, 설정, 구독 또는 구성 파일로 다를 수 있지만, 목적은 같습니다. 파싱 가능한 YAML을 코어에 전달하는 것입니다. 구독을 업데이트하기 전에는 로컬 오버라이드 방식을 확인해 임시 수정 내용을 원격 설정으로 착각하지 않도록 하세요. 이 사이트의 가이드는 ‘가져오기—확인—선택’ 순서로 구성해 첫 연결 전 오류가 시스템 네트워크 계층으로 번지기 전에 설정 단계에서 멈추도록 돕습니다.
mixed-port: 7890
mode: rule
allow-lan: false
proxy-groups:
- name: 노드 선택
type: select
proxies:
- 자동 선택
- DIRECT
설정을 불러왔다면 포트 필드, 정책 그룹 참조와 규칙 순서를 하나씩 대조해야 합니다. mixed-port는 HTTP와 SOCKS5 요청을 모두 받을 수 있어 대부분의 데스크톱 클라이언트에 적합합니다. port 또는 socks-port만 사용할 때는 시스템 프록시에 해당 수신 포트를 입력했는지 확인하세요. 포트 충돌은 대개 코어 시작 실패나 시스템 프록시는 켜졌지만 요청이 클라이언트에 도달하지 않는 증상으로 나타납니다.
규칙은 위에서 아래로 내려가며 처음 일치하는 항목을 적용하므로, 구체적인 도메인과 네트워크 대역은 포괄적인 규칙보다 앞에 배치해야 하며 기본 처리 항목은 보통 마지막에 둡니다. 정책 그룹 이름도 규칙 오른쪽의 참조와 완전히 일치해야 합니다. 단순히 스위치 설명만 제공하는 가이드와 달리, 여기서는 교정 경로를 통해 필드 이름, 들여쓰기 단계, 참조 관계와 적용 위치를 함께 확인할 수 있어 ‘YAML은 읽히지만 분배 결과가 잘못되는’ 문제를 찾기 쉽습니다.
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- GEOIP,CN,DIRECT
- MATCH,노드 선택
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip
설정 검토를 마친 뒤에야 시스템 트래픽을 인계하는 단계로 넘어갑니다. 일반 시스템 프록시는 운영체제의 프록시 설정을 따르는 앱을 주로 대상으로 하며 사용이 간단해 브라우저와 대부분의 데스크톱 소프트웨어에 적합합니다. TUN 모드는 네트워크 계층에서 더 많은 트래픽을 인계하므로 시스템 프록시를 읽지 않는 앱에 유용하지만, 가상 네트워크 어댑터·라우팅·권한을 다뤄야 합니다. 두 방식을 기본값으로 동시에 사용할 필요는 없으며, 대상 앱 범위와 문제 해결 비용에 따라 선택하세요.
연결 후에는 정해진 순서로 확인하세요. 코어가 정상 실행 중인지, 현재 정책 그룹에서 사용 가능한 항목을 선택했는지, 시스템 프록시 포트가 수신 필드와 일치하는지, 로그에 반복 연결이나 DNS 오류가 나타나는지 점검합니다. 특정 사이트만 이상하면 규칙과 DNS로 돌아가고, 모든 요청이 실패하면 코어·포트·시스템 인계를 우선 확인하세요. 이런 계층적 점검이 노드를 반복해서 바꾸는 것보다 실제 장애 지점을 찾는 데 효과적입니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
log-level: info
unified-delay: true
TYPE CASE / 02
홈에서는 플랫폼별 진입점만 제공합니다. 구체적인 클라이언트, 시스템 요구 사항과 설치 패키지 아키텍처는 다운로드 센터에 모아 운영체제별 단계를 섞지 않았습니다.
DESKTOP
그래픽 인터페이스로 구독, 정책 그룹과 시스템 프록시를 관리하려는 경우에 적합합니다. 다운로드 전 시스템 아키텍처와 클라이언트 유지 관리 상태를 확인하고, 설치 후 구독을 가져온 다음 수신 포트를 점검하세요.
다운로드 페이지로 이동DESKTOP
메뉴 막대에서 연결 상태와 정책 선택을 관리하기에 적합합니다. Apple Silicon과 Intel용 설치 패키지가 다르므로 먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 해당 다운로드 항목으로 이동하세요.
다운로드 페이지로 이동MOBILE
앱 내 VPN 권한으로 모바일 기기의 트래픽을 인계하는 데 적합합니다. 기기 프로세서에 맞춰 범용 패키지나 해당 아키텍처를 선택하고, 첫 연결 때 시스템에 표시되는 네트워크 권한을 확인하세요.
다운로드 페이지로 이동MOBILE
iPhone과 iPad에서 클라이언트로 구독을 가져오고 시스템에서 VPN 구성을 승인할 때 적합합니다. 가져오기를 마친 뒤 정책 그룹을 먼저 선택하고, 첫 연결의 권한 상태를 확인하세요.
다운로드 페이지로 이동DESKTOP / SERVER
데스크톱 사용자는 그래픽 클라이언트를 선택할 수 있으며, 서버와 라우터 환경에서는 보통 mihomo 코어를 직접 사용합니다. 설치 전 배포판 패키지 형식, CPU 아키텍처와 서비스 시작 방식을 구분해야 합니다.
다운로드 페이지로 이동PROOF / 03
이름이 비슷한 클라이언트라도 그래픽 인터페이스, 코어와 설정 파일은 서로 다른 계층입니다. 세 요소의 관계를 이해해야 업데이트, 호환성 및 장애 원인을 정확히 판단할 수 있습니다.
PROJECT HISTORY
Clash는 규칙 기반 프록시 코어와 YAML 설정 체계로 널리 사용되는 생태계를 형성했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 기존 클라이언트의 작동 방식이 즉시 바뀌지는 않았지만, 새로운 프로토콜 지원과 네트워크 스택 수정, 설정 확장은 점차 후속 유지 관리 브랜치로 옮겨갔습니다. 클라이언트를 확인할 때는 오래된 코어를 사용하는지, 독립 코어인지, 지속적으로 업데이트되는 mihomo인지 구분해야 합니다.
‘Clash 클라이언트’는 흔히 여러 소프트웨어를 통칭하는 말이며, 모든 그래픽 인터페이스가 같은 프로젝트에서 나온다는 뜻은 아닙니다. 다운로드 페이지에는 플랫폼별 선택 가능한 클라이언트를 나열하고 유지 관리가 중단된 프로젝트도 명시해 시스템과 업데이트 요구에 따라 선택할 수 있도록 했습니다.
OPEN ECOSYSTEM
그래픽 클라이언트는 구독 관리, 정책 전환, 시스템 프록시, 로그 확인과 코어 업데이트를 담당하고, 실제 규칙 매칭과 트래픽 전달은 코어가 수행합니다. YAML 설정은 두 계층 사이에서 수신 포트, DNS와 TUN을 설명하는 동시에 노드, 정책 그룹과 규칙을 정의합니다. 인터페이스 표시 이상이 반드시 코어 장애를 뜻하는 것은 아니며, 코어 오류도 반드시 구독 주소에서 비롯되는 것은 아닙니다.
문제를 해결할 때는 먼저 오류가 어느 계층에서 발생했는지 판단하세요. 구독 다운로드 실패는 출처 또는 네트워크 문제이고, YAML 파싱 실패는 설정 구조 문제입니다. 포트를 열 수 없다면 로컬 환경을 확인해야 하며, 규칙 매칭이 예상과 다르면 순서, 정책 그룹 참조와 DNS 동작을 점검해야 합니다.
MIHOMO CORE
mihomo는 Clash의 설정 방식을 이어받으면서 더 많은 프로토콜, 규칙 기능과 네트워크 옵션을 추가했습니다. 일부 클라이언트는 mihomo를 기본 코어로 사용하고, 다른 클라이언트는 코어 버전 전환을 지원합니다. 기존 설정을 옮길 때 기본 필드는 대체로 이해하기 쉽지만, 실험적 옵션·DNS 동작·규칙 제공자·오버라이드 방식은 현재 코어 문서를 기준으로 하나씩 확인해야 합니다.
일반 데스크톱 사용자는 설치, 권한과 시스템 프록시 진입점을 클라이언트가 처리하므로 그래픽 클라이언트부터 시작하는 편이 적합합니다. 서버, 소프트 라우터 또는 서비스 매개변수를 정밀하게 제어해야 하는 사용자는 코어를 직접 배포하고 설정과 시작 서비스를 직접 관리하는 경우가 많습니다.
UPDATE METHOD
한 번의 전체 업데이트에는 클라이언트 프로그램, 코어 파일과 원격 구독이 포함될 수 있습니다. 클라이언트 업데이트는 인터페이스와 시스템 통합에 영향을 주고, 코어 업데이트는 프로토콜과 설정 동작에 영향을 주며, 구독 업데이트는 노드·정책 그룹·규칙 내용을 바꿉니다. 세 요소를 하나의 ‘버전’으로 묶으면 문제가 생겼을 때 잘못된 대상을 되돌리기 쉽습니다.
업데이트 전 현재 클라이언트 이름, 코어 유형, 설정 출처와 주요 오버라이드를 기록해 두세요. 업데이트 후에는 먼저 설정이 로드되는지 확인하고, 정책 그룹과 시스템 프록시를 점검한 다음 규칙 분배를 검증합니다. 문제가 구독 새로 고침 뒤에만 나타났다면 클라이언트를 바로 재설치하기보다 설정 내용을 먼저 비교하세요.
SOURCE / MIHOMO
구현을 읽거나 코어를 컴파일하거나 설정 동작을 추적해야 한다면 공개 코드 저장소에서 프로젝트를 가져올 수 있습니다. 일반 클라이언트 사용자는 이 명령을 실행할 필요 없이 다운로드 센터의 그래픽 클라이언트를 사용하면 됩니다.
git clone https://github.com/MetaCubeX/mihomo.git
MARGIN NOTES
먼저 장애가 발생한 계층을 판단한 뒤 해당 가이드로 이동해 포트, 노드와 규칙 사이에서 반복적으로 시행착오를 겪지 않도록 하세요.
먼저 구독 주소에 정상적으로 접속할 수 있는지, 클라이언트에 업데이트 시간이 표시되는지 확인한 뒤 설정 파싱 로그를 살펴보세요. 원격 콘텐츠가 비어 있거나 YAML 형식이 아니거나 추가 인증이 필요하면 클라이언트가 노드와 정책 그룹을 생성하지 못하는 경우가 많습니다. 전체 가져오기 순서는 Clash 사용 가이드를 참고하세요.
코어 실행 상태와 수신 포트를 차례로 확인하고, 시스템 프록시 포트가 수신 포트와 일치하는지 점검한 뒤 현재 정책 그룹에서 사용 가능한 항목을 선택했는지 확인하세요. mixed-port를 수정한 후 시스템 설정을 함께 바꾸지 않으면 요청이 계속 이전 포트로 전송됩니다.
브라우저와 시스템 프록시를 따르는 데스크톱 앱에는 설정 경로가 짧은 시스템 프록시를 먼저 사용하세요. 더 많은 앱이나 특수한 네트워크 트래픽을 인계해야 한다면 TUN을 검토합니다. TUN을 켠 뒤에는 가상 네트워크 어댑터 권한, 라우팅과 DNS도 확인해야 하며 두 방식이 완전히 같은 효과를 내는 스위치라고 보면 안 됩니다.
더 앞에 있는 포괄적인 규칙이 요청을 먼저 가로채고 있지 않은지, 정책 그룹 이름이 완전히 일치하는지, 규칙이 클라이언트가 실제로 로드한 설정에 들어 있는지 확인하세요. 오버라이드 기능을 사용한다면 병합 순서 때문에 로컬 규칙이 기본 처리 규칙 뒤로 밀리지 않았는지도 점검해야 합니다.
PROOF SHEETS / 04
플랫폼 설치, 포트 충돌, 규칙 문법과 코어 차이를 중심으로 내용을 계속 정리하며, 글은 게시일 기준으로 보관합니다.
iPhone과 iPad에서 스토어를 이용하는 방법, 설정 가져오기, 권한 승인과 첫 연결 점검을 설명하고, 구독 읽기와 시스템 VPN 승인이라는 두 단계를 구분합니다.
전체 글 읽기수신 프로세스 확인부터 시작해 mixed-port 같은 필드를 수정하는 방법과 시스템 프록시 포트를 함께 업데이트해야 하는 이유를 설명합니다.
도메인, IP, 프로세스와 기본 처리 규칙의 작성법을 정리하고, 위에서 아래로 진행되는 최초 매칭 방식을 설명합니다. 규칙이 존재하지만 예상대로 적용되지 않는 일반적인 원인도 함께 다룹니다.
전체 글 읽기