오픈소스 프로젝트 · 모든 플랫폼 클라이언트 지속 유지보수

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

모든 플랫폼 클라이언트, 구독 가져오기 단계규칙 라우팅 설정을 한곳에서 확인하세요. 다운로드하기 전에 기기 운영체제에 맞는 그래픽 클라이언트를 선택하고, 설치 후 설정 가져오기, 프록시 그룹 선택, 시스템 프록시 확인을 순서대로 진행하세요.

영구 무료 오픈소스 한국어 문서 mihomo 커널 생태계
  • 개요
  • 프록시
  • 규칙
  • 연결
  • 로그
  • 설정 파일
  • 설정
프록시 그룹 노드 선택 자동 선택 글로벌 직접 연결 DIRECT REJECT
시스템 프록시
TUN 모드
LAN 연결 허용
IPv6
시작 시 자동 실행
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

핵심 설정 기능

규칙 라우팅, TUN 모드 및 구독 관리

세 기능은 Clash를 일상적으로 사용할 때 가장 자주 거치는 설정 경로를 보여줍니다. 먼저 트래픽이 규칙과 어떻게 매칭되는지 이해하고, TUN 처리가 필요한지 판단한 다음 안정적인 설정 업데이트 절차를 마련하세요.

mode: rule

매칭 순서에 따라 각 연결 처리

규칙 모드는 설정 파일의 규칙 목록을 읽고 위에서부터 도메인, IP, 프로세스 또는 규칙 집합을 매칭합니다. 규칙에 매칭되면 연결은 지정된 정책 그룹으로 전달되고, 매칭되지 않은 요청은 최종적으로 MATCH가 처리합니다. 규칙 순서가 결과를 직접 결정하므로 더 구체적인 도메인 규칙은 앞에, 범위가 넓은 지역 규칙과 기본 규칙은 뒤에 배치하는 것이 일반적입니다.

실제 설정에서는 자주 사용하는 서비스를 별도의 정책 그룹으로 나누어 브라우저, 개발 도구 및 로컬 서비스가 서로 다른 출구를 사용하도록 할 수 있습니다. 규칙을 수정한 뒤에는 먼저 설정을 다시 불러오고, 연결 기록에서 매칭된 규칙 이름을 확인하세요. 전역 스위치만 제공하는 프록시 도구와 달리 Clash는 연결 결정을 설정 파일에 기록할 수 있어 재사용, 검토 및 기기 간 이전이 편리합니다.

유형매칭 내용정책
DOMAIN-SUFFIXexample.com노드 선택
DOMAIN-KEYWORDservice자동 선택
GEOIPCNDIRECT
MATCH나머지 연결노드 선택

플랫폼 입구

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

그래픽 클라이언트는 설정 가져오기, 프록시 그룹 전환, 로그 확인 및 시스템 통합 기능을 제공합니다. 서버와 라우터 환경에서는 다운로드 센터에서 mihomo 커널 패키지를 확인할 수 있습니다.

Windows

트레이 제어, 시스템 프록시, TUN 모드 및 시작 시 자동 실행이 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 및 보관된 클라이언트를 확인하고 설치 패키지의 차이를 살펴볼 수 있습니다.

다운로드 페이지로 이동

macOS

Intel 및 Apple Silicon 데스크톱 기기에 적합합니다. 다운로드 페이지에서 먼저 프로세서 아키텍처를 확인한 뒤 알맞은 설치 패키지를 선택하세요. 처음 실행할 때는 시스템 안내에 따라 네트워크 확장, 프록시 설정 또는 백그라운드 서비스 권한을 허용해야 할 수 있습니다.

다운로드 페이지로 이동

Android

스마트폰, 태블릿 및 일부 Android TV 기기에 적합합니다. 클라이언트는 시스템 VPN 인터페이스로 연결을 처리하며, 처음 활성화할 때 연결 승인 화면이 나타납니다. 백그라운드 실행을 위해 배터리 최적화와 상시 알림 설정을 조정해야 할 수도 있습니다.

다운로드 페이지로 이동

iOS

iPhone 및 iPad 사용자는 App Store에서 Clash Plus를 받을 수 있습니다. 설치 후 구독을 가져오고 시스템이 VPN 구성을 추가하도록 허용하세요. 연결 상태, 필요 시 적용되는 규칙 및 설정 업데이트는 모두 클라이언트에서 관리합니다.

다운로드 페이지로 이동
Linux

Linux

