설정 참고 · 카테고리별 정리

Clash 용어집

프록시 프로토콜과 규칙 라우팅부터 mihomo 코어와 DNS 설정까지, 클라이언트 화면과 설정 파일에서 자주 보이는 용어를 한곳에서 설명합니다. 각 항목은 어떤 문제를 해결하는지, 설정을 읽을 때 어떤 관계를 확인해야 하는지 안내합니다.

5개 카테고리 27개 용어 설정 및 문제 해결에 유용

빠른 색인

자주 쓰는 표기로 찾기

영문 약어와 한국어 이름을 모두 색인에 표시합니다. 용어를 선택하면 해당 설명으로 바로 이동할 수 있습니다.

Protocol

프록시 프로토콜

프로토콜은 클라이언트와 서버가 연결을 수립하고 인증하며 데이터를 전송하는 방식을 결정합니다. 설정할 때는 해당 프로토콜과 전송 매개변수를 코어가 지원하는지도 함께 확인해야 합니다.

Shadowsocks SS: 구조가 비교적 간단한 암호화 프록시 프로토콜로, Clash 설정에서는 흔히 SS로 줄여 씁니다. 노드에는 보통 서버 주소, 포트, 비밀번호 및 암호화 방식이 필요하며, 어느 한 항목이라도 다르면 연결이 실패할 수 있습니다. 암호화 방식에 따라 코어 버전 호환성도 달라집니다.

VMess vmess: V2Ray 생태계에서 사용하는 프록시 프로토콜로, 인증 정보는 보통 사용자 식별자로 표시합니다. VMess는 TCP, WebSocket 등의 전송 방식과 함께 사용할 수 있으므로 서버와 포트만 확인하는 것으로는 충분하지 않습니다. 클라이언트의 네트워크 유형, TLS 및 경로 매개변수도 서버 설정과 일치해야 합니다.

Trojan trojan: TLS 연결 방식을 기반으로 설계된 프록시 프로토콜로, 클라이언트에는 보통 서버 주소, 포트, 비밀번호 및 도메인 관련 설정을 입력해야 합니다. 인증서 이름 검증과 SNI 설정이 TLS 연결 수립 여부에 영향을 줍니다. 문제를 해결할 때는 인증 오류, 인증서 오류 및 네트워크 연결 불가를 먼저 구분해야 합니다.

VLESS vless: 인증 계층을 간소화한 프록시 프로토콜로, 자체적으로 완전한 전송 보안을 제공하지는 않습니다. 실제 설정에서는 TLS, Reality 또는 특정 전송 계층을 함께 사용하는 경우가 많으므로, 프로토콜 이름이 같다고 노드 매개변수를 서로 바꿔 쓸 수 있는 것은 아닙니다. 사용 전에 현재 코어가 설정에 사용된 확장 기능을 지원하는지 확인해야 합니다.

Hysteria2 hy2: QUIC 기반 프록시 프로토콜로, 패킷 손실이나 대역폭 변동이 큰 네트워크 환경에 맞춰 전송을 최적화합니다. 하위 전송에 UDP를 사용하므로 네트워크에서 안정적인 UDP 통신을 허용하는지가 연결 품질에 직접 영향을 줍니다. 인증 정보, TLS 도메인 및 대역폭 매개변수는 서버 설정에 맞춰 입력해야 합니다.

TUIC tuic: 마찬가지로 QUIC 기반인 프록시 프로토콜로, 멀티플렉싱 등의 전송 기능을 지원합니다. 노드 설정에는 보통 사용자 식별자, 비밀번호, 혼잡 제어 및 TLS 관련 항목이 포함됩니다. 오래된 코어는 최신 설정을 인식하지 못할 수 있으므로 가져오기에 실패하면 먼저 코어의 지원 범위를 확인해야 합니다.

Routing

규칙 및 라우팅

규칙은 연결 정보를 위에서 아래로 매칭하고, 일치하면 해당 정책으로 전달합니다. 순서, 규칙 데이터 및 정책 그룹 이름이 최종 출구를 함께 결정합니다.

규칙 라우팅 rules: 도메인, IP, 프로세스 또는 지리 데이터를 기준으로 트래픽을 식별한 뒤 지정된 정책으로 처리하는 방식입니다. Clash는 일반적으로 규칙 목록의 위에서 아래로 검색하며, 처음 일치한 뒤에는 추가 매칭을 중단합니다. 범위가 넓은 규칙을 너무 앞에 배치하면 뒤의 더 정확한 규칙이 적용되지 않을 수 있습니다.

정책 그룹 proxy-group: 여러 프록시 노드, 다른 정책 그룹 또는 DIRECT를 하나의 논리적 출구로 구성합니다. 일반적인 유형으로는 수동 선택, 자동 테스트, 장애 조치 및 부하 분산이 있습니다. 규칙은 보통 특정 노드가 아니라 정책 그룹 이름을 참조합니다.

DIRECT 직접 연결: 트래픽이 프록시 노드를 거치지 않고 대상 주소에 직접 연결되도록 지정합니다. DIRECT도 로컬 네트워크, 라우팅 및 DNS 조회 결과의 영향을 받습니다. 단일 규칙의 정책 위치에 쓰거나 정책 그룹의 선택지로 사용할 수 있습니다.

