오픈 소스 클라이언트 모음 mihomo 코어

Clash 배포 페이지크로스 플랫폼 클라이언트 다운로드

Clash 다운로드 사용 가이드 보기

크로스 플랫폼 클라이언트, 규칙 기반 라우팅, 한국어 설정 가이드를 정리했습니다. 기기에 맞는 클라이언트를 선택하고 코어별 기능을 확인하세요.

오픈 소스 코어설정 참고마이그레이션 가이드

Clash 클라이언트 다운로드

먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 트레이 관리와 설정 편집이 중요하고, 모바일에서는 백그라운드 권한, 배터리 설정, 시스템 네트워크 인터페이스도 고려해야 합니다. 이름이 비슷한 클라이언트라도 설치 파일, 코어, 구독 형식이 모두 호환되는 것은 아닙니다.

Windows 클라이언트

Clash Plus를 우선 추천하며 Clash Verge Rev, FlClash, Clash Nyanpasu도 선택할 수 있습니다. 설치 전에 시스템 유형을 확인하고, TUN을 사용하려면 클라이언트 안내에 따라 서비스 권한을 설정하세요. Clash for Windows는 지원이 중단되었습니다. 기존 환경에서 이전할 때는 프로그램 폴더만 복사하지 말고 구독, 오버라이드 규칙, 시스템 프록시 포트도 함께 확인하세요.

다운로드 페이지로 이동

macOS 클라이언트

Clash Plus를 우선 추천합니다. Clash Verge Rev와 FlClash는 데스크톱 규칙 관리에 사용할 수 있습니다. 시스템 정보에서 Apple Silicon 또는 Intel을 확인한 뒤 알맞은 설치 파일을 선택하세요. 네트워크 서비스를 허용한 후 다른 프록시 도구가 시스템 설정을 제어하고 있지 않은지 확인하세요. 보관된 ClashX Meta는 기존 설정을 살펴볼 때 참고할 수 있지만, 새 환경의 기본 선택으로는 권장하지 않습니다.

다운로드 페이지로 이동

Android 클라이언트

Clash Plus를 우선 추천하며 Clash Meta for Android, FlClash, Surfboard에 대한 선택 정보도 제공합니다. 최신 기기는 대부분 ARM64를 사용하지만 시스템 정보에서 직접 확인하는 것이 좋습니다. 처음 연결할 때는 시스템 VPN 권한을 허용하고, 백그라운드에서 연결이 끊기면 배터리 최적화 설정을 확인하세요. Surfboard는 Clash YAML과 설정 체계가 다르므로 구독 주소를 무조건 함께 사용할 수는 없습니다.

다운로드 페이지로 이동

iOS 클라이언트

Clash Plus를 우선 추천합니다. 다운로드 페이지에서 App Store와 공식 웹사이트 clashplus.io로 이동할 수 있습니다. 설정을 가져온 뒤 시스템 안내에 따라 VPN 구성을 허용하고 규칙과 정책 그룹이 제대로 로드되었는지 확인하세요. iOS 클라이언트는 시스템에서 허용하는 네트워크 인터페이스를 사용하므로 데스크톱의 서비스 모드, 포트 제어, 코어 교체 절차를 그대로 적용할 수 없습니다.

다운로드 페이지로 이동

Linux 클라이언트

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식으로 설치할 수 있습니다. 프록시 전환은 데스크톱 환경과 앱 지원 여부에 따라 달라지며, 터미널 도구는 환경 변수를 별도로 설정해야 할 수도 있습니다. 서버나 라우터에서 사용할 경우 다운로드 페이지에서 mihomo 코어를 확인하세요. 서비스를 실행하기 전에 설정 디렉터리, 수신 범위, 권한을 명확히 지정해 로컬 포트가 LAN에 노출되지 않도록 하세요.

다운로드 페이지로 이동

mihomo 코어와 설정 기능

GUI는 관리를 담당하고 코어는 연결을 처리합니다. 아래 설정은 필드 예시이며 그대로 가져와 사용할 수 있는 완성된 구독 설정이 아닙니다. 실제 사용 전에는 정책 그룹과 연결 정보를 직접 채워야 합니다.

규칙 기반 라우팅: 대상에 따라 연결 경로 선택

