오픈 소스 코어 · 데스크톱 및 모바일 클라이언트

Clash 데스크톱 버전
클라이언트 다운로드 및 설정

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

클라이언트 비교부터 시작해 구독 가져오기, 프록시 모드, 규칙 분기를 순서대로 설정하세요. Windows, macOS, Linux와 모바일 환경의 진입점 및 사용 범위를 한곳에 정리했습니다.

영구 무료 오픈 소스 규칙 기반 한국어 문서

RULE ENGINE INDEX

규칙 엔진 구성 목록

클라이언트 화면은 조작을 위한 진입점일 뿐이며, 실제 동작은 설정, 정책 그룹, 매칭 순서와 시스템 트래픽 가로채기 범위가 함께 결정합니다. 사용 중 자주 마주치는 다섯 가지 단계로 나누어 설명합니다.

현재 확인할 항목

먼저 매칭 순서를 확인한 뒤 정책 필드를 수정하세요

규칙 문제는 대개 문법보다 앞쪽의 포괄적인 규칙이 요청을 먼저 가로채는 데서 발생합니다. 연결 페이지에서 대상 도메인을 찾아 매칭된 규칙과 정책 그룹을 기록한 다음 설정 파일로 돌아가 순서를 조정하세요. 수정 후에는 설정을 다시 불러오고 새 연결을 만들어야 합니다. 기존 연결은 전체 매칭 과정을 자동으로 다시 거치지 않습니다.

PLATFORM ENTRANCE

운영체제에 맞춰 클라이언트를 선택하세요

같은 Clash 설정도 서로 다른 화면의 클라이언트에서 불러올 수 있습니다. 선택할 때는 운영체제, 프로세서 아키텍처, TUN 지원 여부와 유지 관리 상태를 우선 확인하세요. 화면 디자인만을 기준으로 판단할 필요는 없습니다.

Windows

일반적인 데스크톱 사용에 적합합니다. 설치 후 시스템 프록시, 수신 포트와 UWP 앱 루프백을 우선 확인하고, 더 많은 앱을 가로채야 할 때 권한 요구 사항에 맞춰 TUN을 설정하세요.

다운로드 페이지로 이동

macOS

다운로드할 때 Apple Silicon과 Intel 아키텍처를 구분하세요. 처음 실행하면 네트워크 확장 또는 시스템 권한을 허용해야 할 수 있으며, 메뉴 막대 상태와 시스템 프록시 스위치는 각각 확인해야 합니다.

다운로드 페이지로 이동

Android

스마트폰과 태블릿에 적합합니다. 구독을 가져오면 시스템 VPN 인터페이스가 앱 트래픽을 처리합니다. 배터리 절전, 백그라운드 제한과 항상 켜기 설정이 지속적인 연결에 직접 영향을 줍니다.

다운로드 페이지로 이동

iOS

시스템 네트워크 확장으로 연결을 만들며 설정, 정책 그룹과 필요할 때만 연결하는 기능을 앱 안에서 관리합니다. 처음 사용할 때는 VPN 설정 추가를 허용한 뒤 시스템 상태 표시줄에서 연결 상태를 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱, 서버와 라우터 환경에 적합합니다. GUI 클라이언트는 일상적인 전환이 편리하고, Mihomo 코어를 직접 실행할 때는 설정 파일, 서비스 프로세스와 권한을 직접 관리해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →

QUICK START

검증 가능한 연결을 만드는 3단계

처음 설정할 때 규칙, DNS, TUN과 시스템 프록시를 동시에 조정하지 마세요. 먼저 최소한의 정상 경로를 만든 다음 트래픽 가로채기 범위를 단계적으로 넓히면, 문제가 생겨도 직전의 정상 상태로 명확하게 되돌릴 수 있습니다.

전체 가이드 보기
  1. 01

    설치하고 코어 실행을 확인하세요

    다운로드 페이지에서 운영체제와 프로세서 아키텍처에 맞는 클라이언트를 선택하세요. 처음 실행한 뒤 로그 또는 상태 페이지에서 설정 디렉터리에 쓰기 권한이 있고 수신 포트가 열렸는지, 시스템의 다른 프록시 프로그램이 같은 포트를 사용하지 않는지 확인합니다.

  2. 02

    구독을 가져와 활성화하세요

    설정 페이지에 구독 주소를 붙여 넣고 다운로드를 실행하세요. 설정 항목이 나타나면 직접 선택해 클라이언트가 코어를 다시 불러오게 해야 합니다. 그다음 프록시 페이지에서 선택 가능한 정책 그룹에 사용할 노드를 지정하세요.

  3. 03

    프록시를 켜고 경로별로 확인하세요

    먼저 시스템 프록시를 켜고 브라우저로 테스트 대상에 접속한 뒤 연결 페이지에서 해당 요청을 찾으세요. 브라우저가 정상 작동하면 터미널과 다른 앱을 각각 확인합니다. 더 넓은 범위를 가로채야 할 때 TUN과 DNS를 마지막으로 설정하세요.

OPEN SOURCE CONTEXT

오픈 소스 프로젝트와 코어의 관계

Clash 클라이언트가 장기간 사용에 적합한지 판단하려면 그래픽 인터페이스, 프록시 코어, 설정 형식과 구독 출처를 분리해서 봐야 합니다. 이들은 서로 다른 프로젝트나 서비스가 관리하며 업데이트 주기도 다릅니다.

A

프로젝트 역사

