오픈 소스 생태계 · 전체 플랫폼 클라이언트와 한국어 설정 가이드

Clash 프록시 클라이언트 다운로드 및 규칙 라우팅

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

현재 시스템과 사용 환경에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 정책 그룹 선택, 네트워크 연결 순서로 설정합니다. 전체 플랫폼 다운로드, 규칙 라우팅, 한국어 문제 해결을 중심으로 설명해 처음 설정하거나 이후 유지 관리할 때 필요한 단계를 빠르게 찾을 수 있습니다.

영구 무료 오픈 소스 mihomo 커널 생태계 한국어 설정 문서
PLATFORMS 5가지 플랫폼 입구

Windows、macOS、Android、iOS、Linux

ROUTING CORE mihomo

Clash 설정과 호환되며 규칙, 프로토콜 및 네트워크 연결 기능을 확장합니다.

OPEN SOURCE GPL-3.0

핵심 코드가 공개되어 설정 동작과 버전별 변경 사항을 커뮤니티가 함께 검토할 수 있습니다.

DOWNLOAD BY PLATFORM

시스템에 맞는 Clash 클라이언트 선택

시스템마다 네트워크 권한, 백그라운드 동작 방식, 설치 패키지 형식이 다릅니다. 먼저 해당 플랫폼으로 이동한 다음 데스크톱 GUI가 필요한지, 모바일에서 상시 연결할지, 서버에서 실행할지에 따라 클라이언트를 선택하세요.

전체 클라이언트 보기 →
DESKTOP / WINDOWS

Windows

트레이 제어, 시스템 프록시 전환, 시작 시 자동 실행, TUN 연결이 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 및 보관된 클라이언트의 유지 관리 상태와 용도별 차이를 함께 안내합니다.

다운로드 페이지로 이동
DESKTOP / MACOS

macOS

Apple Silicon 및 Intel Mac에 적합합니다. 설치 패키지는 프로세서 아키텍처에 맞게 선택해야 하며, 시스템 프록시 권한, 로그인 항목, 네트워크 확장 권한을 확인하세요. 시스템 프록시를 따르지 않는 프로그램까지 연결하려면 라우팅 영향을 이해한 뒤 TUN을 사용할 수 있습니다.

다운로드 페이지로 이동
MOBILE / ANDROID

Android

Android 클라이언트는 일반적으로 시스템 VpnService를 통해 앱 트래픽을 연결합니다. 구독을 가져오는 것 외에도 백그라운드 실행, 배터리 최적화 제외, 상시 VPN, 앱별 라우팅을 설정해야 합니다. 그렇지 않으면 화면이 잠긴 뒤 시스템이 프로세스를 종료해 연결이 끊길 수 있습니다.

다운로드 페이지로 이동
MOBILE / IOS

iOS

iPhone과 iPad는 시스템 네트워크 확장으로 프록시 연결을 구성하며, 클라이언트 설치와 업데이트는 App Store에서 관리합니다. 다운로드 페이지에서 Clash Plus의 스토어 링크와 공식 사이트 정보를 제공하며, 가져온 뒤 설정의 정책 그룹으로 출구를 전환할 수 있습니다.

다운로드 페이지로 이동
DESKTOP / LINUX

Linux

데스크톱 배포판은 GUI 클라이언트를, 서버·소프트 라우터·컨테이너 환경은 mihomo 커널을 직접 실행하는 방식을 선택할 수 있습니다. 설치 전 CPU 아키텍처, 패키지 형식, 서비스 권한, 설정 파일과 로그 저장 위치를 확인하세요.

다운로드 페이지로 이동
권장 선택 순서

일반 데스크톱 사용자는 먼저 유지 관리 중인 GUI 클라이언트를 선택한 뒤 프로세서 아키텍처에 맞는 설치 패키지를 다운로드하세요. 모바일에서는 시스템 스토어 또는 설치 패키지 출처를 확인한 다음 백그라운드 권한을 설정합니다. 서버, 라우터 또는 자동화 환경에서 실행할 때만 mihomo 커널, 설정 파일, 서비스 프로세스를 직접 관리하면 됩니다.

RULE ROUTING WORKBENCH

Clash 규칙 라우팅 워크벤치

규칙 모드는 모든 트래픽을 하나의 출구로 보내는 단순한 방식이 아닙니다. 클라이언트는 위에서부터 규칙을 확인하고, 처음 일치하는 항목을 지정된 정책 그룹으로 전달합니다. 일치 순서, 규칙 유형, 네트워크 연결 범위를 이해해야 설정 결과를 명확하게 추적할 수 있습니다.

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN: 도메인으로 트래픽 출구 결정

