Clash 리소스 허브 · 클라이언트 및 설정 안내

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

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

다중 플랫폼 클라이언트, 설정 항목, 프로토콜 안내를 정리했습니다. 구독 가져오기부터 규칙 분기까지 순서대로 살펴보세요.

  • YAML 설정
  • mihomo 커널
  • 한국어 문서

클라이언트 다운로드 / 기기별 선택

모든 플랫폼용 Clash 클라이언트

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. GUI 클라이언트는 설정 관리, 시스템 프록시, 로그 확인을 담당하고 커널은 프로토콜 연결과 트래픽 분기를 처리합니다. 둘은 같은 설치 파일이 아닙니다. 처음 사용한다면 GUI 클라이언트부터 시작하고, 서버나 라우터에 배포할 때는 독립 커널을 고려하세요.

Windows

데스크톱 브라우저와 개발 도구, 일상 업무에 적합합니다. Clash Plus, Clash Verge Rev, FlClash 중에서 시작할 수 있으며, 설치 전 시스템 정보에서 아키텍처를 확인하세요. 시스템 프록시는 프록시 설정을 따르는 앱에 적합합니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 서비스와 권한 요건을 확인하세요.

설치 후 설정을 가져와 프록시 그룹을 선택하고 로컬 수신 포트를 확인한 다음 시스템 프록시를 켜세요. 다른 네트워크 도구도 함께 실행 중이라면 포트가 겹치는지 확인해야 합니다. 여러 프로그램이 시스템 설정을 반복해서 덮어쓰는 문제를 예방할 수 있습니다.

다운로드 페이지

macOS

Apple Silicon용과 Intel용 설치 파일을 구분해 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 GUI를 제공하며, 보관된 클라이언트는 운영체제 호환성을 추가로 확인해야 합니다. 앱을 응용 프로그램 폴더로 옮긴 뒤 시스템 안내에 따라 필요한 권한을 허용하세요.

메뉴 막대의 연결 상태와 시스템 프록시 설정을 각각 확인하세요. 클라이언트를 종료하기 전에 프록시 설정을 복원하면 브라우저가 종료된 로컬 포트에 계속 연결하는 상황을 줄일 수 있습니다. 가상 네트워크 인터페이스를 사용하는 경우 관련 백그라운드 서비스도 정상적으로 실행되는지 확인하세요.

다운로드 페이지

Android

휴대전화와 태블릿에서는 Clash Plus, Clash Meta for Android, FlClash, Surfboard의 설정 지원 범위를 비교해 보세요. 설치 파일은 기기 아키텍처에 맞아야 하고 설정 형식도 클라이언트와 호환되어야 합니다. 구독 링크를 가져올 수 있다는 이유만으로 모든 설정 항목이 적용된다고 볼 수는 없습니다.

처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 배터리 절약을 위한 백그라운드 제한은 연결 유지에 영향을 줄 수 있으므로 기기 설정에서 필요한 백그라운드 활동을 허용하세요. 일반적으로 한 번에 하나의 앱만 시스템 VPN을 사용할 수 있으니 도구를 바꾸기 전에 기존 연결을 중지해야 합니다.

다운로드 페이지

iOS

App Store에서 Clash Plus를 확인할 수 있으며, 클라이언트 공식 사이트는 clashplus.io입니다. 설정을 가져온 뒤 시스템 안내에 따라 VPN 구성을 추가하고 클라이언트에서 정책을 선택하세요. 앱 설치, 구독 가져오기, 연결 시작은 각각 별도의 단계입니다.

데스크톱 설정의 파일 경로, 외부 제어 인터페이스, 가상 네트워크 인터페이스 매개변수는 모바일 운영체제에서 그대로 사용할 수 없을 수 있습니다. 설정을 옮기기 전에 지원 항목을 확인하고 필요한 프록시와 규칙만 남긴 다음, 클라이언트의 연결 기록으로 실제 트래픽 경로를 확인하세요.

다운로드 페이지

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판의 패키지 형식에 맞춰 설치할 수 있습니다. 서버, 컨테이너, 라우터에서는 mihomo를 직접 실행할 수 있지만 설정 경로, 프로세스 관리, 서비스 권한, 네트워크 라우팅을 직접 구성해야 합니다.

설치 파일 형식과 프로세서 아키텍처가 모두 맞아야 합니다. 독립 커널에는 완전한 데스크톱 인터페이스가 포함되지 않으며 시스템 프록시가 자동으로 활성화되는 것도 아닙니다. 먼저 로그와 수신 주소를 확인한 뒤 앱이나 운영체제 요구사항에 맞춰 프록시 진입점을 설정하세요.

다운로드 페이지

클라이언트 이름이 비슷해도 유지 관리 상태, 커널 기능, 구독 형식까지 같은 것은 아닙니다. 다운로드 페이지에서 플랫폼별 클라이언트, 설치 파일 종류, 시스템 요구사항을 확인할 수 있습니다. 프로토콜 지원과 커널 계열의 차이는 프로토콜 매뉴얼에서 확인한 뒤 인터페이스와 기능을 선택하세요.

