Clash Meta · 오픈 소스 프록시 코어

Mihomo 코어 Clash 클라이언트 다운로드

mode: rule·tun.enable: true·dns.enhanced-mode: fake-ip Clash 다운로드

플랫폼별 클라이언트를 살펴보고 규칙 기반 라우팅, TUN 모드, DNS 설정 방법을 확인하세요.

가이드 보기 →
  • GPL-3.0 오픈 소스
  • YAML 설정
  • UDP 포워딩

Mihomo 설정과 네트워크 트래픽 처리

먼저 트래픽이 코어로 들어오는 경로를 확인한 다음, 요청을 내보낼 경로를 정하세요. 시스템 프록시와 TUN은 요청을 코어로 전달하고, 규칙과 프록시 그룹은 출구를 선택하며, DNS는 도메인 이름을 해석합니다. 아래 화면은 설정 항목을 보여주는 예시이며, 실제 메뉴 이름은 사용 중인 클라이언트에 따라 다를 수 있습니다.

RULES

프록시 모드와 규칙 기반 라우팅

규칙 모드는 설정된 순서에 따라 도메인과 대상 주소 등의 조건을 확인하고, 일치하는 규칙의 정책으로 요청을 전달합니다. 전역 모드는 전역 프록시 그룹을 사용하며, 직접 연결 모드는 프록시를 거치지 않고 연결합니다. 평소에는 구독에 포함된 규칙을 그대로 두고 연결 기록에서 어떤 규칙이 적용됐는지 확인하세요. 특정 사이트의 경로를 바꾸려면 더 구체적인 규칙을 포괄적인 규칙보다 앞에 두고, 지정한 정책 이름이 실제로 있는지 확인합니다. 모드를 바꾸면 출구 선택 방식만 달라집니다. 시스템 프록시가 자동으로 켜지는 것은 아니며 노드 연결 상태도 별도로 확인해야 합니다.

자세히 알아보기 →

TUN

가상 네트워크 인터페이스와 자동 라우팅

TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시 설정을 따르지 않는 앱에도 사용할 수 있습니다. 켜기 전에 클라이언트가 요구하는 권한을 부여하고, 기본 경로를 함께 처리하는 다른 VPN이 없는지 확인하세요. 자동 라우팅은 TUN으로 트래픽을 전달하는 경로를 설정합니다. 엄격 라우팅의 동작은 운영체제마다 다르므로 옵션 이름만으로 영향을 판단할 수 없습니다. 먼저 시스템 프록시로 설정이 정상 작동하는지 확인한 뒤 TUN을 별도로 켜세요. LAN이나 원격 연결에 문제가 생기면 라우팅 경로와 제외 주소부터 점검합니다.

자세히 알아보기 →

DNS

Fake-IP와 도메인 이름 해석

Fake-IP는 도메인에 대응하는 가상 주소를 반환해 코어가 이후 연결에서 원래 도메인을 식별하도록 합니다. 이 주소는 원격 서버의 실제 주소가 아니며, 사이트 콘텐츠가 로컬에서 제공된다는 뜻도 아닙니다. 설정할 때는 DNS 서버, 트래픽을 코어로 전달하는 방식, 앱 자체의 DNS 동작을 함께 고려해야 합니다. enhanced-mode만 바꿔도 모든 DNS 요청이 코어를 거치는 것은 아닙니다. 실제 주소가 필요한 LAN 서비스는 fake-ip-filter로 처리할 수 있습니다. 문제를 진단할 때는 이름 해석 실패와 연결 실패를 구분하고, 설정 파일 전체를 무작정 바꾸지 마세요.

자세히 알아보기 →

PROFILES

구독 가져오기와 설정 업데이트

클라이언트는 구독 링크나 로컬 파일에서 설정을 불러올 수 있지만, 다운로드가 완료됐다고 설정이 활성화된 것은 아닙니다. 가져온 뒤 해당 설정을 선택하고 파싱 결과를 확인한 다음, 프록시 그룹에 사용할 수 있는 항목이 있는지 살펴보세요. 전체 설정이 포함된 구독과 노드만 제공하는 프록시 목록은 용도가 다르므로 가져오는 위치를 서로 바꾸면 안 됩니다. 자동 업데이트 간격은 클라이언트 또는 provider 설정에 따라 달라집니다. 그림의 값은 항목 예시입니다. 개인 규칙은 클라이언트의 오버라이드 기능에 저장해 다음 업데이트 때 수동 변경 사항이 덮어써지지 않도록 하세요.

자세히 알아보기 →

증상별 설정 점검 경로

모든 옵션을 한꺼번에 바꿀 필요는 없습니다. 현재 증상에 맞는 항목부터 확인하고, 필요할 때 전체 가이드를 살펴보세요.

먼저 규칙 모드인지 확인한 다음 연결 기록에서 도메인, 적용된 규칙, 최종 정책 경로를 살펴보세요. 규칙이 일치하면 뒤에 있는 같은 종류의 규칙은 확인하지 않으므로 앞쪽의 포괄적인 조건이 뒤쪽의 구체적인 조건을 가릴 수 있습니다. 변경 전 결과를 기록하고, 변경 후에는 새 연결을 만들어 확인하세요. 기존 연결을 새 규칙의 테스트 결과로 착각하지 않도록 주의해야 합니다.

