mihomo
Proxy core
Clash Meta 프로젝트를 이어받은 프록시 커널로, 연결 처리와 규칙 매칭, DNS 및 다양한 프로토콜 구현을 담당합니다. GUI 클라이언트는 설정 파일과 제어 인터페이스를 통해 커널을 호출합니다. 창의 레이아웃은 커널 기능이 아닙니다. 특정 필드의 사용 가능 여부는 클라이언트 이름만 볼 것이 아니라 현재 실행 중인 커널 버전과 문서를 확인해야 합니다.
설정 참고 / 용어 설명
Clash 용어 정리
커널, 프로토콜, 규칙, 구독 관련 용어를 정리했습니다. 설정 상황별로 의미를 확인하고 인터페이스 옵션, 연결 매개변수, 실제 적용 범위를 구분해 보세요.
처음 설정한다면 사용 가이드를 먼저 확인하세요. 프로토콜과 커널 기능을 비교하려면 프로토콜 참고 자료를 살펴보세요. 아래 용어 제목의 링크를 복사하면 해당 설명으로 바로 이동할 수 있습니다.
CORE / CLIENT
커널 및 클라이언트
먼저 연결을 처리하는 주체를 파악한 다음, 설정이 어느 계층에 적용되는지 확인하세요. 클라이언트 이름과 커널 이름은 서로 바꿔 쓸 수 없습니다.
Clash Meta
Historical project name
mihomo 프로젝트의 이전 이름으로, 일부 클라이언트와 구독 안내, 오래된 튜토리얼에서 여전히 사용됩니다. Meta 설정은 보통 해당 커널 계열의 확장 기능을 사용하는 Clash 형식의 YAML을 뜻하며, 별도의 파일 형식은 아닙니다. 원본 커널이 새 프로토콜이나 필드를 인식하지 못할 수 있으므로, 이전할 때 호환성을 확인해야 합니다.
GUI 클라이언트
Graphical user interface · GUI
구독 가져오기, 정책 선택, 시스템 설정, 로그 확인 기능을 제공하는 앱입니다. 예를 들어 Clash Verge Rev가 있습니다. 클라이언트는 작업을 커널 설정으로 변환하며, 서비스 권한과 시작 작업, 설정 오버라이드도 관리할 수 있습니다. 인터페이스에 옵션이 표시된다고 해서 현재 운영체제와 커널 버전, 권한이 사용 조건을 충족한다는 뜻은 아닙니다.
시스템 프록시
System proxy
운영체제의 프록시 설정을 클라이언트의 로컬 리스닝 주소로 지정해, 해당 설정을 따르는 앱의 요청을 커널에 전달합니다. 시스템 전체 트래픽을 처리하는 단일 진입점은 아닙니다. 일부 명령줄 도구, 게임, 독립 네트워크 프로그램은 이 설정을 무시할 수 있습니다. 특정 프로그램이 프록시를 거치지 않는다면 먼저 해당 프로그램의 프록시 지원 방식을 확인한 뒤 별도 설정이나 TUN 모드를 고려하세요.
TUN 모드
Virtual network interface
가상 네트워크 인터페이스로 IP 패킷을 받아 커널에서 연결 처리와 라우팅을 수행하는 방식입니다. 시스템 프록시를 따르지 않는 일부 앱에도 적용할 수 있지만, 실제 범위는 라우팅, 제외 항목, 권한, DNS 설정에 따라 달라집니다. 켠 뒤에는 서비스 상태와 연결 경로를 확인해야 합니다. 스위치가 켜져 있다는 사실만으로 트래픽이 커널에 전달된다고 볼 수는 없습니다.
TRANSPORT / AUTHENTICATION
프록시 프로토콜
프로토콜은 클라이언트와 서버의 통신 방식을 결정합니다. 주소, 인증 정보, 전송 계층, 보안 계층을 함께 맞춰야 하며, 프로토콜 이름만으로 속도를 판단할 수는 없습니다.
Shadowsocks
Shadowsocks · SS
일반적으로 SS라고 줄여 부르는 암호화 프록시 프로토콜입니다. 설정에는 보통 서버 주소, 포트, 암호화 방식, 비밀번호가 포함됩니다. 클라이언트와 서버에서 호환되는 방식을 사용해야 합니다. 이름에 Shadowsocks가 적혀 있다고 해서 어떤 매개변수든 서로 호환되는 것은 아닙니다. 제공업체에서 플러그인이나 특정 프로토콜 버전을 요구하면 현재 커널의 지원 여부도 확인해야 합니다.
VMess
VMess protocol
V2Ray 생태계에서 비롯된 프록시 프로토콜로, UUID 등의 매개변수로 사용자를 식별합니다. 시스템 시간이 크게 어긋나면 인증에 영향을 줄 수 있습니다. VMess는 프로토콜 종류이고 WebSocket 등은 전송 방식이므로 서로 대체할 수 있는 옵션이 아닙니다. 가져온 뒤 핸드셰이크가 실패한다면 인증 정보, 전송 경로, TLS 설정, 기기 시간을 각각 확인하세요.
VLESS
VLESS protocol
V2Ray 생태계에서 비롯된 경량 프록시 프로토콜로, 자체적으로 페이로드를 암호화하지 않으며 실제 구성에서는 보통 TLS나 REALITY 같은 보안 계층을 함께 사용합니다. UUID는 설정의 일부일 뿐이므로 전송 방식, 서버 이름, 관련 보안 매개변수도 맞춰야 합니다. 특정 전송 방식이나 보안 계층의 지원 여부만으로 모든 VLESS 설정을 사용할 수 있다고 단정해서는 안 됩니다.
Trojan
TLS-based proxy protocol
일반적으로 TLS로 연결을 보호하고 비밀번호로 인증하는 프록시 프로토콜입니다. 연결 문제를 확인할 때는 서버 주소, 비밀번호, 서버 이름, 인증서 신뢰 여부를 각각 살펴봐야 합니다. 포트 번호만으로 설정이 올바른지 판단할 수는 없습니다. 인증서 오류가 발생하면 도메인, 시스템 시간, 인증서 체인을 먼저 확인하세요. 인증서 검증을 건너뛰는 방법을 일반적인 해결책으로 사용해서는 안 됩니다.
Hysteria2
QUIC-based proxy protocol
QUIC 기반 프록시 프로토콜로, 하위 계층에서 UDP를 사용합니다. 사용 가능 여부는 네트워크의 UDP 지원, 패킷 손실, 서버 설정에 따라 달라집니다. 설정의 대역폭 매개변수는 전송 동작에 영향을 주지만 실제 다운로드 속도를 보장하지는 않습니다. 현재 네트워크에서 UDP를 제한하면 인증 정보가 정확해도 연결이 성립하지 않을 수 있으므로, 네트워크 경로 문제와 매개변수 문제를 먼저 구분해야 합니다.
TUIC
QUIC-based proxy protocol
QUIC 기반 프록시 프로토콜로, 연결 다중화와 UDP 전달 등의 기능을 제공합니다. 프로토콜 버전에 따라 인증 항목과 구현 세부 사항이 다를 수 있으므로 프로토콜 이름만 바꾸지 말고 서버가 제공한 전체 매개변수를 가져와야 합니다. 모바일 기기의 배터리 사용량은 연결 활성도, 네트워크 전환, 앱 동작에도 영향을 받으므로 TUIC 등의 프로토콜 이름만으로 고정적인 순위를 매길 수 없습니다.
RULES / POLICY
규칙 및 라우팅
규칙은 사용할 정책을 선택하고, 정책 그룹은 트래픽을 내보낼 경로를 선택합니다. 이 두 단계의 관계를 이해해야 노드를 바꿨을 때 어떤 연결이 달라지는지 판단할 수 있습니다.
규칙 기반 라우팅
Rule-based routing
규칙 모드에서는 대상 도메인, IP 또는 다른 조건에 따라 연결에 적용할 정책을 결정합니다. 규칙은 위에서 아래로 확인하며 보통 일치하는 규칙을 찾으면 처리를 멈춥니다. 따라서 구체적인 예외 규칙을 포괄적인 규칙보다 앞에 두세요. 예를 들어 DOMAIN-SUFFIX,github.com,Proxy는 해당 도메인 연결을 Proxy라는 정책으로 전달합니다. 이 정책이 설정에 실제로 존재해야 합니다.
정책 그룹
Proxy group
노드, 다른 정책 그룹 또는 내장 정책으로 구성된 집합으로, 규칙에서 대상으로 참조할 수 있습니다. select는 직접 선택하고, url-test는 테스트 결과에 따라 선택하며, fallback은 사용 가능 여부와 설정 순서에 따라 처리합니다. 그룹 내 항목을 바꾸면 보통 새 연결에 주로 영향을 줍니다. 기존 장기 연결은 이전 경로를 계속 사용할 수 있으며, 이전 연결을 종료할지는 클라이언트 동작에 따라 다릅니다.
노드
Proxy endpoint
클라이언트에서 프록시 서버 연결 매개변수 묶음을 흔히 부르는 이름으로, 보통 주소, 포트, 프로토콜, 인증 정보가 포함됩니다. 표시 이름은 구분을 위한 레이블일 뿐, 서버 위치나 회선 품질, 사용 범위를 증명하지 않습니다. 노드 테스트에 성공해도 모든 요청이 해당 노드를 이용한다는 뜻은 아닙니다. 실제 출구는 현재 모드와 일치한 규칙, 정책 그룹 선택을 함께 확인해야 합니다.
GeoIP
IP geolocation matching
IP 데이터베이스를 사용해 국가 또는 지역 코드로 대상 주소를 매칭하는 규칙 기능입니다. 예를 들어 GEOIP,CN,DIRECT와 같이 사용할 수 있습니다. 결과는 데이터베이스 내용에 따라 달라지며 기업 등록지 또는 사용자의 위치를 의미하지 않습니다. 대상이 처음에 도메인이라면 매칭 과정에서 DNS 조회가 관련될 수 있습니다. no-resolve가 포함된 규칙은 매칭을 위해 DNS 조회를 새로 시작하는 동작을 제한합니다.
MATCH
Final catch-all rule
매칭 조건 없이 앞선 규칙에 일치하지 않은 연결을 처리하는 기본 규칙입니다. 예를 들면 MATCH,Proxy와 같습니다. 보통 rules 목록의 마지막에 배치해야 합니다. 앞에 두면 뒤의 규칙이 나머지 연결을 처리할 수 없습니다. 기본 대상은 정책 그룹이나 내장 정책이 될 수 있으며, 실제 의미는 설정에 지정된 이름에 따라 달라집니다.
지연 시간 테스트
URL latency test
노드를 통해 지정된 테스트 주소에 요청을 보내고 소요 시간을 기록하는 방식이며, 보통 서버에 직접 ICMP 테스트를 하는 것은 아닙니다. 결과는 테스트 주소, 연결 재사용, DNS, 현재 네트워크 상태에 따라 달라지며 파일 다운로드 속도와 같지 않습니다. 테스트 한 번에 성공했다고 해서 다른 사이트나 UDP 앱, 이후 연결에서도 같은 결과가 보장되는 것은 아닙니다.
DNS / NETWORK STACK
DNS 및 네트워크 스택
도메인 조회와 연결 전달은 서로 관련되어 있지만 별개의 과정입니다. 문제를 확인할 때는 시스템, 브라우저, 커널을 함께 살펴봐야 하며 한 가지 설정만 확인해서는 안 됩니다.
DNS
Domain Name System
도메인을 IP 주소 등의 레코드로 변환하는 시스템으로, 여러 네트워크 연결을 시작하기 전에 거치는 단계입니다. 커널의 DNS 처리, 운영체제 리졸버, 브라우저의 보안 DNS는 서로 다른 경로를 사용할 수 있으므로 커널의 DNS 서버를 설정해도 모든 앱의 쿼리가 자동으로 처리되지는 않습니다. 도메인 접속은 실패하지만 주소를 직접 입력하면 정상일 경우 조회 결과와 캐시, 로그를 함께 확인해 문제를 찾아볼 수 있습니다.
Fake-IP
Synthetic IP mapping
도메인에 가상 주소를 반환하고 커널에 도메인과 주소의 매핑을 저장하는 DNS 처리 방식입니다. 이후 연결이 커널에 전달되면 매핑을 이용해 원래 도메인을 연결할 수 있습니다. 가상 주소는 웹사이트의 실제 서버 주소가 아닙니다. 실제 DNS 응답에 의존하는 일부 앱은 fake-ip-filter에 예외를 추가해야 할 수 있으므로, 실제 문제를 확인한 뒤 항목을 설정해야 합니다.
DNS 누수
DNS leak
DNS 쿼리가 예상한 경로로 전송되지 않고 다른 리졸버에 도달하는 현상입니다. 경로가 예상과 다른지 판단하려면 먼저 설정에서 의도한 DNS 정책을 확인해야 합니다. 시스템 DNS, 브라우저의 보안 DNS, IPv6, 트래픽 처리 설정, 실제 쿼리 기록을 함께 살펴보세요. 테스트 사이트에 표시된 리졸버의 지역은 참고 자료일 뿐이며, 그것만으로 결론을 내릴 수 없습니다. 직접 DNS 조회가 의도된 설정일 수도 있습니다.
도메인 스니핑
Domain sniffing
HTTP Host, TLS SNI 등의 연결 메타데이터에서 대상 도메인을 추출하는 기능입니다. IP만 포함된 연결도 도메인 규칙에 매칭할 수 있게 도와줍니다. HTTPS 본문을 복호화하는 기능은 아니며, 모든 프로토콜과 암호화 방식에서 도메인을 알아낼 수 있는 것도 아닙니다. 활성화 여부와 적용 범위는 DNS 모드, 설정 범위, 호환성 요구 사항을 고려해 결정해야 합니다.
SUBSCRIPTION / CONFIGURATION
구독 및 설정 파일
전체 설정, 노드 모음, 규칙 모음은 서로 다른 입력 형식입니다. 가져오기 전에 파일 구조를 확인하고, 업데이트 후에는 최종 적용 내용을 살펴보세요.
구독
Subscription
원격 주소에서 노드나 전체 설정을 가져오는 업데이트 소스입니다. 소스마다 반환하는 내용의 구조가 다를 수 있으므로 링크의 확장자만 보고 호환 여부를 판단할 수 없습니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으니 스크린샷, 로그, 문의 내용에 공개하지 않도록 주의하세요. 업데이트로 원본 파일이 교체될 수 있으므로, 계속 유지할 사용자 규칙은 원격 파일 사본을 직접 수정하기보다 클라이언트가 지원하는 오버라이드 방식으로 관리하는 것이 좋습니다.
YAML
YAML configuration format
설정의 계층 구조, 목록, 키와 값의 관계를 표현하는 텍스트 형식입니다. Clash 형식 설정은 보통 .yaml 또는 .yml 확장자를 사용합니다. 들여쓰기에는 공백을 사용하고 같은 계층에서는 일관되게 맞춰야 합니다. 특수 문자가 포함된 문자열은 따옴표도 확인하세요. 파일 분석에 성공했다는 것은 형식이 유효하다는 뜻일 뿐입니다. 필드 지원 여부와 정책 참조의 존재 여부는 커널에서 추가로 확인해야 합니다.
rule-providers
Rule providers
외부 규칙 세트의 소스를 지정하는 설정 항목으로, 필요에 따라 업데이트 간격, 콘텐츠 형식, 매칭 동작을 설정할 수 있습니다. 소스를 정의한 다음에는 rules에서 RULE-SET으로 참조해야 합니다. 다운로드에 성공했다고 규칙 세트가 자동으로 라우팅에 적용되는 것은 아닙니다. behavior와 형식이 일치해야 하며, 우선순위는 기본 규칙 목록에서 참조한 위치에 따라 결정됩니다.
proxy-providers
Proxy providers
프록시 노드 집합을 가져오는 설정 항목으로, 소스와 업데이트 간격, 상태 확인을 관리할 수 있습니다. 정책 그룹에서는 보통 해당 집합을 use로 참조합니다. 노드 소스를 관리하는 기능으로, proxies에 노드를 직접 나열하는 방식과는 다릅니다. 노드 집합만으로 완전한 클라이언트 설정이 되는 것은 아니며, 사용 가능한 설정을 구성하려면 정책 그룹과 규칙, 기타 설정도 필요합니다.
설정 오버라이드
Configuration override
클라이언트가 원본 설정을 기반으로 필드를 병합, 추가 또는 수정하는 방식으로, 개인 규칙이나 DNS, 리스닝 설정을 유지할 때 자주 사용합니다. 목록 교체와 규칙 삽입, 필드 병합 방식은 클라이언트마다 다르므로 오버라이드 조각만 보고 결과를 확정할 수 없습니다. 수정 후에는 최종 적용 설정을 확인하고 구독 업데이트 뒤에도 다시 검증해 필드 충돌이나 규칙 순서 변경이 없는지 살펴보세요.
문제별로 이어서 확인하기
- 첫 연결을 설정해야 한다면 구독 가져오기 및 프록시 적용 확인 단계를 읽어보세요.
- 프로토콜과 커널을 비교하려면 프로토콜 참고 자료 및 설정 호환성 안내를 읽어보세요.
- 설정이 적용되지 않는다면 도움말 센터에서 문제 유형별로 확인해 보세요.