클라이언트 · 코어 · 프로토콜 참고 자료

Clash 리뷰
클라이언트 다운로드와 선택

Clash 다운로드 가이드 보기

기기와 설정을 기준으로 멀티플랫폼 클라이언트를 비교하고 규칙 분기와 프로토콜 선택을 살펴보세요. 먼저 호환성을 확인한 뒤 연결 방식을 조정하세요.

  • 오픈소스 생태계
  • 한국어 설정 가이드
  • mihomo 코어 참고 자료

자주 겪는 문제 / 원인부터 확인

구독, 인증서, DNS: 자주 발생하는 세 가지 문제

가져오기 성공, 프록시 활성화, 웹페이지 접속은 각각 별도로 확인해야 합니다. 오류 메시지를 그대로 보관하고 설정을 한 번에 하나씩 바꾸면 노드, 코어, DNS를 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.

Clash 구독 업데이트 실패

먼저 로그에서 요청 시간 초과, 서버 거부, 설정 파싱 실패를 구분하세요. 시간 초과라면 현재 네트워크와 업데이트 요청의 프록시 경유 여부를 확인합니다. 접근이 거부되면 구독 유효 기간과 계정 상태를 살펴보세요. 파싱에 실패했다면 응답이 로그인 페이지인지, 형식이 호환되지 않는지 확인해야 합니다. 전체 구독 링크를 반복해서 공개하지 말고 모든 설정을 급히 지우지도 마세요. 이전에 작동하던 설정을 보관한 뒤 항목별로 확인하세요. 자세한 내용은 구독 문제 FAQ를 참고하세요.

프록시를 켠 뒤 인증서 오류 발생

인증서 오류가 발생했다고 새 인증서를 설치해야 하는 것은 아닙니다. 먼저 시스템 시간과 시간대를 확인한 뒤 프록시를 끄거나 노드를 바꿨을 때 결과가 달라지는지 비교해 문제가 기기에서 발생했는지 연결 경로에서 발생했는지 판단하세요. 일반적인 HTTPS 프록시 연결에는 웹 트래픽을 클라이언트에서 복호화할 필요가 없습니다. 출처가 불분명한 루트 인증서는 시스템의 신뢰 체계를 바꿀 수 있습니다. 인증서 검증을 끄는 방식으로 문제를 덮지 말고 구체적인 오류 코드를 기록한 다음 인증서 오류 해결 단계에 따라 확인하세요.

예상과 다른 DNS 경로

시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며, 모든 도메인 조회를 코어가 처리한다고 보장하지 않습니다. 브라우저의 보안 DNS, 시스템 DNS 캐시, 다른 VPN이 실제 경로를 바꿀 수 있습니다. 문제를 확인할 때는 먼저 어떤 앱이 요청을 보냈는지 파악한 뒤 코어 DNS가 활성화되어 있는지, TUN이 트래픽을 처리하는지, DNS 서버에 연결할 수 있는지 확인하세요. 테스트 페이지 하나만으로 모든 트래픽의 경로를 단정할 수는 없습니다. 로그와 연결 기록을 함께 살펴보고 DNS 및 네트워크 FAQ를 참고하세요.

설정 자료 탐색

Clash 핵심 기능과 설정의 범위

먼저 그래픽 클라이언트의 역할과 코어의 처리 범위를 구분한 뒤 더 복잡한 설정이 필요한지 판단하세요. 아래 예시는 각 항목을 설명하기 위한 것으로, 그대로 가져올 수 있는 완전한 구독 설정이 아닙니다.

RULES / 목적지별 경로 선택

규칙 분기: 규칙은 개수보다 순서가 중요합니다

규칙 모드는 설정에 적힌 순서대로 대상 도메인, 주소 또는 규칙 세트를 확인하고, 일치하는 항목에 지정된 정책을 적용합니다. 직접 연결과 프록시 연결을 함께 사용하는 일상적인 환경에 적합하며, 앱마다 전역 모드를 반복해서 바꿀 필요가 없습니다. 사용자 지정 규칙을 추가하기 전에 정책 그룹이 실제로 있는지 확인하고, 앞선 규칙에 가려지지 않는지도 살펴보세요. 단일 스위치만 제공하는 프록시 도구와 달리 Clash 생태계는 정책 그룹과 규칙의 조합을 중요하게 다룹니다. 규칙 세트의 적용 범위와 업데이트 출처, 최종 기본 규칙을 사용자가 이해해야 합니다.

mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,PROXY
규칙 문법과 우선순위 보기

자료는 9초마다 바뀝니다. 탭 클릭, 키보드 조작 또는 포커스 이동 시 전환이 멈춥니다. 동작 줄이기 설정을 사용하면 정지된 상태로 읽을 수 있습니다.

기기별 다운로드 페이지로 이동

플랫폼별 Clash 클라이언트

