브라우저, 개발 도구, 로컬 서비스에 같은 출구를 사용할 필요는 없습니다. 규칙 모드에서는 설정의 rules를 읽어 위에서부터 차례로 확인하고, 일치하는 규칙을 찾으면 해당 정책을 적용합니다. 클라이언트의 ‘프록시’ 페이지에서 규칙 모드를 선택한 뒤 ‘규칙’ 페이지에서 매칭 순서를 확인하세요. 전역 모드와 달리 LAN이나 지정 사이트에 직접 연결을 유지할 수 있지만, 결과는 규칙 설정에 따라 달라집니다. 아래 Proxy는 기존 프록시 그룹을 가리켜야 하며, 기본 처리용 MATCH는 마지막에 두어 앞선 세부 규칙이 적용되도록 하세요.
구독은 원격 설정을 로컬로 가져와 프록시 매개변수를 하나씩 입력할 필요를 줄여 줍니다. ‘설정’ 페이지에서 ‘URL에서 가져오기’를 선택하고 서비스 제공업체가 안내한 설정 주소를 붙여 넣으세요. 가져온 뒤에는 해당 설정을 선택하고 활성화해야 합니다. YAML 파일을 직접 편집하는 것보다 구독을 이용하면 지속적으로 업데이트할 수 있지만, 원격 내용이 로컬 변경 사항을 덮어쓸 수 있습니다. 사용자 지정 규칙을 유지하려면 클라이언트의 오버라이드 또는 병합 기능을 이용하세요. 아래는 원격 프록시 목록의 설정 구조만 보여 주는 예시입니다. 예시 주소로는 실제 연결할 수 없으며, 완전한 구독 파일도 아닙니다.
‘규칙’, ‘전역’, ‘직접 연결’은 코어에 들어온 요청을 처리하는 방식을 정하며, 어떤 앱의 요청이 코어로 전달되는지는 정하지 않습니다. 평소에는 규칙 모드를 사용하세요. 규칙이 잘못 적용됐는지 확인하려면 잠시 전역 모드로 전환한 뒤 전역 프록시 그룹을 확인하면 됩니다. 직접 접속하려면 직접 연결 모드를 선택하세요. 전역 모드라고 해서 모든 앱이 프록시를 사용하는 것은 아닙니다. 시스템 프록시를 따르지 않는 프로그램은 클라이언트를 우회할 수 있습니다. 규칙 파일을 반복해서 수정하는 대신 모드를 바꿔 비교 테스트할 수 있지만, 테스트가 끝나면 원래 설정으로 되돌려 로컬 네트워크에 문제가 생기지 않도록 하세요.
config.yaml · 원하는 모드 하나 선택
# rule / global / direct
mode: rule
TUN 모드: 시스템 프록시를 따르지 않는 프로그램 연결하기
일부 게임, 명령줄 도구, 백그라운드 서비스는 시스템 프록시 설정을 읽지 않습니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 연결을 처리할 수 있습니다. 데스크톱 클라이언트의 ‘설정’에서 필요한 서비스를 설치한 뒤 ‘TUN 모드’를 켜세요. 필요한 권한은 클라이언트 안내를 따르세요. 시스템 프록시보다 TUN은 네트워크 계층에 더 가까운 방식으로 연결을 처리합니다. 다른 VPN, 가상 네트워크 어댑터, 기업 네트워크 라우팅과 충돌할 가능성도 큽니다. 처음 켜기 전에 일반 프록시가 작동하는지 확인하고 라우팅과 DNS도 점검하세요. 아래는 mihomo 설정 예시입니다. 모든 모바일 앱 화면에 적용되는 것은 아니며, 기존 설정 전체를 이 내용으로 덮어쓰면 안 됩니다.
웹페이지가 열리지 않으면 먼저 ‘연결’ 페이지에서 대상 요청이 표시되는지 확인하고, ‘로그’ 페이지에서 같은 시각의 오류를 찾아보세요. 연결 세부 정보에는 적용된 규칙과 프록시 경로가 표시되는 경우가 많습니다. 로그를 보면 도메인 조회, 연결 수립, 설정 로딩 중 어디에서 문제가 생겼는지 구분할 수 있습니다. 속도 테스트 결과만 보는 것보다 실패한 요청의 전체 상황을 확인하는 편이 더 유용합니다. 평소에는 info로 설정하고, 문제를 재현할 때만 잠시 debug로 바꾼 뒤 다시 되돌리세요. 로그를 공유하기 전에는 구독 주소, 인증 정보, 개인 접속 기록을 삭제하세요. 프록시 이름만 가리고 로그 전체를 공개해서는 안 됩니다.
config.yaml · 로그 설정
# 임시 진단 시 debug로 변경할 수 있습니다
log-level: info
모든 플랫폼용 클라이언트: 설정 방식은 참고하되 시스템 설정을 그대로 복사하지 마세요
데스크톱, 스마트폰, 라우터에서 비슷한 규칙 구조를 사용할 수 있지만 클라이언트 버튼, 코어 기능, 시스템 권한은 서로 다릅니다. 먼저 다운로드 페이지에서 기기에 맞는 클라이언트를 선택하고 지원되는 설정 범위를 확인하세요. 파일을 가져올 수 있다는 이유만으로 모든 항목이 적용된다고 단정해서는 안 됩니다. 코어를 직접 실행하는 것보다 GUI 클라이언트는 설정과 기능 스위치를 한곳에서 관리할 수 있습니다. 기기를 바꿀 때는 로컬 파일 경로, 수신 포트, TUN 매개변수를 확인하세요. 아래 예시는 제어 인터페이스를 로컬 기기로 제한하고 LAN 접근은 기본적으로 비활성화합니다. 데스크톱 설정을 다른 네트워크에 그대로 가져가지 않도록 주의하세요.
Clash는 규칙 기반 프록시 도구 생태계를 가리키는 이름이며, 모든 운영체제에서 같은 화면을 제공하는 단일 소프트웨어는 아닙니다. 다운로드 전에 기기의 운영체제를 확인하고 GUI 클라이언트와 코어를 구분하세요. GUI 클라이언트는 설정, 프록시, 시스템 옵션을 제공하고 코어는 설정을 읽고 연결을 처리합니다. 처음 사용하는 경우 GUI 클라이언트를 선택하면 됩니다. 서비스 관리나 명령줄 실행 옵션부터 익힐 필요는 없습니다.
설치 파일 이름에 포함된 프로세서 표기도 기기에 맞아야 합니다. 같은 운영체제라도 패키지를 공용으로 쓸 수는 없으며, 특히 데스크톱은 아키텍처에 따라 다릅니다. 업데이트하기 전 실행 중인 클라이언트를 종료하고 기존 설정과 필요한 옵션을 보존하세요. 다른 클라이언트로 옮길 때는 프로그램 데이터 폴더 전체를 복사하기보다 구독을 다시 가져오는 편이 좋습니다.
처음 설정할 때는 필요한 작업만 진행하세요. 구독을 가져와 현재 설정을 선택하고 규칙 모드를 지정한 다음, 사용하는 시스템에 맞는 연결 기능을 켭니다. 이후 특정 사이트를 열고 연결 페이지에서 적용된 정책을 확인하세요. 먼저 이 경로가 작동하는지 검증한 뒤 TUN, 시작 시 자동 실행, LAN 공유를 시도하면 여러 설정이 동시에 바뀌어 생기는 혼란을 줄일 수 있습니다.
Clash 노드 속도 테스트는 특정 시점에 테스트 대상과 연결할 수 있는지만 보여 줍니다. 모든 사이트에서의 실제 이용 환경을 보장하지는 않습니다. 속도 테스트는 정상인데 서비스 요청이 실패한다면 대상 도메인, 적용 규칙, 원본 로그를 확인하세요. 특정 앱만 실패한다면 먼저 해당 앱이 시스템 프록시를 사용하는지 확인하세요. 연결 문제는 문제 진단에서 확인할 수 있습니다. 반복해서 재설치하며 원인을 찾을 필요는 없습니다.
시스템 프록시, 전역 모드, TUN은 서로 다른 단계의 설정입니다
시스템 프록시는 프록시를 따르는 앱에 프록시 주소를 전달합니다. 전역 모드는 코어가 받은 요청의 출구를 선택하는 방식입니다. TUN은 더 많은 요청이 코어로 전달되는 경로를 바꿉니다. 각각 다른 단계를 처리하므로 서로 대체할 수 없습니다. 모드별 차이는 모드 선택을, 개별 도구에 프록시 주소를 입력하는 방법은 포트 설정을 확인하세요.
Clash 생태계는 원래 프로젝트, 후속 코어, 여러 GUI 클라이언트가 함께 발전해 왔습니다. 검색 결과로 찾은 가이드는 제작 시기에 따라 화면이 다를 수 있고, 같은 버튼 이름을 사용해도 서로 다른 코어를 기반으로 할 수 있습니다. 이 사이트에서는 설치, 시작하기, 문제 해결 자료를 나누어 제공합니다. 다운로드 페이지에서는 기기와 클라이언트를 선택하고, 가이드 페이지에서는 처음 설정하는 방법을, 문제 진단 페이지에서는 기존 설정이 예상대로 작동하지 않는 원인을 확인할 수 있습니다.
예전 스크린샷은 개념을 이해하는 데 도움이 되지만 현재 버튼 위치나 지원 필드를 판단하는 유일한 근거로 삼아서는 안 됩니다. 설정 오류가 발생하면 먼저 실행 중인 코어와 클라이언트를 확인한 다음 해당 필드의 지원 여부를 확인하세요. 오래전에 유지 관리가 중단된 프로그램으로 되돌려 예전 가이드를 그대로 따라 하지 마세요. 보관된 클라이언트를 꼭 사용해야 한다면 호환성과 유지 관리 상태를 먼저 파악하세요.
코어는 연결을 처리하고 클라이언트는 일상적인 작업을 관리합니다
mihomo는 Clash 생태계에서 지속적으로 개발되는 코어 프로젝트 중 하나로, 규칙 매칭, 프록시 연결 및 관련 네트워크 처리를 담당합니다. GUI 클라이언트는 그 위에 구독 관리, 프록시 그룹 선택, 로그 확인, 시스템 연동 기능을 제공합니다. 클라이언트 업데이트와 코어 업데이트는 별개입니다. 화면이 바뀌어도 규칙 문법은 그대로일 수 있고, 코어 기능이 추가되어도 GUI에 바로 반영되지 않을 수 있습니다. 지원 여부는 해당 프로젝트의 릴리스 노트와 문서에서 확인하세요.
설정 예시에 사용 환경을 표시해야 하는 이유도 여기에 있습니다. 데스크톱 mihomo에서 작동하는 설정이 모든 모바일 앱에 그대로 가져와지는 것은 아닙니다. 클라이언트를 바꾸기 전 구독 출처, 오버라이드 규칙, 필요한 로컬 매개변수를 보존한 뒤 하나씩 옮기세요. 이해할 수 있는 설정 부분만 복사하면 기존 파일 전체를 새 환경에 덮어쓰는 것보다 문제를 쉽게 찾을 수 있습니다.
소스 코드와 문서는 확인용이며 설치 절차를 대신하지 않습니다
공개 소스 코드를 통해 설정 필드를 이해하고, 이슈 논의를 확인하거나 개발에 참여할 수 있습니다. 아래 명령은 mihomo 프로젝트 저장소에서 소스 코드를 가져옵니다. 기기에 Git이 설치되어 있고 저장소에 접속할 수 있어야 합니다. 이 명령은 클라이언트를 설치하지 않으며 바로 사용할 수 있는 GUI 프로그램을 자동으로 만들지도 않습니다. 일반 사용자는 다운로드 페이지에서 설치 파일을 선택하면 됩니다. 소스 코드를 읽거나 프로젝트 문서에 따라 빌드하려는 경우에만 저장소를 복제하세요.
터미널 · mihomo 소스 코드 가져오기
git clone https://github.com/MetaCubeX/mihomo.git
업데이트 전 변경 사항을 확인하고, 업데이트 후 다시 테스트하세요
클라이언트, 코어, 구독은 각기 다른 경로로 업데이트됩니다. 클라이언트 업데이트는 프로그램과 시스템 연동 기능을 주로 바꾸고, 구독 업데이트는 프록시 목록, 프록시 그룹, 규칙을 바꿀 수 있습니다. ‘어제는 됐는데 오늘은 안 돼요’와 같은 문제가 생기면 무엇이 바뀌었는지 먼저 확인한 뒤 관련 로그를 살펴보세요. 복구할 수 있는 설정 사본을 보관하고 로컬 오버라이드 내용을 기록해 두면 연결을 복구하는 과정에서 직접 추가한 규칙까지 잃어버리는 일을 막을 수 있습니다.
업데이트 후에는 현재 설정이 계속 선택되어 있는지, 규칙 모드가 의도한 대로인지, 프록시 그룹에 사용할 수 있는 항목이 있는지, 로컬 포트가 바뀌지 않았는지 확인하세요. 설정 페이지에 업데이트 성공이라고 표시돼도 가져오기와 파싱이 완료됐다는 뜻일 뿐, 실제 대상 요청이 작동하는지는 별도로 확인해야 합니다. 규칙 데이터베이스 관련 문제는 GeoIP 관련 문제를 참고하세요. 연결 시간 초과가 발생하면 시간 초과 문제 해결의 순서에 따라 점검하세요.
설정 용어를 둘러싼 흔한 오해 세 가지
프록시 그룹은 프록시 프로토콜이 아닙니다. 프록시 그룹은 여러 출구를 선택하거나 속도를 측정하고 장애 시 전환하는 방식으로 묶어 관리합니다. 그룹 안에 포함된 실제 프록시마다 프로토콜 매개변수가 다릅니다. 그룹 내 항목을 직접 바꾸면 이후 연결의 출구가 달라질 수 있지만, 이미 연결된 장시간 연결은 바로 다시 연결되지 않을 수 있습니다. 그룹 이름이나 중첩 구조를 이해하기 어렵다면 Clash 프록시 그룹을 확인하세요. 규칙에서 참조하는 그룹을 임의로 삭제하지 마세요.
구독 업데이트가 반드시 규칙 업데이트를 의미하는 것은 아닙니다. 구독에 프록시 목록만 포함된 경우도 있고, 전체 설정이 들어 있는 경우도 있으며, 규칙이 별도의 규칙 모음에서 제공되기도 합니다. 업데이트 버튼이 무엇을 변경하는지는 클라이언트와 설정 구조에 따라 다릅니다. 프록시를 바꿨는데도 특정 사이트가 계속 직접 연결되면 구독을 반복해서 새로 고치기보다 적용된 규칙을 확인하세요. 설정 계층 구조는 용어 설명에서 분류별로 찾아볼 수 있습니다.
시작 시 자동 실행이 자동 연결을 뜻하지는 않습니다. 프로그램 실행, 마지막 설정 복원, 시스템 프록시 활성화는 각각 별도의 옵션일 수 있으며 시스템 권한도 복원 결과에 영향을 줍니다. 부팅 후 바로 사용할 수 있도록 설정하려면 먼저 전체 연결 과정을 직접 확인한 뒤 자동 실행을 켜고 재부팅해 테스트하세요. 화면은 표시되는데 네트워크 요청이 처리되지 않는다면 시작 시 자동 실행 문제에서 설정을 확인하세요. 구독이 잘못됐다고 단정하지 마세요.