오픈소스 프로젝트 · 전체 플랫폼 클라이언트 지속 업데이트

Clash 공식 사이트 · 전체 플랫폼 클라이언트 다운로드

Windows / macOS / Android / iOS / Linux 5개 플랫폼용 클라이언트 다운로드 링크를 제공합니다. mihomo 코어 기반으로 규칙 기반 트래픽 분배구독 원클릭 가져오기를 지원합니다. 설치 파일은 업스트림 릴리스에 맞춰 계속 업데이트되며, 프로토콜 차이와 코어 선택은 프로토콜 참고 페이지에서, 설정과 문제 해결 방법은 가이드 페이지와 헬프 센터에서 확인할 수 있습니다.

영구 무료 오픈소스 코드 5개 플랫폼 동시 관리
[ SECTION 01 / DOWNLOAD ]

클라이언트 다운로드

플랫폼별로 다운로드 링크를 선택하세요. 플랫폼별 추천 클라이언트, 전체 버전 목록과 최소 시스템 요구 사항은 다운로드 페이지에서 확인하고, 다운로드 전에 기기의 CPU 아키텍처를 확인하세요.

Windows

Win 10 / 11 · x64 / ARM64

데스크톱과 노트북의 상시 백그라운드 운용에 적합하며, 시스템 프록시와 TUN 모드를 언제든 전환할 수 있습니다.

다운로드로 이동

macOS

Intel / Apple Silicon

두 가지 칩 아키텍처별로 별도 빌드를 제공하며, 네트워크 확장과 키체인 승인 절차는 가이드 페이지를 참고하세요.

다운로드로 이동

Android

Android 7+ · ARM64 / ARM

루팅 없이 VpnService로 전체 트래픽을 처리하며, 배터리 최적화 예외 목록에 추가하는 것을 권장합니다.

다운로드로 이동

iOS

App Store에서 통합 제공

오프라인 설치 파일이 없으며, 첫 실행 시 VPN 프로필 승인이 필요합니다. 절차는 블로그 글을 참고하세요.

다운로드로 이동

Linux

x64 / ARM64 · deb 등

deb 패키지와 사전 빌드 바이너리를 제공하며, 데스크톱 환경이 없는 서버에서도 서비스로 상시 운용할 수 있습니다.

다운로드로 이동
[ SECTION 02 / FEATURES ]

핵심 기능

모듈 실행 상태를 한눈에 확인하고, 행을 클릭하면 설명이 펼쳐집니다

NO.MODULESTATUS

규칙 기반 분배가 해결하는 것은 "어떤 트래픽을 프록시로, 어떤 트래픽을 직접 연결로 보낼 것인가"라는 가장 핵심적인 문제입니다. 도메인, GEOIP, IP-CIDR, 프로세스 이름 등의 조건을 위에서 아래로 하나씩 매칭하여 일치하면 지정된 아웃바운드로 라우팅하고, 일치하지 않으면 MATCH 폴백 규칙으로 넘어갑니다. 전역 프록시를 수동으로 전환하는 방식과 달리 규칙 모드는 한 번 설정하면 장기간 유효하며, 국내 트래픽은 우회 없이 직접 연결되고 해외 트래픽은 해당 정책 그룹으로 자동 분배됩니다. 규칙 세트는 원격 구독과 로컬 오버라이드 두 가지 방식으로 관리할 수 있으며 로컬 오버라이드가 우선 적용되고, 규칙을 업데이트해도 기존 연결은 끊기지 않습니다. 작성 예시와 매칭 우선순위는 프로토콜 참고 페이지와 용어 사전에서 확인하세요.

curl -I -x http://127.0.0.1:7890 https://example.com

서비스 제공업체마다 노드의 프로토콜은 제각각입니다. Shadowsocks, VMess, Trojan, VLESS, Hysteria2, TUIC에 WebSocket, gRPC 같은 전송 계층 조합까지, Clash는 하나의 YAML 설정 파일로 모두 통합 관리하므로 프로토콜마다 별도의 클라이언트를 설치할 필요가 없습니다. 노드는 url-test(지연 시간을 자동 측정해 가장 빠른 노드 선택), fallback(주 노드 장애 시 자동 전환), load-balance(여러 노드에 연결 분산) 등의 정책 그룹으로 구성할 수 있어 경로 선택을 코어에 맡기고 수동 개입을 최소화합니다. 어떤 프로토콜이 어떤 네트워크 환경에 적합한지, 코어별 프로토콜 지원 차이는 프로토콜 참고 페이지의 대조표에 정리되어 있습니다.

