mihomo 코어 · 클라이언트 및 설정 문서

Clash Meta 다운로드와 설정 가이드

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독을 가져온 뒤, 규칙 기반 라우팅을 설정하고 프록시 연결을 확인하세요.

  • 오픈 소스 코어
  • 다양한 플랫폼 지원
  • 한국어 설정 안내

플랫폼 및 설치 파일

Clash 클라이언트 다운로드

먼저 운영체제와 CPU 아키텍처를 확인한 뒤 GUI 클라이언트를 선택하세요. 설치 파일, 시스템 요구 사항, 유지 관리 상태는 다운로드 페이지에서 확인할 수 있으며 코어 파일은 별도로 제공됩니다.

Windows

데스크톱에서는 Clash Plus를 먼저 살펴보고, 인터페이스 취향에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 시스템 프록시는 시스템 설정을 따르는 앱에 적합합니다. 더 많은 연결을 처리해야 한다면 TUN에 필요한 권한과 서비스를 확인하세요. 설치 전에 CPU 아키텍처를 확인하고, 기존 클라이언트의 설치 폴더를 새 프로젝트에 그대로 덮어쓰지 마세요.

다운로드 페이지로 이동

macOS

먼저 Apple Silicon과 Intel을 구분해 알맞은 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash를 인터페이스 선택의 출발점으로 삼을 수 있습니다. 처음 실행할 때는 시스템 안내에 따라 권한을 허용하세요. 클라이언트를 바꾸기 전에는 기존 클라이언트의 프록시 처리를 종료해야 합니다. 설정 호환성은 앱 이름만으로 판단하지 말고 실제 사용하는 코어와 설정 항목을 확인하세요.

다운로드 페이지로 이동

Android

기기 아키텍처에 맞는 설치 파일을 선택하고 처음 연결할 때 VPN 권한을 확인하세요. Clash Plus, Clash Meta for Android, FlClash는 설정 메뉴가 서로 다를 수 있습니다. 먼저 구독을 가져온 다음 앱별 트래픽 분리와 백그라운드 실행 제한을 확인하세요. Surfboard는 Clash YAML과 설정 체계가 다르므로 파일 확장자만 바꿔서 그대로 사용할 수 없습니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 VPN 구성 추가를 허용하고, 클라이언트가 지원하는 링크나 파일을 가져오세요. 데스크톱 설정의 로컬 경로, 스크립트, 특정 시스템 매개변수는 휴대폰에서 작동하지 않을 수 있습니다. 가져오기 오류가 발생하면 내용을 수정하기 전에 설정 형식과 앱 지원 범위를 먼저 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev와 FlClash를 살펴보고, 배포판에 맞는 패키지 형식을 선택할 수 있습니다. 서버나 라우터에서 사용할 경우 별도의 mihomo 코어 다운로드 페이지를 확인하세요. 설정 디렉터리, 프로세스, 네트워크 권한은 직접 관리해야 합니다. 데스크톱 GUI 클라이언트와 백그라운드 서비스가 같은 수신 포트나 가상 네트워크 인터페이스를 동시에 사용하지 않도록 하세요.

다운로드 페이지로 이동

설치에 성공했다는 것은 프로그램이 실행된다는 뜻일 뿐, 구독이나 노드, 트래픽 분리가 정상 작동한다는 의미는 아닙니다. 처음 사용할 때는 클라이언트 하나만 실행하고 기존 설정 사본을 보관한 뒤, ‘가져오기, 선택, 확인’ 순서로 점검하세요.

전체 클라이언트 보기 →

설정 기능 살펴보기

mihomo와 규칙 기반 라우팅

GUI는 조작을 담당하고 코어는 연결과 규칙 처리를 담당합니다. 사용 목적에 맞는 기능을 확인하고 적용 범위를 이해한 뒤 활성화 여부를 결정하세요.

목적지별 아웃바운드 지정

