용어 본문으로 이동

설정 항목 · 프로토콜 개념 · 설정 범위

Clash 용어 가이드

설정 상황에 맞는 용어를 찾아보세요. 먼저 개념과 역할을 파악한 뒤 클라이언트의 설정 항목, 권한, 실제 적용 여부를 확인하세요.

자주 쓰이는 용어 25개를 정리했습니다. 설정을 이해하는 데 참고하되, 메뉴 이름과 지원 범위는 실제 클라이언트 및 커널 버전에 따라 다를 수 있습니다.

커널과 클라이언트

클라이언트는 조작 기능을 제공하고 커널은 연결을 처리합니다. 기능 차이가 있다면 두 항목을 모두 확인하세요.

클라이언트: Client application; 구독 관리, 정책 선택, 시스템 설정을 제공하는 애플리케이션 인터페이스입니다. 데스크톱 클라이언트는 트레이 메뉴, 시작 시 실행, 로그 관리 기능도 제공하는 경우가 많습니다. 클라이언트는 조작을 돕고 커널은 연결을 처리합니다. 화면이 비슷한 두 앱도 커널 버전이나 설정 병합 방식이 다를 수 있습니다. 앱을 선택할 때는 운영체제 지원, 유지 관리 상태, 필요한 기능을 각각 확인하세요.

mihomo: Proxy core; Clash Meta의 개발을 이어받은 프록시 커널로, 프로토콜 연결과 규칙 매칭, DNS 처리 등을 담당하며 특정 그래픽 클라이언트와 동일한 것은 아닙니다. 설정을 불러올 수 있는지는 실행 중인 커널 버전과 필드 지원 여부에 따라 달라집니다. 새 기능 문서를 찾았다면 설정을 변경하기 전에 클라이언트의 커널 정보나 시작 로그에서 버전을 확인하세요.

Clash Meta: Historical core name; Clash 생태계에서 확장 커널을 가리키던 옛 이름으로, 이후 mihomo로 발전했습니다. 따라서 오래된 가이드나 구독 옵션, 앱 이름에 Meta라는 문구가 남아 있을 수 있습니다. 이 이름만으로 설치 파일의 배포 시기를 알 수 없고, 현재 mihomo의 모든 기능을 지원한다고 보장할 수도 없습니다. 이전 설정을 옮길 때는 파일명이나 클라이언트 표시 이름만 바꾸지 말고 필드 호환성을 확인하세요.

TUN 모드: Virtual network interface; 가상 네트워크 인터페이스를 통해 트래픽을 처리하는 방식으로, 시스템 프록시 설정을 따르지 않는 일부 앱에도 적용할 수 있습니다. 활성화하려면 보통 관리자 권한, 가상 인터페이스, 라우팅 및 DNS 가로채기 설정이 필요합니다. 적용 범위는 운영체제와 클라이언트 구현에 따라 다릅니다. 켠 뒤 인터넷에 연결되지 않으면 노드 오류로 단정하지 말고 라우팅 충돌, 다른 VPN, DNS 설정을 확인하세요.

시스템 프록시: System proxy settings; 운영체제가 제공하는 프록시 주소 설정으로, 이 설정을 따르는 앱의 요청을 클라이언트의 로컬 수신 포트로 보냅니다. 시스템 프록시를 켜도 모든 트래픽이 프록시를 거치는 것은 아니며, 게임, 명령줄 도구, 일부 앱은 자체 네트워크 설정을 사용할 수 있습니다. 클라이언트를 종료한 뒤 일반 웹페이지도 열리지 않는다면, 시스템에 종료된 포트를 가리키는 프록시 주소가 남아 있는지 먼저 확인하세요.

프록시 프로토콜

프로토콜 유형은 서버 설정과 일치해야 합니다. 연결 상태는 회선, 전송 방식, 네트워크 환경에도 영향을 받습니다.

Shadowsocks（SS）: Shadowsocks; 사전 공유 키와 지정된 암호화 방식을 사용해 연결하는 프록시 프로토콜입니다. 노드 항목에는 보통 서버 주소, 포트, 암호화 방식, 비밀번호가 필요합니다. 클라이언트와 서버는 호환되는 프로토콜 세대와 인증 매개변수를 사용해야 합니다. 다른 프로토콜의 노드 유형을 SS로 바꾸는 것만으로는 작동하지 않습니다. 인증에 실패하면 구독 내용과 커널 지원 여부를 먼저 확인한 뒤 네트워크 연결을 점검하세요.

