Clash 설정 가이드

Clash 용어 가이드: 프록시, 규칙, DNS 및 설정 필드

설정 파일에서 혼동하기 쉬운 용어를 나누어 설명합니다. 구독 가져오기, 규칙 매칭, TUN 또는 DNS를 설정할 때 먼저 개념을 확인한 뒤 작업을 진행하세요.

29개 주요 용어 5개 콘텐츠 분류 입문자와 설정 문제 해결을 위한 안내
01 · CONNECTION

프록시 프로토콜

먼저 설정의 출처, 서버 진입점 및 로컬 프록시 인터페이스를 구분해야 합니다. 같은 페이지에 함께 나타나도 각각의 역할은 다릅니다.

구독

구독은 일반적으로 원격 설정 주소 하나를 뜻하며, 클라이언트가 이를 통해 노드, 프록시 그룹, 규칙 및 DNS 설정을 가져옵니다. 구독을 업데이트하면 서버에서 제공하는 내용이 다시 읽히므로 로컬에서 직접 수정한 부분이 덮어써질 수 있습니다.

구독 링크를 가져올 수 없다면 먼저 주소가 완전하고 아직 유효한지, 응답 내용이 클라이언트가 지원하는 설정 형식인지 확인하세요. 구독 자체는 노드가 아니며, 노드는 구독 내용의 한 구성 요소일 뿐입니다.

프록시 프로토콜
노드

노드는 연결에 사용할 수 있는 프록시 서버 진입점으로, 일반적으로 서버 주소, 포트, 프로토콜, 인증 정보 및 전송 매개변수가 포함됩니다. 클라이언트가 노드를 선택해야 코어가 해당 매개변수로 연결을 설정합니다.

노드 이름은 식별을 위한 라벨일 뿐 실제 속도를 단독으로 나타내지 않습니다. 연결 품질은 로컬 네트워크, 서버 부하, 회선 거리 및 대상 웹사이트의 영향을 함께 받습니다.

프록시 프로토콜
지연 시간

지연 시간은 테스트 요청을 보낸 후 응답을 받을 때까지 걸린 시간이며, 보통 밀리초 단위로 기록합니다. 값이 작으면 당시 테스트 대상의 응답이 빠르다는 뜻이지만 다운로드 속도가 반드시 더 빠른 것은 아닙니다.

클라이언트의 지연 시간 테스트는 테스트 주소, 제한 시간 및 현재 네트워크 상태의 영향을 받습니다. 노드를 비교할 때는 같은 테스트 방식을 사용하고 실제 접속 경험도 함께 판단해야 합니다.

프록시 프로토콜
HTTP 프록시

HTTP 프록시는 로컬 수신 포트를 통해 애플리케이션 요청을 받은 뒤 클라이언트가 이후 연결 방식을 결정합니다. 브라우저와 시스템 프록시 설정을 따르는 많은 프로그램에서 이 인터페이스를 바로 사용할 수 있습니다.

시스템 프록시만 활성화하면 시스템 설정을 읽지 않는 명령줄 도구, 게임 또는 일부 백그라운드 서비스는 클라이언트를 거치지 않을 수 있습니다. 이 경우 애플리케이션에 별도로 프록시를 설정하거나 TUN 모드를 사용해야 합니다.

프록시 프로토콜
SOCKS5

SOCKS5는 범용성이 높은 프록시 프로토콜 인터페이스로, 다양한 상위 계층 연결을 전달하고 사용자 이름과 비밀번호 인증을 지원합니다. 일부 개발 도구, 다운로드 도구 및 명령줄 프로그램은 별도의 SOCKS5 설정을 제공합니다.

사용하려면 클라이언트의 로컬 수신 주소와 SOCKS 포트를 입력해야 합니다. DNS까지 프록시를 통해 처리할지는 애플리케이션 구현과 사용한 주소 형식에 따라 달라집니다.

프록시 프로토콜
02 · RUNTIME

코어와 클라이언트

