SUBSCRIPTION CONFIG MANUAL

Clash 구독 가이드
클라이언트 설정 및 구독 가져오기

Clash 다운로드 입문 가이드 보기

기기에 맞는 클라이언트를 선택한 뒤 구독 링크 가져오기, 정책 그룹 확인, 트래픽 라우팅을 순서대로 진행하세요. 각 단계는 클라이언트의 실제 메뉴와 확인 가능한 상태에 대응합니다.

설정 흐름 확인 가능 영구 무료 오픈 소스 멀티플랫폼 클라이언트 중국어 사용 문서

구독 주소는 설정을 전달하는 역할만 합니다. 가져온 뒤에는 현재 설정, 정책 그룹, 프록시 모드와 시스템 라우팅 상태를 확인해야 합니다. 연결 문제가 발생하면 이 흐름을 단계별로 점검하는 편이 클라이언트를 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다.

PLATFORM OUTPUT

기기에 맞는 클라이언트 다운로드 페이지로 이동

먼저 운영체제를 확인한 다음 현재 기기 아키텍처에 맞고 계속 유지 관리되는 클라이언트를 선택하세요. 홈페이지의 플랫폼별 링크는 해당 페이지로 이동하는 역할만 하며, 설치 파일·시스템 요구 사항·클라이언트별 차이는 다운로드 페이지에서 확인합니다.

DESKTOP / 01

Windows

일상적인 데스크톱 환경에 적합합니다. 다운로드하기 전에 “설정 → 시스템 → 시스템 정보”에서 x64 아키텍처를 확인한 뒤 Clash Plus, Clash Verge Rev, FlClash 같은 그래픽 클라이언트 중에서 선택하세요. 설치 후에는 설정 페이지에서 구독을 가져오고 시스템 프록시 또는 TUN 모드를 별도로 켜야 합니다. 클라이언트가 실행 중이라고 해서 트래픽이 이미 라우팅되는 것은 아닙니다.

다운로드 페이지로 이동

DESKTOP / 02

macOS

먼저 “이 Mac에 관하여”에서 Apple Silicon과 Intel 프로세서를 구분하세요. 두 종류의 설치 파일은 서로 바꿔 사용할 수 없습니다. 처음 실행하면 앱 실행, 네트워크 확장 또는 관리자 권한을 승인하라는 메시지가 표시될 수 있습니다. 구독을 성공적으로 가져온 뒤에는 먼저 시스템 프록시로 브라우저 트래픽을 확인하고, 터미널·개발 도구·기타 앱까지 적용해야 할 때 TUN 사용 여부를 결정하세요.

다운로드 페이지로 이동

MOBILE / 03

Android

최근 출시된 대부분의 기기는 ARM64 설치 파일을 사용할 수 있습니다. 아키텍처를 확인하기 어렵다면 다운로드 페이지에서 범용 패키지와 다른 아키텍처 안내를 확인하세요. Android 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 라우팅하며, 처음 연결할 때 VPN 권한 승인 메시지가 표시됩니다. 구독을 가져온 뒤 현재 설정, 정책 그룹 선택, 백그라운드 실행 권한을 확인해 배터리 절전 정책으로 연결이 조기에 종료되지 않도록 하세요.

다운로드 페이지로 이동

MOBILE / 04

iOS

iPhone과 iPad에서는 App Store를 통해 Clash Plus를 설치합니다. 구독을 가져올 때는 전체 링크를 복사해 앱 안에서 추가하거나, 제공자가 안내한 이동 링크를 사용할 수 있습니다. 처음 연결하려면 VPN 구성 추가를 허용해야 합니다. 설정이 업데이트되었는데 정책이 바뀌지 않았다면 시스템 상태 표시줄의 VPN 아이콘만 보지 말고 앱으로 돌아가 현재 사용 중인 설정 파일과 정책 그룹을 확인하세요.

다운로드 페이지로 이동

DESKTOP / 05

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있으며, 서버·소프트 라우터·자동화 환경에는 Mihomo 코어를 직접 실행하는 방식이 더 적합합니다. 그래픽 클라이언트를 사용할 때도 배포판에 맞는 패키지 형식인지 확인해야 합니다. 코어를 직접 사용할 경우에는 설정 파일 경로, 시작 인수, 서비스 권한과 로그를 직접 관리해야 합니다. 두 방식의 메뉴와 절차는 다르므로 튜토리얼 단계를 섞어 사용하지 마세요.

다운로드 페이지로 이동

SELECTION CHECK

플랫폼이 같아도 유지 관리 상태와 사용 방식에 따라 클라이언트를 선택해야 합니다