VMess: VMess protocol; 사용자 ID로 인증하고 여러 전송 방식을 함께 사용할 수 있는 프록시 프로토콜입니다. 실제 노드에는 WebSocket, TLS, 서버 이름 등의 매개변수가 포함될 수 있습니다. 유형이 같아도 전송 계층 매개변수가 다르면 연결에 실패할 수 있습니다. 오래된 설정을 점검할 때는 전체 매개변수와 시스템 시간이 올바른지 확인하고, 노드 이름만 비교하거나 사용자 ID 일부만 복사하지 마세요.

Trojan: Trojan protocol; 일반적으로 TLS 연결과 비밀번호 인증을 사용하는 프록시 프로토콜로, 연결 시 TLS와 프로토콜 인증을 모두 완료해야 합니다. 서버 이름, 인증서 검증, 비밀번호가 서버 설정과 일치해야 하므로 포트에 접속할 수 있다고 노드가 정상 작동하는 것은 아닙니다. 인증서 오류가 발생하면 시간, 도메인, 인증서 설정을 확인하세요. 인증서 검증을 끄는 것은 기본적인 해결 방법이 아닙니다.

VLESS: VLESS protocol; 인증과 외부 전송 계층의 보안을 분리한 경량 프록시 프로토콜로, 자체적으로 데이터 암호화를 제공하지 않습니다. 실제 보안 수준은 함께 사용하는 전송 설정에 따라 달라집니다. TLS, REALITY, 전송 유형 및 관련 매개변수가 연결 방식을 결정하므로 VLESS라는 이름만으로 호환성을 판단할 수 없습니다. 가져온 뒤 필드가 무시되거나 미지원 오류가 발생하면 현재 커널이 해당 조합을 지원하는지 먼저 확인하세요.

Hysteria 2 및 TUIC: QUIC-based proxy protocols; 서로 다른 두 QUIC 기반 프록시 프로토콜입니다. 모두 네트워크에서 해당 UDP 통신을 허용해야 하지만 인증 방식과 설정 항목은 서로 다릅니다. 패킷 손실이 있는 일부 환경에서는 TCP 방식과 다른 특성을 보일 수 있지만, 모든 회선에서 더 빠르다고 보장하지는 않습니다. 선택할 때는 서버 지원 여부, 네트워크의 UDP 제한, 모바일 기기의 배터리 사용량을 고려하고 실제 사용 환경에서 확인하세요.

전송 방식의 장단점을 비교하려면 프로토콜 및 커널 기술 참고 자료를 확인하세요.

규칙 및 라우팅

규칙은 연결을 처리할 대상을 정하고, 정책 그룹은 출구 선택 방식을 정합니다. 문제를 점검할 때는 실제로 적용된 규칙부터 확인하세요.

규칙 기반 라우팅: Rule-based routing; 도메인, IP 또는 기타 연결 속성을 기준으로 트래픽에 적용할 정책을 선택하는 방식입니다. 규칙은 보통 위에서 아래로 확인하며, 처음 일치하는 규칙이 이후 처리 방식을 결정합니다. 따라서 구체적인 조건은 일반적인 조건보다 위에 두는 것이 좋습니다. 특정 앱의 연결 방향이 예상과 다르면 노드를 계속 바꾸기보다 연결 기록에서 적용된 규칙을 확인하고 순서나 조건을 조정하세요.

정책 그룹: Proxy group; 노드나 다른 정책을 선택, 자동 테스트 또는 장애 전환에 사용할 수 있도록 묶은 그룹입니다. 규칙에서 그룹 이름을 직접 참조할 수 있습니다. 업무별 분류와 실제 출구를 분리할 수 있어 규칙을 그대로 두고 그룹 내 선택만 바꾸면 됩니다. 정책 그룹 유형마다 전환 조건이 다르며, 자동 테스트 결과는 지정한 테스트 대상에만 해당하므로 모든 앱의 접속 가능 여부를 나타내지는 않습니다.

