오픈 소스 클라이언트 · 설정 문서 지속 정리

Clash 공식 클라이언트 다운로드 및 규칙 설정

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

운영체제에 맞는 유지 관리 상태가 확실한 클라이언트를 선택한 뒤 구독 가져오기, 규칙 매칭, 네트워크 가로채기의 세 경로를 따라 설정을 완료하세요. mihomo 코어, DNS, TUN 및 자주 발생하는 연결 문제를 확인할 수 있는 경로도 함께 정리했습니다.

  • 영구 무료
  • 오픈 소스 코드
  • 5개 플랫폼 지원
  • 한국어 설정 문서
FIG.01 주황색 경로는 요청이 규칙 매칭, 정책 선택, 아웃바운드 연결을 거치는 순서를 나타냅니다. 플랫폼 표시는 이용 가능한 진입점일 뿐 특정 버전을 의미하지 않습니다.

Platform entry · Plate 02

운영체제별 다운로드 목록

동일한 Clash 설정은 여러 GUI 클라이언트나 mihomo 코어에서 읽을 수 있지만 설치 방법, 시스템 권한, 유지 관리 상태는 서로 다릅니다. 먼저 기기의 운영체제를 확인한 다음 다운로드 페이지에서 클라이언트를 비교하면 아키텍처 불일치, 중단된 구형 프로젝트, 설정 디렉터리 혼용 문제를 피할 수 있습니다.

OS · 01

Windows

구독, 프록시 그룹, 시스템 프록시를 GUI로 관리하려는 데스크톱 사용자에게 적합합니다. 다운로드 전에 시스템 아키텍처를 확인하고, 현재 유지 관리 중인 Clash Plus, Clash Verge Rev, FlClash 또는 Clash Nyanpasu를 우선 선택하세요. Clash for Windows는 과거 프로젝트를 확인하기 위한 보관 항목으로만 제공합니다.

다운로드 페이지로 이동

OS · 02

macOS

Apple Silicon 및 Intel Mac에 적합합니다. 설치 파일은 프로세서 아키텍처에 맞아야 하며, 처음 실행할 때 시스템 네트워크 및 프록시 권한을 승인해야 합니다. GUI 클라이언트로 일상적인 정책 전환을 할 수 있고, 세밀한 제어가 필요할 때는 설정 디렉터리, 강화 모드, 시스템 확장 상태를 확인하세요.

다운로드 페이지로 이동

OS · 03

Android

스마트폰, 태블릿 및 일부 Android TV 기기에 적합합니다. 클라이언트는 일반적으로 시스템 VPN 인터페이스로 트래픽을 가로채므로 동시에 다른 VPN 앱이 같은 인터페이스를 사용할 수 없습니다. 구독을 가져온 뒤 먼저 정책 노드를 선택하고, 앱의 배터리 최적화 및 백그라운드 실행 제한을 확인하세요.

다운로드 페이지로 이동

OS · 04

iOS

iPhone과 iPad는 시스템 네트워크 확장을 통해 프록시 연결을 설정합니다. 다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 정보를 제공합니다. 설치가 끝나면 구독 주소나 설정 파일에서 콘텐츠를 가져오고, 시스템 권한 대화상자에서 네트워크 설정 추가를 승인하세요.

다운로드 페이지로 이동

OS · 05

Linux

데스크톱 환경에서는 GUI 클라이언트를 사용할 수 있으며, 서버·소프트 라우터·헤드리스 시스템에는 mihomo를 직접 실행하는 방식이 더 적합합니다. 배포할 때 바이너리 아키텍처, 설정 디렉터리, 서비스 계정을 구분하고, 프로세스 수명 주체가 systemd인지 컨테이너인지 현재 터미널인지 명확히 하세요.

다운로드 페이지로 이동

어떤 클라이언트를 골라야 할지 모르겠다면 유지 관리 상태, 시스템 아키텍처, GUI 필요 여부, TUN 지원을 먼저 확인한 뒤 설치 파일을 선택하세요.

전체 클라이언트 보기 →

Rule chain atlas · Plate 03

요청 유입부터 아웃바운드 연결까지

Clash의 핵심은 프록시를 단순히 켜고 끄는 것이 아니라 도메인 해석, 규칙 판단, 정책 선택, 시스템 트래픽 가로채기를 점검 가능한 하나의 실행 흐름으로 연결하는 데 있습니다. 각 단계의 입력과 출력을 이해해야 설정 변경과 장애 분석을 반복적인 시행착오에 의존하지 않을 수 있습니다.

