오픈 소스 클라이언트 · 플랫폼별 다운로드 및 설정 참고

Clash 공식 다운로드 및 설정 안내

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

데스크톱, 모바일, Linux 환경에 맞는 Clash 클라이언트를 한곳에서 찾고 구독 가져오기, 규칙 라우팅, 설정 파일 안내를 계속 확인하세요. 다운로드 페이지는 운영체제별 클라이언트를 정리하고, 가이드 페이지는 실제 활성화 순서에 따라 첫 연결 과정을 설명합니다.

영구 무료 오픈 소스 5개 플랫폼 지원 한국어 설정 문서

클라이언트 이름이 비슷해도 인터페이스, 코어 버전, 지원 시스템 아키텍처는 다를 수 있습니다. 먼저 플랫폼을 선택한 뒤 기기 아키텍처, 설치 방식과 유지 관리 상태를 확인해 설치 패키지를 결정하세요. 기존 설정이 있다면 설정 참고 자료에서 필요한 필드를 바로 찾고, 처음 사용하는 경우에는 시작 가이드부터 확인하는 것이 좋습니다.

PLATFORM DIRECTORY

운영체제별 다운로드 페이지로 이동

홈페이지는 기기를 해당 플랫폼 영역으로 안내하는 역할만 합니다. 자세한 클라이언트 모델, 유지 관리 상태, 시스템 아키텍처와 설치 패키지는 다운로드 페이지에 통합해 중복 링크 관리를 피했습니다. 기기 아키텍처가 확실하지 않다면 먼저 시스템 정보를 확인한 후 다운로드 페이지의 요구 사항 표와 대조하세요.

데스크톱

Windows

일반적인 Windows 10 및 Windows 11 데스크톱 환경에 적합합니다. 다운로드 전에 프로세서 아키텍처와 클라이언트 유지 관리 상태를 확인하세요. 설치 후에는 보통 구독을 가져오고 정책 그룹을 선택한 다음 시스템 프록시를 활성화해야 합니다. 시스템에 다른 프록시 프로그램이 있다면 먼저 포트 사용 여부를 확인하세요.

Windows 다운로드
데스크톱

macOS

Apple Silicon 및 Intel 프로세서 기기에 각각 맞는 패키지입니다. 처음 실행할 때 앱 실행 허용, 네트워크 확장, 시스템 프록시 또는 키체인 권한이 필요할 수 있습니다. 각 권한의 용도가 다르므로 클라이언트 안내와 시스템 설정 경로에 따라 하나씩 처리하고, 설정을 반복해서 삭제하지 마세요.

macOS 다운로드
모바일

Android

Android 클라이언트는 시스템의 로컬 VPN 인터페이스를 통해 트래픽을 처리합니다. 설치 패키지를 선택하기 전에 ARM 아키텍처를 확인하세요. 사용을 시작한 후에는 VPN 권한, 알림 권한, 배터리 절전 정책과 백그라운드 활동 제한도 점검해야 화면을 잠근 뒤 연결이 중단되는 문제를 피할 수 있습니다.

Android 다운로드
모바일

iOS

iPhone 및 iPad 사용자는 해당 플랫폼 영역에서 Clash Plus의 App Store 링크와 공식 웹사이트 정보를 확인할 수 있습니다. 설치가 완료되면 시스템에서 VPN 구성 추가를 요청합니다. 권한을 승인한 뒤 설정을 가져오고 정책을 선택해 연결을 시작하세요. 일상적인 노드 전환은 앱에서 진행할 수 있습니다.

iOS 다운로드
데스크톱 및 서버

Linux

데스크톱 사용자는 그래픽 인터페이스를 제공하는 클라이언트를 우선 확인하고, 서버·소프트웨어 라우터·컨테이너 환경에서는 보통 Mihomo 코어를 직접 사용합니다. 두 설치 방식의 설정 원리는 비슷하지만 서비스 관리, 파일 권한, DNS 처리와 부팅 시 시작 방식이 다르므로 절차를 섞어 사용하지 마세요.

