clashsdk / clash

Public
Clash 공식 다운로드 Code Releases Wiki License

버전 릴리스 타임라인 · 코어 mihomo, 마우스를 올리면 버전 번호 표시

적음 많음

clashsdk / clash / README.md

오픈소스 라이선스 MIT 코어 mihomo 5개 플랫폼 클라이언트 완전 무료

Clash 전체 플랫폼 클라이언트 다운로드와 한국어 가이드

Clash는 오픈소스 네트워크 프록시 클라이언트로, 규칙 기반 분기를 핵심 설계로 삼아 TUN 모드와 구독 관리를 지원합니다. 이 사이트는 Windows, macOS, Android, iOS, Linux 5개 플랫폼의 설치 파일과 한국어 가이드, 문제 해결 문서를 함께 제공하며, 버전은 업스트림 공개 릴리스를 따라 갱신됩니다.

코어 실행 · 터미널 출력 
$ mihomo -d ~/.config/mihomo
INFO[0000] Start initial configuration in progress
INFO[0000] RESTful API listening at: 127.0.0.1:9090
INFO[0000] HTTP(S) proxy listening at: 127.0.0.1:7890
Clash 다운로드 사용 가이드 보기 Windows · macOS · Android · iOS · Linux

전체 플랫폼 설치 파일

download.html 전체 클라이언트 보기 →
Windows setup.exe · x64 / ARM64

Windows 10/11을 지원하며, 설치 후 시스템 프록시 또는 TUN 모드를 선택할 수 있습니다. Clash Plus와 Clash Verge Rev를 추천합니다.

다운로드하기 → macOS .dmg · Intel / Apple Silicon

칩 아키텍처별로 설치 파일이 나뉘어 있어, Apple Silicon과 Intel용을 각각 받으면 에뮬레이션 손실 없이 사용할 수 있습니다.

다운로드하기 → Android .apk · arm64 / armv7

Android 7.0 이상에서 APK를 바로 설치할 수 있으며, 시스템 VPN 인터페이스로 트래픽을 처리해 루팅이 필요 없습니다.

다운로드하기 → iOS App Store

App Store에서 Clash Plus를 설치할 수 있으며, iPhone과 iPad를 모두 지원하고 설정 형식은 데스크톱과 동일합니다.

다운로드하기 → Linux .deb / .rpm · amd64

주요 배포판에서는 GUI 클라이언트를 사용할 수 있고, 서버나 라우터에는 mihomo 코어만 따로 설치할 수 있습니다.

다운로드하기 →

핵심 기능

docs/features/

왼쪽 파일명을 클릭하면 오른쪽 패널에 해당 기능 설명이 표시됩니다. 저장소에서 마크다운 파일을 하나씩 열어보는 것과 같은 방식입니다.

clash / docs / features / rules.md

규칙 기반 분기

규칙 기반 분기는 '어떤 트래픽을 프록시로 보내고 어떤 트래픽을 직접 연결할지'를 결정하는 기능입니다. Clash는 DOMAIN-SUFFIX, DOMAIN-KEYWORD, IP-CIDR, GEOIP 등의 규칙 유형을 사용하며, 설정 파일에 작성된 순서대로 위에서부터 하나씩 매칭해 일치하는 순간 해당 정책(직접 연결, 특정 프록시 그룹 사용, 또는 차단)을 실행합니다.

일반적으로는 커뮤니티가 관리하는 규칙 세트를 구독하고, 필요에 따라 특정 사이트용 사용자 규칙을 몇 줄 추가하는 방식으로 사용합니다. 클라이언트 화면에서 규칙 / 전역 / 직접 연결 세 가지 모드를 한 번에 전환할 수도 있습니다. 전역 스위치만 있는 단순한 프록시 도구와 비교하면, 규칙 기반 분기는 로컬 트래픽은 우회하지 않고 해외 트래픽만 노드를 거치게 해 속도와 호환성이 더 안정적입니다. 규칙 작성법은 사용 가이드에서 확인할 수 있습니다.

오픈소스 생태계와 업데이트 방식

docs/project/

프로젝트 히스토리

Clash는 2018년에 처음 공개되었고 Go 언어로 작성되었으며, 규칙 기반 분기가 다른 유사 도구와 구별되는 핵심 설계였습니다. 원본 저장소가 2023년에 유지 관리를 중단하고 보관 처리된 이후, 커뮤니티 포크인 Clash.Meta가 코어 개발을 이어받아 mihomo로 이름을 바꾸고 지금까지 계속 발전하고 있습니다. 지원 프로토콜, 규칙 유형, API 모두 기존 기반 위에서 계속 확장되고 있습니다.

