오픈 소스 코드 · 5개 플랫폼 클라이언트

ClashX 공식 사이트전 플랫폼 Clash 클라이언트 및 설정 가이드

공식 Clash 다운로드 가이드 보기

사용 중인 운영체제에 맞는 Clash 클라이언트를 선택한 뒤 한국어 문서에 따라 구독 가져오기, 규칙 분기, DNS 및 TUN 설정을 진행하세요. 다운로드 링크, 기본 절차, 고급 매개변수를 나누어 정리해 여러 프로젝트 페이지를 반복해서 오갈 필요가 없습니다.

영구 무료 오픈 소스 한국어 문서 mihomo 코어 자료
핵심 기능

구독 가져오기부터 규칙 분기용도별 설정 항목 안내

Clash 클라이언트마다 화면은 다르지만, 기본 동작은 대체로 설정 불러오기, 정책 선택, 규칙 매칭, 트래픽 가로채기를 중심으로 이루어집니다. 아래 네 가지 항목은 일상적으로 가장 자주 확인하는 내용이며, 탭을 전환해 원리, 설정 예시와 적용 범위를 살펴볼 수 있습니다.

01 / CONFIG

구독 가져오기 및 로컬 오버라이드

구독은 노드, 정책 그룹, 기본 규칙을 제공하고 클라이언트는 이를 주기적으로 가져와 로컬 설정에 기록합니다. 처음 사용할 때는 구독 주소가 정상적으로 응답하는지 확인한 다음, 설정 미리보기에 프록시와 정책 그룹이 표시되는지 점검하세요. 로컬 DNS, 포트 또는 규칙 설정을 유지해야 한다면 구독으로 생성된 파일을 계속 직접 수정하지 말고, 클라이언트의 오버라이드·병합·스크립트 기능을 사용해 개인 설정을 별도 계층에 두는 편이 좋습니다. 이렇게 하면 구독을 업데이트할 때 노드 목록은 교체하면서도 수동 설정은 정해진 순서에 따라 계속 병합할 수 있습니다.

구독 가져오기 절차 보기 →
config.yaml 
mixed-port: 7890
mode: rule

profile:
  store-selected: true

proxy-providers:
  primary:
    type: http
    path: ./providers/main.yaml
플랫폼 선택

Clash 클라이언트 다운로드

현재 사용하는 운영체제의 탭으로 먼저 이동한 뒤 유지 관리 상태, 인터페이스 방식, 설치 형식과 아키텍처 지원 여부를 비교하세요. 홈에서는 플랫폼별 진입점만 제공하고, 전체 클라이언트 목록과 시스템 요구 사항, 설치 패키지 링크는 다운로드 페이지에 모아 일관되지 않은 정보가 여러 곳에 생기지 않도록 했습니다.

Windows

데스크톱에서 일상적으로 사용하기 좋습니다. 다운로드 페이지에서 그래픽 클라이언트와 아카이브 클라이언트를 나누어 소개하고, 설치 패키지 아키텍처와 시스템 프록시 및 TUN 권한의 차이를 설명합니다.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel 아키텍처를 모두 확인하세요. 각 클라이언트의 설치 방법과 시스템 프록시, 메뉴 막대 조작, 설정 디렉터리 안내를 확인할 수 있습니다.

다운로드 페이지로 이동

Android

스마트폰과 태블릿에 적합합니다. 다운로드 전에 프로세서 아키텍처를 확인하고, 구독을 가져온 뒤 클라이언트가 시스템 VPN 연결을 생성하도록 허용해야 트래픽 가로채기가 적용됩니다.

다운로드 페이지로 이동

iOS

스토어 페이지에서 Clash Plus를 설치하세요. iOS 탭에서 앱 진입점과 공식 사이트 정보, 처음 VPN 설정을 추가할 때 확인해야 할 시스템 절차를 볼 수 있습니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 그래픽 클라이언트를 선택할 수 있으며, 서버·소프트 라우터·컨테이너 환경에서는 mihomo 코어를 직접 실행하는 경우가 많습니다. 다운로드 페이지에서 두 용도를 분리해 데스크톱 설치 패키지와 코어 압축 파일이 섞이지 않도록 했습니다.

다운로드 페이지로 이동

어떤 클라이언트를 선택해야 할지 모르겠나요?

먼저 운영체제를 확인하고 그래픽 인터페이스가 필요한지 살펴보세요. 일반 데스크톱과 모바일 기기에는 구독 가져오기, 정책 전환, 로그 확인이 쉬운 GUI 클라이언트를 우선 권장합니다. Linux 서버나 라우터 환경에서는 보통 mihomo 코어를 설정 파일 및 서비스 관리자와 함께 사용합니다. 기기가 ARM 아키텍처라면 ARM64, ARMv7 등의 표기도 추가로 확인해야 합니다. 이름이 비슷하다고 설치 패키지를 다른 운영체제에서 사용할 수 있는 것은 아니므로, 설치 전 다운로드 페이지의 시스템 요구 사항을 기준으로 판단하세요.

