Clash 클라이언트 · 설정 및 규칙

Clash 최신 버전 다운로드 모든 플랫폼 클라이언트와설정 가이드

mihomo 커널· GPL-3.0 오픈 소스

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기, 규칙 기반 라우팅, 프록시 설정을 완료하세요.

  • 오픈 소스
  • 중국어 문서
  • YAML 설정

CLIENTS / 플랫폼 선택

Clash 클라이언트 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 다음 클라이언트를 선택하세요. GUI는 설정을 관리하고 커널은 연결을 처리합니다. 설정 항목이 같아도 클라이언트마다 메뉴 위치는 다를 수 있습니다.

Windows

Clash Plus를 우선 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu의 인터페이스와 서비스 작동 방식도 비교해 보세요. 설치 전에 시스템 설정에서 프로세서 종류를 확인하세요. 설치 파일 아이콘만 보고 호환 여부를 판단하면 안 됩니다.

처음 연결할 때는 시스템 프록시부터 사용하세요. 브라우저 요청이 연결 기록에 표시되는지 확인한 뒤 필요에 따라 TUN을 활성화하면 됩니다. 기존 클라이언트를 교체할 때는 이전 프로그램을 종료하고 기존 프록시 설정도 해제해 포트 충돌이나 여러 서비스의 라우팅 설정 변경을 방지하세요. Clash for Windows는 더 이상 유지 관리되지 않으며, 보관된 다운로드는 기존 환경을 확인할 때 사용할 수 있습니다.

다운로드 Windows 클라이언트

macOS

Apple Silicon과 Intel용 설치 파일을 구분해 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 설정 관리 방식이 서로 다릅니다. 백그라운드 서비스가 필요한지는 시스템 프록시, TUN 권한, 부팅 시 자동 실행 여부를 고려해 판단하세요.

클라이언트를 응용 프로그램 폴더로 옮긴 뒤 처음 실행하고 시스템 권한을 승인하세요. 연결에 문제가 생기면 시스템 설정의 현재 네트워크 서비스에서 프록시 주소와 포트가 실행 중인 클라이언트와 일치하는지 먼저 확인하세요. Wi-Fi를 바꾼 뒤에도 다시 확인해야 합니다. 메뉴 막대 아이콘만으로 트래픽이 정상적으로 전달된다고 판단하지 마세요. ClashX Meta의 보관 상태는 다운로드 페이지에 별도로 표시되어 있습니다.

다운로드 macOS 클라이언트

Android

Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교해 보세요. 설치 파일의 아키텍처가 기기와 맞아야 합니다. 구독 형식도 먼저 확인하세요. 같은 프록시 클라이언트라고 해서 다른 형식의 설정을 Clash YAML로 바로 가져올 수 있는 것은 아닙니다.

처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다. 앱을 백그라운드로 전환하면 연결이 끊기는 경우 배터리 최적화와 백그라운드 실행 제한을 확인한 뒤 클라이언트 로그를 살펴보세요. 다른 VPN 앱이 실행 중이라면 먼저 트래픽을 어느 앱이 처리하는지 확인하세요. 두 앱을 계속 번갈아 전환하면 테스트 결과를 비교하기 어렵습니다.

다운로드 Android 클라이언트

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 전에 스토어의 시스템 요구 사항을 읽고, 가져오기 전에 구독 설정 형식이 클라이언트에서 지원되는지 확인하세요.

설정을 추가한 뒤 시스템 안내에 따라 VPN 구성을 허용하고, 클라이언트로 돌아가 사용할 구독과 아웃바운드를 선택하세요. Wi-Fi와 모바일 네트워크에서 각각 테스트해야 합니다. 한쪽 네트워크에서 문제가 발생하면 네트워크 환경, DNS 조회 결과, 연결 로그를 기록한 뒤 DNS 변경 여부를 판단하세요. 시스템에 VPN 표시가 나타나도 터널이 활성화됐다는 뜻일 뿐, 규칙 적용이나 대상 서비스 접속까지 확인된 것은 아닙니다.

다운로드 iOS 클라이언트

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식으로 설치할 수 있습니다. 서버와 라우터 사용자는 다운로드 페이지의 mihomo 커널 항목을 확인하세요. 서비스를 시작하기 전에 프로세서 아키텍처, 실행 권한, 설정 디렉터리를 먼저 확인해야 합니다.

