개념과 설정의 범위

Clash 용어 가이드

자주 쓰이는 용어 25개를 다섯 가지 범주로 살펴봅니다. 먼저 커널, 클라이언트, 트래픽 진입점을 구분한 뒤 규칙, DNS, 설정 파일을 이해하세요. 각 용어에 고유 바로가기가 있어 해당 설명을 바로 공유할 수 있습니다.

구체적인 설정 방법은 시작 가이드를, 설정 과정을 차근차근 익히려면 사용 설명서를 확인하세요.

01 · 소프트웨어 역할

커널과 클라이언트

클라이언트는 관리를, 커널은 실제 처리를 담당합니다. 인터페이스의 스위치가 적용되는지는 권한과 실제 설정, 트래픽이 커널에 들어오는지에 따라 달라집니다.

mihomo

mihomo 커널

mihomo는 Clash Meta 포크에서 발전한 프록시 커널로, 설정 파싱, 규칙 매칭, DNS 처리, 프록시 연결 수립을 담당합니다. 그래픽 클라이언트가 관리하게 하거나 명령줄 환경에서 독립적으로 실행할 수 있습니다. 특정 항목의 지원 여부는 클라이언트 이름만 보고 판단하지 말고 실제 실행 중인 커널 버전과 문서를 확인해야 합니다.

비교: 그래픽 클라이언트 →
GUI client

그래픽 클라이언트

그래픽 클라이언트는 구독 가져오기, 프록시 그룹 선택, 시스템 프록시 전환, 로그 확인 등의 기능을 제공하며, Clash Verge Rev도 이 계층에 속합니다. 클라이언트가 커널 프로세스를 관리하고 인터페이스 설정을 구독 설정과 병합할 수도 있습니다. 따라서 구독 원본과 커널에 최종 전달되는 내용이 다를 수 있으므로 문제 해결 시 실제 실행 설정을 확인해야 합니다.

클라이언트 목록 보기 →
System proxy

시스템 프록시

시스템 프록시는 운영체제에 프록시 주소와 포트를 등록하며, 이 설정을 따르는 앱이 프록시에 연결합니다. 일반적으로 로컬 루프백 주소를 진입점으로 사용합니다. 기기의 모든 트래픽을 가로채는 것은 아니므로 자체 네트워크 설정을 사용하는 앱은 시스템 프록시를 무시할 수 있습니다. 일부 앱만 연결되지 않는다면 먼저 앱 자체의 프록시 설정을 확인한 뒤 TUN이 필요한지 판단하세요.

비교: TUN 모드 →
Service mode

서비스 모드

서비스 모드를 사용하면 클라이언트가 시스템 백그라운드 서비스를 통해 가상 네트워크 인터페이스 같은 기능에 필요한 높은 권한의 커널 작업을 시작하거나 관리할 수 있습니다. 서비스를 설치할 때 관리자 권한이 필요할 수 있지만, 시스템 프록시, TUN, 시작 프로그램이 자동으로 켜지는 것은 아닙니다. 설치 후 각 기능의 스위치와 커널 상태, 관련 로그를 따로 확인하세요.

External controller

외부 제어 인터페이스

외부 제어 인터페이스는 그래픽 클라이언트나 제어 패널이 상태를 확인하고, 정책을 전환하며, 연결을 관리하는 데 사용합니다. 설정 키는 보통 external-controller입니다. 관리용 진입점이지 브라우저 요청을 전달하는 프록시 포트가 아닙니다. 일반적으로 로컬에서만 수신하도록 제한하고 인증을 설정해야 하며, 로컬 네트워크에 공개하기 전에는 접근 권한과 방화벽도 고려해야 합니다.

비교: 혼합 포트 →
02 · 연결 설정

프로토콜과 전송

노드는 서버 주소만으로 구성되지 않습니다. 프로토콜, 인증, 전송 방식과 네트워크 지원이 서로 맞아야 하며, 테스트 결과도 실제 사용 환경에 맞춰 해석해야 합니다.

Proxy node

프록시 노드

프록시 노드는 원격 프록시 서버에 연결하는 데 필요한 설정의 묶음으로, 일반적으로 서버 주소, 포트, 프로토콜, 인증 정보, 전송 옵션을 포함합니다. 노드 이름은 식별을 위한 라벨일 뿐이며, 이름에 적힌 지역이나 회선 정보가 실제 성능을 보장하지는 않습니다. 같은 노드라도 접속 대상에 따라 결과가 다를 수 있으므로 연결 로그와 실제 접속 결과를 함께 확인하세요.

