릴리스 채널 · 플랫폼 호환성 · 설정 단계

Clash 공식 다운로드
모든 플랫폼 클라이언트

공식 Clash 다운로드 가이드 보기

Windows, macOS, Android, iOS 및 Linux 클라이언트를 한곳에서 확인하고, 릴리스 상태에 따라 설치 경로를 선택한 뒤 중국어 설정 문서를 참고해 구독 가져오기, 규칙 분기, 시스템 프록시 및 TUN을 설정할 수 있습니다. 또한 원본 Clash, Clash Meta, mihomo의 관계를 설명해 기존 설정에 맞는 호환 클라이언트를 선택하도록 돕습니다.

영구 무료 오픈 소스 멀티플랫폼 클라이언트 YAML 설정 중국어 문서

PROTOCOL ROUTING

설정 경로 및 규칙 핵심

설정 파일에서 클라이언트로 들어온 요청은 수신 포트, DNS 해석, 규칙 매칭, 정책 그룹을 차례로 거칩니다. 아래 네 가지 항목은 일상적인 설정에서 가장 자주 확인하는 지점입니다.

PROFILE LAYER

설정 출처를 확인한 뒤 현재 Profile로 전환

설정 파일에는 프록시 수신 포트, 정책 그룹, 규칙, DNS 및 리스닝 매개변수가 정의됩니다. 원격 구독을 사용할 때는 보통 클라이언트가 구독 주소를 먼저 저장한 다음 로컬 Profile로 내려받습니다. 직접 편집한 YAML은 파일에서 바로 가져옵니다. 두 방식 모두 최종적으로 현재 설정을 만들지만, 이를 활성 상태로 명확히 지정해야 이후 규칙과 정책이 요청 처리에 적용됩니다.

일상적인 업데이트에서는 ‘구독 내용 업데이트’와 ‘현재 설정 전환’을 구분해야 합니다. 업데이트는 파일만 새로 고치고, 전환은 실제 실행 중인 설정을 변경합니다. 가져오기에 실패하면 먼저 YAML 들여쓰기, 필드 이름, 커널 호환 범위를 확인한 뒤 구독 주소에 접근할 수 있는지 점검하세요. 여러 설정은 사용 목적에 따라 이름을 정하고, 시작이 검증된 기본 설정을 하나 보관해 복잡한 규칙을 수정한 뒤 빠르게 되돌릴 수 있도록 하는 것이 좋습니다.

01 / SOURCE 원격 구독 또는 로컬 YAML 설정 출처를 읽고 Profile로 저장
02 / VALIDATE 구문 및 필드 해석 들여쓰기, 필드 형식, 커널 지원 범위 확인
03 / APPLY 현재 설정으로 지정 정책 그룹, 규칙 및 DNS 설정 다시 불러오기 
mixed-port: 7890
mode: rule
log-level: info

PLATFORM EXITS

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

클라이언트마다 비슷한 설정 개념을 공유하지만 설치 형식, 권한 요구 사항, 시스템 트래픽 처리 방식은 다릅니다. 다운로드 페이지에서 유지 관리 상태, 아키텍처, 사용 환경을 비교할 수 있습니다.

DESKTOP / X64

Windows

데스크톱에서 장시간 실행하기에 적합하며 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 등의 그래픽 클라이언트를 선택할 수 있습니다. 설치 전에 시스템 아키텍처를 확인하고, 처음 실행한 뒤 설정을 가져온 다음 시스템 프록시 스위치와 수신 포트를 점검하세요. 구버전 Clash for Windows는 보관 상태이므로 클라이언트를 바꾸기 전에 기존 설정을 백업해야 합니다.

다운로드 페이지로 이동

DESKTOP / ARM · X64

macOS

Apple Silicon과 Intel 모델은 각각 맞는 설치 파일을 선택해야 합니다. 시스템 프록시, 네트워크 확장 또는 TUN을 처음 활성화할 때 관리자 승인이 필요할 수 있습니다. 설치 후에는 먼저 Rule 모드로 기본 연결을 확인한 다음 시작 프로그램 등록, 메뉴 막대 제어, 라우팅 처리를 설정해 권한 문제와 설정 문제를 분리해서 확인하는 것이 좋습니다.

