Clash 용어 사전
튜토리얼을 읽거나 설정 파일을 수정할 때 낯선 용어를 만나면 이 페이지에서 분류별로 빠르게 찾아볼 수 있습니다. 모든 항목은 프록시 프로토콜, 코어와 클라이언트, 규칙과 분기, 네트워크와 DNS, 설정 파일 필드 다섯 방향으로 정리했으며, 각 항목마다 두세 문장의 바로 활용 가능한 설명과 mihomo 코어 지원 여부를 함께 표기했습니다.
프록시 프로토콜
노드 항목의 type 필드에 대응하는 전송 프로토콜입니다. 프로토콜이 트래픽 암호화와 위장 방식을 결정하며 코어 지원 범위와 직접 연관됩니다.
Shadowsocks 프록시 프로토콜
일찍부터 널리 사용된 암호화 프록시 프로토콜로 대칭키 암호화를 이용해 클라이언트와 서버 간 SOCKS5 트래픽을 전송합니다. 경량화와 낮은 오버헤드를 목표로 설정 필드가 적고 크로스 플랫폼 구현이 성숙했습니다. Clash 설정에서는 프로토콜 유형을 ss로 표기하며, 요즘은 대체로 AEAD 계열 암호화 방식과 함께 사용됩니다.
VMess 프록시 프로토콜
V2Ray 프로젝트에서 설계한 전송 프로토콜로 UUID를 통해 인증하며, 클라이언트와 서버 간 시간이 대략 동기화되어 있어야 합니다. WebSocket과 TLS 조합 등 다양한 위장 및 전송 계층 조합을 지원합니다. mihomo 코어가 기본 지원하며 설정 유형은 vmess로 표기합니다.
VLESS 프록시 프로토콜
VMess의 경량화 후속 프로토콜로 내장 암호화 계층을 제거하고 암호화를 전적으로 TLS 전송 계층에 맡겨 핸드셰이크 오버헤드가 더 낮습니다. XTLS, REALITY 등 전송 방식과 함께 배포되는 경우가 많습니다. 레거시 Clash 코어는 이 유형을 지원하지 않으므로 mihomo 코어를 사용해야 해석할 수 있습니다.
Trojan 프록시 프로토콜
프록시 트래픽을 표준 HTTPS 접속처럼 위장하는 프로토콜로 실제 TLS 인증서로 핸드셰이크를 완료하며, 트래픽 특성이 일반 웹사이트 접속과 비슷합니다. 설정에는 서버 주소, 포트, 비밀번호 세 가지만 필요해 필드가 간단합니다. 유형은 trojan으로 표기하며 주요 클라이언트와 코어가 모두 지원합니다.
Hysteria2 프록시 프로토콜
QUIC(UDP) 기반 고속 전송 프로토콜로 자체 혼잡 제어를 통해 손실률이 높은 회선에서도 처리량을 유지합니다. 해저 케이블처럼 지연이 큰 구간이나 불안정한 네트워크 환경에 적합합니다. mihomo 확장 프로토콜에 속해 레거시 코어에서는 사용할 수 없으며 설정 유형은 hysteria2로 표기합니다.
코어와 클라이언트
코어는 트래픽 전달과 규칙 매칭을 담당하고 클라이언트는 그래픽 상호작용과 구독 관리를 담당합니다. 두 계층의 관계를 구분하면 선택과 문제 해결이 훨씬 명확해집니다.
mihomo 코어와 클라이언트
Clash Meta 프로젝트가 이어서 유지·관리하는 Clash 생태계의 현재 사실상 표준 코어입니다. 레거시 코어와 비교해 VLESS, Hysteria2 등 프로토콜 지원, 더 많은 규칙 유형, 더 완성도 높은 DNS 기능을 추가했습니다. Clash Plus, Clash Verge Rev, FlClash 등 주요 클라이언트가 모두 이 코어를 내장하고 있습니다.
레거시 Clash 코어 코어와 클라이언트
초기 clash 오픈소스 코어와 비공개 소스 강화판 Premium을 가리키며, 관련 저장소는 아카이브되어 업데이트가 중단되었습니다. 기존 설정 파일 대부분은 mihomo가 그대로 호환해 읽을 수 있어 마이그레이션 비용이 낮습니다. 클라이언트를 고를 때는 반드시 코어가 mihomo인지 확인해 새 프로토콜을 못 쓰는 상황을 피해야 합니다.
GUI 클라이언트 코어와 클라이언트
코어 위에 그래픽 인터페이스를 씌운 데스크톱 또는 모바일 앱으로 구독 관리, 노드 전환, 시스템 프록시 스위치, TUN 모드 등 조작 진입점을 제공합니다. 트래픽 전달은 코어가 처리하고 사람과의 상호작용은 클라이언트가 처리하는, 감싸는 관계이지 대체 관계가 아닙니다. 같은 설정 파일을 여러 클라이언트에서 공통으로 사용할 수 있습니다.
구독 코어와 클라이언트
구독형 서비스나 자체 구축 서버가 제공하는 URL로, 접속하면 전체 노드 정보를 담은 설정 내용을 반환합니다. 클라이언트가 이 주소를 주기적으로 가져오면 노드 변경 사항이 자동으로 동기화되어 서버 파라미터를 하나씩 수동으로 입력할 필요가 없습니다. 구독 주소는 계정 자격증명과 같으므로 공개적으로 공유해서는 안 됩니다.
구독 변환 코어와 클라이언트
한 형식의 노드 구독을 Clash YAML 설정으로 변환하는 서비스나 도구로, 대표적인 구현체는 subconverter입니다. 구독 소스가 다른 클라이언트 형식만 제공할 때 변환 인터페이스를 통해 규칙 템플릿이 포함된 완전한 설정을 생성할 수 있습니다. 공용 변환 서비스는 구독 내용을 경유하므로 민감한 상황에서는 자체 구축 인스턴스를 권장합니다.
규칙과 분기
Clash와 일반 프록시 도구의 핵심 차이가 바로 여기에 있습니다. 각 연결이 어떤 조건에 따라 어느 출구로 나가는지는 전부 이 계층에서 결정됩니다.
규칙 분기 규칙과 분기
Clash의 핵심 동작 방식으로, 도메인, IP, 프로세스 등 조건에 따라 각 연결을 서로 다른 출구 정책으로 매칭합니다. 규칙은 위에서 아래로 순서대로 매칭되며 일치하면 즉시 멈춥니다. 설정의 rules 목록에 쓰인 순서가 최종 분기 결과를 직접 결정하므로 분기 이상을 조사할 때는 순서부터 살펴봐야 합니다.
정책 그룹 규칙과 분기
여러 노드나 다른 정책 그룹을 하나의 선택 가능한 그룹으로 묶는 것으로, 유형에는 수동 선택 select, 자동 속도 측정 url-test, 장애 조치 fallback, 부하 분산 load-balance 등이 있습니다. 규칙의 출구는 보통 개별 노드가 아니라 정책 그룹을 가리키므로 노드를 바꿀 때는 그룹 안에서 전환만 하면 됩니다.
규칙 세트 규칙과 분기
rule-providers 필드로 참조하는 외부 규칙 파일로, HTTP 구독과 로컬 경로를 지원하며 interval 주기에 따라 자동으로 업데이트됩니다. 방대한 규칙을 메인 설정에서 분리한 뒤 메인 설정에서는 RULE-SET 한 줄로 참조하면 유지 비용이 크게 줄어듭니다.
GeoIP 규칙과 분기
IP 소재지 데이터베이스로 연결 목적지가 속한 국가나 지역을 매칭하는 규칙 유형으로, 전형적인 표기는 GEOIP,CN,DIRECT입니다. 목적지 IP를 얻은 뒤에 매칭이 이루어지며 보통 규칙 목록 뒤쪽에 배치해 기본값 처리에 사용합니다. 데이터베이스 파일은 코어가 자동으로 내려받으며 업데이트 주소를 설정에서 지정할 수 있습니다.
GEOSITE 규칙과 분기
미리 컴파일된 도메인 분류 라이브러리로 매칭하는 규칙 유형으로, 데이터 소스는 커뮤니티가 관리하는 도메인 분류 프로젝트에서 나옵니다. GEOSITE 규칙 하나로 특정 분류에 속한 수백~수천 개 도메인을 커버할 수 있어 규칙 목록을 크게 줄여줍니다. mihomo의 확장 기능이며 레거시 코어는 지원하지 않습니다.
네트워크와 DNS
트래픽이 어떻게 인수되고 도메인이 어떻게 해석되는지가 대부분의 골치 아픈 문제의 근원입니다. 이 그룹의 개념은 문제 해결 과정에서 가장 자주 등장합니다.
노드 네트워크와 DNS
설정 파일 proxies 목록에 있는 프록시 서버 항목으로 프로토콜 유형, 주소, 포트, 인증 정보를 포함합니다. 클라이언트 화면에서 선택할 수 있는 서버 한 줄이 곧 노드 하나에 대응합니다. 노드 품질은 물리적 경로와 서버 자체가 결정하며 클라이언트 소프트웨어 자체와는 무관합니다.
지연 테스트 네트워크와 DNS
클라이언트가 지정된 테스트 URL로 탐지 요청을 보내 소요 시간을 측정하고, 결과를 노드 옆에 밀리초 단위로 표시합니다. 이 값은 한 번의 HTTP 핸드셰이크 왕복 시간을 나타내며 노드 간 상대 비교용일 뿐 실제 다운로드 속도와는 다릅니다. url-test 정책 그룹은 이 결과를 바탕으로 현재 최적 노드를 자동 선택합니다.
DNS 유출 네트워크와 DNS
프록시를 켠 상태에서도 도메인 해석 요청이 로컬 통신사 DNS로 직접 전송되어 접속 의도가 노출되는 현상입니다. 흔한 원인은 시스템 프록시 모드에서 UDP 53번 포트의 해석 트래픽이 인수되지 않는 것입니다. Clash 내장 DNS를 켜고 TUN이나 Fake-IP 모드와 함께 사용하면 방지할 수 있습니다.
Fake-IP 네트워크와 DNS
Clash 내장 DNS의 응답 방식 중 하나로, 도메인 조회에 즉시 예약 대역 안의 가상 IP로 응답하고 실제 해석은 연결이 수립될 때로 미룹니다. 상위 DNS 응답을 기다리는 시간을 없애고 해석 결과가 오염될 여지도 막아줍니다. 실제 IP에 의존하는 일부 프로그램은 fake-ip-filter로 제외해야 합니다.
TUN 모드 네트워크와 DNS
가상 네트워크 카드를 만들어 네트워크 계층에서 시스템 전체 트래픽을 인수하는 방식으로, 애플리케이션이 프록시 설정을 자발적으로 따르는지에 의존하지 않습니다. 커맨드라인 도구, 게임, UDP 트래픽도 모두 분기 대상에 포함됩니다. 사용하려면 관리자 또는 root 권한이 필요하며 설정 필드는 tun.enable입니다.
시스템 프록시 네트워크와 DNS
운영체제 네트워크 설정에 HTTP/SOCKS 프록시 주소를 등록해 애플리케이션이 스스로 읽고 따르게 하는 전통적인 인수 방식입니다. 구현이 간단하고 특별한 권한이 필요 없지만, 이 설정을 따르지 않는 프로그램은 프록시를 그대로 우회합니다. TUN 모드와 상호 보완적이므로 사용 상황에 맞게 선택하면 됩니다.
도메인 스니핑 네트워크와 DNS
지나가는 TLS, HTTP 트래픽에서 SNI나 Host 안의 실제 도메인을 해석해 IP가 아닌 도메인으로 규칙 매칭에 참여시키는 기능입니다. Fake-IP나 순수 IP 연결 상황에서 도메인 규칙이 어긋나는 문제를 보완할 수 있습니다. mihomo에서는 sniffer.enable로 활성화합니다.
설정 파일 필드
config.yaml에서 가장 자주 나오는 최상위 필드 몇 가지입니다. 값의 의미를 이해하면 대부분의 구독 설정을 읽어낼 수 있습니다.
YAML 설정 파일 필드
Clash 설정 파일이 채택한 텍스트 형식으로 들여쓰기로 계층을 표현하며, 콜론 뒤에는 반드시 공백이 필요합니다. 들여쓰기는 공백만 사용해야 하며 탭 문자가 섞이면 곧바로 해석 오류가 발생합니다. 설정을 수정한 뒤 오류가 나면 먼저 들여쓰기 단계와 콜론 서식이 규정에 맞는지 확인하세요.
mixed-port 설정 파일 필드
하나의 포트에서 HTTP와 SOCKS5 두 프록시 프로토콜을 동시에 수신하는 필드로 기본값은 보통 7890입니다. 브라우저 확장 프로그램과 커맨드라인 도구가 이 포트 하나를 함께 쓸 수 있어 따로 지정할 필요가 없습니다. 같은 네트워크에서 프록시를 공유할 때 다른 기기도 이 포트 번호를 입력하게 됩니다.
allow-lan 설정 파일 필드
같은 네트워크의 다른 기기가 본 기기의 프록시 포트에 연결하도록 허용할지 정하는 스위치입니다. true로 설정하면 같은 네트워크의 휴대폰, TV 셋톱박스가 이 컴퓨터를 프록시로 지정할 수 있습니다. 켤 때는 시스템 방화벽에서 해당 포트를 허용하고 필요하면 authentication 필드로 접속 인증을 추가해야 합니다.
mode 설정 파일 필드
트래픽 처리 정책을 결정하는 전역 필드로, rule은 규칙에 따라 분기, global은 전부 프록시로, direct는 전부 직접 연결을 뜻합니다. 일상 사용에는 rule 유지를 권장합니다. 클라이언트 화면의 모드 전환 버튼이 바로 이 필드를 바꾸는 것입니다.
proxy-providers 설정 파일 필드
구독 방식으로 노드 집합을 불러오는 필드로 여러 소스를 설정하고 주기적으로 자동 업데이트할 수 있으며, 직접 작성한 proxies 목록과 함께 존재할 수 있습니다. 정책 그룹의 use 참조 방식과 결합하면 여러 구독을 통합 관리하고 하나로 그룹화할 수 있습니다.
external-controller 설정 파일 필드
코어가 외부에 RESTful 제어 인터페이스를 노출하는 수신 주소 필드로, 흔히 쓰는 값은 127.0.0.1:9090입니다. 웹 제어판이 이 인터페이스를 통해 연결 목록을 읽고 노드를 전환하며 로그를 확인합니다. 로컬이 아닌 주소에서 수신하는 경우 반드시 secret 접근 키도 함께 설정해야 합니다.
개념을 실제 설정에 적용하기
용어는 색인일 뿐이며 직접 손으로 해봐야 제대로 익힐 수 있습니다. 아래 두 페이지가 이 페이지의 개념을 서로 다른 깊이로 실제 사용법과 연결해 줍니다.
처음 사용한다면 먼저 설치 및 구독 가져오기 가이드를 보고 단계별로 클라이언트 설정을 완료하세요. DNS 최적화, 정책 그룹 설계, 규칙 세트 관리를 깊이 다뤄야 한다면 심화 설정 가이드를 참고하고, 아직 클라이언트를 설치하지 않았다면 클라이언트 다운로드 페이지에서 플랫폼을 선택하세요.