규칙 기반 라우팅은 목적지마다 서로 다른 아웃바운드 정책을 적용해 접속할 때마다 모드를 수동으로 바꾸지 않도록 합니다. mihomo는 규칙을 위에서 아래로 확인하며, 처음 일치하는 항목이 이후 연결 경로를 결정합니다. 도메인, IP 대역, 규칙 집합을 조건으로 사용할 수 있습니다. 프록시 그룹은 선택 가능한 아웃바운드를 묶어 관리하는 기능으로, 규칙과는 다른 개념입니다. 특정 앱의 연결 경로가 잘못됐다면 전체 트래픽을 전역 모드로 바꾸기보다 연결 기록에서 일치한 규칙을 확인하고 순서를 조정하세요.

자세히 알아보기 ›

규칙과 프록시 그룹 구분하기

설정을 가져온 뒤 프록시 페이지에서 프록시 그룹의 아웃바운드를 선택하고 규칙 모드로 새 연결을 시도하세요. 수동 선택 그룹은 선택한 항목을 유지하고, 자동 테스트 그룹은 설정에 따라 연결을 점검하고 전환합니다. mihomo는 기존 Clash보다 일부 규칙과 정책 기능을 확장했지만, 사용할 수 있는 설정 항목은 코어 문서에서 확인해야 합니다. 사용자 지정 규칙은 우선 적용이 필요한 위치에 두고, 다음 구독 업데이트 때 변경 사항이 사라지지 않도록 클라이언트의 덮어쓰기 또는 병합 기능을 사용하세요.

자세히 알아보기 ›

첫 실행 절차

구독 가져오기와 연결 점검

반복해서 확인할 수 있는 점검 순서를 따르세요. 설정이 정상적으로 불러와지는지 확인하고, 아웃바운드 정책을 지정한 다음 실제 연결을 살펴봅니다. 한 번에 한 종류의 설정만 변경하세요.

단계 01 / 설정

Profile 가져오기 및 활성화

클라이언트의 설정 페이지를 열고 신뢰할 수 있는 출처의 구독 링크를 붙여넣거나 로컬 YAML 파일을 선택하세요. 다운로드와 구문 분석이 끝날 때까지 기다린 뒤 해당 설정을 직접 선택해야 합니다. 파일이 목록에 표시되는 것만으로는 코어가 설정을 불러왔다는 의미가 아닙니다. 현재 설정 표시와 오류 메시지도 함께 확인하세요.

가져오기 오류가 발생하면 링크가 웹페이지를 반환하는지 설정 내용을 반환하는지 먼저 확인한 뒤, 현재 코어가 지원하는 형식인지 점검하세요. 구독 링크에 접근 인증 정보가 포함될 수 있으므로 스크린샷을 공유할 때 전체 주소를 가리고 공개 게시판에 링크를 붙여넣지 마세요. 먼저 복구할 수 있는 설정 사본을 보관한 뒤 덮어쓰기와 병합을 시도하세요.

단계 02 / 아웃바운드

모드와 프록시 그룹 선택

처음 연결할 때는 규칙 모드를 사용하고, 설정에 포함된 프록시 그룹에서 아웃바운드를 선택한 다음 시스템 요구 사항에 따라 시스템 프록시를 켜거나 VPN 연결을 허용하세요. 지연 시간 테스트는 특정 테스트 대상의 연결 상태만 보여줍니다. 모든 웹사이트의 접속 속도를 나타내거나 실제 요청을 완전히 대신하지는 않습니다.

먼저 기본 프록시 경로가 작동하는지 확인한 뒤 TUN이 필요한지 결정하세요. 전역 모드는 정책 선택 방식을 바꿀 뿐, 원래 시스템 프록시를 무시하는 앱까지 자동으로 프록시를 사용하게 하지는 않습니다. 모드를 바꾼 뒤 새 연결을 만들어 결과를 확인하세요. 이미 연결된 장시간 연결은 기존 아웃바운드 경로를 계속 사용할 수 있습니다.