GeoIP: IP geolocation database; IP 데이터베이스를 통해 대상 주소를 지역 등으로 분류하는 규칙 기준입니다. 예를 들어 GEOIP,CN,DIRECT는 데이터베이스에서 해당 주소로 분류된 IP를 매칭합니다. 데이터베이스가 최신이 아닐 수 있고 하나의 서비스가 여러 지역의 주소를 사용할 수도 있으므로 모든 도메인 규칙을 대신하지는 않습니다. 데이터를 업데이트한 뒤에도 라우팅이 예상과 다르면 실제 DNS 응답과 앞서 적용되는 규칙도 확인하세요.

GeoSite: Categorized domain datasets; 서비스나 용도별로 정리한 도메인 모음으로, GEOSITE 규칙에서 참조하면 도메인을 하나씩 관리할 필요가 줄어듭니다. 분류 이름의 제공 여부는 불러온 데이터 파일에 따라 다르며, 모든 데이터 소스가 같은 목록을 제공하지는 않습니다. 도메인 분류를 처리하는 기능으로, GeoIP의 IP 주소 분류와는 다릅니다. 분류를 찾을 수 없다면 데이터 소스와 업데이트 로그를 확인하세요.

DIRECT, REJECT 및 MATCH: Actions and catch-all rule; DIRECT와 REJECT는 각각 직접 연결과 연결 거부를 뜻하는 처리 정책입니다. MATCH는 나머지 트래픽을 매칭하는 규칙 유형으로, 보통 규칙 목록의 마지막에 둡니다. 예시 MATCH,PROXY에서 PROXY는 일반적으로 설정에서 직접 지정한 정책 이름이며 자동으로 생성되는 노드가 아닙니다. 참조하는 이름은 설정에 정의된 항목과 일치해야 합니다.

네트워크와 DNS

도메인 조회, 트래픽 연결, 노드 접속은 각각 다른 단계이므로 따로 확인해야 합니다.

DNS: Domain Name System; 도메인을 네트워크 주소 등의 레코드로 변환하는 시스템으로, 앱은 보통 DNS 응답을 받은 뒤 연결을 시작합니다. 클라이언트의 DNS 설정은 요청 경로와 조회 결과, 일부 규칙 판단에 영향을 주지만, DNS 서버를 바꾼다고 노드 대역폭이 늘어나지는 않습니다. 도메인으로는 접속할 수 없지만 IP로는 연결되는 경우, 조회 로그와 캐시를 확인하고 앱이 자체 DNS를 사용하는지도 살펴보세요.

Fake-IP: Synthetic address mapping; 커널이 앱에 가상 주소를 반환하고 주소와 도메인의 매핑을 관리하는 DNS 방식입니다. 가상 주소는 대상 서비스의 실제 공인 IP가 아닙니다. 연결이 커널로 돌아오면 매핑을 활용해 도메인 정보를 유지하고 라우팅할 수 있습니다. 일부 LAN 서비스나 앱은 실제 DNS 응답이 필요할 수 있으므로 호환성 문제가 발생하면 필요한 항목만 필터링하고 기존 DNS 캐시도 확인하세요.

DNS 누수: DNS leak; DNS 요청이 예상한 조회 경로를 벗어나 다른 DNS 서버로 전달되는 현상입니다. 판단하기 전에 어떤 서버가 어떤 경로로 조회해야 하는지 먼저 정해야 합니다. 브라우저의 보안 DNS, 앱 내장 DNS, 시스템 DNS에 따라 요청 목적지가 달라질 수 있습니다. 검사 페이지에 표시된 DNS 서버의 지역은 참고 자료일 뿐, 그것만으로 누수 여부를 입증할 수는 없습니다. 로그와 실제 네트워크 설정을 함께 확인하세요.

지연 시간: Latency; 특정 방식으로 테스트 대상이 응답을 완료하는 데 걸린 시간입니다. 클라이언트에서 흔히 사용하는 URL 테스트는 연결 설정과 요청 응답을 포함할 수 있어 ICMP ping과 같지 않습니다. 측정값은 테스트 주소, 캐시, 네트워크 상태, 시간 초과 설정에 따라 달라지므로 도구마다 나온 결과를 그대로 비교하기 어렵습니다. 지연 시간이 낮으면 대화형 응답에 유리할 수 있지만, 지속적인 다운로드 속도나 동영상 재생 안정성을 바로 판단할 수는 없습니다.

