· 코어 심화 · 읽는 시간 약 8분
mihomo와 기존 Clash 차이: 지원 프로토콜, 룰셋 및 설정 변경 사항
기존 Clash와 비교해 mihomo(Clash Meta)의 프로토콜, rule-providers, DNS, TUN 확장 사항과 기존 설정에서 수정할 부분을 정리합니다.
코어 버전 및 설정 호환 범위
Clash Meta는 mihomo의 이전 이름입니다. 기존 Clash와 비교할 때는 기존 오픈소스 코어와 별도로 배포된 Clash Premium을 구분해야 합니다. 룰셋과 TUN 기능이 mihomo에서 처음 추가된 것은 아닙니다. Premium에도 관련 기능이 있지만, Premium 설정을 기존 오픈소스 코어에서 그대로 쓸 수 있는 범용 설정으로 간주해서는 안 되며 모든 항목이 mihomo에서 똑같이 동작한다고 볼 수도 없습니다.
마이그레이션 전에 클라이언트가 실제로 실행하는 코어를 확인하세요. 클라이언트 버전과 코어 버전은 서로 다릅니다. 사용 중인 mihomo 실행 파일에 접근할 수 있다면 mihomo -v로 버전을 확인할 수 있습니다. 별도로 내려받은 바이너리의 이름이 같더라도 GUI 클라이언트에서 사용 중인 코어라는 뜻은 아닙니다.
| 설정 항목 | mihomo로 옮길 때 확인할 사항 |
|---|---|
mixed-port、mode | 기존 값을 우선 유지하세요. 클라이언트가 수신 포트나 실행 모드를 덮어쓰는 경우 실제 실행 시 적용된 값을 기준으로 확인하세요. |
proxies、proxy-groups、rules | 일반적인 설정 구조는 유지할 수 있습니다. 노드 유형, 그룹 멤버 이름, 규칙 대상은 하나씩 확인하세요. |
rule-providers、RULE-SET | 기존 설정이 Premium용이라면 불러오는 방식, 규칙 동작, 실제 매칭 순서를 확인하세요. |
dns、tun | 각 항목을 따로 옮기고 검증하세요. DNS 업스트림, 강화 모드, 시스템 라우팅을 한꺼번에 바꾸지 마세요. |
프로토콜 추가: 노드 유형과 전송 설정 확인
mihomo는 기존 Clash보다 더 다양한 아웃바운드 프로토콜을 지원합니다. 예를 들어 VLESS 노드는 type: vless, Hysteria 2는 type: hysteria2, TUIC는 type: tuic로 지정합니다. 기존 설정에서 type: vmess만 type: vless로 바꾼다고 프로토콜이 변환되는 것은 아닙니다. 아웃바운드 유형, 인증 정보, 전송 파라미터는 서버 설정과 일치해야 합니다.
- VLESS와 REALITY: VLESS는 노드 프로토콜이며, REALITY는 독립적인
type이 아닙니다. REALITY를 사용하는 VLESS 노드라면servername과reality-opts안의public-key,short-id를 확인하세요. 서버에서 Vision을 요구하는 경우에만 해당flow를 설정하세요. - Hysteria 2와 TUIC: 두 프로토콜 모두 QUIC 기반입니다. 서버 도메인을 해석할 수 있거나 웹페이지에 접속할 수 있고 서버의 TCP 포트에 연결되더라도, 같은 포트의 UDP 트래픽까지 통신된다는 뜻은 아닙니다. 문제를 진단할 때 프로토콜 항목, 인증 정보, 네트워크의 UDP 지원 여부를 각각 확인하세요.
- 구독 가져오기: 전체 YAML 설정과 노드 프로바이더가 읽는 노드 목록을 먼저 구분하세요. 구독 업데이트 성공은 클라이언트가 콘텐츠를 가져왔다는 의미일 뿐입니다. 정책 그룹에서 새 노드를 참조하지 않으면 일반 요청은 계속 기존 아웃바운드로 나갈 수 있습니다.
룰셋: 파일 형식, 동작 및 매칭 순서
rule-providers에서 룰셋을 등록하고, rules의 RULE-SET에서 적용 시점과 매칭 후 사용할 아웃바운드를 지정합니다. 아래 예시는 원격 룰셋 다운로드 실패와 설정 오류를 구분할 수 있도록 로컬 파일로 마이그레이션하는 방법을 보여 줍니다.
주 설정의 룰셋 참조
mode: rule
rule-providers:
local-domains:
type: file
behavior: classical
format: yaml
path: ./rules/local-domains.yaml
rules:
- RULE-SET,local-domains,DIRECT
- MATCH,DIRECT
룰셋 파일 rules/local-domains.yaml
payload:
- DOMAIN-SUFFIX,example.org
두 규칙 모두 DIRECT를 지정하므로 규칙 매칭만 확인하고 기본 아웃바운드는 바꾸지 않습니다. 규칙 모드에서 코어는 순서대로 규칙을 확인하며, 일반적으로 처음 일치하는 규칙을 적용합니다. 연결 기록에서 example.org가 마지막의 MATCH가 아닌 RULE-SET에 일치했는지 확인하세요. 아웃바운드 이름만으로는 두 경우를 구분할 수 없습니다. 실제 설정에서는 기본 규칙을 맨 마지막에 두고, 앞쪽의 더 포괄적인 도메인 또는 IP 규칙이 먼저 일치하는지도 확인하세요.
behavior: classical에서는 예시의 DOMAIN-SUFFIX,example.org 형식을 사용할 수 있습니다. behavior: domain은 도메인 매칭 항목을 읽으므로 이런 규칙 유형 접두사가 붙은 형식을 사용하지 않습니다. behavior: ipcidr은 IP 대역을 읽습니다. format은 파일 인코딩 형식을 지정하는 항목이지 매칭 동작을 지정하는 항목이 아닙니다. 파일 확장자를 .mrs로 바꿔도 YAML이 MRS로 변환되지 않습니다. MRS를 사용하려면 실제로 생성한 파일을 사용하고, 규칙 동작은 domain 또는 ipcidr로 지정해야 합니다.
DNS 마이그레이션: 접속 대상 도메인과 노드 도메인 구분
접속 대상 도메인은 앱이 접속하는 주소이고, 노드 도메인은 프록시 서버 자체의 주소입니다. 클라이언트가 접속 대상 도메인을 해석하더라도 코어가 노드 도메인을 해석할 수 있는 것은 아닙니다. 노드 설정의 server에 도메인을 사용한다면 mihomo의 proxy-server-nameserver로 노드 도메인을 해석할 업스트림을 지정할 수 있습니다. 문제를 진단할 때 노드에 연결되기 전에도 해당 업스트림에 접근할 수 있는지 확인해, 노드에 먼저 연결해야 노드 주소를 해석할 수 있는 순환 의존성을 방지하세요.
nameserver는 일반 쿼리에 사용할 업스트림을 지정하는 항목 중 하나입니다.nameserver-policy를 사용하면 일치하는 도메인마다 다른 업스트림을 지정할 수 있습니다. 기업 내부 도메인에는 내부 영역을 해석할 수 있는 DNS를 사용하세요. 공용 업스트림을 하나 더 추가하는 것만으로는 해결되지 않습니다.enhanced-mode: fake-ip는 조건에 맞는 쿼리에 매핑 주소를 반환합니다. 실행 중인 설정에서198.18.0.1/16을 사용한다면 이 범위의 응답은 일반적으로 예상된 동작이며, 대상 서버의 공인 IP 주소가 아닙니다.- 내부 도메인에 실제 IP가 필요하다면
fake-ip-filter와fake-ip-filter-mode를 확인하세요. 블랙리스트 모드에서는 필터 항목에 일치하는 도메인에 Fake IP를 반환하지 않습니다. 필터는 응답 방식을 바꿀 뿐, 내부 도메인을 해석할 수 있는 업스트림을 자동으로 선택하지는 않습니다.
일반 DNS 쿼리는 성공하지만 서비스가 작동하지 않는다면 같은 도메인으로 앱이 실제 사용하는 해석 경로와 코어 연결 기록을 비교하세요. 브라우저의 암호화 DNS는 다른 경로를 사용할 수 있습니다. 또한 IP를 기준으로 하는 규칙은 도메인 조회를 유발할 수 있습니다. 해당 규칙에 no-resolve를 추가하면 규칙이 도메인의 IP를 직접 조회하지 않도록 할 수 있지만, 전역 DNS를 비활성화하는 것은 아닙니다.
TUN 마이그레이션: 프록시 포트를 확인한 다음 시스템 라우팅 적용
시스템 프록시는 앱이 프록시 설정을 따르는 경우에만 트래픽을 처리합니다. TUN은 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 받습니다. 시스템 프록시에서 브라우저가 정상 작동하더라도 TUN이 터미널, 게임 등 시스템 프록시를 사용하지 않는 앱의 트래픽까지 처리한다는 뜻은 아닙니다. 마이그레이션할 때는 먼저 TUN을 끄고 프록시 리스닝과 노드를 확인한 뒤, TUN을 별도로 켜서 차이를 비교하세요.
- 실행 설정에서
mixed-port: 7890을 사용하는 경우curl -I --proxy http://127.0.0.1:7890 https://example.org/를 실행할 수 있습니다. Windows PowerShell에서curl을 별칭으로 사용하는 경우에는curl.exe를 사용하세요. 응답을 받은 뒤에도 연결 기록을 확인해 요청이 예상한 정책을 따랐는지 검증해야 합니다. 응답이 왔다고 해서 프록시 노드가 선택되었다는 뜻은 아닙니다. tun.enable을 켠 다음 코어에 가상 네트워크 인터페이스 생성 및 라우팅 변경 권한이 있는지 확인하세요.auto-route는 라우트를 자동으로 추가할지 결정합니다. 유선 네트워크, 무선 네트워크, 다른 VPN을 함께 사용하는 경우 자동으로 감지된 출구가 올바른지 확인하세요. 기본 출구를 노드 장애로 오인하지 않도록 주의해야 합니다.- TUN을 켠 뒤 DNS만 문제가 생긴다면
dns-hijack의 매칭 범위를 확인하세요.any:53은 UDP 53을,tcp://any:53은 TCP 53을 매칭합니다. 이 규칙은 HTTPS를 통해 전달되는 암호화 DNS 쿼리를 일반적인 53번 포트 쿼리로 간주해 가로채지 않습니다.
기존 설정 마이그레이션 검증 순서
사용 가능한 기존 설정은 보존하고 별도의 작업 디렉터리에서 새 설정을 테스트하세요. 아래 명령은 해당 설정이 있는 작업 디렉터리에서 실행합니다. GUI 클라이언트를 사용한다면 구독 병합과 덮어쓰기를 거친 뒤 코어에 전달되는 최종 설정도 확인해야 합니다.
mihomo -v
mihomo -t -d . -f config.yaml
-t는 설정을 테스트하는 옵션이며 실행 중 동작을 검증하는 용도는 아닙니다. 먼저 정상 작동이 확인된 노드로 프록시 연결을 검증하세요. 다음으로 직접 연결되어야 하는 요청과 프록시 그룹을 거쳐야 하는 요청을 각각 확인하고, 마지막으로 DNS와 TUN을 따로 검증하세요. 구독 업데이트 후 문제가 재현된다면 업데이트 전후의 실제 규칙 순서와 그룹 멤버를 비교하고, 덮어쓰기 설정이 여전히 적용되는지 확인하세요.
전환 후 내부 네트워크까지 연결되지 않는다면 우선 TUN을 끄고 이전 시스템 프록시 및 설정을 복원한 다음 항목별로 다시 테스트하세요. 설정 항목의 의미는 설정 레퍼런스를, 앱 프록시와 정책 그룹, 코어의 관계는 용어 설명에서 확인할 수 있습니다.