Clash 커널
설정을 읽고 규칙을 매칭해 프록시 연결을 설정하는 프로그램으로, 보통 GUI 뒤에서 실행됩니다. 원래 Clash와 이후 파생된 커널은 지속적으로 함께 업데이트되는 동일한 프로그램이 아니며, 지원하는 프로토콜과 설정 키도 다를 수 있습니다. ‘설정을 불러올 수 없음’ 문제가 발생하면 창에 표시된 클라이언트 이름만 보지 말고, ‘정보’ 화면이나 시작 로그에서 커널 이름을 확인하세요.
CLASH / 용어 정리
Clash 주요 용어
및 설정 키 정리
먼저 트래픽을 누가 가져오는지, 규칙이 어느 출구를 선택하는지 확인한 다음 DNS와 구독을 살펴보세요. 설정 위치에 따라 용어 25개를 정리했으며, 각 항목으로 바로 이동할 수 있습니다.
설정 항목을 찾을 수 없나요? 브라우저의 페이지 찾기 기능에서 한국어 이름이나 설정 키를 검색해 보세요. 설정 방법은 시작하기에서, 오류가 발생했다면 문제 해결에서 확인할 수 있습니다.
01 / 프로그램과 인터페이스
커널과 클라이언트
클라이언트 창에서는 조작하고 커널은 연결을 처리합니다. 먼저 실행 중인 프로그램을 확인한 다음 설정 키가 지원되는지 살펴보세요.
mihomo
Clash Meta 프로젝트를 이어받은 프록시 커널로, Clash 형식의 설정과 호환되며 프로토콜, DNS, 네트워크 트래픽 처리 기능을 확장했습니다. 일부 오래된 가이드에서는 ‘Meta 커널’이라고 부르므로 실제 설정 항목을 기준으로 확인해야 합니다. 클라이언트가 mihomo를 지원하더라도 현재 사용 중인 커널 버전을 확인하세요. 클라이언트 UI를 업데이트해도 커널이 바뀌지 않을 수 있습니다.
GUI 클라이언트
‘설정’, ‘프록시’, ‘로그’ 등의 조작 화면을 제공하며, 커널 실행, 구독 관리, 시스템 프록시 설정을 담당하는 앱입니다. 구독 원본에 포트, DNS, 재정의 설정을 추가할 수 있으므로 편집기에서 보이는 파일이 실제 실행 설정과 다를 수 있습니다. 설정을 저장했는데 원래대로 돌아간다면 클라이언트가 해당 항목을 관리하는지 먼저 확인한 뒤 UI 옵션과 설정 파일 중 어디를 수정할지 결정하세요.
외부 제어 인터페이스
클라이언트나 관리 대시보드에서 연결 상태를 확인하고 정책 그룹을 전환하거나 실행 설정을 변경할 때 사용하는 인터페이스입니다. 예를 들어 127.0.0.1:9090에서 수신할 수 있습니다. 관리용 인터페이스이지 브라우저의 인터넷 연결에 사용하는 프록시 포트가 아닙니다. 일반적으로 로컬에서만 접근할 수 있게 유지하세요. 원격 관리가 꼭 필요하다면 인증과 접근 제한도 설정해야 하며, 수신 주소만 모든 네트워크 인터페이스로 바꿔서는 안 됩니다.
혼합 포트
HTTP 프록시와 SOCKS 프록시 연결을 모두 받는 로컬 수신 포트입니다. 흔히 쓰는 설정 예시는 mixed-port: 7890이지만 실제 값은 클라이언트의 현재 설정을 따릅니다. 앱에 프록시를 직접 입력할 때는 올바른 수신 주소와 포트를 사용하고 제어 인터페이스 포트는 입력하지 마세요. address already in use 오류가 발생하면 같은 포트를 다른 클라이언트가 사용 중인지 먼저 확인하세요.
다음 단계: Clash 포트 설정 및 앱의 프록시 입력 방법 보기.
02 / 연결 방식
프록시 프로토콜
프로토콜에 따라 연결 방식이 결정됩니다. 프로토콜 이름이 같아도 인증, 전송, 인증서 설정이 서로 맞아야 하므로 type 하나만 바꾸면 안 됩니다.
HTTP 프록시
앱이 HTTP 요청을 프록시로 전달합니다. HTTPS에 접속할 때는 보통 CONNECT 요청으로 터널을 만든 다음 앱과 대상 사이트가 TLS 통신을 합니다. ‘HTTP 프록시’라는 이름만으로 앱과 프록시 사이의 연결이 암호화된다는 뜻은 아닙니다. 브라우저는 시스템 설정을 따를 수 있지만 다른 앱은 프록시 주소를 직접 입력해야 할 수도 있습니다. 앱에서 해당 설정을 지원하는지 확인하세요.
SOCKS5
TCP를 전달하고 UDP ASSOCIATE로 UDP를 지원하는 범용 프록시 프로토콜입니다. 실제 사용 가능 여부는 앱과 서버의 구현에 따라 다릅니다. 프로토콜 자체가 암호화를 보장하거나 도메인을 조회할 위치를 정해 주지는 않습니다. 일부 도구는 프록시 서버에서 도메인을 조회한다는 의미로 socks5h를 사용하므로, 사용 전에 해당 도구의 매개변수 안내를 확인하세요.
Shadowsocks
정해진 암호화 방식과 비밀번호로 서버에 연결하는 프록시 프로토콜이며, Clash 설정에서는 보통 ss로 표기합니다. 주소, 포트, 암호화 방식, 비밀번호와 플러그인 매개변수가 있다면 모두 서버 설정과 일치해야 합니다. 가져온 뒤 연결되지 않는다면 커널이 해당 암호화 방식과 플러그인을 지원하는지 먼저 확인하세요. 비밀번호를 다시 붙여 넣어도 프로토콜 지원 문제는 해결되지 않습니다.
Trojan
일반적으로 TLS로 암호화 연결을 설정하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호뿐 아니라 서버 인증서와 SNI도 확인해야 합니다. 연결 주소에 IP를 사용하더라도 인증서 검증에 필요한 도메인을 별도로 입력해야 할 수 있습니다. x509 관련 오류가 발생하면 시스템 시간, 도메인, 인증서 체인을 먼저 확인하고 인증서 검증을 해제한 상태로 계속 사용하지 마세요.
Hysteria 2
QUIC 기반 프록시 프로토콜로, 현재 네트워크에서 해당 UDP 통신을 허용해야 합니다. TCP를 사용하는 웹사이트에 접속할 수 있다고 해서 이 연결 경로도 사용할 수 있는 것은 아닙니다. Hysteria 2와 1세대 Hysteria는 인증 방식과 매개변수를 그대로 바꿔 쓸 수 없으므로 프로토콜 이름만 바꾸면 안 됩니다. 연결 시간 초과가 반복되면 커널 지원, 서버 주소, UDP 연결 가능 여부를 먼저 확인한 뒤 대역폭 등 고급 설정을 살펴보세요.
03 / 출구 선택
규칙과 라우팅
트래픽을 가져온 다음에야 라우팅이 적용됩니다. 연결 경로를 확인할 때는 매칭된 규칙과 정책 그룹의 현재 선택 항목을 함께 살펴보세요.
규칙 기반 라우팅
도메인, IP, 프로세스 등의 조건에 따라 연결의 출구를 선택합니다. rules는 보통 위에서 아래로 확인하며 처음 일치하는 규칙을 적용합니다. 예를 들어 DOMAIN-SUFFIX,example.com,DIRECT는 해당 도메인과 하위 도메인을 직접 연결합니다. 기본 규칙인 MATCH는 일반적으로 마지막에 배치합니다. 앞쪽에 두면 뒤에 작성한 세부 규칙이 올바르더라도 적용되지 않습니다.
정책 그룹
여러 노드나 정책 그룹을 하나로 묶어 규칙에서 출구로 참조할 수 있게 합니다. 설정 항목은 proxy-groups입니다. select는 보통 수동 선택에, url-test는 테스트 결과에 따른 선택에 사용합니다. 정책 그룹 자체가 새 프록시 서버를 추가하는 것은 아닙니다. 규칙에서 참조하는 그룹 이름은 정의된 이름과 정확히 일치해야 합니다. 그룹 이름만 확인하지 말고 그룹에서 현재 선택된 항목도 살펴보세요.
규칙·전역·직접 연결 모드
rule은 규칙에 따라 출구를 선택하고, global은 일반적으로 전역 정책 그룹을 사용하며, direct는 커널에 들어온 연결을 직접 연결합니다. 모드는 트래픽을 처리하는 방식을 정할 뿐, 어떤 앱의 트래픽을 가져올지는 결정하지 않습니다. 따라서 전역 모드로 전환해도 시스템 프록시나 TUN을 대신할 수 없습니다. 문제를 해결할 때 모드별 차이를 잠시 비교해 볼 수 있지만, 원래 설정을 기록하고 확인이 끝나면 필요한 라우팅 방식으로 되돌리세요.
GeoIP
IP 주소가 속한 지역을 기준으로 매칭하는 데이터와 규칙 방식입니다. 예를 들어 GEOIP,CN,DIRECT처럼 설정합니다. 데이터베이스의 결과는 IP 주소의 등록 지역이나 추정 지역이며 사용자의 현재 위치를 나타내지 않습니다. CDN 주소도 네트워크에 따라 달라질 수 있습니다. 예상과 다르게 매칭되면 웹페이지에 표시된 지역만 보고 규칙이 작동하지 않는다고 판단하지 말고, 현재 커널이 사용하는 데이터 형식, 로드 로그, 업데이트 출처를 확인하세요.
규칙 세트
여러 매칭 조건을 독립 리소스에 모아 rule-providers로 선언한 뒤 RULE-SET 규칙으로 참조하면 별도로 관리하고 업데이트할 수 있습니다. 규칙 세트는 ‘어떤 연결이 조건에 맞는지’를 정의하고, 이를 참조하는 규칙이 ‘어느 출구로 보낼지’를 결정합니다. 파일 형식과 behavior는 실제 내용에 맞아야 합니다. 다운로드에 성공해도 형식이 맞지 않으면 불러오지 못할 수 있습니다.
더 알아보기: 프록시 모드 선택 · GeoIP 업데이트 및 매칭 오류 해결.
04 / DNS와 트래픽 처리
DNS와 네트워크 스택
도메인 조회와 트래픽 처리는 별개의 문제입니다. 페이지가 열린다고 해서 모든 조회 요청이 예상한 경로를 거치는 것은 아닙니다.
DNS
연결을 설정하기 전에 도메인을 IP 주소로 변환하는 시스템입니다. 클라이언트의 dns 설정은 해당 DNS 조회 경로를 거치는 요청에만 영향을 줍니다. 브라우저의 암호화 DNS, 앱 자체 DNS 조회, 시스템 캐시가 결과를 바꿀 수 있습니다. no such host 오류가 발생하면 대상 도메인과 프록시 서버 도메인 중 어느 쪽의 조회가 실패했는지 확인한 뒤 해당 경로를 점검하세요.
Fake-IP
앱에는 매핑용 가상 IP를 먼저 반환하고, 커널은 매핑 정보를 이용해 도메인을 찾아 연결을 처리합니다. 도메인 정보를 유지하고 일부 DNS 조회 대기 시간을 줄이기 위한 방식입니다. 자주 사용하는 가상 주소 범위는 198.18.0.0/16이며 웹사이트의 실제 서버 주소가 아닙니다. 앱이 가상 주소를 받은 뒤 커널을 우회해 직접 연결하면 연결에 실패할 수 있습니다. 호환성 문제를 해결할 때는 특정 도메인에 맞춰 필터링하고 제외 범위를 함부로 넓히지 마세요.
TUN 모드
가상 네트워크 인터페이스와 라우팅으로 IP 트래픽을 가져와 시스템 프록시를 따르지 않는 일부 프로그램도 처리할 수 있습니다. 설정은 일반적으로 tun 아래에 있습니다. 시스템 권한, 라우팅, DNS 설정이 함께 맞아야 하며, TUN을 켠다고 기기의 모든 통신이 프록시를 거치는 것은 아닙니다. 다른 VPN과 함께 사용 중이라면 라우팅 충돌부터 확인하세요. 트래픽이 제대로 처리되는지는 스위치 상태가 아니라 연결 기록으로 확인해야 합니다.
DNS 누수
지정된 경로로 보내야 할 도메인 조회 요청이 실제로는 다른 DNS 리졸버로 전달되는 현상입니다. 예를 들어 로컬 네트워크의 DNS 서버로 요청이 전송될 수 있습니다. 운영체제, 브라우저, 클라이언트 설정과 테스트 페이지의 조회 방식까지 함께 확인하세요. 리졸버에 표시된 국가나 지역만으로는 판단할 수 없습니다. 브라우저와 시스템의 DNS 설정을 일관되게 맞춘 뒤 조회 및 연결 로그를 살펴보고 경로를 하나씩 확인하세요.
시스템 프록시
운영체제에 로컬 프록시 주소를 등록해 시스템 설정을 따르는 앱에서 사용하게 합니다. 모든 네트워크 패킷의 경로를 강제로 바꾸는 기능은 아닙니다. 명령줄 도구, 게임, 자체 네트워크 설정이 있는 프로그램은 이 설정을 무시할 수 있으므로 프록시를 별도로 설정하거나 TUN 사용을 검토해야 합니다. 클라이언트를 종료한 뒤 브라우저에서 인터넷에 접속할 수 없다면, 중지된 포트를 가리키는 프록시 주소가 시스템에 남아 있는지 먼저 확인하세요.
05 / 구독과 파일
구독과 설정 파일
가져오기에 성공했다는 것은 자료를 읽었다는 뜻일 뿐입니다. 현재 설정이 활성화되어 있는지, 참조가 올바른지, 출구를 실제로 사용할 수 있는지도 확인해야 합니다.
구독
지정된 주소에서 프록시 정보나 전체 설정을 가져와 정기적으로 업데이트하는 방식이며, 출처에 따라 내용과 형식이 다를 수 있습니다. 전체 Clash 설정에는 보통 노드, 정책 그룹, 규칙이 포함되지만 노드만 있는 구독은 전체 설정으로 바로 활성화할 수 없을 수 있습니다. 링크에 접근 인증 정보가 포함될 수 있으므로 스크린샷이나 로그를 공유하기 전에 전체 주소를 가리세요. 업데이트한 뒤에는 해당 설정이 현재 활성화되어 있는지도 확인하세요.
노드
커널에서 연결할 수 있는 프록시 서버 설정으로, 보통 프로토콜, 서버 주소, 포트, 인증 정보가 포함됩니다. 노드 이름은 표시용일 뿐이며 특정 지역이나 회선 이름이 실제 위치, 속도, 사용 가능 여부를 보장하지 않습니다. 노드는 proxies에 직접 정의하거나 프록시 공급자에서 불러올 수 있습니다. 설정 문제를 해결하기 위해 파일을 공유할 때는 표시 이름만 바꾸지 말고 인증 정보를 삭제하세요.
지연 시간 테스트
클라이언트가 지정된 출구를 통해 테스트 주소에 접속하고 걸린 시간을 기록합니다. 결과에는 연결, 핸드셰이크, 응답 대기 시간이 포함될 수 있으며 순수한 네트워크 왕복 시간만 측정하는 것은 아닙니다. 지연 시간이 짧다고 다운로드 속도가 빠른 것은 아닙니다. 테스트에 성공해도 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 노드를 비교할 때는 같은 테스트 주소와 조건을 사용하세요. 시간 초과가 표시되면 로그를 통해 연결 실패, DNS 조회 실패, 테스트 대상 접근 불가를 구분해야 합니다.
YAML
Clash 설정에 널리 쓰이는 구조화 텍스트 형식으로, 들여쓰기, 콜론, 목록 기호로 계층을 표현합니다. 들여쓰기에는 Tab이 아니라 공백을 사용하세요. config.yaml은 자주 쓰이는 파일 이름일 뿐, 파일의 모든 설정 키를 현재 커널이 지원한다는 뜻은 아닙니다. 수정한 뒤 문법을 확인하고 정책 그룹 이름과 리소스 참조도 점검하세요. 구독 관리 대상 파일은 다음 업데이트 때 덮어써질 수 있으므로, 변경 사항을 유지하려면 클라이언트에서 지원하는 재정의 기능을 사용하세요.
프록시 공급자
proxy-providers로 프록시 항목을 별도로 불러온 뒤 정책 그룹에서 use로 참조하는 방식입니다. 전체 구독 설정을 가져오는 것과 달리, 출구 정보만 따로 업데이트하고 기본 설정의 규칙과 그룹 구조는 유지할 수 있습니다. 공급자 다운로드는 완료됐는데 프록시 목록이 비어 있다면 리소스 형식, 참조 이름, 필터 조건을 확인하세요. 규칙 세트 파일을 프록시 공급자에 잘못 지정하지 않도록 주의하세요.
다음 단계: Clash 구독 링크 가져오기 · 노드 연결 시간 초과 해결.