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

Clash 릴리스 허브: 모든 플랫폼 클라이언트 및 설정 안내

공식 Clash 다운로드 시작하기

플랫폼에 맞는 클라이언트를 찾은 뒤 구독 가져오기, 규칙 기반 분기, TUN 모드부터 설정하세요. 다운로드 경로와 기본 개념, 문제 해결 절차를 한곳에 정리해 처음 설치할 때와 나중에 다시 확인할 때 편리합니다.

영구 무료 오픈 소스 코드 중국어 문서 규칙 및 구독 안내

프록시 관리 방식

분산된 설정에서 통합 클라이언트로

프록시 도구의 어려움은 보통 설치 파일 자체보다 설정, 모드, 시스템 연동과 문제 해결 정보가 여러 곳에 흩어져 있다는 데 있습니다. 먼저 명확한 작업 순서를 세워 두면 이후 클라이언트를 바꾸거나 설정을 옮길 때 훨씬 수월합니다.

사용을 중단하게 만들기 쉬운 지점

  • 다운로드 경로와 플랫폼 아키텍처가 뒤섞임

    Windows 설치 파일, macOS 칩 아키텍처, Android 설치 형식은 서로 다르므로 파일 이름만으로는 어떤 항목을 선택해야 할지 바로 판단하기 어렵습니다.

  • 구독을 가져온 뒤 전략을 선택하지 않음

    설정이 클라이언트에 표시되더라도 프록시 그룹이 기본 항목에 머물러 있으면 실제 트래픽 경로가 예상과 달라질 수 있습니다.

  • 시스템 프록시와 TUN 모드를 동시에 사용함

    두 기능은 트래픽을 가로채는 계층이 다릅니다. 명확한 목적 없이 함께 켜면 오히려 문제의 원인을 판단하기 어려워집니다.

  • 문제가 발생하자 곧바로 반복해서 재설치함

    포트 사용 중, 설정 문법, 권한, DNS 등도 연결 이상을 일으킬 수 있으므로 클라이언트를 재설치해도 이런 원인이 해결되지는 않습니다.

더 명확한 처리 순서

  • 먼저 운영체제에 맞는 다운로드 페이지로 이동

    플랫폼 태그를 선택하면 해당 클라이언트 목록으로 바로 이동합니다. 이후 기기 아키텍처, 그래픽 인터페이스 필요 여부, 유지 관리 상태를 기준으로 설치 파일을 선택하세요.

  • 설정을 업데이트한 뒤 프록시 그룹 확인

    구독 업데이트 시간과 설정 상태를 확인한 다음 프록시 페이지에서 자동 선택, 수동 노드 또는 DIRECT 등의 전략을 선택합니다.

  • 애플리케이션 적용 범위에 맞춰 트래픽 연동 방식 선택

    브라우저처럼 시스템 설정을 따르는 앱에는 먼저 시스템 프록시를 사용할 수 있습니다. 더 많은 트래픽을 처리해야 할 때 TUN을 별도로 알아보고 활성화하세요.

  • 로그와 설정 검증부터 문제 해결 시작

    먼저 오류 키워드를 확인하고 포트, 설정, 권한 및 네트워크 환경을 점검하면 원인을 찾는 시간을 줄일 수 있습니다.

핵심 설정 경로

자주 쓰는 세 가지 작업을 하나씩 확인

아래 내용은 규칙 모드, 구독 업데이트, 로그 문제 해결로 나누어 정리했습니다. 각 항목은 클라이언트의 실제 설정에 대응하며 마우스, 터치 또는 키보드 방향키로 전환할 수 있습니다.

MODE / RULE

규칙 모드와 프록시 그룹의 역할

규칙 모드는 설정 파일의 도메인, IP, 프로세스 또는 규칙 집합에 따라 트래픽을 차례로 매칭한 뒤 해당 요청을 적절한 프록시 그룹으로 전달합니다. “전역” 모드가 보통 모든 트래픽을 하나의 전략으로 보내는 것과 달리, 규칙 모드에서는 직접 연결, 프록시, 차단 등 여러 경로를 동시에 유지할 수 있습니다. 실제로 사용할 때는 먼저 클라이언트 상단의 실행 모드가 “규칙”으로 설정되어 있는지 확인한 다음 프록시 페이지에서 각 프록시 그룹의 현재 선택 항목을 확인하세요.

프록시 그룹은 노드 목록을 다르게 부르는 말이 아닙니다. 노드는 실제 연결을 만들고, 프록시 그룹은 수동 선택, 자동 선택, 장애 조치처럼 선택 로직을 구성합니다. 구독을 가져온 뒤에도 프록시 그룹이 사용 목적에 맞는지 확인해야 합니다. 필드 간 관계, 규칙 순서와 매칭 방식은 설정 파일 전체 참고서에서 계속 확인할 수 있습니다.

