오픈 소스 코어 · 모든 플랫폼 클라이언트 가이드

Clash 간체 중국어 리소스 사이트: 클라이언트 다운로드 및 설정 가이드

Clash 클라이언트 다운로드, 모든 플랫폼의 설치와 설정, 라우팅 규칙 및 문제 해결을 한곳에 정리했습니다. 운영체제에 맞는 유지 관리 중인 그래픽 클라이언트를 선택한 뒤 가이드에 따라 구독 가져오기, 프록시 그룹 선택, 시스템 프록시 또는 TUN 연결을 완료하세요.

영구 무료 오픈 소스 한국어 문서 라우팅 규칙
ROUTING WORKFLOW

Clash 라우팅 규칙 및 트래픽 연결

연결은 규칙 매칭으로 시작해 프록시 그룹에서 출구를 선택한 다음, 시스템 프록시 또는 TUN을 통해 애플리케이션 트래픽을 로컬 코어로 전달합니다. 아래에서는 실제 처리 순서에 따라 각 단계의 역할, 적합한 상황과 설정 경로를 설명합니다.

RULE ROUTER

규칙 매칭: 도메인, 주소와 프로세스를 순서대로 판단

Clash는 설정 파일의 규칙 섹션을 위에서 아래로 검사합니다. 도메인 규칙, GeoSite, GeoIP, IP 대역 및 프로세스 규칙으로 요청 유형을 구분할 수 있으며, 처음 일치한 규칙이 연결을 넘길 프록시 그룹을 결정합니다. 앞선 규칙에 일치하지 않은 연결은 보통 MATCH가 처리합니다. 따라서 규칙은 개수보다 순서가 중요합니다. 구체적인 규칙을 포괄적인 규칙보다 앞에 배치해야 의도치 않은 조기 일치를 피할 수 있습니다.

직접 연결, 프록시와 차단을 구분해야 하는 일상적인 설정에 적합합니다. 구독을 가져온 뒤 현재 설정에 완전한 규칙 섹션이 포함되어 있는지 확인하고, 클라이언트의 연결 기록에서 일치한 항목을 검토하세요. 특정 웹사이트가 잘못된 출구를 사용한다면 글로벌 모드로 바로 전환하기보다 규칙 순서, 도메인 유형과 참조된 프록시 그룹 이름을 먼저 확인해야 합니다.

CLIENT ENTRANCE

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

홈에서는 플랫폼별 진입점만 제공하며, 구체적인 클라이언트와 유지 관리 상태, 시스템 요구 사항 및 설치 패키지 유형은 다운로드 페이지에 정리했습니다. 이동하기 전에 운영체제 버전과 프로세서 아키텍처를 확인하세요. macOS용 Apple Silicon 패키지를 Intel 기기에 사용하거나 데스크톱 파일을 모바일 기기에 사용하는 실수를 피할 수 있습니다.

WINDOWS

Windows

일반적인 데스크톱 사용에 적합하며 Clash Plus, Clash Verge Rev, FlClash와 기타 그래픽 클라이언트를 비교할 수 있습니다. 다운로드 전 시스템 비트 수를 확인하고, 설치 후 구독을 가져와 시스템 프록시를 활성화하세요.

다운로드 페이지로 이동
MACOS

macOS

Apple Silicon과 Intel 모델별 진입점을 제공합니다. 처음 실행할 때 시스템 보안 경고를 처리해야 하며, 선택한 클라이언트에 따라 시스템 프록시 또는 TUN에 필요한 권한을 허용해야 합니다.

다운로드 페이지로 이동
ANDROID

Android

기기 아키텍처에 맞는 설치 패키지를 선택할 수 있습니다. 설치 후에는 보통 Android VPN 인터페이스로 트래픽을 처리하며, 첫 연결 때 시스템 권한 승인 창이 나타납니다. 구독 업데이트와 백그라운드 실행 권한도 별도로 확인해야 합니다.

다운로드 페이지로 이동
IOS

iOS

App Store에서 Clash Plus를 설치한 뒤 앱에서 구독 또는 설정을 추가하세요. 처음 연결할 때 시스템 안내에 따라 VPN 구성 추가를 허용하면, 이후 앱에서 프록시 그룹을 전환하고 구독을 업데이트할 수 있습니다.

다운로드 페이지로 이동
LINUX

Linux

데스크톱 사용자는 그래픽 클라이언트를 선택할 수 있으며, 서버·소프트 라우터·자동화 환경에는 Mihomo 코어를 직접 사용하는 방식이 더 적합합니다. 배포 전에 서비스 권한, 설정 경로와 로그 확인 방법을 명확히 정해야 합니다.

다운로드 페이지로 이동
QUICK START

Clash 사용법 3단계 미리 보기