규칙 순서와 정책 그룹 가이드 →

Clash 클라이언트 플랫폼별 다운로드

그래픽 클라이언트는 설정 관리, 권한 요청, 실행 제어를 담당하고 코어는 네트워크 요청을 처리합니다. 처음 사용하는 경우 해당 운영체제용 클라이언트부터 시작하면 됩니다. 독립 코어를 먼저 설치할 필요는 없습니다. 아래 링크는 다운로드 센터의 플랫폼별 탭으로 연결되며, 설치 방법과 프로세서 아키텍처를 비교할 수 있습니다.

Windows

Clash Plus, Clash Verge Rev, FlClash 등 그래픽 클라이언트 중에서 선택할 수 있습니다. 설치 전에 시스템 정보에서 프로세서 아키텍처를 확인하세요. 설치 후 설정을 가져온 다음 시스템 프록시를 켜면 됩니다. TUN을 사용하려면 클라이언트 안내에 따라 서비스를 설치하고 권한을 부여하세요. 기존 클라이언트의 설정은 단계별로 옮겨야 합니다. 프록시 프로그램 두 개가 동시에 실행되어 수신 포트를 두고 충돌하지 않도록 주의하세요.

다운로드 페이지로 이동 →

macOS

Apple Silicon과 Intel 모델을 구분해 맞는 설치 파일을 선택하세요. 처음 실행할 때 보안 경고가 표시되면 앱의 출처를 확인한 뒤 시스템 설정 안내에 따라 진행합니다. 시스템 프록시, 백그라운드 서비스, TUN 권한은 서로 다른 설정입니다. 앱이 실행 중이라고 프록시도 작동하는 것은 아닙니다. 업그레이드 후에도 필요한 권한과 활성 설정을 다시 확인하세요.

다운로드 페이지로 이동 →

Android

필요한 기능에 따라 Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 클라이언트마다 지원하는 설정 형식이 완전히 같지는 않습니다. 처음 연결할 때는 일반적으로 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 앱별 프록시를 설정할 때는 앱을 포함할지 제외할지도 확인해야 합니다.

다운로드 페이지로 이동 →

iOS

다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 공식 사이트는 clashplus.io입니다. 설치 후 앱 안내에 따라 설정을 추가하고 VPN 권한을 허용한 뒤 정책을 선택해 연결하세요. 데스크톱 설정의 프로세스 규칙, 파일 경로, 시스템 라우팅 옵션이 모바일에서도 그대로 적용된다고 볼 수 없습니다. 앱에서 실제로 지원하는 범위를 확인하세요.

다운로드 페이지로 이동 →

Linux

데스크톱에서는 Clash Verge Rev와 FlClash를 살펴보고 배포판에 맞는 패키지를 선택하세요. 서버나 라우터에서 사용할 경우 독립 Mihomo 코어를 검토할 수 있으며, 설정 디렉터리와 서비스 실행, 권한을 직접 관리해야 합니다. 명령줄 앱은 데스크톱 시스템 프록시를 따르지 않을 수 있습니다. 테스트할 때는 트레이 아이콘 상태만 확인하지 말고 사용할 프록시 환경 변수나 TUN 라우팅을 명확히 지정하세요.

다운로드 페이지로 이동 →

설정은 옮길 수 있지만 시스템 설정은 다시 확인해야 합니다. 같은 YAML이라도 클라이언트별 코어 기능과 오버라이드 방식, 운영체제 권한에 따라 다르게 동작할 수 있습니다. 이전하기 전에 사용할 수 있는 설정을 내보내고 프록시 그룹 선택과 사용자 규칙을 기록하세요. 이전 후에는 기본 연결부터 확인한 다음 TUN, DNS 등 고급 설정을 차례로 복원합니다. 구독 주소는 민감 정보이므로 공개 스크린샷이나 코드 저장소, 게시판에 올리지 마세요.

모든 클라이언트 보기 →

OPEN SOURCE

코어 출처와오픈 소스 관리

Mihomo 코어, 그래픽 클라이언트, 구독 제공처는 각각 맡은 역할이 다릅니다. 이 관계를 이해하면 앱 이름만 보고 선택하는 것보다 클라이언트를 고르고 문제를 진단하기가 쉽습니다.

Clash Meta에서 Mihomo로

Mihomo 프로젝트는 Clash.Meta에서 시작한 Clash 생태계의 오픈 소스 프록시 코어입니다. 예전 가이드의 Clash Meta, 설정 문서의 mihomo, 클라이언트 설정 화면의 코어 이름은 같은 프로젝트를 가리키는 서로 다른 시기의 명칭일 수 있습니다. 설치 파일 이름만으로 판단하지 말고 실제 프로젝트 출처와 클라이언트의 코어 정보를 확인하세요. 프로젝트 코드와 변경 기록은 MetaCubeX/mihomo 저장소에서 볼 수 있습니다.

