mihomo
mihomo는 설정을 해석하고 규칙을 매칭해 아웃바운드 연결을 만드는 프록시 커널입니다. 클라이언트 UI는 파일 가져오기와 설정 전환을 담당하고, 실제 설정을 실행하는 것은 커널입니다. 인식되지 않는 필드가 있으면 앱 버전만 보지 말고 실제 실행 중인 커널 버전을 확인하세요.
Clash / mihomo · 용어 색인
클라이언트 화면이나 YAML 필드에 나오는 용어를 찾아보세요. 라우팅 결과가 예상과 다르면 먼저 트래픽이 가로채졌는지, 어떤 규칙과 일치했는지, 해당 규칙의 프록시 그룹이 최종적으로 어떤 출구를 선택했는지 확인하세요.
mihomomihomo는 설정을 해석하고 규칙을 매칭해 아웃바운드 연결을 만드는 프록시 커널입니다. 클라이언트 UI는 파일 가져오기와 설정 전환을 담당하고, 실제 설정을 실행하는 것은 커널입니다. 인식되지 않는 필드가 있으면 앱 버전만 보지 말고 실제 실행 중인 커널 버전을 확인하세요.
노드는 설정에 정의된 프록시 출구로, 일반적으로 프로토콜, 서버 주소, 포트와 해당 프로토콜에 필요한 매개변수를 포함합니다. proxies에 노드를 직접 나열할 수 있으며, 프록시 그룹은 후보 출구 중 하나를 선택하는 역할만 합니다. 표시 이름은 참조에 사용할 수 있지만, 노드의 연결 가능 여부나 프로토콜을 판단하는 근거는 아닙니다.
프록시 프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 정합니다. 노드의 type에 따라 나머지 필드의 해석 방식이 달라지므로, 프로토콜을 바꿀 때 이름만 수정해서는 안 되며 서버가 지원하는 매개변수 세트를 사용해야 합니다. 로컬 앱이 프록시에 연결할 때 쓰는 프로토콜과 커널이 원격 노드에 연결할 때 쓰는 프로토콜은 서로 다를 수 있습니다.
패널에 표시되는 밀리초 값은 대개 지정된 URL로 한 번 테스트한 결과이며, 모든 목적지까지의 왕복 시간은 아닙니다. 테스트 주소, 시간 초과 설정, 연결 재사용 방식이 다르면 값을 직접 비교하기 어렵습니다. 다운로드 속도와 지속적인 안정성은 별도로 테스트해야 하며, 한 번 테스트가 시간 초과됐다고 모든 접속이 실패하는 것은 아닙니다.
구독은 클라이언트가 설정을 주기적으로 가져오는 소스로, 보통 링크를 통해 추가합니다. 응답에는 전체 설정이 들어 있을 수도 있고 노드 목록만 포함될 수도 있습니다. 바로 사용할 수 있는지는 응답 형식과 클라이언트 지원 여부에 따라 다릅니다. 구독 링크에 접근 자격 증명이 포함될 수 있으므로 가져오기 문제를 문의할 때 전체 링크를 공개하지 마세요.
YAMLYAML은 들여쓰기로 계층을 나타내고 키-값 쌍과 시퀀스로 데이터를 구성합니다. 예를 들어 dns: 아래 들여쓴 enable:은 DNS 설정이며 최상위 스위치가 아닙니다. 들여쓰기에는 공백을 사용하세요. 문법 검사를 통과한 뒤에도 필드 이름, 계층, 값 형식이 커널 요구사항에 맞는지 확인해야 합니다.
proxy-providersproxy-providers는 제공자별로 노드를 구성하며, 원격 주소나 로컬 파일을 소스로 사용할 수 있습니다. 프록시 그룹에서 use로 제공자를 참조하므로 노드 목록이 갱신될 때 그룹의 후보 항목을 하나씩 다시 작성할 필요가 없는 경우가 많습니다. 제공자 갱신은 성공했는데 그룹에 노드가 없다면 참조 이름과 필터 조건을 확인하세요.
오버라이드는 구독 원본과 별도로 로컬 변경 사항을 저장합니다. 예를 들어 DNS 필드를 수정하거나 구독 규칙 앞에 예외 규칙을 추가할 수 있습니다. 같은 이름의 필드를 덮어쓰기, 목록 끝에 추가하기, 목록 앞에 삽입하기는 서로 다른 작업이며, 구체적인 동작은 클라이언트에 따라 달라집니다. 구독을 갱신한 뒤에는 병합 결과를 확인해 변경 사항이 필요한 계층과 순서에 남아 있는지 살펴보세요.
proxy-groups프록시 그룹은 후보 노드, 내장 출구 또는 다른 그룹을 하나의 이름으로 묶어 규칙에서 참조할 수 있게 합니다. select는 사용자가 직접 선택하고, fallback은 후보 순서에 따라 사용 가능한 항목을 우선 사용합니다. 규칙이 그룹 이름과 일치하더라도 실제 연결 경로를 확인하려면 해당 그룹에서 현재 선택된 출구를 살펴봐야 합니다.
url-testurl-test는 지정한 URL로 후보 출구를 테스트하고 지연 시간에 따라 경로를 선택합니다. interval은 테스트 간격을 지정하고, tolerance는 작은 지연 시간 차이로 잦은 전환이 일어나지 않도록 합니다. 테스트 대상에 대한 응답을 측정하는 기능이므로, 선택된 출구가 다른 사이트에서도 더 빠르다고 보장하지는 않습니다.
mode: rule에서는 커널이 rules를 순서대로 확인하며, 일반적으로 처음 일치한 규칙이 이후 처리 방식을 결정합니다. DOMAIN-SUFFIX는 지정된 도메인과 그 하위 도메인에 일치합니다. 특정 하위 도메인을 다르게 처리해야 한다면 범위가 더 넓은 규칙보다 구체적인 규칙을 앞에 두세요.
GeoIPGEOIP는 IP 데이터 세트를 기준으로 국가나 지역 코드 등 목적지 주소의 범주를 판별합니다. 도메인 접미사를 확인하는 방식이 아니며, 조회 결과만으로 서비스의 소유자를 증명할 수도 없습니다. 연결 대상이 도메인인 경우 규칙 적용을 위해 먼저 주소를 해석해야 할 수 있습니다. no-resolve를 사용하면 이 규칙만을 위해 주소를 조회하지 않습니다.
MATCHMATCH는 앞선 규칙에서 처리하지 않은 연결과 일치합니다. 흔히 MATCH,DIRECT처럼 작성합니다. 보통 규칙 목록의 마지막에 둡니다. 앞쪽에 배치하면 이후 규칙은 이미 이 규칙과 일치한 연결을 처리할 수 없습니다. 예상치 않게 기본 규칙이 적용되면 앞선 규칙과 로그에 표시된 대상 도메인 또는 IP를 먼저 확인하세요.
Fake-IPdns.enhanced-mode: fake-ip를 설정하면 커널이 조건에 맞는 DNS 요청에 합성 주소를 반환하고 도메인과 주소의 매핑을 저장합니다. 이후 연결을 가로챌 때 이 정보를 사용해 도메인을 복원하고 규칙을 매칭할 수 있습니다. 실제 주소가 필요한 로컬 네트워크 서비스나 앱은 필요에 따라 fake-ip-filter로 제외할 수 있습니다.
DNS 누출은 DNS 쿼리가 예상하지 않은 경로로 전달되는 현상입니다. 예를 들어 웹 연결은 프록시를 통하지만 DNS 쿼리는 로컬 네트워크의 DNS 서버에서 처리될 수 있습니다. 누출 여부는 미리 정한 DNS 처리 경로에 따라 판단해야 하며, 검사 페이지에 표시된 국가나 지역으로 결정되지 않습니다. 문제를 확인할 때는 브라우저의 보안 DNS, 시스템 DNS 서버, 커널이 사용하는 상위 DNS 서버를 각각 점검하세요.
tun.enable: true는 TUN을 활성화하는 설정입니다. 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 가로채며, 시스템 프록시 설정을 따르지 않는 일부 앱에도 적용할 수 있습니다. 단, 실제 적용 범위는 시스템 권한, 라우팅 규칙, 제외 항목에 따라 제한됩니다. 활성화한 뒤에도 대상 트래픽과 DNS 쿼리가 모두 예상대로 처리되는지 각각 확인해야 합니다.
mixed-portmixed-port는 하나의 수신 포트에서 HTTP와 SOCKS 프록시 요청을 모두 받습니다. 7890은 흔히 사용하는 예시일 뿐, 모든 클라이언트의 기본값은 아닙니다. 앱에는 현재 실제로 수신 중인 포트를 입력해야 합니다. 다른 기기에서 연결할 경우 allow-lan, 수신 주소, 방화벽 설정도 확인하세요.
GUI그래픽 클라이언트는 설정 가져오기, 프록시 선택, 로그 확인 등의 화면을 제공합니다. 커널을 앱에 내장하거나 별도의 커널 프로세스를 관리할 수 있습니다. 같은 종류의 커널을 사용하더라도 클라이언트마다 오버라이드 문법, 메뉴 위치, 시스템 연동 기능이 다를 수 있습니다. 클라이언트를 고를 때는 먼저 플랫폼 지원 여부를 확인한 뒤 실제 필요한 기능을 비교하세요.
시스템 프록시 설정은 이를 따르는 앱에 프록시 주소와 포트를 제공하지만, 트래픽을 가로채는 라우팅을 설치하지는 않습니다. 시스템 프록시를 읽지 않는 앱은 직접 연결하거나 앱에서 별도로 지정한 프록시를 사용할 수 있습니다. 클라이언트를 종료한 뒤에도 시스템 프록시가 로컬 포트를 가리키고 해당 포트의 수신이 중단되면, 시스템 설정을 따르는 앱은 인터넷에 연결되지 않을 수 있습니다.
x64, amd64, x86_64는 보통 같은 64비트 x86 아키텍처를 가리키며, arm64와 aarch64는 보통 64비트 ARM을 뜻합니다. 다운로드 전에 운영체제, 아키텍처, 설치 파일 형식을 모두 확인하세요. 같은 클라이언트에 여러 빌드가 있다면 시스템에 맞는 네이티브 빌드를 선택하는 것이 좋습니다.