오픈소스 프로젝트 · 모든 플랫폼에서 클라이언트 업데이트

Clash 클라이언트
무료 다운로드

Clash 다운로드 사용 안내 보기

기기에 맞는 클라이언트를 선택하고 하나의 호환 설정 파일로 구독과 규칙 기반 라우팅을 관리하세요. 설치부터 연결까지 한국어 안내를 확인할 수 있습니다.

오픈소스멀티 플랫폼 설정단계별 안내

플랫폼 선택

Windows Android iOS macOS Linux

클라이언트 다운로드

운영체제에 맞는 Clash 클라이언트 선택

먼저 운영체제를 확인한 뒤 프로세서 아키텍처를 선택하세요. 데스크톱 GUI, 모바일 앱, 독립 실행형 코어는 설치 방법이 다릅니다. 다운로드 페이지에서 지원 기기와 설치 요건을 확인할 수 있습니다.

Windows

Clash Plus를 먼저 살펴보세요. Clash Verge Rev, FlClash 같은 GUI 클라이언트도 비교할 수 있습니다. 설치 전에 시스템 정보에서 아키텍처를 확인하고, 처음에는 시스템 프록시부터 설정하세요. 다운로드 페이지로 이동 →

macOS

Apple Silicon용과 Intel용 설치 파일을 구분하세요. 메뉴 막대에서 연결을 관리할 수 있습니다. TUN을 사용하려면 클라이언트 안내에 따라 서비스를 설치하거나 네트워크 권한을 허용하세요. 다운로드 페이지로 이동 →

Android

Clash Plus, Clash Meta for Android 등의 옵션을 확인하세요. 기기에 맞는 APK를 선택하고 설정을 가져온 다음, 시스템 VPN 요청을 승인하고 백그라운드 실행 및 배터리 제한을 확인하세요. 다운로드 페이지로 이동 →

iOS

App Store에서 Clash Plus를 다운로드할 수 있으며 공식 사이트는 clashplus.io입니다. 먼저 스토어에서 시스템 요구 사항을 확인한 뒤 호환되는 구독을 가져오고 앱의 VPN 설정 추가를 허용하세요. 다운로드 페이지로 이동 →

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 다운로드할 수 있습니다. 서버와 라우터 사용자는 mihomo 코어 및 서비스 설정 안내도 확인하세요. 다운로드 페이지로 이동 →

클라이언트는 설정 관리와 로컬 트래픽 전달 기능을 제공합니다. 원격 프록시 기능은 직접 준비한 서비스와 설정에 따라 달라지며, 앱을 설치한다고 사용할 수 있는 노드가 생기는 것은 아닙니다. 구독이 있다면 대상 클라이언트가 사용하는 설정 형식과 호환되는지 먼저 확인하세요. 기존 클라이언트에서 옮길 때는 원래 설정을 보관하고 로컬 포트, 권한, 규칙 호환성을 다시 점검하세요.

전체 클라이언트 보기 →

설정과 연결

규칙, 모드, 네트워크 트래픽 처리

화면은 기능을 설명하기 위한 예시이며 특정 클라이언트의 전체 화면을 재현한 것이 아닙니다. 클라이언트마다 메뉴 이름이 다를 수 있습니다. 먼저 설정과 트래픽의 관계를 이해한 뒤 실제 메뉴에서 해당 기능을 찾아보세요.

일반 설정

규칙 기반 라우팅

위에서 아래로 규칙 적용
먼저 일치하는 규칙이 적용됩니다

rules:
  - DOMAIN-SUFFIX,google.com,Proxy
  - IP-CIDR,192.168.0.0/16,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
기본 정책Proxy

정책 그룹 이름은 설정에 정의된 이름과 일치해야 합니다.

전체 시스템 안내 읽기 →핵심 개념부터 설정 관리까지, 항목별로 확인하세요.

설정 재사용의 범위

mode: rule
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - DIRECT
rules:
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

구조 예시는 정책 참조 관계를 보여줍니다. 실제 프록시 출구는 본인의 설정에서 정의해야 합니다.

멀티 플랫폼 설정

동일한 규칙을 사용하고
기기별 권한은 따로 설정

같은 설정 형식을 지원하는 클라이언트끼리는 도메인 규칙과 정책 그룹 정의를 공유할 수 있습니다. 설정을 복사하면 기기마다 트래픽 분기 방식을 다시 정리할 필요가 없습니다. 하지만 로컬 네트워크 설정까지 그대로 옮길 수는 없습니다. 데스크톱의 수신 포트, 모바일의 VPN 권한, 운영체제별 시작 방식은 각 기기의 실행 환경에 따라 달라집니다.

