Clash 클라이언트 · 다운로드 및 설정

Clash Hub · 클라이언트 다운로드 구독 가져오기와 규칙 기반 라우팅

기기에 맞는 클라이언트를 선택하고 기존 구독으로 설정하세요. 먼저 규칙 모드를 사용하고, 필요에 따라 시스템 프록시 또는 TUN 모드를 켜세요.

  • 오픈 소스 커널 생태계
  • 다양한 플랫폼의 클라이언트
  • 한국어 설정 가이드

기기 플랫폼 선택

플랫폼별 다운로드

Clash 클라이언트, 먼저 기기 선택

클라이언트는 화면과 시스템 연동을 담당하고, 커널은 연결을 처리합니다. 운영체제와 프로세서 아키텍처를 확인한 뒤 구독 관리, 서비스 모드 등의 기능을 비교하세요. 처음 설치한다면 Clash Plus부터 살펴보세요. Linux 사용자는 Clash Verge Rev와 FlClash도 확인할 수 있습니다.

설치 파일의 실행 가능 여부는 플랫폼 이름만으로 판단할 수 없습니다. 운영체제 지원 범위, 프로세서 아키텍처, 그래픽 환경과 권한을 확인해야 합니다. 이전 클라이언트는 마이그레이션 참고용으로 보관할 수 있지만, 새 기기에서는 지속적으로 관리되는 프로젝트를 우선 살펴보세요. 다운로드 페이지에서는 선택 가능한 클라이언트와 보관된 프로젝트를 구분해 표시하므로 익숙한 이름만 보고 설치 파일을 고르는 일을 피할 수 있습니다.

기존 Clash for Windows 설정을 사용 중이라면 먼저 구독 주소, 사용자 지정 규칙, 프록시 그룹 선택을 백업한 뒤 새 클라이언트에 다시 가져오세요. 기존 프로그램 폴더 전체를 그대로 덮어쓰지 마세요. 클라이언트 설정 파일과 구독 YAML은 대개 형식이 다릅니다. 사용 방식부터 비교하려면 클라이언트 비교를 확인하세요.

전체 클라이언트 보기 →

빠른 시작 미리보기

구독 가져오기부터 연결 확인까지, 3단계

클라이언트를 설치했다고 해서 바로 사용할 수 있는 프록시 설정이 생기는 것은 아닙니다. 신뢰할 수 있는 출처에서 호환되는 구독을 준비한 다음 아래 순서대로 진행하세요. 처음 설정할 때는 기본 포트와 DNS 옵션을 유지하세요. 여러 항목을 한꺼번에 바꾸지 않으면 문제가 생겼을 때 원인을 찾기 쉽습니다.

  1. 설정 가져오기 및 선택

    ‘구독’ 또는 ‘설정’을 열고 URL 가져오기를 선택한 뒤 전체 구독 주소를 붙여넣고 업데이트하세요. 설정 이름이 표시되면 현재 사용할 항목으로 선택해야 합니다. 형식 오류가 뜨면 먼저 받은 주소가 다른 클라이언트 전용 링크가 아니라 Clash 호환 YAML인지 확인하세요. 인증 정보가 포함된 구독 주소를 공개 게시판에 올리지 마세요.

  2. 규칙과 트래픽 처리 방식 선택

    실행 모드는 먼저 ‘규칙’로 설정하고, 프록시 그룹에서 사용할 수 있는 노드를 선택한 다음 데스크톱에서 ‘시스템 프록시’를 켜세요. 모바일에서는 시스템 안내에 따라 VPN 연결을 허용하세요. 규칙 모드는 연결의 목적지를 정하고, 시스템 프록시나 TUN은 어떤 연결을 커널로 보낼지 결정합니다. 서로 대체할 수 있는 설정이 아니며, ‘전역’ 사용을 위해 모두 켤 필요는 없습니다.

  3. 연결 및 적용된 규칙 확인

    프록시가 필요한 웹사이트에 접속한 다음 ‘연결’ 또는 ‘로그’에서 대상 도메인, 규칙, 출구를 확인하세요. 브라우저는 되지만 특정 앱이 연결되지 않으면 해당 앱이 시스템 프록시를 사용하는지 먼저 살펴보고, 필요하면 TUN을 검토하세요. 테스트할 때는 설정을 한 번에 하나씩만 바꾸세요. 정상 작동하는 설정을 보존하고 결과를 확인한 뒤 DNS나 분할 라우팅 규칙을 조정하세요.

전체 가이드 보기 →

설정 페이지 미리보기

자주 쓰는 Clash 설정, 문제별로 확인

‘연결 처리 범위’와 ‘출구 선택’을 구분한 뒤 규칙, 포트, 설정을 조정하세요. 아래 화면은 설정 항목 예시이며 현재 기기의 실행 상태를 나타내지 않습니다. 실제 항목 이름과 사용 가능 여부는 선택한 클라이언트에 따라 다릅니다.