Reading order

일반 프록시 요청은 보통 로컬 리스닝 포트로 들어온 뒤 설정에 따라 DNS와 규칙이 처리됩니다. TUN 모드에서는 가상 네트워크 인터페이스가 더 많은 시스템 트래픽을 수신합니다. 규칙은 설정 파일에 작성된 순서대로 위에서 아래로 매칭되며, 처음 일치한 항목이 대상 프록시 그룹을 결정합니다. 이후 프록시 그룹은 수동 선택, 자동 테스트 또는 장애 조치 결과에 따라 실제 아웃바운드를 정합니다. 웹페이지가 열리지 않으면 모든 옵션을 동시에 바꾸기보다 가로채기, 해석, 매칭, 선택, 연결 순서로 단계별 점검을 진행하세요.

Specimen 01 · Matching

규칙 순서가 트래픽 경로를 결정합니다

규칙은 설정 파일 상단부터 아래로 확인되며 일치하면 즉시 중단됩니다. 자주 사용하는 유형으로는 도메인 완전 일치, 도메인 접미사, 프로세스, IP 대역, 지역 데이터, 기본 규칙이 있습니다. 사용자 규칙은 트래픽을 먼저 가로챌 수 있는 포괄적인 규칙보다 앞에 배치해야 합니다. 그렇지 않으면 문법이 올바르더라도 적용되지 않습니다. 전역 스위치만 제공하는 프록시 도구와 달리 Clash에서는 사이트, 프로그램, 주소 대역별로 독립적인 정책을 지정하면서 매칭 기록도 추적할 수 있습니다.

수정할 때 먼저 대상 도메인을 기록한 뒤 연결 또는 로그 페이지에서 실제로 매칭된 규칙을 확인하세요. 결과가 예상과 다르면 규칙 위치, 규칙 세트 업데이트 여부, 도메인의 IP 변환 여부, 대상 프록시 그룹 이름의 존재 여부를 차례로 점검합니다. 처음부터 노드를 바꾸지 마세요. 노드 연결과 규칙 매칭은 서로 다른 단계입니다.

DOMAIN-SUFFIX,example.com,PROXY도메인 접미사 → 프록시 정책
GEOIP,CN,DIRECT주소 지역 → 직접 연결
MATCH,FALLBACK미매칭 요청 → 기본 정책

mixed-port

하나의 포트에서 HTTP와 SOCKS5 프록시 연결을 동시에 받아 데스크톱 프로그램에 로컬 프록시 주소를 통일해 입력할 때 적합합니다.

RULE

규칙표에 따라 요청의 경로를 결정하는 일반적인 모드입니다. 일상적인 사용에서는 전역 모드보다 직접 연결과 프록시 범위를 관리하기 쉽습니다.

Fake-IP

예약 주소로 도메인 매핑을 유지하여 TUN이 가로챈 연결에서도 도메인 정보를 보존하고 규칙 매칭에 참여하게 합니다.

external-controller

제어판이 실행 상태를 읽고 정책을 변경하는 관리 인터페이스입니다. LAN에 공개하기 전 접근 제어를 설정해야 합니다.

Selected questions

자주 묻는 질문

먼저 증상을 실행 흐름의 구체적인 단계로 좁힌 뒤 한 번에 하나씩 수정하세요. 전체 작업 절차는 사용 문서에서 순서대로 확인할 수 있습니다.

구독을 가져온 뒤 노드가 표시되지 않는 이유는 무엇인가요?

먼저 구독 응답이 Clash 또는 mihomo에서 읽을 수 있는 YAML 설정인지 확인하세요. 일반 웹페이지, 로그인 페이지, 다른 클라이언트 전용 형식의 콘텐츠일 수 있습니다. 그런 다음 구독 업데이트 기록의 파싱 오류를 확인하고 들여쓰기, 프록시 그룹 참조, 노드 필드를 중점적으로 살펴보세요. 구독에 인증이 필요하다면 링크가 만료되지 않았는지도 확인해야 합니다. 구독 가져오기 단계에서 계속 확인할 수 있습니다.

클라이언트는 연결됨으로 표시되는데 브라우저에서 인터넷이 되지 않으면 어떻게 하나요?