기기 간 설정을 옮기기 전에 코어 지원 여부를 확인한 다음 설정을 가져오세요. 설정에 로컬 규칙 파일, 스크립트 또는 특정 확장 필드가 포함되어 있다면 대상 클라이언트가 이를 인식하는지 확인해야 합니다. 구독 주소만 복사한다고 모든 클라이언트에서 기능이 완전히 같아지는 것은 아닙니다. 사용할 수 있는 설정을 따로 보관하면 이전하거나 되돌리기 쉽습니다.

  1. 설치하고 구독 가져오기

    운영체제에 맞는 클라이언트를 다운로드한 다음 설정 관리에서 호환되는 구독을 가져와 선택하세요. 구독이 없다면 먼저 사용할 수 있는 설정을 준비해야 합니다. 설치 파일이 원격 프록시 서비스를 만들어 주지는 않습니다.

  2. 모드와 출구 선택

    규칙 모드를 선택하고 프록시 페이지에서 정책 그룹이 사용 가능한 출구를 가리키는지 확인한 다음 시스템 프록시나 플랫폼에서 필요한 VPN 연결을 활성화하세요. 처음 설정할 때는 다른 네트워크 도구를 함께 사용하지 않는 것이 좋습니다.

  3. 연결 및 라우팅 확인

    자주 방문하는 웹 페이지에 접속하고 연결 페이지에서 적용된 규칙을 확인하세요. 로컬 서비스와 자주 사용하는 앱도 테스트해 프록시 요청과 직접 연결 요청이 예상대로 처리되는지 살펴보세요.

빠른 시작 · 3단계

먼저 연결을 확인하고
고급 설정은 나중에 조정

처음 사용할 때는 설정 유효성, 출구 사용 가능 여부, 트래픽이 클라이언트로 들어오는 순서로 확인하세요. 가져오기에 성공한 것은 첫 단계일 뿐입니다. 정책 그룹에서 출구를 선택했는지, 앱 트래픽이 실제로 클라이언트를 거치는지도 확인해야 합니다. 연결에 실패하면 오류 메시지부터 확인하고 문제 해결 대신 모드를 계속 바꾸지 마세요.

한 번에 설정 하나만 바꾸고 변경 전 상태를 기록해 두세요. 기본 연결이 확인되면 TUN, 사용자 지정 DNS, 규칙 덮어쓰기를 차례로 시도할 수 있습니다. 이렇게 하면 어떤 변경이 네트워크에 영향을 줬는지 파악하고 구독 업데이트 뒤에도 기존 환경을 빠르게 복구할 수 있습니다.

전체 안내 보기 →

오픈소스 생태계와 유지 관리

클라이언트 화면과 프록시 코어의 역할

소프트웨어의 출처와 설정을 실행하는 주체를 이해하는 것이 앱 이름만 확인하는 것보다 중요합니다. 이 사이트는 다운로드 경로와 사용 안내를 정리하며 프록시 서비스를 제공하지 않습니다. 실제 기능은 선택한 클라이언트와 해당 클라이언트가 지원하는 코어에 따라 달라집니다.

Clash에서 mihomo까지

Clash는 설정 파일로 프록시, 정책 그룹, 규칙을 관리하는 사용 방식을 정립했습니다. 원 프로젝트와 이를 기반으로 만들어진 클라이언트는 서로 다른 관리 주체입니다. 이후 Clash Meta／mihomo 생태계에서는 호환 설정과 네트워크 기능이 계속 발전했습니다. 따라서 이름에 Clash가 들어가도 같은 팀에서 만든 제품이라는 뜻은 아니며, 지원하는 프로토콜과 필드가 모두 같다는 의미도 아닙니다.

새 클라이언트를 선택할 때는 현재 유지 관리 상태, 운영체제 지원, 코어 호환성을 우선 확인하세요. 이전 클라이언트는 마이그레이션 배경을 파악하는 데 도움이 되지만, 장기간 사용하려면 시스템 업데이트에 따른 권한, 네트워크 스택, 설치 호환성 변화도 고려해야 합니다. 기존 설정을 한 번에 다시 작성할 필요는 없습니다. 계속 유지 관리되는 클라이언트로 먼저 가져온 다음 로그를 확인해 지원되지 않는 필드를 처리하세요.

화면은 관리하고 코어는 실행합니다

GUI 클라이언트는 보통 구독 관리, 모드 전환, 시스템 프록시, 로그 메뉴를 제공합니다. 코어는 설정 해석, 규칙 매칭, 프록시 연결, DNS 처리를 담당합니다. 특정 메뉴를 사용할 수 있는지는 화면 기능뿐 아니라 클라이언트에 포함된 코어와 권한 방식에도 달려 있습니다. 안내와 화면이 다르면 먼저 클라이언트 이름을 확인한 뒤 비슷한 기능의 메뉴를 찾아보세요.

