클라이언트
클라이언트는 설정을 조작하는 인터페이스입니다. 구독 가져오기, 정책 전환, 로그 확인, 시스템 프록시 활성화 등을 보통 클라이언트 화면에서 처리합니다. 실제 설정을 해석하고 연결을 전달하는 작업은 커널이 맡으므로, 같은 커널을 서로 다른 인터페이스와 함께 사용할 수 있습니다. 가이드에서 옵션을 찾을 때는 먼저 클라이언트 이름을 확인하세요. 화면 구성이 다르다고 해서 해당 기능이 없는 것은 아닐 수 있습니다.
용어 찾아보기 / 설정 비교
Clash 용어 가이드
먼저 트래픽이 커널로 들어오는 방식을 확인한 다음, 규칙이 연결 경로를 어떻게 선택하는지 살펴보세요. 용어를 주제별로 찾아보고 설정 필드와 클라이언트 옵션을 연결해 이해할 수 있습니다.
커널과 클라이언트
인터페이스, 커널, 트래픽 처리 방식 구분하기
인터페이스에서 설정을 가져올 수 있다고 해서 커널이 모든 필드를 지원하는 것은 아닙니다. 문제를 해결하기 전에 클라이언트 이름, 실제 사용 중인 커널, 트래픽이 커널에 들어오는 방식을 확인하세요.
mihomo 커널
mihomo는 네트워크 연결을 처리하는 핵심 프로그램입니다. 설정을 읽고 DNS를 조회한 뒤 규칙을 적용해 직접 연결하거나 프록시 연결을 구성합니다. Clash Meta의 기술 계보를 이어받았으며, 그래픽 클라이언트에서 호출하거나 독립적으로 실행할 수 있습니다. 지원되지 않는 필드나 인식할 수 없는 프로토콜이 있다면 클라이언트의 업데이트 날짜만 보지 말고 실제 실행 중인 커널을 확인하세요.
Clash Meta
오래된 문서에서 Clash Meta는 보통 Clash 생태계의 커널 분기를 가리키며, 과거 명칭이 현재의 mihomo와 관련이 있습니다. 일부 클라이언트, 구독 유형, 가이드에서는 여전히 Meta라는 표현을 사용하지만, 이를 근거로 같은 애플리케이션이라고 단정할 수는 없습니다. 오래된 설정을 읽을 때는 현재 커널 문서에서 필드 의미를 확인하고, 특히 DNS, TUN, 신규 프로토콜 매개변수의 차이에 유의하세요.
시스템 프록시
시스템 프록시를 켜면 운영체제의 프록시 설정이 클라이언트가 수신 대기하는 로컬 주소와 포트를 가리킵니다. 이 설정을 따르는 브라우저와 앱은 연결을 프록시로 전달하지만, 직접 네트워크에 연결하는 프로그램이나 일부 터미널 도구, 게임은 이를 따르지 않을 수 있습니다. 브라우저는 되는데 다른 앱이 연결되지 않는다면 먼저 해당 앱의 프록시 설정 지원 여부를 확인하고, 필요할 때 TUN으로 트래픽을 처리하세요.
지연 시간
지연 시간은 특정 테스트에 걸린 시간이지 노드 속도 점수가 아닙니다. 테스트 주소, 연결 설정 방식, 시간 초과 기준, 당시의 네트워크 혼잡도에 따라 결과가 달라지며 클라이언트별 수치를 직접 비교하기 어려울 수 있습니다. 지연 시간이 짧아도 대역폭이 낮거나 패킷 손실이 발생할 수 있으므로 실제 웹사이트 연결, 지속 전송 상태, 안정성도 확인해야 합니다.
프록시 프로토콜
프로토콜과 전송 매개변수 확인하기
프로토콜 이름은 연결 설정의 일부일 뿐입니다. 인증 정보, 전송 방식, TLS, 서버 매개변수를 함께 맞춰야 합니다. 노드 이름만으로 호환 여부를 판단할 수는 없습니다.
Shadowsocks
암호화 방식과 인증 정보를 사용해 연결하는 프록시 프로토콜입니다. 일반적인 설정에는 서버 주소, 포트, 암호화 방식, 비밀번호가 포함됩니다. 클라이언트와 서버가 같은 암호화 방식을 지원해야 하며, 프로토콜 이름만 일치하는 것으로는 충분하지 않습니다. 구독을 가져왔는데 연결에 실패한다면 암호화 방식과 매개변수가 모두 있는지, 현재 커널이 해당 설정의 확장 기능을 지원하는지 확인하세요.
VMess
사용자 ID 등의 매개변수로 인증하는 프록시 프로토콜입니다. 연결에는 WebSocket, gRPC, TLS 같은 전송 설정이 함께 사용될 수 있습니다. 사용자 ID가 맞더라도 경로나 호스트명이 다르면 연결되지 않을 수 있습니다. 구독을 변환한 뒤 특정 노드만 작동하지 않는다면 서버 주소만 비교하지 말고 관련 필드가 유지되었는지 확인하세요.
VLESS
가벼운 프록시 프로토콜로, 실제 배포에서는 보통 TLS나 REALITY 같은 방식으로 전송을 보호합니다. 사용자 ID, 전송 방식, 경우에 따라 포함되는 flow 필드는 서버 설정과 일치해야 합니다. VMess와 사용자 ID를 쓴다는 이유만으로 프로토콜 유형을 서로 바꾸지 마세요. 호환성 문제가 생기면 전체 매개변수와 커널 지원 여부를 확인해야 합니다.
Trojan
일반적으로 TLS로 전송하고 비밀번호로 인증하는 프록시 프로토콜입니다. 인증서와 서버 이름도 연결에 중요한 조건입니다. 주소와 비밀번호가 맞아도 기기의 시간이 잘못되었거나 인증서가 만료되었거나 서버 이름이 일치하지 않으면 연결에 실패할 수 있습니다. TLS 오류가 발생하면 먼저 시간과 서버 이름 설정을 확인하고, 인증서 검증을 건너뛰어 문제를 숨기지 마세요.
Hysteria 2
QUIC 기반 프록시 프로토콜로, UDP를 사용하므로 현재 네트워크에서 관련 UDP 통신을 허용하는지가 연결 가능 여부에 직접 영향을 줍니다. 초기 Hysteria 설정과 같은 방식이라고 단정할 수 없으므로 가져올 때 프로토콜 유형과 인증 필드를 확인하세요. 한 네트워크에서는 되지만 다른 네트워크에서 시간 초과가 발생한다면 서버뿐 아니라 UDP 제한과 대역폭 설정도 점검해야 합니다.
규칙과 트래픽 분류
규칙 적용 순서에 따라 연결 경로 이해하기
먼저 연결이 커널에 들어왔는지 확인한 다음 어떤 규칙이 일치했는지 살펴보세요. 아래 구문에서 PROXY는 예시 정책 이름이므로 실제 설정에 해당 정책이 있어야 합니다.
규칙 분류
규칙 모드에서는 커널이 설정 순서대로 연결을 확인하며, 일반적으로 처음 일치하는 규칙이 사용할 연결 경로를 결정합니다. 규칙은 도메인, 대상 IP 등의 조건으로 트래픽을 구분할 수 있지만, 애초에 커널에 들어오지 않은 요청을 가져올 수는 없습니다. 트래픽 분류를 바꾸기 전에 연결 상세 정보에서 일치한 규칙을 확인하고 해당 항목을 수정하세요. 웹사이트가 열리는지만 보고 규칙이 적용됐다고 판단하지 마세요.
DOMAIN-SUFFIX
특정 도메인과 하위 도메인에 적용할 수 있습니다. 예를 들어 DOMAIN-SUFFIX,github.com,PROXY는 해당 도메인과 하위 도메인에 일치합니다. URL 전체가 아니라 도메인 접미사를 확인하며 웹페이지 경로는 검사하지 않습니다. 규칙을 추가할 때 프로토콜이나 슬래시를 넣지 말고, 먼저 일치할 수 있는 광범위한 규칙보다 위에 배치하세요.
GeoIP
IP 지리 데이터베이스를 사용해 대상 주소의 지역을 판단합니다. 예를 들어 GEOIP,CN,DIRECT는 해당 지역으로 분류된 주소를 직접 연결합니다. 데이터베이스상 지역이 웹사이트 운영자의 소재지를 뜻하지 않으며, 콘텐츠 전송 네트워크나 주소 업데이트도 판단에 영향을 줄 수 있습니다. 규칙에 도메인 조회가 필요할 수 있으므로 같은 도메인의 연결 경로가 달라진다면 DNS 결과, 데이터베이스, 규칙 순서를 함께 확인하세요.
MATCH
앞선 규칙에 모두 일치하지 않은 연결을 처리하도록 규칙 목록의 마지막에 둡니다. 예를 들면 MATCH,PROXY와 같습니다. 도메인이나 IP 조건을 추가로 검사하지 않으며 너무 앞에 배치하면 뒤의 규칙은 보통 적용되지 않습니다. 기본 정책은 실제 요구에 맞게 선택하세요. 프록시로 설정했다고 해서 이미 직접 연결 규칙에 일치한 연결까지 프록시로 바뀌는 것은 아닙니다.
정책 그룹
여러 노드나 다른 정책을 이름이 있는 그룹으로 묶으면 규칙에서 단일 서버 대신 해당 이름을 참조할 수 있습니다. 자주 쓰이는 유형에는 수동 선택, 자동 테스트, 장애 전환이 있으며 전환 방식은 유형마다 다릅니다. 규칙이 올바른 정책 그룹에 일치했는데도 경로가 예상과 다르면 같은 규칙을 반복해서 추가하기보다 그룹에서 현재 선택된 항목과 중첩 구조를 확인하세요.
DNS와 네트워크
DNS 조회 경로와 연결 경로 구분하기
도메인에서 주소를 찾는 과정과 이후 연결이 기기에서 나가는 경로는 서로 관련은 있지만 별개의 문제입니다. 문제를 확인할 때는 DNS 리졸버, 조회 결과, 연결 경로를 각각 기록하세요.
DNS
DNS는 도메인을 IP 주소 등의 레코드로 조회하는 시스템이며, 앱은 보통 조회 결과를 받은 뒤 대상에 연결합니다. 운영체제, 브라우저, 커널이 모두 DNS 조회에 관여할 수 있으므로 클라이언트의 DNS를 바꿔도 모든 앱에 적용되는 것은 아닙니다. 도메인에 접속할 수 없다면 먼저 요청이 실제로 어느 DNS 리졸버로 전달됐는지 확인하고, 조회 실패와 주소를 받은 뒤의 연결 실패를 구분하세요.
Fake-IP
이 DNS 처리 방식을 사용하면 커널이 앱에 가상 주소를 반환하고 해당 주소와 원래 도메인의 매핑을 유지합니다. 이후 트래픽이 커널로 돌아오면 이 매핑으로 도메인을 식별해 설정에 따라 처리할 수 있습니다. 가상 주소는 프록시 서버 주소가 아닙니다. 실제 DNS 결과에 의존하는 일부 앱에서 호환 문제가 생기면 필터 목록을 확인하고, 곧바로 DNS 설정 전체를 다시 작성할 필요는 없습니다.
TUN 모드
가상 네트워크 인터페이스와 라우팅 설정을 통해 처리 대상 IP 트래픽을 커널로 전달하므로 시스템 프록시를 따르지 않는 일부 앱에 적합합니다. 켜려면 보통 시스템 권한이 필요하며 다른 VPN, 가상 네트워크 어댑터, 라우팅 설정과 충돌할 수 있습니다. TUN은 트래픽이 커널로 들어오는 방식만 바꾸며 이후에는 현재 모드와 규칙에 따라 경로를 선택합니다. 모든 연결이 프록시를 통과한다는 뜻은 아닙니다.
DNS 유출
지정된 DNS 경로로 처리해야 하는 조회가 다른 경로로 전송되어 조회 정보가 노출되는 현상을 DNS 유출이라고 합니다. 검사 페이지에 특정 통신사나 지역이 표시된다는 사실만으로 유출이라고 단정할 수는 없습니다. DNS 리졸버의 위치와 연결 경로가 서로 다를 수 있기 때문입니다. 먼저 어떤 요청을 어느 경로로 보낼지 정한 다음 브라우저의 보안 DNS, 시스템 DNS, 커널 설정이 일치하는지 확인하세요.
DNS 가로채기 설정
클라이언트 설정에서 DNS 가로채기는 보통 조건에 맞는 DNS 요청을 커널의 DNS 처리 모듈로 리디렉션하는 것을 뜻하며, 네트워크 공격을 의미하지 않습니다. TUN 설정의 dns-hijack을 이러한 트래픽 처리에 사용할 수 있지만, 실제 적용 범위는 플랫폼, 라우팅, 요청 방식에 따라 달라집니다. 앱이 자체적으로 사용하는 암호화 DNS에는 같은 방식이 적용되지 않을 수 있으므로 앱 설정과 연결 기록을 함께 확인하세요.
구독 및 설정 파일
노드 데이터와 전체 설정 구분하기
파일을 다운로드할 수 있다고 해서 내용을 바로 사용할 수 있는 것은 아닙니다. 먼저 구독이 노드 모음인지 전체 설정인지 확인한 뒤 필드, 참조 관계, 업데이트 방식을 점검하세요.
구독
구독은 노드나 전체 설정을 가져오고 업데이트하는 원격 콘텐츠 경로이며, 정해진 파일 형식을 뜻하지 않습니다. 응답은 YAML, Base64로 인코딩된 노드 목록, 여러 URI 등 다양한 형식일 수 있고 바로 가져올 수 있는지는 클라이언트 지원 여부에 달려 있습니다. 구독 주소에는 접근 인증 정보가 포함되는 경우가 많으므로 계정 정보처럼 안전하게 보관하세요. 문제 해결을 위해 전체 링크를 공개 로그, 스크린샷, 온라인 변환 사이트에 붙여 넣지 마세요.
노드
노드는 프록시 서버에 연결하는 데 필요한 매개변수 모음으로, 일반적으로 프로토콜, 서버 주소, 포트, 인증 정보, 전송 설정이 포함됩니다. 목록의 표시 이름은 노드를 구분하기 위한 것으로, 실제 서버 위치나 회선 품질, 대역폭을 보장하지 않습니다. 특정 노드가 작동하지 않으면 같은 설정에 있는 다른 노드부터 테스트한 뒤 개별 연결 매개변수 문제인지, 로컬 트래픽 처리나 기본 네트워크 문제인지 확인하세요.
YAML
Clash 설정에 자주 쓰이는 구조화된 텍스트 형식으로, 공백 들여쓰기로 계층을 표현하고 목록과 키-값 쌍으로 데이터를 구성합니다. 편집할 때는 들여쓰기를 일정하게 유지하고 탭을 사용하지 마세요. 콜론 뒤의 공백과 특수 문자도 확인해야 합니다. YAML 구문에 맞는다는 것은 파일을 분석할 수 있다는 뜻일 뿐이며, 필드의 유효성이나 정책 이름의 존재 여부는 커널에서 추가로 확인해야 합니다.
proxy-providers
이 설정 필드로 노드 모음을 기본 설정과 분리해 관리하면 커널이 지정된 출처에서 노드 데이터를 불러오거나 업데이트할 수 있습니다. 노드 출처를 참조할 수 있게 해 주며, 보통 정책 그룹에서 use 등의 필드로 참조해야 합니다. 다운로드에 성공했는데 그룹에 노드가 보이지 않는다면 참조 이름, 콘텐츠 형식, 필터 조건을 확인하세요. 노드 모음 파일을 전체 설정처럼 직접 실행해서는 안 됩니다.
rule-providers
이 설정으로 외부 규칙 모음을 선언한 다음 규칙 목록에서 RULE-SET으로 참조하면 긴 도메인 규칙이나 주소 규칙을 분리해 업데이트할 수 있습니다. 선언한 콘텐츠 유형과 형식이 규칙 모음과 일치해야 하며, 참조할 때 유효한 정책도 지정해야 합니다. 규칙 모음 자체가 올바르더라도 참조 위치가 너무 뒤에 있으면 적용되지 않을 수 있으므로 업데이트 로그와 기본 규칙의 적용 순서를 함께 확인하세요.