mihomo 코어 · 멀티 플랫폼 클라이언트

Clash 다운로드 센터멀티 플랫폼 클라이언트와 mihomo 설정 가이드

Clash 다운로드 가이드 보기

먼저 구독을 가져오고, 설정 설명을 참고해 규칙 분기와 TUN 모드를 이해하세요.

오픈 소스 생태계한국어 문서설정 예제
구독 가져오기 profile
https://example.com/sub?token=xxxx
구독 주소 예시가져오기

구독 가져오기

설정 소스를 추가한 다음 정책 그룹을 확인하세요.
아웃바운드 모드 mode
규칙전역직접 연결
mode: rule

아웃바운드 모드

용도에 따라 규칙, 전역 또는 직접 연결을 선택하세요.
규칙 매칭 rules
DOMAIN-SUFFIX,github.com,PROXY
정책 그룹 매칭 PROXY

규칙 매칭

첫 번째로 일치하는 규칙에 따라 아웃바운드가 결정됩니다.
가상 네트워크 인터페이스 tun
TUN 모드 · 활성화 예시
stack: mixed

TUN 모드

가상 네트워크 인터페이스와 트래픽 처리 범위를 알아보세요.

Clash 빠른 시작 3단계

먼저 기본 연결을 설정한 뒤 필요한 항목을 조정하세요.

전체 가이드 보기 →
STEP 01

클라이언트와 설치 파일 선택

운영체제에 맞는 다운로드 페이지로 이동해 CPU 아키텍처를 확인하세요. 데스크톱은 설치 후 처음 실행하고, 모바일은 시스템 안내에 따라 네트워크 연결 권한을 허용하면 됩니다. 기본 설정을 유지하고 프록시 클라이언트를 여러 개 동시에 실행하지 마세요.

STEP 02

구독 또는 로컬 설정 가져오기

설정 또는 구독 메뉴에서 사용할 설정 소스를 추가한 다음, 업데이트 후 현재 설정으로 전환하세요. 정책 그룹과 아웃바운드 항목이 표시되는지 확인하세요. 구독 주소에는 접근 정보가 포함될 수 있으므로 안전하게 보관하고 공개 스크린샷에 노출하지 마세요.

STEP 03

규칙 모드를 선택하고 연결 확인

사용할 아웃바운드를 선택하고 시스템 프록시를 켜거나 필요에 따라 TUN을 활성화한 뒤 대상 사이트에 접속하세요. 연결 목록과 로그에서 트래픽이 클라이언트로 들어오는지, 규칙이 올바르게 매칭되는지 확인하세요. 문제가 있으면 설정 로드 상태부터 확인하고 DNS와 아웃바운드를 차례로 점검하세요.

구독은 설정을 제공하고 클라이언트는 이를 실행하므로 서로 다른 역할을 합니다. 설치를 마쳤다고 바로 사용할 수 있는 아웃바운드가 생기는 것은 아닙니다. 가져온 뒤 목록이 비어 있다면 먼저 구독 응답이 클라이언트에서 지원하는 설정 형식인지 확인한 다음 연결을 진행하세요. 전체 가이드에서는 화면 위치와 확인 방법을 순서대로 설명하며, 필드별 내용은 설정 종합 가이드를 참고하세요.

Clash 멀티 플랫폼 다운로드

먼저 플랫폼을 선택한 뒤 아키텍처와 클라이언트를 확인하세요.

전체 클라이언트 보기 →

처음 사용한다면 Clash Plus부터 살펴보세요. 인터페이스, 시스템 연동, 유지 관리 상태를 비교하려면 클라이언트 선택 가이드를 참고하세요. 클라이언트마다 설정 문법은 비슷할 수 있지만 구독 관리, 서비스 설치, 권한 요청, 설정 덮어쓰기 위치는 다릅니다. 다운로드 페이지에서 플랫폼별 옵션을 확인하고, 설치 전 시스템 요구 사항과 설치 파일 아키텍처를 함께 점검하세요.

Windows

데스크톱 일상 사용과 개발 환경별 트래픽 분기에 적합합니다. Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 기존 Clash for Windows는 지원이 종료된 보관용 옵션으로 남겨 두었으며, 마이그레이션 방법은 클라이언트 선택 가이드에서 확인할 수 있습니다.