LAN 연결 허용: Allow LAN access; 다른 기기에서 이 기기의 프록시 수신 서비스에 접속할 수 있도록 허용하는 설정으로, 보통 allow-lan에 해당합니다. 이 설정만으로 기기가 LAN 전체의 트래픽을 자동으로 처리하는 것은 아닙니다. 실제 접속 여부는 수신 주소, 방화벽, 프록시 포트, 무선 네트워크 격리에도 영향을 받습니다. 신뢰할 수 있는 네트워크에서만 사용하고 인증과 접근 범위를 필요한 만큼 제한해 불필요한 네트워크에 서비스가 노출되지 않도록 하세요.

구독 및 설정

구독은 가져올 내용을 제공하고, 설정은 실행 방식을 정의하며, 오버라이드는 최종 병합 결과를 결정합니다.

구독: Subscription; 링크를 통해 노드 모음이나 전체 설정을 가져와 업데이트하는 방식입니다. 콘텐츠는 프로토콜 링크 목록일 수도 있고 규칙 및 정책 그룹을 포함한 YAML 파일일 수도 있습니다. 클라이언트가 해당 형식을 지원해야 하며, 파일을 다운로드할 수 있다고 해서 가져오기도 가능한 것은 아닙니다. 구독 링크에는 접속 정보가 포함될 수 있으므로 스크린샷, 로그, 문의 글에 공개하지 마세요. 자동 업데이트 주기도 제공자의 안내에 맞춰 설정하세요.

노드: Proxy endpoint; 프록시 출구에 연결하는 데 필요한 매개변수를 담은 항목으로, 보통 프로토콜, 서버 주소, 포트, 인증 정보와 전송 및 TLS 매개변수를 포함합니다. 노드 이름은 알아보기 쉽게 붙인 표시에 불과하므로 서버 위치, 회선 품질, 현재 접속 가능 여부를 증명하지 않습니다. 표시 이름을 바꿔도 연결이 개선되지는 않습니다. 문제를 점검할 때는 전체 매개변수, 서버 상태, 네트워크 경로를 확인하세요.

YAML: YAML configuration format; 맵, 목록, 스칼라 등의 데이터를 표현하는 텍스트 형식으로, Clash에서는 프록시, 규칙, DNS 설정을 작성할 때 자주 사용합니다. 들여쓰기, 필드 계층, 데이터 유형에 따라 파싱 결과가 달라지며 같은 줄도 배치된 계층에 따라 의미가 바뀔 수 있습니다. 편집할 때는 공백 들여쓰기를 사용하고 백업을 보관하세요. 문법을 파싱할 수 있더라도 커널에서 필드가 유효한지, 참조 대상이 있는지 확인해야 합니다.

설정 오버라이드: Configuration override; 구독 설정을 불러오는 과정에서 지정한 필드를 병합하거나 수정하는 방식입니다. 로컬 DNS, 규칙, 수신 설정을 유지해 업데이트 후 반복 편집을 줄일 수 있습니다. 병합 순서, 목록 추가, 필드 교체 방식은 클라이언트마다 다를 수 있으므로 이름이 같은 기능이 동일한 결과를 낸다고 가정하지 마세요. 수정한 뒤 실제 적용된 설정을 확인하고 구독을 다시 업데이트한 뒤에도 원하는 상태가 유지되는지 살펴보세요.

프록시 및 규칙 모음: Proxy providers / Rule providers; proxy-providers와 rule-providers는 각각 노드 모음과 규칙 모음을 별도로 불러와 기본 설정과 분리해 관리하는 데 사용합니다. 모음을 선언한 뒤 정책 그룹이나 규칙에서 참조해야 합니다. 리소스가 있어도 참조하지 않으면 처리에 사용되지 않습니다. 업데이트에 실패하면 기본 구독과 모음 리소스의 로그를 구분해 확인하고 형식, 경로, 업데이트 간격, 로컬 캐시를 점검하세요.

Clash 다운로드