grep -c "name:" profile.yaml

구독 방식은 "노드 목록 유지 관리"라는 일을 사용자 손에서 덜어냅니다. 서비스 제공업체가 전체 노드와 추천 규칙을 하나의 URL로 묶어 제공하므로, 클라이언트에 붙여넣기만 하면 전체 설정을 가져올 수 있습니다. 노드 추가·삭제나 주소 변경은 다음 업데이트에서 자동으로 동기화되어 서버 정보를 일일이 옮겨 적을 필요가 없습니다. 시간 단위 또는 일 단위 정기 자동 업데이트를 지원하며, 업데이트 실패 시 이전 버전 캐시로 롤백하므로 한 번의 실패로 인터넷이 끊기는 일은 없습니다. 가져오기 입구는 각 클라이언트의 '설정' 또는 '구독' 페이지에 있으며, 구체적인 절차와 흔한 가져오기 오류의 해결법은 가이드 페이지 2단계와 헬프 센터에서 확인하세요.

mihomo -f profile.yaml -t

기존 '시스템 프록시'는 프록시 설정을 읽는 앱에만 적용되어 커맨드라인 도구, 게임 클라이언트, UWP 앱은 이를 건너뛰고 직접 연결하는 경우가 많습니다. TUN 모드는 시스템에 가상 네트워크 어댑터를 만들어 모든 발신 트래픽을 네트워크 계층에서 인수한 뒤 코어의 규칙 처리로 넘기므로, 앱마다 개별 설정이 필요 없고 시스템 프록시를 무시하는 프로그램에도 동일하게 적용됩니다. 활성화하려면 Windows는 관리자 권한, macOS는 네트워크 확장 승인, Android는 VpnService가 필요하며 모두 최초 1회 승인입니다. Windows UWP 루프백 제한 해제 방법과 TUN의 흔한 충돌 해결은 헬프 센터 해당 항목을 참고하세요.

ip route | head -n 3

DNS 오염과 해석 유출은 프록시 환경에서 가장 흔한 두 가지 숨은 장애입니다. 도메인이 잘못된 IP로 해석되어 규칙 판정이 어긋나거나, 해석 요청이 평문으로 로컬 ISP에 전송되어 접속 대상이 노출되는 경우가 이에 해당합니다. 내장 DNS 모듈은 fake-ip와 redir-host 두 가지 모드를 제공합니다. fake-ip는 예약 대역의 가상 주소를 반환하고 실제 해석을 출구 측으로 미루므로 빠르고 오염에 강하며, redir-host는 호환성이 좋아 실제 IP가 필요한 상황에 적합합니다. 상위 서버로는 DoH / DoT 암호화 조회를 지원하고, 국내외 해석을 도메인별로 서로 다른 리졸버에 분배할 수도 있습니다. 두 모드의 선택 기준은 용어 사전에서 자세히 다룹니다.

nslookup example.com 127.0.0.1

GUI 클라이언트로 할 수 있는 일은 스크립트와 패널로도 똑같이 할 수 있습니다. 코어는 로컬 9090 포트에 완전한 RESTful 제어 API를 노출하며 연결 목록, 노드 지연 시간, 트래픽 통계, 실행 로그를 JSON으로 반환합니다. 노드 전환, 모드 변경, 구독 업데이트 트리거도 HTTP 요청 한 번이면 됩니다. metacubexd, yacd 같은 오픈소스 웹 패널과 연동하면 특정 GUI에 의존하지 않고 시각화 모니터링이 가능하며, 정기 속도 측정이나 이상 알림 자동화 스크립트도 curl만으로 작성할 수 있습니다. API는 기본적으로 로컬 루프백 주소에서만 수신하므로, 외부에 공개하기 전에 반드시 secret 인증을 설정하세요.

curl http://127.0.0.1:9090/version
[ SECTION 03 / QUICKSTART ]

빠른 시작

3단계로 연결 완료, 전체 과정과 스크린샷은 가이드 페이지에서 확인