전체 클라이언트 보기 →
OPEN SOURCE CONTEXT

오픈 소스 코어와 클라이언트의 구분

Clash 생태계는 코어, 그래픽 클라이언트, 설정 형식, 커뮤니티 규칙 등 여러 요소로 구성됩니다. 서로 다른 클라이언트가 같거나 유사한 설정 방식을 사용할 수 있지만, 프로젝트 유지 관리 주체, 지원 플랫폼, 인터페이스 기능과 릴리스 주기는 완전히 같지 않습니다. 소프트웨어를 선택할 때는 이름만 보지 말고 프로젝트 상태와 시스템 호환성을 함께 확인하세요.

mihomo 지속적으로 유지 관리되는 호환 코어
GPL-3.0 mihomo 오픈 소스 라이선스
5개 플랫폼 데스크톱, 모바일 및 Linux

프로젝트의 역사

Clash는 널리 사용되는 규칙 설정 방식과 정책 그룹 모델을 처음 정립했으며, 이후 여러 커뮤니티 프로젝트가 이를 바탕으로 클라이언트와 호환 코어를 유지 관리해 왔습니다. 현재 설정 기능을 살펴볼 때 mihomo와 Clash Meta라는 이름을 자주 접하게 됩니다. 두 프로젝트에는 역사적·호환성 관계가 있지만 단순히 같은 설치 프로그램으로 볼 수는 없습니다. 이 사이트의 다운로드 목록은 구체적인 클라이언트 이름을 기준으로 정리하고, 문서는 현재도 사용되는 설정 개념을 중심으로 설명합니다.

코어의 관계

mihomo는 설정을 해석하고 프록시 연결을 수립하며 규칙 매칭을 실행하고 DNS 및 TUN 같은 하위 기능을 제공합니다. 그래픽 클라이언트는 그 위에서 설치, 구독 관리, 정책 전환, 로그 확인과 시스템 트레이 조작을 담당합니다. 특정 인터페이스 기능의 제공 여부는 코어의 기능뿐 아니라 클라이언트가 해당 설정을 화면에 노출했는지에도 달려 있습니다. 따라서 문서의 YAML 매개변수와 클라이언트 화면의 옵션은 구분해서 이해해야 합니다.

커뮤니티 생태계

규칙 세트, GeoSite 데이터, 패널, 구독 처리 도구와 여러 플랫폼의 클라이언트가 함께 사용 환경을 구성합니다. 커뮤니티 리소스는 설정 비용을 줄여 주지만, 외부 규칙이나 스크립트를 도입하기 전에는 업데이트 출처, 참조 경로와 적용 순서를 확인해야 합니다. 특히 원격 규칙 세트의 구조가 바뀌면 설정 불러오기가 실패할 수도 있고 일부 트래픽만 예상한 정책에 매칭되지 않을 수도 있어, 두 경우의 점검 방법은 서로 다릅니다.

업데이트 방식

클라이언트 업데이트, 코어 업데이트, 구독 업데이트와 규칙 세트 업데이트는 서로 다른 네 가지 경로입니다. 클라이언트 업그레이드는 주로 인터페이스와 통합 기능을 바꾸고, 코어 업그레이드는 프로토콜 및 설정 기능에 영향을 줍니다. 구독 업데이트는 노드와 서비스 제공자가 지정한 정책을 교체하며, 규칙 세트 업데이트는 도메인과 IP의 분류 결과를 변경합니다. 문제가 생기면 최근 변경이 어느 경로에서 발생했는지 먼저 확인한 뒤 해당 부분을 되돌리거나 점검하는 것이, 모든 것을 동시에 재설치하고 설정을 다시 작성하는 것보다 효과적입니다.

mihomo source git clone https://github.com/MetaCubeX/mihomo.git
자주 묻는 질문

다운로드와 설정 전에 확인할 네 가지

많은 연결 문제는 노드 자체보다 클라이언트 유형, 구독 내용, 프록시 모드와 시스템 권한이 서로 맞지 않아 발생합니다. 다음은 처음 설치하거나 설정을 마이그레이션할 때 자주 확인하는 핵심 사항입니다.

Clash, mihomo, 그래픽 클라이언트는 어떤 관계인가요?

