프로젝트 이력: 이름과 유지 관리 상태 확인
Clash는 규칙 기반 프록시 커널로 알려지기 시작했고, 이후 여러 운영체제용 그래픽 클라이언트가 등장했습니다. 원래 Clash 프로젝트와 일부 초기 클라이언트의 유지 관리가 중단된 뒤에도 생태계에서는 다양한 후속 프로젝트가 이어지고 있습니다. Clash Meta는 이후 mihomo라는 이름으로 개발을 계속했기 때문에 예전 가이드의 Clash, Meta와 현재 문서의 mihomo가 서로 다른 시기의 프로젝트를 가리킬 수 있습니다. 가이드를 읽을 때는 커널, 클라이언트, 설정 형식 중 무엇을 설명하는지 먼저 확인하세요.
Clash for Windows는 과거 데스크톱 클라이언트의 이름이지 Windows용 모든 Clash 클라이언트를 통칭하는 말이 아닙니다. 기존 환경을 살펴보려는 목적이라면 예전 설치 파일을 사용할 수 있지만, 유지 관리가 중단되어 이후 시스템 호환성, 프로토콜 지원, 문제 수정은 보장되지 않습니다. 새로 설치할 때는 현재도 유지 관리되는 클라이언트를 우선 비교하세요. 이전할 때는 기존 설정을 보관하고 프로그램 파일만 바꾸기보다 규칙, DNS, 프록시 그룹의 호환성을 확인하세요.
오픈 소스 생태계: 코드 라이선스와 서비스 출처 구분
mihomo 소스 코드는 GPL-3.0 라이선스로 공개되어 있으며 공개 저장소에서 구현, 커밋 기록, 이슈 논의를 확인할 수 있습니다. 코드를 공개하면 설정 동작을 직접 살펴볼 수 있지만, 그래픽 클라이언트의 기능, 패키징 방식, 유지 관리 주기는 해당 프로젝트의 안내를 기준으로 판단해야 합니다. 저장소의 별 수로 연결 품질을 추측하거나 커뮤니티의 인기를 모든 기기에 적합하다는 근거로 삼지 않습니다. 운영체제 지원, 필요한 권한, 유지 관리 방식에 주목해 클라이언트를 선택하세요.
오픈 소스 커널, 클라이언트, 연결 서비스는 서로 다른 계층입니다. 소프트웨어 라이선스는 코드를 사용하고 배포하는 방법을 정하고, 구독 서비스는 연결 정보와 이용 조건을 제공합니다. 서로를 대체할 수는 없습니다. 공개 노드는 언제든 작동을 멈출 수 있으며 공유 페이지만으로 운영 주체를 확인하기도 어렵습니다. 계정 로그인, 결제 등 민감한 작업을 할 때는 연결 경로의 출처를 살펴보고 대상 앱 자체의 암호화 연결도 계속 사용하세요.
커널 관계: 인터페이스 설정이 모든 플랫폼에서 같지는 않습니다
그래픽 클라이언트는 보통 설정 관리, 시스템 프록시 전환, 서비스 설치, 로그 표시를 담당하고 커널은 실제 연결을 처리합니다. 여기서 소개하는 문법은 mihomo를 기준으로 합니다. iOS 등 다른 플랫폼의 클라이언트는 해당 문서에서 지원 범위를 확인하세요. 같은 YAML을 사용하더라도 커널 기능, 플랫폼 네트워크 인터페이스, 클라이언트의 오버라이드 방식에 따라 일부 필드의 동작이 달라질 수 있습니다. 설정을 가져올 수 있다는 것은 파일이 받아들여졌다는 뜻일 뿐이므로 실제 트래픽 경로도 확인해야 합니다.
시스템 프록시, TUN, 규칙 모드는 서로 다른 계층에서 작동합니다. 시스템 프록시는 앱이 프록시 설정을 사용해야 하고, TUN은 네트워크 라우팅을 통해 트래픽을 가져오며, 규칙 모드는 트래픽을 처리한 뒤 적용할 정책을 정합니다. 이 세 가지를 구분하면 브라우저에서는 접속되지만 다른 앱에서는 안 되는 문제나 전역 모드인데도 연결이 우회되는 문제를 더 빠르게 찾을 수 있습니다. 먼저 연결이 커널에 들어오는지 확인하고, 다음으로 적용된 규칙을 살펴본 뒤 선택한 경로에 연결할 수 있는지 확인하세요.
업데이트 방식: 프로그램, 구독, 규칙 데이터를 따로 확인
클라이언트 업데이트는 인터페이스와 시스템 연동에 영향을 줄 수 있고, 커널 업데이트는 프로토콜이나 설정 동작을 바꿀 수 있습니다. 구독 업데이트는 연결 정보를 교체하고, 규칙 모음과 지리 데이터베이스 업데이트는 분류 결과에 영향을 줍니다. 이 작업들이 반드시 한꺼번에 진행되는 것은 아닙니다. 업그레이드 전에 사용 중인 설정과 로컬 오버라이드를 기록하고 변경 사항을 읽어보세요. 업그레이드 뒤에는 자주 방문하는 사이트, 로컬 네트워크 기기, 절전 모드 해제 후 연결을 확인하세요. 네트워크 매개변수를 한꺼번에 바꾸지 않는 것이 좋습니다.
다운로드 페이지에서 플랫폼별 링크와 설치 안내를 확인할 수 있으며, 홈 화면에는 특정 릴리스 번호를 고정해 표시하지 않습니다. 업그레이드 후 문제가 생기면 최소 설정으로 재현한 뒤 규칙 모음, DNS 정책, TUN을 차례로 다시 적용하세요. 프로젝트에 문제를 제보할 때는 운영체제, 클라이언트 이름, 커널 정보, 재현 절차를 포함하고 구독 주소, 계정 정보 등 민감한 내용은 삭제하세요. 단순히 인터넷에 연결되지 않는다고만 적으면 DNS 오류, 라우팅 충돌, 연결 경로 문제를 구분하기 어렵습니다.