Clash 용어집
설정 파일을 읽거나 클라이언트 오류를 보거나 고급 매뉴얼을 뒤적이다 보면 반복적으로 마주치는 용어들이 있습니다. 이 표는 28개 핵심 용어를 5가지 카테고리로 정리해 각 항목을 2~4문장으로 무엇인지, 어디에 등장하는지, 인접 개념과의 경계가 무엇인지 설명합니다. 각 용어 카드에는 독립된 앵커가 있어 특정 항목으로 바로 이동하는 링크를 다른 사람에게 전달할 수 있습니다.
참고 방법: 클라이언트 화면의 스위치 이름(TUN, Fake-IP, LAN 허용)이 궁금하면 「DNS와 트래픽 처리」와 「설정 파일 필드」를 먼저 확인하세요. 구독으로 받은 YAML에서 이해되지 않는 항목명은 대부분 「규칙과 정책 그룹」에 있고, 노드 유형 열의 약어는 「프로토콜」에서 찾을 수 있습니다. 개념 외의 구체적인 조작 절차는 사용 가이드를, 필드 단위의 상세 작성법과 실전 예시는 고급 매뉴얼을 참고하세요.
코어와 클라이언트
SECTION 01 · 6 ENTRIES「코어」와 「클라이언트」를 구분하는 것이 Clash 생태계를 이해하는 첫걸음입니다. 코어는 트래픽 처리를 담당하고 클라이언트는 코어를 사람이 쓸 수 있게 해줍니다.
mihomo
코어와 클라이언트Clash Meta 코어의 현재 명칭입니다. 기존 Clash 코어가 업데이트를 멈춘 후 커뮤니티가 개발을 이어가며 그 문법을 기반으로 더 많은 프로토콜과 규칙 유형을 확장했습니다. 현재 주류 GUI 클라이언트(Clash Verge Rev, FlClash, Clash Plus 등)는 기본적으로 이 코어를 사용하며, 튜토리얼에서 말하는 「Meta 코어」 「Meta 문법」이 바로 이것입니다.
GUI 클라이언트
코어와 클라이언트코어 위에 얹힌 그래픽 인터페이스 껍데기로 구독 관리, 시스템 프록시 스위치, 코어 프로세스 관리, 로그 시각화를 담당합니다. 동일한 설정 파일은 서로 다른 GUI 클라이언트 사이에서 대부분 공통으로 사용할 수 있으며 차이는 화면 구성과 부가 기능에 집중됩니다. 선택 비교는 클라이언트 비교 페이지를 참고하세요.
external-controller(외부 제어)
코어와 클라이언트코어가 제공하는 RESTful 제어 인터페이스로 기본적으로 127.0.0.1:9090에서 대기합니다. 웹 패널(metacubexd, yacd 등)이 이를 통해 연결 목록을 읽고 노드를 전환하며 실시간 로그를 확인합니다. 함께 제공되는 secret 필드는 접근 암호를 설정하는 용도이며, 대기 주소를 루프백이 아닌 주소로 바꾸기 전에는 반드시 먼저 설정해야 합니다.
UWP 루프백 예외
코어와 클라이언트Windows의 UWP 앱(Microsoft Store에서 설치한 앱)은 기본적으로 로컬 루프백 주소 접근이 차단되어 시스템 프록시가 켜져 있어도 이런 앱의 트래픽은 로컬 프록시 포트로 들어가지 못합니다. 루프백 예외 도구(EnableLoopback)에서 해당 앱을 체크하거나, 아예 TUN 모드로 네트워크 계층에서 처리하는 방법이 있습니다.
시스템 프록시
코어와 클라이언트OS 수준의 HTTP/SOCKS 프록시 설정입니다. 클라이언트가 이 스위치를 켜면 시스템 설정을 따르는 브라우저 등의 앱이 트래픽을 로컬 대기 포트로 전달합니다. 「앱이 자발적으로 협조하는」 방식이라 시스템 프록시를 읽지 않는 프로그램(일부 명령줄 도구, 게임)은 영향을 받지 않으며, 이런 프로그램까지 처리하려면 TUN 모드가 필요합니다.
프로토콜
SECTION 02 · 6 ENTRIES구독의 각 노드에는 프로토콜이 표시됩니다. 프로토콜은 암호화 방식, 위장 형태, 불안정한 네트워크에서의 성능을 결정합니다. 클라이언트 측에서 수동 설정할 필요는 없지만 유형을 이해하면 연결 안 되는 노드를 점검하는 데 도움이 됩니다.
Shadowsocks
프로토콜경량 암호화 프록시 프로토콜로 구조가 단순하고 전송 오버헤드가 낮아 생태계에서 가장 오래된 프로토콜 중 하나입니다. mihomo는 AEAD 암호화 스위트와 일반적인 플러그인(obfs, v2ray-plugin)을 지원합니다. 노드 목록에서 흔히 SS로 표기됩니다.
VMess
프로토콜V2Ray 생태계의 전송 프로토콜로 사용자 ID 인증과 시간 검증 기능이 있으며 WebSocket, gRPC 등 전송 계층 및 TLS와 함께 자주 사용됩니다. 로컬 시간 오차에 민감해서 시스템 시간이 약 90초 이상 어긋나면 핸드셰이크가 실패할 수 있으므로 노드가 전부 빨갛게 표시될 때는 먼저 시간을 확인해볼 만합니다.
VLESS
프로토콜VMess의 경량화 후속 프로토콜로 프로토콜 자체의 불필요한 암호화 계층을 없애고 전송 보안을 전적으로 TLS에 맡겼습니다. Reality, XTLS 플로우 제어와 함께 사용해 특징을 줄이는 경우가 많습니다. mihomo에서 기본 지원되며 별도 코어가 필요 없습니다.
Trojan
프로토콜표준 HTTPS 트래픽으로 위장하는 프로토콜로 443 포트와 실제 TLS 핸드셰이크를 그대로 재사용해 외부에서 보면 일반 웹사이트 접속과 거의 구분되지 않습니다. 서버 측에 유효한 인증서가 필요하며 클라이언트 측 설정 항목은 매우 적습니다.
Hysteria2
프로토콜QUIC 기반 프로토콜로 손실률이 높은 회선에 맞춰 적극적인 혼잡 제어 최적화를 했고, 국경을 넘는 불안정한 네트워크 환경에서 처리량이 뛰어납니다. 대신 전 과정이 UDP를 사용하므로 해당 네트워크에서 UDP를 제한하거나 차단하면 이런 노드는 눈에 띄게 성능이 떨어지거나 사용이 불가능해집니다.
TUIC
프로토콜역시 QUIC 기반의 경량 프로토콜로 0-RTT 핸드셰이크와 UDP over stream을 지원해 연결 수립이 빠르며 지연에 민감한 환경에서 자주 쓰입니다. Hysteria2와 마찬가지로 UDP 네트워크 품질의 영향을 받으므로 둘을 정책 그룹에서 서로 대체 옵션으로 둘 수 있습니다.
규칙과 정책 그룹
SECTION 03 · 6 ENTRIES규칙은 「이 트래픽이 어디로 가야 하는가」에 답하고, 정책 그룹은 「거기로 갈 때 구체적으로 어느 노드를 쓸 것인가」에 답합니다. 둘이 합쳐져 Clash 분기 처리의 골격이 됩니다.
규칙 분기(Rules)
규칙과 정책 그룹설정 파일 rules 항목의 매칭 목록으로 DOMAIN-SUFFIX, IP-CIDR, GEOIP 등 유형을 위에서부터 순서대로 매칭하며 일치하면 멈춥니다. 규칙 순서가 트래픽 방향을 결정하므로 광범위한 규칙을 정밀한 규칙보다 앞에 두면 후자는 절대 매칭되지 않습니다. 끝에는 보통 MATCH 규칙으로 마무리합니다.
정책 그룹(Proxy Group)
규칙과 정책 그룹여러 노드를 선택 가능한 하나의 단위로 묶은 것입니다. 자주 쓰이는 유형: select(수동 선택), url-test(자동 속도 측정), fallback(장애 시 전환), load-balance(로드 밸런싱). 규칙의 출구는 대개 단일 노드가 아닌 정책 그룹을 가리키므로 노드가 바뀌어도 규칙을 수정할 필요가 없습니다.
url-test
규칙과 정책 그룹자동 속도 측정 정책 그룹으로 interval 주기마다 url로 지정된 주소에 지연 측정을 진행해 항상 가장 낮은 지연의 노드를 선택합니다. tolerance 값으로 전환 임계치를 설정해 지연이 비슷한 노드 사이에서 자주 왔다 갔다 하며 연결이 반복 재구성되는 것을 막습니다.
rule-providers(규칙 세트)
규칙과 정책 그룹규칙을 구독 가능한 원격 파일로 외부화하고 클라이언트가 interval마다 자동으로 가져와 갱신한 뒤 RULE-SET 유형으로 rules 항목에서 참조합니다. 규칙 관리가 메인 설정과 분리되며 커뮤니티에서 관리하는 분기 규칙 저장소 대부분이 이 형태로 배포됩니다. 작성법은 고급 매뉴얼을 참고하세요.
GeoIP / GeoSite
규칙과 정책 그룹미리 컴파일된 IP 소속과 도메인 분류 데이터베이스입니다. GEOIP,CN은 중국 본토 IP 대역을 매칭하고, GEOSITE,category-ads-all은 광고 도메인 집합을 매칭합니다. 데이터베이스 파일은 코어와 독립적으로 존재해 개별 업데이트할 수 있으며, 데이터가 오래되면 일부 사이트에서 분기가 부정확해질 수 있습니다.
DIRECT / REJECT
규칙과 정책 그룹코어에 내장된 두 특수 정책으로 설정에서 별도로 선언할 필요가 없습니다. DIRECT는 프록시를 거치지 않고 목표에 직접 연결함을 의미하고, REJECT는 해당 연결을 즉시 거부함을 의미하며 광고와 원격 측정 도메인 차단에 자주 사용됩니다. 필요한 도메인을 REJECT 처리하면 특정 기능이 「로딩만 계속되고 열리지 않는」 증상으로 나타날 수 있으니 점검 시 유의할 부분입니다.
DNS와 트래픽 처리
SECTION 04 · 5 ENTRIES분기 정확도와 프라이버시 경계는 대부분 DNS 단계에서 결정됩니다. 이 카테고리의 용어들은 트래픽이 규칙 매칭에 들어가기 전에 무슨 일이 일어나는지 설명합니다.
Fake-IP
DNS와 트래픽 처리DNS 강화 모드 중 하나로, 응답이 예약 대역의 가상 IP(기본값 198.18.0.0/16)를 바로 반환하고 실제 해석은 아웃바운드 노드 단계로 미룹니다. 로컬 해석 대기를 줄이고 오염된 해석이 분기 판단에 영향을 주지 않는 장점이 있지만, 실제 IP에 의존하는 LAN 프로그램(프린터 검색, LAN 게임)은 fake-ip-filter로 제외해야 합니다.
Redir-Host
DNS와 트래픽 처리Fake-IP와 대비되는 전통적인 방식으로 DNS가 실제 해석 결과를 정상적으로 반환한 뒤 코어가 해석된 IP로 규칙을 매칭합니다. 동작이 직관적이고 호환성이 좋지만 해석 결과가 오염되면 분기도 함께 틀어집니다. mihomo 최신 버전에서는 이 모드가 약화되었으며 일반적으로는 Fake-IP를 권장합니다.
DNS 누출
DNS와 트래픽 처리프록시가 켜져 있음에도 도메인 해석 요청이 여전히 로컬 통신사 DNS로 직접 나가 접속 의도가 드러나는 현상입니다. 방지법: 코어 DNS를 활성화하고 nameserver에 암호화된 업스트림(DoH/DoT)을 설정하거나, TUN 모드로 53 포트 트래픽까지 함께 인수합니다. 누출 여부는 온라인 진단 사이트로 확인할 수 있습니다.
TUN 모드
DNS와 트래픽 처리코어가 가상 네트워크 카드를 만들어 네트워크 계층에서 본 기기의 모든 트래픽을 인수하며, 앱이 시스템 프록시 설정을 읽는지 여부에 의존하지 않습니다. 명령줄 도구, 게임, UWP 앱까지 커버할 수 있으며 관리자 또는 root 권한이 필요합니다. 보통 Fake-IP, auto-route와 함께 사용됩니다. 처음 활성화할 때 각 플랫폼에서 필요한 권한 부여 절차는 사용 가이드를 참고하세요.
도메인 스니핑(sniffer)
DNS와 트래픽 처리TLS 핸드셰이크의 SNI 필드나 HTTP Host 헤더에서 목적지 도메인을 복원해 순수 IP 형태로 들어오는 트래픽(대표적으로 TUN에서 코어 DNS를 거치지 않은 연결)도 도메인 규칙에 매칭될 수 있게 합니다. 활성화하면 분기 정확도가 눈에 띄게 좋아지지만 약간의 해석 오버헤드가 발생합니다.
설정 파일 필드
SECTION 05 · 5 ENTRIES구독으로 받은 설정 파일을 열면 첫 십여 줄이 바로 이런 필드들입니다. 이를 이해하면 「값 하나만 바꾸면 해결되는」 문제 대부분을 남에게 묻지 않고 해결할 수 있습니다.
YAML
설정 파일 필드Clash 설정 파일의 작성 형식으로 들여쓰기로 계층을 표현하며 들여쓰기에는 공백만 사용할 수 있습니다. 웹에서 설정을 복사할 때 탭 문자가 섞이거나 목록 항목의 들여쓰기가 어긋나는 것이 「설정 파싱 실패」 오류의 가장 흔한 원인입니다. 설정을 수정하기 전에는 YAML 문법 검사를 지원하는 편집기로 열어보는 것을 권장합니다.
구독(subscription)
설정 파일 필드서비스 제공자가 제공하는 호스팅 설정 주소로, 클라이언트가 주기적으로 가져와 노드와 규칙 업데이트를 받을 수 있으며 본질적으로는 전체 또는 일부 Clash 설정을 반환하는 URL입니다. 구독 링크는 계정 자격 증명과 동등하므로 공개적으로 게시하지 않아야 합니다. 업데이트 실패 시 점검 방법은 블로그 관련 글과 자주 묻는 질문을 참고하세요.
proxy-providers
설정 파일 필드노드를 외부화한 필드로 하나 이상의 원격 주소에서 노드 목록을 가져와 interval 주기로 갱신한 뒤 use로 정책 그룹에 참조합니다. rule-providers와 같은 방식으로, 여러 구독을 합쳐 하나의 자체 관리 설정으로 통합하는 표준적인 방법입니다.
mixed-port
설정 파일 필드혼합 대기 포트로 동일한 포트에서 HTTP와 SOCKS5 프록시 요청을 모두 받을 수 있어 시스템 프록시와 서드파티 소프트웨어가 모두 이 포트만 가리키면 됩니다. 흔한 기본값은 7890 또는 7897이며, 시작 시 포트 사용 중 오류가 나면 이 값을 바꾸거나 점유 중인 프로세스를 종료하세요.
allow-lan
설정 파일 필드LAN 내 다른 기기가 본 기기의 프록시 포트에 접속할 수 있는지를 제어합니다. 활성화하면 휴대폰, TV, 게임기가 프록시 서버를 이 컴퓨터의 내부 IP로 지정해 같은 분기 설정을 공유할 수 있습니다. 카페, 공항 등 공용 네트워크에서는 꺼두어 낯선 기기가 포트를 사용하는 것을 막는 것이 좋습니다.
용어집은 「이것이 무엇인가」를 해결합니다. 「어떻게 설정하는가」를 해결하려면 필요에 따라 두 갈래로 나아가세요. 클라이언트를 처음 설치하고 구독을 가져올 때는 사용 가이드를 순서대로 따라 해보고, 사용자 정의 규칙 작성이나 DNS 조정, 여러 구독 통합에 관심이 있다면 바로 고급 매뉴얼에서 필요한 장을 찾아보세요. 아직 클라이언트가 없다면 클라이언트 다운로드 페이지에서 플랫폼에 맞는 설치 파일을 받으세요.