도메인 규칙은 웹사이트, API 도메인, 콘텐츠 서비스에 적합합니다. 전체 도메인 또는 특정 도메인 접미사를 기준으로 일치시킨 뒤 직접 연결, 프록시 또는 사용자 지정 정책 그룹으로 요청을 보낼 수 있습니다. 대상 IP만 확인하는 방식보다 실제로 이용하는 서비스 이름에 가까워 읽고 관리하기도 쉽습니다.

사용할 때는 범위가 더 구체적인 규칙을 앞에, 포괄적인 접미사 규칙을 뒤에 배치하세요. 예를 들어 특정 하위 도메인은 직접 연결하고 같은 주 도메인의 다른 요청은 프록시로 보내려면 전체 도메인 규칙을 먼저 작성해야 합니다. DNS 해석 경로도 확인해야 합니다. 커널에 전달되기 전에 도메인 정보가 사라지면 IP 규칙에 의존해 일치할 수 있으므로 도메인 라우팅과 DNS 설정을 함께 점검하세요.

요청 도메인→위에서부터 일치→지정 정책 그룹→직접 연결 또는 프록시
ORDER

첫 번째 일치 원칙

Clash는 일반적으로 설정에 등장하는 순서대로 규칙을 확인하며, 일치하면 더 이상 검색하지 않습니다. 모든 규칙을 동시에 계산한 뒤 ‘가장 구체적인’ 규칙을 고르는 방식이 아니므로 순서 자체가 설정 로직의 일부입니다. 새 규칙을 추가했는데 결과가 바뀌지 않는다면 먼저 앞의 포괄적인 규칙이 해당 연결을 이미 처리한 것은 아닌지 확인하세요.

POLICY

정책 그룹과 노드 분리

규칙은 보통 개별 노드가 아니라 정책 그룹을 가리킵니다. 따라서 규칙 문구를 수정하지 않고도 노드 전환, 자동 선택, 출구 변경이 가능합니다. 설정을 점검할 때는 먼저 규칙이 어느 정책 그룹과 일치했는지 확인하고, 그 다음 정책 그룹의 현재 선택 항목을 살펴보세요. 그래야 규칙 문제와 노드 연결 문제를 혼동하지 않습니다.

OPEN SOURCE CONTEXT

Clash 오픈 소스 생태계와 설정 근거

클라이언트를 선택할 때 인터페이스 이름은 첫 번째 정보일 뿐입니다. 실제로 더 중요한 것은 사용하는 커널, 설정 호환 범위, 시스템 통합 방식, 유지 관리 상태입니다. 이러한 관계를 이해해야 가이드의 설정이 현재 클라이언트에 적용되는지 판단할 수 있습니다.

01

Clash 설정 문법부터 mihomo 확장 기능까지

Clash 생태계는 프록시 노드, 정책 그룹, 규칙, DNS, 실행 매개변수를 포함한 널리 사용되는 YAML 설정 구조를 갖추고 있습니다. 원본 프로젝트의 업데이트가 중단된 뒤에도 커뮤니티 포크가 호환성을 계속 유지했으며, mihomo는 일반적인 설정 문법을 이어받는 동시에 규칙 유형, 프록시 프로토콜, DNS 동작, TUN 관련 기능을 확장했습니다. 실제 사용에서는 클라이언트에 내장되었거나 호출되는 커널을 기준으로 판단해야 하며, 인터페이스에 Clash라는 이름이 있는지만으로 기능을 단정해서는 안 됩니다.

02

클라이언트는 인터페이스와 시스템 통합을 담당

GUI 클라이언트는 일반적으로 구독 관리, 정책 그룹 전환, 시스템 프록시, 시작 시 실행, 로그 확인, 커널 업데이트를 담당합니다. 실제 연결 생성, 규칙 일치, 트래픽 전달은 커널이 수행합니다. 두 구성 요소의 역할이 다르므로 ‘인터페이스에서 설정을 가져올 수 있다’고 해서 현재 커널이 모든 필드를 지원하는 것은 아닙니다. 설정 오류가 발생하면 클라이언트 버전, 커널 이름, 오류 행, 실행 로그를 기록한 뒤 문법 문제인지 호환성 문제인지 시스템 권한 문제인지 판단하세요.

03

공개 코드로 동작을 검증할 수 있음