그래픽 클라이언트는 트레이 메뉴, 정책 그룹 선택, 시스템 프록시 전환, 설정 업데이트 화면이 필요한 데스크톱 사용자에게 적합합니다. 코어 프로그램은 명령줄, 서비스 관리와 YAML 설정에 익숙한 서버 또는 라우터 환경에 더 알맞습니다. 오래된 클라이언트가 실행될 수는 있지만 유지 관리가 중단되면 새로운 코어 필드와 운영체제 변경 사항을 계속 지원하지 못합니다. 이전할 때는 구독 주소, 오버라이드 내용과 사용자 지정 규칙을 먼저 보존한 뒤 새 클라이언트에서 라우팅 방식을 다시 확인하세요.

기기 아키텍처는 별도로 확인해야 합니다. Windows는 보통 x64이고, macOS는 Apple Silicon과 Intel을 구분해야 하며, Android에는 ARM64·ARM·범용 패키지가 있을 수 있습니다. 설치 파일 이름의 아키텍처 표기가 기기와 일치해야 합니다. 다운로드 후 설치되지 않으면 출처가 다른 같은 이름의 설치 파일을 계속 시도하지 말고 먼저 아키텍처와 시스템 버전을 확인하세요.

전체 클라이언트 및 시스템 요구 사항 보기 →

RECEIVE CHAIN

구독 입력부터 트래픽 출력까지

Clash 설정은 단일 스위치가 아닙니다. 구독 파싱, 정책 라우팅, DNS 처리와 자동 업데이트가 하나의 흐름에서 차례로 작동합니다. 왼쪽 메뉴에서 점검 항목을 전환할 수 있으며, 주홍색 표시는 현재 설명 위치를 나타냅니다.

CONFIG INPUT / CHANNEL 01

구독 링크가 먼저 로컬 설정으로 변환됩니다

클라이언트가 구독 주소에 접속하면 프록시 노드, 정책 그룹, 규칙과 포함된 DNS 필드를 읽어 로컬 설정으로 저장합니다. 가져오기에 성공했다는 것은 내용이 클라이언트에 기록되었다는 뜻일 뿐, 해당 설정이 현재 설정으로 지정되었거나 트래픽이 프록시 경로에 들어갔다는 의미는 아닙니다. 설정 이름, 업데이트 시간과 현재 선택 상태를 확인한 뒤 정책 그룹을 열어 노드 항목이 정상적으로 표시되는지 확인하세요.

가져온 뒤 내용이 비어 있다면 먼저 링크가 완전히 복사되었는지, 구독이 아직 유효한지, 클라이언트가 구독 주소에 접속할 수 있는지 확인하세요. 웹 브라우저에서 텍스트가 열린다고 해서 클라이언트의 파싱이 반드시 완료되는 것은 아닙니다. 응답 형식, 리디렉션 방식과 필드 호환성이 결과에 영향을 줍니다. 다시 가져오기 전에 수동 업데이트를 한 번 실행하고 클라이언트 로그의 설정 로드 메시지를 확인할 수 있습니다.

  • 구독 주소에 누락된 매개변수나 불필요한 공백이 없는지 확인
  • 새 설정이 현재 사용 항목으로 전환되었는지 확인
  • 노드, 정책 그룹과 규칙 섹션이 모두 로드되었는지 확인

OPEN SOURCE RECORD

오픈 소스 코어, 설정 경계와 업데이트 기준

Clash 생태계는 코어, 그래픽 클라이언트, 설정 형식과 커뮤니티 유지 관리 프로젝트로 구성됩니다. 클라이언트를 계속 사용해도 되는지 판단할 때는 화면 이름만 보지 말고 코드, 릴리스 기록, 코어 호환성과 운영체제 지원 여부를 확인해야 합니다.

HISTORY / 01

프로젝트 변화: 이름이 비슷한 클라이언트라도 유지 관리 상태는 다릅니다

Clash는 규칙 매칭, 정책 그룹과 YAML 설정 같은 일반적인 사용 방식을 처음 정립했고, 이후 여러 플랫폼을 위한 그래픽 클라이언트가 등장했습니다. 일부 기존 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환 코어와 새로운 클라이언트를 중심으로 기능을 이어가고 있습니다. 현재 “Clash 클라이언트”를 검색하면 이름이 비슷한 여러 프로그램이 표시되며, 서로 다른 코어·화면 계층·배포 경로를 사용할 수 있습니다.

선택할 때는 세 가지를 따로 확인해야 합니다. 클라이언트가 최근에도 유지 관리되고 있는지, 포함된 코어가 현재 구독 필드를 지원하는지, 설치 파일이 기기의 운영체제와 아키텍처에 맞는지입니다. 이전 튜토리얼의 메뉴 이름이 새 클라이언트와 다를 수도 있지만, 설정 흐름은 “설정 가져오기—정책 선택—라우팅 활성화—로그 확인” 순서로 이해할 수 있습니다.

ECOSYSTEM / 02

