오픈소스 프로젝트 · 클라이언트 지속 업데이트·clashsupport.com

Clash 전체 플랫폼 클라이언트 다운로드 및 설정 문서

이 페이지는 Windows, macOS, Android, iOS, Linux 다섯 플랫폼에서 Clash 생태계 클라이언트를 받을 수 있는 입구를 모았습니다. 단계별 구독 가져오기 튜토리얼과 증상별로 정리한 문제 해결 매뉴얼을 함께 제공하며, 모든 절차는 실제 기기에서 검증한 뒤 작성했습니다.

영구 무료 오픈소스 코드 한국어 문서 core: mihomo

오류가 났나요? 먼저 문제 해결 매뉴얼 →을 확인해보세요

clash/community
Public clash / community main

핵심 기능 목록

Clash 클라이언트의 핵심 기능 6가지를 issue 목록 형식으로 정리했습니다. 제목을 클릭하면 더 긴 설명이 펼쳐집니다. 각 항목은 사이트 내 튜토리얼이나 매뉴얼의 해당 챕터와 연결되어 있으며 홍보 문구가 아닙니다.

Open 6 Closed 0 LabelsSort

정책 그룹

Clash의 핵심은 규칙 엔진입니다. 각 연결은 도메인, IP 대역, 프로세스명 등의 조건으로 규칙표와 매칭되고, 일치하면 지정된 프록시 또는 다이렉트 출구로 전달됩니다. 중국 본토 사이트는 직접 연결하고 특정 서비스는 프록시를 거치는 판단이 전부 자동으로 이루어지므로 수동으로 켜고 끌 필요가 없습니다. 구독 설정에는 보통 이미 정교한 규칙 세트가 포함되어 있어 가져오기만 하면 바로 사용할 수 있으며, 숙련된 사용자는 직접 규칙을 작성해 기본 동작을 덮어쓸 수도 있습니다.

규칙 매칭은 위에서 아래로 한 줄씩 진행되며 자주 쓰는 유형으로는 DOMAIN-SUFFIX(도메인 접미사), DOMAIN-KEYWORD(도메인 키워드), IP-CIDR(IP 대역), GEOIP(지역 데이터베이스), PROCESS-NAME(프로세스별 분기)이 있습니다. 기존의 '전역 프록시' 도구와 다른 점은, Clash가 모든 트래픽을 하나의 출구로 몰지 않고 연결마다 각자의 경로를 타게 한다는 것입니다. 이렇게 하면 트래픽을 아끼고 중국 본토 서비스가 프록시 출구 때문에 차단되는 상황도 피할 수 있습니다. 규칙 작성법과 매칭 순서에 대한 자세한 설명은 문제 해결 매뉴얼과 기술 노트의 관련 글에서 확인할 수 있습니다.

노드 관리

정책 그룹은 여러 노드를 선택 가능한 하나의 묶음으로 구성합니다. select 그룹은 수동으로 고르고, url-test 그룹은 주기적으로 지연 시간을 측정해 가장 빠른 노드로 자동 전환하며, fallback 그룹은 우선 노드에 장애가 생기면 순서대로 대체 노드로 넘어갑니다. 구독에 담긴 수십, 수백 개의 노드를 일일이 시험해 볼 필요 없이 클라이언트 화면에서 정책 그룹을 열면 각 노드의 실측 지연 시간을 바로 볼 수 있습니다.

속도 측정 원리는 설정에 지정된 url(흔히 Google의 generate_204 주소)로 HTTP 요청을 보내고 시간을 재는 방식으로, 표시되는 값은 '해당 노드를 거쳐 테스트 주소에 접속하는' 전체 경로의 지연 시간이며 단순 ping이 아닙니다. url-test 그룹의 interval 매개변수는 측정 주기를 제어하고, tolerance 매개변수는 지연 시간이 비슷한 두 노드 사이에서 전환이 계속 흔들리는 것을 막아줍니다. 어떤 용도에 어떤 그룹을 쓰고 어떻게 중첩해 조합하는지는 클라이언트 비교 페이지와 기술 노트에서 더 자세히 다룹니다.

구독 가져오기

구독 링크는 본질적으로 다운로드 가능한 YAML 설정 주소입니다. 주요 클라이언트는 모두 구독 링크를 붙여넣어 원클릭으로 가져오는 기능을 지원하며, 정기 자동 업데이트도 설정할 수 있어 노드 변경이나 규칙 수정이 업데이트마다 로컬에 반영됩니다. 여러 구독을 동시에 등록해 두고 설정을 전환하면 노드와 규칙 전체가 함께 바뀝니다.