Linux 다운로드
전체 클라이언트 및 시스템 요구 사항 보기 →

CONFIG LABEL

Clash 설정 기능 자료

Clash의 조작 화면은 클라이언트마다 다르지만 기본 설정은 대체로 규칙, 구독, 시스템 프록시와 오버라이드로 구성됩니다. 아래에서는 각 기능의 용도, 주요 진입 경로와 YAML 작성법을 설명합니다. 사용할 수 있는 필드는 현재 클라이언트가 채택한 코어를 기준으로 확인해야 합니다.

RULES

도메인, IP 및 기본 규칙으로 연결 출구 결정

규칙 라우팅은 “어떤 연결을 어느 정책 그룹으로 보낼지”를 결정합니다. Clash는 위에서부터 규칙을 확인하고 일치하는 순간 이후 규칙을 더 이상 검사하지 않습니다. 따라서 구체적인 도메인, 로컬 네트워크 주소와 특수 서비스 규칙은 앞에 두고, 범위가 넓은 규칙은 뒤에 배치하며, 기본 처리용 MATCH는 일반적으로 마지막에 둡니다. 전역 스위치만 제공하는 단순 프록시 도구와 달리 규칙 모드에서는 직접 연결, 프록시와 접근 거부를 함께 구성할 수 있습니다.

수정하기 전에 규칙에서 참조하는 정책 그룹 이름이 실제로 존재하는지 확인한 뒤 순서와 들여쓰기를 점검하세요. 범위가 넓은 규칙이 먼저 일치하면 뒤의 구체적인 규칙은 적용되지 않습니다. 문제를 확인할 때는 웹페이지가 열리는지만 보지 말고 연결 기록에서 어떤 규칙이 일치했는지 확인하세요.

규칙 문법 안내 보기 → 
rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

QUICK START

첫 연결을 위한 3단계

아래 단계는 설치 완료부터 연결 검증까지의 핵심 흐름만 정리한 것입니다. 클라이언트마다 버튼 위치는 다를 수 있지만 설정 읽기, 정책 선택, 시스템 연결과 결과 검증의 순서는 대체로 같습니다. 문제가 발생하면 현재 단계에서 멈추고 확인한 뒤 여러 설정을 동시에 변경하지 마세요.

  1. 설정을 가져오고 내용을 읽을 수 있는지 확인

    클라이언트의 설정, 구독 또는 Profiles 페이지를 열고 사용할 수 있는 구독 주소를 붙여 넣어 가져오기를 실행하세요. 가져온 뒤에는 저장 성공 메시지 하나만 표시되는 것이 아니라 설정 이름, 업데이트 시간과 프록시 그룹이 보여야 합니다. 노드가 전혀 표시되지 않으면 먼저 수동 업데이트를 실행하고 오류 메시지를 확인하세요. 주소 만료, 네트워크 연결 불가, 비정상 응답 형식과 코어 필드 비호환은 서로 다른 방법으로 처리해야 합니다.

    로컬 파일에서 가져올 때는 YAML의 기존 공백 들여쓰기를 유지하고 문장 부호나 탭을 자동으로 바꾸는 편집기로 수정하지 마세요. 설정에 포함된 노드 정보는 실제 연결 자료이므로 백업을 저장할 때 개인이 통제할 수 있는 위치를 사용하세요.

  2. 규칙 모드, 정책 그룹 및 사용 가능한 노드 선택

    설정을 불러온 뒤 실행 모드를 규칙 모드로 설정하고 프록시 그룹 페이지로 이동하세요. 수동 선택 그룹은 노드를 하나 지정해야 하며, 자동 선택 그룹은 먼저 지연 시간 테스트를 실행해야 합니다. 지연 시간 결과는 해당 시점에 테스트 주소에 연결할 수 있었는지만 보여줄 뿐 모든 웹사이트의 실제 연결 품질을 보장하지 않습니다. 테스트에 실패하면 구독 상태, 기기 시간, DNS와 현재 네트워크를 함께 확인해야 합니다.

    정책 그룹은 노드를 참조할 수도 있고 다른 정책 그룹을 다시 참조할 수도 있습니다. 화면에는 특정 그룹이 선택된 것으로 보이는데 연결이 잘못된 출구로 나간다면, 규칙이 실제로 어느 그룹과 일치했는지, 해당 그룹에서 최종적으로 어떤 구성원이 선택됐는지 확인하세요.

  3. 시스템 프록시를 활성화하고 요청 경로 검증

    코어가 실행 중인지 확인한 뒤 시스템 프록시를 활성화하거나 필요에 따라 TUN을 켜세요. 먼저 안정적인 사이트에 접속해 기본 연결을 확인하고, 클라이언트 연결 기록에서 요청이 나타났는지, 어떤 규칙과 일치했는지, 어떤 정책을 사용했는지 확인합니다. 브라우저 페이지만 관찰하면 캐시, 직접 연결과 프록시 결과를 구분하기 어렵지만 연결 기록은 더 직접적인 판단 근거를 제공합니다.

    검증을 마친 뒤 부팅 시 시작, 백그라운드 실행 또는 자동 업데이트를 설정하세요. 앱을 종료한 후 다른 소프트웨어가 갑자기 인터넷에 연결되지 않는다면 시스템 네트워크 설정으로 돌아가 프록시 주소가 이미 중지된 로컬 포트를 가리키고 있지 않은지 확인하세요.

