오픈 소스 클라이언트 · 구독 및 규칙 지속 업데이트

Clash 클라이언트 다운로드 구독 가져오기 및 업데이트 가이드

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고, 구독 가져오기부터 규칙 업데이트까지 설정과 연결 상태를 단계별로 확인하세요.

  • 오픈 소스 생태계
  • 플랫폼 선택
  • 중국어 설정 안내

기기 운영체제별 다운로드 보기

구독·규칙·네트워크 설정

설정 출처부터 연결 경로까지, 문제에 맞는 항목을 찾아보세요.

한 번 가져온 뒤 업데이트 출처별로 관리

클라이언트의 설정 페이지에 구독 URL을 붙여넣어 가져온 다음, 해당 설정을 현재 사용 중으로 선택하세요. 원격 설정을 업데이트하면 YAML을 다시 가져오며, 프록시 제공자와 규칙 제공자는 각각 설정된 간격에 따라 새로고침할 수 있습니다. 이 세 가지 업데이트는 서로 다릅니다. 로컬 파일은 오프라인 백업에 편리하지만 대개 원격 변경 사항이 자동 반영되지 않습니다. 다운로드한 설정을 직접 수정하면 다음 새로고침 때 덮어쓰일 수 있으므로, 변경 사항을 유지하려면 클라이언트의 오버라이드 또는 병합 기능을 사용하세요. 업데이트에 실패하면 URL이 여전히 유효한지 확인한 뒤 요청 로그와 구독을 가져올 때 사용한 네트워크 경로를 살펴보세요.

구독 가져오기 단계 보기 → 
# 설정 파일의 프록시 제공자 예시
# interval 단위는 초
proxy-providers:
  remote:
    type: http
    url: "https://example.com/proxies.yaml"
    path: ./providers/remote.yaml
    interval: 86400
클라이언트 목록

Clash 전 플랫폼 다운로드

전체 클라이언트 보기 →

운영체제로 먼저 필터링한 뒤 프로세서 아키텍처와 설치 패키지 형식을 확인하세요. 클라이언트는 인터페이스와 시스템 연동, 설정 관리를 담당하고 코어는 프로토콜 처리와 규칙 실행을 담당합니다. 인터페이스가 비슷해도 지원하는 설정 항목까지 같다는 뜻은 아닙니다. 이전하기 전에 구독 출처와 오버라이드 파일을 보관하고, 기존 작업 설정을 바로 덮어쓰지 마세요.

Windows

데스크톱에서 구독과 시스템 프록시, 시작 프로그램을 관리하기에 적합합니다. Clash Plus, Clash Verge Rev 등의 인터페이스와 코어 지원 여부를 비교한 다음 운영체제 요구 사항에 맞춰 설치하세요.

처음 실행하면 설정을 가져오고 브라우저 요청이 정상적으로 처리되는지 확인하세요. 필요한 경우에만 서비스 권한과 TUN을 설정합니다. 기존 클라이언트를 남겨 둔다면 두 프로그램이 동시에 시스템 프록시를 설정하거나 같은 포트를 점유하지 않도록 주의하세요.

다운로드 페이지로 이동

macOS

다운로드 전에 Apple Silicon과 Intel 프로세서를 구분하세요. 시스템 프록시, 메뉴 막대 조작, 백그라운드 서비스 지원은 클라이언트마다 다르므로 기기 아키텍처에 맞는 설치 패키지를 선택해야 합니다.

클라이언트를 바꾼 뒤에는 시스템 네트워크 프록시 설정을 다시 확인하세요. 이전 설정이 자동으로 삭제된다고 가정하면 안 됩니다. 터미널이나 다른 앱의 트래픽을 처리하려면 해당 프로그램의 프록시 환경 또는 TUN 상태를 별도로 확인해야 합니다.

다운로드 페이지로 이동

Android

프로세서 아키텍처에 맞는 설치 패키지를 고르고 클라이언트의 VPN 트래픽 처리 방식도 확인하세요. 처음 연결할 때는 시스템 안내에 따라 권한을 허용한 뒤, 가져오기만 완료된 것이 아니라 설정이 선택되어 있는지 확인해야 합니다.

백그라운드 업데이트는 배터리 최적화와 백그라운드 네트워크 권한, 프로세스 상태에 영향을 받습니다. 구독이 예약한 시간에 새로고침되지 않으면 먼저 앱을 열어 수동 업데이트를 테스트한 다음 시스템이 클라이언트의 백그라운드 실행을 제한하는지 확인하세요.