연결 상태는 코어 프로세스가 실행 중이라는 뜻일 뿐입니다. 시스템 프록시 활성화 여부, 브라우저의 독립 프록시 설정 사용 여부, 현재 프록시 그룹에서 사용 가능한 출구를 선택했는지, DNS가 응답하는지를 추가로 확인하세요. 먼저 직접 연결 사이트에 접속한 다음 연결 로그에 요청이 기록되는지 살펴보면 문제가 트래픽 가로채기 이전인지 규칙 처리 이후인지 판단할 수 있습니다.

규칙 모드, 전역 모드, 직접 연결 모드는 어떻게 선택해야 하나요?

일상적인 사용에는 규칙 모드를 선택해 설정이 도메인, 주소, 프로세스에 따라 트래픽 경로를 결정하도록 하는 것이 좋습니다. 전역 모드는 가로챌 수 있는 요청을 하나의 정책으로 모아 임시로 노드를 확인할 때 적합합니다. 직접 연결 모드는 프록시를 우회하여 문제가 프록시 경로에서 발생했는지 판단할 때 사용할 수 있습니다. 세 모드는 트래픽 결정 방식만 바꾸며 구독이나 노드 자체의 문제를 해결하지는 않습니다.

TUN 모드는 언제 켜야 하나요?

대상 프로그램이 시스템 프록시를 사용하지 않거나 명령줄 프로그램을 가로채야 하거나 더 많은 시스템 트래픽을 한 번에 처리해야 할 때 TUN을 고려하세요. 먼저 일반 프록시 모드를 안정적으로 작동시킨 뒤 TUN을 별도로 활성화하고 인터페이스, 라우팅, DNS를 확인해야 합니다. 그래야 인터넷이 끊겨도 기본 설정 문제인지 가상 인터페이스 가로채기 문제인지 구분할 수 있습니다. 자세한 순서는 사용 문서를 참고하세요.

Open source record · Plate 04

Clash 생태계와 mihomo 코어

클라이언트 이름은 비슷해도 GUI, 코어 프로그램, 설정 형식은 서로 다른 계층입니다. 프로젝트 간 관계를 이해해야 업데이트 출처, 호환 범위, 문제를 어디에 제보할지 정확히 판단할 수 있습니다.

A

프로젝트의 역사: Clash 설정 관례에서 지속적으로 발전하는 생태계까지

Clash는 널리 사용되는 YAML 설정 구조, 규칙 유형, 프록시 그룹 개념을 만들었고 이후 다양한 플랫폼용 GUI 클라이언트가 등장했습니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 생태계가 하나의 새 프로젝트로 자동 통합된 것은 아닙니다. 클라이언트마다 선택한 코어, UI 프레임워크, 출시 주기가 다릅니다. 따라서 이름에 Clash가 포함되어 있다고 해서 같은 관리자가 배포한 제품이라고 볼 수 없으며, 오래된 가이드만으로 현재 호환성을 판단해서도 안 됩니다.

클라이언트를 선택할 때는 GUI 프로젝트와 포함된 코어의 유지 관리 상태를 함께 확인하세요. 기존 설정은 대체로 이전할 수 있지만 확장 필드, 규칙 세트 형식, DNS 동작, TUN 구현에는 차이가 있을 수 있습니다. 다운로드 센터에서는 현재 유지 관리 중인 선택지를 플랫폼별로 소개하고, 유지 관리가 중단된 프로젝트는 보관용으로 명확히 표시합니다.

B

오픈 소스 생태계: GUI, 코어, 규칙 데이터의 협업

전체 실행 흐름은 보통 GUI 클라이언트, mihomo 코어, 구독 설정, 규칙 데이터로 구성됩니다. GUI 클라이언트는 설정 가져오기, 프록시 그룹 표시, 시스템 프록시 전환, 프로세스 관리를 담당합니다. 코어는 포트 리스닝, DNS 해석, 규칙 실행, 아웃바운드 연결을 처리하고 규칙 세트는 도메인·주소·애플리케이션 분류를 제공합니다. 어느 한 계층의 업데이트라도 실패하면 노드 누락, 규칙 미매칭, 요청 시간 초과로 나타날 수 있습니다.

오픈 소스 코드를 통해 설정 동작, 매개변수 정의, 변경 기록을 커뮤니티가 검토할 수 있습니다. 문제가 발생하면 먼저 GUI 조작 문제인지 코어 실행 문제인지 확인한 다음 해당 프로젝트의 문서와 로그를 살펴보세요. 모든 문제를 클라이언트 이름 탓으로 돌리면 실제 오류가 발생한 구성 요소를 놓칠 수 있습니다.

