설정 참고 자료

Clash 용어집

클라이언트는 앱을 조작하고 커널은 연결을 처리합니다. 프로토콜, 규칙, DNS는 각각 서로 다른 역할을 합니다.

이 페이지에서는 설정에 관련된 다섯 가지 영역을 기준으로 25개 용어를 정리했습니다. 각 항목에서 개념의 의미와 활용 범위, 헷갈리기 쉬운 점을 확인할 수 있습니다. 설정에 나온 키워드를 먼저 찾은 다음 해당 항목을 참고해 구체적인 설정을 확인하세요. 클라이언트마다 인터페이스 이름과 지원 기능은 다를 수 있습니다.

연결을 단계별로 설정하려면 Clash 사용 가이드를 확인하세요. 플랫폼 권한과 설치, TUN 설정은 전체 플랫폼 안내에서 살펴볼 수 있습니다. 아래 용어 제목에는 각각 앵커가 있어 주소를 공유하면 해당 항목으로 바로 이동합니다.

커널과 클라이언트

먼저 인터페이스와 실행 프로그램, 시스템 프록시를 구분한 뒤 설정을 어디서 바꿀지 확인하세요.

Clash

Clash

Clash는 처음에는 규칙 기반 프록시 커널을 가리켰으며, 현재는 그 설정 형식을 중심으로 형성된 클라이언트 생태계까지 의미하는 경우가 많습니다. 클라이언트마다 커널, 프로토콜 지원, 유지 관리 상태가 다를 수 있으므로 이름만 보고 기능을 판단해서는 안 됩니다. 가이드를 참고할 때는 클라이언트 이름과 실제로 실행 중인 커널을 함께 확인하세요.

mihomo / Clash Meta

mihomo

mihomo는 Clash Meta에서 발전한 오픈 소스 프록시 커널로, 연결 처리와 규칙 매칭, DNS 등의 작업을 담당합니다. 특정 데스크톱 인터페이스를 뜻하는 이름이 아니며, 같은 커널을 여러 클라이언트에 통합할 수 있습니다. 설정 항목의 지원 여부는 실제 실행 중인 커널 버전과 문서를 기준으로 확인하세요.

Client / GUI

클라이언트

클라이언트는 일반적으로 그래픽 인터페이스를 갖춘 앱으로, 구독 관리, 정책 선택, 로그 표시, 시스템 설정을 담당합니다. 인터페이스에 표시된 토글이 커널의 모든 기능을 의미하지는 않으며, 일부 설정은 설정 파일이나 오버라이드 기능을 통해 적용해야 합니다. 클라이언트 업데이트와 내장 커널 업데이트가 항상 함께 진행되는 것도 아닙니다.

Proxy core

프록시 커널

프록시 커널은 실제로 연결을 수신하고 설정을 실행하는 프로그램이며, 그래픽 클라이언트는 보통 제어 인터페이스를 통해 커널과 통신합니다. 구독을 성공적으로 가져왔더라도 클라이언트가 설정을 받았다는 뜻일 뿐, 커널이 정상적으로 불러왔다는 의미는 아닙니다. 실행에 실패하면 인터페이스의 연결 버튼만 확인하지 말고 설정 파싱 및 포트 수신 로그를 살펴보세요.

System proxy

시스템 프록시

시스템 프록시는 HTTP나 SOCKS 등의 프록시 주소를 운영체제에 등록합니다. 이 설정을 따르는 앱만 연결을 클라이언트로 전달합니다. 일부 게임과 명령줄 프로그램, 자체 네트워크 스택을 사용하는 앱은 시스템 프록시를 무시할 수 있습니다. 브라우저에서는 접속되지만 다른 앱에서 실패한다면 먼저 트래픽을 가로채는 범위를 확인한 뒤 TUN이 필요한지 판단하세요.

프록시 프로토콜