가져오기 실패는 초보자가 가장 자주 겪는 문제로, 흔한 원인은 세 가지입니다. 구독 주소 자체에 접속하려면 프록시가 필요한 경우(먼저 다이렉트 연결이나 임시 노드로 업데이트), 구독이 base64로 인코딩된 다른 형식을 반환하는 경우(변환을 지원하는 클라이언트나 변환 서비스가 필요), 구독의 트래픽이나 유효기간이 소진된 경우(서버가 YAML 대신 오류 페이지를 반환)입니다. 항목별 점검 절차는 문제 해결 매뉴얼의 '구독 실패' 챕터에서, 구독 업데이트 실패에 대한 전문 분석은 자주 묻는 질문 페이지에서도 확인할 수 있습니다.

심화

시스템 프록시는 프록시 설정을 따르는 앱만 커버할 수 있고, 명령줄 도구나 게임 클라이언트, UWP 앱은 자주 이를 우회합니다. TUN 모드는 네트워크 계층에 가상 네트워크 카드를 만들어 기기의 모든 아웃바운드 트래픽을 Clash가 처리하도록 넘기며, 커버 범위는 VPN과 동등하면서도 분기 규칙은 그대로 적용됩니다. '일부 앱이 프록시를 타지 않는' 문제를 해결하는 표준 방법입니다.

TUN을 켜려면 관리자 권한이 필요하며(Windows에서는 보통 서비스 모드 설치와 함께 사용), DNS 하이재킹도 함께 켜는 것을 권장합니다. 그렇지 않으면 시스템 DNS 조회가 가상 네트워크 카드를 건너뛰어 규칙이 맞지 않을 수 있습니다. TUN은 시스템 프록시와 충돌하지 않아 동시에 켤 수 있으며, 성능 부담은 시스템 프록시보다 약간 높지만 일상적인 웹서핑과 다운로드에서는 거의 느껴지지 않습니다. 두 모드의 동작 방식 비교와 선택 기준은 기술 노트에 별도 글이 있고, Windows UWP 앱의 루프백 제한 해결법은 문제 해결 매뉴얼에도 수록되어 있습니다.

커널

현재 클라이언트는 대부분 mihomo 커널(커뮤니티에서는 흔히 Clash Meta로 부름)을 탑재하고 있으며, 원본 프로토콜을 기반으로 VLESS, Hysteria2, TUIC 등 비교적 새로운 프로토콜을 추가로 지원합니다. 하나의 설정 안에서 여러 프로토콜의 노드를 섞어 써도 문제가 없습니다. 커널은 GPL-3.0 라이선스로 오픈소스이며 배포판은 데스크톱, 서버, 라우터 아키텍처를 모두 지원합니다.

원본 Clash 커널은 2023년에 개발이 중단되었고, 커뮤니티 후속 프로젝트인 mihomo가 프로토콜 발전을 이어받았습니다. Shadowsocks, Trojan, VMess 같은 기존 프로토콜은 그대로 호환되고, 새로운 프로토콜은 업스트림 구현을 따라 추가됩니다. 일반 사용자라면 'mihomo 커널 기반' 클라이언트를 선택하는 것만으로 가장 넓은 프로토콜 지원을 얻을 수 있으며, 본 사이트 다운로드 페이지에 실린 활발한 클라이언트는 모두 이 조건을 만족합니다. 구독에 새 프로토콜 노드가 나타나 인식되지 않을 때는 클라이언트의 커널 버전을 올리면 대부분 해결됩니다.

심화

allow-lan을 켜면 Clash가 실행 중인 PC 한 대가 로컬 네트워크 안의 프록시 서버가 됩니다. 스마트폰, TV, 게임기에서 네트워크 프록시를 이 PC의 IP와 혼합 포트로 설정하면 동일한 노드와 규칙을 함께 사용할 수 있어 기기마다 따로 설정할 필요가 없습니다.

설정에서 핵심은 세 가지입니다. mixed-port로 HTTP와 SOCKS를 함께 처리하는 혼합 포트를 지정하고, allow-lan을 true로 설정하면서 bind-address가 외부 접속을 허용하는지 확인하고, 운영체제 방화벽에서 해당 포트의 인바운드 연결을 허용해야 합니다. 이 세 가지를 마치면 다른 기기의 Wi-Fi 프록시 설정에 PC의 내부 IP와 포트만 입력하면 됩니다. 더 나아가 이 PC를 게이트웨이로 만들어 전체 네트워크 대역이 기본적으로 Clash를 거치게 할 수도 있습니다. 전체 절차와 방화벽 허용 스크린샷은 기술 노트의 로컬 네트워크 공유 전문 글에서 확인할 수 있습니다.

3단계로 첫 연결 성공하기

1

클라이언트 설치 후 구독 가져오기

다운로드 페이지에서 해당 플랫폼 설치 파일을 선택하고, 설치 후 클라이언트를 열어 구독 링크를 '설정/구독' 입력란에 붙여넣은 다음 설정이 내려받아질 때까지 기다립니다.

