오픈 소스 mihomo 코어 · 데스크톱 클라이언트

Clash PC 버전 · Windows·macOS 데스크톱 클라이언트 다운로드

Clash 다운로드 가이드 보기

mihomo 코어 기반 클라이언트 선택과 설정을 안내합니다. 구독 가져오기, 규칙 기반 라우팅, 데스크톱 프록시 설정을 다룹니다.

오픈 소스 다중 플랫폼 한국어 문서
  • 코어 mihomo
  • 코어 오픈 소스 라이선스 GPL-3.0
  • 5개 플랫폼 지원
  • 기본 혼합 포트 7890

설정 화면 예시이며, 실제 메뉴 이름은 클라이언트마다 다를 수 있습니다.

설정 기능

규칙 기반 라우팅과 로컬 프록시 설정

먼저 트래픽이 코어로 들어오는 방식을 확인한 다음, 어떤 정책으로 처리할지 정하세요. 아래 예시는 mihomo 설정 문법을 기준으로 하며, 그래픽 인터페이스에서는 이러한 설정을 메뉴로 구성해 조작할 수 있습니다.

규칙 기반 라우팅

도메인, IP, 규칙 세트를 순서대로 대조합니다.
처음 일치한 규칙에 지정된 정책을 적용하고, 나머지 요청은 마지막 MATCH로 처리합니다.

rules · YAML 목록 내용
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
MATCH,PROXY

정책 그룹 유형

수동 선택, 자동 테스트, 장애 시 대체 경로를 각각 설정합니다.
규칙에서 그룹 이름을 참조하고, 그룹 안에서 실제 사용할 프록시 출구를 선택합니다.

proxy-groups · type
  • select
  • url-test
  • fallback
  • load-balance

프록시 모드 전환

일상적인 트래픽 분기에는 규칙 모드를, 비교·문제 해결에는 전역 모드를 사용하세요.
직접 연결 모드는 코어의 처리 방식을 바꾸며 클라이언트를 종료하는 기능은 아닙니다.

규칙전역직접 연결

포트 및 LAN

혼합 포트는 HTTP 및 SOCKS 프록시 연결에 사용됩니다.
신뢰할 수 있는 기기에 프록시를 제공해야 할 때만 LAN 연결을 허용하세요.

혼합 포트7890
LAN 연결 허용

설정 항목별 사용 방법

먼저 어떤 규칙이 적용됐는지 확인하고 출구를 변경하세요

연결 페이지에서 대상 앱이 보낸 요청을 찾아 적용된 규칙과 정책 경로를 확인하세요. 사용자 지정 도메인 규칙은 범위가 넓은 규칙보다 앞에 두고, 마지막에 기본 처리용 MATCH를 배치해야 합니다. 앞선 규칙이 트래픽을 처리하면 뒤에 있는 예외 규칙은 적용되지 않습니다. 예시의 PROXY는 설정에 실제로 등록해야 하는 정책 그룹 이름입니다. 고정 프록시 주소 하나만 설정하는 것과 달리 규칙 모드에서는 대상별로 경로를 다르게 지정할 수 있지만, 정확도는 도메인 식별, DNS 설정, 규칙 순서에 따라 달라집니다.

규칙 세트와 로컬 오버라이드 보기 →

다운로드

운영체제에 맞는 클라이언트 선택

다운로드 센터에서 플랫폼별 클라이언트와 설치 파일을 확인할 수 있습니다. 데스크톱 사용자는 먼저 그래픽 클라이언트를 선택하고, 서버나 라우터 사용자는 독립 코어를 검토하세요. 설치 및 설정 방법은 서로 다릅니다.

Windows

데스크톱에서 사용할 클라이언트로 Clash Plus를 먼저 살펴보고 Clash Verge Rev, FlClash 등과 비교해 보세요. 설치 전에 시스템의 ‘정보’에서 프로세서 종류를 확인하고 다운로드 항목에 안내된 설치 파일을 선택하세요.

처음 실행하면 구독을 가져오고 시스템 프록시가 작동하는지 확인하세요. TUN이 필요하다면 클라이언트 안내에 따라 서비스를 설치하거나 관리자 권한을 부여하세요. 여러 설정을 한꺼번에 켜면 문제 원인을 찾기 어려워집니다.

