Clash 생태계 · 한국어 설정 문서

Clash 지식베이스클라이언트 다운로드와 설정 안내

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

플랫폼별 클라이언트를 선택하고 mihomo 코어, YAML 필드, 규칙 분기를 차례로 확인하세요.

오픈소스 코드설정 예제한국어 문서

설정 필드와 작동 방식

먼저 필드가 속한 위치를 확인한 뒤 설정 예제와 비교하세요. 예제는 구조를 보여 주며 완성된 구독 설정을 대신하지 않습니다.

Clash 지식베이스config.yaml / general

CORE / mihomo

코어는 연결과 라우팅을 담당합니다

mihomo는 Clash 생태계의 프록시 코어로, 설정을 읽고 연결을 수신해 규칙을 확인한 뒤 아웃바운드 연결을 만듭니다. 클라이언트는 구독 관리, 트레이 메뉴, 시스템 연동 기능을 제공하므로 두 요소는 서로 다른 계층에 속합니다. 클래식 Clash, Clash Meta, mihomo는 계보가 이어지지만 새 필드를 구형 코어가 반드시 인식하는 것은 아닙니다. 설정 문제를 확인할 때는 먼저 클라이언트에서 실제로 사용하는 코어를 확인하고 필드 지원 여부를 살펴보세요. 예제의 혼합 포트는 HTTP와 SOCKS 요청을 모두 받을 수 있습니다. 로컬에서만 사용할 경우 LAN 접근은 비활성화 상태로 두세요.

일반 필드 보기 → 
# 최상위 공통 필드
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false

설정을 읽을 때는 ‘진입점 → 모드 → 규칙 → 정책 → 아웃바운드’ 순서로 살펴보세요. 포트와 TUN은 연결이 코어에 들어오는 방식을 결정하고, mode는 처리 방식을, rules는 트래픽을 전달할 정책을 결정합니다. 각 계층을 나누어 확인하면 여러 설정을 한꺼번에 바꾸는 것보다 원인을 파악하기 쉽습니다.

운영체제별 클라이언트 선택

먼저 플랫폼과 프로세서 아키텍처를 확인한 뒤 인터페이스, 트래픽 처리 방식, 유지보수 상태를 비교하세요.

Windows

Clash Plus, Clash Verge Rev, FlClash 등에서 선택할 수 있습니다. 일반적인 웹 이용은 시스템 프록시부터 사용해 보세요. 게임이나 명령줄 프로그램이 시스템 프록시를 따르지 않는다면 TUN을 검토하세요. 설치 전에 시스템 정보에서 프로세서 종류를 확인하고, 업데이트 후에도 서비스 모드가 작동하는지 점검하세요.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel 기기에는 각각 맞는 설치 파일이 필요합니다. ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. 처음 실행할 때 시스템 안내에 따라 권한을 허용한 뒤 메뉴 막대 상태와 네트워크 프록시 설정을 확인하세요. 클라이언트를 바꾸기 전에는 기존 앱을 종료해 두 앱이 동시에 시스템 프록시를 변경하지 않도록 하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교하고 설정 형식과 코어 기능 차이를 확인하세요. 처음 연결할 때 VPN 요청을 허용하세요. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 실행, 자동 시작 권한을 확인하세요. 구독을 반복해서 다시 설치할 필요는 없습니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 호환되는 설정을 가져오고 시스템 안내에 따라 VPN 구성을 추가하세요. 모바일 운영체제는 백그라운드 네트워크 확장을 별도로 관리하므로 데스크톱의 서비스 설치 절차를 휴대폰에 적용할 수 없습니다.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 사용하세요. 서버나 라우터 사용자는 mihomo 코어 안내를 참고해 서비스 시작, 설정 디렉터리, 권한을 직접 관리할 수 있습니다. 데스크톱 프록시 설정이 터미널의 모든 프로세스에 적용되는 것은 아닙니다.

다운로드 페이지로 이동

설치 파일, 구독, 클라이언트의 차이

설치 파일은 프로그램을 제공하고 구독은 프록시 설정을 제공하므로 서로 대체할 수 없습니다. 설치를 마친 뒤에는 신뢰할 수 있는 출처에서 받은, 클라이언트와 호환되는 설정을 가져와야 합니다. 이 지식베이스는 소프트웨어 링크와 설정 필드 정보를 제공하며 프록시 서비스를 제공하지 않습니다. 클라이언트를 다운로드해도 사용할 수 있는 출구가 자동으로 만들어지지는 않습니다. 구독 링크는 계정 권한과 연결되는 경우가 많으므로 스크린샷이나 로그를 공유하기 전에 전체 주소를 가리세요.