규칙 모드에서는 목록 순서대로 도메인, IP 대역, 규칙 세트를 확인하고 처음 일치하는 항목을 지정된 정책으로 전달합니다. 이를 활용하면 로컬 서비스, 업무 리소스, 그 밖의 트래픽을 서로 다른 경로로 나눌 수 있어 모든 연결이 하나의 출구를 공유하지 않아도 됩니다. 문제를 해결할 때는 먼저 연결 페이지에서 적용된 규칙을 확인한 다음 정책 그룹의 현재 선택을 살펴보세요. 규칙이 많다고 반드시 정확도가 높아지는 것은 아닙니다. 단일 프록시 전환만 제공하는 도구와 달리 mihomo에서는 규칙 출처를 별도로 관리할 수 있지만, 규칙 세트 형식과 업데이트 주기를 이해해야 합니다. 아래 예시는 로컬 규칙 파일을 참조하므로 실제 정책 이름은 설정에 있는 그룹 이름과 일치해야 합니다.

Clash 다운로드프로토콜 문서 보기 →
rule-providers:
  work:
    type: file
    behavior: domain
    path: ./rules/work.yaml
rules:
  - RULE-SET,work,DIRECT
  - MATCH,PROXY

Clash 사용 가이드: 3단계 미리보기

먼저 최소한의 연결을 구성한 뒤 트래픽을 가로채는 범위를 넓히세요. 각 단계를 마칠 때마다 확인 가능한 결과를 남기면 구독 오류, 정책 선택, 시스템 설정을 한꺼번에 점검하는 일을 피할 수 있습니다.

  1. 구독 가져오기 및 설정 적용 확인

    구독 주소나 YAML 파일을 가져온 뒤 해당 설정을 선택하세요. 정책 그룹이 표시되고 파싱 오류가 없는지 확인합니다. 구독 주소는 공개하지 말고, 도움을 요청할 때는 오류 내용에서 인증 정보를 삭제하세요.

  2. 규칙 모드와 연결 정책 선택

    규칙 모드를 유지하고 필요한 정책 그룹에서 연결을 선택하세요. 지연 시간 테스트가 실제 속도를 보장하지는 않습니다. 브라우저 접속부터 확인하고, 시스템 프록시로 충분하다면 TUN은 나중에 설정하세요.

  3. 연결, DNS, 종료 후 복구 확인

    연결 페이지에서 대상, 적용 규칙, 실제 연결 경로를 확인하세요. 앱과 LAN 접속도 테스트합니다. 종료 전 시스템 프록시를 끄고 일반 접속이 복구되는지 확인하세요. 자세한 문제 해결 절차는 가이드를 참고하세요.

전체 가이드 보기 →

Clash 오픈 소스 생태계와 유지 관리 범위

클라이언트, 코어, 설정 출처는 서로 독립된 세 가지 계층입니다. 각 계층의 역할을 이해하면 소프트웨어 이름만 외우는 것보다 마이그레이션, 업데이트, 문제 해결에 도움이 됩니다.

프로젝트 이력: 기존 버전과 후속 포크 구분

Clash는 YAML 설정, 규칙, 정책 그룹을 중심으로 한 사용 방식이 자리 잡았고, 이후 클라이언트들은 이 인터페이스를 바탕으로 GUI 관리 기능을 제공했습니다. 기존 프로젝트와 일부 초기 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티 포크는 프로토콜과 네트워크 스택 기능을 확장했습니다. 오래된 가이드를 찾았다면 화면이 비슷하다는 이유로 모든 절차를 그대로 따르지 말고, 먼저 해당 클라이언트 이름을 확인한 다음 현재 화면과 필드 설명을 대조하세요.

Clash for Windows와 Clash Verge Rev는 서로 다른 프로젝트입니다. 전자의 지원이 중단되었다고 Clash 생태계의 모든 클라이언트 업데이트가 멈춘 것은 아니며, 후자도 기존 프로그램 폴더를 덮어쓰는 방식으로 이전할 수 없습니다. 기존 환경의 구독 주소, 단축키, 서비스 구성 요소, 오버라이드 스크립트를 각각 기록하세요. 마이그레이션 후에는 기존 설정 백업을 보관하고 새 환경이 작동하는지 확인한 뒤 이전 서비스와 남아 있는 프록시 설정을 정리하세요.

코어 계보: Meta와 mihomo