데스크톱 배포판은 Clash Verge Rev 또는 FlClash를 선택할 수 있으며, 서버와 라우터 사용자는 아키텍처에 맞는 mihomo 커널을 다운로드할 수 있습니다. 그래픽 클라이언트를 사용하기 전에 데스크톱 환경, 트레이 지원 및 패키지 형식을 확인하세요.

다운로드 페이지로 이동

빠른 시작

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

처음 설정할 때 모든 옵션을 한꺼번에 수정할 필요는 없습니다. 다운로드가 끝나면 가져오기, 선택, 확인의 세 단계로 진행해 먼저 작동하는 연결을 만든 다음 사용 환경에 맞춰 라우팅과 TUN 설정을 조정하세요. 이렇게 하면 여러 변수가 동시에 바뀌어 문제를 추적하기 어려워지는 상황을 줄일 수 있습니다.

전체 사용 안내 보기 →
  1. 01

    구독 또는 설정 파일 가져오기

    클라이언트의 설정, 구독 또는 Profiles 페이지를 열고 전체 구독 링크를 붙여 넣어 가져오기를 실행하세요. 로컬 YAML 파일을 사용하는 경우 파일에서 로드를 선택합니다. 가져오기가 완료되면 목록에 설정이 표시되는지 확인하고 현재 설정으로 전환하세요. 구독에 실패해도 클라이언트를 반복해서 재설치하지 말고, 먼저 링크에 불필요한 공백이 없는지, 시스템 시간이 정확한지, 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요.

  2. 02

    모드 및 프록시 그룹 선택

    일반적인 사용에서는 규칙 모드를 우선 선택해 설정 파일이 어떤 연결을 직접 연결하고 어떤 연결을 프록시로 보낼지 결정하게 하세요. 그런 다음 프록시 페이지의 ‘노드 선택’과 같은 정책 그룹에서 사용할 노드를 지정합니다. 자동 선택 그룹은 설정에 따라 상태 확인을 수행하지만, 패널의 테스트 결과는 특정 테스트 주소의 응답 과정만 반영하며 다운로드 속도나 모든 웹사이트의 실제 사용 경험과 같지는 않습니다.

  3. 03

    프록시 활성화 및 매칭 기록 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, 모바일에서는 시스템 VPN 승인을 확인한 뒤 프록시가 필요한 사이트에 접속하세요. 연결 페이지에 해당 요청이 표시되고 매칭된 규칙과 정책 그룹이 나타나야 합니다. 브라우저는 정상인데 터미널 프로그램이 연결되지 않을 때 TUN 모드 활성화를 고려하세요. 모든 앱이 연결되지 않는다면 설정 상태, 프록시 그룹 선택 및 시스템 시간을 차례로 다시 확인하세요.

프로젝트 및 설정 출처

Clash 오픈소스 생태계와 mihomo 커널

커널, 그래픽 클라이언트 및 설정 서비스는 서로 다른 계층에 속합니다. 이 관계를 이해하면 업데이트 출처, 호환 범위 및 문제가 발생한 위치를 판단하는 데 도움이 됩니다.

Clash 커널에서 커뮤니티 포크까지

Clash는 처음에 규칙 기반 프록시 커널로 시작해 설정 문법과 정책 그룹 모델을 형성했습니다. 원본 프로젝트의 업데이트가 중단된 뒤 커뮤니티는 호환 포크를 계속 유지했고, 그중 mihomo는 일반적인 설정 구조를 이어받으면서 네트워크 스택, 규칙 집합, DNS 및 프로토콜 지원을 확장했습니다. 현재 널리 사용되는 데스크톱 및 모바일 클라이언트는 대개 그래픽 인터페이스, 시스템 권한, 구독 관리 및 업데이트 진입점을 담당하며, 실제 연결 처리는 통합된 커널이 수행합니다.

따라서 ‘Clash 클라이언트’는 하나의 고정된 인터페이스만을 뜻하지 않습니다. Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu, ClashX Meta 등의 프로젝트는 각각 창 조작, 트레이 메뉴 및 플랫폼 통합을 처리하고, mihomo는 하위 실행 구성 요소에 가깝습니다. 클라이언트를 선택할 때는 먼저 운영체제와 프로세서 아키텍처를 확인한 다음 TUN, 오버라이드 규칙, 설정 병합 또는 LAN 공유가 필요한지 살펴보세요.

설정 파일이 연결 동작을 결정합니다