Clash for Windows는 더 이상 유지보수되지 않습니다. 기존 안내를 이해하거나 현재 설정을 옮길 때 참고할 수 있지만, 이름이 익숙하다는 이유만으로 새 기기의 기본 클라이언트로 선택하는 것은 권장하지 않습니다. 이전할 때는 구독 주소와 사용자 지정 규칙을 보관하고 새 클라이언트가 생성한 설정을 확인하세요. 특정 프로토콜 지원 여부는 앱 이름에 Clash가 포함됐는지가 아니라 실제 코어와 클라이언트 통합 방식에 달려 있습니다.

전체 클라이언트 보기 →

Clash 사용 가이드: 시작하기 3단계

먼저 확인 가능한 연결을 하나 만든 뒤 분기 규칙, 오버라이드, TUN 설정을 추가하세요.

01 / PROFILE

구독 또는 로컬 설정 가져오기

클라이언트의 설정 관리 화면에서 구독 주소를 추가하거나 로컬 YAML 파일을 가져오세요. 다운로드와 파싱이 끝나면 해당 설정을 현재 설정으로 지정합니다. 파싱 오류가 표시되면 먼저 해당 줄을 확인해 네트워크 요청 실패인지 YAML 구조 오류인지 구분하세요. 두 문제의 해결 방법은 다릅니다.

구독에는 노드, 정책 그룹, 규칙이 포함될 수도 있고 노드 목록만 들어 있을 수도 있습니다. 가져오기에 성공했다고 해서 설정 구조까지 완전한 것은 아닙니다. 먼저 화면에서 선택 가능한 정책이 있는지 확인한 뒤 연결을 시작하세요. Base64 텍스트를 완성된 YAML 파일처럼 저장하지 마세요.

02 / MODE

모드와 트래픽 진입점 선택

일반적인 사용은 규칙 모드부터 시작하고, 해당 정책 그룹에서 사용할 수 있는 출구를 선택한 다음 시스템 프록시 또는 모바일 VPN 연결을 활성화하세요. 전역 모드는 코어에 들어오는 트래픽을 전역 정책에 전달하고, 직접 연결 모드는 프록시를 거치지 않고 연결합니다. 두 모드는 속도 설정이 아닙니다.

시스템 프록시와 TUN은 트래픽 진입점 설정이고, 규칙 모드와 전역 모드는 처리 방식입니다. 브라우저는 정상인데 다른 프로그램이 연결되지 않는다면 먼저 해당 프로그램이 시스템 프록시를 따르는지 확인한 뒤 TUN이 필요한지 판단하세요. 한 번에 조건 하나만 바꾸고 변경 전 상태를 기록해 두세요.

03 / VERIFY

연결과 적용된 규칙 확인

프록시가 필요한 사이트를 열고 연결 화면에서 대상 도메인, 적용된 규칙, 정책 그룹, 실제 출구를 확인하세요. VPN 아이콘이 보이거나 트레이 아이콘 색상이 바뀌었다고 해서 모든 프로그램이 예상한 경로를 사용한다고 단정할 수 없습니다. 해당 연결 기록을 기준으로 확인해야 합니다.

연결 기록이 없다면 먼저 트래픽 진입점을 확인하세요. 잘못된 정책이 적용됐다면 규칙 순서를 살펴보고, 정책은 맞지만 연결에 실패한다면 출구와 DNS를 확인하세요. 점검을 마친 뒤 정상 작동하는 설정을 저장해 두면 이후 업데이트 문제도 모든 설정을 한꺼번에 초기화하지 않고 항목별로 비교할 수 있습니다.

처음 확인할 항목

브라우저에서는 접속되지만 터미널에서는 안 된다면 먼저 터미널 프로그램의 프록시 설정을 확인하세요. 구독은 업데이트되지만 웹페이지가 열리지 않는다면 출구 선택과 대상 연결을 추가로 점검해야 합니다. 클라이언트의 구독 다운로드, 코어 아웃바운드, 브라우저 접속은 서로 다른 네트워크 경로를 사용할 수 있으므로 한쪽이 성공했다고 전체가 정상이라고 볼 수는 없습니다.

DNS를 바꾼 뒤에도 이전 결과가 표시된다면 관련 연결을 끊었다가 다시 시도하고, 필요하면 플랫폼에 맞게 캐시를 지우세요. 다른 VPN, 가속 프로그램, 가상 네트워크 도구를 사용 중이라면 원인을 좁히기 위해 하나씩 종료해 보세요. 작업 전 현재 설정을 보관하고 테스트가 끝난 뒤 변경 사항을 계속 유지할지 결정하세요.