다운로드 페이지로 이동

MOBILE / APK

Android

Android 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 처리하므로 VPN 권한을 유지하고 시스템의 백그라운드 제한에 유의해야 합니다. 다운로드할 때 ARM64, ARM, 범용 설치 파일을 구분하세요. 최신 기기는 대체로 ARM64를 사용합니다. 설정을 가져온 뒤 정책과 실행 모드를 선택하고 배터리 최적화, 상시 알림, 다른 VPN 앱이 연결에 영향을 주는지 확인하세요.

다운로드 페이지로 이동

MOBILE / APP STORE

iOS

iPhone과 iPad에서는 App Store를 통해 Clash Plus를 받을 수 있습니다. 설치 후 시스템 네트워크 확장이 연결을 만들며, 설정 가져오기, 정책 선택, 규칙 확인은 모두 클라이언트 안에서 진행합니다. 네트워크를 바꾼 뒤 연결 상태가 달라지면 먼저 시스템 VPN 상태를 다시 확인하고 현재 설정과 정책 그룹을 살펴보세요. 상태 표시줄 아이콘만으로 요청 경로를 판단해서는 안 됩니다.

다운로드 페이지로 이동

DESKTOP / SERVER

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 사용할 수 있으며, 서버·라우터·컨테이너 환경에는 mihomo 커널을 직접 배포하는 방식이 더 적합합니다. 설치 파일을 선택할 때 배포판 형식과 CPU 아키텍처를 함께 확인하세요. 명령줄 배포는 설정 경로, 실행 권한, 서비스 시작 방식, 로그 위치를 직접 관리해야 하므로 시스템 네트워크에 익숙한 사용자에게 적합합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →

QUICK START

설치부터 규칙 적용까지

먼저 가장 짧은 설정 경로를 완성한 다음 TUN, 사용자 지정 DNS, 복잡한 규칙을 추가하세요. 단계마다 한 가지 요소만 바꾸면 오류 원인을 더 쉽게 찾을 수 있습니다.

  1. 01

    설치 및 첫 실행

    다운로드 페이지에서 현재 운영체제 패널로 이동해 유지 관리 중인 그래픽 클라이언트를 선택하고 시스템 아키텍처를 확인하세요. Windows는 일반적으로 x64, Apple Silicon은 ARM 아키텍처이며 Android는 ARM64, ARM, 범용 패키지를 구분해야 합니다. 설치가 끝나면 클라이언트를 정상적으로 실행해 화면이 열리고 커널이 로드되며 수신 포트 충돌이 없는지 확인하세요. 이 단계에서는 DNS, TUN, 사용자 지정 규칙을 동시에 수정할 필요가 없습니다.

    시스템에서 권한을 요청하면 기능에 맞게 처리하세요. 시스템 프록시는 일반 데스크톱 앱에 사용하고, 모바일 환경과 TUN은 보통 VPN 또는 네트워크 확장 권한이 필요합니다. 클라이언트가 시작 즉시 오류를 표시하면 오류 원문을 먼저 기록하고, 이전 클라이언트가 백그라운드에서 같은 포트를 사용하고 있지 않은지 확인하세요.

  2. 02

    설정 가져오기 및 모드 선택

    Profile 또는 설정 페이지에서 구독 주소를 추가하거나 로컬 YAML 파일을 가져옵니다. 설정 해석이 끝나면 대상 Profile을 현재 설정으로 지정하고 정책 그룹에서 선택 가능한 정책이 표시되는지 확인하세요. 첫 테스트에는 Rule 모드를 권장합니다. 규칙 분기 구조를 유지하면서 연결 로그에서 요청이 어떤 규칙과 매칭되었는지 확인하기 쉽기 때문입니다.

    구독 업데이트 성공은 파일이 새로 고쳐졌다는 뜻일 뿐, 실행 중인 설정이 전환되었다는 의미는 아닙니다. 화면에 여러 Profile이 남아 있다면 현재 표시, 업데이트 시간, 설정 이름을 다시 확인하세요. 수동 YAML을 불러오지 못하면 먼저 들여쓰기와 필드 형식을 점검하고, 현재 커널에서 지원하지 않는 구문을 사용했는지도 확인하세요.

  3. 03

    트래픽 처리 활성화 및 경로 검증

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, 모바일에서는 시스템 VPN 연결을 시작하세요. 그런 다음 자주 사용하는 웹사이트를 열고 클라이언트 연결 기록에서 도메인, 매칭된 규칙, 최종 정책을 확인합니다. 중요한 것은 페이지가 열리는지만이 아니라 요청이 클라이언트로 들어왔는지, 규칙이 예상대로 매칭되었는지, 정책 그룹이 올바른 출구를 선택했는지입니다.

    일반 트래픽 검증을 마친 뒤 앱 범위에 따라 TUN 활성화 여부를 결정하세요. 활성화 후 LAN 기기, 개발 환경, 다른 네트워크 도구에 문제가 생기면 라우팅 제외 항목, DNS 처리, 인터페이스 우선순위를 확인합니다. 한 번에 한 항목만 조정하고 다시 테스트하면 문제 해결 경로를 명확하게 유지할 수 있습니다.

