GLOSSARY

Clash 용어집

29개 자주 쓰는 용어를 다섯 개 분류로 정리했습니다. 구독, 규칙 라우팅, TUN 모드, Fake-IP 같은 용어는 설정 화면에서 반복해서 등장합니다. 이 페이지에서는 각 용어의 정의와 사용 상황을 하나씩 설명하며, 입문 가이드와 전체 문서와 함께 참고하면 좋습니다.

커널 및 프로토콜

6개

mihomo

커널 및 프로토콜

Clash 생태계에서 현재 주력으로 쓰이는 커널로, Clash.Meta 프로젝트를 계승해 발전했습니다. 설정 해석, 규칙 매칭, 트래픽 전달을 담당하며 Clash Verge Rev, FlClash 등 주요 클라이언트에 기본 내장되어 있습니다. 지원하는 프로토콜과 규칙 유형이 원본 Clash 커널보다 더 폭넓습니다.

Clash 커널(원본)

커널 및 프로토콜

프로젝트가 처음 공개했던 오픈소스 코어로, 설정 파일 형식을 정의했습니다. 2023년 저장소가 아카이브된 뒤로는 업데이트가 멈췄고 현재 생태계는 mihomo가 이어받아 관리하고 있지만, 'Clash 설정'이라는 형식 명칭은 지금도 그대로 쓰입니다. 옛 클라이언트가 여전히 원본 커널을 탑재하고 있다면 새 프로토콜은 사용할 수 없습니다.

Shadowsocks

커널 및 프로토콜

설정 항목이 적고 연결 오버헤드가 낮은 경량 암호화 프록시 프로토콜입니다. Clash 설정 파일의 proxies 섹션에서 type: ss로 선언하며, 흔히 쓰는 암호화 방식은 aes-128-gcmchacha20-ietf-poly1305입니다.

VMess

커널 및 프로토콜

V2Ray 프로젝트가 정의한 전송 프로토콜로, UUID 인증에 의존하며 WebSocket, gRPC 등 여러 전송 계층을 지원합니다. 설정 필드가 비교적 많아 보통 구독으로 바로 내려받아 쓰며 직접 작성할 필요가 없습니다. UUID를 잘못 입력하거나 시간 오차가 크면 핸드셰이크가 실패합니다.

Trojan

커널 및 프로토콜

TLS 트래픽처럼 보이도록 만든 프록시 프로토콜로, 보통 443 포트를 사용하며 핸드셰이크 특징이 일반 HTTPS 접속과 비슷합니다. 서버 측에 유효한 인증서가 필요하며, 클라이언트는 비밀번호와 SNI만 입력하면 연결을 맺을 수 있습니다.

Hysteria2

커널 및 프로토콜

QUIC 기반 프록시 프로토콜로, 손실률이 높은 회선에 최적화되어 있어 열악한 네트워크 환경에서 TCP 계열 프로토콜보다 처리량이 좋습니다. 원본 Clash 커널은 지원하지 않으며, 설정에 type: hysteria2로 표시된 노드는 mihomo 커널이 있어야 불러올 수 있습니다.

설정 파일 및 규칙

6개

설정 파일(config.yaml)

설정 파일 및 규칙

Clash 실행의 유일한 기준이 되는 파일로, 포트, DNS, 노드, 정책 그룹, 규칙 다섯 섹션으로 구성됩니다. 클라이언트 화면의 대부분 스위치는 사실 이 파일의 필드를 읽고 쓰는 것입니다. 문제를 파악할 때는 먼저 지금 어떤 설정 파일이 로드되어 있는지 확인하세요.

YAML

설정 파일 및 규칙

설정 파일이 사용하는 텍스트 형식으로, 들여쓰기로 계층을 표현합니다. 들여쓰기는 반드시 공백을 써야 하고 콜론 뒤에는 공백 하나를 남겨야 합니다. 수동으로 편집할 때 들여쓰기나 기호를 잘못 쓰면 설정 전체를 불러오지 못하며, 클라이언트 로그에 보통 오류가 발생한 줄 번호가 표시됩니다.

구독(Subscription)

설정 파일 및 규칙

서비스 제공자가 발급하는 URL 하나로, 접속하면 완전한 Clash 설정이나 노드 목록이 반환됩니다. 클라이언트는 일정한 간격으로 업데이트를 가져오므로 노드가 추가되거나 삭제돼도 파일을 직접 고칠 필요가 없습니다. 구독이 만료되거나 초기화되면 같은 주소에서 빈 내용이나 오류가 반환됩니다.