2

규칙 모드와 노드 선택하기

프록시 모드는 기본값인 '규칙'을 그대로 두면 되고, 정책 그룹 화면에서 메인 그룹에 지연 시간이 낮은 노드를 골라주거나 자동 속도 테스트 그룹에 맡기면 됩니다.

3

시스템 프록시 켜고 확인하기

'시스템 프록시' 스위치를 켜고(모바일에서는 VPN 시작) 해외 사이트에 접속해 연결이 되는지 확인한 다음, 중국 본토 사이트에 접속해 다이렉트 연결이 영향을 받지 않는지도 확인합니다.

각 단계의 자세한 조작법, 스크린샷 위치, 자주 막히는 지점은 전체 튜토리얼 보기 →에서 확인하세요

오픈소스 생태계와 유지보수 방식

Clash는 2018년에 공개된 오픈소스 규칙 기반 프록시 커널로, 명확한 YAML 설정 형식과 규칙 분기 설계 덕분에 이 분야에서 사실상의 설정 표준으로 자리 잡았습니다. 오늘날 대부분의 구독 서비스가 출력하는 설정도 Clash 형식입니다. 원저작자가 2023년에 개발을 중단한 이후 커뮤니티 프로젝트인 mihomo(Clash Meta)가 커널 발전을 온전히 이어받아 프로토콜 지원과 버그 수정을 지금까지 활발히 이어가고 있습니다.

이 커널을 중심으로 여러 클라이언트로 이루어진 생태계가 자라났습니다. Clash Verge Rev, FlClash, Clash Nyanpasu 같은 그래픽 클라이언트는 각기 다른 팀이 독립적으로 유지보수하며 화면 구성과 지원 플랫폼에서 서로 다른 선택을 했지만 같은 커널과 설정 형식을 공유합니다. 즉 클라이언트를 바꿔도 구독을 바꿀 필요가 없으며, 하나의 설정이 다섯 플랫폼에서 그대로 통용됩니다. 커널과 주요 클라이언트는 모두 공개 저장소에서 개발되어 누구나 코드, 커밋 기록, 배포 산물을 확인할 수 있습니다.

이 사이트는 커뮤니티가 운영하는 문서 및 다운로드 안내 사이트입니다. 다운로드 입구는 각 클라이언트의 정식 배포 채널을 따라 갱신되고, 튜토리얼과 매뉴얼 내용은 실제 기기에서 검증한 뒤 게시하며, 클라이언트에 중요한 변경이 생기면 해당 챕터도 함께 수정합니다. 사이트 자체는 노드 서비스를 제공하지 않으며 어떤 구독 서비스 제공업체와도 관련이 없습니다.

소스 코드에서 직접 커널을 빌드하고 싶다면 저장소를 클론하면 됩니다:

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

facts.yaml

  • kernel: mihomo
  • license: GPL-3.0
  • config: YAML
  • platforms: Windows / macOS / Android / iOS / Linux
  • since: 2018

note

커널, 클라이언트, 규칙 세트는 각각 다른 저장소에서 관리되어 업그레이드가 서로 막히지 않습니다. 클라이언트에 내장된 커널 버전은 설정 페이지에서 확인할 수 있으며, 프로토콜이 인식되지 않는 문제가 생기면 먼저 커널 버전을 확인하세요.

자주 묻는 질문 모음

구독 업데이트가 계속 실패하면?먼저 구독 주소가 브라우저에서 바로 열리는지 확인하고, 클라이언트가 가져올 때 임시로 다이렉트 연결로 전환해야 하는지도 점검하세요. 자세한 내용은 자주 묻는 질문에서 확인할 수 있습니다.

프록시를 켰는데 일부 앱이 타지 않으면?명령줄 도구와 UWP 앱은 자주 시스템 프록시를 우회하므로 TUN 모드로 바꾸면 처리할 수 있습니다. 방법은 사용 가이드에서 확인하세요.

노드가 전부 타임아웃되면 어떻게 점검하나요?'로컬 네트워크 → 구독 유효성 → 노드 가용성 → 규칙 일치' 순서로 단계별로 원인을 좁혀 가세요. 자세한 절차는 문제 해결 매뉴얼에 수록되어 있습니다.

다른 클라이언트끼리 설정을 공유할 수 있나요?가능합니다. 주요 클라이언트는 같은 YAML 설정 형식을 공유하므로 클라이언트를 바꿀 때는 구독만 다시 가져오면 됩니다. 선택 기준은 클라이언트 비교에서 확인하세요.

기술 노트 · 최근 업데이트

태그별로 전체 콘텐츠 보기: 전체 글 보기 →

Clash 다운로드