MATCH 기본 규칙: 규칙 목록의 최종 기본 유형으로, 앞선 규칙에 매칭되지 않은 트래픽을 처리합니다. MATCH는 보통 규칙 목록의 마지막에 배치하며, 그 뒤에 규칙을 추가해도 예상대로 작동하지 않습니다. MATCH가 가리키는 정책 그룹이 분류되지 않은 연결의 기본 처리 방식을 결정합니다.

GeoIP IP 지리 규칙: 대상 IP가 지리 데이터베이스에서 속한 위치 정보를 기준으로 매칭합니다. 도메인 연결은 GeoIP가 판단할 주소를 얻기 위해 먼저 조회를 완료해야 할 수 있습니다. 데이터베이스의 최신 여부, 조회 결과 및 CDN 라우팅이 실제 매칭 결과에 영향을 줍니다.

GeoSite 도메인 분류: 미리 정리된 도메인 분류 모음을 기준으로 요청을 매칭합니다. 예를 들어 소프트웨어 서비스나 콘텐츠 카테고리가 있습니다. 도메인 모음을 처리하므로 GeoIP의 주소 소속 판단과는 다릅니다. 사용할 수 있는 분류 이름은 현재 지리 데이터 파일과 코어 지원 여부에 따라 달라집니다.

Core & Client

코어 및 클라이언트

그래픽 클라이언트는 조작 인터페이스를 제공하고 코어는 네트워크 처리를 수행합니다. 두 영역의 경계를 이해하면 특정 기능이 인터페이스 버전과 코어 버전 중 어느 쪽에 의해 결정되는지 판단하기 쉽습니다.

Clash 코어 core: 설정을 읽고 프록시 연결을 수립하며 규칙을 매칭하고 제어 인터페이스를 제공하는 핵심 프로그램입니다. 그래픽 클라이언트는 보통 제어 인터페이스를 통해 정책, 연결 및 로그 정보를 읽습니다. 프로토콜 지원, DNS 동작 및 규칙 문법은 주로 코어의 구현에 따라 결정됩니다.

mihomo Clash.Meta: Clash.Meta에서 발전한 오픈 소스 프록시 코어로, 다양한 프로토콜·규칙·DNS 설정 기능을 지원합니다. 일부 클라이언트는 mihomo를 내장 코어로 사용하고, 일부 환경에서는 별도로 실행할 수도 있습니다. 튜토리얼을 확인할 때는 내용이 원본 Clash 문법을 대상으로 하는지 mihomo 확장 문법을 대상으로 하는지 살펴봐야 합니다.

그래픽 클라이언트 GUI client: 코어에 설정 가져오기, 정책 선택, 로그 확인 및 시스템 프록시 제어 등의 시각적 조작 기능을 제공하는 애플리케이션입니다. 클라이언트마다 같은 코어를 사용할 수 있지만 인터페이스 구성, 업데이트 방식 및 플랫폼 연동은 서로 다릅니다. 클라이언트 업데이트와 코어 업데이트도 별개의 과정일 수 있습니다.

TUN 모드 virtual interface: 가상 네트워크 인터페이스를 통해 IP 트래픽을 가로채는 방식으로, 일반적으로 시스템 프록시보다 더 넓은 범위의 트래픽을 처리합니다. 시스템 프록시 설정을 읽지 않는 애플리케이션도 처리할 수 있지만 라우팅, DNS 및 시스템 권한과 관련된 설정이 필요합니다. 활성화 후 네트워크가 끊기면 로그에서 인터페이스 생성, 라우팅 기록 및 DNS 설정을 함께 확인해야 합니다.

Profile

설정 및 구독

설정은 코어의 동작 방식을 정의하고, 구독은 설정 내용을 전달하거나 업데이트합니다. 가져오기에 성공했다는 것은 파일을 읽을 수 있다는 뜻일 뿐, 모든 노드와 규칙이 정상적으로 작동한다는 의미는 아닙니다.

구독 subscription: 서버에서 제공하는 설정 진입점으로, 클라이언트는 구독 주소를 통해 노드와 정책 관련 내용을 가져올 수 있습니다. 구독을 업데이트하면 원격 데이터를 다시 가져오지만, 로컬 덮어쓰기 항목을 유지할지는 클라이언트의 설정 관리 방식에 따라 달라집니다. 링크 만료, 접근 제한 또는 호환되지 않는 반환 형식으로 인해 업데이트가 실패할 수 있습니다.

설정 파일 profile: 프록시 노드, 정책 그룹, 규칙, DNS 및 수신 포트 등의 설정을 정의하는 YAML 문서입니다. 완전한 설정을 유지하려면 각 부분의 이름 참조가 일치해야 합니다. 예를 들어 규칙의 정책 이름이 정책 그룹에 존재해야 합니다. 수정한 뒤에는 먼저 문법이 유효한지 확인하고 설정을 다시 불러와야 합니다.