단계 03 / 확인

연결 및 일치 규칙 확인

테스트 대상을 정해 접속한 다음 클라이언트 연결 목록에서 대상 도메인, 일치한 규칙, 프록시 그룹, 최종 아웃바운드를 확인하세요. 실제 외부 IP를 확인해야 한다면 신뢰할 수 있는 IP 조회 페이지도 함께 이용하세요. 페이지가 열리는 것은 해당 요청이 성공했다는 뜻일 뿐이므로, 예상한 경로를 거쳤는지 연결 기록을 함께 살펴보세요.

브라우저에서는 정상인데 특정 앱이 실패하면 먼저 해당 앱이 시스템 프록시를 따르는지 확인한 뒤 트래픽 처리 범위와 DNS를 살펴보세요. Windows Store 앱은 루프백 제한의 영향을 받을 수도 있습니다. 문제가 발생한 앱, 대상, 로그 요약을 기록하고 설정, 프록시 경로, DNS 해석을 각각 확인하세요. 여러 매개변수를 동시에 바꾸면 결과를 비교하기 어렵습니다.

전체 가이드 보기 → 첫 연결 점검 목록 →

프로젝트 및 유지 관리 정보

오픈 소스 생태계와 코어 관계

코어 프로젝트, GUI 클라이언트, 구독 제공처를 구분해 확인하세요. 소스 코드와 라이선스, 업데이트 기록은 공개 자료에서 확인할 수 있지만 클라이언트 이름만으로 모든 설정의 호환성을 보장할 수는 없습니다.

Clash, Meta, mihomo의 관계

Clash는 규칙 기반 프록시 도구의 중요한 출발점입니다. Clash Meta는 관련 설정 체계에 프로토콜과 네트워크 기능을 확장했고, 후속 코어 프로젝트는 mihomo라는 이름으로 발전을 이어가고 있습니다. 검색할 때 쓰는 “Clash Meta”는 코어를 뜻할 수도 있고 해당 코어를 사용하는 GUI 클라이언트를 가리킬 수도 있습니다. 구체적인 프로젝트를 식별하려면 앱 이름뿐 아니라 코어 안내와 유지 관리 기록도 확인하세요. 이 세 이름을 서로 바꿔 쓸 수 있는 설치 파일처럼 취급하면 안 됩니다.

코어는 설정을 해석하고 규칙을 매칭하며 연결을 처리합니다. GUI 클라이언트는 보통 구독 목록, 트레이 메뉴, 시스템 프록시 전환, 로그 화면을 제공합니다. 같은 코어를 서로 다른 인터페이스와 조합할 수 있으며, 각 인터페이스가 설정을 사전 처리하는 방식은 다를 수 있습니다. 다른 클라이언트로 옮길 때는 내보낸 내용이 표준 코어 설정인지 특정 클라이언트 전용 관리 데이터인지 먼저 확인한 다음 가져오기 방법을 정하세요.

소스 코드 및 라이선스

mihomo 소스 코드와 프로젝트 안내는 MetaCubeX 공개 저장소에서 확인할 수 있으며, 코어는 GPL-3.0 라이선스를 따릅니다. 라이선스는 코드의 사용, 수정, 배포 조건을 설명합니다. 모든 GUI 클라이언트가 같은 라이선스를 사용한다는 뜻도, 코어 프로젝트가 구독 서비스를 제공한다는 뜻도 아닙니다. 코드를 배포하거나 2차 개발할 때는 사용하는 프로젝트의 라이선스 전문과 관련 의존성 안내를 각각 확인하세요.