전체 과정은 다운로드 후 스위치만 켜면 끝나지 않습니다. 먼저 클라이언트가 시스템과 호환되는지 확인하고, 신뢰할 수 있는 설정을 가져온 뒤 프록시 모드를 선택하고 연결 기록으로 실제 일치 결과를 검증해야 합니다.

  1. 01

    클라이언트 설치 및 로컬 코어 실행 확인

    다운로드 페이지에서 해당 플랫폼을 선택하고, 현재 시스템 아키텍처에 맞는 유지 관리 중인 클라이언트를 우선 사용하세요. 설치가 끝나면 기본 화면을 열어 포트 충돌, 권한 부족 또는 코어 실행 실패 메시지가 없는지 확인합니다. macOS에서는 보안 권한 승인을, Windows에서 TUN을 사용할 때는 관리자 권한을 확인해야 하며 모바일에서는 VPN 구성 권한을 요청합니다.

  2. 02

    구독 또는 로컬 YAML 설정 가져오기

    설정 또는 구독 페이지에 서비스 제공자가 발급한 구독 주소를 붙여 넣거나 로컬 YAML 파일을 가져오세요. 업데이트가 완료되면 프록시 노드, 프록시 그룹과 규칙이 모두 표시되는지 확인합니다. 노드만 있고 규칙이 없다면 클라이언트가 용도별 라우팅을 수행하지 못할 수 있습니다. 구독 주소는 민감한 설정이므로 공개 페이지에 게시하거나 화면 캡처에 포함해서는 안 됩니다.

  3. 03

    프록시 그룹 선택, 연결 활성화 및 규칙 확인

    처음에는 규칙 모드를 유지하고 주요 프록시 그룹에서 사용 가능한 출구를 선택한 다음 시스템 프록시를 활성화하는 것이 좋습니다. 연결 기록을 열어 자주 사용하는 사이트에 접속하고 요청이 예상한 규칙과 프록시 그룹에 일치하는지 확인하세요. 일반 프록시가 정상임을 확인한 뒤 필요에 따라 TUN, 시작 시 자동 실행과 백그라운드 실행을 활성화하면 문제 발생 시 원인을 더 쉽게 찾을 수 있습니다.

OPEN SOURCE ECOSYSTEM

Clash 오픈 소스 생태계, 코어와 클라이언트의 관계

Clash는 단일 설치 패키지의 이름이 아니라 규칙 기반 프록시 코어, 유지 관리 분기, 그래픽 클라이언트와 설정 데이터로 구성된 생태계입니다. 각 계층을 이해해야 다운로드 대상, 업데이트 출처와 문제 해결 범위를 올바르게 판단할 수 있습니다.

PROJECT HISTORY

프로젝트 관계: 원본 Clash와 후속 유지 관리 분기

원본 Clash 프로젝트는 YAML 설정, 프록시 노드, 프록시 그룹과 규칙 목록을 기반으로 하는 핵심 사용 방식을 정립했습니다. 생태계가 발전하면서 Mihomo가 코어 기능을 계승하고 확장했으며, 현재 유지 관리되는 많은 데스크톱·모바일 클라이언트가 Mihomo를 하위 구성 요소로 사용합니다. 사용자가 다운로드하는 것은 보통 인터페이스가 포함된 클라이언트이지 코어 파일 자체가 아닙니다. 서버와 라우터 환경에서만 코어를 직접 실행하는 경우가 많습니다.

CLIENT LAYER

그래픽 클라이언트: 설치, 구독과 시스템 통합 담당

Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트는 인터페이스와 플랫폼 통합 방식이 서로 다르지만 기본 흐름은 비슷합니다. 설정 파일을 관리하고, 코어를 실행하며, 프록시 그룹을 표시하고, 시스템 프록시를 변경하고, 연결 및 로그를 읽습니다. 이름이 비슷하다고 설치 패키지를 플랫폼 간에 공용으로 사용할 수 있는 것은 아니며 유지 관리 상태도 같지 않습니다. 따라서 다운로드 페이지에서 플랫폼, 아키텍처와 유지 관리 중단 여부를 구분해 표시합니다.

CONFIG DATA

설정과 데이터: 구독, 규칙과 지리 데이터베이스는 서로 독립적

구독은 보통 노드와 설정을 제공하고, 규칙은 연결 라우팅을 결정하며, GeoIP와 GeoSite 같은 데이터는 지리 또는 도메인 분류 규칙의 매칭 근거가 됩니다. 세 요소의 업데이트 주기는 서로 다를 수 있습니다. 특정 도메인 분류가 잘못되었다면 원인이 클라이언트에만 있는 것은 아닙니다. 구독 업데이트 여부, 규칙 세트 참조의 유효성, 데이터베이스 로드 여부와 프록시 그룹 이름이 규칙과 일치하는지를 각각 확인해야 합니다.

UPDATE PATH

업데이트 방식: 클라이언트, 코어와 설정을 따로 점검