처음 설치할 때는 운영체제 아키텍처부터 확인하세요. 시스템 프록시는 프록시 설정을 따르는 앱에서 주로 사용됩니다. 터미널 도구의 프록시 사용 여부는 자체 옵션과 환경 변수에도 달려 있으므로 브라우저 접속만으로 판단하면 안 됩니다.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 서로 다른 인터페이스를 제공합니다. ClashX Meta의 보관 상태와 사용 범위는 다운로드 페이지에서 별도로 안내합니다.

시스템 확장 프로그램, 네트워크 권한 또는 보조 서비스가 필요한 경우 클라이언트 안내에 따라 항목별로 확인하세요. 클라이언트를 바꾸기 전에는 기존 클라이언트의 시스템 프록시와 트래픽 처리를 해제해 이전 설정이 새 설정 확인에 영향을 주지 않도록 하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 구독을 가져오기 전에 기기 아키텍처와 설정 형식을 확인하세요. 앱마다 지원하는 규칙 필드가 다를 수 있으므로 각각 확인해야 합니다.

연결하려면 보통 시스템 VPN 권한이 필요합니다. 다른 VPN 앱을 동시에 실행하면 충돌할 수 있습니다. 백그라운드 제한으로 연결이 끊길 수도 있으니 시스템의 배터리 관리 설정과 클라이언트 실행 상태를 함께 확인하세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 앱 화면에서 설정을 추가하고 시스템 안내에 따라 VPN 연결을 허용하세요.

데스크톱 설정이 모바일에서도 항목별로 그대로 작동한다고 단정할 수는 없습니다. 가져오기 전에 앱이 지원하는 구독 형식을 확인하세요. 연결 후에는 앱 내 기록에서 정책 선택을 확인하고, 상태 표시줄의 연결 아이콘만으로 접속 여부를 판단하지 마세요.

다운로드 페이지로 이동

Linux

그래픽 데스크톱 앱으로는 Clash Verge Rev와 FlClash를 확인해 보세요. 서버, 라우터 또는 직접 관리하는 서비스에서 사용할 경우 mihomo 코어 섹션을 참고하세요. 데스크톱 앱과 명령줄 코어는 설치, 실행, 설정 경로가 서로 다릅니다.

설치 전 배포판의 패키지 형식, CPU 아키텍처, 실행 종속성을 확인하세요. 코어를 직접 사용하면 프로세스, 설정 경로, 권한을 직접 관리해야 합니다. 먼저 리스닝 포트와 서비스 로그를 이해한 뒤 부팅 시 자동 실행을 설정하는 것이 좋습니다.

다운로드 페이지로 이동

mihomo 코어 설정 설명

실제 설정 필드로 아웃바운드 결정, 도메인 조회, 트래픽 처리를 구분해 보세요.

설정 종합 가이드 보기 →

규칙 분기
매칭 순서에 따라 아웃바운드 결정

규칙 모드에서는 요청마다 다른 정책을 적용할 수 있어 모든 트래픽을 하나의 경로로 보낼 필요가 없습니다. 설정의 rules는 위에서 아래로 확인하며, 처음 일치한 규칙으로 정책이 결정됩니다. 따라서 특정 도메인 규칙은 일반적인 기본 규칙보다 앞에 배치해야 합니다. 오른쪽 예시는 GitHub 도메인과 하위 도메인을 PROXY로 보내고 나머지 요청은 직접 연결합니다. 전역 모드와 달리 로컬 서비스와 외부 사이트를 따로 처리할 수 있지만, 결과는 규칙 순서와 도메인 정보, 실제 정책 그룹 선택에 따라 달라집니다. 변경 후에는 연결 목록에서 매칭된 규칙을 확인하세요. 스위치 상태만 확인해서는 안 됩니다.

규칙 문법 보기 →
config.yaml · 규칙 예시
mode: rulerules:  - DOMAIN-SUFFIX,github.com,PROXY  - MATCH,DIRECT

DNS 및 Fake-IP
도메인을 유지한 뒤 연결