다운로드

macOS

‘이 Mac에 관하여’에 표시된 칩에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 메뉴 구성이 서로 다르므로 평소 사용 방식에 맞춰 고르면 됩니다.

앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 실행하고, 네트워크 서비스 및 권한 요청을 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 터미널 도구는 프록시 연결을 별도로 설정해야 할 수 있습니다.

다운로드

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 라우팅 방식을 사용하세요.

다운로드

처음 사용하는 경우 다운로드 센터에서 먼저 추천하는 Clash Plus로 시작한 다음, 비교 리뷰에서 설정 편집, 서비스 관리, 플랫폼 지원이 필요한 조건에 맞는지 확인하세요. 유지 관리가 중단된 클라이언트는 과거 호환성을 위한 참고용일 뿐입니다. 익숙한 인터페이스라는 이유만으로 유지 관리 상태를 무시하지 마세요. 클라이언트를 다운로드해도 구독이 생성되거나 사용할 수 있는 프록시 출구가 자동으로 제공되지는 않습니다. 설정을 제공받는 일과 클라이언트를 설치하는 일은 별개입니다.

전체 클라이언트 보기 → 클라이언트 비교 리뷰 보기 →

빠른 시작

가져오기·활성화·연결 확인

처음 설정할 때는 확인 가능한 경로 하나만 구성하세요. 설정 하나를 활성화하고 정책 그룹 하나를 선택한 다음 트래픽 유입 방식 하나를 켭니다. 정상 작동을 확인한 뒤 자동 업데이트와 고급 규칙을 추가하세요.

  1. 구독 설정 가져오기

    ‘설정’ 페이지에서 신뢰할 수 있는 출처의 구독 주소를 붙여넣고 가져오기를 선택하거나 원격 설정을 새로 만드세요. 다운로드와 파싱이 끝나면 설정 항목이 생성됐는지 확인하고 현재 설정으로 지정하세요.

    링크만 저장하고 설정을 활성화하지 않으면 프록시 페이지가 비어 있을 수 있습니다. 파싱에 실패하면 먼저 로그에서 형식 오류나 네트워크 오류를 확인하세요. 구독 주소를 공개 스크린샷, 댓글, 문의 내용에 붙여넣지 마세요.

    구독 가져오기 방법 보기 →

  2. 모드와 트래픽 유입 경로 선택

    프록시 페이지에서 규칙 모드를 사용하고, 수동 선택 정책 그룹의 출구를 지정하세요. 그런 다음 설정 페이지에서 시스템 프록시를 켜고 혼합 포트가 클라이언트에 표시된 값과 일치하는지 확인하세요. 평소에는 기본 포트를 바꿀 필요가 없습니다.

    먼저 시스템 프록시를 따르는 브라우저로 확인하세요. 대상 앱이 시스템 프록시를 사용하지 않거나 더 많은 트래픽을 처리해야 할 때만 TUN 모드의 권한, DNS, 라우팅 설정을 살펴보세요.

    시스템 프록시 설정 보기 →

  3. 요청 및 규칙 확인

    확인이 필요한 웹사이트에 접속하면서 클라이언트의 연결 페이지를 열어 해당 요청이 표시되는지 확인하고 적용된 규칙과 정책 그룹을 살펴보세요. 클라이언트가 실행 중이라고 해서 트래픽이 코어로 들어간 것은 아닙니다. 연결 기록을 확인하는 편이 정확합니다.

    요청 기록이 없다면 먼저 프록시 연결 경로를 확인하세요. 기록은 있지만 접속에 실패한다면 출구, 도메인 확인, 로그를 살펴보세요. 이 순서로 점검하면 모드, 포트, DNS를 한꺼번에 바꾸는 것보다 원인을 찾기 쉽습니다.

    문제 해결 FAQ 보기 →

전체 가이드 보기 →

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

Clash, mihomo와 그래픽 클라이언트