그래픽 클라이언트는 데스크톱과 모바일에서 일상적으로 사용하기 좋고, 독립 코어는 서버를 직접 관리하는 사용자에게 적합합니다. 다운로드 페이지에서 설치 파일 형식, 아키텍처와 유지 관리 상태를 확인하세요. 파일명이 비슷한 다른 패키지를 잘못 설치하지 않도록 먼저 기기 조건을 확인한 뒤 기능을 비교하세요.

Windows

Clash Plus부터 비교한 뒤 서비스 모드, 구독 덮어쓰기와 인터페이스 선호에 따라 Clash Verge Rev, FlClash 또는 Clash Nyanpasu를 선택하세요. Clash for Windows는 유지 관리가 중단되었습니다. 보관된 설치 파일은 명확한 호환성 요구가 있는 환경에 적합하며, 익숙한 이름만 보고 새 설치의 우선 선택으로 삼지는 마세요.

다운로드 페이지로 이동

macOS

먼저 시스템의 '이 Mac에 관하여'에서 Apple 칩과 Intel 프로세서를 구분한 다음 해당 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev와 FlClash를 비교할 수 있습니다. ClashX Meta는 유지 관리가 중단되었습니다. 설치 후에는 시스템 권한, 프록시 처리와 백그라운드 서비스를 각각 확인하세요. 창이 열리는 것만으로 연결이 정상이라고 판단할 수는 없습니다.

다운로드 페이지로 이동

Android

먼저 프로세서 아키텍처와 시스템 설치 요구 사항을 확인한 뒤 Clash Plus, Clash Meta for Android, FlClash와 Surfboard의 설정 형식을 비교하세요. 처음 연결할 때는 보통 VPN 권한이 필요합니다. 백그라운드에서 연결이 끊기면 구독을 계속 바꾸기 전에 배터리 절약 제한과 다른 VPN의 사용 여부부터 확인하세요.

다운로드 페이지로 이동

iOS

Clash Plus는 App Store에서 설치할 수 있으며, 제품 정보는 공식 사이트 clashplus.io에서 확인할 수 있습니다. 가져오기 전에 설정의 호환 범위를 확인하고, 처음 연결할 때 시스템 안내에 따라 VPN 설정 추가를 허용하세요. 연결 전환이나 백그라운드 문제는 시스템 권한, 구독 상태와 노드 연결 가능성을 구분해 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 Clash Verge Rev와 FlClash를 먼저 비교하고 배포판에 맞는 패키지 형식을 선택한 뒤 그래픽 환경과 의존성을 확인하세요. 서버, 라우터 또는 시작 서비스를 직접 관리하는 사용자는 다운로드 페이지의 mihomo 코어 항목을 확인할 수 있습니다. 그래픽 클라이언트와 독립 코어를 함께 설치해야 작동하는 것은 아닙니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

첫 설정 / 세 단계 미리보기

구독 가져오기부터 연결 확인까지

설치, 설정, 트래픽 처리를 나누어 진행하세요. 문제가 생기면 처음부터 다시 설치하기보다 현재 단계에서 멈춰 로그를 확인하는 편이 유효한 단서를 보존하기 쉽습니다.

  1. 설정 가져오기 및 활성화

    클라이언트의 설정 또는 구독 페이지에서 링크를 추가하세요. 업데이트가 완료되면 해당 설정을 직접 선택합니다. 인터페이스에 정책 그룹이 표시되는지 확인하고 파싱 오류가 있는지도 살펴보세요. 로그인 페이지가 응답으로 표시된다면 먼저 구독 출처 문제를 해결해야 합니다. 전체 링크에는 보통 접근 정보가 포함되어 있으므로 화면을 공유하거나 도움을 요청하기 전에 가리세요.

  2. 모드와 트래픽 처리 방식 선택

    일상적으로는 규칙 모드를 선택하고 정책 그룹에서 사용할 수 있는 노드를 고른 다음 시스템 프록시를 활성화하세요. 시스템 프록시를 따르지 않는 앱의 트래픽을 처리해야 할 때만 TUN을 추가로 설정하세요. 전역 모드는 잠깐 비교하거나 문제를 확인할 때 유용하지만 규칙 모드보다 더 완전한 방식은 아니며, 규칙 적용 여부 확인을 대신할 수도 없습니다.

  3. 연결 기록으로 경로 확인

    대상 서비스에 접속한 뒤 연결 페이지에서 해당 도메인, 적용된 규칙과 실제 정책을 확인하세요. 속도 측정에 한 번 성공했다고 해서 모든 앱의 트래픽이 처리된다는 뜻은 아닙니다. 확인을 마치면 작동하는 설정과 필요한 로컬 덮어쓰기를 보관하세요. 이후 업데이트에 문제가 생겼을 때 비교할 기준이 됩니다.

전체 가이드 보기 →

오픈소스 생태계 / 자료 출처

클라이언트와 코어의 유지 관리 관계