전체 가이드 및 단계별 문제 해결 보기 →

OPEN SOURCE NOTES

오픈 소스 코어, 클라이언트와 업데이트 구분

Clash 관련 명칭은 코어, 그래픽 클라이언트와 설정 형식을 동시에 가리키는 경우가 많습니다. 세 요소의 관계를 이해하면 설치 패키지를 선택하고 기능의 출처를 판단하며, 필드 호환성 문제가 발생했을 때 올바른 확인 지점을 찾는 데 도움이 됩니다.

프로젝트 역사와 설정 방식

Clash는 YAML 기반의 프록시 노드, 정책 그룹과 규칙 설정 방식에서 출발했으며 이후 다양한 플랫폼용 그래픽 클라이언트가 등장했습니다. 사용자가 인터페이스에서 보는 설정, 프록시 그룹, 연결 기록과 시스템 프록시 스위치는 대부분 이 사용 방식을 중심으로 구성됩니다. 초기 프로젝트와 후속 포크는 유지 관리 상태가 다르므로 현재 클라이언트를 선택할 때는 이름만 보지 말고 실제로 사용하는 코어와 최근 유지 관리 현황도 확인해야 합니다.

오픈 소스 생태계의 역할 분담

그래픽 클라이언트는 설치 경험, 구독 관리, 트레이 메뉴, 시스템 권한과 설정 편집을 담당하고, 프록시 코어는 설정 읽기, 규칙 매칭, 연결 수립과 DNS·TUN 같은 네트워크 기능을 처리합니다. 서로 다른 클라이언트가 같은 코어를 사용할 수도 있고 시기에 따라 다른 버전을 사용할 수도 있으므로 동일한 YAML의 사용 가능한 필드가 항상 완전히 일치하는 것은 아닙니다. 문제를 해결할 때는 먼저 인터페이스 조작, 운영체제 권한과 코어 설정 중 무엇이 원인인지 구분하세요.

Mihomo 및 설정 호환성

Mihomo는 Clash Meta 계열에서 지속적으로 유지 관리되는 코어 구현으로, 프록시 프로토콜, 규칙 제공자, DNS와 트래픽 처리 기능을 확장했습니다. 현재 많은 클라이언트가 이를 하위 코어로 사용하지만, 클라이언트가 고급 필드를 감싸거나 숨기거나 자동으로 생성할 수 있습니다. 인터넷에서 찾은 전체 설정을 그대로 복사하기 전에 현재 코어의 지원 범위를 확인하고 필드를 하나씩 추가하세요. YAML 분석에 성공했다는 것은 문법이 올바르다는 뜻일 뿐, 정책 그룹 참조, DNS 업스트림과 규칙 순서가 실제 네트워크에 적합하다는 의미는 아닙니다.