규칙 모드: 순서대로 출구 결정

업무 사이트는 직접 연결하고 나머지는 지정한 프록시 그룹으로 보내려면 ‘규칙’ 모드를 선택하세요. 커널은 일반적으로 위에서 아래 순서로 규칙을 확인하며, 먼저 일치한 규칙이 출구를 결정합니다. 따라서 사용자 지정 도메인 규칙은 기본 규칙보다 앞에 두세요. 전역 모드는 모든 연결을 전역 프록시 그룹으로 보내는 설정이지, 모든 앱의 트래픽을 자동으로 처리한다는 뜻은 아닙니다. 클라이언트마다 규칙 편집, 재정의, 병합 메뉴가 다릅니다. 구독은 정기적으로 업데이트되므로 사용자 지정 내용을 오래 유지하려면 클라이언트가 지원하는 재정의 영역에 저장해 업데이트로 덮어쓰이지 않도록 하세요.

도메인 접미사 규칙 예시DOMAIN-SUFFIX,example.com,DIRECT

오픈 소스 생태계와 사용 범위

클라이언트, 커널, 구독은 각각 역할이 다릅니다

Clash Hub는 클라이언트 다운로드와 한국어 가이드를 모아 제공하는 사이트이며, 각 클라이언트의 개발팀은 아닙니다. 프로젝트를 장기간 사용해도 괜찮은지 판단하려면 익숙한 인터페이스인지보다 원본 저장소, 유지 관리 기록, 설정 호환성을 확인하세요.

Clash에서 mihomo까지

Clash 생태계의 기본은 설정 파일에 프록시, 프록시 그룹, 분할 라우팅 규칙을 정의하고 커널이 연결을 처리하는 방식입니다. 이를 바탕으로 커뮤니티에서 다양한 데스크톱 인터페이스와 모바일 클라이언트가 만들어졌습니다. 원본 Clash의 공개 유지 관리는 중단되었으며 후속 프로젝트는 이름만 바꾼 동일한 프로그램이 아닙니다. 기능 범위, 기본 동작, 설정 지원이 달라질 수 있습니다.

Clash Meta의 후속 프로젝트는 mihomo라는 이름으로 관리되며, 현재 생태계에서 흔히 선택하는 커널 중 하나입니다. 이름이 비슷하다고 모든 필드를 서로 바꿔 쓸 수 있는 것은 아닙니다. 특히 최신 프록시 프로토콜, DNS 옵션, 규칙 기능은 차이가 있을 수 있습니다. 이전 가이드로 기본 개념을 익힐 수는 있지만 실제 설정은 현재 실행 중인 커널의 문서를 따르세요. 오류 원인을 찾을 때는 클라이언트 이름만 검색하기보다 구체적인 필드와 커널 정보를 확인하는 편이 효과적입니다.

그래픽 클라이언트와 커널의 역할

Clash Plus, Clash Verge Rev 등의 클라이언트는 설정 관리, 프록시 그룹 선택, 로그 확인, 시스템 연동 기능을 제공합니다. 커널은 연결을 받은 뒤 규칙을 적용하고 도메인을 해석해 상위 연결을 만드는 일을 처리합니다. 클라이언트와 커널의 업데이트 주기는 다를 수 있으므로 한 인터페이스에 새 설정이 추가되었다고 해서 모든 플랫폼의 구현이 완전히 같다는 뜻은 아닙니다.

클라이언트를 고를 때는 화면 취향보다 기기 지원, 구독 호환성, 필요한 트래픽 처리 방식을 먼저 살펴보세요. 처음이라면 Clash Plus를 우선 확인할 수 있습니다. Linux 사용자는 Clash Verge Rev와 FlClash를 비교해 보세요. Clash for Windows에서 옮길 때는 기존 설정을 백업하고 시스템 프록시, 포트, 재정의 규칙을 하나씩 확인하세요. 이전 클라이언트의 데이터 폴더를 범용 설정처럼 그대로 가져오면 안 됩니다.

구독 내용은 어디에서 오나요?

클라이언트 다운로드와 프록시 서비스는 별개입니다. 구독에는 노드, 프록시 그룹, 규칙, DNS 설정이 포함될 수 있으며 사용 가능 여부는 구독 출처와 실제 네트워크 환경에 따라 달라집니다. 가져오기에 성공했다는 것은 파일을 인식했다는 뜻일 뿐 모든 노드에 연결할 수 있다는 의미는 아닙니다. 테스트할 때는 먼저 사용할 설정을 선택하고 프록시 그룹이 사용 가능한 노드를 가리키는지 확인한 뒤 연결 기록을 살펴보세요.