데스크톱의 시스템 프록시가 명령줄 도구까지 적용되는 것은 아닙니다. 터미널 프로그램은 자체 프록시 옵션이나 환경 변수를 확인해야 하며, TUN을 사용할 때는 권한과 라우팅도 확인해야 합니다. 시스템 서비스로 배포한다면 설정 경로를 명확히 지정하고 읽을 수 있는 로그를 남기세요. 서비스 프로세스가 현재 터미널과 같은 작업 디렉터리나 사용자 권한을 사용한다고 가정하지 마세요.

다운로드 Linux 클라이언트

CONFIGURATION / 설정 기능

규칙, 트래픽 처리 및 설정 관리

모든 스위치를 한꺼번에 켜기보다 필요한 문제에 맞춰 설정하세요. 아래 예시는 필드 간 관계만 보여 주며 실제로 사용할 수 있는 프록시 서버는 포함하지 않습니다. 실제 설정에는 구독 정보나 아웃바운드 정보를 추가해야 합니다.

규칙 모드

mode: rule
rules:
  - DOMAIN-SUFFIX,example.org,PROXY
  - MATCH,DIRECT
규칙 매칭 → 아웃바운드

전역 모드

mode: global

GLOBAL
  → 선택한 아웃바운드
GLOBAL로 전달

직접 연결 모드

mode: direct

DIRECT
  → 대상 주소
직접 연결 대상

규칙 기반 라우팅

규칙 모드는 목록 순서에 따라 도메인, 주소 또는 규칙 집합을 매칭하고, 조건에 맞으면 지정된 아웃바운드로 전달합니다. 마지막 MATCH는 나머지 연결을 처리합니다. 프록시 경로를 임시로 비교하려면 전역 모드로 전환하고 GLOBAL에서 실제 아웃바운드가 선택됐는지 확인하세요. 직접 연결 모드는 로컬 네트워크와 비교할 때 사용하며 클라이언트를 끄는 것과는 다릅니다. 통합 프록시 주소만 제공하는 도구와 달리 Clash에서는 설정 파일에서 라우팅 기준을 확인할 수 있습니다. 문제를 진단할 때는 먼저 매칭된 규칙을 확인한 뒤 순서를 조정하세요. 아웃바운드 문제를 규칙 오류로 오해하지 않도록 주의해야 합니다.

연결 경로로 설정 이해하기

먼저 요청이 클라이언트에 들어오는지 확인한 다음 DNS 조회, 규칙 매칭, 아웃바운드 선택을 차례로 확인하세요. 설정 화면의 PROXY는 그룹 이름이며 설치 파일에 포함된 프록시 서비스가 아닙니다.

전체 문서 보기 →

QUICKSTART / 3단계 점검

구독 가져오기부터 연결 확인까지

처음 설정할 때는 검증 가능한 연결 경로 하나부터 구성하세요. 한 단계를 완료한 뒤 다음 단계로 넘어가면 오류가 구독 가져오기, 트래픽 처리, 아웃바운드 중 어느 단계에서 발생했는지 파악하기 쉽습니다.

  1. 설정 가져오기 및 활성화

    클라이언트의 구독 또는 설정 화면에서 링크를 추가하거나 로컬 YAML 파일을 가져오세요. 저장한 뒤 파싱 결과를 확인해 예상한 아웃바운드 그룹이 표시되는지 살펴보고, 해당 설정을 현재 사용 항목으로 지정하세요. 구독이 목록에 표시되는 것만으로 커널에 설정이 로드된 것은 아닙니다.

    가져오기에 실패하면 네트워크 요청 오류인지 설정 문법 오류인지 먼저 확인하세요. 웹페이지 형태의 안내 주소는 구독 데이터로 사용할 수 없으며, 필드 들여쓰기가 잘못됐다면 파일을 수정해야 합니다. 처음 사용할 때는 원본 설정 사본을 보관하세요. 사용자 지정 내용은 이후 원격 업데이트와 로컬 변경을 구분하기 쉽도록 클라이언트에서 지원하는 오버라이드 기능으로 추가하는 편이 좋습니다.

  2. 모드와 트래픽 처리 방식 선택

    일상적인 사용은 규칙 모드로 시작하고 실제 사용하는 선택 그룹에서 아웃바운드를 지정하세요. 데스크톱에서는 먼저 시스템 프록시를 켜고 수신 포트를 확인합니다. 모바일에서는 시스템 안내에 따라 VPN 연결을 허용하세요. 시스템 프록시를 따르지 않는 프로그램까지 처리해야 한다면 해당 플랫폼의 TUN 설정을 확인하세요.

    전역 모드는 이미 커널에 들어온 연결의 아웃바운드 선택 방식만 바꿉니다. 아직 트래픽이 처리되지 않는 프로그램을 자동으로 클라이언트에 연결하지는 않습니다. 모드를 바꾼 뒤 요청을 다시 보내 로그를 확인하세요. 차이를 검증하려면 대상 주소와 네트워크 환경을 그대로 유지하고 한 번에 변수 하나만 바꾸세요. 간헐적인 네트워크 변화를 설정 효과로 오해하지 않도록 주의해야 합니다.

  3. 매칭 규칙과 아웃바운드 결과 확인

    테스트할 주소를 열고 연결 기록에서 해당 도메인을 찾아 매칭된 규칙과 최종 아웃바운드를 확인하세요. 그런 다음 직접 연결될 것으로 예상되는 주소도 테스트해 규칙이 순서대로 적용되는지 살펴보세요. 앱과 브라우저를 각각 테스트하면 프록시 설정이 일부 프로그램에만 적용되는 문제를 찾을 수 있습니다.

    연결 기록이 없다면 시스템 프록시, 앱 설정 또는 TUN을 통한 트래픽 처리를 먼저 확인하세요. 기록은 있지만 연결에 실패했다면 DNS 조회, 아웃바운드 사용 가능 여부, 원격 서버 응답을 살펴보세요. 사용을 마칠 때는 먼저 클라이언트의 트래픽 처리 기능을 끈 다음 프로그램을 종료해야 시스템 프록시가 로컬 포트를 계속 가리키는 일을 방지할 수 있습니다. 전체 설정 절차와 복구 방법은 가이드에서 확인하세요.