소스 코드를 살펴보는 목적은 구현과 문서를 확인하는 데 있으며, 별 개수로 연결 품질을 보장받기 위한 것이 아닙니다. 이 문서에는 변동하는 인기 지표를 나열하지 않습니다. 기능이 필요한 환경에 적합한지 판단하려면 공개 문서, 변경 기록, 현재 클라이언트에 통합된 코어를 우선 확인하세요. 커뮤니티 게시물은 알려진 문제를 찾는 데 유용하지만, 문의를 올리기 전 설정에 포함된 접근 인증 정보와 개인정보를 제거해야 합니다.

mihomo 오픈 소스 저장소 보기 ↗

업데이트 방식과 호환성 범위

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 집합 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스나 권한 절차를 바꿀 수 있고, 코어 업데이트는 프로토콜이나 설정 항목을 변경할 수 있습니다. 구독 업데이트는 원격 설정 내용을 새로고침하며, 규칙 집합 업데이트는 일부 규칙이 참조하는 데이터를 바꿉니다. 문제가 생겼을 때는 먼저 어느 계층이 업데이트됐는지 확인해야 관련 기록을 찾을 수 있습니다. 모든 문제를 구독 탓으로 돌리지 마세요.

업데이트 전에 설정 사본과 로컬 덮어쓰기 내용을 보관하세요. 업데이트 후에는 기존 테스트 대상으로 기본 연결을 확인한 다음 사용자 지정 규칙을 점검하세요. 기존 설정이 구문 분석에 성공해도 이전 환경과 동일하게 작동한다는 보장은 없습니다. 반대로 새 설정의 확장 항목을 구형 코어가 불러오지 못할 수도 있습니다. 보관된 클라이언트는 이전 환경을 확인할 때 유용하지만, 일상적으로 사용할 클라이언트는 유지 관리 기록이 있고 시스템 지원 범위가 명확한 프로젝트를 우선 선택하세요.

구독 출처 및 문서 범위

이 사이트에서는 클라이언트 다운로드 경로, 사용 절차, 관련 개념을 안내합니다. 구독에 어떤 아웃바운드가 포함되는지, 서버에서 어떤 매개변수를 사용하는지, 원격 주소에 접속할 수 있는지는 해당 설정 제공처가 결정합니다. 클라이언트를 설치한 뒤에도 유효한 설정이 필요합니다. 설치 파일 자체가 구독 서비스는 아닙니다. 매개변수를 확인해야 한다면 클라이언트 이름으로 연결 정보를 추측하지 말고 설정 제공처에 프로토콜 유형, 형식, 사용 조건을 문의하세요.

클라이언트마다 버튼 이름과 설정 위치가 다를 수 있으므로 가이드는 ‘설정 가져오기, 아웃바운드 선택, 트래픽 처리, 연결 확인’ 순서로 구성했습니다. 화면이 다르면 해당 기능을 찾아 사용하면 되며 모든 스위치 설정을 똑같이 따라 할 필요는 없습니다. 프록시 그룹, 규칙 집합, DNS 향상 모드를 이해하려면 개념 요약부터 확인하세요. 프로토콜과 코어 기능을 비교하려면 프로토콜 안내를 살펴보면 됩니다.

개념 빠르게 보기 › 프로토콜 가이드 › 자주 묻는 질문 ›

mihomo 소스 코드 받기

Git이 설치된 환경에서는 다음 명령을 복사할 수 있습니다. 저장소를 클론해도 코드만 다운로드되며 GUI 클라이언트가 자동으로 설치되거나 시스템 프록시가 활성화되지는 않습니다. 빌드와 실행 요구 사항은 저장소 문서를 확인하세요.

git clone https://github.com/MetaCubeX/mihomo.git

로컬 터미널에 복사할 수 있습니다. 실행 전에 명령 내용을 확인하세요.

설정 및 문제 해결 기록

최근 기술 문서

설정 관리, DNS 동작, 앱 호환성을 다룹니다. 문제가 발생한 계층부터 확인한 다음 문서의 절차에 따라 항목별로 점검하세요.

전체 글 보기 →