노드 proxy: 설정에 정의된 개별 프록시 출구로, 일반적으로 프로토콜 유형, 서버 주소, 포트 및 인증 정보가 포함됩니다. 노드 이름은 주로 화면 표시와 정책 그룹 참조에 사용되며 연결 품질을 의미하지 않습니다. 노드 사용 가능 여부는 매개변수의 정확성, 서버 상태 및 현재 네트워크 경로에 따라 결정됩니다.

YAML .yaml: Clash 설정에서 흔히 사용하는 구조화된 텍스트 형식으로, 들여쓰기로 계층을 표시합니다. 탭, 잘못된 들여쓰기, 누락된 콜론 또는 부적절한 특수 문자가 있으면 파일을 파싱하지 못할 수 있습니다. 편집할 때는 같은 계층의 들여쓰기를 일관되게 유지하고 목록과 키-값 객체를 구분해야 합니다.

Provider 외부 모음: 별도 파일이나 원격 주소에서 프록시 노드, 규칙 모음 등의 내용을 불러오는 설정 방식입니다. Proxy Provider는 노드 모음을 관리하고 Rule Provider는 규칙 모음을 관리하므로 용도가 다릅니다. 업데이트 주기, 캐시 경로 및 참조 이름이 주 설정에서 정확히 대응해야 합니다.

Network

네트워크 기초

프록시가 실제로 적용되는지는 노드뿐 아니라 애플리케이션 프록시 설정, 이름 확인, 수신 포트 및 운영체제 라우팅에도 영향을 받습니다. 문제를 해결할 때는 경로를 단계별로 확인해야 합니다.

지연 시간 latency: 클라이언트가 테스트 요청을 보낸 뒤 응답을 받을 때까지 걸린 시간으로, 보통 밀리초로 표시합니다. 특정 테스트 주소, 테스트 방식 및 당시 네트워크 상태만 반영하며 다운로드 속도와는 다릅니다. 클라이언트마다 테스트 대상이 다르면 결과를 직접 비교하기 어렵습니다.

시스템 프록시 system proxy: 운영체제가 애플리케이션에 제공하는 HTTP 또는 SOCKS 프록시 설정입니다. 브라우저 등은 보통 이를 따르지만 일부 터미널 도구, 게임 또는 네트워크를 자체 관리하는 프로그램은 무시할 수 있습니다. 시스템 프록시를 켠 뒤에도 적용되지 않으면 먼저 애플리케이션이 시스템 설정을 읽는지 확인해야 합니다.

DNS 도메인 조회: 도메인을 IP 주소로 변환하는 시스템으로, 대부분의 네트워크 연결을 시작하기 전에 거치는 중요한 단계입니다. Clash는 설정에 따라 DNS 서버, 수신 방식 및 조회 경로를 선택할 수 있습니다. 조회 결과는 도메인 규칙, GeoIP 판단 및 최종 연결 주소에 영향을 줍니다.

DNS 누수 DNS leak: 서비스 트래픽은 예상한 경로를 통과하지만 도메인 조회가 예상하지 못한 다른 경로로 전송되는 현상입니다. 애플리케이션이 DNS를 직접 지정하거나 시스템이 기존 조회기를 계속 사용하거나 TUN과 DNS 가로채기 설정이 제대로 연동되지 않은 경우에 자주 발생합니다. 문제를 해결할 때는 조회를 누가 시작했는지, 어디로 전송했는지, 어떤 결과가 반환됐는지를 함께 확인해야 합니다.

Fake-IP 향상된 모드: DNS 모듈이 먼저 예약 주소 매핑을 반환하고, 코어가 매핑을 기반으로 대상 도메인을 복원한 뒤 규칙을 매칭하는 방식입니다. 연결 단계에서 도메인 정보를 식별할 수 있도록 하는 데 도움이 됩니다. 일부 LAN 장치나 특수 애플리케이션에는 매핑 주소가 적합하지 않으므로 필터 규칙으로 제외할 수 있습니다.

혼합 포트 mixed-port: 하나의 로컬 수신 포트에서 HTTP와 SOCKS5 프록시 연결을 동시에 허용하는 설정입니다. 애플리케이션은 지원하는 프록시 유형에 맞춰 해당 포트에 연결하면 됩니다. 포트를 다른 프로그램이 이미 사용 중이면 코어가 일반적으로 로그에 수신 실패를 기록합니다.

개념 관계

구독에서 연결까지의 처리 순서

설정 불러오기 클라이언트가 로컬 파일이나 구독에서 YAML 내용을 읽어 코어에 전달하고 파싱합니다.
진입점 생성 시스템 프록시, 혼합 포트 또는 TUN 모드가 애플리케이션 트래픽을 코어로 보냅니다.
식별 완료 DNS, 도메인 및 대상 IP 정보가 규칙 매칭에 필요한 조건을 제공합니다.
규칙 매칭 규칙이 순서에 따라 정책 그룹을 선택하고, MATCH가 앞서 매칭되지 않은 연결을 처리합니다.
출구 선택 정책 그룹이 최종적으로 노드 또는 DIRECT를 선택하고 해당 방식으로 연결을 수립합니다.