그래픽 인터페이스는 설정을 쉽게 조작하도록 돕고, 코어는 실제 연결 처리를 담당합니다. 이 관계를 이해하면 시작 실패와 기능 차이를 더 직접적으로 점검할 수 있습니다.

mihomo

mihomo는 Clash Meta에서 발전한 프록시 코어로, 설정을 읽고 프로토콜 연결을 수립하며 규칙 매칭, DNS 처리 및 TUN 트래픽 가로채기를 수행합니다. 많은 최신 그래픽 클라이언트가 이를 하위 실행 구성 요소로 사용합니다.

클라이언트 인터페이스 버전과 mihomo 코어 버전은 별개의 개념입니다. 새 필드를 인식하지 못하거나 기능을 사용할 수 없다면 그래픽 클라이언트와 코어가 해당 설정을 지원하는지 모두 확인해야 합니다.

코어와 클라이언트
Clash 코어

Clash 코어는 프록시 작업을 실행하는 핵심 프로그램으로, 로컬 포트를 열고 설정에 따라 연결을 처리합니다. 코어만 실행할 때는 일반적으로 명령줄에서 설정 파일과 작업 디렉터리를 지정해야 합니다.

코어가 곧 완전한 클라이언트를 의미하지는 않습니다. 구독 관리, 메뉴 막대 아이콘, 시스템 프록시 전환 및 로그 확인 같은 기능은 보통 외부 그래픽 클라이언트가 제공합니다.

코어와 클라이언트
GUI 클라이언트

GUI 클라이언트는 그래픽 인터페이스를 갖춘 관리 프로그램으로, 구독 가져오기, 정책 선택, 모드 전환 및 로그 확인에 사용됩니다. 사용자의 조작을 코어가 이해할 수 있는 설정이나 제어 명령으로 변환합니다.

같은 코어를 사용하더라도 클라이언트마다 메뉴 위치, 기본 매개변수 및 시스템 통합 방식이 다를 수 있습니다. 튜토리얼을 따라 하기 전에 해당 튜토리얼의 클라이언트 이름과 플랫폼을 확인하세요.

코어와 클라이언트
Clash Plus

Clash Plus는 여러 주요 플랫폼을 지원하는 그래픽 클라이언트로, 구독 가져오기, 프록시 그룹 관리 및 기본 네트워크 설정 조정에 사용할 수 있습니다. 클라이언트 인터페이스 계층에 해당하며, 실제 트래픽 처리는 사용하는 코어가 담당합니다.

여러 플랫폼에서 사용할 때 메뉴 배치는 운영체제의 상호작용 방식에 따라 달라집니다. 설정 개념은 대체로 같지만 시스템 프록시, 백그라운드 실행 및 권한 설정은 플랫폼별로 처리해야 합니다.

코어와 클라이언트
Provider

Provider는 로컬 파일이나 원격 주소에서 콘텐츠 묶음을 불러오는 설정 방식으로, 프록시 모음과 규칙 모음이 대표적입니다. 기본 설정에는 참조 관계만 남기고 구체적인 항목은 별도로 업데이트할 수 있습니다.

이처럼 나누면 설정 내용이 많을 때 관리하기 쉽고, 여러 프록시 그룹이 같은 노드 묶음을 재사용하기도 편합니다. Provider 업데이트에 실패하면 참조 주소, 파일 경로, 업데이트 주기 및 콘텐츠 형식을 확인하세요.

코어와 클라이언트
03 · ROUTING

규칙과 라우팅

프록시 모드는 전체 처리 방식을 정하고, 규칙은 개별 연결의 경로를 결정합니다. 규칙은 보통 위에서 아래로 매칭되며 먼저 일치한 항목이 먼저 적용됩니다.

Rule 모드

Rule 모드는 연결을 규칙 목록과 차례로 매칭한 뒤, 일치한 정책에 따라 프록시, 직접 연결 또는 거부를 결정합니다. 일상적인 사용에 적합하며 웹사이트와 애플리케이션마다 다른 경로를 지정할 수 있습니다.

