Clash 클라이언트 · mihomo 코어 설정

Clash 설치 파일 다운로드 모든 플랫폼 클라이언트와 설정 가이드

Clash 다운로드 가이드 보기

운영체제에 맞는 설치 파일을 선택하고 규칙 분류, 구독 가져오기, mihomo 코어 설정을 확인하세요.

  • Clash Verge Rev
  • FlClash
  • YAML 설정
  • 한국어 문서
코어
mihomo
코어 프로토콜
GPL-3.0
플랫폼별 다운로드
5개 플랫폼
설정 형식
YAML

CONFIGURATION / 설정 기능

Clash 코어 기능 및 설정 항목

트래픽 제어부터 정책 매칭까지, 용도별 설정 예시를 확인하세요. 아래 내용은 일부 항목만 보여 주는 예시이며, 실제 노드와 정책 그룹을 함께 구성해야 합니다.

규칙 분류: 대상에 따라 아웃바운드 정책 선택

규칙 모드에서는 목록을 위에서부터 확인해 일치하는 규칙의 정책을 적용하고, 그 뒤의 규칙은 더 이상 검사하지 않습니다. 도메인 접미사는 특정 서비스를 지정할 때, 키워드는 폭넓은 도메인 매칭에 적합하며, 지리 데이터베이스 규칙은 주소 판별을 보완합니다. 모든 연결을 하나의 출구로 보내는 대신 개발 서비스, LAN 리소스, 일반 웹사이트에 서로 다른 경로를 지정할 수 있습니다. 구체적인 도메인 규칙을 앞에 두고 기본 규칙은 마지막에 배치하세요. 예시의 PROXY는 설정에 이미 등록된 노드 또는 정책 그룹 이름이어야 합니다.

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-KEYWORD,google,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

OPEN SOURCE / 코어 및 클라이언트

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

클라이언트는 사용자 인터페이스를, 코어는 연결 처리를 담당합니다. 두 구성 요소의 역할을 이해하면 설치 파일 선택, 문제 해결, 업데이트 계획을 세우기 쉽습니다.

프로젝트의 역사와 이름

Clash는 규칙 기반 프록시 코어를 바탕으로 시작했으며, 이를 둘러싸고 그래픽 클라이언트, 설정 편집기, 컨트롤 패널 등 다양한 도구가 만들어졌습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티 포크는 계속 발전했습니다. Clash Meta는 이후 mihomo라는 이름을 사용하게 되었습니다. 따라서 기존 가이드의 Meta 코어와 최신 자료의 mihomo는 계보상 이어져 있지만, 과거 설정의 모든 항목이 현재와 완전히 호환된다는 뜻은 아닙니다.

설치 파일 이름과 코어 이름은 서로 다를 수 있습니다. Clash Verge Rev, FlClash 등의 클라이언트는 각자 인터페이스, 시스템 프록시, 서비스 설치, 설정 관리 기능을 제공합니다. 실제 연결 기능은 각 클라이언트가 사용하는 코어를 기준으로 확인해야 합니다. 오래된 글을 참고할 때는 그래픽 인터페이스를 다루는지 코어 설정을 다루는지 먼저 구분하세요. 그래야 클라이언트마다 이름이 같은 버튼을 찾느라 혼란을 겪지 않습니다.

오픈 소스 라이선스와 참고 자료

mihomo는 소스 코드를 공개하며 GPL-3.0 라이선스를 사용합니다. 소스 코드, 이슈 기록, 릴리스 노트를 참고하면 구현 방식과 호환성 문제를 파악하는 데 도움이 됩니다. 그래픽 클라이언트마다 라이선스와 유지 관리 주기가 다르므로 코어의 라이선스 조건을 모든 설치 파일에 똑같이 적용할 수는 없습니다. 소프트웨어를 재배포하거나 수정하기 전에 해당 프로젝트의 라이선스 파일과 관련 안내를 확인하세요.

이 사이트는 설치 파일 안내와 한국어 기술 정보를 제공하며, 상위 프로젝트의 릴리스 안내를 대신하거나 각 클라이언트의 유지 관리 조직을 대표하지 않습니다. 특정 설정 항목의 지원 여부나 시스템 권한이 필요한 이유는 해당 클라이언트와 코어의 문서를 확인하세요. 문제를 신고할 때는 운영체제, 재현 단계, 필요한 로그를 포함하되 구독 주소, 비밀번호 등 개인정보는 제거하세요.

업데이트 구분과 설정 보존