다운로드 페이지로 이동

iOS

Clash Plus의 App Store 페이지와 공식 자료를 확인하세요. 모바일 운영체제의 네트워크 확장은 클라이언트가 관리하므로 구독 가져오기 방법과 업데이트 옵션, 설정 호환성은 앱 내 안내를 따르세요.

가져온 뒤 먼저 설정을 선택하고 시스템 안내에 따라 VPN 연결을 허용하세요. 네트워크를 전환한 뒤 접속 문제가 생기면 분기 설정을 바꾸기 전에 확장 연결 상태와 설정 리소스 업데이트 결과부터 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev와 FlClash를 비교하고 배포판에 맞는 DEB 또는 RPM 패키지를 선택하세요. 그래픽 환경이 없는 서버와 라우터에는 보통 코어를 직접 배포하고 서비스와 권한을 별도로 설정합니다.

설치가 완료되어도 프로그램이 실행된다는 뜻일 뿐입니다. 의존성, 포트 수신 상태, 시스템 프록시 연동 여부를 추가로 확인해야 합니다. 서비스로 실행한다면 작업 디렉터리와 설정 경로, 리소스 파일의 쓰기 권한도 점검하세요.

다운로드 페이지로 이동

플랫폼 아이콘: Windows, Apple, Android는 Simple Icons 벡터를 사용하고 Linux Tux는 Font Awesome, CC BY 4.0 벡터를 사용합니다.

진행 순서

구독을 가져온 뒤 확인할 세 가지

전체 가이드 보기 →

클라이언트 설치, 설정 가져오기, 트래픽 가로채기는 서로 별개의 단계입니다. 아래 순서대로 확인하면 구독 가져오기 문제와 앱 연결 문제를 구분할 수 있어 처음부터 모든 고급 옵션을 바꿀 필요가 없습니다.

  1. 설정을 가져와 현재 사용 중으로 지정

    설정 또는 구독 페이지를 열고 설정 제공자가 준 URL을 붙여넣으세요. 로컬 YAML 파일만 있다면 파일 가져오기를 사용합니다. 클라이언트가 파싱을 마칠 때까지 기다린 뒤 해당 설정을 선택하고 구문 오류나 지원되지 않는 항목이 있는지 확인하세요. 가져오기에 성공했다고 바로 활성화된 것은 아닙니다. 현재 사용 중 표시와 로그에서 실제로 불러왔는지 확인해야 합니다.

  2. 규칙 모드와 트래픽 처리 방식 선택

    설정에 이미 있는 정책 그룹 구조를 유지하고 먼저 규칙 모드를 사용하세요. 데스크톱에서는 시스템 프록시부터 설정하고, 모바일에서는 안내에 따라 VPN 연결을 허용합니다. 시스템 프록시를 사용하지 않는 앱이라면 TUN이나 앱 자체 프록시 설정을 고려하세요. 한 번에 한 항목만 바꾸고 변경 전 상태를 기록해 두면 문제가 생겼을 때 되돌리기 쉽습니다.

  3. 연결을 확인한 다음 업데이트 간격 설정

    대상 웹페이지나 앱을 다시 열고 연결 페이지에서 요청이 코어에 전달되는지, 어떤 규칙과 정책이 적용됐는지 확인하세요. 그런 다음 구독을 한 번 수동으로 업데이트해 가져오기 경로가 정상인지 확인한 뒤 클라이언트가 지원하는 자동 업데이트를 활성화합니다. 인터페이스의 분 단위와 설정 항목의 초 단위를 각각 확인해 리소스를 지나치게 자주 업데이트하지 않도록 하세요.

오픈 소스 생태계와 유지 관리

클라이언트·코어·구독은 각각 업데이트됩니다

Clash 생태계의 발전 과정

원본 Clash는 이 생태계에서 널리 쓰이는 YAML 설정 형식과 규칙 표현 방식을 정립했습니다. Clash Meta는 이를 바탕으로 프로토콜과 규칙, 네트워크 스택 기능을 확장했으며 이후 mihomo라는 이름으로 유지 관리되고 있습니다. 튜토리얼에는 이전 이름이 계속 등장할 수 있지만, 설정 항목의 지원 여부는 클라이언트 이름이 아니라 실제 사용하는 코어의 문서를 기준으로 판단하세요.