전체 가이드 보기 →

OPEN SOURCE RECORD

커널 출처 및 배포 관계

클라이언트를 장기간 사용하기에 적합한지 판단하려면 그래픽 인터페이스, 프록시 커널, 설정 호환성, 설치 파일 릴리스 기록을 나누어 확인해야 합니다.

A / HISTORY

원본 Clash에서 지속적으로 관리되는 커널 분기까지

원본 Clash는 규칙 매칭, 정책 그룹, 설정 파일, 제어 인터페이스와 같은 핵심 개념을 정립했습니다. 원 프로젝트가 업데이트를 중단한 뒤에도 클라이언트 생태계는 하나의 유지 관리 경로를 따르지 않았습니다. 일부 구형 클라이언트는 보관 상태가 되었고, 일부 그래픽 클라이언트는 새로운 커널과 시스템 인터페이스를 계속 지원하고 있습니다. 가이드를 읽을 때는 내용이 원본 Clash, Clash Meta, mihomo 중 어느 대상을 기준으로 하는지 먼저 확인해 새 필드를 구형 커널에 넣는 일을 피하세요.

B / ECOSYSTEM

그래픽 클라이언트와 커널은 별도의 유지 관리 계층입니다

Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트는 주로 설정 관리, 시스템 프록시 제어, 로그 확인, 플랫폼별 설치 환경을 담당합니다. mihomo는 규칙 해석, 프로토콜 지원, DNS, TUN, 연결 처리를 담당합니다. 클라이언트 이름이 비슷하다고 해서 릴리스 주기, 플랫폼 권한, 기능 위치가 완전히 같은 것은 아닙니다. 따라서 다운로드 페이지에서는 플랫폼별 선택지를 나누어 제공하고 보관된 프로젝트도 별도로 표시합니다.

C / COMPATIBILITY

설정 호환성은 실제 커널 해석 결과를 기준으로 판단해야 합니다

일반적인 포트, 프록시 그룹, 기본 규칙은 호환성이 높은 편이지만 향상된 DNS, TUN, 규칙 집합, 스크립트 확장, 새 프로토콜 필드는 버전에 따라 지원 범위가 다를 수 있습니다. 설정을 옮길 때는 먼저 기본 부분을 성공적으로 불러온 뒤 고급 설정을 조금씩 추가하세요. 클라이언트에 가져오기 성공이 표시되어도 커널 로그를 확인해 필드가 실제로 인식되었는지 검증해야 합니다. 단순히 화면에 저장된 것만으로는 충분하지 않습니다.

D / RELEASE

업데이트 판단 기준은 릴리스 목록과 유지 관리 상태입니다

설치 파일入口는 플랫폼, 아키텍처, 클라이언트 프로젝트별로 구성되어 있습니다. 업데이트할 때는 먼저 해당 프로젝트의 릴리스 안내를 읽고 설정 마이그레이션, 시스템 권한 변경, 커널 업그레이드 여부를 판단하세요. 일상적인 사용에서 모든 릴리스를 따라갈 필요는 없습니다. 시스템 트래픽 처리, DNS, 규칙 동작에 영향을 주는 업데이트라면 설정을 백업하고 되돌릴 수 있는 설치 파일을 보관한 뒤 별도의 시간을 내어 검증하는 것이 좋습니다.

