mihomo 코어와 기본 Clash의 차이: 추가 프로토콜·규칙 세트·설정 문법 비교
mihomo(Clash Meta)와 기본 Clash의 차이를 비교합니다. 추가 프로토콜, rule-providers 설정, DNS 개선 사항, TUN 구현과 설정 마이그레이션 시 주의점을 확인하세요.
클라이언트, 코어, 구독부터 구분하기
여기서 기본 Clash는 오픈소스 기본 코어를 뜻하며, Clash Premium이나 클라이언트에 포함된 수정 버전은 포함하지 않습니다. 예전 가이드에서는 이들을 모두 Clash라고 부르는 경우가 많았습니다. 따라서 오래된 설정에 특정 필드가 있다고 해서 기본 코어가 해당 필드를 지원한다고 단정할 수는 없습니다. 특히 규칙 세트와 TUN은 별도로 확인해야 합니다. Premium에서 제공하던 일부 기능은 mihomo에도 구현되어 있지만 기본값과 사용 가능한 옵션이 다를 수 있습니다.
클라이언트는 구독 가져오기, 시스템 프록시 관리, 연결 정보 표시를 담당하고, 코어는 설정 해석, 아웃바운드 연결 생성, 규칙 매칭을 담당합니다. 먼저 클라이언트의 코어 정보나 시작 로그에서 코어 이름과 버전을 확인하세요. mihomo 바이너리를 직접 실행할 수 있다면 mihomo -v로 버전을 확인할 수 있습니다. 클라이언트 설치 파일의 버전은 코어 버전을 대신할 수 없으며, 구독 주소에 표시된 형식 이름만으로 올바른 필드가 출력됐다고 판단할 수도 없습니다.
추가 프로토콜: 유형과 전송 옵션 확인
| 노드 유형 | 마이그레이션 시 확인할 사항 |
|---|---|
ss | 두 코어 모두 Shadowsocks를 지원하더라도 암호화 방식과 플러그인 옵션이 현재 코어에서 지원되는지 확인해야 합니다. |
vless | UUID, 전송 방식, TLS 설정을 확인하세요. REALITY를 사용하는 노드는 reality-opts도 확인해야 합니다. VMess의 유형만 VLESS로 바꾸면 되는 것은 아닙니다. |
hysteria2 | hysteria와는 다른 프로토콜이므로 서버와 클라이언트의 프로토콜을 일치시켜야 합니다. 비밀번호, 인증서 이름, UDP 연결 가능 여부를 확인하세요. |
tuic | 클라이언트와 서버에서 사용하는 프로토콜 버전 및 인증 필드를 확인하고, 네트워크에서 서버의 UDP 포트에 접근할 수 있는지도 확인하세요. |
구독을 마이그레이션할 때는 먼저 mihomo용이라고 명시된 설정을 가져온 다음, 실제 적용된 설정의 proxies 또는 proxy-providers에서 내려받은 노드 목록을 확인하세요. 노드 표시 이름이 ‘HY2’여도 type: hysteria2를 대신할 수는 없습니다. 시작 로그에 알 수 없는 프록시 유형이 표시되면 코어와 구독 출력부터 확인하세요. 설정은 불러왔지만 핸드셰이크에 실패한다면 인증, 인증서, 전송 설정을 확인하세요. 두 오류를 혼동하지 마세요.
예를 들어 서버가 Hysteria2 연결을 443/UDP로 받는 경우, 같은 호스트의 HTTPS 페이지가 브라우저에서 열린다고 해서 해당 TCP 서비스에 접근할 수 있다는 사실만 확인될 뿐 UDP 경로가 정상이라는 뜻은 아닙니다. 진단할 때는 정상 작동이 확인된 TCP 노드를 비교 대상으로 두고, 같은 네트워크에서 동일한 테스트 대상에 접속해 보세요.
규칙 세트: 소스 선언과 규칙 참조를 구분하기
rules에 DOMAIN-SUFFIX를 작성할 수 있다고 해서 rule-providers도 불러올 수 있는 것은 아닙니다. mihomo에서는 rule-providers로 규칙 세트의 소스와 형식을 선언하고, RULE-SET으로 어느 위치에서 매칭할지와 일치 후 적용할 정책을 지정합니다. 아래 예시는 로컬 파일을 사용해 원격 다운로드 실패와 규칙 매칭 실패를 구분합니다.
rule-providers:
local-domains:
type: file
behavior: domain
format: yaml
path: ./rules/local-domains.yaml
rules:
- RULE-SET,local-domains,DIRECT
- MATCH,DIRECT
코어의 작업 디렉터리에서 rules/local-domains.yaml 파일을 만들고 다음 내용을 입력하세요. 클라이언트가 코어용 별도 작업 디렉터리를 사용할 수 있으므로 구독 파일이 있는 디렉터리와 같다고 단정하지 마세요.
payload:
- "example.com"
- "+.example.net"
behavior: domain은 도메인 매칭 항목에 사용합니다. 파일에DOMAIN-SUFFIX,example.net처럼 규칙 유형이 포함된 항목을 쓴다면 이에 맞는classical동작을 사용해야 합니다.- 원격 규칙 세트를 마이그레이션할 때는 소스,
behavior,format, 캐시 경로를 각각 확인하세요. YAML 파일의 확장자를.mrs로 바꿔도 파일 형식은 바뀌지 않습니다. mihomo의 MRS 규칙 세트는domain또는ipcidr동작에 사용됩니다. - 규칙은 작성된 순서대로 매칭됩니다. 예시의 두 규칙은 모두 직접 연결을 사용하므로, 확인할 때는 연결 상세 정보에서
RULE-SET과 마지막MATCH중 어느 규칙이 적용됐는지 구분하세요. 웹페이지가 열린다는 사실만으로 판단하면 안 됩니다.
DNS: 응답 주소, 조회 업스트림, 정책별 라우팅 구분하기
fake-ip는 mihomo에서 새로 추가된 개념이 아닙니다. 이 모드에서는 도메인에 매핑 주소를 반환하고, 애플리케이션 연결이 가로채지면 코어가 매핑을 통해 도메인을 찾아냅니다. 198.18.0.1/16은 흔히 사용하는 fake-ip-range 설정입니다. 애플리케이션이 매핑 주소를 받았지만 연결이 같은 코어를 통과하지 않으면 연결에 실패할 수 있습니다. 이때는 업스트림 DNS를 계속 바꾸기보다 먼저 트래픽이 가로채지는 경로를 확인하세요.
마이그레이션 시 조회 대상별로 설정 확인하기
nameserver는 일반 조회에 사용할 업스트림을 지정합니다.nameserver-policy를 사용하면 특정 도메인에 사용할 업스트림을 선택할 수 있습니다. DNS 조회에 사용할 업스트림을 지정하는 것과 실제 연결이 사용할 프록시를 지정하는 것은 서로 다른 설정입니다.proxy-server-nameserver는 프록시 노드 서버의 도메인 이름을 조회하는 데 사용합니다. 노드 주소가 도메인 이름이라면 아직 연결되지 않은 동일한 프록시 연결에 이 단계의 DNS 조회가 의존하지 않는지 확인하세요.fake-ip-filter를 사용하면 일치하는 이름에 실제 주소를 반환할 수 있습니다. 로컬 네트워크 앱에서 실제 주소가 필요한 경우 해당 이름부터 확인한 뒤 예외로 둘지 결정하세요. 광범위하게 제외하면 다른 도메인의 응답 방식도 달라집니다.
TUN: 라우팅 가로채기와 프록시 포트를 나눠 확인하기
시스템 프록시는 앱이 시스템의 프록시 설정을 읽어야 작동합니다. 예를 들어 앱이 로컬 127.0.0.1:7890의 mixed-port를 사용하면 트래픽은 프록시 수신 포트를 통해 코어로 들어갑니다. TUN은 가상 인터페이스와 시스템 라우팅을 사용해 시스템 프록시 설정을 읽지 않는 앱의 트래픽도 가로챌 수 있지만, 적용 범위는 라우팅, 권한, 클라이언트 구현에 따라 달라집니다. 이전 Premium 설정의 TUN 필드를 오픈소스 기본 코어에서 통용되는 설정으로 간주하지 마세요.
mihomo에서 tun.enable은 TUN 사용 여부를 제어하고, auto-route는 라우팅을 자동으로 설정합니다. stack은 환경에 따라 system, gvisor, mixed 중에서 선택할 수 있습니다. dns-hijack은 별도의 설정이며, 흔히 사용하는 any:53은 가로채기 경로로 들어오는 일반 DNS 요청을 대상으로 합니다. 이 설정만으로 앱 내부의 HTTPS DNS 조회까지 가로채진다고 볼 수는 없습니다. 설정을 불러오는 것과 시스템에서 인터페이스를 만드는 것은 별개의 확인 단계입니다. 후자는 클라이언트 로그와 시스템 라우팅 상태를 확인하세요.
먼저 브라우저에서 프록시 포트가 작동하는지 확인한 다음 TUN을 켜고 시스템 프록시를 끄세요. 프록시를 명시적으로 설정하지 않은 앱으로 알려진 대상에 연결해 봅니다. 연결 기록이 나타나지 않으면 인터페이스 권한과 라우팅부터 확인하세요. 기록은 있지만 예상과 다른 정책이 적용되면 규칙과 DNS를 살펴보세요. 이미 VPN이나 다른 TUN 도구를 사용 중이라면 가상 인터페이스 두 개가 동시에 기본 경로를 바꾸지 않도록 한 번에 하나씩 실행해 비교하세요.
설정 마이그레이션 순서와 롤백 기준
- 기존 설정을 보관하세요. 현재 사용하는 설정과 로컬 오버라이드를 백업하고, 수신 포트, 현재 선택된 정책 그룹, DNS 모드를 기록하세요. 새 코어와 기존 코어가 동시에
7890을 사용하지 않도록 하세요. 구독 주소에 액세스 토큰이 포함될 수 있으므로 로그를 공유하기 전에 주소와 노드 인증 정보를 삭제하세요. - 먼저 설정이 정상적으로 로드되는지 확인하세요. 별도의 테스트 디렉터리에서
mihomo -t -f config.yaml을 실행해 설정을 검사할 수 있습니다. 상대 경로로 규칙 파일을 지정했다면 검사할 때와 실제 실행할 때 작업 디렉터리 설정이 같은지 확인하세요. 검사를 통과해도 노드 핸드셰이크가 성공하거나 모든 플랫폼 기능을 사용할 수 있다는 뜻은 아닙니다. - 노드 하나와 대상 하나만 확인하세요. 먼저 TUN을 끄고 프록시 포트를 명시해 연결한 뒤, 연결 상세 정보에서 예상한 아웃바운드 노드가 사용됐는지 확인하세요. 프록시 그룹은 이름으로 대상을 참조합니다. 구독 업데이트로 노드 이름이 바뀌었다면 로컬 오버라이드의 참조를 다시 확인하세요.
- 규칙 세트, DNS, TUN을 차례로 복구하세요. 한 번에 한 항목만 변경하고 같은 테스트 대상을 비교 기준으로 유지하세요. TUN을 켠 뒤 로컬 네트워크까지 문제가 생기면 먼저 TUN을 끄고 기존 라우팅이 복구됐는지 확인한 다음 인터페이스와 DNS 변화를 비교하세요. 구독을 업데이트한 뒤에만 문제가 생겼다면 클라이언트를 재설치하기 전에 업데이트 전후의 적용 설정을 비교하세요.