mihomo 코어 · Apple 실리콘 및 Intel 호환

Clash for Mac 클라이언트 다운로드

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

구독 가져오기부터 규칙과 분류까지, 필요에 따라 TUN 모드를 켜세요.

Windows Android iOS macOS Linux
  • mihomo 코어
  • 코어는 GPL-3.0 오픈 소스
  • Apple 실리콘 / Intel

CLIENT DOWNLOADS

Clash 전체 플랫폼 다운로드

먼저 운영체제와 프로세서를 확인한 뒤 클라이언트를 선택하세요. 데스크톱과 모바일은 라이선스 방식이 다르며, 구독 설정은 클라이언트가 지원하는 형식이어야 합니다.

Windows 클라이언트

우선 Clash Plus를 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu도 비교해 보세요. 설치 후 설정을 가져오고 시스템 프록시를 켜세요. 게임이나 명령줄 연결까지 처리해야 한다면 TUN 권한도 확인하세요. 다른 앱이 수신 포트를 사용 중이면 충돌을 먼저 해결한 다음 연결을 테스트하세요.

다운로드 페이지로 →
칩에 맞는 설치 파일 선택

macOS 클라이언트

Apple 메뉴에서 ‘이 Mac에 관하여’를 열어 프로세서를 확인하세요. Apple 실리콘이면 Apple 실리콘용, Intel이면 Intel용 설치 파일을 선택하면 됩니다. 다운로드 페이지에서는 Clash Plus를 우선 소개하고 Clash Verge Rev와 FlClash도 제공합니다. ClashX Meta는 보관용 옵션으로 남겨 두었습니다.

앱을 ‘응용 프로그램’으로 옮겨 실행한 뒤 시스템 안내에 따라 네트워크 관련 권한을 허용하세요. 먼저 시스템 프록시로 브라우저 연결을 확인하고, 필요한 경우 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를 확인하고 서비스 권한, 설정 경로, 수신 범위를 직접 관리할 수 있습니다.

다운로드 페이지로 →

구독은 연결 정보를 제공하고, 클라이언트는 이를 가져와 적용합니다. 설치를 마친 뒤에도 유효한 설정을 활성화해야 합니다. 기기를 옮길 때는 구독 주소만 복사하지 말고 정책 그룹 선택과 로컬 오버라이드도 함께 확인하세요.

모든 클라이언트 보기 → 클라이언트 선택 가이드 보기 →

MIHOMO CONFIGURATION

정책 그룹, 규칙 및 네트워크 연결 처리

macOS 창 화면을 보며 자주 쓰는 설정을 살펴보세요. 인터페이스 이름은 클라이언트마다 다를 수 있으며, 각 필드의 의미는 사용 중인 mihomo 코어 문서를 기준으로 확인하세요.

config.yaml · 정책 그룹 예시
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - Auto
      - DIRECT
  - name: Auto
    type: url-test
    use:
      - subscription
    url: https://www.gstatic.com/generate_204
    interval: 300
    tolerance: 50
type: url-test
설정 예시 · 별도로 provider 정의 필요

클라이언트의 프록시 페이지를 열어 규칙에 어떤 정책 그룹이 지정되어 있는지 확인한 뒤, 수동 정책이나 자동 테스트 그룹을 선택하세요. select는 직접 선택한 항목을 유지하고, url-test는 지정된 주소의 테스트 결과에 따라 후보 중 가장 적합한 항목을 선택합니다. 네트워크 환경이 자주 바뀌는 기기에 유용합니다. 두 그룹은 중첩할 수도 있습니다. 바깥 그룹이 선택 방식을 정하고 안쪽 그룹이 주기적으로 테스트합니다. 테스트 결과는 해당 시점에 테스트 주소까지의 연결 상태만 보여 주며, 모든 웹사이트의 실제 이용 경험을 보장하지는 않습니다. 예시에 나온 구독 provider는 전체 설정에서 정의해야 하며, 이 부분만 복사해서는 연결할 수 없습니다.

연결부터 확인하고 설정은 단계적으로 추가하세요

처음 사용할 때는 ‘설정 활성화, 정책 사용 가능 여부, 규칙 모드, 시스템 프록시’ 순서로 하나씩 확인하세요. 먼저 브라우저 연결을 테스트한 다음 연결 페이지에서 대상 도메인, 일치 규칙, 출구 정책을 확인합니다. 연결 기록이 없다면 트래픽이 아직 클라이언트에 들어오지 않은 것일 수 있습니다. 기록은 있는데 연결이 실패하면 정책 선택, DNS 결과, 상위 서버 연결 상태를 차례로 점검하세요. 이렇게 하면 연결 진입 문제와 출구 문제를 나눠 파악할 수 있어 앱을 반복해서 재설치하지 않아도 됩니다.