규칙 순서는 매우 중요합니다. 범위가 넓은 규칙을 너무 앞에 두면 뒤에 있는 정확한 규칙이 작동하지 않을 수 있습니다. 라우팅 문제를 점검할 때는 먼저 로그에서 매칭된 규칙과 최종 정책을 확인하세요.

규칙과 라우팅
Global 모드

Global 모드는 클라이언트가 가로챈 대부분의 연결을 현재 선택한 프록시 정책으로 일괄 처리합니다. 이때 설정의 세부 규칙은 일반적인 라우팅 판단에 참여하지 않는 경우가 많습니다.

특정 노드의 사용 가능 여부를 짧게 테스트하거나 문제가 규칙에서 비롯되었는지 확인할 때 적합합니다. 장기간 사용할 때는 LAN, 시스템 서비스 및 프록시를 거치면 안 되는 연결도 확인해야 합니다.

규칙과 라우팅
Direct 모드

Direct 모드는 가로챈 연결이 프록시 노드를 사용하지 않고 대상에 직접 접속하도록 합니다. 로컬 네트워크 경로를 임시로 복구하거나 장애가 프록시 경로와 관련 있는지 판단할 때 유용합니다.

Direct로 전환해도 클라이언트가 종료되는 것은 아닙니다. 로컬 포트, DNS 또는 TUN이 계속 실행 중일 수 있으므로 가로채기를 완전히 중지하려면 해당 기능을 끄거나 프로그램을 종료해야 합니다.

규칙과 라우팅
Rule Provider

Rule Provider는 규칙 묶음을 별도의 파일이나 원격 주소에 저장하고, 기본 설정에서 이름으로 참조합니다. 기본 설정의 길이를 줄이고 자주 사용하는 규칙 세트를 별도로 업데이트할 수 있습니다.

규칙 세트의 동작 유형은 도메인, IP 대역 또는 클래식 규칙 등 콘텐츠 형식과 일치해야 합니다. 유형이 맞지 않으면 파일을 정상적으로 내려받아도 예상대로 매칭되지 않을 수 있습니다.

규칙과 라우팅
GeoIP

GeoIP는 대상 IP가 지리 데이터베이스에서 속한 지역을 기준으로 매칭하며, 국가나 지역별로 연결을 나눌 때 자주 사용합니다. 웹페이지의 사용 언어가 아니라 주소 정보를 기준으로 판단합니다.

데이터베이스를 오랫동안 업데이트하지 않으면 새로 할당되었거나 소속이 변경된 IP가 잘못 분류될 수 있습니다. 지리 규칙의 매칭이 이상하다면 데이터베이스 업데이트 시점과 다운로드 출처를 확인하세요.

규칙과 라우팅
GeoSite

GeoSite는 용도나 소속별로 정리한 도메인 규칙 데이터베이스로, 미디어, 검색, 통신 및 주요 서비스 등의 도메인 그룹을 매칭할 수 있습니다. 도메인 분류에 초점을 두며 주소 소속을 판단하는 GeoIP와는 다릅니다.

하나의 웹사이트가 여러 타사 도메인을 동시에 사용할 수 있으므로 단일 분류만으로 모든 요청이 포함되지는 않습니다. 문제를 점검할 때는 연결 로그를 참고해 더 구체적인 도메인 규칙을 추가할 수 있습니다.

규칙과 라우팅
프록시 그룹

프록시 그룹은 여러 노드, 직접 연결 정책 또는 다른 프록시 그룹을 묶어 규칙에서 참조할 수 있게 합니다. 대표적인 동작으로 수동 선택, 테스트 결과에 따른 선택, 장애 조치 및 부하 분산이 있습니다.

규칙이 매칭하는 대상은 보통 최종 노드 이름이 아니라 프록시 그룹 이름입니다. 실제 연결 경로는 해당 시점에 프록시 그룹에서 어떤 구성원을 선택했는지에 따라 달라집니다.