실행 모드 규칙
프록시 그룹 자동 선택
매칭되지 않은 트래픽 MATCH

시스템 프록시는 좁은 범위부터 시작

시스템 프록시는 애플리케이션이 운영체제의 프록시 설정을 읽는 방식으로 작동합니다. 브라우저, 다운로드 도구와 많은 데스크톱 앱이 이 설정을 따르므로 첫 연결을 검증할 때 적합합니다. 특정 앱이 시스템 프록시를 명확히 무시할 때만 더 넓은 범위의 연동 방식을 고려하고, 처음부터 여러 네트워크 설정을 동시에 바꾸지는 마세요.

TUN 모드는 트래픽 연동 계층을 확인

TUN 모드는 가상 네트워크 어댑터를 통해 IP 계층에서 트래픽을 처리하므로 시스템 프록시 설정을 읽지 않는 일부 앱까지 적용할 수 있습니다. 관리자 권한, 라우팅 테이블과 DNS 동작이 관련될 수 있으므로 활성화하기 전에 현재 설정을 저장하고 기본 프록시 연결이 정상인지 확인하세요. 자세한 작동 방식은 TUN 모드와 시스템 프록시 비교에서 확인할 수 있습니다.

기기별로 이동

Clash 클라이언트 플랫폼 안내

같은 설정을 여러 기기에서 사용할 수 있지만 설치 형식, 시스템 권한과 조작 화면은 서로 다릅니다. 먼저 현재 기기에 맞는 태그를 선택한 뒤 해당 플랫폼에서 사용할 수 있는 그래픽 클라이언트를 비교하세요.

Windows

데스크톱 그래픽 인터페이스, 시스템 프록시 전환과 설정 관리가 필요한 사용자에게 적합합니다. 다운로드 전에 운영체제 아키텍처와 클라이언트 유지 관리 상태를 확인하세요. 기존 Clash for Windows로 부족하다면 계속 관리되는 대체 클라이언트를 비교해 볼 수 있습니다.

다운로드 페이지로 이동

macOS

Mac 데스크톱 환경에서 시스템 프록시, 메뉴 막대 상태와 구독 설정을 관리하려는 사용자에게 적합합니다. 다운로드 페이지에서 Apple Silicon과 Intel 아키텍처를 먼저 구분한 뒤 알맞은 설치 파일을 선택해 설치 중 아키텍처 호환성 오류를 피하세요.

다운로드 페이지로 이동

Android

휴대폰과 태블릿에서 구독 관리, 앱별 트래픽 분기와 VPN 연동을 사용하려는 경우에 적합합니다. 기기마다 프로세서 아키텍처가 다를 수 있으므로 확실하지 않다면 범용 설치 항목을 먼저 확인하고, 시스템 안내에 따라 VPN 연결에 필요한 권한을 허용하세요.

다운로드 페이지로 이동

iOS

iPhone 및 iPad 사용자가 스토어에서 클라이언트를 설치하고 시스템 네트워크 확장 프레임워크에서 연결을 관리할 때 적합합니다. 다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 정보를 확인한 뒤 클라이언트 화면에서 구독을 가져오세요.

다운로드 페이지로 이동

Linux

Linux 데스크톱, 개발 환경과 그래픽 설정 관리가 필요한 사용자에게 적합합니다. 설치 전에 배포판의 패키지 형식을 확인하세요. 서버, 라우터 또는 자동화 환경에서 코어만 실행한다면 다운로드 페이지의 Mihomo 코어 영역으로 이동해야 합니다.

다운로드 페이지로 이동
모든 클라이언트 보기 →

오픈 소스 생태계와 유지 관리 범위

클라이언트, 코어와 설정의 관계 이해

Clash 생태계는 코어, 그래픽 클라이언트, 규칙 프로젝트와 설정 도구로 구성됩니다. 이러한 계층을 구분하면 특정 소프트웨어 이름만 외우는 것보다 선택과 문제 해결에 도움이 됩니다.

프로젝트의 발전 과정

Clash는 처음에 규칙 기반 프록시 코어 형태로 널리 사용되었고, 이후 다양한 운영체제용 그래픽 클라이언트가 등장했습니다. 일부 초기 프로젝트는 이미 유지 관리가 중단되었지만 설정 문법, 프록시 그룹과 규칙 매칭 같은 핵심 개념은 후속 생태계에도 이어지고 있습니다. 클라이언트를 선택할 때는 익숙한 이전 이름만 보고 판단하지 말고 유지 관리 상태, 사용하는 코어와 플랫폼 지원 여부를 함께 확인해야 합니다.