직접 분기 규칙을 만들려면 클라이언트의 로컬 오버라이드 기능을 우선 사용해 업무용 도메인, 로컬 네트워크 예외, 고정 정책을 따로 저장하세요. 구독에서 다운로드한 설정 파일을 직접 수정하면 업데이트 후 변경 내용이 사라질 수 있습니다. 한 번에 한 종류의 설정만 바꾸고 연결되는 설정 사본을 보관하세요. 문제가 생기면 되돌려 수정 전후 동작을 비교할 수 있습니다. 필드 의미, 조합 제한, 더 자세한 YAML 예시는 mihomo 고급 설정 가이드에서 확인하세요. 처음 가져오는 경우에는 구독 가져오기 가이드부터 시작하세요.

OPEN SOURCE CONTEXT

Clash 생태계와 mihomo 오픈 소스 코어

클라이언트, 코어, 구독을 구분해 두면 업데이트, 기기 이전, 문제 해결 시 확인할 위치가 분명해집니다.

클라이언트 UI와 프록시 코어의 역할

클라이언트에서 설정을 가져오고 정책을 전환하거나 연결 기록을 확인하는 작업은 그래픽 인터페이스가 담당합니다. 실제 설정 해석, 규칙 처리, 프록시 연결은 코어가 수행합니다. mihomo는 Clash Meta의 관련 작업을 이어받아 발전시킨 프로젝트이므로 가이드에서 Clash, Clash Meta, mihomo라는 이름을 모두 볼 수 있습니다. 이름이 비슷하다고 모든 클라이언트의 기능 메뉴가 같거나, 오래된 코어가 현재 문서의 모든 필드를 읽을 수 있다는 뜻은 아닙니다. 설정 오류가 발생하면 먼저 실행 중인 코어를 확인한 뒤 클라이언트가 설정을 전달하는 방식을 살펴보세요.

클라이언트를 선택할 때는 운영체제 호환성, 설정 관리 방식, 오버라이드 기능, 권한 설정 절차를 중점적으로 비교하세요. 같은 코어를 사용하는 클라이언트라도 기본값, 메뉴 구성, 서비스 설치 방식은 다를 수 있습니다. 기기를 옮길 때 호환되는 구독은 재사용할 수 있지만, 시스템 프록시, 로그인 시 실행, TUN 권한, 로컬 오버라이드는 새 클라이언트에서 다시 확인해야 합니다. 새 클라이언트를 테스트하기 전에 기존 클라이언트를 종료하면 수신 포트, 시스템 프록시, 가상 네트워크 인터페이스 간 충돌을 줄일 수 있습니다.

프로젝트 이력과 보관된 클라이언트

Clash 생태계에는 계속 발전하는 코어와 인터페이스도 있고, 유지보수가 중단된 과거 클라이언트도 있습니다. 예전 가이드의 화면은 참고할 수 있지만 다운로드 위치, 설정 필드, 시스템 권한 안내는 달라졌을 수 있습니다. 다운로드 페이지에서는 보관된 클라이언트와 현재 선택 가능한 클라이언트를 구분해 기존 설정의 호환성을 확인하기 쉽게 했습니다. 새 기기에는 지속적으로 유지보수되는 옵션을 우선 사용하세요. 오래된 설정을 옮길 때는 원본 파일을 보관한 다음 포트, DNS, 정책 그룹, 규칙 참조를 항목별로 확인하세요.

오래된 인터페이스가 실행된다고 해서 새 설정 문법까지 처리할 수 있는 것은 아닙니다. 마찬가지로 새 코어가 특정 필드를 지원하더라도 클라이언트 UI에 해당 설정 메뉴가 있다는 뜻은 아닙니다. 설정을 불러오지 못하면 로그에 표시된 필드명과 행 번호를 먼저 확인하고 YAML 들여쓰기, 정책 그룹 이름, provider 참조가 서로 맞는지 살펴보세요. 그다음 기능 호환성을 확인하면 됩니다. 설정 전체를 한꺼번에 바꾸기보다 문제를 한 필드나 최소한의 설정 조각으로 좁히는 편이 원인을 찾기 쉽습니다.

소스 코드, 라이선스 및 문제 제보