규칙과 라우팅
04 · NETWORK

DNS와 네트워크

DNS는 도메인을 주소로 변환하고 TUN은 트래픽을 가로채는 범위를 넓힙니다. 두 요소는 서로 영향을 주므로 연결에 문제가 생겼을 때 중점적으로 확인해야 합니다.

DNS

DNS는 도메인을 IP 주소로 변환하는 기본 네트워크 서비스입니다. Clash가 도메인 조회를 가로채 로컬 리졸버, 원격 리졸버 또는 암호화 DNS를 설정에 따라 선택할 수 있습니다.

웹페이지는 열리지 않지만 IP로 직접 접속하면 정상일 때는 이름 해석 단계에 문제가 있을 수 있습니다. 시스템 DNS, 클라이언트 DNS 및 브라우저 보안 DNS가 서로 다른 경로를 만들고 있지 않은지 확인해야 합니다.

DNS와 네트워크
Fake-IP

Fake-IP 모드는 도메인에 먼저 예약 주소를 반환한 뒤, 애플리케이션이 연결을 시작할 때 코어가 도메인을 복원하고 규칙을 판단합니다. 도메인 정보를 유지하면서 실제 주소를 먼저 가져와 매칭하는 단계를 줄일 수 있습니다.

일부 LAN 서비스, 게임 또는 실제 주소에 의존하는 애플리케이션은 이 방식과 호환되지 않을 수 있습니다. 문제가 생기면 전체 DNS 설정을 바꾸기보다 특정 도메인을 필터 목록에 추가해 보세요.

DNS와 네트워크
Redir-Host

Redir-Host는 대상 도메인의 실제 IP를 먼저 해석한 다음 연결 및 규칙 처리를 진행합니다. 전통적인 DNS 동작에 가까워 실제 주소에 의존하는 일부 애플리케이션에서 이해하기 쉽습니다.

실제 해석이 더 일찍 이루어지므로 DNS 경로와 해석 결과가 이후 라우팅에 직접 영향을 줍니다. 모드를 바꾼 뒤에도 기존 캐시가 잠시 적용될 수 있으니 필요하면 시스템과 클라이언트 캐시를 삭제하세요.

DNS와 네트워크
DNS 누수

DNS 누수는 도메인 조회가 예상한 해석 경로를 우회하여 시스템, 브라우저 또는 다른 네트워크 구성 요소에서 직접 처리되는 현상입니다. 여러 DNS 기능을 동시에 켰거나 일부 애플리케이션이 자체 리졸버를 지정할 때 주로 발생합니다.

문제를 점검할 때는 시스템 DNS, 브라우저 보안 DNS, 클라이언트 수신 포트 및 TUN DNS 하이재킹 설정을 단계별로 확인하세요. 여러 해석 방식을 겹쳐 사용하기보다 조회 경로를 일관되게 유지하는 것이 중요합니다.

DNS와 네트워크
DoH

DoH는 DNS over HTTPS의 약자로, HTTPS 연결을 통해 도메인 조회를 전송합니다. 전송 중 기존 평문 DNS가 읽히거나 변조되는 상황을 줄일 수 있습니다.

DoH 서비스 자체도 네트워크 연결을 설정해야 하므로 서비스 도메인의 해석과 접속 경로가 정상적으로 작동해야 합니다. 잘못 설정하면 순환 해석이 발생하거나 시작 단계에서 연결하지 못할 수 있습니다.

DNS와 네트워크
TUN 모드

TUN 모드는 가상 네트워크 카드를 통해 네트워크 계층에서 트래픽을 가로채며, 시스템 프록시 설정을 읽지 않는 애플리케이션, 명령줄 프로그램 및 일부 게임도 처리할 수 있습니다. 단독으로 시스템 프록시를 켜는 것보다 가로채기 범위가 넓은 경우가 많습니다.