구독 제공자는 일반적으로 노드, 정책 그룹 및 규칙을 생성하고, 클라이언트는 원격 콘텐츠를 설정 파일로 저장해 커널에 전달합니다. 시스템 프록시는 프록시 설정을 지원하는 앱의 연결을 로컬 포트로 넘기는 역할만 하며, TUN 모드는 가상 인터페이스를 통해 더 많은 프로그램의 트래픽을 처리합니다. 규칙 모드는 각 요청이 어느 정책 그룹으로 갈지도 결정합니다. 어느 한 계층의 설정이라도 일치하지 않으면 ‘클라이언트는 연결됐지만 접속할 수 없음’으로 나타날 수 있습니다.

문제를 해결할 때는 계층별로 확인해야 합니다. 먼저 설정이 정상적으로 로드되는지 확인하고, 프록시 그룹에서 사용할 수 있는 출구가 선택되었는지 확인한 다음 시스템 프록시 또는 TUN이 적용되는지 점검하고, 마지막으로 연결 기록에서 규칙 매칭 결과를 확인하세요. 모든 옵션을 한 번에 전환하면 변수만 늘어납니다. 로그의 오류 유형, 요청 대상 및 정책 이름이 단순히 스위치 상태를 관찰하는 것보다 훨씬 유용한 판단 근거가 됩니다.

커널 업데이트

커널 업데이트는 주로 프로토콜 구현, 규칙 처리, DNS 동작 및 네트워크 스택 호환성과 관련됩니다. 그래픽 클라이언트가 새 커널을 채택할지는 각 클라이언트 유지보수자가 결정하므로, 같은 설정을 읽더라도 클라이언트마다 지원 필드와 기본 동작이 다를 수 있습니다. 업데이트하기 전에 클라이언트 릴리스 안내를 읽고 현재 정상 작동하는 설정을 보관하세요.

클라이언트 업데이트

클라이언트 업데이트는 일반적으로 시스템 권한, 창 인터페이스, 구독 작업, 트레이 상호작용 및 커널 통합을 처리합니다. 데스크톱 시스템을 업그레이드한 뒤 프록시 서비스가 시작되지 않거나 권한 안내가 반복되거나 트레이 아이콘이 사라진다면 노드 설정을 바로 수정하기보다 먼저 클라이언트 호환성을 확인하세요. 유지보수가 중단된 클라이언트는 과거 환경을 참고하는 용도로만 적합합니다.

구독 업데이트

구독 업데이트는 원격 설정 출처가 제어하며 노드, 정책 그룹 및 규칙이 변경될 수 있습니다. 업데이트 후 기존 정책 이름이 사라졌다면 기본 그룹과 수동 선택 항목을 다시 확인하세요. 개인 규칙은 로컬 오버라이드나 별도 설정으로 관리해 원격 업데이트가 임시 변경 사항을 덮어쓰지 않도록 하는 것이 좋습니다. 구독 링크 자체도 민감한 접근 정보로 취급해 보관해야 합니다.

최신 글

Clash 설정 원리와 사용 방법

글 모음에서는 커널과 클라이언트의 관계, 네트워크 테스트 원리 및 여러 기기에서의 설정 방법을 다룹니다. 기본 연결을 완료한 뒤 이어서 읽기에 적합합니다.

오픈소스 생태

Clash 오픈소스 생태계 총정리: mihomo, Clash Verge, ClashX 및 각 포크 프로젝트의 관계

원본 Clash 커널에서 mihomo, Verge, ClashX, Nyanpasu 등의 그래픽 클라이언트로 이어지는 흐름을 살펴보고 커널과 인터페이스의 유지보수 경계를 구분합니다. 플랫폼과 기능에 따른 선택 기준도 함께 제시합니다.

전체 글 읽기
네트워크 심화

Clash 노드 지연 시간 테스트 원리: 패널의 밀리초 수치가 실제 속도와 다른 이유

테스트 주소, DNS, TCP 및 HTTP 요청 경로를 분석하고 지연 시간이 낮은 노드에서도 끊김이 발생하는 이유를 설명합니다. 안정성, 대역폭 및 대상 사이트의 응답을 함께 고려해 노드를 평가하는 방법도 다룹니다.

전체 글 읽기
멀티 플랫폼

여러 기기에서 하나의 Clash 설정 사용하기: 구독, 동기화 및 백업 방법

통합 구독 업데이트, 설정 파일 동기화 및 자체 설정 호스팅의 세 가지 경로를 비교하고 데스크톱과 모바일 간 필드 차이, 설정 충돌 및 민감한 링크 보관 방법을 설명합니다.

전체 글 읽기