오픈 소스 생태계: 코어와 그래픽 인터페이스의 역할은 다릅니다

Mihomo 같은 호환 코어는 설정 파싱, 연결 생성, 규칙 실행, DNS 처리와 제어 인터페이스 제공을 담당합니다. Clash Plus, Clash Verge Rev, FlClash 같은 클라이언트는 코어 외부에서 설치, 설정 관리, 트레이 조작, 시스템 프록시 전환과 시각화된 로그를 제공합니다. 그래픽 클라이언트의 사용 편의성과 코어의 특정 설정 지원 여부는 서로 다른 문제입니다.

문제를 점검할 때도 경계를 구분해야 합니다. 설치 실패는 보통 시스템 또는 클라이언트 계층의 문제이고, YAML 오류는 설정 파싱 계층에 해당합니다. 웹사이트가 잘못 라우팅되면 규칙 또는 정책 계층을 확인해야 하며, 일부 앱이 프록시에 들어가지 않으면 시스템 프록시·TUN 라우팅 또는 앱 자체의 네트워크 구현과 관련된 경우가 많습니다. 문제가 발생한 계층을 명확히 하면 관련 없는 설정을 바꾸는 일을 줄일 수 있습니다.

CORE RELATION / 03

코어 관계: 화면 설정은 최종적으로 설정과 시작 매개변수로 변환됩니다

클라이언트의 “규칙 모드”, “LAN 허용”, “TUN 모드”, “DNS 강화 모드” 같은 스위치는 최종적으로 설정 필드에 기록되거나 코어 시작 매개변수로 변환됩니다. 화면에서 필드 세부 정보가 숨겨져도 하위 계층의 작동 방식이 바뀌는 것은 아닙니다. 클라이언트를 옮길 때 구독 주소는 보통 다시 가져오면 되지만, 사용자 지정 오버라이드·스크립트·규칙 제공자와 로컬 DNS 예외는 별도로 정리해야 합니다.

코어를 직접 사용하는 사용자는 설정 경로, 제어 포트, 서비스 시작과 로그 순환을 직접 관리해야 하며, 그래픽 클라이언트는 이 중 일부를 대신 관리합니다. 두 방식은 같거나 유사한 설정 개념을 사용하지만 메뉴와 실행 경로를 그대로 옮겨 사용할 수는 없습니다. 이 사이트의 입문 튜토리얼은 그래픽 클라이언트를 중심으로 하며, 설정 필드 페이지에서는 YAML 계층에 따라 코어가 실제로 읽는 내용을 설명합니다.

UPDATE POLICY / 04

업데이트 방식: 클라이언트·코어·구독 설정을 따로 처리하세요

클라이언트 업데이트는 화면, 설치와 시스템 호환성 문제를 수정하고, 코어 업데이트는 프로토콜·규칙·DNS·라우팅 기능을 확장하며, 구독 업데이트는 서비스 제공자가 전달한 설정만 새로 고칩니다. 세 가지 업데이트는 서로를 대신하지 않습니다. 연결이 정상이라면 버전을 따라가기 위해 모든 구성 요소를 자주 바꿀 필요는 없습니다. 호환성 문제가 생겼다면 먼저 어느 계층에서 변화가 발생했는지 확인하세요.

클라이언트를 업그레이드하기 전에 현재 구독 주소, 정책 그룹 선택과 로컬 오버라이드를 기록하는 것이 좋습니다. 업그레이드 후에는 먼저 설정이 로드되는지 확인하고 시스템 프록시 또는 TUN 권한이 유지되는지 점검하세요. 구독 자동 업데이트 후 정책이 바뀌었다면 클라이언트를 바로 되돌리지 말고 업데이트 시간과 설정 내용을 비교하세요. 로그의 필드 오류·권한 오류·네트워크 오류는 각각 따로 처리해야 합니다.

SOURCE CHECKOUT

Mihomo 소스 코드와 커밋 기록 확인

코어의 동작을 확인해야 한다면 공개 저장소에서 설정 구현, 이슈 기록과 릴리스 정보를 확인할 수 있습니다. 클론 명령은 소스 코드를 가져오는 용도일 뿐 그래픽 클라이언트를 설치하거나 사용 가능한 구독을 자동으로 생성하지 않습니다. 일반 사용자는 클라이언트 다운로드 페이지에서 설치 파일을 선택하고, 개발자와 라우터 관리자는 빌드 문서를 참고해 후속 작업을 진행하세요.

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

QUICK DIAGNOSIS

자주 묻는 질문

다음 질문은 어떤 항목부터 점검할지 빠르게 판단하는 데 도움이 됩니다. 전체 절차, 플랫폼별 차이와 문제 해결 방법은 도움말 센터에서 계속 확인할 수 있습니다.

구독을 가져오는 데 성공했는데 브라우저가 계속 직접 연결되는 이유는 무엇인가요?