프로토콜은 클라이언트와 서버의 통신 방식을 정하며, 회선 품질을 직접 나타내지는 않습니다. 아래 매개변수는 모두 서버 설정과 일치해야 합니다.

Shadowsocks / ss

Shadowsocks

Shadowsocks는 암호화 프록시 프로토콜로, 노드 설정에는 보통 서버 주소와 포트, 암호화 방식, 비밀번호가 포함됩니다. 클라이언트와 서버에서 서로 호환되는 매개변수를 사용해야 하며, 일부 확장 기능에는 추가 옵션이 필요합니다. 프로토콜 이름은 연결 방식을 설명할 뿐, 노드의 속도나 안정성, 운영자의 신뢰도를 보장하지 않습니다.

VMess / vmess

VMess

VMess는 프록시 프로토콜 중 하나로, 설정에는 보통 서버와 포트, 사용자 ID, 전송 방식이 포함됩니다. WebSocket, TLS 등의 매개변수는 연결 구성의 일부이므로 서버 설정과 일치해야 합니다. 연결에 실패하면 시스템 시간도 확인하세요. 노드 이름이 같다는 이유만으로 두 설정이 같다고 볼 수는 없습니다.

VLESS / vless

VLESS

VLESS는 경량 프록시 프로토콜로, 보통 TLS나 REALITY 같은 보안 방식과 함께 사용합니다. 사용자 ID와 전송 방식, 보안 매개변수가 서버 설정과 일치해야 하며, 서버 주소만으로는 연결할 수 없습니다. VMess와는 별개의 프로토콜이므로 설정을 가져올 때 유형 항목만 바꿔 대체해서는 안 됩니다.

Trojan / trojan

Trojan

Trojan은 보통 TLS를 통해 프록시 연결을 처리하며, 설정에는 서버 주소와 포트, 비밀번호, 관련 TLS 매개변수가 필요합니다. 서버 이름과 인증서 검증 설정에 따라 연결 여부가 달라질 수 있으며, IP 주소와 인증서 도메인이 서로 다를 수도 있습니다. 인증서 오류가 발생하면 이름과 시간, 서버 설정을 확인하고 검증을 무작정 건너뛰지 마세요.

Hysteria 2 / hysteria2

Hysteria 2

Hysteria 2는 QUIC 기반 프록시 프로토콜로, UDP를 사용하므로 네트워크에서 UDP 통신을 허용해야 합니다. 인증과 TLS, 대역폭 관련 매개변수는 서버 및 실제 네트워크 환경에 맞춰 설정해야 합니다. Hysteria와 Hysteria 2는 서로 바로 대체할 수 있는 프로토콜이 아니며, 클라이언트도 해당 버전을 지원해야 합니다.

규칙과 라우팅

연결이 커널에 들어온 뒤에는 매칭 조건과 규칙 순서, 대상 정책에 따라 연결 경로가 결정됩니다.

Routing rules / rules

규칙 분류

규칙 기반 라우팅은 도메인, 대상 IP, 프로세스 등의 조건에 따라 연결을 지정된 정책으로 보냅니다. 규칙은 보통 위에서 아래 순서로 매칭되며, 먼저 일치하는 항목이 연결 경로를 결정합니다. 따라서 구체적인 규칙을 포괄적인 규칙보다 앞에 두세요. 글로벌 모드와 달리 여러 연결이 동시에 직접 연결되거나 서로 다른 프록시를 이용할 수 있습니다.

Proxy group / proxy-groups

프록시 그룹

프록시 그룹은 여러 노드나 다른 정책을 묶어 규칙에서 참조할 수 있는 대상으로 만듭니다. 수동 선택, 연결 테스트, 장애 조치는 서로 다른 그룹 유형이며 선택 방식도 다릅니다. 규칙이 그룹 이름을 참조하면 그룹 안의 노드를 바꿔도 대개 규칙을 다시 작성할 필요는 없지만, 그룹 이름은 설정의 참조와 일치해야 합니다.

GeoIP / GEOIP