코어는 프로토콜 처리, 규칙 매칭, DNS, 네트워크 스택 관련 기능을 제공합니다. 그래픽 클라이언트는 이를 바탕으로 설정 선택, 구독 업데이트, 로그 확인 기능을 지원합니다. 화면에 옵션이 없다고 코어에 해당 기능이 없는 것은 아닙니다. 반대로 설정 항목이 보여도 현재 코어가 해당 값을 지원한다고 단정할 수 없습니다. 새 설정 항목을 수정하기 전에 현재 실행 환경에 맞는 문서를 확인하세요.

클라이언트와 설정의 역할

클라이언트 설치 파일에는 일반적으로 사용할 수 있는 원격 프록시 서비스가 포함되어 있지 않습니다. 노드 정보와 인증 정보, 구독 내용은 사용자가 선택한 설정 제공처에서 가져옵니다. 연결 가능 여부는 원격 서비스, 현재 네트워크, 프로토콜 설정에도 영향을 받습니다. 구독에 접속할 수 없거나 계정이 만료됐거나 원격 서버가 연결을 거부한다면 클라이언트 설치 문제로 단정하지 말고 해당 제공처부터 확인하세요.

그래픽 클라이언트마다 설정을 병합하는 순서가 다를 수 있습니다. 예를 들어 구독 설정에 오버라이드 레이어를 적용하는 방식도 있고, 다운로드한 파일을 직접 편집하면 업데이트 때 변경 내용이 사라질 수도 있습니다. 원본 구독, 개인 오버라이드, 실행 중인 설정을 구분해 관리하세요. 계속 유지할 규칙은 클라이언트가 지원하는 저장 위치에 두고 업데이트 후 실제 적용된 내용을 확인합니다.

오픈 소스 라이선스와 커뮤니티 기록

Mihomo 저장소는 GPL-3.0 오픈 소스 라이선스를 따릅니다. 소스 코드와 이슈 논의, 릴리스 노트는 설정 동작을 확인할 수 있는 근거입니다. 클라이언트와 부가 구성 요소의 라이선스는 각각 해당 라이선스 파일에서 확인해야 합니다. 이 사이트는 다운로드 수나 노드 수, 속도 측정 결과로 이런 근거를 대신하지 않습니다. 소프트웨어를 고를 때는 지원 기능과 실행 조건, 유지 관리 안내가 명확한지 살펴보세요.

커뮤니티에서 문제 사례를 찾을 때는 운영체제와 코어, 오류 메시지가 일치하는 사례를 우선 확인하세요. 비슷한 증상도 원인은 다를 수 있습니다. 웹페이지 시간 초과는 규칙 경로, DNS 해석, 원격 연결 중 어느 쪽에서든 발생할 수 있습니다. 문제를 보고할 때는 재현 단계와 민감 정보를 가린 로그를 첨부하고 구독 인증 정보, 비밀번호, 개인 네트워크 정보는 삭제하세요. 전체 설정 화면보다 재현 가능한 설명이 원인을 찾는 데 도움이 됩니다.

업데이트 전에 복구 가능한 상태 보관

그래픽 클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 화면과 권한 관리를 바꿀 수 있고, 코어 업데이트는 설정 지원 범위에 영향을 줄 수 있으며, 구독 업데이트는 원격 설정 내용을 교체합니다. 세 가지를 한 번에 업데이트한 뒤 테스트하면 문제가 생겼을 때 원인을 찾기 어렵습니다. 먼저 작동하는 설정을 보관한 다음 하나씩 업데이트하고 로그를 확인하세요.

평소에는 사용 중인 설정 출처, TUN 사용 여부, DNS 작동 모드, 사용자 규칙 위치를 간단히 기록해 두세요. 업그레이드 후에는 일반 웹페이지와 LAN 서비스를 먼저 테스트하고 UDP가 필요한 앱을 확인합니다. UDP 포워딩은 프로토콜과 노드, 원격 서비스, 로컬 트래픽 처리 경로가 모두 지원해야 합니다. 옵션 하나만 켠다고 모든 앱에서 같은 결과가 보장되지는 않습니다.

Mihomo 소스 코드 저장소 보기 ↗ GPL-3.0 YAML

Git이 설치되어 있다면 아래 명령으로 소스 코드를 내려받을 수 있습니다. 저장소를 클론해도 프로젝트 코드만 가져오며 클라이언트가 설치되거나 실행되지는 않습니다.

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

클라이언트 사용 및 문제 해결

최근 게시물 세 편에서는 Android 백그라운드 실행, 연결 후 단계별 점검, macOS 권한 문제를 다룹니다. 문제를 확인할 때는 트래픽 진입 경로, 도메인 해석, 규칙 적용, 원격 출구 순서로 점검하세요. 한 번에 조건 하나만 바꾸고 변경 전후의 증상을 기록해 두면 원인을 찾기 쉽습니다.

전체 게시물 보기 →