mihomo 커널을 중심으로 플랫폼별 다운로드, YAML 설정, 규칙 기반 라우팅을 정리했습니다. 설치부터 설정 필드까지 순서대로 살펴보세요.
mihomo 커널
GPL-3.0 오픈 소스
YAML 설정
YAML 필드 관계도 · 전체 설정이 아님
설정 기능 색인01 — 06 / FIELD NOTES
필드 구조, 라우팅 기준.
설정 파일은 진입점, 이름 해석, 트래픽 출구를 연결합니다. 먼저 각 필드가 어떤 역할을 하는지 파악한 뒤 동작을 조정하세요. 클라이언트에서 켠 옵션도 결국 커널이 읽을 수 있는 설정으로 반영되어야 합니다.
아래 색인은 mihomo에서 자주 사용하는 필드를 기준으로 합니다. GUI 클라이언트마다 필드 지원 범위, 덮어쓰기 방식, 권한 요구 사항이 다를 수 있으므로 설정을 옮기기 전에 해당 클라이언트의 안내도 확인하세요.
규칙 기반 라우팅은 순서가 있는 목록을 통해 연결을 어떤 출구로 보낼지 결정합니다. 도메인 접미사, 대상 주소, 규칙 집합으로 서로 다른 조건을 지정하며, 일반적으로 먼저 일치한 규칙이 적용됩니다. 설정을 변경할 때는 클라이언트가 규칙 모드인지 확인하고, 대상 프록시 그룹이 존재하는지 점검한 뒤 기본 처리 규칙을 맨 마지막에 두세요. 전역 모드와의 차이는 노드 수가 아니라 연결마다 규칙에 따라 경로를 선택하는지 여부입니다. 문제가 생기면 속도 측정 결과만 보지 말고 연결 기록에서 어떤 규칙이 적용됐는지 확인하세요.
프록시 그룹은 규칙과 노드 사이에서 재사용할 수 있는 출구 이름을 제공합니다. 수동 선택 그룹은 사용자가 직접 제어하기 좋고, 지연 시간 테스트 그룹과 장애 조치 그룹은 각각의 방식으로 사용 가능한 구성원을 선택합니다. 규칙에서는 그룹 이름을 참조하고, 그룹에서 노드나 노드 제공자를 참조하도록 구성하세요. 규칙에 노드 이름을 일일이 넣지 않아도 됩니다. 테스트 주소와 간격은 선택 결과에 영향을 주며, 한 번 측정한 지연 시간이 모든 서비스의 성능을 보여주는 것은 아닙니다. 그룹 이름은 일치해야 하며, 순환 참조나 삭제된 구성원이 있으면 설정을 불러오지 못할 수 있습니다.
DNS 설정은 도메인을 IP 주소로 변환하는 방식을 결정하며, 도메인 기반 라우팅에도 영향을 줍니다. fake-ip 모드는 가상 주소를 사용해 도메인과의 연결을 유지하지만, 호환성은 앱과 네트워크 환경에 따라 다릅니다. 설정을 변경하기 전에는 시스템 리졸버, 클라이언트의 DNS 수신 주소, 상위 DNS 서버를 구분하세요. 이 셋은 서로 다른 설정입니다. DNS 문제가 생기면 먼저 요청이 커널에 전달되는지 확인하고, 상위 서버 연결과 도메인 정책을 점검하세요. 암호화 DNS를 켰다고 해서 모든 앱의 DNS 요청이 의도한 경로로 처리된다는 뜻은 아닙니다.
구독 관리에서는 전체 설정 구독과 노드만 포함된 제공자를 구분해야 합니다. 전체 설정 구독에는 규칙과 프록시 그룹이 함께 들어 있을 수 있지만, 노드 제공자는 보통 로컬 설정에서 참조해 사용합니다. 가져오기 전에 응답이 클라이언트가 지원하는 형식인지 확인하세요. 로그인 페이지나 변환되지 않은 링크 목록은 올바른 구독 형식이 아닐 수 있습니다. 구독 주소에 계정 정보가 포함될 수 있으므로 로그를 공유하기 전에 해당 정보를 삭제하세요. 개인 라우팅 규칙을 유지하려면 노드 출처와 로컬 규칙을 따로 관리해 원격 업데이트가 직접 수정한 내용을 덮어쓰지 않게 하세요. 새로고침이 성공해도 노드와 프록시 그룹이 제대로 불러와졌는지 확인해야 합니다.
TUN 모드는 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시 설정을 따르지 않는 앱도 처리할 수 있습니다. 시스템 프록시와 다른 점은 트래픽을 받는 계층이며, TUN을 켠다고 라우팅이나 DNS 문제가 모두 해결되는 것은 아닙니다. 데스크톱에서는 서비스 모드나 별도 권한이 필요한 경우가 많고, 모바일에서는 운영체제의 네트워크 확장 기능에 제약을 받습니다. 사용하기 전에 일반 프록시 연결부터 확인한 다음 자동 라우팅, DNS 가로채기, 로컬 네트워크 접근을 하나씩 점검하세요. 다른 네트워크 도구를 함께 실행한다면 라우팅 우선순위를 확인해 여러 가상 인터페이스가 같은 트래픽을 중복으로 처리하지 않도록 하세요.
설정 덮어쓰기를 사용하면 구독에서 제공하는 내용과 개인 설정을 분리할 수 있습니다. 로컬 포트를 고정하거나 규칙을 추가하고 DNS를 조정할 때 유용합니다. 덮어쓰기는 보통 클라이언트가 설정을 불러오는 과정에서 적용되며, 모든 클라이언트가 같은 최상위 필드나 스크립트 인터페이스를 지원하는 것은 아닙니다. 설정을 옮길 때는 필드가 어떤 방식으로 병합되는지, 목록이 추가되는지 교체되는지, 최종 파일이 어디에 저장되는지 확인하세요. 한 번에 한 종류만 수정하고 다시 불러온 뒤 적용 여부를 확인하는 것이 좋습니다. 캐시 파일을 직접 편집하면 잠시 적용될 수 있지만, 구독을 새로고침하거나 클라이언트를 재시작하면 변경 사항이 사라질 수 있습니다.
다운로드 페이지에서 운영체제를 선택한 뒤 CPU 아키텍처와 설치 파일 형식을 확인하세요. 설치 후에는 클라이언트의 설정 화면과 로그 화면을 먼저 열어 설정을 불러오는 위치와 오류가 표시되는 곳을 파악하세요. 다른 프록시 도구를 사용 중이라면 설정을 기록한 뒤 종료해 포트나 시스템 프록시 설정이 서로 덮어쓰지 않게 하세요.
처음 사용할 때는 모든 네트워크 옵션을 한꺼번에 켤 필요가 없습니다. 기본 수신 범위를 유지하고 커널이 정상적으로 시작되는지 확인한 뒤, 사용하는 앱에 따라 시스템 프록시 또는 TUN을 선택하세요. 권한이 필요한 작업은 용도를 확인한 다음 승인하세요.
02
설정 가져오기 및 프록시 선택
설정 화면에 신뢰할 수 있는 출처의 구독 주소를 붙여 넣거나 기존 YAML 파일을 가져오세요. 다운로드가 끝나면 해당 설정을 현재 설정으로 지정하고 노드와 프록시 그룹이 표시되는지 확인하세요. 가져온 기록만 있고 사용할 수 있는 노드가 없다면 시스템 프록시를 반복해서 바꾸기보다 형식과 로드 로그부터 점검하세요.
그런 다음 프록시 화면에서 사용할 프록시 그룹과 노드를 선택하고 실행 모드가 규칙 모드인지 확인하세요. 설정을 가져오면 규칙과 출구가 연결될 뿐이며, 클라이언트가 원격 프록시 서비스를 자동으로 만들어 주지는 않습니다.
03
트래픽 연결 및 경로 확인
현재 시스템에 적합한 연결 방식을 켜고 접속 가능한 사이트를 방문한 다음, 연결 화면에서 도메인, 적용된 규칙, 실제 출구를 확인하세요. 속도 테스트는 테스트 요청의 결과만 보여줍니다. 웹페이지 접속, DNS 응답, 연결 로그를 함께 확인해야 연결을 제대로 검증할 수 있습니다.
문제가 생기면 로컬 네트워크, 시스템 시간, 구독 내용, 노드 연결, DNS 순으로 확인하세요. 한 번에 하나씩만 바꾸고 결과를 기록하세요. 클라이언트를 종료한 뒤에는 시스템 프록시가 원래대로 복구됐는지도 확인해야 합니다. 그렇지 않으면 앱이 종료된 로컬 포트를 계속 가리킬 수 있습니다.
SOURCE / 오픈 소스 생태계
커널과 인터페이스의 역할 구분
클라이언트 이름은 프로토콜이 아닙니다. 설정 문법이 서비스 출처를 뜻하지도 않습니다.
Clash Home은 한국어 자료를 정리하는 사이트이며 각 클라이언트 프로젝트의 공식 배포처가 아닙니다. 다운로드 옵션, 필드 설명, 튜토리얼은 서로 다른 계층을 다루므로 각 자료를 볼 때 이 차이를 고려하세요.
원본 Clash와 일부 초기 GUI 클라이언트의 유지 관리가 중단된 뒤에도 생태계가 하나의 새 제품으로 통합된 것은 아닙니다. mihomo는 관련 커널 기능을 이어받아 확장하고 있으며, Clash Verge Rev와 FlClash 같은 GUI 프로젝트는 각 플랫폼의 인터페이스와 시스템 연동을 담당합니다. 예전 튜토리얼의 화면, 버튼 이름, 필드 기본값은 현재 클라이언트와 다를 수 있습니다. 차이가 있다면 사용 중인 프로젝트의 문서와 실제 적용된 설정을 기준으로 판단하세요.
따라서 “Clash 공식 사이트”를 검색할 때는 무엇을 찾는지 먼저 확인해야 합니다. 커널 저장소, GUI 클라이언트 홈페이지, 구독 서비스 제공자는 서로 다른 출처입니다. 자료 사이트는 정보를 찾고 이해하는 데 도움을 줄 수 있지만, 프로젝트 유지 관리자를 대신해 호환성을 보장하지는 않습니다. 보관된 클라이언트는 기존 환경을 살펴볼 때 참고하고, 새로 설치할 때는 계속 유지 관리되는 대안을 우선 검토하세요.
커널은 실행하고 클라이언트는 관리합니다
커널은 프로토콜 연결, DNS 처리, 규칙 매칭, 출구 선택을 담당합니다. GUI 클라이언트는 설정 가져오기, 프록시 전환, 로그 표시, 시스템 프록시 등의 설정을 관리합니다. 하나의 커널을 여러 인터페이스에서 사용할 수 있고, 같은 인터페이스도 업데이트에 따라 커널 구성 요소가 달라질 수 있습니다. 특정 기능을 사용할 수 있는지 판단하려면 커널의 지원 여부, 클라이언트에 해당 메뉴가 있는지, 운영체제가 필요한 권한을 허용하는지 모두 확인해야 합니다.
설정 파일은 커널과 클라이언트 사이에서 원하는 동작을 설명하지만, 시스템 트래픽이 실제로 커널에 전달되는 것까지 보장하지는 않습니다. 클라이언트에 실행 중이라고 표시되어도 일부 구성 요소만 시작됐을 수 있습니다. 실제로 트래픽을 처리하는지 확인하려면 연결 기록과 시스템 설정을 살펴보세요. 가이드에서 ‘가져오기 성공’과 ‘연결 확인’을 별도 단계로 나누는 이유도 여기에 있습니다.
오픈 소스 정보 및 문제 제보
mihomo의 소스 코드와 라이선스 정보는 공개 저장소에서 확인할 수 있으며, 커널은 GPL-3.0 라이선스를 따릅니다. 각 GUI 클라이언트의 라이선스는 해당 프로젝트의 안내를 따로 확인하세요. 오픈 소스라는 것은 구현과 변경 내역을 살펴볼 수 있다는 뜻이지, 배포 파일, 구독 출처, 원격 노드의 관리 주체가 모두 같다는 뜻은 아닙니다. 클라이언트를 선택할 때는 릴리스 기록, 이슈 논의, 문서 변경 내역을 참고하고 확인되지 않은 다운로드 수나 평점만으로 판단하지 마세요.
문제를 제보하기 전에 오류가 인터페이스, 커널, 구독 내용 중 어디에서 발생하는지 확인하세요. 운영체제, 클라이언트 이름, 재현 절차, 민감 정보를 삭제한 오류 내용을 포함하면 도움이 됩니다. 구독 주소, 노드 비밀번호, 제어 인터페이스 인증 정보는 공개 스크린샷이나 로그에 노출하지 마세요. 설정 파일 전체를 붙여 넣기보다 필요한 맥락을 함께 설명하는 편이 문제를 찾기 쉽습니다.
클라이언트 업데이트와 설정을 따로 관리
클라이언트 업데이트, 커널 업데이트, 구독 새로고침, 규칙 집합 업데이트는 서로 다른 작업입니다. 앞의 두 작업은 프로그램 기능을 바꾸고, 뒤의 두 작업은 프로그램이 읽는 데이터를 바꿉니다. 규칙 업데이트에 성공해도 클라이언트가 최신 버전이 된 것은 아닙니다. 인터페이스를 업그레이드한 뒤에는 개인 덮어쓰기 설정이 이전 순서대로 병합되는지도 확인하세요. 동작이 달라질 수 있는 변경을 적용할 때는 먼저 복구할 수 있는 설정 사본을 보관하고 항목별로 조정하세요.
홈페이지에는 버전 정보를 고정해 표시하지 않습니다. 설치 파일, 선택 가능한 아키텍처, 유지 관리 상태는 다운로드 페이지에 모아 두고, 필드의 의미는 YAML 가이드에서 확인할 수 있습니다. 이렇게 하면 ‘어떤 프로그램을 선택할지’와 ‘네트워크 동작을 어떻게 설정할지’를 나누어 검토할 수 있어 오래된 화면이나 파일 이름, 클라이언트 간 설정 차이로 인한 오해를 줄일 수 있습니다.
먼저 플랫폼을 선택한 다음 클라이언트와 아키텍처를 비교하세요. Clash Plus는 다운로드 페이지에서 해당 플랫폼에 우선 추천하는 옵션입니다. 특정 데스크톱 인터페이스나 Linux 설치 형식이 필요하면 Clash Verge Rev와 FlClash도 살펴보세요. 전체 목록에는 보관된 프로젝트의 유지 관리 상태도 표시해 오래된 튜토리얼에 나온 이름을 확인할 수 있습니다.
먼저 운영체제와 CPU 아키텍처를 확인한 뒤 설치 프로그램을 선택하세요. Clash Plus, Clash Verge Rev, FlClash를 선택 후보로 살펴볼 수 있습니다. Clash for Windows 대체 프로그램을 찾는다면 유지 관리 상태와 설정 이전 가능성을 특히 확인하세요.
시스템 프록시는 해당 설정을 따르는 앱에만 영향을 줍니다. 더 넓은 범위의 트래픽을 연결해야 한다면 TUN의 서비스 권한 안내를 확인하세요. UWP 앱의 연결에 차이가 있다면 노드를 모두 바꾸기 전에 루프백 제한을 별도로 점검하세요.
Apple Silicon과 Intel 기기에는 각각 맞는 아키텍처를 선택해야 합니다. Clash Plus, Clash Verge Rev, FlClash의 인터페이스와 설정 관리 방식을 비교해 보세요. 기존 ClashX Meta 환경을 사용한다면 보관 상태인지 확인하세요.
처음 실행할 때 시스템 보안 경고나 네트워크 권한 요청이 표시되면 앱 출처와 권한 사용 목적부터 확인하세요. 시스템 프록시, 네트워크 확장 기능, 다른 VPN 도구가 서로 영향을 줄 수 있으므로 문제를 확인할 때는 현재 어떤 프로그램이 트래픽을 처리하는지 먼저 파악하세요.
Android용 Clash 클라이언트로 Clash Plus, Clash Meta for Android, FlClash를 선택할 수 있으며 다운로드 페이지에는 Surfboard도 안내되어 있습니다. 클라이언트마다 지원하는 설정 형식이 다르므로 가져오기 전에 구독 유형을 확인하세요.
연결하려면 보통 시스템 VPN 권한이 필요합니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 앱별 라우팅을 설정할 때는 시스템 VPN이 처리하는 앱 범위와 커널 규칙을 구분해야 합니다. 두 기능은 서로 다른 계층에서 작동합니다.
데스크톱 사용자는 Clash Verge Rev와 FlClash를 확인하고 배포판에 맞는 설치 형식을 선택할 수 있습니다. 서버와 라우터에서는 다운로드 페이지의 커널 섹션에서 mihomo를 찾은 뒤 설정 디렉터리, 프로세스, 네트워크 권한을 직접 관리하세요.
터미널 프로그램은 데스크톱 환경의 프록시 설정을 따르지 않을 수 있으므로 환경 변수와 프로그램 인수를 각각 확인해야 합니다. 가상 인터페이스를 켜기 전에는 라우팅, 방화벽, 서비스 권한도 점검하세요. 데스크톱 클라이언트 사용법을 서버에 그대로 적용하지 않도록 주의해야 합니다.
각 글은 특정 상황에 초점을 맞춰 필드 정의만으로 설명하기 어려운 사용 배경을 보충합니다. 처음 설치한다면 빠른 시작 가이드를 먼저 따라 하고, 이후 화면 사용법, 동기화 방법, 연결 문제 해결을 필요한 만큼 확인하세요. 기본 연결을 만들기 전부터 모든 고급 옵션을 변경할 필요는 없습니다.