Proxy protocol

프록시 프로토콜

프록시 프로토콜은 클라이언트와 원격 서버 간 인증 및 데이터 전달 방식을 정합니다. 대표적인 프로토콜로 Shadowsocks, VMess, VLESS, Trojan이 있습니다. 서버 주소가 같아도 프로토콜을 서로 바꿔 쓸 수 있는 것은 아니며, 비밀번호와 사용자 식별자 등 관련 설정을 모두 유지해야 합니다. 가져오기나 핸드셰이크에 실패하면 먼저 커널이 해당 프로토콜을 지원하는지 확인하고, 변환 과정에서 노드 항목이 누락되지 않았는지 살펴보세요.

Transport / TLS

전송 계층과 TLS

전송 방식은 TCP 직접 연결이나 WebSocket 같은 데이터 전달 방법을 정하며, TLS는 연결을 암호화하고 인증서로 서버 신원을 확인합니다. 이 개념들은 프록시 프로토콜과 구분해야 합니다. 서버 이름, 인증서, 전송 경로가 서버 설정과 일치해야 합니다. 인증서 오류가 발생하면 검증을 끄기보다 먼저 시간, 이름, 인증서 체인을 확인하세요.

UDP forwarding

UDP 전달

UDP 전달은 UDP 기반 앱의 트래픽을 프록시 경로로 보내며, 실시간 통신과 게임, 일부 DNS 요청에 사용됩니다. 브라우저에서 웹페이지가 열린다고 해서 UDP 전달도 정상이라는 뜻은 아닙니다. 클라이언트 설정, 프록시 프로토콜, 원격 서버, 중간 네트워크가 모두 결과에 영향을 줄 수 있으므로 실제 사용하는 앱으로 확인해야 합니다.

Latency test

지연 시간 테스트

클라이언트의 지연 시간 테스트는 보통 노드를 통해 지정된 테스트 주소에 접속하는 데 걸린 시간을 측정하며, ICMP로 측정한 왕복 시간과 다를 수 있습니다. 테스트 대상과 연결 재사용, 네트워크 변동에 따라 결과가 달라지고, 테스트 주소가 다르면 수치를 직접 비교하기도 어렵습니다. 측정 시간이 짧다고 다운로드 속도가 더 빠른 것은 아니며, 시간 초과가 발생하면 테스트 대상만 접속할 수 없는지 노드 전체가 사용할 수 없는지 구분해야 합니다.

03 · 정책 선택

규칙과 라우팅

먼저 연결에 어떤 규칙이 적용됐는지 확인하고, 그 규칙이 어느 프록시 그룹을 가리키는지 살펴본 다음, 그룹에서 실제로 선택된 노드를 확인하세요.

Rule-based routing

규칙 기반 라우팅

규칙 기반 라우팅은 도메인이나 대상 IP 등의 조건에 따라 연결 정책을 선택합니다. 일반 규칙은 위에서 아래 순서로 매칭되며, 처음 일치한 규칙이 이후 경로를 결정합니다. 예를 들어 DOMAIN-SUFFIX,github.com,PROXY는 해당 도메인 접미사를 PROXY라는 정책으로 보내며, 이 정책이 실제로 존재해야 합니다. 구체적인 규칙을 포괄적인 규칙보다 앞에 두고, 마지막에는 보통 MATCH로 나머지 트래픽을 처리합니다.

Proxy group

프록시 그룹 정책

프록시 그룹은 여러 노드나 다른 프록시 그룹을 묶어 규칙에서 참조할 수 있는 진입점으로 사용하므로, 규칙을 특정 노드 하나에 고정하지 않아도 됩니다. select는 수동 선택, url-test는 테스트 결과에 따른 선택, fallback은 정해진 순서대로 사용 가능한 항목을 찾습니다. 그룹 이름은 자유롭게 지정할 수 있으며, 이름에 ‘자동’이 들어가도 자동 테스트 정책이라는 뜻은 아닙니다. 그룹 유형과 구성원을 확인하세요.

Rule / Global / Direct

규칙 모드, 전역 모드, 직접 연결 모드