도메인 조회는 접속 가능 여부뿐 아니라 도메인 규칙에 필요한 정보가 온전히 전달되는지에도 영향을 줍니다. Fake-IP 모드에서는 도메인에 대응하는 주소를 반환하고, 코어가 이후 연결을 처리할 때 원래 도메인과 연결합니다. 이 주소는 원격 서버의 실제 주소가 아닙니다. 오른쪽 예시는 관련 필드만 보여 주며, 실제 환경에 맞는 상위 DNS 서버와 접근 경로도 설정해야 합니다. 실제 주소를 바로 반환하는 방식과 비교하면 Fake-IP는 도메인 정보를 유지하는 데 유리하지만 일부 로컬 네트워크 서비스나 특수 앱은 예외 처리가 필요할 수 있습니다. 호환성 문제가 생기면 먼저 해당 도메인을 확인하고 변경 범위를 좁히세요. DNS 설정 전체를 한 번에 바꾸는 것은 피하는 편이 좋습니다.

DNS 필드 보기 →
config.yaml · DNS 예시
dns:  enable: true  enhanced-mode: fake-ip  fake-ip-range: 198.18.0.1/16  fake-ip-filter:    - "*.lan"

정책 그룹
규칙 이름과 실제 아웃바운드 분리

정책 그룹은 규칙이 참조할 안정적인 대상 이름을 제공하고, 실제 아웃바운드 선택을 한곳에 모읍니다. select 유형은 사용할 아웃바운드를 직접 선택할 때 적합합니다. 다른 그룹 유형은 각자의 방식으로 검사하거나 전환하므로 이름만 보고 동작을 추측해서는 안 됩니다. 오른쪽 예시는 내장된 DIRECT와 REJECT를 사용해 선택 관계를 보여 줄 뿐, 원격 프록시에 연결할 수 있는 설정은 아닙니다. 실제로 사용할 때는 정의된 아웃바운드 이름을 그룹에 넣고 규칙에서도 동일한 그룹 이름을 참조하세요. 구독을 바꾼 뒤에는 이름이 그대로 있는지 확인해 오래된 대상을 참조하는 규칙 때문에 설정 로드가 실패하지 않도록 하세요.

정책 그룹 필드 보기 →
config.yaml · 정책 그룹 예시
proxy-groups:  - name: PROXY    type: select    proxies:      - DIRECT      - REJECT

TUN 모드
트래픽 처리와 전체 프록시는 다릅니다

TUN은 가상 네트워크 인터페이스를 통해 라우팅되는 네트워크 트래픽을 처리하므로 시스템 프록시를 따르지 않는 앱에 적합합니다. 트래픽이 코어로 들어오는 방식을 바꾸지만, 최종적으로 직접 연결할지 프록시를 사용할지는 아웃바운드 모드와 규칙에 따라 결정됩니다. 전역 모드와 같은 의미가 아닙니다. 오른쪽은 mixed 프로토콜 스택과 자동 라우팅 필드를 보여 줍니다. 실제 활성화에는 관리자 권한이나 클라이언트 서비스 지원이 필요할 수 있습니다. 시스템 프록시보다 라우팅과 DNS 단계가 더 많아 다른 VPN, 가상 네트워크 인터페이스, 방화벽의 영향을 받기 쉽습니다. 먼저 기본 설정이 정상 작동하는지 확인한 뒤 TUN을 켜고, 충돌이 생기면 항목별로 되돌리세요.

TUN 설정 보기 →
config.yaml · TUN 예시
tun:  enable: true  stack: mixed  auto-route: true  auto-detect-interface: true

오픈 소스 코어와 클라이언트의 관계

프로젝트 문서, 소스 코드, 실제 설정 동작을 기준으로 살펴보세요.

Clash 설정 생태계와 mihomo

Clash 생태계에는 프록시 코어, 데스크톱·모바일 클라이언트, 규칙 및 설정 도구가 포함됩니다. mihomo는 Clash Meta의 기술 계보를 잇는 오픈 소스 코어 프로젝트로 Clash 설정 체계와 호환됩니다. 호환된다고 해서 모든 클라이언트에서 과거 필드와 새로운 기능을 완전히 똑같이 지원하는 것은 아닙니다. 가이드를 볼 때는 먼저 클라이언트가 사용하는 코어와 지원 범위를 확인하세요.