전체 클라이언트 보기 →

config.yaml / 설정 블록 색인

프록시 그룹·규칙·네트워크 설정

설정 파일은 노드 소스, 정책 선택, 규칙 매칭, 트래픽 처리 항목을 서로 다른 계층으로 나눕니다. 문제가 생기면 먼저 어느 계층의 문제인지 파악한 뒤 해당 항목을 수정하세요. 아래 예시는 구조를 이해하기 위한 것으로, 구독이나 원격 노드를 포함한 완성 설정이 아닙니다. 사용 전 현재 클라이언트와 커널의 지원 범위를 확인하세요.

출구 선택과 트래픽 분기 규칙 분리

프록시 그룹은 여러 출구를 하나의 이름으로 묶어 규칙에서 참조할 수 있게 합니다. 수동 선택 그룹에는 select를 사용하고 자동 탐지 방식의 정책에는 해당 탐지 매개변수가 필요합니다. 규칙에는 그룹 이름을 지정하고 그룹 안에서 실제 출구를 선택하므로, 출구를 바꿀 때 보통 규칙을 다시 작성할 필요가 없습니다. 아래는 직접 연결을 사용한 최소 예시입니다. 원격 노드를 추가한다면 노드 이름이 실제로 존재해야 합니다. 구독을 갱신한 뒤 기존 선택 항목이 삭제되었다면 갱신 성공 여부만 확인하지 말고 그룹 안의 선택 항목도 다시 살펴보세요.

proxy-groups:
  - name: 노드 선택
    type: select
    proxies:
      - DIRECT
지원 클라이언트: Clash 설정을 지원하는 GUI 클라이언트

설정을 읽을 때는 들여쓰기와 항목의 계층을 먼저 확인한 뒤 값을 살펴보세요. YAML에서 같은 항목을 중복으로 선언하거나 목록의 계층이 잘못되거나 참조 이름이 일치하지 않으면 설정을 불러오지 못할 수 있습니다. 클라이언트에서 파일을 열 수 있다는 것은 해당 처리 단계가 통과되었다는 뜻일 뿐, 모든 규칙이 예상대로 작동한다는 의미는 아닙니다. 연결 기록에서 매칭된 규칙과 최종 정책을 확인하세요.

구독 가져오기부터 시작하기 →

오픈소스 생태계 / 출처와 범위

Clash와 mihomo 커널의 관계

클라이언트가 적합한지 판단할 때는 프로젝트 유지 관리 상태, 실제로 탑재된 커널, 설정 및 프로토콜 지원 범위를 확인해야 합니다. 이 사이트는 자료와 문서를 정리하며 각 클라이언트 개발팀을 대표하거나 원격 프록시 서비스를 제공하지 않습니다. 앱, 커널, 설정 출처를 각각 구분해야 하며 하나의 프로젝트 이름으로 전체 생태계를 지칭해서는 안 됩니다.

프로젝트의 역사와 유지 관리 상태

Clash는 YAML로 프록시, 정책 그룹, 트래픽 분기 규칙을 정의하는 설정 방식을 구축했고 이후 여러 운영체제용 GUI 클라이언트가 등장했습니다. 원본 프로젝트의 업데이트가 중단된 뒤에도 기존 설치 파일이 실행될 수 있지만, 정상 실행이 지속적인 프로토콜 호환성 개선이나 오류 수정을 보장하지는 않습니다. 클라이언트를 고를 때는 현재도 관리되는 프로젝트인지와 릴리스 노트를 먼저 확인하세요. 기존 클라이언트는 익숙한 이름 때문이 아니라 명확한 호환성 요구가 있을 때 유지하는 편이 좋습니다.

유지 관리 상태를 화면 디자인만으로 판단해서도 안 됩니다. 인터페이스 개선, 커널 업그레이드, 운영체제 호환성 수정은 서로 다른 작업이며 한 번의 릴리스에서 일부만 업데이트될 수 있습니다. 업그레이드 후 동작이 달라졌다면 클라이언트 이름, 사용 중인 커널, 구체적인 설정을 기록하고 프로젝트 설명과 대조하세요. 전체 설정을 곧바로 바꾸는 것보다 원인을 재현하기 쉽습니다.

GUI 클라이언트와 커널의 역할

mihomo는 Clash Meta의 개발 방향을 이어받아 프로토콜 처리, 규칙 매칭, DNS, 네트워크 스택 등 핵심 기능을 담당합니다. GUI 클라이언트는 그 위에 구독 관리, 정책 선택, 시스템 서비스, 로그 화면을 제공합니다. 같은 커널을 사용하는 클라이언트라도 설정 병합 방식, 기본 옵션, 권한 관리 절차가 다를 수 있으므로 한 클라이언트의 메뉴 경로를 다른 클라이언트에 그대로 적용하면 안 됩니다.