mihomo 소스 코드는 MetaCubeX의 공개 저장소에서 관리되며 코어는 GPL-3.0 라이선스를 따릅니다. 저장소의 문서, 커밋 기록, 이슈 토론은 기능 변경을 확인하는 데 도움이 됩니다. 그래픽 클라이언트의 코드와 라이선스는 각 프로젝트에서 별도로 확인하세요. 이 사이트는 다운로드 경로와 중국어 사용 가이드를 정리하며 클라이언트, 코어, 구독 서비스는 각 운영 주체가 제공합니다. 문제를 제보할 때는 UI 버튼이 작동하지 않는지, 설정이 제대로 전달되지 않는지, 코어가 연결을 받았지만 처리에 실패하는지를 구분하세요.

로그를 공유하기 전에 구독 주소에 포함된 인증 정보, 서버 정보, 개인을 식별할 수 있는 내용을 삭제하세요. 운영체제, 프로세서 아키텍처, 작업 순서, 오류 메시지와 민감한 정보를 가린 최소 설정은 재현을 위해 남겨 둘 수 있습니다. 코어를 직접 읽거나 빌드하려면 옆의 명령으로 소스 코드를 내려받으세요. 일반 사용자는 그래픽 클라이언트를 선택하면 되며 소스 코드 다운로드는 클라이언트 설치에 필수적이지 않습니다.

앱 업데이트와 구독 업데이트

앱 업데이트는 보통 UI, 시스템 통합 또는 함께 제공되는 코어를 바꿉니다. 구독 업데이트는 연결 정보, 정책, 규칙을 새로 가져오는 별개의 과정입니다. 앱을 업데이트한 뒤에는 기존 설정이 여전히 활성화되어 있는지, 권한과 서비스가 정상인지 확인하세요. 구독을 업데이트한 뒤에는 직접 선택한 정책이 유지되는지, 로컬 오버라이드가 계속 적용되는지, 규칙 세트가 제대로 로드됐는지 살펴보세요. 두 업데이트를 나눠 확인하면 어떤 변경이 연결에 영향을 줬는지 파악하기 쉽습니다.

영향 범위가 큰 설정을 바꾸기 전에 연결 가능한 설정과 로컬 오버라이드를 저장해 두세요. 네트워크 환경, 구독 내용, 클라이언트 설정이 동시에 바뀌면 웹페이지 하나가 열리는지만으로는 문제를 찾기 어렵습니다. 대상 사이트 열기, 연결 기록 확인, 규칙 일치 확인, 출구 정책 확인 순으로 검증하는 절차를 고정해 두세요. 테스트가 끝나면 일상 모드로 되돌려 임시 전역 설정이 이후 사용에 남지 않도록 하세요.

설치 및 사용 관련 자주 묻는 질문

설치 후 구독 링크는 어디에 입력하나요?

클라이언트의 설정 페이지를 열고 새 설정 만들기 또는 가져오기를 선택한 다음 호환되는 구독 URL을 붙여넣으세요. 다운로드가 끝나면 해당 설정을 활성화하고 프록시 페이지에서 정책 그룹을 확인합니다. 버튼 이름은 클라이언트마다 조금 다를 수 있으니 구독 가져오기 절차에서 순서를 확인하세요.

시스템 프록시와 TUN을 함께 켜야 하나요?

먼저 시스템 프록시를 사용해 시스템 설정을 따르는 앱의 연결을 확인하세요. 다른 앱도 연결 처리해야 한다면 클라이언트 안내에 따라 TUN을 설정하고 권한, 라우팅, DNS를 확인하세요. 두 방식의 적용 범위와 구체적인 점검 방법은 고급 설정 가이드에서 확인할 수 있습니다.

구독을 업데이트한 뒤 사용자 지정 규칙을 유지하려면 어떻게 하나요?

구독에서 생성된 파일을 직접 수정하기보다 클라이언트의 로컬 오버라이드나 병합 설정에 규칙을 추가하세요. 업데이트 후 연결 페이지에서 규칙 일치를 확인하고 사용자 지정 규칙이 기본 규칙보다 앞에 있는지 확인합니다. 자주 발생하는 설정 문제는 도움말 센터에서 더 찾아볼 수 있습니다.

웹페이지는 열리지만 다른 앱은 연결되지 않나요?

먼저 해당 앱의 연결이 클라이언트에 들어오는지 확인하세요. 기록이 있으면 일치 규칙, 선택된 정책, DNS를 점검하고, 기록이 없으면 앱의 프록시 설정이나 트래픽 처리 방식을 확인하세요. 명령줄 도구는 프록시 환경 변수를 별도로 설정해야 할 수 있습니다. 자세한 문제 해결은 문제 해결 Q&A를 참고하세요.

CONFIGURATION NOTES

Clash 설정 및 규칙 분기 가이드

설정 필드 이해부터 분기 결과 확인까지, 필요한 주제를 골라 읽어보세요.

전체 글 보기 →