규칙 모드는 규칙표에 따라 정책을 선택하고, 전역 모드는 보통 커널에 들어온 연결을 전역 정책으로 보내며, 직접 연결 모드는 대상에 바로 연결합니다. Clash 전역 모드는 앱 트래픽을 가로채지 않습니다. 커널에 들어오지 않은 연결은 모드를 바꿔도 경로가 달라지지 않습니다. 라우팅 문제를 확인할 때 모드를 잠시 바꿔 결과를 비교할 수 있지만, 전역 정책에서 현재 선택된 항목도 확인해야 합니다.

GeoIP / GeoSite

GeoIP와 GeoSite

GeoIP는 IP 주소의 지리적 등록 정보를 기준으로 매칭하고, GeoSite는 분류된 도메인 데이터를 사용합니다. 두 기능은 처리 대상이 다르며 각각 별도의 데이터 소스에 의존합니다. IP 주소의 등록 지역을 사용자 위치나 서비스 배포 위치와 동일시할 수는 없습니다. 특히 CDN을 사용하는 사이트는 도메인 규칙도 함께 확인해야 합니다. Clash GeoIP 데이터 업데이트와 구독 업데이트는 별개의 작업이므로 분류가 예상과 다르면 데이터 출처와 업데이트 시점, 규칙 순서를 점검하세요.

Rule provider / RULE-SET

규칙 세트

규칙 세트는 여러 매칭 조건을 한곳에 모아 관리합니다. rule-providers로 정의한 뒤 기본 규칙표에서 RULE-SET으로 참조합니다. 규칙 세트의 동작 유형과 파일 형식, 내용이 서로 맞아야 하며 도메인 목록을 IP 목록 형식으로 임의로 불러와서는 안 됩니다. 규칙 세트를 업데이트하면 조건만 새로고침되며 기본 규칙표에서의 위치가 바뀌거나 누락된 프록시 그룹이 만들어지지는 않습니다.

04 · DNS와 트래픽 처리

DNS와 네트워크 스택

도메인을 어떻게 조회하는지와 연결이 어떻게 커널로 들어오는지는 서로 연관되어 있지만, 하나가 다른 하나를 대신하지는 않습니다.

Domain Name System

DNS 조회

DNS 조회는 도메인을 IP 주소 등의 레코드로 변환합니다. 커널은 규칙 매칭과 연결 수립에 사용할 자체 DNS 경로를 제공할 수 있습니다. 운영체제, 브라우저, 앱이 서로 다른 해석기를 사용할 수 있고 브라우저의 암호화 DNS 설정이 시스템 DNS 경로를 우회할 수도 있습니다. 따라서 커널 DNS를 변경한 뒤에도 요청을 실제로 보낸 주체와 조회 결과가 이전 캐시에서 온 것인지 확인해야 합니다.

Fake-IP

Fake-IP

Fake-IP는 예약된 주소 대역의 가상 IP를 반환해 도메인과 연결의 대응 관계를 저장하고, 커널이 연결 단계에서 도메인 기준으로 라우팅할 수 있게 합니다. 이 주소는 원격 웹사이트의 실제 IP가 아니므로 공인 IP의 등록 정보와 직접 비교하기에 적합하지 않습니다. 실제 주소에 의존하거나 조회 결과를 자체 처리하는 일부 앱에는 예외가 필요할 수 있습니다. fake-ip-filter로 도메인별 설정을 조정한 뒤 연결을 다시 수립해 확인하세요.

TUN mode

TUN 모드

TUN 모드는 가상 네트워크 인터페이스와 라우팅 설정을 이용해 더 많은 앱 트래픽을 커널로 전달하므로, 프록시를 직접 설정할 수 없는 앱에 유용합니다. 실제로 처리되는 범위는 라우팅, 시스템 권한, 제외 설정, DNS 구성에 따라 달라집니다. TUN을 켰다고 모든 프로토콜이 정상적으로 전달된다고 단정할 수는 없습니다. 다른 VPN이나 가상 네트워크 어댑터를 함께 사용할 때는 라우팅 충돌에 유의하고, 문제가 생기면 하나씩 비활성화해 비교하세요.

DNS leak

DNS 누수

DNS 누수는 조회가 예상한 경로를 벗어나는 현상입니다. 예를 들어 프록시로 처리해야 할 도메인을 로컬 네트워크의 DNS 해석기가 조회하는 경우가 있습니다. 누수 여부를 판단하려면 먼저 예상 정책을 확인해야 합니다. 직접 연결로 조회하도록 설정한 도메인은 표시된 지역만으로 이상 여부를 판단할 수 없습니다. Clash의 DNS 누수를 점검할 때는 해석기 정보, 브라우저 암호화 DNS, 시스템 설정, 연결 로그를 함께 확인하고 검사 사이트의 국가나 지역 표시만 보아서는 안 됩니다.