SOURCE / 오픈 소스 생태계

Clash와 mihomo 프로젝트의 관계

클라이언트 이름, 커널 이름, 구독 서비스는 구분해서 이해해야 합니다. 기능 지원 여부는 소프트웨어 이름에 Clash가 포함됐는지만 볼 것이 아니라 프로젝트 문서, 실제 커널, 로컬 로그를 기준으로 판단하세요.

프로젝트 이력과 유지 관리 상태

Clash는 규칙 기반 프록시 커널로 시작해 설정 생태계를 형성했고, 이후 데스크톱과 모바일 운영체제용 GUI 클라이언트가 등장했습니다. 원래 Clash 프로젝트와 일부 초기 클라이언트는 더 이상 기존 방식으로 유지 관리되지 않습니다. 이름이 비슷한 최신 클라이언트도 유지 관리 상태는 서로 다를 수 있습니다. 예전 가이드의 버튼 위치, 서비스 설치 방법, 프로토콜 지원을 모든 새 클라이언트에 그대로 적용해서는 안 됩니다.

클라이언트를 선택할 때는 먼저 프로젝트에 최근 릴리스가 있는지 확인한 다음 시스템 요구 사항과 설정 지원 범위를 살펴보세요. 기존 환경에서 실행되던 프로그램도 새 구독 필드를 인식하지 못할 수 있습니다. 이전하기 전에 설정, 그룹 선택, 로컬 규칙을 보관하고 이전 후에는 연결을 다시 확인하세요. 프로그램이 실행되는 것만으로 이전이 완료됐다고 판단하면 안 됩니다.

커널과 인터페이스의 역할

mihomo는 Clash 생태계에서 계속 개발되는 커널 프로젝트로 설정을 파싱하고 규칙을 매칭하며 아웃바운드 연결을 만듭니다. GUI 클라이언트는 구독 목록, 시스템 프록시 스위치, 서비스 설치, 로그 화면을 관리합니다. 두 클라이언트가 같은 커널을 사용하면 핵심 설정 기능은 비슷할 수 있지만 로컬 오버라이드, 권한 처리, 시스템 통합 방식은 다를 수 있습니다.

따라서 인터페이스에 특정 스위치가 보이는지가 커널의 해당 필드 지원 여부를 바로 나타내지는 않습니다. 안내와 화면 내용이 다르면 클라이언트 정보에서 커널을 확인한 다음 관련 문서를 살펴보세요. 다운로드 페이지에서는 클라이언트를 선택하고, 전체 문서에서는 설치 절차와 커널 설정을 구분해 실제 환경에 맞는 내용을 확인할 수 있습니다.

오픈 소스 라이선스와 프로젝트 자료