구독 변환

설정 파일 및 규칙

V2Ray, Sing-box 공유 링크 등 다른 형식의 노드 목록을 Clash 설정으로 바꾸는 과정입니다. 온라인 변환 서비스나 클라이언트 내장 기능으로 처리할 수 있으며, 변환할 때 보통 규칙 템플릿과 정책 그룹 구조도 함께 삽입됩니다.

규칙(Rule)

설정 파일 및 규칙

rules 섹션의 한 줄짜리 매칭 문장으로, 형식은 '유형,매칭값,정책'입니다. 예를 들면 DOMAIN-SUFFIX,github.com,노드 선택입니다. 커널은 위에서 아래로 순서대로 매칭하며 일치하는 순간 멈추므로 규칙 순서가 라우팅 결과에 직접 영향을 줍니다.

규칙 세트(rule-providers)

설정 파일 및 규칙

방대한 규칙을 별도 파일로 분리해 URL을 통해 주기적으로 업데이트하는 방식입니다. 설정에서는 RULE-SET,이름,정책 형태로 참조하며, 수만 개에 달하는 도메인 라우팅 목록을 관리할 때 주로 쓰이고 규칙을 갱신할 때 메인 설정을 건드릴 필요가 없습니다.

정책 그룹 및 라우팅

6개

정책 그룹(Proxy Group)

정책 그룹 및 라우팅

여러 노드나 다른 정책 그룹을 규칙이 참조할 수 있는 하나의 집합으로 묶은 것입니다. 규칙은 특정 노드를 직접 가리키지 않고 정책 그룹을 가리키므로, 노드를 추가하거나 삭제해도 그룹 구성원만 바뀔 뿐 규칙 자체는 그대로 유지됩니다.

select 수동 선택

정책 그룹 및 라우팅

가장 기본적인 정책 그룹 유형으로, 구성원을 클라이언트 화면에서 사용자가 직접 전환합니다. 흔히 '노드 선택'이라는 대표 진입점으로 쓰이며 url-test 같은 자동 그룹을 그 안에 포함시켜 두고, 필요할 때 언제든 수동으로 제어권을 가져올 수 있습니다.

url-test 자동 속도 측정

정책 그룹 및 라우팅

interval 주기마다 url에 지정된 주소로 테스트를 보내 지연이 가장 낮은 노드를 자동으로 선택합니다. tolerance 값으로 전환 임계치를 정해, 지연 차이가 크지 않은 노드끼리 계속 왔다갔다 바뀌는 것을 막습니다.

fallback 장애 조치

정책 그룹 및 라우팅

구성원 순서대로 하나씩 가용성을 테스트해, 목록에서 처음으로 사용 가능한 노드를 계속 사용합니다. '기본은 고정 노드, 장애 시 자동 대체'가 필요한 상황에 알맞으며, 최적을 고르는 url-test와 달리 가장 빠른 노드가 아니라 사용 가능 여부만 신경 씁니다.

load-balance 로드 밸런싱

정책 그룹 및 라우팅

연결을 그룹 내 여러 노드로 분산시킵니다. strategyconsistent-hashing(같은 사이트는 항상 같은 노드로 연결)이나 round-robin(순차 배분) 중에서 고를 수 있으며, 특정 노드에 연결이 몰리는 것을 완화하는 데 씁니다.

MATCH 기본 규칙

정책 그룹 및 라우팅

rules 섹션의 마지막 줄로, 앞의 규칙에 걸리지 않은 모든 트래픽을 처리합니다. 이 규칙이 없으면 매칭되지 않은 트래픽은 커널 기본 동작을 따릅니다. 라우팅이 얼마나 빈틈없는지는 이 규칙이 어떤 정책을 가리키는지에 크게 좌우됩니다.

네트워크 및 DNS

6개

시스템 프록시

네트워크 및 DNS

클라이언트가 운영체제에 HTTP/SOCKS 프록시 주소(예: 127.0.0.1:7890)를 등록하면, 시스템 설정을 따르는 브라우저 등 앱이 자동으로 프록시를 거칩니다. 이 설정을 읽지 않는 프로그램(일부 커맨드라인 도구, 게임)은 영향을 받지 않습니다.

TUN 모드

네트워크 및 DNS