Clash Meta는 mihomo의 역사를 이해하는 데 중요한 이름입니다. 오래된 글에는 두 이름이 함께 나오는 경우가 많지만, 실제 지원 여부는 현재 실행 중인 코어와 해당 문서를 기준으로 확인해야 합니다. GUI 클라이언트의 설정 화면에서는 일부 필드가 보이지 않을 수 있고, 자체 오버라이드 기능으로 최종 설정을 생성하기도 합니다. 따라서 화면에 스위치가 없다고 코어가 해당 기능을 지원하지 않는다고 단정할 수는 없습니다. 반대로 화면에서 필드를 입력할 수 있어도 실제 실행 확인을 대신하지는 못합니다.

mihomo 코어는 GPL-3.0 오픈 소스 라이선스를 사용하며, 프로젝트 저장소에서 코드, 릴리스 기록, 이슈 논의를 확인할 수 있습니다. GUI 클라이언트, 아이콘 자산, 구독 서비스의 라이선스와 유지 관리 방식은 각각 확인해야 하며 코어 라이선스만으로 이를 추정할 수 없습니다. 이 사이트는 다운로드 선택과 한국어 자료를 정리합니다. 구체적인 구현 내용은 해당 프로젝트의 문서, 소스 코드, 릴리스 노트를 기준으로 확인하세요.

업데이트 방식: 프로그램과 설정을 분리

클라이언트, 코어, 구독 업데이트는 서로 다른 부분을 변경합니다. 클라이언트 업데이트는 화면, 서비스 구성 요소, 설정 병합 방식을 바꿀 수 있고, 코어 업데이트는 필드 파싱, 프로토콜 동작, DNS 처리에 영향을 줄 수 있습니다. 구독 업데이트는 주로 연결 리소스와 상위 규칙을 바꿉니다. 업데이트 후 문제가 생기면 먼저 어느 계층이 바뀌었는지 기록하고 보관해 둔 설정 복사본으로 재현해 보세요. 여러 구성 요소를 한꺼번에 바꾸지 않는 것이 좋습니다.

업그레이드 전에 릴리스 노트를 읽고 로컬 오버라이드와 필요한 로그를 저장하세요. 로그에서는 오류 발생 시각, 대상, 적용 규칙을 확인하고 공유하기 전에 구독 주소와 인증 정보를 삭제해야 합니다. 계속 사용하는 기기라면 이해하기 쉽고 되돌릴 수 있는 업데이트 경로를 우선하세요. 테스트 채널은 특정 수정 사항을 검증할 때 유용하지만, 이름이 새롭다는 이유만으로 안정적으로 작동하는 환경을 바꾸지는 마세요. 다운로드 페이지에서는 설치 옵션을 안내하며 홈페이지에는 특정 릴리스 번호를 고정하지 않습니다.

커뮤니티 협업: 재현 가능한 정보로 문제 찾기

문제를 효과적으로 기록하려면 운영체제, 클라이언트, 실행 모드, 오류가 발생한 단계와 함께 브라우저, 터미널 요청, LAN 서비스에서 각각 어떻게 나타나는지 적어야 합니다. “연결 실패”라는 설명이나 지연 시간 결과 하나만으로는 원인을 판단하기 어렵습니다. 먼저 간단한 설정으로 문제를 재현한 뒤 규칙과 오버라이드를 하나씩 복원하면 연결 리소스, 설정 조합, 로컬 환경 중 어디에 원인이 있는지 파악하는 데 도움이 됩니다.

자세히 확인하려면 프로토콜 문서에서 프로토콜 선택 기준을 살펴보고, 용어집에서 필드 의미를 확인하거나 자주 묻는 질문에서 증상별 해결 방법을 찾아보세요. 오픈 소스 협업의 장점은 구현을 살펴보고 변경 사항을 추적하며 문제를 논의할 수 있다는 점입니다. 모든 플랫폼과 설정이 같은 환경에서 동작한다고 가정하는 것이 아닙니다.

mihomo 소스 코드 저장소

저장소를 클론하는 작업은 구현과 릴리스 기록을 살펴보기 위한 것으로, 일반 사용자가 클라이언트를 설치할 때 필요한 절차는 아닙니다. 빌드 의존성과 명령은 저장소 안내를 확인하세요.

MetaCubeX/mihomo 보기 → 
git clone https://github.com/MetaCubeX/mihomo.git

Linux 펭귄 그래픽: Font Awesome, CC BY 4.0 라이선스; 단색으로 표시.

설정 및 문제 해결 기록

증상을 명확히 파악한 뒤 로그, 설정, 네트워크 경로를 차례로 확인하세요. 아래는 최근 게시물 3개이며 기본 설치를 마친 후 필요한 내용을 참고할 수 있습니다.

전체 게시물 보기 →