그래픽 클라이언트는 보통 코어와 플랫폼 기능을 함께 제공합니다. 코어는 요청을 처리하고, 클라이언트는 구독과 시스템 프록시, 로그, 권한을 관리합니다. 같은 설정도 클라이언트에 따라 가져오기 과정이 다를 수 있으며, 일부 클라이언트는 실행용 설정을 생성하거나 병합하기도 합니다. 따라서 문제를 해결할 때는 클라이언트 이름과 코어 종류, 실제 적용된 설정 항목을 함께 기록해야 합니다.

이 사이트 자료와 상위 프로젝트의 역할

Clash 리소스 허브는 다운로드 경로와 사용 단계, 용어 관계를 정리하며 각 클라이언트 개발팀을 대표하지 않습니다. 프로그램 기능 변경과 플랫폼 제한은 상위 프로젝트의 안내를 함께 확인하세요. 다운로드 목록은 운영체제와 패키지 형식을 선택하도록 돕고, 가이드는 설정 항목과 일반적인 작업의 관계를 설명합니다. 생태계의 모든 앱을 같은 소프트웨어로 취급하지 않습니다.

프로그램 업데이트와 구독 업데이트는 다릅니다

클라이언트 업데이트는 인터페이스와 시스템 연동, 내장 코어를 바꿀 수 있습니다. 코어 업데이트는 프로토콜 처리와 설정 호환성에 영향을 주며, 구독 업데이트는 설정이나 리소스를 다시 가져옵니다. 프로그램을 업그레이드해도 구독 유효 기간이 자동 연장되지 않고, 구독을 새로고침해도 오래된 코어에 새 프로토콜 기능이 추가되지는 않습니다. 문제를 해결할 때는 먼저 어느 계층에서 오류가 발생했는지 확인한 뒤 적절한 작업을 선택하세요.

변경 내역을 추적할 수 있는 방식으로 관리하세요

업데이트 전에 로컬 오버라이드와 정상 작동이 확인된 설정을 백업하고, 업데이트 안내에서 설정 변경 사항을 확인하세요. 업데이트 후에는 시작 로그를 살펴본 다음 DNS와 규칙 매칭, 앱 연결을 확인합니다. 문제가 생기면 임시 변경을 계속 더하기보다 이전 설정과 비교해 원인을 찾으세요. 규칙 리소스를 변경할 때도 출처를 기록해 최종 설정만 남아 이유를 알 수 없게 되는 일을 피하세요.

원본 코어와 Meta, mihomo의 관계를 더 자세히 알아보려면 코어의 발전과 기능 비교를 읽어보세요. 라우터나 서버에 배포할 때는 실행 플랫폼의 네트워크 및 권한 안내도 함께 확인하세요.

mihomo 코어 소스 코드

소스 코드와 릴리스 안내, 이슈 토론은 MetaCubeX/mihomo에서 확인할 수 있습니다. 저장소를 복제해 읽거나 개발에 참여하는 것만으로 클라이언트 설치가 완료되는 것은 아닙니다. 그래픽 인터페이스만 필요하다면 플랫폼에 맞는 설치 패키지를 선택하세요.

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

최신 기술 문서

첫 사용부터 단계별 문제 해결까지

전체 문서 보기 →

기본 설정을 마친 뒤 구체적인 문제에 맞는 가이드를 확인하세요. 속도 문제는 비교 테스트부터, 라우터 배포는 트래픽 유입 경로부터, 초보자 문제는 시스템 프록시와 모드, 포트 점검부터 시작하면 됩니다. 문제마다 필요한 근거가 다르므로 같은 설정을 반복해서 적용하지 마세요.

구독 업데이트 실패: 먼저 링크에서 설정을 정상적으로 받아오는지 확인하고 요청 로그를 살펴보세요. 구독 업데이트 문제 해결 안내에 따라 접속 오류와 파싱 오류, 리소스 업데이트 오류를 구분할 수 있습니다.

DNS 및 Fake-IP: 먼저 DNS 요청이 어디에서 시작되는지 확인한 뒤 트래픽 가로채기와 필터 목록을 조정할지 판단하세요. 개념이 익숙하지 않다면 먼저 Fake-IP 용어 설명을 읽고 전체 안내서를 참고해 설정을 변경하세요.