오픈 소스 생태계 · 모든 플랫폼 설정 문서

Clash 문서 센터
클라이언트 다운로드 및 설정 가이드

Clash 다운로드 가이드 보기

클라이언트 선택부터 연결 완료까지 구독 가져오기, 규칙 분기, TUN 모드의 실제 설정 방법을 한곳에서 확인하세요.

영구 무료
오픈 소스
멀티 플랫폼 클라이언트
한국어 설정 가이드

미국 일본 홍콩 싱가포르 한국

구독 가져오기 ×

구독 링크

https://example.com/profile 붙여넣기

업데이트 간격

24시간마다 ⌄

자동 업데이트

시작 시 업데이트

프록시 모드

규칙 전역 직접 연결

설정 형식을 읽을 수 있음 저장 후 업데이트

규칙 분기
TUN 모드
구독 변환

시스템별 선택

Clash 클라이언트 플랫폼 안내

클라이언트마다 인터페이스와 커널 통합 방식이 다릅니다. 먼저 현재 기기에 맞는 다운로드 페이지로 이동한 뒤 유지 관리 상태, 시스템 아키텍처와 사용 방식에 따라 소프트웨어를 선택하세요.

Windows

데스크톱에서 일상적으로 사용하기 좋으며 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu를 선택할 수 있습니다. 유지 관리가 중단된 클라이언트의 마이그레이션 안내도 확인할 수 있습니다. 다운로드 전 시스템 아키텍처를 확인하고, 설치 후에는 보통 구독 메뉴에서 설정을 시작합니다.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel 기기를 모두 지원합니다. 시스템 프록시나 TUN을 처음 활성화할 때는 시스템 안내에 따라 네트워크 확장 관련 권한을 허용하세요.

다운로드 페이지로 이동

Android

휴대폰과 태블릿에 적합합니다. 구독을 가져온 뒤 시스템 VPN 권한을 확인하고, 앱별 프록시와 백그라운드 실행 제한은 기기 설정에서 조정하세요.

다운로드 페이지로 이동

iOS

App Store에서 Clash Plus를 받으세요. 설치 후 시스템이 VPN 구성을 생성하면 클라이언트에서 구독을 추가하고 규칙 모드를 선택합니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 그래픽 클라이언트를 선택할 수 있고, 서버·소프트 라우터·컨테이너 환경에서는 mihomo 커널을 직접 실행하는 경우가 많습니다. 두 방식 모두 같은 계열의 YAML 설정을 사용하지만 서비스 관리, 권한과 로그 위치는 다르므로 다운로드 페이지에서 각각의 진입점을 안내합니다.

다운로드 페이지로 이동

모든 클라이언트 보기 →

설정 흐름

구독, 모드 및 규칙 분기

실행 가능한 기본 설정부터 시작해 시스템 트래픽 가로채기, 규칙 관리와 구독 업데이트를 단계적으로 진행하세요. 아래 패널은 클라이언트에서 가장 자주 볼 수 있는 실제 설정 항목을 보여 줍니다.

기본 설정

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

구독 링크는 프록시 노드, 정책 그룹과 규칙 설정을 한곳에서 가져오는 데 사용됩니다. 가져오기 전에 링크가 본인이 이용하는 서비스 제공업체에서 발급된 것인지 확인한 다음 전체 주소를 클라이언트의 구독 또는 설정 메뉴에 붙여넣으세요. 저장 후 직접 한 번 업데이트하여 설정 이름, 정책 그룹과 규칙 페이지가 정상적으로 표시되는지 확인합니다. 업데이트 간격은 너무 짧게 설정할 필요가 없으며 일상적인 사용에는 하루 단위면 충분합니다. 업데이트에 실패하면 링크 만료 여부, 시스템 시간의 정확성, 현재 네트워크에서 구독 주소에 직접 접속할 수 있는지를 먼저 확인하세요.

처음 가져온 후 수동으로 한 번 업데이트하여 설정을 정상적으로 해석할 수 있는지 확인하세요.
업데이트에 문제가 생겼을 때 되돌릴 수 있도록 사용할 수 있는 이전 설정을 하나 보관하세요.
여러 기기에서 같은 링크를 사용할 경우 각 기기의 업데이트 시간을 따로 확인하세요.

구독 설정

설정 이름일상 규칙

