오픈 소스 코어 · 모든 플랫폼의 그래픽 클라이언트

Clash 중문 커뮤니티클라이언트 다운로드 및설정 가이드

기기에 맞는 클라이언트를 선택하고 구독 가져오기, 규칙 기반 라우팅, TUN 설정을 확인하세요.

중국어 설정 안내mihomo 코어 참고클라이언트 선택

설정 항목과 조작 경로

Clash 설정의 네 단계

그래픽 인터페이스에서 설정을 관리하고, 코어가 설정에 따라 연결을 처리합니다. 처음에는 설정을 하나 불러와 정상적으로 적용되는지 확인한 뒤 모드, 규칙, 트래픽 처리 방식을 조정하세요. 한 번에 한 항목씩 바꾸면 문제가 생겼을 때 원인을 찾기 쉽습니다.

먼저 구독 가져오기 안내를 확인하세요. 호환되는 설정 주소를 준비해 가져온 뒤, 파싱 오류가 없는지 확인하고 실제로 사용할 수 있는 아웃바운드를 선택하세요.

구독 가져오기
및 설정 업데이트

구독 주소는 보통 설정이나 노드 정보를 가져오는 데 사용하며, 클라이언트 설치 파일과는 다릅니다. 클라이언트의 설정 관리 화면에서 서비스 제공자가 안내한 주소를 붙여 넣고 다운로드한 뒤 현재 설정으로 지정하세요. 먼저 파싱 오류가 있는지 확인하고, 정책 그룹에서 선택할 수 있는 아웃바운드가 있는지도 살펴보세요. 클라이언트마다 지원하는 구독 형식이 다르므로 링크 모양만 보고 호환 여부를 판단할 수 없습니다. 원격 설정을 업데이트하면 수동 변경 사항이 덮어써질 수 있으니, 계속 유지할 규칙은 클라이언트에서 지원하는 오버라이드나 병합 기능에 넣으세요. 구독 링크에 접근 자격 증명이 포함될 수 있으므로 로그나 스크린샷을 공유하기 전에 전체 주소를 가리세요.

관련 가이드 보기 →
config.yaml · 설정 진입점
mixed-port: 7890mode: ruleallow-lan: falselog-level: info

규칙 모드
및 정책 그룹 선택

규칙, 전역, 직접 연결 모드는 연결이 어떤 아웃바운드를 사용할지 정하며, 모든 앱의 트래픽을 자동으로 클라이언트에 보내지는 않습니다. 일반적인 트래픽 분기에는 규칙 모드를 선택한 다음 정책 그룹에서 아웃바운드를 지정하세요. 전역 모드는 잠깐 비교 테스트할 때 유용하지만 시스템 프록시나 앱 설정 문제를 해결하는 방법은 아닙니다. 직접 연결 모드에서는 코어에 전달된 연결이 대상에 바로 접속합니다. 모드를 바꾼 뒤에는 새 연결을 만들어 결과를 확인하세요. 기존의 장시간 연결은 경로가 바로 바뀌지 않을 수 있습니다. 정책 그룹 이름은 설정 작성자가 정하므로 예시의 PROXY는 고정 예약어가 아닙니다. 참조하는 이름이 실제 설정과 다르면 불러오기에 실패할 수 있습니다.

관련 가이드 보기 →
config.yaml · 아웃바운드 정책
mode: ruleproxy-groups:  - name: PROXY    type: select    proxies: [DIRECT]

사용자 지정 규칙
및 매칭 순서

규칙은 위에서 아래로 검사하며, 먼저 일치한 항목이 연결에 적용할 정책을 결정합니다. 특정 사이트에 예외를 추가할 때는 구체적인 도메인 규칙을 포괄적인 규칙보다 앞에 두고 대상 정책이 실제로 있는지 확인하세요. DOMAIN-SUFFIX는 도메인과 하위 도메인에 적용되고, MATCH는 보통 마지막 기본 규칙으로 사용됩니다. 페이지가 열리지 않는다는 이유만으로 규칙을 계속 추가하지 마세요. 먼저 연결 기록에서 대상, 적용된 규칙, 아웃바운드를 확인한 뒤 도메인 조회 문제인지 출구 문제인지 구분하세요. 원격 구독과 로컬 변경 사항을 함께 쓴다면 업데이트 시 병합, 앞에 추가, 교체 중 어떤 방식이 적용되는지도 확인해야 예외 규칙이 사라지거나 순서가 바뀌는 일을 막을 수 있습니다.

관련 가이드 보기 →
config.yaml · rules
rules:  - DOMAIN-SUFFIX,github.com,PROXY  - IP-CIDR,192.168.0.0/16,DIRECT  - MATCH,PROXY

시스템 프록시
및 TUN 트래픽 처리