그래픽 클라이언트는 구독 관리, 화면 조작, 시스템 연동, 서비스 제어를 담당하고 코어는 연결, 도메인 조회, 규칙 결정을 처리합니다. 따라서 같은 설정도 인터페이스마다 편집 위치가 다를 수 있으며, 클라이언트 업데이트와 코어 업데이트가 동시에 이루어지는 것도 아닙니다. 화면에서 옵션을 찾을 수 없다면 코어 기능인지, 클라이언트 지원 여부인지, 설정 덮어쓰기 때문인지 먼저 구분하세요.

mihomo 오픈 소스 저장소 보기 →

소스 코드 확인하기

아래 명령은 mihomo 저장소를 복제해 필드 구현, 커밋 기록, 빌드 안내를 확인할 때 사용합니다. 그래픽 클라이언트를 설치하거나 사용할 수 있는 구독을 생성하는 명령은 아닙니다. 일상적인 사용만 필요하다면 다운로드 페이지에서 클라이언트를 선택하세요.

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

유지 관리 상태 및 업데이트 확인 기준

업데이트 여부를 판단할 때는 숫자만 비교하지 말고 클라이언트 릴리스 노트와 코어 변경 사항을 확인하세요. 운영체제 호환성, 설정 필드 변경, 알려진 문제를 살펴보는 것이 중요합니다. 업그레이드 전에 구독 소스, 사용자 지정 규칙, 덮어쓰기 파일을 보관하세요. 업그레이드 후에는 설정이 정상적으로 로드되는지 확인하고 아웃바운드, DNS, TUN 동작을 점검하세요. 지원이 종료된 클라이언트는 다운로드 페이지에 보관 상태를 명시해 과거 호환 목적과 일상적인 사용 옵션을 구분할 수 있도록 했습니다.

사이트 콘텐츠와 이용 범위

이 사이트는 클라이언트 다운로드 경로와 한국어 사용 설명을 정리하며, 프록시 서비스 제공자도 생태계 프로젝트 전체의 개발자도 아닙니다. 예시 주소는 설정 구조를 설명하기 위한 것으로, 실제 연결에는 사용자가 직접 합법적으로 이용할 수 있는 설정 소스를 제공해야 합니다. 사용 전에는 거주 지역의 관련 규정, 네트워크 관리 정책, 서비스 약관을 확인하세요. 로그를 공유하기 전에 구독 주소, 인증 정보 및 기타 개인 데이터를 삭제하세요.

설정 전 자주 묻는 질문

클라이언트를 설치한 뒤에도 구독을 가져와야 하는 이유는 무엇인가요?

클라이언트는 설정을 실행하고 관리하는 기능을 제공하지만, 사용할 수 있는 원격 프록시 아웃바운드가 자동으로 포함되지는 않습니다. 구독에는 보통 노드, 정책 그룹, 규칙이 들어 있지만 구체적인 내용은 설정 소스에 따라 다릅니다. 가져온 뒤 설정이 활성화되었는지 확인하고 정책 그룹에 사용할 수 있는 아웃바운드가 포함되어 있는지 점검하세요. 단계별 방법은 구독 가져오기 가이드를 참고하세요.

브라우저에서는 접속되지만 다른 앱은 실패합니다. 어디부터 확인해야 하나요?

먼저 실패한 앱의 연결이 클라이언트 기록에 나타나는지 확인하세요. 기록이 없다면 앱이 시스템 프록시를 따르는지 점검합니다. 기록이 있다면 규칙 매칭, 정책 선택, DNS, 연결 오류 순으로 확인하세요. 일부 시스템 앱은 별도의 네트워크 제한도 적용될 수 있습니다. Clash UWP 루프백 문제도 참고하세요.

TUN을 켠 뒤에도 규칙 모드를 선택해야 하나요?

용도에 맞는 아웃바운드 모드를 선택해야 합니다. TUN은 트래픽이 코어로 들어오는 방식을 정하고, 규칙 모드는 들어온 트래픽이 어떤 경로로 나갈지 정합니다. 두 설정은 서로 배타적이지 않습니다. 활성화 후 로컬 네트워크 접속에 문제가 생기면 모든 요청을 프록시로 바꾸기보다 라우팅, DNS, 규칙을 확인하세요. 관련 내용은 도움말 센터를 참고하세요.

Clash 사용 팁과 설정 해설

코어 차이부터 트래픽 처리까지, 구체적인 설정 사례를 더 살펴보세요.

전체 글 보기 →
클라이언트 다운로드