자동 업데이트

업데이트 간격24시간

설정 저장

트래픽 결정

규칙 순서와 정책 그룹

Clash 규칙은 일반적으로 위에서 아래 순서로 매칭됩니다. 요청이 적용 가능한 첫 번째 규칙과 일치하면 해당 정책 그룹으로 전달되므로, 더 구체적인 도메인이나 프로세스 규칙을 포괄적인 규칙보다 앞에 배치해야 합니다. 정책 그룹은 여러 프록시, 자동 선택 또는 직접 연결 동작 중에서 다시 선택하도록 하며 규칙 자체가 노드를 의미하지는 않습니다. 설정을 수정할 때는 먼저 매칭 대상이 무엇인지 분명히 한 다음 대상 정책 그룹이 실제로 존재하는지 확인하고, 마지막으로 연결 기록에서 매칭 결과를 살펴보세요. 웹페이지의 겉모습만으로 규칙 적용 여부를 판단하지 않는 것이 좋습니다.

구체적인 규칙을 일반 규칙보다 앞에 배치하세요.
규칙에서 참조하는 정책 그룹 이름은 설정과 일치해야 합니다.
연결 기록에서 도메인, 규칙과 최종 정책을 대조하세요.

규칙 예시 DOMAIN-SUFFIX,example.com,Proxy DOMAIN,local.example,DIRECT GEOIP,CN,DIRECT MATCH,Proxy

규칙은 순서대로 매칭됩니다

오픈 소스 생태계

Clash, Meta와 mihomo의 관계

커널, 클라이언트와 설정 파일의 역할을 이해하면 인터페이스 문제, 규칙 문제와 네트워크 문제를 뒤섞어 처리하는 일을 피할 수 있습니다.

프로젝트 발전 과정

Clash 원본 커널은 규칙 매칭, 정책 그룹과 YAML 설정 등 현재 널리 쓰이는 방식을 정립했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤 커뮤니티 포크가 프로토콜 확장, TUN 구현, 규칙 유형과 데이터 관리 등의 작업을 이어받았습니다. 현재 그래픽 클라이언트를 다운로드할 때는 mihomo 커널이 내장된 선택지가 많은 편이지만, 클라이언트마다 업데이트 주기, 인터페이스 구조와 시스템 통합 방식은 여전히 다릅니다.

클라이언트와 커널

그래픽 클라이언트는 구독 관리, 시스템 프록시 전환, 정책 선택, 로그 확인과 데스크톱 통합을 담당하고, 커널은 설정을 읽고 연결을 수립하며 규칙을 실행하고 DNS를 처리합니다. 인터페이스가 열렸다고 해서 커널이 실행 중이라는 뜻은 아니며, 구독이 업데이트된다고 해서 시스템 트래픽이 가로채진다는 뜻도 아닙니다. 문제를 해결할 때는 설정 로드, 커널 상태, 시스템 프록시와 실제 연결 기록을 각각 확인해야 합니다.

설정 호환성

기본적인 주요 필드는 여러 Clash 생태계 클라이언트에서 상당히 비슷하지만, mihomo 확장 프로토콜·규칙 유형·DNS 필드는 구형 커널에서 인식되지 않을 수 있습니다. 클라이언트를 옮길 때 전체 설정을 복사한 뒤 바로 호환된다고 가정해서는 안 됩니다. 먼저 구독을 가져오고, 직접 관리하는 규칙·오버라이드·DNS 설정을 별도로 옮긴 다음 시작 로그의 필드 안내를 확인하는 편이 안전합니다.

업데이트 및 유지 관리

클라이언트 업데이트, 커널 업데이트, 구독 업데이트와 규칙 데이터 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 주로 인터페이스와 시스템 통합을 바꾸고, 커널 업데이트는 프로토콜과 설정 기능에 영향을 주며, 구독 업데이트는 서비스 제공업체가 생성하고, 규칙 데이터는 별도로 다운로드될 수 있습니다. 업데이트에 실패하면 먼저 무엇이 실패했는지 확인한 뒤 네트워크, 권한, 설정 경로 또는 상위 서비스 상태를 점검하면 더 빠르게 해결할 수 있습니다.

mihomo 오픈 소스 저장소 복제 git clone https://github.com/MetaCubeX/mihomo.git

빠른 문제 해결