전체 가이드 보기 →

오픈소스 코어와 설정 출처

클라이언트, 코어, 서비스 제공자를 구분해야 안내가 어느 대상에 적용되는지 판단할 수 있습니다.

Clash, Meta, mihomo의 관계

Clash 생태계에는 코어, 그래픽 클라이언트, 설정 도구, 규칙 프로젝트가 포함됩니다. 클래식 Clash는 규칙 프록시의 기본 설정 구조를 제공했고, Clash Meta는 이를 바탕으로 기능을 확장했으며 이후 mihomo라는 이름으로 발전했습니다. 이전 안내의 Meta와 현재 문서의 mihomo는 이어지는 부분이 많지만, 모든 필드와 프로토콜, 기본 동작이 완전히 같다고 볼 수는 없습니다.

가이드를 읽을 때는 먼저 어떤 코어를 설명하는지 확인한 뒤 클라이언트에서 해당 필드를 직접 설정할 수 있는지 살펴보세요. 그래픽 인터페이스가 포트, DNS, TUN 설정을 대신 생성하거나 시작 전에 로컬 오버라이드를 병합할 수도 있습니다. 문제를 확인할 때는 구독 원본 파일뿐 아니라 실제 실행 설정도 살펴보세요. 두 설정의 차이가 동작이 달라진 원인일 수 있습니다.

공개 소스 코드와 라이선스 범위

mihomo 소스 코드는 공개되어 있으며 코어에는 GPL-3.0 라이선스가 적용됩니다. 공개 저장소에서 구현과 변경 사항을 확인하고 문제 원인을 찾을 수 있으며, 라이선스는 코드의 사용 및 배포 조건을 정합니다. 그래픽 클라이언트는 별도 프로젝트이므로 다른 라이선스를 사용할 수 있습니다. 코어의 라이선스를 모든 클라이언트의 라이선스 안내로 간주해서는 안 되며, 구독 서비스의 사용 가능 여부를 판단하는 근거로 삼을 수도 없습니다.

오픈소스 저장소의 이슈 기록은 알려진 동작을 확인하는 데 도움이 되지만, 한 건의 논의가 모든 기기에서 같은 문제가 발생한다는 뜻은 아닙니다. 이슈를 등록할 때는 운영체제, 클라이언트 이름, 코어 정보, 재현 절차, 개인정보를 가린 로그를 첨부하세요. 구독 전체 주소, 계정 인증 정보, 개인 네트워크 정보가 담긴 설정 파일을 공개하지 마세요.

클라이언트 업데이트와 구독 업데이트는 다릅니다

클라이언트 업데이트는 코어 기능, 인터페이스, 시스템 연동을 바꿀 수 있고 구독 업데이트는 주로 원격 설정 내용을 바꿉니다. 업데이트 후 문제가 생기면 먼저 어느 계층에 변화가 있었는지 확인하세요. 업데이트 전 정상 작동하던 설정을 보관하고 클라이언트의 릴리스 노트를 살펴본 뒤 생성된 규칙과 DNS 설정을 비교하세요. 파일 이름만 보고 코어도 함께 업데이트됐다고 판단하지 마세요.

이 지식베이스의 설정 예제는 필드와 문법을 설명하기 위한 것이며 바로 연결할 수 있는 프록시 출구를 포함하지 않습니다. 예제를 복사하기 전에 주석을 읽고 정책 이름이 정의되어 있는지, 해당 기능을 현재 플랫폼에서 지원하는지 확인하세요. YAML은 공백으로 계층을 표현하며 목록의 하이픈, 쉼표, 문자열 따옴표는 모두 의미가 있습니다. 여러 조각을 그대로 이어 붙이면 키가 중복되거나 필요한 설정이 빠질 수 있습니다.

문서 확인 순서

처음 사용하는 경우 사용 가이드에서 설정 가져오기와 연결 확인 방법을 살펴보세요. 클라이언트를 선택해야 한다면 선택 가이드를, 확인할 필드명이 정해져 있다면 설정 참고 문서를 확인하세요. 코어 원리와 사용 사례는 주제별 문서에서 다룹니다. 모든 기능을 한꺼번에 켜기보다 현재 문제에 맞는 자료부터 확인해야 설정이 적용됐는지 판단하기 쉽습니다.

최근 설정 가이드

프록시 모드, 트래픽 처리, 모바일 시스템 권한의 작동 원리를 설명합니다.

전체 글 보기 →
Clash 다운로드