C

코어 관계: 실제 네트워크 처리를 수행하는 mihomo

mihomo는 현재 Clash 생태계에서 널리 사용되는 지속 유지 관리 코어로, 규칙 세트, DNS, TUN, 도메인 스니핑, 외부 제어 기능을 확장했습니다. 많은 데스크톱 및 모바일 클라이언트가 이를 GUI 내부에 통합하며, 사용자가 시작 버튼을 누른 뒤 실제로 로컬 포트를 열고 연결을 처리하는 것은 코어 프로세스입니다. 서버와 소프트 라우터 환경에서는 GUI를 거치지 않고 코어를 직접 실행할 수도 있습니다.

설정의 사용 가능 여부는 현재 코어가 지원하는 필드를 기준으로 판단해야 합니다. 어떤 클라이언트가 파일을 가져올 수 있다고 해서 모든 필드가 예상대로 실행되는 것은 아닙니다. 반대로 코어가 지원하는 새 필드가 GUI에 시각적 설정으로 제공되지 않았을 수도 있습니다. 세밀한 설정이 필요하다면 실행 로그와 실제 생성된 설정 파일을 함께 대조하세요.

D

업데이트 방식: 애플리케이션 버전, 코어, 구독을 각각 확인합니다

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 독립적인 세 경로입니다. GUI 클라이언트를 업데이트하면 인터페이스 수정과 새 코어 버전이 포함될 수 있지만 구독 서비스가 제공하는 노드와 규칙이 자동으로 바뀌지는 않습니다. 구독 업데이트는 설정 내용을 교체하지만 로컬 프로그램을 업그레이드하지는 않습니다. 규칙 세트도 자체 일정에 따라 다운로드될 수 있으므로 문제를 분석할 때 어느 계층이 변경되었는지 구체적으로 기록해야 합니다.

업그레이드 전에는 현재 작동하는 설정과 사용자 정의 오버라이드를 보존하는 것이 좋습니다. 업그레이드 후에는 먼저 구독 읽기, 프록시 그룹 표시, 시스템 프록시, DNS를 확인하고 TUN이나 복잡한 오버라이드를 단계적으로 복원하세요. 이렇게 하면 호환성 차이를 명확한 단계로 좁혀 한 번의 업데이트에서 여러 변수를 동시에 마주치는 일을 피할 수 있습니다.

Repository command

mihomo 소스 코드 가져오기

다음 명령은 공개 저장소를 복제하며 설정 정의, 변경 기록, 빌드 설명을 확인할 때 사용할 수 있습니다. 일반 클라이언트 사용자는 일상적인 설치를 위해 소스 코드를 이용할 필요가 없습니다.

git clone https://github.com/MetaCubeX/mihomo.git

Field notes · Plate 05

설정 및 문제 해결 최신 글

글은 구체적인 작업별 범위로 나누어 Linux 배포, 실행 로그 확인, LAN 프록시 공유를 다룹니다. 읽을 때 현재 클라이언트의 메뉴 이름과 비교해 본문의 코어 필드를 해당 설정 항목에 대응시키면 됩니다.

플랫폼 설치

Linux에 Clash 클라이언트 설치하기: GUI와 명령줄 배포 절차

Linux GUI 클라이언트, mihomo 명령줄 코어, 서비스 자동 시작, 설정 디렉터리의 전체 배포 방법을 설명하고 임시 실행과 장기 서비스 관리를 구분합니다.

글 읽기 →
로그 진단

Clash 실행 로그 읽는 법: 자주 발생하는 오류의 의미와 분석 순서

시작, 구독, DNS, 연결, 규칙 매칭 단계별로 로그를 분석하고, 오류 기록 하나에서 구체적인 설정 항목을 찾아가는 방법을 설명합니다. 노드와 설정을 동시에 바꾸지 않아도 됩니다.

글 읽기 →
고급 네트워크

Clash 혼합 포트와 LAN 프록시: 휴대폰 및 다른 기기와 설정 공유하기

mixed-port, LAN 접근 허용, 리스닝 주소, 방화벽 허용 규칙의 관계를 설명하고 공유 기기에서 연결할 수 없을 때의 점검 순서를 제시합니다.

글 읽기 →

프록시 모드 선택, 구독 형식 확인, 설정 변환 원칙, 플랫폼 설치 기록을 다룬 글도 더 있습니다.

전체 글 보기 →