클라이언트 버전 업데이트는 주로 인터페이스, 시스템 통합과 패키징 문제를 수정하고, 코어 업데이트는 프로토콜, DNS, 규칙 실행과 네트워크 스택에 영향을 줍니다. 구독 업데이트는 노드와 설정 내용을 바꿉니다. 문제 해결 중 이 세 가지 업데이트를 혼동하면 효과 없는 작업을 반복하기 쉽습니다. 먼저 현재 클라이언트와 시스템 환경을 기록하고 로그의 명확한 오류를 확인한 뒤, 문제와 관련된 계층만 업데이트하고 수정 후 규칙 일치 결과를 다시 검증하세요.

QUICK DIAGNOSIS

Clash 자주 묻는 질문 모음

먼저 다운로드, 설정, 연결과 규칙 문제를 증상별로 구분한 뒤 자주 묻는 질문 페이지에서 전체 점검 경로를 확인하세요. 문제가 발생한 단계를 확인하기 전에 포트, DNS, 규칙과 프록시 그룹을 한꺼번에 수정하지 마세요.

Clash 클라이언트는 어떻게 선택해야 하나요?

먼저 운영체제로 필터링한 다음 유지 관리 상태, 프로세서 아키텍처와 필요한 기능을 확인하세요. 그래픽 인터페이스를 원하는 일반 사용자는 Mihomo 코어를 별도로 다운로드할 필요가 없습니다. 서버나 라우터에 배포할 때는 코어 패키지와 서비스 관리 방식을 중점적으로 비교하면 됩니다. 구체적인 차이는 클라이언트 비교에서 확인할 수 있습니다.

구독 가져오기는 성공했는데 왜 연결되지 않나요?

가져오기에 성공했다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐입니다. 코어 실행 여부, 프록시 그룹에서 사용 가능한 출구를 선택했는지, 시스템 프록시 또는 TUN이 활성화되었는지, 로컬 수신 포트가 충돌하지 않는지와 현재 요청이 어떤 규칙에 일치했는지를 추가로 확인해야 합니다. 연결 확인 단계에 따라 하나씩 점검하세요.

시스템 프록시와 TUN 모드를 동시에 켜야 하나요?

대부분의 경우 먼저 시스템 프록시만 사용하면 됩니다. 시스템 프록시를 따르지 않는 앱을 실제로 연결해야 할 때만 TUN을 활성화하세요. 두 기능의 연동 방식은 클라이언트마다 다를 수 있으므로 활성화 후 라우팅, DNS와 가상 네트워크 어댑터 상태를 확인하고 다른 VPN이나 네트워크 관리 소프트웨어와 중복 연결되지 않도록 해야 합니다.

규칙 모드, 글로벌 모드와 직접 연결 모드는 어떻게 다른가요?

규칙 모드는 설정에 따라 연결을 하나씩 판단하므로 일상적인 사용에 적합합니다. 글로벌 모드는 모든 연결을 하나의 프록시 그룹으로 보내 단시간 출구를 테스트할 때 사용하고, 직접 연결 모드는 프록시를 우회합니다. 특정 웹사이트만 문제가 있다면 먼저 규칙 일치 결과를 확인해야 하며, 설정 문제를 가리기 위해 글로벌 모드를 장기간 사용하는 것은 권장하지 않습니다. 자세한 내용은 자주 묻는 질문을 참고하세요.

TECHNICAL NOTES

Clash 설정 및 문제 해결 기술 노트

다음 글에서는 프로젝트 관계, YAML 설정 구조와 기존 클라이언트 마이그레이션을 다룹니다. 기본 설치를 마치고 코어 의존성과 설정 유지 관리 방식을 더 깊이 이해하려는 사용자에게 적합합니다.

Clash 오픈 소스 생태계의 프로젝트 관계: 코어, 클라이언트와 유지 관리 분기 구분하기

Clash, Mihomo와 주요 그래픽 클라이언트의 역할, 의존 관계와 선택 기준을 정리하고 일반 사용자가 클라이언트를 다운로드해야 하는지 코어를 따로 사용해야 하는지 설명합니다.

전체 글 읽기 →

Clash 설정 파일 구조 해설: 포트와 DNS부터 규칙 섹션까지

YAML 계층에 따라 자주 사용하는 필드를 나누어 살펴보고, 프록시 노드·프록시 그룹·DNS·규칙 사이의 참조 관계와 설정을 수동으로 수정할 때 발생하기 쉬운 들여쓰기 문제를 설명합니다.

전체 글 읽기 →

Clash 클라이언트 지원 종료 후 마이그레이션: 설정 보존과 대체 소프트웨어 선택

기존 클라이언트를 이전하기 전 필요한 준비와 구독·로컬 설정을 옮기는 방법을 소개하고, 운영체제별 대체 클라이언트 선택 및 설정 재확인 순서를 설명합니다.

전체 글 읽기 →
Clash 다운로드