Clash 생태계는 단일 설치 파일로 이루어진 제품군이 아닙니다. 초기 Clash가 프록시, 정책 그룹과 규칙 설정의 기본 구조를 만들었고, 이후 코어와 그래픽 클라이언트는 각기 다른 방향으로 발전했습니다. Clash 리뷰는 다운로드와 선택 정보를 제공하는 사이트이며 해당 프로젝트의 개발 주체가 아닙니다. 추천은 플랫폼 지원 범위, 기능 요구와 유지 관리 상태를 기준으로 하며 사이트 브랜드를 소프트웨어의 공식 지위로 내세우지 않습니다.

이 관계를 이해하면 업데이트 내용을 더 정확히 읽을 수 있습니다. 인터페이스 수정은 시스템 트레이나 창 동작에만 영향을 줄 수 있지만, 코어 업데이트는 프로토콜 파싱, 규칙 처리와 DNS 동작을 바꿀 수 있습니다. 선택할 때는 두 항목을 모두 확인하세요. 설치 파일 이름이나 한 번의 인터페이스 개편만으로 기능 전체가 바뀌었다고 판단해서는 안 됩니다.

프로토콜 및 코어 기술 자료 읽기 →

소스 코드로 기능 설명 확인

mihomo 공개 저장소에서 소스 코드, 이슈 논의와 릴리스 기록을 확인할 수 있습니다. 아래 명령은 프로젝트 소스 코드만 가져오며 클라이언트를 설치하거나 기기의 그래픽 인터페이스를 대신하지 않습니다.

git clone https://github.com/MetaCubeX/mihomo.git
mihomo 저장소 보기 ↗

프로젝트의 역사와 이름

Clash Meta는 이후 mihomo로 이름이 바뀌었기 때문에 가이드에서 두 이름이 함께 나올 수 있습니다. 이전 이름은 자료의 출처를 파악하는 데 도움이 되지만, 이전 설정이 현재 코어와 완전히 호환된다는 뜻은 아닙니다. 오래된 글을 읽을 때는 개념 설명과 구체적인 설정 항목을 구분하세요. 정책 그룹과 매칭 순서는 여전히 참고할 만한 경우가 많지만, 프로토콜 매개변수, DNS 동작과 플랫폼 권한은 다시 확인해야 합니다. Clash for Windows의 지원 중단이 Clash 생태계 전체의 개발 중단을 뜻하지는 않습니다.

오픈소스 협업과 이슈 기록

공개된 소스 코드를 통해 구현과 변경 내역을 확인할 수 있지만, 오픈소스라는 사실만으로 호환성 테스트가 이루어지는 것은 아닙니다. 문제를 재현할 수 있는지, 로그가 같은 모듈을 가리키는지, 수정 내용이 사용 중인 클라이언트의 릴리스에 반영되었는지가 더 유용한 근거입니다. 이슈를 제출할 때는 운영체제, 코어 출처, 재현 단계와 민감 정보를 가린 로그를 적고 전체 구독이나 개인 네트워크 정보를 올리지 마세요. 다른 사용자의 비슷한 기록은 참고 자료로 활용하되 현재 기기의 진단 결과로 단정해서는 안 됩니다.

코어 호환성과 마이그레이션

이전할 때는 원본 설정 사본을 보관한 뒤 새 클라이언트에 가져와 테스트하세요. 문법 검사를 통과하는 것은 첫 단계일 뿐입니다. 정책 그룹 참조, 규칙 세트 다운로드, DNS 조회와 실제 연결 경로도 확인해야 합니다. 클라이언트에 설정 병합 기능이 있다면 원격 구독에서 관리하는 항목과 로컬 덮어쓰기 항목을 구분하세요. 최소한의 설정으로 먼저 실행한 뒤 고급 옵션을 하나씩 복원하면 이전 디렉터리를 통째로 복사하는 것보다 차이를 찾기 쉽고, 과거 캐시가 판단에 영향을 주는 일도 막을 수 있습니다.

업데이트 방식과 선택 기준

클라이언트, 함께 제공되는 코어, 구독과 규칙 세트는 각각 별도로 업데이트될 수 있습니다. 한 항목을 업데이트해도 나머지가 자동으로 동기화되지는 않습니다. 업그레이드 전에 필요한 기능과 관련된 변경 사항을 읽고, 업그레이드 후에는 같은 대상으로 연결을 확인하세요. 장기적으로 사용할 때는 이름에 '새 버전'이 들어가는지보다 유지 관리 상태, 설정 이전 가능 여부와 문제 정보의 명확성을 우선하세요. 다운로드 페이지에서 설치 경로를 확인하고, 클라이언트 비교 페이지에서 선택 이유를 살펴본 뒤 프로토콜 가이드로 전송 방식과 호환성을 판단할 수 있습니다.

리뷰 노트 / 최신 글

규칙 설정과 문제 해결

각 글은 구체적인 문제 하나를 중심으로 현상을 정의하고 작동 원리를 설명한 뒤 결과를 확인할 수 있는 방법을 안내합니다. 로컬 환경 설정을 변경할 때는 기존 설정을 보관하고, 하나의 문제를 해결하기 위한 설정을 모든 연결에 적용하지 마세요.

전체 글 보기 →