그래픽 클라이언트, 코어, 구독, 규칙 집합 업데이트는 서로 다른 작업입니다. 인터페이스 업데이트는 서비스 설치 방식을 바꿀 수 있고, 코어 업데이트는 설정 항목의 동작에 영향을 줄 수 있으며, 구독 업데이트는 주로 설정 내용을 교체합니다. 한 번에 한 항목만 변경하고 기존 설정을 백업한 뒤 연결과 규칙 분류를 확인하세요. 모든 구성 요소를 동시에 업데이트하는 것보다 문제의 원인을 찾기 쉽습니다.

원격 구독 설정과 로컬 설정도 구분해야 합니다. 구독을 내려받은 파일을 직접 수정하면 다음 새로 고침 때 변경 내용이 덮어써질 수 있습니다. 고정 LAN 직접 연결 규칙, 개인 정책 그룹, DNS 예외는 클라이언트의 오버라이드 기능을 우선 사용하고 수정 이유를 기록하세요. 클라이언트를 옮길 때는 기존 설정을 가져온 뒤 혼합 포트, DNS, TUN 동작을 확인하세요. 이전 인터페이스에서 스위치가 있던 위치를 설정 기준으로 삼지 마세요.

연결 확인 및 문제 해결 순서

프록시 스위치가 켜져 있다는 것은 특정 트래픽 제어 설정이 활성화되었다는 뜻일 뿐, 모든 앱이 프록시를 사용한다는 의미는 아닙니다. 연결이 실제로 코어에 전달되었는지, 어떤 규칙이 적용되었는지, 최종적으로 어떤 정책을 선택했는지 확인해야 합니다. 브라우저와 터미널은 서로 다른 프록시 설정을 사용할 수 있고 LAN 앱은 시스템 프록시를 우회할 수도 있으므로 앱별로 확인하세요.

문제 해결은 설정을 불러올 수 있는지, 노드 정보가 올바른지, DNS가 정상인지, 트래픽이 코어에 전달되는지 순서로 확인한 뒤 규칙과 TUN 라우팅을 점검하세요. 한 번의 연결 결과만으로 클라이언트 전체를 판단하지 마세요. 프로토콜 차이와 코어 호환성은 프로토콜 및 코어 기술 참고서에서 확인할 수 있습니다. 설정 항목 이름이 낯설다면 먼저 용어 빠른 안내를 살펴보세요.

mihomo 소스 코드

구현을 살펴보거나 직접 빌드하려는 사용자를 위한 자료입니다. 일반 사용자는 소스 코드를 복제하지 않고 그래픽 클라이언트를 바로 선택해도 됩니다.

MetaCubeX/mihomo 저장소 보기 ↗ 
git clone https://github.com/MetaCubeX/mihomo.git

PACKAGES / 플랫폼별 선택

Clash 클라이언트 설치 파일

운영체제를 먼저 확인한 뒤 프로세서 아키텍처와 소프트웨어 유지 관리 상태를 살펴보세요. 아래 링크는 다운로드 페이지의 해당 플랫폼 섹션으로 이동하며 다운로드를 바로 시작하지 않습니다.

Windows

Clash Plus, Clash Verge Rev 등에서 선택하세요. 데스크톱에서는 먼저 시스템 프록시를 켜고 브라우저 연결을 확인한 뒤, 필요한 앱에 한해 TUN을 검토할 수 있습니다. 설치 전에 시스템 요구 사항과 프로세서 종류를 확인하고, 업그레이드할 때는 구독 출처와 로컬 오버라이드 규칙을 보존하세요.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel용 설치 파일을 구분하세요. 처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하고, 네트워크 확장이나 백그라운드 서비스가 필요한 기능은 클라이언트 설명을 참고하세요. 유지 관리가 중단된 클라이언트를 선택하기 전에 현재 시스템 및 구독 설정과 호환되는지 확인하세요.

다운로드 페이지로 이동

Android

기기 아키텍처에 맞는 설치 파일을 선택하고 첫 연결 시 시스템 VPN 권한을 승인하세요. 모바일 운영체제의 백그라운드 제한으로 연결이 끊길 수 있으니 배터리 관리 설정을 확인하세요. 가져오기 전에 구독 형식이 클라이언트와 호환되는지 확인하고, 네트워크를 전환한 뒤 DNS와 앱 접속을 테스트하세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 후 클라이언트 안내에 따라 설정을 가져오고 VPN 권한을 허용하세요. 모바일 운영체제의 네트워크 제어 방식은 데스크톱 시스템 프록시와 다르므로, 이전할 때 정책 그룹과 연결 설정을 다시 확인해야 합니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 Clash Verge Rev 또는 FlClash를 선택할 수 있으며, 배포판에 맞는 설치 파일 형식을 골라야 합니다. 서버와 라우터 사용자는 다운로드 페이지의 코어 섹션을 확인하고 서비스, 권한, 설정 파일을 별도로 관리하세요. 그래픽 클라이언트의 설치 절차는 서버 배포 과정을 대신할 수 없습니다.