Clash는 보통 설정 체계와 관련 생태계를 가리키며, mihomo는 지속적으로 유지 관리되는 호환 코어 중 하나입니다. 그래픽 클라이언트는 코어 기능을 데스크톱이나 모바일 시스템에 연결합니다. 실제로 설치하는 것은 구체적인 클라이언트 또는 코어 파일이지 모든 플랫폼에 적용되는 범용 설치 패키지가 아닙니다. 선택할 때는 먼저 시스템을 확인하고 클라이언트가 사용하는 코어와 지원 기능 범위를 점검하세요. 기본 개념 질문 더 보기 →

구독 가져오기는 성공했는데 정책 그룹에 선택할 노드가 없는 이유는 무엇인가요?

먼저 구독 응답이 Clash에서 인식할 수 있는 설정인지 확인한 뒤 클라이언트의 설정 미리보기와 실행 로그를 살펴보세요. 구독이 오류 페이지, 인증 안내 또는 불완전한 YAML만 반환하면 화면에는 가져오기가 완료된 것으로 표시되어도 실제 프록시 목록이 생성되지 않을 수 있습니다. 또한 정책 그룹이 올바른 프록시나 provider를 참조하는지 확인해 노드가 존재하지만 표시되는 정책 그룹에 포함되지 않은 상황을 방지하세요. 설정 및 설치 문제 해결 보기 →

시스템 프록시와 TUN 모드 중 무엇을 선택해야 하나요?

브라우저와 시스템 프록시 설정을 따르는 대부분의 데스크톱 앱은 먼저 시스템 프록시를 사용하면 됩니다. 게임, 명령줄 도구 또는 시스템 프록시를 읽지 않는 앱까지 적용하려면 TUN이 필요할 수 있습니다. TUN은 가상 네트워크 어댑터, 라우팅과 권한을 사용하므로 활성화한 뒤 DNS와 로컬 네트워크 제외 항목도 함께 확인해야 합니다. 적용 범위를 넓히려고 여러 프록시 방식을 동시에 겹쳐 사용하면 장애 원인을 찾기 더 어려워질 수 있습니다. TUN 및 Fake-IP 설명 보기 →

구독 업데이트에 실패하면 어디부터 확인해야 하나요?

먼저 브라우저나 명령줄에서 구독 주소가 유효한 내용을 반환하는지 확인한 뒤 클라이언트 시간, 네트워크 연결, 구독 주소의 완전성, 로그의 HTTP 상태를 점검하세요. 기존 설정은 연결되지만 새 내용을 가져오지 못한다면 문제는 대개 구독 요청 경로에 있습니다. 다운로드는 성공했지만 불러오기에 실패한다면 YAML 문법, 규칙 세트 경로와 오버라이드 병합 결과를 확인해야 합니다. 전체 문제 해결 보기 →

설정 및 문제 해결 문서

최근 업데이트

시스템 프록시, 실행 로그와 트래픽 가로채기를 중심으로 재현 가능한 점검 절차를 정리했습니다. 현상이 어떤 동작 계층에 해당하는지 먼저 설명한 다음 확인 순서를 제시해, 연결 문제가 생길 때 모든 설정을 한꺼번에 초기화하지 않도록 돕습니다.

전체 문서 보기 →
문제 해결

프록시를 켜면 브라우저는 되는데 터미널은 안 되나요? 시스템 프록시가 적용되지 않을 때 상황별 점검

브라우저는 시스템 프록시를 읽을 수도 있고 자체 프록시 설정을 사용할 수도 있지만, 터미널 프로그램은 환경 변수에 의존하는 경우가 많습니다. 이 문서에서는 적용 설정, 프록시 포트, 환경 변수와 확인 명령을 차례로 점검해 트래픽이 어느 계층에서 클라이언트를 우회하는지 판단하는 방법을 설명합니다.

전체 내용 보기 →
문제 해결

Clash 실행 로그 읽는 법: DNS 오류부터 연결 시간 초과까지 원인 찾기

실행 로그에는 규칙 매칭, DNS 조회, 연결 수립과 오류 원인이 함께 나타납니다. 이 글에서는 주요 필드를 읽는 순서를 설명하고, 해석 실패·연결 시간 초과·연결 거부·설정 불러오기 오류별로 어디를 확인해야 하는지 구분합니다.

전체 내용 보기 →
고급 설정

TUN 모드와 시스템 프록시 중 무엇을 선택할까? 두 트래픽 가로채기 방식의 작동 원리 비교

시스템 프록시는 애플리케이션이 설정을 직접 읽어야 적용되지만, TUN은 네트워크 계층에서 가상 네트워크 어댑터로 트래픽을 가로챕니다. 적용 범위, DNS 처리, 권한 요구 사항과 문제 해결 비용을 항목별로 비교해 데스크톱 일상 사용과 특수 애플리케이션에 맞는 선택 기준을 제시합니다.

전체 내용 보기 →
Clash 다운로드