[ clashzip / quickstart ]
  1. 클라이언트 다운로드 및 설치

    다운로드 페이지에서 해당 플랫폼의 설치 파일을 선택하세요. x64와 ARM64 아키텍처를 구분해야 합니다. Windows와 macOS는 설치 마법사를 실행하고 첫 실행 시 안내에 따라 서비스 또는 네트워크 확장 승인을 완료하세요. Android는 APK를 설치하거나 스토어에서 받으며, iOS는 App Store를 통해 통합 설치합니다. 설치 후에는 설정 페이지를 한 번 열어 코어 버전과 자동 시작 옵션을 확인해 두는 것이 좋습니다.

  2. 구독 링크 가져오기

    서비스 제공업체가 제공한 구독 주소를 복사하여 클라이언트의 설정 또는 구독 페이지에 붙여넣고 가져옵니다. 노드 목록을 불러온 뒤 정기 자동 업데이트도 함께 켜 두세요. 가져오기가 실패하면 먼저 링크가 완전히 복사되었는지, 만료되지 않았는지 확인하고, 이어서 현재 네트워크에서 구독 서버에 직접 접속할 수 있는지 확인하세요. 반복 실패 시의 항목별 점검 목록은 헬프 센터에 있습니다.

  3. 노드 선택 및 연결 확인

    규칙 모드로 전환하고 정책 그룹에서 지연 시간이 낮은 노드를 선택한 다음, 임의의 웹페이지에 접속해 연결을 확인하고 속도 테스트로 대역폭이 기대치에 맞는지 확인합니다. 문제가 있으면 로그 패널을 열어 연결 실패, DNS 해석, 규칙 미일치 세 가지 관점에서 순서대로 점검하세요. 모바일에서는 앱이 시스템의 백그라운드 절전 정책에 의해 종료되지 않았는지도 확인해야 합니다.

3단계면 정상적으로 사용할 수 있습니다. 어느 단계에서 막혀도 처음부터 재설치할 필요는 없습니다. 설치 문제는 대부분 시스템 아키텍처나 권한 승인에서, 가져오기 문제는 구독 링크 자체에서, 연결 문제는 노드나 규칙에서 비롯됩니다. 문제 단계를 먼저 특정하는 것이 무작정 재시도하는 것보다 빠릅니다. 가이드 페이지에는 각 단계의 스크린샷과 플랫폼별 차이 설명이 있습니다.

[ SECTION 04 / TRUST ]

오픈소스 신뢰성

2018년 초기 코어부터 현재의 mihomo까지, 프로젝트 계보·코드·릴리스 절차가 모두 공개되어 있습니다

[ clashzip / open source ]
  • 추적 가능한 프로젝트 역사Clash 코어는 2018년 GitHub에 오픈소스로 공개되었고, 원본 저장소가 보관 처리된 뒤에는 커뮤니티 포크인 mihomo(구 Clash.Meta)가 유지 관리를 이어받았습니다. 설정 형식은 하위 호환되며, 계보 전체는 블로그의 생태계 해설 글에서 확인할 수 있습니다.
  • 코어 코드 공개mihomo 코어는 Go로 작성되어 GPL 라이선스로 공개 저장소에서 관리됩니다. 모든 커밋, 각 릴리스의 빌드 산출물과 체크섬을 추적할 수 있으며, 누구나 소스를 감사하거나 직접 빌드할 수 있습니다.
  • 커뮤니티 지속 관리각 플랫폼의 GUI 클라이언트(Clash Verge Rev, ClashMetaForAndroid 등)는 독립적인 커뮤니티 저장소에서 개발되며, 이슈 토론, 변경 로그, 릴리스 주기가 모두 공개되어 있습니다. 비공개 블랙박스 구성 요소는 없습니다.
  • 투명한 업데이트 체계이 사이트의 설치 파일은 업스트림 저장소의 정식 릴리스에 맞춰 동기화 업데이트되며, 재패키징이나 삽입을 하지 않습니다. 다운로드 전에 업스트림 릴리스 페이지에서 파일명과 버전 번호를 대조할 수 있어, 받는 파일은 개발자가 배포한 것과 동일합니다.
  • 코어와 UI의 분리 구조GUI 클라이언트는 화면과 프로세스 관리만 담당하고, 트래픽 처리는 전부 내장된 mihomo 코어가 수행합니다. UI 프로젝트가 멈춰도 코어는 독립적으로 업그레이드하거나 교체할 수 있어, 특정 프로젝트의 존폐에 얽매이지 않습니다.

