구독
원격 설정 출처 · subscription구독은 원격 링크를 통해 설정 내용을 가져오는 방식입니다. 노드, 정책 그룹, 규칙 등이 포함될 수 있으며, 노드 목록만 제공하는 것은 아닙니다. 구독을 업데이트하면 제공자가 게시한 내용을 다시 가져오므로 로컬에서 직접 수정한 필드가 덮어써질 수 있습니다. 링크에 접근 인증 정보가 포함되는 경우가 많으니 문제를 확인할 때는 민감한 매개변수를 숨기고, 전체 링크를 공개 페이지에 올리지 마세요.
설정 용어 참고
용어 25개
Clash 용어집
구독부터 네트워크 스택까지, 설정에서 용어가 등장하는 맥락에 따라 살펴보세요. 각 항목은 개념과 용도, 적용 범위를 설명합니다. 카드 제목을 링크로 공유하면 같은 용어를 다시 찾아볼 수 있습니다.
핵심 개념
먼저 설정의 출처, 프록시 항목, 트래픽 처리 방식을 구분한 다음 연결 상태를 확인하세요.
프로필(Profile)
현재 불러온 설정 · profileProfile은 코어에서 불러오는 설정 모음으로, 보통 YAML 형식으로 노드, 정책 그룹, 규칙, DNS 매개변수를 저장합니다. 구독 설정은 원격에서 가져오고 로컬 설정은 사용자가 저장하고 관리하지만, 둘 다 현재 설정으로 사용할 수 있습니다. 설정을 바꾸면 규칙과 정책 그룹도 함께 바뀔 수 있으므로 설정 이름만 보지 말고 현재 선택된 항목을 다시 확인하세요.
노드
프록시 항목 · proxies노드는 연결에 사용할 수 있는 프록시 서버 항목으로, 보통 서버 주소와 포트, 프로토콜, 인증 매개변수를 포함합니다. 설정에 노드가 표시된다는 것은 항목이 불러와졌다는 뜻일 뿐, 서버가 작동 중이거나 인증이 유효하다는 의미는 아닙니다. 연결할 수 없다면 이름이 비슷한 항목을 계속 바꾸기보다 구독 유효성, 매개변수 일치 여부, 네트워크 경로를 함께 확인하세요.
지연 시간
테스트 요청 시간 · latency클라이언트에 표시되는 지연 시간은 보통 지정된 테스트 주소에 접속하는 데 걸린 시간입니다. 도메인 해석과 핸드셰이크, 응답 과정이 포함될 수 있어 고정된 회선 특성은 아닙니다. 테스트 주소와 시간 제한, 네트워크 환경에 따라 결과가 달라집니다. 지연 시간이 짧다고 대역폭이 넓거나 특정 사이트에 접속할 수 있는 것은 아닙니다. 실제로 사용할 때는 연결 안정성과 대상 서비스의 응답도 확인하세요.
시스템 프록시
시스템 설정을 로컬 수신 포트로 연결시스템 프록시는 운영체제의 프록시 설정을 Clash 클라이언트의 로컬 수신 주소로 지정해, 해당 설정을 따르는 앱의 요청을 전달합니다. 일부 앱은 자체 네트워크 설정을 사용하므로 시스템 프록시를 켜도 직접 연결할 수 있습니다. 시스템 프록시와 TUN은 트래픽을 처리하는 계층이 다릅니다. 클라이언트를 종료하기 전에 시스템 프록시를 꺼 두면, 수신이 중단된 포트로 요청이 계속 전송되는 상황을 피할 수 있습니다.
프록시 프로토콜
프로토콜은 연결 및 인증 방식을 정하며, 전송 보안은 암호화와 인증서, 서버 설정에도 좌우됩니다.
HTTP 프록시
애플리케이션 계층 프록시 인터페이스 · HTTP / CONNECTHTTP 프록시는 브라우저 등 앱에서 흔히 사용하는 프록시 인터페이스로, CONNECT 메서드로 HTTPS 연결을 중계할 수 있습니다. 여기서 HTTP는 프록시 인터페이스의 유형을 가리킬 뿐, 대상 웹페이지가 평문 HTTP만 사용한다는 의미는 아닙니다. HTTPS를 정상적으로 중계하면 암호화 연결은 앱과 대상 서버 사이에 유지됩니다. 프록시를 사용한다고 해서 별도의 루트 인증서를 설치해야 하는 것은 아닙니다.
SOCKS5
범용 프록시 프로토콜 · TCP / UDPSOCKS5는 TCP 연결을 중계하며 UDP 데이터그램 중계 방식도 정의하지만, 앱과 클라이언트, 서버가 해당 기능을 모두 지원해야 합니다. 프로토콜 자체는 전송 암호화를 제공하지 않으므로 SOCKS5를 암호화 터널과 같은 것으로 보면 안 됩니다. 앱이 도메인을 로컬에서 먼저 해석할 수도 있고 프록시 서버에 맡길 수도 있으므로, DNS 경로를 확인할 때는 구체적인 구현을 살펴보세요.
Shadowsocks
노드 프로토콜 필드 · type: ssShadowsocks는 암호화 방식으로 네트워크 트래픽을 중계합니다. 설정할 때 서버 주소와 포트, 암호화 방식, 비밀번호를 일치시켜야 합니다. 프로토콜 버전과 암호화 방식에 따라 호환성이 다를 수 있으므로 노드 이름만 보고 사용 가능 여부를 판단하지 마세요. 서버에서 플러그인을 사용하는 경우 클라이언트도 해당 플러그인을 지원하고 매개변수를 정확히 설정해야 합니다. 암호화 방식을 바꾼다고 서버 호환성이 저절로 개선되지는 않습니다.
Trojan
TLS 프록시 프로토콜 · type: trojanTrojan은 일반적으로 TLS로 연결하고 비밀번호로 인증합니다. 서버와 포트뿐 아니라 TLS 호스트 이름, 인증서 검증, 전송 옵션도 연결 결과에 영향을 줍니다. 인증서 오류가 발생하면 시스템 시간과 호스트 이름, 서버 인증서부터 확인하세요. 인증서 검증을 건너뛰는 방식은 서버 신원을 확인하는 중요한 절차를 무력화하므로 일반적인 해결책으로 사용하지 않는 것이 좋습니다.
VLESS
노드 프로토콜 필드 · type: vlessVLESS는 UUID로 사용자를 식별하는 경우가 많은 프록시 프로토콜입니다. 실제 연결에는 서버가 지정한 전송 방식과 보안 계층도 필요합니다. TLS, REALITY, 전송 경로와 관련 매개변수는 임의로 서로 바꿔 쓸 수 없으며, 노드마다 동일한 조합을 사용하는 것도 아닙니다. 가져온 뒤 연결되지 않으면 코어의 지원 여부와 전체 매개변수를 확인하세요. UUID 하나만 추가했다고 설정이 완성되는 것은 아닙니다.
규칙 및 정책 그룹
규칙은 조건을 판별하고 정책은 연결을 처리하며, 정책 그룹은 사용할 프록시 진입점을 선택합니다.
규칙 기반 트래픽 분기
매칭 조건과 대상 정책 · rules규칙 기반 트래픽 분기는 도메인, IP, 프로세스 등의 조건에 따라 각 연결에 프록시, 직접 연결, 차단 등의 정책을 적용합니다. 규칙은 보통 위에서 아래로 검사하며, 먼저 일치한 규칙이 처리 결과를 결정합니다. 따라서 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 분기 문제를 확인할 때는 규칙 문구가 있는지만 보지 말고 연결 기록에서 일치한 규칙과 최종 정책을 확인하세요.
정책 그룹
규칙에서 참조할 수 있는 진입점 · proxy-groups정책 그룹은 여러 노드나 다른 정책 그룹을 하나의 진입점으로 묶습니다. 규칙에서 이 진입점을 참조하면 특정 노드 하나에 고정하지 않아도 됩니다. select는 수동 선택, url-test는 테스트 결과에 따른 선택, fallback은 보통 순서대로 사용할 수 있는 항목을 찾습니다. 자동 선택은 테스트 주소와 검사 간격에 영향을 받으며, 모든 사용 상황에서 늘 같은 최적의 결과를 보장하지는 않습니다.
규칙 공급자(Rule Provider)
규칙 출처 · rule-providers / RULE-SET규칙 모음은 여러 매칭 조건을 별도로 저장한 뒤 기본 설정에서 참조하는 방식으로, 도메인이나 네트워크 대역 목록을 한곳에서 관리할 때 유용합니다. 규칙 모음의 내용은 behavior와 파일 형식에 맞아야 합니다. 도메인 목록을 임의의 전체 규칙 모음 형식으로 읽을 수는 없습니다. 원격 가져오기에 실패하면 업데이트 로그와 로컬 캐시를 확인하세요. 기본 설정이 정상적으로 불러와졌어도 모든 규칙 모음의 업데이트가 성공한 것은 아닙니다.
GeoIP
IP 데이터베이스 기반 분류 · GEOIPGeoIP는 데이터베이스를 사용해 IP 주소가 속한 지역이나 유형을 판별하며, 주로 대상 주소에 따라 트래픽을 분기할 때 사용합니다. 결과는 데이터베이스 버전과 주소 할당 정보에 따라 달라지며, 웹사이트의 언어, 운영 주체, 실제 서비스 위치를 뜻하지는 않습니다. 도메인이 여러 주소로 연결되면 DNS 결과에 따라 판별 결과가 바뀔 수도 있습니다. 특정 서비스에 정밀하게 규칙을 적용하려면 도메인 규칙도 함께 구성하는 것이 일반적입니다.
규칙·전역·직접 연결 모드
연결 처리 모드 · mode규칙 모드는 규칙 목록에 따라 정책을 선택하고, 전역 모드는 가로챈 연결에 보통 전역 정책을 적용하며, 직접 연결 모드는 해당 연결을 대상에 바로 연결합니다. 모드는 코어가 이미 받은 트래픽을 어떻게 처리할지 정하는 설정이지, 앱이 트래픽을 코어에 전달할지를 정하는 설정은 아닙니다. 전역 모드를 켜도 모든 앱의 트래픽이 가로채지는 것은 아닙니다. 가로채는 범위는 시스템 프록시와 TUN, 앱 설정에 따라 달라집니다.
DNS 및 네트워크 스택
도메인 해석 경로와 트래픽 경로를 함께 확인하세요. 설정 하나를 바꿔도 모든 앱의 동작이 달라지는 것은 아닙니다.
DNS
도메인 이름 시스템 · dnsDNS는 도메인을 IP 주소 등의 레코드로 변환해 앱이 연결할 대상을 찾도록 합니다. 운영체제, 브라우저, Clash 코어는 각각 다른 해석 경로를 사용할 수 있으므로 설정에서 DNS를 바꿔도 브라우저에서 별도로 켠 보안 DNS에는 영향을 주지 않을 수 있습니다. 문제를 확인할 때는 먼저 어떤 주체가 쿼리를 보내고 어떤 해석기를 거치는지 확인한 다음 서버와 분기 설정을 조정하세요. 여러 단계를 한꺼번에 바꾸지 않는 것이 좋습니다.
Fake-IP
DNS 강화 모드 · dns.enhanced-mode: fake-ipFake-IP는 도메인에 합성 주소를 반환하고 코어에 매핑을 저장합니다. 이후 해당 주소로 연결할 때 원래 도메인을 찾아 처리에 활용할 수 있습니다. 합성 주소는 웹사이트의 실제 서버 주소가 아니므로 DNS 가로채기와 트래픽 경로를 올바르게 설정해야 합니다. 실제 DNS 결과에 의존하는 일부 앱은 fake-ip-filter에 추가해야 할 수 있습니다. 모든 도메인을 제외하기보다 구체적인 호환성 문제에 맞춰 조정하세요.
TUN 모드
가상 네트워크 인터페이스 · tun.enableTUN은 가상 네트워크 인터페이스와 라우팅 설정으로 IP 트래픽을 가로채며, 시스템 프록시 설정을 따르지 않는 일부 앱의 트래픽도 처리할 수 있습니다. 사용하려면 보통 추가 권한이 필요합니다. 실제 처리 범위는 라우팅, 제외 항목, 네트워크 스택, DNS 설정에 따라 달라지므로 스위치를 켰다고 모든 연결이 반드시 포함되는 것은 아닙니다. 다른 VPN과 함께 실행할 때는 라우팅 충돌을 확인하고 TUN을 끌 수 있는 복구 방법을 마련해 두세요.
DNS 누수
예상한 해석 경로를 우회하는 쿼리DNS 누수는 쿼리가 예상한 DNS 해석 경로나 프록시 경로를 우회하는 현상입니다. 예를 들어 로컬 네트워크에서 제공하는 DNS 서버로 쿼리가 전송될 수 있습니다. 웹 트래픽이 프록시를 통해 나가더라도 DNS 쿼리까지 같은 경로를 거친다는 보장은 없습니다. 암호화 DNS도 자동으로 프록시를 통해 연결되는 것은 아닙니다. 시스템 DNS, 브라우저 보안 DNS, TUN의 트래픽 처리 여부, 로그를 함께 확인하세요. 테스트 사이트만으로는 일부만 파악할 수 있습니다.
도메인 스니핑(Sniffer)
연결 메타데이터 식별 · sniffer도메인 스니핑은 지원되는 연결의 핸드셰이크나 프로토콜 메타데이터에서 도메인을 식별해, 대상 IP만 있는 연결의 규칙 매칭 정보를 보완합니다. 임의의 HTTPS 내용을 복호화할 수 없고 모든 연결을 식별하지도 못합니다. 특히 프로토콜과 암호화된 핸드셰이크 방식의 제약을 받습니다. 기존 대상 정보의 덮어쓰기 여부는 설정에 따라 달라지므로 매칭 기록을 비교해 변화를 확인하세요. 스니핑은 완전한 DNS 설계를 대신할 수 없습니다.
클라이언트 및 도구
인터페이스, 코어, 설정 파일은 역할이 다릅니다. 문제가 생기면 먼저 어느 계층에서 발생했는지 확인하세요.
mihomo
프록시 처리 코어mihomo는 Clash 생태계의 코어 프로젝트로, 프록시 연결, 규칙 매칭, DNS, 네트워크 트래픽 가로채기 등을 처리합니다. 그래픽 클라이언트는 조작 인터페이스를 제공하며 코어를 함께 포함하는 경우가 많지만, 클라이언트 버전과 코어 버전은 서로 다른 개념입니다. 설정 필드가 지원되지 않거나 프로토콜 호환 문제가 발생하면 실제 실행 중인 코어와 버전을 확인한 뒤 관련 설정 문서를 살펴보세요.
Clash 클라이언트
설정 관리 및 실행 제어 인터페이스Clash 클라이언트에서는 설정을 가져오고 정책을 선택하며 연결을 제어하고 로그를 확인할 수 있습니다. 앱마다 인터페이스와 시스템 통합 방식이 다릅니다. 메뉴 이름이 비슷해도 내부 기능이 완전히 같다는 뜻은 아니며, 설정 필드 지원 여부도 포함된 코어의 영향을 받습니다. 클라이언트를 선택할 때는 플랫폼과 프로세서 아키텍처를 먼저 확인한 다음 필요한 기능을 살펴보세요. 플랫폼별 정보는 다운로드 페이지에서 확인할 수 있습니다.
YAML
설정 텍스트 형식 · .yaml / .ymlYAML은 Clash 설정에 자주 사용하는 텍스트 데이터 형식입니다. 들여쓰기로 계층을 표현하고 키·값과 목록 등의 구조로 매개변수를 정리합니다. 들여쓰기에는 공백을 사용하고, 특수 문자가 포함된 문자열은 따옴표를 올바르게 처리해야 합니다. 문서의 서식을 그대로 복사하지 마세요. YAML 파서가 파일을 읽을 수 있어도 코어 설정이 유효하다는 뜻은 아닙니다. 필드 이름과 정책 그룹 참조, 매개변수 유형도 확인해야 합니다.
외부 대시보드
제어 인터페이스 · external-controller / external-ui외부 대시보드는 코어의 제어 인터페이스를 통해 연결을 확인하고 정책을 전환하며 실행 상태를 관리합니다. 프록시 트래픽의 출구 자체는 아닙니다. external-controller는 제어 인터페이스가 수신할 주소를 지정하고, external-ui는 대시보드 정적 파일의 위치를 지정하는 데 사용할 수 있습니다. 수신 범위를 제한하고 인증을 설정해 권한이 없는 사용자가 정책을 변경하거나 연결 정보를 확인하지 못하도록 하세요.
설정 오버라이드
로컬 설정 조정 · override / merge설정 오버라이드는 원본 설정을 불러오기 전후에 클라이언트가 제공하는 방식으로 특정 필드를 바꾸거나 병합하는 기능입니다. 로컬 DNS, 규칙, 트래픽 처리 설정을 유지할 때 자주 사용합니다. 클라이언트마다 맵과 목록, 적용 순서를 다르게 처리할 수 있으므로 오버라이드가 항상 기존 값을 대체하지 않고 추가된다고 가정하면 안 됩니다. 수정한 뒤 최종 적용 설정을 확인하고, 구독을 업데이트하거나 프로필을 전환해도 원하는 설정이 유지되는지 살펴보세요.
용어를 바탕으로 문제 찾기
가져오기에 실패하면 구독과 YAML부터 확인하세요. 앱 트래픽이 프록시 경로에 들어가지 않는다면 시스템 프록시와 TUN을 구분해 살펴보세요. 연결이 코어에 도달했지만 예상과 다른 정책이 적용된다면 규칙과 정책 그룹, 도메인 식별 설정을 확인하세요. 이 순서대로 점검하면 설정 출처, 트래픽 처리 범위, 분기 결과를 혼동하지 않을 수 있습니다.