ROUTINE CHECKS

자주 묻는 질문

아래 질문은 처음 설정할 때 가장 혼동하기 쉬운 네 가지 지점을 다룹니다. 전체 작업 순서와 화면 위치는 사용 문서에서 이어서 확인할 수 있습니다.

설정을 가져왔는데 규칙이 적용되지 않는 이유는 무엇인가요?

먼저 가져온 Profile이 현재 설정으로 지정되었는지 확인하고 실행 모드가 Rule인지 점검하세요. 그런 다음 시스템 프록시 또는 모바일 VPN을 활성화하고 연결 기록에서 요청이 클라이언트로 들어오는지 확인합니다. 파일만 가져오고 현재 설정으로 전환하지 않으면 규칙은 실제 실행 경로에 적용되지 않습니다. 전체 확인 순서는 설정 가져오기 단계에서 확인하세요.

시스템 프록시와 TUN 중 무엇을 먼저 활성화해야 하나요?

데스크톱에서는 먼저 시스템 프록시를 활성화해 브라우저와 자주 사용하는 앱이 규칙에 따라 연결되는지 확인하는 것이 좋습니다. 시스템 프록시를 읽지 않는 프로그램이 실제로 있을 때 TUN을 설정하세요. 이렇게 하면 포트·설정·규칙 문제와 가상 인터페이스·라우팅·권한 문제를 나누어 처리할 수 있어 여러 설정을 동시에 변경할 때 생기는 혼란을 줄일 수 있습니다.

구독을 업데이트했는데 정책 그룹 내용이 바뀌지 않는 이유는 무엇인가요?

구독 업데이트 시간과 현재 Profile이 같은 항목인지 확인하세요. 일부 클라이언트는 파일을 업데이트한 뒤에도 기존 실행 설정을 유지하므로 다시 적용하거나 한 번 전환해야 합니다. 그래도 내용이 바뀌지 않으면 구독 응답이 완전한지, 설정 해석 오류가 없는지, 정책 그룹이 참조하는 프록시 이름이 업데이트된 항목과 일치하는지 확인하세요.

Clash 클라이언트를 바꿀 때 어떤 항목을 옮길 수 있나요?

구독 주소, 기본 YAML, 규칙, 정책 그룹은 일반적으로 마이그레이션의 출발점으로 사용할 수 있습니다. 클라이언트별 화면 설정, 자동 시작, 시스템 프록시 제어, 백업 형식은 다를 수 있습니다. 이전하기 전에 기존 설정을 저장하고 새 클라이언트에서 기본 규칙을 먼저 검증한 뒤 TUN, DNS, 스크립트 확장을 처리하세요. 구체적인 플랫폼 선택은 클라이언트 다운로드 페이지에서 확인할 수 있습니다.

FIELD NOTES

설정 및 문제 해결 문서

포트 충돌, DNS 경로, Profile 관리에 관한 구체적인 절차를 정리했습니다. 각 문서는 증상, 확인 명령, 설정 위치, 검증 결과를 중심으로 설명합니다.

문제 해결

Clash 포트가 사용 중일 때 해결 방법: 프로세스 확인 및 수신 포트 변경

오류 증상 확인부터 시스템 포트 조회와 설정 변경까지, mixed-port·HTTP·SOCKS 수신 충돌을 단계별로 해결하고 변경 후 함께 확인해야 할 시스템 프록시 설정도 설명합니다.

전문 읽기 →
개인정보 및 보안

Clash DNS 유출 검사 및 방지 설정: 테스트 결과부터 규칙 수정까지

검사 페이지에서 나타날 수 있는 차이를 설명하고 DNS 모드, 업스트림 서버, 브라우저 설정, 시스템 캐시의 네 가지 측면에서 도메인 요청의 실제 경로를 점검합니다.

전문 읽기 →
시작 가이드

Clash Profile 설정 파일 입문: 가져오기, 전환, 다중 설정 관리

설정 출처, 구독 업데이트, 현재 Profile, 실행 커널 사이의 관계를 정리하고 일상적인 사용에 적합한 다중 설정의 이름 지정, 전환, 되돌리기 방법을 안내합니다.

전문 읽기 →
전체 문서 보기 →