구독 URL에는 접근 인증 정보가 포함되는 경우가 많아 유출되면 다른 사람이 설정을 열람할 수 있습니다. 문제를 확인할 때는 민감한 내용을 가린 오류 정보, 필드 이름, 작업 단계를 공유하세요. 전체 구독 주소나 비밀번호가 포함된 설정 파일은 올리지 마세요. 형식 변환이 필요하다면 변환 서비스가 링크를 어떻게 처리하는지도 먼저 확인하세요. 단순 노드 목록만으로는 원본 설정의 정책 그룹과 전체 규칙을 복원할 수 없습니다.

업데이트 및 문제 해결 기본 순서

클라이언트, 커널, 구독 업데이트는 서로 다른 문제를 해결합니다. 인터페이스가 충돌하면 클라이언트 로그를, 프로토콜이 지원되지 않으면 커널 문서를, 노드가 작동하지 않으면 구독 상태를 먼저 확인하세요. 소프트웨어 업그레이드, DNS 교체, 포트 수정, TUN 활성화를 한꺼번에 하면 원래 쉽게 찾을 수 있던 문제도 복잡해집니다. 정상 작동하는 설정을 저장하고 한 번에 한 항목씩 조정하는 편이 안전합니다.

오픈 소스 저장소에서 커밋 내역, 이슈 토론, 릴리스 정보를 확인할 수 있지만 토론에 나온 임시 설정을 일반적인 해결책으로 그대로 적용해서는 안 됩니다. 자신의 시스템, 클라이언트, 오류 위치를 대조해야 해당 조언이 맞는지 판단할 수 있습니다. 아래에는 소스 코드를 읽거나 구현을 살펴보려는 사용자를 위해 mihomo 원본 저장소를 복제하는 명령을 안내합니다. 일반 사용자는 그래픽 클라이언트만 설치하면 되며, 먼저 빌드 방법을 익힐 필요는 없습니다.

mihomo 원본 소스 코드 보기

MetaCubeX / mihomo ↗ · 소스 코드, 이슈 기록, 릴리스 정보

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

문제가 발생한 단계부터 확인

웹페이지가 열리지 않으면 먼저 기존 네트워크가 정상인지 확인한 뒤 클라이언트에 해당 대상의 연결 기록이 있는지 살펴보세요. 기록이 전혀 없으면 시스템 프록시, 앱 자체의 프록시 설정, TUN 라우팅부터 확인하세요. 기록은 있지만 연결에 실패하면 선택한 프록시 그룹과 노드를 확인합니다. 연결은 성공했지만 잘못된 출구를 사용한다면 규칙 순서와 도메인 인식을 다시 살펴보세요. 이 순서대로 확인하면 ‘전역’을 반복해서 전환하는 것보다 원인을 쉽게 찾을 수 있습니다.

DNS도 연결 경로의 일부입니다. Fake-IP는 매핑된 주소를 이용해 커널이 연결을 도메인과 연결하도록 돕는 기능이지, 켜기만 하면 모든 문제가 해결되는 만능 옵션은 아닙니다. LAN 서비스, 다른 VPN, 특정 앱과 함께 사용할 때는 실제 증상에 따라 필터링과 DNS 설정을 조정하세요. 프로토콜 선택, 모바일 기기의 배터리 사용, 커널 호환성은 프로토콜 안내서에서 더 확인할 수 있습니다. 구체적인 설정 방법은 빠른 시작 가이드를 참고하세요.

최근 가이드

TUN, 시스템 프록시 및 시작 오류 해결

전체 글 보기 →

기본 연결을 마친 뒤 실제 문제에 맞춰 확인하세요. 트래픽 처리 범위가 맞지 않으면 시스템 프록시와 TUN을 살펴보고, 프로그램이 열리지 않으면 시작 로그부터 확인하세요. 연결 문제 해결 방법으로 설정 문법 오류를 고치려 하지 말고, 설정을 선택하지 않은 상태에서 노드만 계속 바꾸지 마세요.

고급 설정

Clash 가상 네트워크 인터페이스로 전체 트래픽 처리하기: 활성화 단계, 드라이버 권한, DNS 하이재킹 안내

가상 네트워크 인터페이스가 트래픽을 받는 원리를 설명하고 Windows, macOS, Linux, Android별 활성화 방법, 서비스 권한, stack 옵션, DNS 하이재킹을 안내합니다. 먼저 플랫폼과 권한을 확인한 뒤 변경할 설정을 판단하세요.

가상 네트워크 인터페이스 설정 보기 →
고급 설정

시스템 프록시와 TUN 작동 방식 비교: 일부 프로그램이 프록시를 사용하지 않는 이유

앱이 프록시 설정을 직접 읽는 방식과 가상 네트워크 인터페이스가 패킷을 받는 방식을 비교해 트래픽 처리 범위와 DNS 처리의 차이를 설명합니다. 브라우저는 연결되지만 게임이나 명령줄은 작동하지 않을 때는 연결이 커널에 전달됐는지 먼저 확인하세요.

두 가지 트래픽 처리 방식 비교 →
Clash 다운로드