mihomo는 GPL-3.0 라이선스를 사용하며 코드, 이슈 논의, 릴리스 노트는 프로젝트 저장소에서 확인할 수 있습니다. 라이선스는 해당 프로젝트에 적용되므로 모든 GUI 클라이언트, 구독 서비스, 추가 구성 요소도 같은 라이선스를 사용한다고 단정할 수는 없습니다. 소프트웨어를 배포하거나 수정하려면 해당 프로젝트의 라이선스 파일과 의존성 안내를 확인하세요.

소스 코드와 이슈 기록을 살펴보면 필드 동작, 플랫폼 제한, 알려진 문제를 확인하는 데 도움이 됩니다. 이 사이트는 검증되지 않은 다운로드 수, 사용자 평점, 연결 성능 통계를 표시하지 않습니다. 오픈 소스 코드는 구현을 직접 확인할 근거를 제공하지만 실제 네트워크 성능은 로컬 환경, 대상 서비스, 선택한 아웃바운드에 따라 달라집니다. 프로젝트의 인기도를 실제 테스트 대신 활용할 수는 없습니다.

업데이트 방식과 설정 백업

클라이언트 업데이트, 커널 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 시스템 서비스를 바꿀 수 있고, 커널 업데이트는 필드 지원과 연결 동작을 바꿀 수 있습니다. 구독 업데이트는 주로 서버, 규칙, 설정 내용을 갱신합니다. 문제가 생기면 어느 항목이 변경됐는지 먼저 기록한 뒤 설정을 복구할지 릴리스 노트를 확인할지 결정하세요.

업데이트 전에 로컬 오버라이드와 사용자 지정 규칙을 내보내고 포트와 트래픽 처리 방식을 기록하세요. 업데이트 후에는 설정을 불러올 수 있는지 확인한 다음 프록시 그룹 참조, DNS, 라우팅을 살펴보세요. 구독만 업데이트한 뒤 문제가 생겼다면 클라이언트를 바로 재설치하기보다 구독 내용을 먼저 비교하세요. 변경 사항을 항목별로 기록하면 같은 문제를 반복해서 진단하는 일을 줄일 수 있습니다.

구독 서비스와 로컬 설정의 구분

Clash 클라이언트를 설치해도 프록시 서버가 자동으로 제공되지는 않습니다. 사용할 아웃바운드는 직접 운영하는 서버나 기존 구독에서 제공되며, 클라이언트는 설정에 따라 연결을 처리할 뿐입니다. 구독에 포함된 주소, 접근 자격 증명, 계정 정보는 비공개로 보관하세요. 문제 해결 정보를 공유할 때는 오류 유형과 필요한 필드만 남기고 서비스 접속에 사용할 수 있는 내용은 삭제하세요. 전체 구독을 공개 저장소에 올리지 마세요.

이 페이지의 편집 화면은 필드 구조를 보여 주기 위한 예시입니다. 선택 그룹의 DIRECT는 직접 연결을 뜻하며 프록시 경로가 설정됐다는 의미는 아닙니다. 낯선 용어는 용어집에서 커널, 아웃바운드 그룹, 네트워크 모드 설명을 먼저 확인한 다음 클라이언트 비교에서 차이를 살펴보세요. 특정 플랫폼의 권한이나 서비스 문제는 전체 문서에서 운영체제별 안내를 확인할 수 있습니다.

mihomo 소스 코드 보기

아래 명령은 소스 코드와 문서를 살펴보기 위해 프로젝트 저장소를 복제합니다. 일반적인 설치라면 클라이언트를 선택하면 됩니다. 소스 코드를 빌드하려면 프로젝트 문서에 지정된 도구와 환경도 필요합니다.

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

NOTES / 최신 글

Clash 설치 및 문제 해결

실제 사용 환경을 바탕으로 설정 절차를 안내합니다. 문제 해결 글은 연결 경로를 따라가며 먼저 오류가 발생한 단계를 확인한 뒤 설정을 조정합니다. 변경 전후 테스트는 같은 네트워크와 대상 주소에서 진행하세요.

문제를 확인할 때는 연결 불가와 연결 속도 저하를 구분하세요. 연결할 수 없다면 요청이 커널에 들어왔는지 먼저 확인하고, 속도가 느리다면 동일한 조건에서 테스트해야 합니다. 설정 필드의 자세한 설명과 플랫폼별 복구 절차는 설정 관련 자주 묻는 질문에서 확인할 수 있습니다.