프로젝트를 구분할 때는 코어, 인터페이스, 설정 출처를 각각 확인하세요. 이름에 Clash가 들어간다고 해서 같은 관리자가 배포했거나 기능과 설정 문법이 완전히 같다는 뜻은 아닙니다.

코어는 네트워크 및 규칙 처리를 담당합니다

Clash 생태계는 초기 코어와 설정 방식을 바탕으로 발전했으며, 이후 여러 포크와 그래픽 클라이언트가 등장했습니다. mihomo는 이러한 설정 및 트래픽 분기 기능을 계승하고 확장해 프록시 프로토콜 처리, 규칙 매칭, DNS, 네트워크 스택 등을 담당합니다. 데스크톱 창의 이름도 구독 서비스도 아닙니다.

데스크톱 클라이언트는 설정 가져오기, 정책 선택, 로그 확인, 시스템 연동을 메뉴로 제공하고 로컬 오버라이드나 서비스 관리 기능을 추가하기도 합니다. 같은 코어라도 인터페이스에 따라 설정 메뉴 위치가 달라질 수 있으므로 버튼의 위치보다 기능 이름을 확인하는 것이 중요합니다. 페이지 상단의 창은 설정 간 관계를 설명하기 위한 예시이며, 모든 클라이언트의 인터페이스가 같다는 뜻은 아닙니다.

유지 관리 상태와 업데이트 종류를 구분하세요

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 시스템 호환성을 바꿀 수 있고, 코어 업데이트는 프로토콜, DNS, 규칙 동작에 영향을 줄 수 있습니다. 구독 업데이트는 주로 프록시 출구와 설정 내용을 교체합니다. 문제가 생기면 최근에 변경된 계층이 무엇인지 기록해 설정을 복원할지, 코어 변경 사항을 확인할지, 클라이언트 릴리스 정보를 살펴볼지 판단하세요.

프로젝트를 선택할 때 이름이나 인터페이스만 보지 말고 공개 저장소의 라이선스, 커밋 기록, 이슈 논의, 릴리스 내역을 확인하세요. mihomo 코어는 GPL-3.0 라이선스를 따르며, 각 클라이언트의 라이선스는 별도로 확인해야 합니다. 이 사이트의 다운로드와 가이드는 선택에 필요한 정보를 정리한 것이며, 각 오픈 소스 프로젝트의 유지 관리 안내를 대신하지 않습니다. 서로 다른 프로젝트를 하나의 공식 배포판으로 묶어 부르지도 않습니다.

mihomo 소스 코드 보기

아래 명령은 공개 저장소에서 소스 코드를 가져옵니다. 사용하려면 컴퓨터에 Git이 설치되어 있어야 합니다. 저장소를 복제하면 코드 읽기와 개발에 사용할 수 있지만 데스크톱 클라이언트가 자동으로 설치되지는 않습니다. 일반 사용자는 다운로드 센터에서 그래픽 설치 파일을 선택하세요.

mihomo 오픈 소스 저장소 방문 → 
git clone https://github.com/MetaCubeX/mihomo.git

설정 문제는 해당 계층별로 확인하세요

연결은 되지만 일부 도메인에 문제가 있다면 고급 가이드의 DNS 확인 경로를 살펴보세요. 가상 네트워크 어댑터를 켠 뒤에만 문제가 생긴다면 TUN 및 Fake-IP를 확인하세요. 구독 업데이트 후 로컬 규칙이 사라졌다면 규칙 세트와 오버라이드 순서를 살펴보세요. 설정들은 서로 연관되어 있지만 로그 근거 없이 한꺼번에 변경하지 마세요. Clash DNS 유출 여부를 판단할 때는 앱 자체의 암호화 DNS 사용 여부, 실제 라우팅, DNS 요청의 출구도 확인해야 합니다. 스위치 하나만으로는 결론을 내릴 수 없습니다.

최근 게시물

데스크톱 사용 및 설정 문제 해결

구체적인 문제를 기준으로 확인하세요. 앱이나 설정이 어떤 단계에 있는지 먼저 파악한 다음 메뉴와 로그를 하나씩 살펴보면 됩니다. 최근 게시물 세 편을 소개합니다.

전체 게시물 보기 →