시스템 프록시는 시스템 프록시 설정을 따르는 앱에서 사용됩니다. 일부 명령줄 도구와 게임은 별도로 설정해야 합니다. TUN은 가상 네트워크 인터페이스를 통해 해당 트래픽을 처리하며, 서비스 권한과 라우팅, DNS 설정이 필요할 수 있습니다. 처음 연결할 때는 시스템 프록시로 브라우저 연결을 먼저 확인한 뒤 앱의 요구에 따라 TUN을 활성화하세요. 처음부터 네트워크 옵션을 모두 바꿀 필요는 없습니다. 활성화 후 로컬 기기에 접속할 수 없거나 이름 해석에 문제가 생기면 새로 켠 기능을 끄고 비교한 다음 다른 가상 네트워크 인터페이스나 프록시 서비스와 충돌하는지 확인하세요. 시작 시 자동 실행은 클라이언트를 실행할 뿐입니다. 설정 자동 불러오기와 프록시 스위치 복원 여부는 각각 설정에서 확인해야 합니다.

관련 가이드 보기 →
config.yaml · 가상 네트워크 인터페이스
tun:  enable: true  stack: mixed  auto-route: true  auto-detect-interface: true

기기에 맞는 설치 파일 찾기

Clash 클라이언트 다운로드

운영체제를 선택한 다음 프로세서 아키텍처와 시스템 요구 사항을 확인하세요. 데스크톱과 모바일 설치 파일은 서로 바꿔 쓸 수 없으며, 같은 설정도 코어에 따라 지원 여부가 다를 수 있습니다. 다운로드 센터에서 플랫폼별 클라이언트, 유지 관리 상태와 설치 안내를 확인할 수 있습니다. 일반적인 데스크톱 사용자는 그래픽 클라이언트부터 시작하면 되며, 명령줄 코어를 따로 설치할 필요는 없습니다.

Windows

먼저 Clash Plus를 확인하고, 인터페이스 취향에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. Clash for Windows 대체 클라이언트를 찾는다면 설정을 백업하고 기존 클라이언트의 시스템 프록시와 자동 실행을 끄세요. 포트 충돌을 방지할 수 있습니다. TUN을 처음 사용할 때는 안내에 따라 서비스를 설치하고, 네트워크 트래픽을 처리하는 클라이언트를 여러 개 동시에 실행하지 마세요.

다운로드 페이지로 이동

macOS

먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인한 뒤 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash 중에서 고를 수 있으며, 구버전 ClashX Meta는 기존 사용자를 위해 보관 자료로 제공합니다. 시스템 프록시가 켜져 있는데도 앱이 연결되지 않으면 네트워크 서비스와 앱 자체의 프록시 설정을 먼저 확인하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android, FlClash, Surfboard의 설정 호환 범위를 확인하세요. 최신 스마트폰은 대부분 ARM64를 사용하지만 기기 정보로 확인하는 것이 좋습니다. 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 모든 연결 끊김을 노드 탓으로 돌리지는 마세요.

다운로드 페이지로 이동

iOS

다운로드 센터에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 앱 안내에 따라 설정을 추가하고 VPN 권한을 허용하세요. 데스크톱 클라이언트의 기능 이름이 모바일 화면에도 그대로 적용되는 것은 아닙니다. 가져오기 전에 구독 형식을 확인하고, Wi-Fi와 모바일 데이터에서 각각 네트워크 전환 후 연결 상태를 테스트하세요.

다운로드 페이지로 이동

Linux

그래픽 데스크톱 클라이언트는 Clash Verge Rev 또는 FlClash를 먼저 확인하고 배포판에 맞는 패키지 형식을 선택하세요. 서버, 라우터, 데스크톱 환경이 없는 기기에서는 mihomo 코어 안내를 참고하세요. 설치 전 아키텍처, 서비스 권한, 데스크톱 의존성을 확인하세요. 터미널 도구에는 프록시 환경 변수가 필요할 수도 있으며, 데스크톱 시스템 프록시 설정이 이미 실행 중인 터미널 세션에 전달되지 않을 수 있습니다.

다운로드 페이지로 이동

프로젝트 출처 및 참고 자료

Clash, Meta, mihomo의 관계

Clash는 프록시 코어와 그 설정 생태계를 가리키는 이름이지, 특정 그래픽 인터페이스를 통칭하는 말이 아닙니다. 소프트웨어 이름만 비교하기보다 클라이언트와 코어의 역할을 이해하는 편이 유용합니다. 이 사이트는 다운로드 경로와 중국어 안내를 정리하며 각 클라이언트 개발팀과는 관계가 없습니다. 구체적인 기능은 선택한 프로젝트의 문서와 실제 빌드를 기준으로 확인하세요.

원본 설정 생태계에서 커뮤니티 코어까지

원본 Clash는 널리 쓰이는 설정 항목, 정책 그룹, 규칙 사용 방식의 기반을 마련했습니다. 이후 커뮤니티 프로젝트는 서로 다른 방향으로 기능을 확장했고, Clash.Meta는 그중 중요한 흐름 중 하나입니다. 후속 프로젝트는 mihomo라는 이름으로 개발을 이어가고 있습니다. 오래된 문서의 Meta와 새 문서의 mihomo는 대체로 같은 기술 계보를 가리키지만, 모든 예전 설정이 완전히 호환된다는 뜻은 아닙니다. 가이드를 볼 때는 문서에서 다루는 코어와 클라이언트가 실제로 사용하는 코어를 함께 확인하세요.