가상 네트워크 카드를 만들어 시스템의 모든 트래픽을 넘겨받으며, 앱이 시스템 프록시 설정을 읽는지와 무관하게 동작해 시스템 프록시보다 적용 범위가 넓습니다. 켤 때 관리자 권한이나 시스템 확장 승인이 필요하고, 트래픽 순환을 막기 위해 시스템 프록시는 꺼두어야 합니다.

혼합 포트(mixed-port)

네트워크 및 DNS

같은 포트에서 HTTP와 SOCKS5 두 가지 프록시 요청을 동시에 받는 방식으로, 대부분의 클라이언트가 기본값으로 7890을 씁니다. 앱은 이 포트 하나만 가리키면 되고 프로토콜을 구분할 필요가 없으며, 다른 프로그램이 이 포트를 점유하고 있으면 커널 실행이 실패합니다.

Fake-IP

네트워크 및 DNS

DNS 응답 전략 중 하나로, 커널이 도메인 조회에 즉시 예약된 대역의 가짜 IP(198.18.0.0/16)를 돌려주고, 실제 해석은 연결이 맺어지는 순간으로 미룹니다. 해석을 기다리는 시간을 줄여주며, 실제 IP가 필요한 일부 프로그램은 fake-ip-filter에 예외로 등록해야 합니다.

DNS 유출

네트워크 및 DNS

프록시를 켠 뒤에도 도메인 해석 요청이 여전히 로컬 통신사 DNS로 직접 전달되는 현상입니다. 해석 기록에 접속 대상이 그대로 노출되며, 커널의 DNS 모듈을 켜거나 TUN 모드로 바꿔 해석도 프록시 경로를 거치게 하는 것이 흔한 해결 방법입니다.

GeoIP

네트워크 및 DNS

IP 소속 지역 데이터베이스로 트래픽을 매칭하는 규칙 유형으로, 가장 흔한 표기는 GEOIP,CN,DIRECT, 즉 중국 본토 IP는 직접 연결입니다. 데이터베이스는 커널이나 클라이언트와 함께 업데이트되며, 오래 갱신하지 않으면 지역 판정이 어긋나 라우팅이 부정확해집니다.

클라이언트 및 플랫폼

5개

Clash Verge Rev

클라이언트 및 플랫폼

Tauri 기반 오픈소스 데스크톱 클라이언트로, Windows, macOS, Linux를 지원하며 mihomo 커널을 내장하고 있습니다. TUN 모드, 구독 관리, 스크립트 확장을 지원하며, 기존 Clash Verge가 업데이트를 멈춘 뒤 커뮤니티가 이어가는 버전입니다.

Clash Plus

클라이언트 및 플랫폼

Windows, macOS, Android, iOS를 지원하는 멀티 플랫폼 클라이언트로, iOS 버전은 App Store를 통해 배포됩니다. 인터페이스가 시스템 고유 스타일에 가깝고 구독 가져오기와 규칙 전환 경로가 짧아 Clash를 처음 접하는 사용자에게 알맞습니다.

네트워크 확장(Network Extension)

클라이언트 및 플랫폼

macOS와 iOS가 제공하는 시스템 수준 네트워크 접수 프레임워크입니다. 클라이언트가 TUN이나 VPN 형태를 켤 때는 시스템 팝업을 통해 확장 설치 승인을 받아야 합니다. 잘못 눌러 거부하면 기능을 쓸 수 없으며, 시스템 설정의 네트워크나 로그인 항목에서 다시 허용할 수 있습니다.

VpnService

클라이언트 및 플랫폼

Android가 제공하는 VPN 프레임워크로, Clash 계열 클라이언트는 이를 이용해 가상 네트워크 카드를 만들어 전체 트래픽을 접수합니다. 처음 실행할 때 시스템 VPN 연결 요청 팝업이 뜨며, 같은 시점에는 하나의 앱만 이 통로를 점유할 수 있습니다.

외부 제어(external-controller)

클라이언트 및 플랫폼

커널이 열어두는 로컬 HTTP 인터페이스로 기본값은 127.0.0.1:9090입니다. 클라이언트 패널이나 웹 대시보드(metacubexd 등)가 이를 통해 연결 목록을 읽고 노드를 전환하고 로그를 확인하며, 설정에서 접근 키를 지정할 수 있습니다.

용어는 '이게 뭔지'만 알려줍니다. '어떻게 설치하고 설정하는지'는 입문 가이드의 3단계 흐름을, 각 플랫폼의 전체 설치와 문제 해결은 전체 문서를 참고하세요.