오픈 소스 협업

코드가 공개되어 있어 개발자는 구현을 검토하고 이슈를 제보하며 플랫폼 지원을 개선할 수 있습니다. 또한 규칙 집합, DNS, 투명 프록시와 사용자 인터페이스를 중심으로 여러 프로젝트가 발전하고 있습니다. 클라이언트마다 인터페이스와 업데이트 주기가 다를 수 있고, 사용하는 코어에 따라 하위 수준의 기능도 달라집니다. 이 사이트는 실제 필요에 따라 확인할 수 있도록 클라이언트 다운로드 경로와 개념 문서를 나누어 정리했습니다.

mihomo 코어

mihomo는 현재 Clash 생태계에서 널리 사용되는 계승 코어로, 규칙 모드, 프록시 그룹, DNS 설정과 TUN 등을 지원합니다. 그래픽 클라이언트는 보통 설정 관리, 시스템 통합과 상태 표시를 담당하며, 실제 트래픽 매칭과 연결 처리는 코어가 수행합니다. 기능 차이가 발생하면 먼저 클라이언트가 어떤 코어를 사용하는지, 해당 설정 필드가 지원되는지 확인해야 합니다.

업데이트 방식

클라이언트 업데이트, 코어 업데이트와 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 그래픽 인터페이스와 시스템 통합을 바꾸고, 코어 업데이트는 프로토콜 또는 설정 기능의 변화를 가져올 수 있습니다. 구독 업데이트는 사용 중인 노드, 전략과 규칙 내용을 새로 고칩니다. 문제가 발생했을 때 최근 변경 사항이 어느 계층에 속하는지 기록하면 설정 문제를 설치 문제로 잘못 판단하는 일을 피할 수 있습니다.

mihomo 소스 코드 보기 git clone https://github.com/MetaCubeX/mihomo.git

자료에서 실제 조작으로 이어지는 권장 순서

처음 접할 때 모든 설정 필드를 먼저 읽을 필요는 없습니다. 먼저 다운로드 페이지에서 기기에 맞는 그래픽 클라이언트를 선택한 다음 시작하기의 단계에 따라 구독 가져오기, 규칙 모드 선택, 시스템 프록시 활성화와 기본 검증을 진행하세요. 정상적으로 연결된 후 앱 적용 범위에 따라 TUN이 필요한지 판단하고, 용어 설명에서 DNS, 프록시 그룹, 규칙 집합과 가상 네트워크 어댑터 등의 개념을 확인하면 됩니다.

YAML을 수정해야 한다면 먼저 정상적으로 로드되는 설정 사본을 보관한 뒤 항목별로 변경하세요. 포트, DNS, 프록시 그룹과 규칙 목록을 한 번에 바꾸면 오류 원인을 확인하기 어려워집니다. 한 번에 하나의 주제만 수정하고 설정을 다시 로드한 뒤 로그를 관찰하는 편이 안전합니다. 코어에서 문법 오류를 표시하면 마지막으로 정상 작동한 내용으로 돌아가 들여쓰기, 필드 형식과 참조 이름을 차례로 확인하세요.

설정 및 문제 해결 문서

최근 읽을거리

인터페이스 이해, 설정 구조부터 시작 오류까지 실제 사용 상황에 맞춰 설명합니다. 튜토리얼 페이지에서 자세히 다루기 어려운 원리와 문제 해결 세부 내용을 보완하는 글입니다.

문제 해결

Clash 클라이언트가 열리지 않을 때: 시작 충돌 및 강제 종료 문제 해결 절차

시작 실패의 주요 원인을 발생 빈도에 따라 정리했습니다. 포트 사용 중, 설정 파일 문법 오류, 권한 부족, 코어 파일 이상과 시스템 구성 요소 누락을 항목별로 확인하고 각각의 처리 순서를 제시합니다.

전체 글 읽기 →
고급 가이드

Clash 설정 파일 구조 단계별 해설: port부터 rules까지 YAML 읽기

전체 설정을 일반 필드, DNS, proxies, proxy-groups와 rules로 나누어 설명하고 필드 간 참조 방식, 들여쓰기, 이름 불일치와 규칙 순서에서 발생하는 일반적인 문제를 다룹니다.

전체 글 읽기 →
고급 가이드

TUN 모드와 시스템 프록시의 차이: 트래픽 연동 계층과 작동 방식 비교

운영체제 네트워크 스택 관점에서 두 가지 트래픽 연동 방식을 비교합니다. 시스템 프록시가 앱 지원에 의존하는 이유와 TUN이 가상 네트워크 어댑터로 더 넓은 트래픽을 처리하는 방식을 설명합니다.

전체 글 읽기 →
전체 글 보기 →