Clash 실행 로그 읽는 법: 자주 나오는 오류 메시지의 의미와 문제 진단 방법
로그 레벨 설정부터 시작해 DNS 해석 실패, 핸드셰이크 시간 초과, 규칙 미매칭 등 빈번한 오류의 의미를 하나씩 풀어 설명하고, 오류 유형별로 원인을 찾는 실전 방법을 제시합니다.
Windows, macOS, Android, iOS, Linux 설치 파일을 한 곳에서 제공합니다. 규칙 분기와 YAML 설정을 기반으로 하는 오픈소스 프록시 클라이언트로, 구독 가져오기, TUN 모드, 다중 프로토콜 노드를 지원하며 사용법과 문제 해결 문서를 함께 제공합니다.
규칙 기반 프록시 클라이언트의 여섯 가지 기본 기능이며, 각각 실제 사용 중 마주치는 구체적인 문제와 직접 연결됩니다. 자세한 조작 절차는 사용법 페이지, 개념 설명은 용어 매뉴얼을 참고하세요.
도메인 키워드, 도메인 접미사, IP 대역, GeoIP, 프로세스명을 기준으로 트래픽을 하나씩 매칭하여 프록시, 직접 연결, 차단 중 하나로 분기합니다. 규칙은 위에서 아래로 매칭되며 일치 시 즉시 종료되고, 마지막에는 MATCH가 나머지를 처리합니다. 일괄적으로 전역 프록시를 쓰는 방식과 달리, 규칙 분기를 사용하면 로컬 사이트는 직접 연결을 유지하고 대상 사이트만 필요에 따라 노드를 거치게 되어 대역폭을 절약하고 지연을 줄일 수 있습니다. 규칙 세트는 원격 관리가 가능해 설정 하나만 업데이트하면 모든 기기에 반영되므로 일상적으로 수동 개입이 거의 필요 없습니다.
시스템 계층에 가상 네트워크 카드를 생성해 명령줄 도구, 게임 클라이언트를 포함한 모든 아웃바운드 트래픽을 처리하며, "브라우저만 프록시를 거친다"는 전형적인 공백을 보완합니다. mihomo 코어는 TUN을 기본 지원하므로 활성화하면 애플리케이션마다 개별적으로 프록시를 설정할 필요가 없고, fake-ip DNS 모드와 함께 사용하면 해석 대기 시간도 줄일 수 있습니다. 최초 활성화 시 클라이언트에 관리자 또는 VPN 권한을 부여해야 하며, 플랫폼별 활성화 방법은 사용법 페이지에 단계별로 안내되어 있습니다.
구독 링크를 붙여넣기만 하면 모든 노드와 그룹을 한 번에 가져올 수 있으며, 클라이언트가 설정한 주기에 따라 자동으로 업데이트를 가져오므로 노드가 바뀌어도 설정 파일을 직접 수정할 필요가 없습니다. 여러 개의 구독을 동시에 유지하며 용도에 따라 전환할 수 있고, 구독 업데이트에 실패하면 로그에 HTTP 상태 코드와 파싱 오류 위치가 표시되어 링크 만료와 로컬 네트워크 문제를 구분하기 쉽습니다. 여러 기기에서 같은 구독 링크를 공유하는 것이 설정 일관성을 유지하는 가장 간편한 방법입니다.
정책 그룹은 노드를 전환 가능한 집합으로 묶습니다: select는 수동 지정, url-test는 지연이 가장 낮은 노드를 자동 선택, fallback은 순서대로 장애 대응, load-balance는 트래픽을 분산합니다. 규칙이 특정 노드가 아닌 정책 그룹을 가리키므로 노드를 바꿔도 규칙을 수정할 필요가 전혀 없습니다. 그룹을 합리적으로 나누면 동영상, 다운로드, 업무용 트래픽을 각각 다른 그룹으로 처리해 서로 점유하지 않게 할 수 있고, 패널에서 현재 경로를 한눈에 확인하기도 쉬워집니다.
클라이언트에 내장된 HTTP 지연 테스트는 지정한 URL로 탐지 요청을 보내 각 노드의 밀리초 값을 표시하며, 시간 초과된 노드는 즉시 빨간색으로 표시됩니다. url-test 그룹은 테스트 결과에 따라 자동으로 전환되며, 테스트 간격과 허용 오차를 조정해 노드의 미세한 흔들림으로 인한 빈번한 전환을 방지할 수 있습니다. 테스트 주소와 타임아웃 값은 설정에서 직접 지정할 수 있으며, 로그의 핸드셰이크 기록과 함께 보면 노드 장애인지 로컬 네트워크 문제인지 빠르게 구분할 수 있습니다.
코어는 RESTful 제어 인터페이스를 제공하며, 웹 대시보드는 이를 바탕으로 활성 연결, 트래픽 속도, 실행 로그를 실시간으로 표시하고 노드 전환, 프록시 모드 변경, 속도 테스트 실행을 지원합니다. 문제 해결 시에는 먼저 패널을 확인하세요: 연결 목록에서 특정 요청이 어떤 규칙에 매칭되어 어떤 노드를 거쳤는지 확인할 수 있고, 로그는 등급별로 출력되므로 debug 레벨로 설정하면 DNS 해석과 프로토콜 핸드셰이크의 상세 내역까지 볼 수 있습니다.
5개 플랫폼에는 각각 여러 선택 가능한 클라이언트가 있으며, 다운로드 페이지에서 플랫폼별로 추천 순서와 시스템 요구 사항을 정리했습니다. 플랫폼을 클릭하면 해당 섹션으로 바로 이동합니다.
설치부터 프록시 작동 확인까지 표준 절차는 세 단계뿐입니다. 아래는 간략 미리보기이며 전체 스크린샷과 플랫폼별 차이는 사용법 페이지를 참고하세요.
다운로드 페이지에서 해당 플랫폼의 설치 파일을 선택해 설치를 완료한 뒤, 클라이언트의 구독 또는 설정 관리 화면을 열어 서비스 제공자가 준 구독 링크를 붙여넣고 가져오기를 확인합니다. 가져오기가 성공하면 노드 목록과 정책 그룹이 자동으로 나타나며 설정 파일을 직접 편집할 필요가 없습니다.
프록시 모드는 기본값인 "규칙 모드"를 그대로 두면 설정 내 규칙에 따라 자동으로 분기됩니다. 정책 그룹 화면에서 수동 선택 그룹에 들어가 지연이 낮은 노드를 하나 고르고, 확신이 없다면 지연 테스트를 한 번 눌러 밀리초 값이 낮은 순서대로 선택합니다.
"시스템 프록시" 스위치를 켠 뒤(명령줄 및 전역 트래픽이 필요하면 TUN 모드 사용) 목표 사이트에 접속해 연결을 확인합니다. 접속이 안 되면 먼저 클라이언트 로그를 확인해 노드 문제인지 로컬 설정 문제인지 구분하고, 자세한 해결 경로는 문제 해결 문서를 참고하세요.
Clash는 커뮤니티가 주도하는 오픈소스 프로젝트군으로, 소스 코드가 공개되어 있어 누구나 확인할 수 있습니다. 아래 네 항목에서 프로젝트의 흐름을 설명하여 어떤 코어, 어떤 클라이언트를 써야 할지 판단하는 데 도움을 드립니다.
Clash는 처음에는 커뮤니티가 유지보수하던 오픈소스 규칙 기반 프록시 코어로, YAML 설정 형식과 "규칙이 경로를 결정한다"는 설계로 이 계열 클라이언트의 형태를 확립했습니다. 원본 저장소가 보관 처리된 뒤에도 프로젝트는 중단되지 않았습니다: 커뮤니티가 해당 프로토콜과 설정 형식을 바탕으로 계속 발전시켜 왔으며, 설정 문법, 규칙 작성법, 정책 그룹 개념이 그대로 계승되어 기존 설정 파일 대부분이 새 코어에서도 바로 작동합니다.
현재 가장 활발히 유지보수되는 코어 분기는 mihomo(구 Clash Meta)입니다. 원본을 기반으로 VLESS, Hysteria2, TUIC 등 프로토콜 지원을 확장했고, TUN 모듈과 강화된 규칙 세트를 내장하고 있어 본 사이트가 추천하는 클라이언트들이 널리 채택하는 코어입니다. 코어와 GUI 클라이언트는 서로 다른 계층입니다: 코어는 프록시 로직을 담당하고 GUI는 설정 관리와 화면 상호작용을 담당하므로, 이 관계를 이해하면 문제 해결 시 방향을 잡는 데 도움이 됩니다.
코어를 중심으로 여러 플랫폼을 아우르는 클라이언트 생태계가 형성되었습니다: Clash Plus, Clash Verge Rev, FlClash 등의 프로젝트가 각각 데스크톱과 모바일 플랫폼을 다루며 독립적으로 배포·유지보수됩니다. 유지보수가 종료된 Clash for Windows와 ClashX Meta는 다운로드 페이지에 보관 표시와 대체 제품 안내를 함께 제공해 신규 사용자가 더 이상 업데이트되지 않는 소프트웨어를 설치하지 않도록 돕습니다.
본 사이트는 각 클라이언트의 정식 배포 채널을 따라 다운로드 링크를 동기화하며 버전 번호는 다운로드 페이지에 실시간으로 표시됩니다. 사용법, 용어 매뉴얼, 기술 참고 문서는 코어 기능 변화에 맞춰 계속 갱신됩니다. 코어 소스 코드는 GitHub에서 확인할 수 있으며, 서버나 라우터에서 코어를 직접 실행하려는 사용자는 저장소에서 모든 배포 버전을 받을 수 있습니다.
코어 소스 코드 받기
git clone https://github.com/MetaCubeX/mihomo.git
자주 나오는 질문 네 가지에 대한 한 줄 결론이며, 전체 답변과 더 많은 질문은 자주 묻는 질문 페이지에서 확인할 수 있습니다.
로그 해석, 코어 차이, 문제 해결을 다루는 실전 아티클을 발행일 최신순으로 최근 세 편 소개합니다.
로그 레벨 설정부터 시작해 DNS 해석 실패, 핸드셰이크 시간 초과, 규칙 미매칭 등 빈번한 오류의 의미를 하나씩 풀어 설명하고, 오류 유형별로 원인을 찾는 실전 방법을 제시합니다.
시스템 프록시가 적용되는 범위를 설명하고, 브라우저가 프록시를 거치지 않는 경우와 터미널 명령이 프록시를 거치지 않는 경우의 점검 절차를 각각 제시하며, 프록시 스위치, 환경 변수, TUN 모드 선택까지 다룹니다.
mihomo(Clash Meta)가 원본 코어 대비 확장한 기능을 정리합니다: VLESS, Hysteria2 등 프로토콜 지원, 내장 TUN, 강화된 규칙 세트를 다루며 기존 설정을 옮길 때 주의할 호환성 포인트를 설명합니다.