활성화하려면 시스템 권한이 필요할 수 있으며 라우팅, DNS 하이재킹 및 LAN 접근도 처리해야 합니다. 인터넷이 끊기면 먼저 가상 네트워크 카드가 정상적으로 생성되었는지 확인한 뒤 스택 유형과 라우팅 설정을 살펴보세요.

DNS와 네트워크
05 · CONFIG

설정 파일 필드

Clash 설정은 일반적으로 YAML을 사용합니다. 먼저 들여쓰기를 보고, 다음으로 필드 계층을 확인한 뒤 이름 참조가 일치하는지 점검하는 것이 오류 메시지를 글자 그대로 추측하는 것보다 효과적입니다.

YAML

YAML은 Clash 설정에서 자주 사용하는 데이터 형식으로, 들여쓰기로 필드 계층을 표현합니다. 공백, 콜론 및 목록 기호에 민감하며 탭이나 잘못된 들여쓰기로 인해 파싱에 실패할 수 있습니다.

설정을 수정할 때는 같은 계층의 들여쓰기를 일관되게 유지하고 노드 이름을 함부로 바꾸지 마세요. 이름에 특수 기호가 포함되어 있다면 따옴표로 감싸는 편이 더 안전합니다.

설정 파일 필드
port

port는 HTTP 프록시의 로컬 수신 포트를 설정합니다. 애플리케이션에서 HTTP 프록시를 활성화할 때는 보통 로컬 주소와 이 포트로 연결해야 합니다.

다른 프로그램이 포트를 사용 중이면 코어가 수신 대기를 시작하지 못할 수 있습니다. 포트를 변경한 뒤에는 시스템 프록시와 수동으로 설정한 애플리케이션도 함께 업데이트해야 합니다.

설정 파일 필드
mixed-port

mixed-port는 HTTP와 SOCKS 연결을 동시에 받는 혼합 수신 포트입니다. 애플리케이션은 지원하는 프록시 유형에 따라 하나의 포트에 연결할 수 있습니다.

로컬 포트 수를 줄일 수 있지만 원격 노드에서 사용하는 프로토콜이 바뀌는 것은 아닙니다. 설정에 여러 수신 포트를 함께 지정할 때는 포트 값이 서로 충돌하지 않도록 해야 합니다.

설정 파일 필드
proxies

proxies는 기본 설정에 직접 작성한 정적 노드 정의를 저장합니다. 각 항목에는 일반적으로 이름, 서버 주소, 포트, 프로토콜 및 해당 인증 매개변수가 포함됩니다.

프록시 그룹은 노드 이름으로 이러한 항목을 참조하므로 이름을 바꾸면 관련 프록시 그룹도 업데이트해야 합니다. 노드가 많다면 Proxy Provider를 사용해 내용을 별도 파일로 분리할 수 있습니다.

설정 파일 필드
proxy-groups

proxy-groups는 그룹 이름, 동작 유형 및 선택 가능한 구성원을 포함한 프록시 그룹을 정의합니다. 규칙은 보통 트래픽을 프록시 그룹에 전달하고, 프록시 그룹이 최종 노드를 결정합니다.

그룹 구성원은 노드, 내장 정책 또는 다른 프록시 그룹일 수 있습니다. 참조 이름이 정확히 일치하지 않으면 코어가 해당 프록시나 정책을 찾지 못했다는 오류를 보고할 수 있습니다.

설정 파일 필드
rules

rules는 위에서 아래 순서로 라우팅 조건과 대상 정책을 저장합니다. 일반적으로 정확한 도메인과 특수 서비스를 먼저 작성하고, 범위가 넓은 분류 규칙을 뒤에 둔 다음 최종 대체 규칙을 배치합니다.

연결이 앞쪽 규칙과 일치하면 이후 규칙은 보통 더 이상 판단하지 않습니다. 새 규칙이 적용되지 않을 때는 더 앞에 있는 광범위한 조건이 먼저 가로채고 있지 않은지 확인하세요.

설정 파일 필드