오픈 소스 프로젝트의 코드, 커밋 기록, 릴리스 노트, 이슈 논의는 추적 가능한 기술 근거를 함께 구성합니다. 사용자는 특정 규칙이 언제 추가되었는지, 기본 동작이 변경되었는지, 알려진 문제가 확인되었는지 살펴볼 수 있으며 클라이언트 래퍼와 커널 자체의 역할도 비교할 수 있습니다. 이 사이트는 기능을 설명할 때 다운로드 수, 평점, 노드 속도처럼 안정적으로 검증하기 어려운 데이터를 판단 기준으로 삼지 않고 설정 의미, 시스템 네트워크 메커니즘, 공개된 유지 관리 정보를 우선합니다.

04

업데이트 전 변경 사항을 읽고 되돌릴 수 있는 설정 보관

클라이언트 업데이트에는 인터페이스 조정, 커널 교체, 권한 변경, 설정 마이그레이션이 함께 포함될 수 있습니다. 안정적으로 관리하려면 사용 가능한 설정을 보관하고, 사용자 지정 규칙을 기록하며, 릴리스 노트를 읽고, 업데이트 후 구독 갱신·정책 그룹 선택·DNS·시스템 프록시 상태를 확인하세요. 문제가 발생하면 먼저 최소 설정으로 기본 연결을 확인한 다음 규칙 세트, 스크립트, TUN 설정을 단계적으로 추가하는 편이 여러 옵션을 한꺼번에 변경하는 것보다 원인을 찾기 쉽습니다.

QUICK ANSWERS

Clash 자주 묻는 질문 모음

다음 질문을 통해 다운로드 페이지, 튜토리얼, 용어집, 전체 FAQ 중 어디로 이동해야 할지 빠르게 판단할 수 있습니다. 구체적인 오류 로그가 있다면 원문 오류와 작업 순서를 보관한 뒤 항목별로 점검하세요.

Clash 클라이언트, mihomo 커널, 설정 파일은 어떤 관계인가요?

클라이언트는 시각적 인터페이스와 시스템 통합을 제공하고, mihomo와 같은 커널은 연결·규칙·트래픽 전달을 담당하며, YAML 설정 파일은 노드·정책 그룹·규칙·DNS 동작을 정의합니다. 세 요소가 호환되어야 정상적으로 실행됩니다. 자세한 개념은 용어집에서 확인할 수 있습니다.

구독을 성공적으로 가져왔는데 웹페이지가 여전히 프록시로 열리지 않는 이유는 무엇인가요?

가져오기에 성공했다는 것은 설정이 클라이언트에 들어왔다는 뜻일 뿐입니다. 커널을 시작하고 사용 가능한 정책을 선택한 뒤 시스템 프록시 또는 해당 연결 방식을 활성화해야 하며, 규칙이 올바른 정책 그룹과 일치하는지도 확인해야 합니다. 사용 가이드에 따라 설정, 모드, 연결, 확인 단계를 차례로 점검하세요.

규칙 모드, 글로벌 모드, 직접 연결 모드는 어떻게 선택하나요?

규칙 모드는 설정에 따라 연결을 분류하므로 일상적인 사용에 적합합니다. 글로벌 모드는 대부분의 연결을 하나의 프록시 정책으로 보내 노드를 임시로 테스트할 때 유용하고, 직접 연결 모드는 로컬 네트워크가 정상인지 확인할 때 주로 사용합니다. 모드 변경으로 작동하지 않는 노드나 잘못된 구독이 해결되지는 않습니다. 자세한 차이는 FAQ 페이지에서 확인하세요.

시스템 프록시를 켰는데 TUN도 활성화해야 하나요?

브라우저와 일반적인 데스크톱 프로그램이 시스템 프록시를 정상적으로 따르면 기존 설정을 유지해도 됩니다. 앱이 시스템 프록시를 읽지 않거나 더 많은 프로토콜을 연결해야 하거나 전체 트래픽을 통합 라우팅해야 할 때만 TUN을 검토하세요. 활성화한 뒤에는 라우팅, DNS, LAN 접근, 다른 VPN 소프트웨어와의 충돌 여부를 확인해야 합니다.

LATEST GUIDES

Clash 설정 및 문제 해결 문서

커널 차이, Android 네트워크 연결, 클라이언트 인터페이스까지 구체적인 문제별로 설명합니다. 기본 설치를 마친 뒤 이어서 참고하기 좋습니다.

전체 문서 보기 →