오픈소스가 일반 사용자에게 갖는 의미는 추상적이지 않습니다. 트래픽 처리 로직이 누구나 읽을 수 있는 코드로 작성되어 있다는 것, 문제가 생기면 공개 이슈에서 같은 사례와 수정 진행 상황을 찾을 수 있다는 것, 그리고 어떤 클라이언트 프로젝트가 중단되어도 설정 파일과 구독을 그대로 생태계 내 다른 클라이언트로 옮겨 계속 쓸 수 있다는 뜻입니다. 아래 명령으로 코어 소스 코드를 직접 받아 검토하거나 빌드할 수 있습니다.

git clone https://github.com/MetaCubeX/mihomo.git
[ SECTION 05 / FAQ ]

자주 묻는 질문 모음

한 줄 답변만 제공, 전체 문제 해결 절차는 헬프 센터에서 확인

[ clashzip / faq digest ]

아래 네 항목은 신규 사용자가 가장 자주 묻는 상황을 다룹니다. 먼저 자신의 증상과 대조하면 진단 시간을 크게 줄일 수 있습니다. 해당하지 않는 문제는 헬프 센터에서 증상으로 검색하세요.

  • 구독을 가져왔는데 노드가 없다?먼저 링크가 완전히 복사되었는지, 만료되지 않았는지 확인하고 클라이언트에서 수동 업데이트를 한 번 실행하세요. 그래도 실패하면 헬프 센터의 가져오기 점검 목록을 항목별로 확인하세요.
  • 프록시를 켰는데 일부 앱에 적용되지 않는다?커맨드라인 도구와 UWP 앱은 시스템 프록시를 건너뛰는 경우가 많습니다. TUN 모드로 전환해 전체 트래픽을 인수하면 해결되며, 활성화 절차는 가이드 페이지에 있습니다.
  • 어떤 프로토콜의 노드를 골라야 하나?일반 네트워크에서는 Shadowsocks / VMess면 충분하고, 제한이 심한 환경에서는 Trojan이나 Hysteria2를 우선하세요. 비교 결론은 프로토콜 참고에서 확인할 수 있습니다.
  • 규칙 모드와 전역 모드는 어떻게 고르나?평소에는 규칙 모드로 도메인별 자동 분배를 사용하고, 전역 모드는 임시 디버깅에만 쓰세요. 개념 차이는 용어 사전에 있습니다.
[ SECTION 06 / BLOG ]

최신 글

선택 가이드, 플랫폼 안내, 문제 해결 기록. 장문 문서는 계속 추가 중이며 전체 글 입구는 푸터에 있습니다

선택 가이드 2026-07-11

Clash 오픈소스 생태계 한눈에 보기: 코어, GUI 클라이언트, 규칙 프로젝트의 관계 정리

코어 프로젝트, 각 플랫폼 GUI 클라이언트, 규칙 세트, 변환 도구를 하나의 관계도로 정리하여 누가 무엇에 의존하는지, 어떤 프로젝트가 보관 처리되었는지, 커뮤니티 유지 현황이 어떤지 설명해 독자가 생태계를 이해하고 선택할 수 있도록 돕습니다.

플랫폼 2026-06-25

iOS에서 Clash 사용법: App Store로 클라이언트 받고 구독 설정 가져오기

iOS 플랫폼에는 오프라인 설치 파일이 없어 클라이언트는 App Store를 통해서만 받을 수 있습니다. 스토어 다운로드, 첫 실행 시 VPN 프로필 권한 승인, 구독 링크 가져오기, 노드 연결 확인까지 네 단계를 순서대로 보여줍니다.

문제 해결 2026-06-04

모바일에서 Clash 배터리 소모가 심할 때 점검 방법: 백그라운드 실행 정책과 절전 설정 조정

규칙 세트 폴링, 로그 레벨, DNS 동시 조회부터 시스템 백그라운드 제한까지 단계별로 모바일 배터리 소모 원인을 찾아내고, Android 배터리 최적화 예외 목록과 iOS 필요 시 연결 설정의 구체적인 방법을 제시합니다.

클라이언트 받기