프로토콜 유형, DNS 옵션, 규칙 기능은 코어가 발전하면서 달라질 수 있습니다. 한 클라이언트에서 작동하는 설정이라고 해서 다른 클라이언트도 같은 항목을 지원하는 것은 아닙니다. 가져오기 오류가 나면 오류가 발생한 항목과 코어 이름을 기록한 뒤 관련 문서를 확인하세요. 구독 변환 방식을 계속 바꾸는 것보다 문제를 찾기 쉽습니다. 프로토콜 선택과 호환성은 프로토콜 가이드에서 확인할 수 있습니다.

그래픽 클라이언트와 코어는 따로 업데이트됩니다

그래픽 클라이언트는 구독 관리, 정책 그룹 선택, 로그 화면과 시스템 연동을 제공하고, 코어는 설정을 해석해 연결을 만들고 규칙을 적용합니다. 클라이언트에 코어가 내장되어 있을 수도 있고, 코어 업데이트 옵션을 제공할 수도 있습니다. 인터페이스에 버튼이 추가되어도 모든 코어가 해당 기능을 지원하는 것은 아닙니다. 코어에 새 설정 항목이 추가되어도 인터페이스에 해당 스위치가 바로 생기지는 않을 수 있습니다. 문제를 해결할 때 두 계층을 구분해 기록하면 상황을 더 정확히 파악할 수 있습니다.

업데이트하기 전에 프로젝트 릴리스 정보를 읽고 시스템 요구 사항, 설정 이전, 권한 변경 사항을 확인하세요. 사용 가능한 설정을 하나 보관한 뒤 업데이트하고 연결을 테스트하세요. 유지 관리가 중단된 클라이언트는 오래된 가이드를 이해하는 데 참고할 수 있지만 새로운 기능의 기준으로 삼아서는 안 됩니다. 비교 페이지에서는 인터페이스, 플랫폼, 일상적인 관리 방식의 차이를 다루고 다운로드 페이지에서는 설치 경로를 안내합니다. 클라이언트 선택과 설치 작업을 한 번에 섞지 마세요.

mihomo 소스 코드 및 문서 보기

프로젝트 저장소에서 소스 코드, 릴리스 기록, 이슈 논의를 확인할 수 있습니다. 아래 명령은 저장소를 로컬에 복제할 뿐, 클라이언트를 설치하거나 시스템 프록시를 변경하지 않습니다. 일반 사용자는 소스 코드를 빌드할 필요가 없습니다. 설정 항목의 동작을 확인해야 한다면 프로젝트 문서와 기존 논의부터 살펴보세요.

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

연결 기록으로 문제 원인 찾기

지연 시간 테스트에 결과가 나왔다는 것은 해당 테스트 요청이 한 번 완료됐다는 뜻일 뿐, 실제 앱의 접속 여부를 보장하지 않습니다. 문제를 확인할 때는 먼저 대상 앱의 연결이 기록에 나타나는지 살펴보세요. 기록이 없다면 프록시 진입점을 우선 확인합니다. 기록은 있지만 정책이 맞지 않으면 모드와 규칙 순서를 확인하세요. 정책이 맞는데도 실패한다면 DNS, 아웃바운드, 대상 서비스를 점검하세요. 로그에는 도메인, 구독 주소, 계정 정보가 포함될 수 있으므로 공개적으로 도움을 요청하기 전에 필요한 부분만 남기고 민감한 정보는 가리세요.

‘Clash 무료 노드’는 클라이언트에 기본으로 들어 있는 기능이 아닙니다. 클라이언트, 설정 파일, 연결 서비스는 각각 별개의 요소이며 소프트웨어를 설치해도 사용할 수 있는 아웃바운드가 자동으로 생기지는 않습니다. 출처가 불분명한 설정은 가져오기 전에 제공자와 용도를 확인하세요. 한 번의 지연 시간 테스트만으로 장기간 사용할지 결정하지 마세요. 기본 용어는 용어 빠른 안내에서, 구체적인 연결 문제는 자주 묻는 질문의 단계별 안내에서 확인할 수 있습니다.

커뮤니티 글

클라이언트 선택 및 설정 기록

기본 연결을 설정한 뒤 실제 필요에 따라 고급 내용을 살펴보세요. 각 글은 확인할 수 있는 설정과 조작을 중심으로 구성했습니다. 먼저 적용 상황을 설명한 다음 함께 변경해야 하는 항목을 안내합니다. 프록시 공유, 서비스 권한, 시스템 네트워크 설정을 다룰 때는 기존 설정을 보관하고 정상 작동을 확인한 뒤 계속 사용하세요.