업데이트 방식과 자료 확인

클라이언트 업데이트, 코어 업데이트와 구독 업데이트는 서로 다른 세 가지 경로입니다. 클라이언트 업데이트는 인터페이스와 시스템 통합 방식을 바꿀 수 있고, 코어 업데이트는 필드 동작에 변화를 줄 수 있으며, 구독 업데이트는 주로 노드, 정책 그룹과 규칙 내용을 교체합니다. 문제가 발생했을 때 어느 계층에서 변경이 일어났는지 기록하면 모든 내용을 동시에 되돌리는 것보다 원인을 찾기 쉽습니다. 이 사이트의 다운로드 페이지는 플랫폼별 진입 경로를, 설정 참고 자료는 필드를 설명하며, 실제 사용 가능 기능은 설치된 클라이언트와 코어 버전을 함께 기준으로 판단해야 합니다.

SELECTED QUESTIONS

자주 묻는 질문

아래 내용은 클라이언트 선택과 설정 후 기본적인 판단에 필요한 질문을 다룹니다. 설치, 사용과 문제 유형별 해결 방법은 문제 해결 페이지에서 더 자세히 확인할 수 있습니다.

Clash 클라이언트와 Mihomo 코어는 어떻게 다른가요?

클라이언트는 조작 가능한 그래픽 인터페이스, 구독 관리와 시스템 통합을 제공하고, Mihomo 코어는 설정을 해석하고 규칙을 매칭하며 연결을 처리합니다. 하나의 클라이언트가 코어를 포함해 실행 상태를 관리할 수 있지만 두 구성 요소의 업데이트 주기는 다를 수 있습니다. 다운로드 항목을 선택할 때는 보통 그래픽 클라이언트를 먼저 고르고, 서버와 라우터 사용자는 코어를 직접 배포하는 경우가 많습니다.

구독을 가져온 후 선택할 노드가 없는 이유는 무엇인가요?

먼저 구독 주소가 아직 유효한지 확인한 다음 수동으로 업데이트하고 반환된 오류를 확인하세요. 흔한 원인으로는 주소에 연결할 수 없음, 비정상적인 응답 형식, 만료된 구독, 현재 코어와 호환되지 않는 설정 필드 또는 프록시 제공자 파일 쓰기 실패가 있습니다. 단순히 가져오기를 반복하지 말고 오류 유형에 맞게 처리해야 합니다.

시스템 프록시를 활성화하면 모든 프로그램이 연결을 넘겨받나요?

아닙니다. 시스템 프록시는 주로 운영체제의 프록시 설정을 따르는 프로그램에 영향을 줍니다. 일부 게임, 명령줄 도구와 특수 네트워크 서비스는 자체 연결 경로를 우회할 수 있습니다. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN 모드를 고려할 수 있지만, 활성화 전에 시스템 권한, DNS 설정과 다른 네트워크 소프트웨어와의 충돌을 확인해야 합니다.

노드 지연 시간 테스트는 정상인데 웹페이지가 열리지 않으면 어떻게 해야 하나요?

지연 시간 테스트는 특정 테스트 주소와 해당 시점의 연결 결과만 확인합니다. 대상 요청과 일치한 규칙, 정책 그룹의 최종 구성원, DNS 해석, 기기 시스템 시간, 현재 네트워크 제한과 로컬 방화벽도 점검해야 합니다. 연결 기록을 열고 요청, 규칙, 정책 그룹과 노드 순서로 하나씩 확인하는 것이 좋습니다.

전체 문제 해결 보기 →

FIELD NOTES

최근 Clash 사용 가이드

플랫폼 설정, 고급 라우팅, 첫 연결과 문제 해결을 주제별로 정리했습니다. 각 글은 하나의 명확한 작업을 중심으로 구성되어 기본 설치 후 이어서 읽기 좋으며, 관련 현상이 발생했을 때 점검 순서에 따라 바로 진행할 수도 있습니다.

전체 글 보기 →