GeoIP

GeoIP는 데이터베이스를 기준으로 대상 IP를 지역이나 다른 범주로 분류하며 GEOIP 유형 규칙에 사용할 수 있습니다. 데이터베이스의 분류가 웹사이트의 실제 소속 국가를 뜻하지는 않으며, CDN 뒤에서 콘텐츠가 제공되는 위치를 정확히 알려주지도 않습니다. 도메인 조회가 필요한 매칭에서는 no-resolve 매개변수와 규칙 순서가 DNS 조회에 미치는 영향도 확인하세요.

GeoSite / GEOSITE

GeoSite

GeoSite는 도메인을 범주별로 정리한 데이터로, 같은 유형의 사이트를 하나의 정책으로 보낼 때 사용할 수 있습니다. 분류 이름과 포함 범위는 데이터 소스에 따라 다르며, 모든 데이터베이스가 같은 범주를 제공하는 것은 아닙니다. 예상과 다르게 매칭된다면 프록시 그룹만 바꾸지 말고 실제로 불러온 데이터와 범주 이름, 앞에 배치된 규칙을 확인하세요.

MATCH / catch-all rule

MATCH

MATCH는 남은 연결을 처리하는 기본 규칙으로, 보통 규칙 목록의 마지막에 둡니다. 뒤에는 DIRECT나 정의된 프록시 그룹 이름처럼 연결을 보낼 정책을 지정합니다. MATCH를 앞에 두면 뒤의 규칙은 대개 매칭되지 않습니다. 기본 정책이 프록시라고 해서 설정 전체가 글로벌 모드인 것은 아닙니다.

DNS와 네트워크 스택

도메인 조회와 트래픽의 커널 유입은 서로 관련되어 있지만, 별도로 살펴봐야 하는 경로입니다.

Domain Name System / DNS

DNS

DNS는 도메인을 IP 등의 레코드로 변환하며, 대부분의 네트워크 연결을 시작할 때 중요한 역할을 합니다. 시스템과 브라우저, 프록시 커널이 각자 다른 DNS 조회 경로를 사용할 수 있으므로 한 곳의 설정을 바꿔도 다른 경로에는 영향을 주지 않을 수 있습니다. DNS 문제를 확인할 때는 먼저 요청을 보낸 주체와 사용된 리졸버, 리졸버 연결이 통과한 경로를 파악하세요.

Fake-IP / enhanced-mode

Fake-IP

Fake-IP 모드에서는 앱에 가상 주소를 반환하고, 커널이 도메인과 가상 주소의 매핑을 저장합니다. 앱이 해당 주소에 연결하면 커널이 도메인 정보를 복원한 뒤 규칙 기반 라우팅과 프록시 처리를 수행할 수 있습니다. 이 주소는 대상 웹사이트의 실제 IP가 아닙니다. 실제 DNS 조회 결과에 의존하는 앱에서 문제가 발생하면 예외 도메인과 로그를 함께 확인하세요.

TUN / virtual network interface

TUN 모드

TUN 모드는 가상 네트워크 인터페이스와 라우팅 설정을 통해 더 많은 앱의 IP 트래픽을 프록시 커널로 전달합니다. 인터페이스 생성과 라우팅 변경에 추가 권한이 필요한 경우가 많으며, 실제로 가로채는 범위는 라우트 제외 설정과 플랫폼 구현에 따라 달라집니다. TUN은 글로벌 모드와 같은 개념이 아닙니다. TUN이 가로챈 연결도 규칙에 따라 직접 연결하거나 프록시를 사용할 수 있습니다.

DNS leak

DNS 유출

DNS 유출은 DNS 조회 요청이 예상한 네트워크 경로를 따르지 않는 현상입니다. 예를 들어 프록시를 거쳐야 할 요청이 로컬 네트워크의 리졸버로 직접 전달될 수 있습니다. 테스트 페이지에 특정 DNS 서비스 제공자가 표시된다는 사실만으로 전체 요청 경로를 단정할 수는 없습니다. 시스템 DNS와 브라우저의 보안 DNS, 커널 설정, 연결 로그를 함께 확인하고 설정을 변경한 뒤 다시 테스트하세요.