프로토콜을 선택할 때는 서버 측 요구사항과 클라이언트 커널의 지원 여부를 함께 확인하세요. 설정에 프로토콜 이름을 적어도 구형 커널에 기능이 추가되는 것은 아닙니다. TLS, UDP, 전송 계층 설정도 양쪽이 일치해야 합니다. 프로토콜 매뉴얼에서 주요 프로토콜의 설계상 차이와 커널별 지원 범위를 확인할 수 있습니다. 클라이언트를 바꾸거나 구독을 이전하기 전에 참고하세요.

구독·노드·규칙의 출처

구독 링크는 설정이나 노드 정보를 가져오는 데 사용되며 클라이언트 자체가 아닙니다. 설정에는 프록시 그룹, 원격 규칙, DNS 설정이 함께 들어 있을 수도 있고 노드 목록만 포함될 수도 있습니다. 가져온 뒤 형식을 확인하고 필요한 정책을 추가할지 결정하세요. 출처가 불분명한 Clash 무료 노드나 공개 설정은 서비스 제공자와 설정 내용을 검토해야 합니다. 가져오기에 성공했다고 해서 서비스의 신뢰성이 입증되는 것은 아닙니다.

Clash VPN 구독 링크는 보통 별도의 접속 주소를 사용하며 주소에 포함된 매개변수가 계정 권한과 연결될 수 있습니다. 문제 화면을 공유하거나 로그를 제출하기 전에 구독 주소, 계정 식별 정보, 노드 인증 정보를 삭제하세요. 문제를 확인할 때는 오류 유형과 관련 항목 이름, 필요한 네트워크 환경만 남기면 됩니다. 개인 설정 전체를 공개 게시물에 올리지 마세요.

업데이트 방식과 이전 순서

앱, 커널, 구독, 규칙 데이터 업데이트는 서로 독립적으로 이루어집니다. 구독을 새로고침해도 앱이 자동으로 업데이트되지 않으며 앱 업데이트가 노드 목록 새로고침을 뜻하지도 않습니다. Clash GeoIP 업데이트는 관련 지리 규칙의 데이터 출처에 영향을 줄 뿐 모든 도메인 규칙을 갱신하지는 않습니다. 실제 적용 여부는 설정에서 사용하는 데이터 형식, 파일 위치, 규칙 유형에 따라 달라집니다.

이전하기 전에 사용 가능한 설정을 보관하고 프록시 포트, 선택한 프록시 그룹, 트래픽 처리 방식을 기록하세요. 앱을 업그레이드한 뒤에는 기존 모드로 먼저 연결을 확인하고 사용자 지정 DNS, 규칙 덮어쓰기, TUN 설정을 하나씩 복원하세요. Clash 노드 지연 시간 테스트는 지정된 테스트 대상과 방식에 따른 응답만 보여 줍니다. 동영상 전송, 다운로드 속도, 모든 사이트의 사용 가능 여부를 단독으로 판단하는 지표는 아닙니다.

처음 사용할 때 확인할 순서

먼저 클라이언트를 설치하고 구독을 가져와 설정이 정상적으로 로드되는지 확인하세요. 다음으로 프록시 그룹에 사용할 수 있는 출구가 있는지 확인하고 규칙 모드로 전환합니다. 이어서 시스템 프록시 설정이나 모바일 VPN 권한을 확인하고 명확한 테스트 대상으로 접속한 뒤 연결 기록에서 적용된 규칙과 정책을 살펴보세요. 연결됨으로 표시되는데 접속이 안 된다면 모든 스위치를 한꺼번에 바꾸지 말고 DNS, 규칙, 출구, 로컬 트래픽 처리 중 어디에서 문제가 생겼는지 구분하세요.

시스템 프록시와 TUN을 반드시 함께 켤 필요는 없습니다. 브라우저와 프록시 설정을 따르는 앱만 프록시를 사용하면 된다면 시스템 프록시부터 확인하세요. 앱이 직접 연결을 만들고 시스템 설정을 따르지 않을 때 가상 네트워크 인터페이스 방식을 고려할 수 있습니다. 클라이언트를 종료한 뒤 브라우저에 문제가 생기면 시스템에 로컬 프록시 주소가 남아 있는지 확인하세요. 전체 사용 절차는 Clash 사용 가이드에서, 복잡한 프로토콜과 커널 호환성 문제는 프로토콜 매뉴얼에서 확인할 수 있습니다.

기술 노트 / 최근 정리

배포 및 연결 설정 노트

구체적인 사용 환경에 맞춰 설정 경로, 권한 요건, 확인 순서를 정리합니다. 먼저 가이드에 따라 기본 연결을 구성한 뒤 실제 문제에 해당하는 노트를 살펴보세요. 라우터 배포와 가상 네트워크 인터페이스를 통한 트래픽 처리는 시스템 네트워크 설정을 변경하므로, 변경 전 상태를 기록해 두면 항목별로 확인하고 복원하기 쉽습니다.

전체 글 보기 →
클라이언트 다운로드