코어와 클라이언트의 관계

코어는 프로토콜 구현, 규칙 매칭, 트래픽 전달을 담당하고 GUI 클라이언트는 화면, 구독 관리, 시스템 통합을 담당합니다. 즉 두 요소는 계층적으로 분리되어 있습니다. 이 사이트에서 소개하는 Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트는 모두 mihomo 코어를 내장하고 있어 설정 형식이 서로 호환되며, 클라이언트를 바꿔도 설정 파일을 다시 작성할 필요가 없습니다.

설치 파일 출처와 업데이트

이 사이트는 어떤 설치 파일도 수정하지 않으며, 다운로드 링크는 각 프로젝트가 공개 배포한 원본 버전을 그대로 가리킵니다. 다운로드 페이지의 버전 번호는 업스트림 최신 release를 자동으로 따르므로 수동으로 비교할 필요가 없습니다. 업스트림에 새 버전이 나오면 클라이언트 내부의 업데이트 알림과 이 사이트의 다운로드 페이지가 함께 갱신되며, 기존 버전 사용자는 그대로 덮어 설치해도 설정이 유지됩니다.

커뮤니티 협업

코어와 클라이언트 외에도 규칙 세트, 구독 변환 도구, GeoIP 데이터베이스 같은 주변 도구들 역시 커뮤니티가 오픈소스로 관리하며 하나의 완전한 도구 체인을 이룹니다. 기능상의 문제가 있다면 해당 프로젝트의 공개 저장소에 이슈를 등록할 수 있습니다. 이 사이트의 문서는 한국어 사용자를 위한 설치, 설정, 문제 해결에 초점을 맞추고 있으며 업스트림 문서를 보완하는 역할을 합니다.

소스 코드로 코어 빌드 
$ git clone https://github.com/MetaCubeX/mihomo.git
$ cd mihomo && go build

자주 묻는 질문

docs/faq.md

구독 링크를 가져왔는데 노드가 보이지 않아요

먼저 링크가 Clash/YAML 형식인지 확인하고, 구독 변환 도구가 필요한 형식인지 점검하세요. 전체 절차는 사용 가이드에서 확인할 수 있습니다.

프록시를 켰는데도 웹사이트가 열리지 않아요

'시스템 프록시 스위치 → 노드 상태 → DNS 설정' 순서로 하나씩 확인해 보세요. 단계별 절차는 문제 해결에서 볼 수 있습니다.

iPhone/iPad에는 어떻게 설치하나요

App Store에서 Clash Plus를 설치하면 됩니다. 스토어 링크와 안내는 다운로드 페이지 iOS 항목에서 확인하세요.

클라이언트가 너무 많은데 뭘 골라야 하나요

데스크톱과 모바일 모두 Clash Plus를 추천하며, 커스터마이징 여지를 원한다면 Clash Verge Rev도 좋은 선택입니다. 항목별 비교는 선택 가이드에서 확인할 수 있습니다.

최신 아티클

blog/ 전체 아티클 보기 →

원리 분석

Fake-IP 모드 원리 상세 설명: DNS 해석이 어떻게 처리되는지, 언제 켜고 꺼야 하는지

DNS 조회 과정부터 시작해 Fake-IP가 예약된 네트워크 대역의 가상 주소로 매칭을 빠르게 하고 DNS 유출을 줄이는 방식을 설명하고, Redir-Host와의 차이를 비교하며 LAN 서비스나 게임 멀티플레이처럼 꺼야 하거나 예외를 추가해야 하는 대표적인 상황을 정리합니다.

입문 가이드

Clash 클라이언트 화면 한눈에 보기: 프록시 탭, 설정 탭, 로그 탭이 각각 하는 일

클라이언트 메인 화면을 영역별로 살펴봅니다. 프록시 탭의 그룹과 노드 전환, 설정 탭의 구독 관리와 규칙 로딩, 로그 탭의 연결 기록을 활용한 문제 해결 방법까지 다루며, 처음 사용하는 사람이 전체 화면의 기능을 한 번에 파악할 수 있게 정리했습니다.

구독과 설정

Clash 구독 형식 정리: YAML, Base64 노드 목록, 범용 형식의 차이와 변환 방법

자주 쓰이는 구독 형식의 구조적 차이를 정리합니다: Clash YAML 설정, Base64로 인코딩된 노드 목록, 각 클라이언트 고유 형식을 다루며 일부 링크가 가져오기에 실패하는 이유와 변환 도구로 형식을 안전하게 바꿀 때 주의할 점을 설명합니다.