이 사이트의 다운로드 페이지에서는 GUI 클라이언트와 독립형 mihomo 코어를 구분해 소개합니다. 일반 데스크톱 및 모바일 사용자는 GUI부터 시작하면 설정하기 쉽습니다. 서버, 라우터, 자동화 배포 환경에서는 설정 경로, 서비스 권한, 실행 방식을 직접 관리해야 합니다. 코어만 따로 다운로드해도 GUI의 시스템 프록시 설정 기능이 생기는 것은 아닙니다.

공개 소스와 이슈 추적

오픈소스 저장소에서는 구현 내용을 읽고 설정 필드의 용도를 확인하거나 알려진 문제를 검색할 수 있습니다. 이슈 기록을 살펴볼 때는 재현 조건이 같은지 비교하세요. 같은 현상이라도 구독 만료, 대상 사이트의 제한, 로컬 프록시 포트 충돌 때문일 수 있으며 모두 프로그램 결함인 것은 아닙니다. 제보할 때 클라이언트 이름, 운영체제, 재현 절차, 민감 정보를 가린 로그를 준비하면 확인에 드는 시간을 줄일 수 있습니다.

아래 명령은 mihomo 소스 코드를 가져옵니다. 구현 내용을 살펴보거나 개발에 참여하려는 사용자를 위한 것으로, 일반적인 사용을 위해 프로젝트를 먼저 빌드할 필요는 없습니다. 다운로드 페이지에서 클라이언트를 선택하면 됩니다. 저장소의 빌드 안내, 설정 설명, 릴리스 기록을 함께 확인하세요. 공개된 소스는 검토에 도움이 되지만 로컬 환경과 설정 내용을 직접 확인하는 일을 대신하지는 않습니다.

업데이트 전 복구할 수 있는 상태 보관

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 앱 업데이트는 화면과 권한 절차를 바꿀 수 있고, 코어 업데이트는 필드 지원과 연결 동작에 영향을 줄 수 있으며, 구독 업데이트는 프록시 그룹이나 규칙을 바꿀 수 있습니다. 변경을 분리해 적용하면 문제가 생겼을 때 원인을 파악하고 로그를 보며 단계적으로 되돌리기 쉽습니다.

업데이트 전에 현재 선택한 설정, 정책 그룹, 로컬 덮어쓰기 항목을 기록하고 자체 규칙 파일을 보관하세요. 구독 내용은 보통 제공자가 관리하므로 다운로드한 파일을 직접 수정하면 다음 업데이트에서 덮어써질 수 있습니다. 수정 사항을 계속 유지하려면 클라이언트에서 지원하는 덮어쓰기나 병합 기능을 우선 사용하세요. 새 설정을 적용한 뒤에는 웹 페이지, 로컬 네트워크, 자주 사용하는 앱을 확인하세요.

mihomo 소스 코드 보기

로컬에 Git이 설치되어 있어야 합니다. 이 명령은 저장소만 가져오며 프록시 서비스를 설치하거나 실행하지 않습니다.

프로젝트 저장소 열기 ↗ 
git clone https://github.com/MetaCubeX/mihomo.git

Linux 펭귄 아이콘: Font Awesome, CC BY 4.0 라이선스에 따라 사용. 라이선스 보기

설정 노트

최신 사용 안내 및 문제 해결 글

기본 연결을 완료한 뒤 실제로 겪는 문제에 맞춰 설정 지식을 보충하세요. 노드, 모드, DNS를 한꺼번에 바꾸기보다 재현 가능한 비교 조건을 먼저 마련해야 원인을 더 명확히 찾을 수 있습니다.

모든 글 보기 →

증상에 맞는 문제 해결 방법

클라이언트가 실행 중인데 웹 페이지가 열리지 않으면 구독 유효성을 확인한 다음 수신 포트와 시스템 프록시를 점검하세요. 특정 앱만 문제가 있다면 시스템 프록시를 따르는지, 자체 DNS를 사용하는지, 다른 VPN이 트래픽을 처리하는지 비교하세요. 연결 페이지에 해당 요청이 없다면 규칙을 급히 수정하기보다 먼저 트래픽이 클라이언트로 들어오는 경로를 확인하세요.

처음부터 전체 설정 과정을 따라가려면 사용 안내를 읽고, 이미 연결할 수 있으며 정책 그룹과 규칙 순서를 알고 싶다면 시스템 안내를 확인하세요. 문제를 해결하는 동안 기존 설정을 보관하고 변경 사항과 결과를 단계별로 기록하세요. 네트워크가 복구된 뒤 불필요한 글로벌 프록시나 DNS 덮어쓰기가 남지 않도록 점검하세요.