Clash는 처음에 규칙 기반의 크로스 플랫폼 프록시 코어로 시작해 널리 사용되는 설정 문법과 정책 모델을 형성했습니다. 원본 프로젝트가 업데이트를 중단한 뒤에도 기존 설정 형식, 규칙 표현과 클라이언트 사용 방식은 생태계에서 이어졌습니다. 오래된 가이드를 읽을 때는 원본 Clash, 후속 코어 또는 특정 그래픽 클라이언트 중 무엇을 설명하는지 먼저 구분해 서로 다른 시기의 필드와 기능을 혼동하지 않도록 해야 합니다.

B

오픈 소스 생태계

일반적인 데스크톱 클라이언트는 그래픽 인터페이스, 설정 관리, 시스템 프록시 제어와 코어 프로세스로 구성됩니다. 인터페이스 프로젝트는 설치 경험, 구독 업데이트, 정책 선택과 시스템 통합을 담당하고, 코어는 프로토콜 연결, DNS, 규칙 매칭과 트래픽 전달을 담당합니다. 특정 클라이언트 화면의 유지 관리가 중단되어도 설정 문법이 즉시 무효가 되는 것은 아니지만, 시간이 지나면 시스템 호환성과 코어 기능의 차이가 커집니다.

C

Mihomo 코어

Mihomo는 Clash 설정 체계를 이어가면서 프로토콜, 규칙, DNS와 TUN 기능을 확장했습니다. 최신 데스크톱 클라이언트 대부분은 이를 교체 가능한 코어 또는 내장 실행 코어로 사용합니다. 설정 파일을 불러올 수 있는지는 YAML 문법뿐 아니라 현재 코어가 해당 필드를 지원하는지에 따라서도 결정됩니다. 낯선 설정 항목을 만나면 클라이언트 화면에서 같은 이름의 스위치를 찾기보다 먼저 코어 문서를 확인하세요.

D

업데이트 방식

클라이언트 업데이트, 코어 업데이트와 구독 업데이트는 서로 독립된 세 가지 경로입니다. 클라이언트 업데이트는 화면과 시스템 호환성 문제를 해결하고, 코어 업데이트는 프로토콜 및 네트워크 처리 방식을 바꾸며, 구독 업데이트는 노드, 정책 그룹과 원격 규칙을 교체합니다. 평소 세 상태를 따로 기록하고, 문제가 생기면 한 번에 한 단계만 되돌려 변화가 소프트웨어, 설정 또는 구독 내용에서 비롯되었는지 확인해야 합니다.

SOURCE COMMAND

Mihomo 소스 코드 저장소

아래 명령은 공개 소스 코드를 가져올 때 사용합니다. 코어를 컴파일하려면 별도의 Go 개발 환경이 필요합니다. 일상적인 사용만 필요하다면 그래픽 인터페이스가 포함된 클라이언트를 선택하는 편이 적합합니다.

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

FIRST CHECKS

자주 묻는 질문

아래 네 가지 질문은 처음 사용할 때 가장 자주 발생하는 문제를 다룹니다. 전체 작업 과정은 시작 가이드와 사용 설명서에 정리했으며, 여기서는 판단 기준만 간단히 안내합니다.

구독을 가져온 뒤 노드가 보이지 않는 이유는 무엇인가요?

먼저 링크가 웹 페이지나 다른 구독 형식이 아닌 Clash에서 읽을 수 있는 YAML 설정을 반환하는지 확인하세요. 이어서 설정이 정상적으로 다운로드되었고 현재 활성 항목으로 지정되었는지 점검합니다. 노드는 정책 그룹 안에 있을 수 있어 홈 화면에 바로 표시되지 않을 수도 있습니다.

구독 가져오기 단계 보기 →

시스템 프록시를 켰는데도 터미널이 직접 연결되는 이유는 무엇인가요?

일부 터미널 프로그램은 운영체제의 프록시 설정을 읽지 않습니다. HTTP, HTTPS 또는 SOCKS 환경 변수를 별도로 설정하거나 필요에 따라 TUN을 사용할 수 있습니다. 문제를 확인할 때는 브라우저와 터미널을 나누어 테스트하고 각 요청이 연결 페이지에 표시되는지 따로 확인하세요.

시스템 프록시와 TUN 보기 →

규칙 모드와 전역 모드 중 무엇을 선택해야 하나요?

일상적인 사용에는 규칙 모드가 적합합니다. 로컬 서비스, 프록시 대상과 차단 항목을 각각 처리할 수 있기 때문입니다. 전역 모드는 노드 연결 여부를 짧게 확인할 때 유용하지만 완전한 규칙을 대신할 수는 없습니다. 모드를 바꾼 뒤에는 기존 세션의 영향을 피하도록 새 테스트 연결을 만들어야 합니다.

프록시 모드 설명 보기 →

설정을 업데이트한 뒤 기존 사용자 지정 규칙은 어디로 갔나요?

원격 구독이 생성한 파일에 직접 추가한 내용은 다음 업데이트에서 통째로 교체될 수 있습니다. 장기적으로 사용자 지정하려면 클라이언트가 제공하는 오버라이드, 병합 또는 스크립트 기능을 사용하세요. 수정 전에는 실행 가능한 사본을 보관하고 최종 규칙이 삽입되는 위치와 MATCH와의 선후 관계를 확인해야 합니다.

규칙 유지 관리 방법 보기 →

LATEST NOTES

최근 사용 가이드

시스템 프록시, Windows 설치와 클라이언트 화면이라는 세 가지 주요 상황을 중심으로 재현 가능한 확인 순서에 따라 세부 조작법을 정리했습니다.

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