다운로드 페이지로 이동

설치 전 확인할 세 가지

설치 파일에는 클라이언트 프로그램만 포함되어 있으며 사용할 수 있는 노드가 자동으로 생성되지는 않습니다. 연결하려면 정식으로 확보한 노드 정보나 구독 설정이 필요하며, 해당 프로토콜을 현재 코어가 지원하는지도 확인해야 합니다.

처음 사용하는 경우 시작 가이드를 먼저 읽어 보세요. 기존 설정을 사용하면서 클라이언트만 바꾸려면 플랫폼 지원, 설정 관리, 네트워크 제어 방식부터 비교한 다음 기존 파일을 가져오세요.

클라이언트 비교 보기 →

전체 클라이언트 보기 →

설치부터 연결까지 설정 순서

설치 후 설정 관리 화면에서 구독 또는 로컬 YAML을 가져오고, 클라이언트가 콘텐츠를 다운로드하고 파싱할 때까지 기다리세요. 정책 그룹에 선택 가능한 노드가 표시되는지 확인한 다음 현재 상황에 맞는 트래픽 제어 방식을 켜세요. 유효한 설정 없이 시스템 프록시만 켜거나 노드 목록만 있고 해당 정책 그룹이 없으면 요청이 예상대로 처리되지 않을 수 있습니다. 버튼 이름은 클라이언트마다 다를 수 있으며, 자세한 절차는 Clash 설정 가이드를 참고하세요.

처음 연결을 확인할 때는 기존 설정의 규칙 모드를 유지하고 프록시가 필요한 서비스와 로컬 리소스를 각각 테스트하세요. 특정 앱의 트래픽이 코어에 전달되지 않으면 노드 정보를 바로 수정하기 전에 시스템 프록시를 따르는 앱인지 확인하세요. 해당 연결까지 제어해야 하는 경우에만 TUN을 켜고 권한과 라우팅을 설정하세요. 전역 모드는 출구 연결 여부를 임시로 확인할 때 유용하지만 규칙 매칭 결과를 점검하는 용도로 대신 사용해서는 안 됩니다.

자주 묻는 설정 질문

Clash 클라이언트와 mihomo 코어는 어떤 관계인가요?

클라이언트는 구독 관리, 시스템 설정, 사용자 인터페이스를 제공하고 코어는 프록시 연결, DNS, 규칙 매칭을 처리합니다. 인터페이스가 비슷하다고 코어 기능까지 같다는 뜻은 아니므로 문제를 해결할 때 둘 다 확인해야 합니다. 용어 빠른 안내에서 코어와 클라이언트의 차이를 알아보세요.

구독을 가져온 뒤에도 정책 그룹을 선택해야 하는 이유는 무엇인가요?

구독에는 노드, 정책, 규칙이 포함되고 정책 그룹은 규칙에 일치하는 트래픽에 실제로 사용할 출구를 정합니다. 일부 설정은 그룹에서 직접 선택해야 하므로 구독을 성공적으로 가져온 뒤에도 사용할 노드를 지정해야 합니다. 구독을 반복해서 새로 고치기보다 그룹에서 선택된 항목을 확인한 다음 연결 기록을 살펴보세요.

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

반드시 그럴 필요는 없습니다. 트래픽 제어 방식은 앱의 동작과 클라이언트 구현에 따라 달라집니다. 처음에는 시스템 프록시를 테스트하고, 시스템 프록시를 따르지 않는 프로그램의 트래픽까지 제어해야 할 때 TUN을 검토하세요. 둘 다 켜면 중복 제어가 발생하거나 다른 VPN의 라우팅과 충돌할 수 있습니다. 관련 용어는 네트워크 스택 용어 안내에서 확인하세요.

구독 업데이트 후 사용자 지정 규칙이 바뀌는 이유는 무엇인가요?

원격 업데이트 과정에서 설정 파일이 다시 생성되면 파일에 직접 입력한 내용이 덮어써질 수 있습니다. 오래 유지할 규칙은 클라이언트가 지원하는 오버라이드 설정으로 옮기고 병합된 규칙의 실제 순서를 확인하세요. 원본 파일을 백업한 뒤 한 번에 하나씩 수정하면 결과를 확인하기 쉽습니다.

TECH NOTES / 기술 노트

mihomo 설정 및 문제 해결 노트

코어별 차이, 로그 분석, 설정 기능을 정리했습니다. 먼저 적용 범위를 확인한 뒤 글에 나온 일부 설정을 자신의 파일에 병합하세요.

전체 글 보기 →