오픈 소스 커널 · 모든 플랫폼 클라이언트 clash-desktop.com

Clash최신 버전 다운로드

mihomo 커널을 중심으로 규칙 분류와 TUN 모드 설정 방법을 안내합니다.

오픈 소스 코드 YAML 설정 한국어 문서
엔진 mihomo 커널 및 클라이언트
LICENSE / CORE
GPL-3.0
CONFIG
YAML
ROUTING
규칙 / 전역 / 직접 연결

플랫폼 / 플랫폼별 안내

Clash 클라이언트 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. 설치 파일, 유지 관리 상태, 플랫폼별 요구 사항은 다운로드 페이지에서 확인할 수 있습니다.

Windows

그래픽 인터페이스에서 구독, 프록시 그룹, 연결 기록을 관리하려는 사용자에게 적합합니다. Clash Plus를 시작점으로 삼거나 사용 방식에 따라 Clash Verge Rev 등을 선택할 수 있습니다. 설치 전에 시스템 정보에서 프로세서 아키텍처를 확인해 다른 아키텍처용 설치 파일을 잘못 사용하지 않도록 하세요.

처음 연결할 때는 시스템 프록시를 사용해 브라우저 접속을 확인하세요. 다른 앱의 트래픽까지 처리해야 한다면 서비스 구성 요소와 TUN 권한을 확인하세요. Clash for Windows는 지원이 종료되었습니다. 보관용 다운로드와 현재 사용 가능한 클라이언트는 별도로 안내합니다.

다운로드 Windows 클라이언트

macOS

Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택하세요. 데스크톱 클라이언트는 보통 메뉴 막대 제어, 설정 전환, 시스템 프록시 기능을 제공합니다. Clash Plus, Clash Verge Rev, FlClash의 세부 옵션은 다운로드 페이지에서 확인할 수 있습니다.

설치 후 먼저 시스템에서 요구하는 권한을 허용한 다음 설정을 가져오세요. TUN을 켠다면 네트워크 확장 프로그램이나 서비스 권한도 확인해야 합니다. 클라이언트를 바꾸기 전에 기존 프록시를 끄면 여러 앱이 시스템 프록시 설정을 반복해서 바꾸는 일을 줄일 수 있습니다.

다운로드 macOS 클라이언트

Android

시스템 VPN 인터페이스를 통해 앱의 연결을 처리합니다. Clash Plus, Clash Meta for Android, FlClash 중에서 선택할 수 있습니다. 클라이언트마다 인터페이스와 커널 지원 범위가 다르므로 설정을 가져오기 전에 형식을 확인하세요.

처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 실행, 제조사 시스템의 자동 실행 제한을 확인하세요. 다른 VPN 앱과 동시에 사용할 수 없는 경우도 있으니 하나씩 점검하세요.

다운로드 Android 클라이언트

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 후 클라이언트가 지원하는 방식으로 설정을 가져오고, 구독 내용을 인식하는지 확인한 다음 VPN 설정 생성을 허용하세요.

모바일 데이터와 Wi-Fi를 전환한 뒤 같은 웹사이트에 다시 접속해 연결을 비교할 수 있습니다. 데스크톱 설정의 프로세스 규칙, 파일 경로, 네트워크 스택 매개변수를 휴대폰에 그대로 적용하지 마세요. 플랫폼별 차이는 모든 플랫폼 가이드에서 확인하세요.

다운로드 iOS 클라이언트

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 사용하세요. 서버, 라우터 또는 서비스를 직접 관리하려는 경우 다운로드 페이지의 커널 항목에서 mihomo를 찾을 수 있습니다.

그래픽 인터페이스가 정상적으로 실행되어도 라우팅이 적용된 것은 아닙니다. 시스템 프록시는 데스크톱 환경과 앱 지원 여부에 따라 달라지고, TUN은 기기 권한, 라우팅, DNS 설정이 필요합니다. 먼저 포그라운드에서 로그를 확인한 뒤 백그라운드 서비스와 시작 프로그램 설정을 검토하세요.

다운로드 Linux 클라이언트

라우팅 / 기능 안내

핵심 기능과 설정 범위

트래픽 분류는 규칙부터 확인하세요.
연결 처리 여부는 시스템 설정에서 확인하세요.

아래 예시는 mihomo 설정 구조를 설명하기 위한 것으로, 그대로 연결에 사용할 수 있는 완성 설정이 아닙니다. 전략 그룹, 노드, 규칙 파일은 직접 추가해야 하며 다른 커널이나 클라이언트에서는 호환 여부를 먼저 확인하세요.

구독 가져오기부터 시작 →

소스 / 오픈 소스와 유지 관리

Clash 생태계와 mihomo 커널

클라이언트 이름만으로 호환성을 판단할 수 없습니다.
설정 동작은 커널과 문서를 확인하세요.

프로젝트 이력: 이름과 유지 관리 상태 확인

Clash는 규칙 기반 프록시 커널로 알려지기 시작했고, 이후 여러 운영체제용 그래픽 클라이언트가 등장했습니다. 원래 Clash 프로젝트와 일부 초기 클라이언트의 유지 관리가 중단된 뒤에도 생태계에서는 다양한 후속 프로젝트가 이어지고 있습니다. Clash Meta는 이후 mihomo라는 이름으로 개발을 계속했기 때문에 예전 가이드의 Clash, Meta와 현재 문서의 mihomo가 서로 다른 시기의 프로젝트를 가리킬 수 있습니다. 가이드를 읽을 때는 커널, 클라이언트, 설정 형식 중 무엇을 설명하는지 먼저 확인하세요.

