mihomo 커널
mihomo / Clash Meta설정을 읽고 규칙을 매칭하며 프록시 연결을 수립하고 DNS를 처리하는 네트워크 커널입니다. Clash Meta의 기술적 방향을 이어받았습니다. GUI 클라이언트는 보통 별도의 설정 인터페이스를 제공하지만, 사용할 수 있는 프로토콜과 필드는 커널 기능에 따라 결정됩니다. 호환성 문제를 해결할 때는 클라이언트 버전과 커널 버전을 따로 기록하세요. 앱 이름만으로 판단해서는 안 됩니다.
설정 읽기 참고
Clash 용어 정리
커널, 프로토콜, 규칙, DNS를 살펴보세요. 설정에 나온 명칭을 찾아 의미를 확인한 뒤 어느 계층을 조정할지 판단할 수 있습니다.
이 페이지는 mihomo에서 흔히 사용하는 설정을 기준으로 설명합니다. 클라이언트마다 버튼 이름이 다를 수 있으며, 지원되는 필드는 사용 중인 커널에 따라 달라집니다. 처음 설정한다면 구독 가져오기 가이드를 먼저 읽고, 연결에 문제가 있으면 문제 해결 가이드를 확인하세요.
개념 6개 분야
용어 24개
필드명 대조
커널과 클라이언트
네트워크 처리를 담당하는 커널, 조작 인터페이스를 제공하는 클라이언트, 가져온 설정 내용을 먼저 구분하세요.
클라이언트
GUI client구독 관리, 모드 전환, 로그 확인, 시스템 연동 기능을 제공하는 애플리케이션입니다. Clash Verge Rev 등이 이에 해당합니다. 클라이언트마다 비슷한 커널을 사용하더라도 메뉴 이름, 설정 디렉터리, 서비스 관리 방식은 다를 수 있습니다. 클라이언트를 업그레이드해도 커널까지 업그레이드되는 것은 아닙니다. 가이드를 참고하기 전에 앱 이름과 사용 중인 커널을 확인하세요.
구독
subscription하나의 주소로 노드나 전체 설정을 가져와 주기적으로 업데이트하는 배포 방식입니다. 전체 구독에는 정책 그룹, 규칙, DNS 설정이 함께 포함될 수 있어 업데이트 후 노드 목록 외의 항목도 바뀔 수 있습니다. 접근 정보가 포함된 구독 링크는 안전하게 보관하고, 스크린샷이나 로그를 공유할 때는 주소를 가리세요. 로컬에서 수정한 내용은 업데이트로 덮어쓰이지 않도록 클라이언트가 지원하는 오버라이드 위치에 저장해야 합니다.
노드
proxy / outbound클라이언트에 저장된 프록시 연결 정보입니다. 보통 프로토콜, 서버 주소, 포트, 인증 정보가 포함됩니다. 노드 이름은 알아보기 쉽게 붙인 표시에 불과하므로 이름만으로 서버 위치나 연결 품질을 판단할 수 없습니다. 노드를 선택할 수 있어도 인증과 네트워크 연결이 성공했다는 뜻은 아닙니다. 실제 접속 결과와 로그의 연결 오류를 함께 확인하세요.
프록시 프로토콜
프로토콜 이름은 통신 방식을 나타낼 뿐 속도를 직접 보장하지 않습니다. 서버 설정, 전송 계층, 네트워크 환경도 중요합니다.
Shadowsocks
type: ss암호화 프록시 프로토콜로, mihomo 설정에서는 보통 ss 유형을 사용합니다. 서버 주소, 포트, 암호화 방식, 비밀번호가 서버 측 설정과 일치해야 하며 연결에 따라 추가 플러그인 매개변수가 필요할 수 있습니다. UDP 사용 가능 여부는 양쪽 설정을 확인해야 합니다. 웹 페이지가 열린다고 해서 게임이나 다른 UDP 앱도 연결된다는 뜻은 아닙니다.
VMess
type: vmessUUID 등의 정보로 인증하는 프록시 프로토콜이며 다양한 전송 방식 및 TLS 설정과 함께 사용할 수 있습니다. 노드를 가져올 때 서버와 포트뿐 아니라 WebSocket 경로, Host, 서버 이름 등의 매개변수가 모두 있는지 확인하세요. 프로토콜 이름만 바꿔 다른 유형의 노드를 VMess로 변환할 수는 없습니다. 서버도 해당 연결 방식을 지원해야 합니다.
VLESS
type: vless인증과 전달 과정을 간소화한 프록시 프로토콜로, 자체적으로 전송 내용을 암호화하지 않습니다. 실제 연결은 TLS, REALITY, 전송 방식 등의 관련 매개변수를 함께 고려해야 합니다. VLESS라는 이름 자체가 암호화를 보장하는 것은 아닙니다. 가져오기에 실패하면 먼저 커널이 해당 조합을 지원하는지 확인한 뒤 UUID, 서버 이름, 핸드셰이크 매개변수를 점검하세요.
Trojan
type: trojan일반적으로 TLS로 연결하고 비밀번호로 인증하는 프록시 프로토콜입니다. 비밀번호가 맞더라도 서버 이름이나 인증서가 일치하지 않으면 핸드셰이크 단계에서 연결이 실패할 수 있습니다. 시스템 시간, 서버 이름, 인증서 오류를 함께 확인하세요. 인증서 검증을 건너뛰는 방법은 서버 신원 확인을 약화하므로 일반적인 해결책으로 사용하지 않는 것이 좋습니다.
규칙과 라우팅
규칙은 연결이 어디로 향할지 결정합니다. 설정이 올바른지뿐 아니라 현재 모드에서 규칙이 적용되는지도 확인해야 합니다.
규칙 기반 라우팅
rules / rule mode도메인, 대상 IP 등의 조건에 따라 연결의 출구를 직접 연결, 프록시, 차단 등으로 선택하는 방식입니다. 규칙은 보통 위에서 아래로 매칭되며 먼저 일치한 규칙이 정책을 결정합니다. 따라서 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 라우팅이 적용됐는지 확인할 때는 현재 선택한 노드만 보지 말고 연결 기록에서 일치한 규칙과 최종 출구를 확인하세요.
GeoIP
GEOIPIP 주소의 지역 정보를 기준으로 매칭하는 데이터 및 규칙 방식으로, 지역별 라우팅에 자주 사용됩니다. 데이터베이스의 IP 위치 정보는 회사 등록 국가나 서비스 이용 가능 지역과 다를 수 있으며 데이터베이스 업데이트나 CDN의 영향도 받습니다. 도메인을 대상으로 할 때는 IP 매칭에 DNS 조회가 관여할 수 있으므로 DNS 결과와 규칙 순서도 함께 확인하세요.
RULE-SET
RULE-SET,그룹 이름,출구규칙 목록에서 외부 규칙 모음을 참조하는 규칙 유형입니다. 그룹 이름은 rule-providers에 선언된 이름과 일치해야 합니다. 규칙 모음을 사용하면 많은 항목을 기본 설정에서 분리해 별도로 관리하고 업데이트할 수 있습니다. 참조가 성공해도 규칙이 반드시 적용되는 것은 아니므로 파싱 방식, 파일 형식, 기본 규칙 목록에서의 위치를 확인하세요.
MATCH
MATCH,출구추가 조건 없이 앞선 규칙에 일치하지 않은 연결을 처리하는 기본 규칙으로, 보통 rules 목록 맨 끝에 둡니다. 대상은 정책 그룹이나 DIRECT 같은 내장 출구로 지정할 수 있습니다. 목록 앞부분에 배치하면 뒤의 규칙이 연결을 처리할 기회가 거의 없습니다. 모든 트래픽이 같은 출구로 나갈 때는 먼저 이 규칙의 위치를 확인하세요.
정책 그룹
정책 그룹은 선택 가능한 출구를 묶어 관리합니다. 수동 선택, 응답 시간에 따른 자동 선택, 순서대로 대체, 연결 분배는 서로 다른 동작입니다.
수동 선택
type: select사용자가 그룹에서 구성원 하나를 직접 고르는 정책 그룹 유형입니다. 구성원은 노드나 다른 정책 그룹일 수 있습니다. 연결이 실제로 해당 그룹을 참조할 때만 선택 결과가 적용되므로 노드를 바꿨는데 출구가 그대로라고 해서 반드시 선택에 실패한 것은 아닙니다. 일치한 규칙에서 그룹 참조를 따라 확인하고 새 연결로 테스트하세요. 기존 연결은 이전 출구를 계속 사용할 수 있습니다.
자동 선택과 지연 시간
type: url-test테스트 주소에 주기적으로 연결해 후보 구성원의 응답을 비교하고 출구를 자동 선택합니다. 화면에 표시되는 지연 시간은 보통 테스트 대상의 응답 시간을 뜻하며 파일 다운로드 속도나 모든 웹사이트에서의 체감 품질과는 다릅니다. interval은 테스트 간격을 설정하고, tolerance는 응답 차이가 작을 때 잦은 전환을 줄이는 데 사용됩니다.
장애 조치
type: fallback구성원 목록 순서대로 사용 가능한 출구를 우선 사용하며, 앞의 구성원을 사용할 수 없으면 다음 구성원을 선택합니다. 항상 응답이 가장 빠른 노드를 고르는 것이 아니라 지정된 우선순위를 따르므로 기본 회선을 정해 두고 싶은 설정에 적합합니다. 테스트 주소에 연결할 수 있다는 것은 해당 테스트가 통과했다는 뜻일 뿐입니다. 실제 서비스는 대상 사이트의 제한을 받을 수 있으므로 대체 출구도 직접 접속해 확인하세요.
로드 밸런싱
type: load-balance지정된 방식에 따라 서로 다른 연결을 그룹 내 사용 가능한 구성원에 분배합니다. 하나의 연결에 여러 노드의 대역폭을 합치는 기능은 아닙니다. 일부 방식은 같은 대상에 동일한 출구를 유지하고, 다른 방식은 구성원 간 연결을 번갈아 분배합니다. 로그인 상태를 안정적으로 유지해야 하는 서비스라면 출구 변경의 영향을 고려하세요. 구성원이 많다고 사용 경험이 반드시 좋아지는 것은 아닙니다.
DNS와 네트워크 스택
도메인 조회, 트래픽 가로채기, 실제 출구 경로를 구분해서 확인하세요. 스위치 하나를 켜는 것만으로 전체 연결 경로를 점검할 수는 없습니다.
DNS
Domain Name System도메인을 IP 주소 등의 레코드로 변환하는 시스템으로, 대부분의 네트워크 연결에서 기본적으로 사용됩니다. 프록시 서버의 도메인 조회, 서비스 도메인 조회, DNS 요청의 출구 경로는 서로 다른 설정을 사용할 수 있습니다. 브라우저가 자체 암호화 DNS를 사용하는 경우도 있습니다. 특정 앱에서만 사이트가 열리지 않는다면 앱과 커널의 DNS 설정을 따로 확인하세요.
Fake-IP
enhanced-mode: fake-ip커널이 도메인에 가상 주소를 할당하고 매핑을 저장하는 DNS 기능으로, 연결이 커널에 전달된 뒤 도메인을 복원해 라우팅하는 데 유용합니다. 앱이 받은 가상 주소는 웹사이트의 실제 서버 주소가 아니므로 사이트의 위치를 판단하는 데 사용할 수 없습니다. 실제 주소가 필요한 LAN 서비스나 앱에 문제가 생기면 DNS 기능 전체를 끄기보다 해당 문제에 맞는 필터 설정을 검토하세요.
DNS 누수
DNS leak지정된 경로로 처리해야 할 도메인 조회가 예상하지 못한 DNS 경로를 통해 이루어지는 현상입니다. 일부 도메인을 로컬에서 조회하도록 설계했다면 모든 직접 DNS 조회가 누수인 것은 아닙니다. 판단에 앞서 보호하려는 대상을 정하고 시스템 DNS, 브라우저의 암호화 DNS, IPv6, 커널이 트래픽을 가로채는 범위를 확인하세요. 테스트 페이지에 표시된 지역만으로 결론을 내리면 안 됩니다.
TUN 모드
virtual network interface가상 네트워크 인터페이스와 라우팅으로 트래픽을 가로채는 방식으로, 시스템 프록시 설정을 따르지 않는 프로그램을 처리할 때 자주 사용합니다. 필요한 권한이나 서비스가 있어야 하며 실제 적용 범위는 라우팅, DNS 가로채기, 커널 설정에 따라 달라집니다. TUN 모드가 곧 글로벌 모드인 것은 아닙니다. 트래픽이 커널에 들어온 뒤에도 규칙에 따라 라우팅할 수 있습니다. 활성화 후 인터넷이 끊기면 먼저 라우팅 충돌과 DNS 경로를 확인하세요.
설정 파일 필드
노드 정의, 정책 그룹 구성, 규칙 참조는 각각 설정 위치가 다릅니다. 이름이 정확히 맞아야 전체 연결 흐름이 제대로 구성됩니다.
YAML
config.yamlmihomo 설정에 널리 쓰이는 구조화된 텍스트 형식입니다. 들여쓰기는 계층을, 하이픈은 목록 항목을 나타냅니다. 편집할 때는 공백 들여쓰기를 일관되게 유지하고 탭을 섞지 마세요. 특수 문자가 포함된 값은 문법에 맞게 따옴표로 감쌀 수 있습니다. YAML 파싱에 성공했다는 것은 기본 구조가 올바르다는 뜻일 뿐, 현재 커널이 필드를 지원하거나 노드 인증 정보가 정확하다는 뜻은 아닙니다.
proxies
프록시 출구 목록기본 설정에서 프록시 출구를 정의하는 목록 필드입니다. 각 항목에는 보통 name, type, 프로토콜에 필요한 연결 정보가 들어갑니다. 정책 그룹이나 규칙에서 노드를 참조할 때 이름이 일치해야 하며, 이름이 중복되면 혼동이 생길 수 있습니다. 외부 노드 제공자를 사용하는 설정은 다른 파일에 구성원이 있을 수 있으므로 기본 설정에 노드 항목이 적다고 해서 누락된 것은 아닙니다.
proxy-groups
정책 그룹 정의 목록정책 그룹의 이름, 유형, 후보 구성원을 정의하는 목록 필드로 규칙과 노드를 연결하는 역할을 합니다. 그룹 구성원은 proxies로 지정하거나 설정 방식에 따라 노드 제공자를 참조할 수 있습니다. 규칙의 그룹 이름은 정의와 일치해야 하며 그룹끼리 순환 참조하지 않도록 주의하세요. 이름을 바꿀 때는 화면에 표시되는 이름만 수정하지 말고 모든 참조 위치를 확인해야 합니다.
rule-providers
외부 규칙 모음 선언외부 규칙 모음의 출처, 파싱 방식, 파일 형식, 저장 위치, 업데이트 방법을 선언합니다. 규칙 모음을 선언한 뒤 rules에서 RULE-SET으로 참조해야 연결 매칭에 사용됩니다. 업데이트에 실패하면 다운로드 로그와 로컬 파일 상태를 확인하세요. 파일이 있는데도 규칙이 적용되지 않는다면 파싱 방식과 기본 규칙의 순서를 점검해야 합니다.