DNS over HTTPS / DoH

DoH

DoH(DNS over HTTPS)는 HTTPS로 DNS 조회를 전송하는 방식으로, 바뀌는 것은 DNS 요청의 전송 방법입니다. DoH를 사용한다고 조회가 자동으로 프록시를 통과하는 것은 아니며, 라우팅 및 DNS 정책 설정을 대신하지도 않습니다. 도메인 형식의 DoH 주소를 사용할 때는 리졸버 도메인을 처음에 누가 조회하는지도 고려해 DNS 의존성 루프를 방지하세요.

구독과 설정 파일

설정을 가져온 뒤 실제로 적용되기까지 파싱과 로드, 정책 선택, 연결 확인 과정이 이어집니다.

Subscription

구독

구독은 노드나 전체 설정을 정기적으로 가져올 수 있는 주소를 가리키며, 반환되는 내용은 제공자가 결정합니다. 노드 구독과 전체 설정은 서로 다르며, 전체 설정에는 프록시 그룹과 규칙, DNS 설정이 포함될 수 있습니다. 구독 주소에 접근 인증 정보가 들어 있을 수 있으므로 로그나 스크린샷을 공유하기 전에 가리세요. 구독을 업데이트한 뒤에는 로컬에서 수정한 내용이 덮어써지지 않았는지도 확인하세요.

Node / proxy entry

노드

노드는 프록시 서버에 연결하는 데 필요한 매개변수 묶음으로, 보통 주소와 포트, 프로토콜, 인증 정보를 포함합니다. 목록에 표시되는 이름은 식별을 위한 레이블일 뿐 서버의 실제 위치를 나타내지 않을 수 있습니다. 노드를 가져올 수 있다고 해서 서비스가 작동하는 것은 아닙니다. 연결 테스트를 진행하고 프록시 그룹에서 해당 노드를 실제로 선택했는지도 확인하세요.

Latency / URL test

노드 지연 시간

클라이언트에 표시되는 노드 지연 시간은 보통 해당 노드를 통해 테스트 주소에 요청했을 때 걸린 시간이며, 반드시 ICMP ping을 뜻하지는 않습니다. 테스트 대상과 시간 제한, 연결 재사용 방식에 따라 결과가 달라지므로 클라이언트마다 표시되는 수치를 직접 비교하기 어려울 수 있습니다. 지연 시간이 낮아도 다운로드 속도가 빠르다는 보장은 없으므로 실제 서비스 접속 성능도 확인하세요.

YAML / configuration syntax

YAML

YAML은 Clash 생태계에서 널리 쓰이는 설정 파일 형식입니다. 들여쓰기로 계층을 나타내고 하이픈으로 목록 항목을 표시합니다. 편집할 때는 탭 대신 공백을 사용하고 콜론과 따옴표, 같은 수준의 항목 정렬에 주의하세요. 문법이 올바르더라도 설정이 유효하다는 뜻은 아닙니다. 존재하지 않는 정책 이름이나 커널이 지원하지 않는 항목도 불러오기 또는 실행 문제를 일으킬 수 있습니다.

Profile

프로필

프로필은 클라이언트가 설정을 저장하고 전환할 때 사용하는 관리 단위로, 로컬 파일이나 원격 구독에서 가져올 수 있습니다. 프로필이 여러 개라면 보통 활성화된 프로필만 현재 실행에 적용되므로 다른 프로필을 편집해도 연결 상태는 바로 바뀌지 않습니다. 일부 클라이언트는 오버라이드나 병합 설정을 추가로 적용합니다. 문제를 확인할 때는 원본 파일만 보지 말고 최종 적용된 설정을 확인하세요.