Mixed port

혼합 포트

혼합 포트는 하나의 수신 포트에서 HTTP와 SOCKS 프록시를 제공해 로컬 앱이 프록시를 사용하도록 합니다. 이에 해당하는 설정 키는 mixed-port입니다. 포트 번호는 실제 실행 설정을 기준으로 확인하세요. 안내서의 예시 번호가 현재 클라이언트에도 적용된다고 볼 수는 없습니다. 로컬 네트워크 연결을 허용할 때는 수신 주소와 접근 인증, 방화벽을 확인해 로컬 전용 진입점이 다른 네트워크에 노출되지 않도록 해야 합니다.

05 · 설정 출처

구독과 설정 파일

다운로드한 원본, 로컬 수정 내용, 최종 실행 결과를 구분하면 구독 업데이트 후 설정이 사라지거나 변경 사항이 적용되지 않는 문제를 줄일 수 있습니다.

Subscription URL

구독 링크

구독 링크는 노드나 전체 설정을 가져오는 데 사용됩니다. 일반적인 Clash VPN 구독은 서비스 제공자가 생성하며 계정을 식별하는 액세스 토큰이 포함될 수 있습니다. 공개 스크린샷이나 로그, 게시판에 링크를 올리지 말고 민감 정보로 취급하세요. 구독 업데이트는 원본 내용만 새로고침하며 현재 프록시 그룹을 전환하지 않습니다. 가져온 뒤에는 설정이 활성화됐는지, 그룹에 선택 가능한 항목이 있는지, 연결 진입점이 올바른지 확인해야 합니다.

YAML

YAML 설정

YAML은 들여쓰기, 키와 값, 목록으로 구조를 표현하는 설정 형식이며, Clash 설정에는 config.yaml 같은 파일을 자주 사용합니다. 들여쓰기에는 공백을 사용해야 합니다. 계층 오류나 중복 키, 따옴표가 필요한 특수 문자는 파싱 오류를 일으킬 수 있습니다. 파일이 파싱된다는 것은 구조를 읽을 수 있다는 뜻일 뿐입니다. 현재 커널의 항목 지원 여부와 정책 참조 대상의 존재 여부를 확인하고 실행 로그에 오류가 없는지도 살펴보세요.

Subscription conversion

구독 변환

구독 변환은 노드 정보나 전체 설정을 다른 클라이언트가 인식할 수 있는 형식으로 바꿉니다. 원본 형식과 대상 클라이언트가 맞지 않을 때 주로 사용합니다. 변환 과정에서 프로토콜 설정, 프록시 그룹, 규칙, DNS 설정이 누락될 수 있으므로 단순히 파일 확장자만 바꾸는 작업은 아닙니다. 원격 변환 서비스를 이용하면 원본 구독이 해당 서비스에 전달되므로 신뢰성을 먼저 확인하고, 가능하면 제공자가 직접 제공하는 호환 형식을 사용하세요.

Override / Merge

오버라이드와 병합

오버라이드와 병합을 사용하면 구독 원본에 설정을 추가하거나 수정할 수 있어 로컬 포트, DNS, 사용자 지정 규칙을 보존하고 구독 업데이트로 변경 사항이 덮어써지는 일을 줄일 수 있습니다. 객체 병합, 목록 교체, 규칙 추가 방식은 클라이언트마다 다를 수 있으므로 다른 클라이언트의 설정 방법을 그대로 적용해서는 안 됩니다. 수정 후 병합된 설정을 확인하고 사용자 지정 규칙의 위치와 참조하는 프록시 그룹 이름을 점검하세요.

Profile / Runtime configuration

프로필과 실행 설정

프로필은 클라이언트가 저장하는 로컬 파일이나 구독 기록이고, 실행 설정은 선택한 내용에 오버라이드와 병합을 적용해 커널에 전달하는 설정입니다. 편집기에 표시된 원본과 디스크의 파일, 현재 커널 상태는 서로 다를 수 있으며 수정 후 다시 적용해야 할 수도 있습니다. 문제를 해결할 때는 현재 활성화된 프로필을 확인한 다음 실행 설정과 로그를 살펴보세요. 사용하지 않는 파일을 반복해서 수정하는 것보다 효과적입니다.