Clash for Windows는 과거 데스크톱 클라이언트의 이름이지 Windows용 모든 Clash 클라이언트를 통칭하는 말이 아닙니다. 기존 환경을 살펴보려는 목적이라면 예전 설치 파일을 사용할 수 있지만, 유지 관리가 중단되어 이후 시스템 호환성, 프로토콜 지원, 문제 수정은 보장되지 않습니다. 새로 설치할 때는 현재도 유지 관리되는 클라이언트를 우선 비교하세요. 이전할 때는 기존 설정을 보관하고 프로그램 파일만 바꾸기보다 규칙, DNS, 프록시 그룹의 호환성을 확인하세요.

오픈 소스 생태계: 코드 라이선스와 서비스 출처 구분

mihomo 소스 코드는 GPL-3.0 라이선스로 공개되어 있으며 공개 저장소에서 구현, 커밋 기록, 이슈 논의를 확인할 수 있습니다. 코드를 공개하면 설정 동작을 직접 살펴볼 수 있지만, 그래픽 클라이언트의 기능, 패키징 방식, 유지 관리 주기는 해당 프로젝트의 안내를 기준으로 판단해야 합니다. 저장소의 별 수로 연결 품질을 추측하거나 커뮤니티의 인기를 모든 기기에 적합하다는 근거로 삼지 않습니다. 운영체제 지원, 필요한 권한, 유지 관리 방식에 주목해 클라이언트를 선택하세요.

오픈 소스 커널, 클라이언트, 연결 서비스는 서로 다른 계층입니다. 소프트웨어 라이선스는 코드를 사용하고 배포하는 방법을 정하고, 구독 서비스는 연결 정보와 이용 조건을 제공합니다. 서로를 대체할 수는 없습니다. 공개 노드는 언제든 작동을 멈출 수 있으며 공유 페이지만으로 운영 주체를 확인하기도 어렵습니다. 계정 로그인, 결제 등 민감한 작업을 할 때는 연결 경로의 출처를 살펴보고 대상 앱 자체의 암호화 연결도 계속 사용하세요.

커널 관계: 인터페이스 설정이 모든 플랫폼에서 같지는 않습니다

그래픽 클라이언트는 보통 설정 관리, 시스템 프록시 전환, 서비스 설치, 로그 표시를 담당하고 커널은 실제 연결을 처리합니다. 여기서 소개하는 문법은 mihomo를 기준으로 합니다. iOS 등 다른 플랫폼의 클라이언트는 해당 문서에서 지원 범위를 확인하세요. 같은 YAML을 사용하더라도 커널 기능, 플랫폼 네트워크 인터페이스, 클라이언트의 오버라이드 방식에 따라 일부 필드의 동작이 달라질 수 있습니다. 설정을 가져올 수 있다는 것은 파일이 받아들여졌다는 뜻일 뿐이므로 실제 트래픽 경로도 확인해야 합니다.

시스템 프록시, TUN, 규칙 모드는 서로 다른 계층에서 작동합니다. 시스템 프록시는 앱이 프록시 설정을 사용해야 하고, TUN은 네트워크 라우팅을 통해 트래픽을 가져오며, 규칙 모드는 트래픽을 처리한 뒤 적용할 정책을 정합니다. 이 세 가지를 구분하면 브라우저에서는 접속되지만 다른 앱에서는 안 되는 문제나 전역 모드인데도 연결이 우회되는 문제를 더 빠르게 찾을 수 있습니다. 먼저 연결이 커널에 들어오는지 확인하고, 다음으로 적용된 규칙을 살펴본 뒤 선택한 경로에 연결할 수 있는지 확인하세요.

업데이트 방식: 프로그램, 구독, 규칙 데이터를 따로 확인

클라이언트 업데이트는 인터페이스와 시스템 연동에 영향을 줄 수 있고, 커널 업데이트는 프로토콜이나 설정 동작을 바꿀 수 있습니다. 구독 업데이트는 연결 정보를 교체하고, 규칙 모음과 지리 데이터베이스 업데이트는 분류 결과에 영향을 줍니다. 이 작업들이 반드시 한꺼번에 진행되는 것은 아닙니다. 업그레이드 전에 사용 중인 설정과 로컬 오버라이드를 기록하고 변경 사항을 읽어보세요. 업그레이드 뒤에는 자주 방문하는 사이트, 로컬 네트워크 기기, 절전 모드 해제 후 연결을 확인하세요. 네트워크 매개변수를 한꺼번에 바꾸지 않는 것이 좋습니다.

다운로드 페이지에서 플랫폼별 링크와 설치 안내를 확인할 수 있으며, 홈 화면에는 특정 릴리스 번호를 고정해 표시하지 않습니다. 업그레이드 후 문제가 생기면 최소 설정으로 재현한 뒤 규칙 모음, DNS 정책, TUN을 차례로 다시 적용하세요. 프로젝트에 문제를 제보할 때는 운영체제, 클라이언트 이름, 커널 정보, 재현 절차를 포함하고 구독 주소, 계정 정보 등 민감한 내용은 삭제하세요. 단순히 인터넷에 연결되지 않는다고만 적으면 DNS 오류, 라우팅 충돌, 연결 경로 문제를 구분하기 어렵습니다.

노트 / 설정 가이드

최신 설정 가이드

트래픽 처리, 도메인 조회, 연결 경로 선택을 단계별로 확인하세요. 예시는 설정 방법을 설명하기 위한 것이며, 실제 매개변수는 사용하는 클라이언트의 지원 범위에 맞춰야 합니다.