먼저 가져온 설정이 현재 설정으로 지정되었는지 확인한 다음 클라이언트에서 시스템 프록시가 켜져 있는지 점검하세요. 클라이언트를 실행하거나 노드를 선택하는 것만으로 모든 앱의 네트워크 진입점이 자동으로 바뀌지는 않습니다. 브라우저가 별도의 프록시 설정, 확장 프로그램 또는 보안 DNS를 사용한다면 이러한 설정이 시스템 프록시를 덮어쓰는지도 확인해야 합니다.

시스템 프록시와 TUN 모드 중 무엇을 먼저 사용해야 하나요?

데스크톱 환경에서는 먼저 시스템 프록시를 사용해 브라우저와 시스템 설정을 따르는 앱을 확인하는 것이 좋습니다. 게임·터미널·스토어 또는 기타 프로그램이 시스템 프록시를 읽지 않을 때 TUN 모드를 검토하세요. TUN은 적용 범위가 더 넓지만 추가 권한이 필요하며 가상 머신, 다른 VPN 또는 보안 소프트웨어의 네트워크 드라이버와 충돌할 수 있습니다.

구독을 업데이트한 뒤 원래 선택한 노드가 바뀐 이유는 무엇인가요?

구독 업데이트로 정책 그룹이 다시 만들어지거나 노드 이름이 변경될 수 있습니다. 기존 선택 항목이 사라지면 클라이언트는 정책 그룹의 기본값으로 돌아갑니다. 업데이트 후에는 자주 사용하는 정책 그룹을 열어 출구를 다시 확인하세요. 클라이언트가 오버라이드를 지원한다면 병합 순서를 이해한 뒤 일부 로컬 설정을 고정할 수 있지만, 다음 업데이트에서 덮어써질 구독 파일을 직접 수정하지는 마세요.

일부 앱만 연결되지 않을 때 먼저 무엇을 확인해야 하나요?

먼저 해당 앱이 시스템 프록시를 읽는지 판단한 다음 요청이 클라이언트 로그에 기록되는지 확인하세요. 로그에 기록이 없다면 문제는 보통 트래픽 진입점에 있습니다. 기록은 있지만 규칙과 일치하지 않으면 규칙과 정책 그룹을 확인하고, 도메인 확인에 문제가 있으면 DNS 모드·캐시·제외 항목을 점검하세요. 진입점, 규칙, 출구, DNS 순서로 원인을 좁혀 가면 됩니다.

도움말 센터에서 모든 질문 보기 →

CONFIG NOTES

최근 설정 문서

문서는 설정 구조, 라우팅 방식과 클라이언트 이전을 주제별로 설명합니다. 특정 문제를 해결해야 한다면 입문 과정을 처음부터 읽지 말고 해당 주제로 바로 이동하세요.

YAML 참조

Clash 설정 파일 YAML 구조 해설: 기본 필드부터 규칙 섹션까지의 전체 순서

실제 로드 순서에 따라 포트, DNS, 프록시 노드, 정책 그룹과 규칙 필드를 분석하고 들여쓰기·참조·필드 오버라이드 관계를 설명합니다.

구독 가져오기를 완료하고 설정 파일을 읽거나 수정하려는 사용자에게 적합합니다. 각 섹션 간의 참조 관계와 필드가 존재해도 실제 실행 설정에 반영되지 않을 수 있는 이유를 중점적으로 설명합니다.

라우팅 방식

Clash TUN 모드와 시스템 프록시의 차이: 트래픽 진입점, 적용 범위와 선택 방법

작동 계층, 앱 호환성, DNS 처리와 권한 요구 사항을 기준으로 두 라우팅 방식을 비교하고 일반적인 기기 환경에서 선택할 기준을 제시합니다.

“브라우저는 정상인데 다른 앱이 연결되지 않는” 문제나 “TUN을 켠 뒤 네트워크가 비정상인” 문제를 해결할 때 적합합니다. 트래픽 진입점에 따라 차이를 설명하고 전환 전에 확인해야 할 권한·라우팅·충돌 항목을 정리합니다.

클라이언트 선택

Clash for Windows 서비스 종료 후 이전 방법: 대체 클라이언트와 설정 전환 단계

계속 사용할 수 있는 클라이언트를 정리하고 구독, 오버라이드 규칙과 시스템 프록시 설정을 이전하는 방법을 설명하며 전환 전후의 점검 항목을 제시합니다.

이전의 핵심은 기존 프로그램 폴더를 복사하는 것이 아니라 재사용 가능한 설정과 클라이언트 전용 상태를 분리하는 데 있습니다. 구독·오버라이드·사용자 지정 규칙·라우팅 설정을 각각 어떻게 기록하고 다시 구성할지 설명합니다.

전체 문서 보기 →