오픈소스 커뮤니티 · 모든 플랫폼의 클라이언트

Clash 클라이언트다운로드와 설정 파일 안내

클라이언트 선택부터 규칙 기반 라우팅까지, config.yaml의 주요 항목과 실제 사용법을 한곳에서 확인하세요.

오픈소스YAML 설정한국어 문서
config.yaml YAML

config.yaml

Clash 오픈소스 커뮤니티 · 설정 작업 공간

포트와 모드

mixed-port: 7890allow-lan: falsemode: rulelog-level: info

DNS

enable: trueenhanced-mode: fake-ipnameserver:- 223.5.5.5- 119.29.29.29

프록시 노드

name: 예시 노드type: ssserver: example.comport: 443udp: true

프록시 그룹

select url-test fallback load-balance

규칙

DOMAIN-SUFFIXDOMAIN-KEYWORDGEOIP,CN,DIRECTMATCH,PROXY

오버라이드와 병합

prepend-rulesappend-proxies병합 순서

관련 문서

설정 항목 일부 예시입니다. 전체 설정은 아니며, 오버라이드 키는 클라이언트가 해석합니다.

설정 항목 빠른 확인 / CONFIG

config.yaml에서
자주 수정하는 6가지 항목

입력, 출구, 규칙의 적용 순서를 먼저 파악한 뒤 설정을 바꾸세요. 포트는 연결을 받고, 노드는 출구를 제공하며, 프록시 그룹은 출구를 묶고, 규칙은 트래픽을 어디로 보낼지 결정합니다.

각 코드 조각은 설정 항목을 이해하기 위한 예시이며, 그대로 이어 붙여 사용하면 안 됩니다. 노드 이름, 프록시 그룹 이름, 규칙의 대상이 서로 일치해야 합니다. 코어와 클라이언트별 확장 기능도 따로 확인하세요.

브라우저나 다른 앱에서 사용할 로컬 프록시 주소가 필요합니다. mixed-port는 하나의 포트에서 HTTP와 SOCKS 프록시 연결을 모두 받습니다. 먼저 클라이언트에 표시된 실제 수신 포트를 확인한 다음 앱 설정에 입력하세요. 이 포트는 노드 서버의 포트와 다릅니다. 실행 로그에 주소가 이미 사용 중이라고 나오면 다른 프록시 프로세스를 종료한 뒤 포트 변경을 고려하세요. 로컬에서만 사용할 때는 LAN 접근을 비활성화해 두세요. 여기서 rule은 규칙에 따른 라우팅을 뜻하며, 시스템 트래픽이 이미 코어로 전달된다는 의미는 아닙니다. 시스템 프록시나 TUN은 별도로 설정해야 합니다.

mixed-port: 7890
allow-lan: false
bind-address: "127.0.0.1"
mode: rule
log-level: info
ipv6: false
클라이언트 다운로드 / PLATFORMS

운영체제에 맞는 Clash 클라이언트 선택

먼저 운영체제를 선택한 뒤 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 구독 가져오기, 설정 관리, 코어 제어를 담당합니다. 명령줄 코어만 사용하는 경우에는 설정 파일 경로와 실행 인수, 시스템 서비스를 직접 구성해야 합니다. 데스크톱이나 스마트폰에서 일상적으로 사용한다면 GUI 클라이언트부터 시작하는 편이 문제를 찾기 쉽습니다.

Windows

시스템 트레이 관리, 시스템 프록시, 규칙을 확인할 수 있는 GUI가 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트 다운로드를 안내하고 Clash for Windows 보관 자료도 제공합니다.

기존 클라이언트에서 옮길 때는 구독 주소와 사용자 규칙부터 백업하세요. 프로그램 폴더 전체를 그대로 복사하지 마세요. 설치 후 실행은 되지만 앱에서 프록시가 작동하지 않는다면 시스템 프록시 설정, 실제 포트, 앱 자체의 프록시 설정부터 확인한 뒤 TUN 사용을 고려하세요.

다운로드 Windows 클라이언트

macOS

먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel인지 확인한 뒤 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스와 설정 관리 방식이 다릅니다. 자세한 시스템 요구 사항은 다운로드 페이지에서 확인하세요.

시스템 프록시와 터미널 환경 변수는 서로 다른 경로입니다. 브라우저에서 연결된다고 해서 명령줄 도구도 프록시를 사용하는 것은 아닙니다. 터미널에서 연결 문제가 발생하면 해당 도구가 지원하는 프록시 설정을 확인하세요. 보조 서비스를 설치할 때 권한이 필요하다면 클라이언트 안내에 따라 진행하면 됩니다.

다운로드 macOS 클라이언트

Android

스마트폰에서는 Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 클라이언트마다 지원하는 구독 형식이 다를 수 있습니다. 파일을 성공적으로 내려받았다는 것은 가져오기가 완료됐다는 뜻일 뿐, 모든 설정 항목을 인식한다는 의미는 아닙니다.

처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 관리와 백그라운드 실행 제한을 확인하세요. VPN 연결을 사용하는 다른 앱을 동시에 실행하면 충돌이 발생할 수도 있습니다. 앱별 라우팅을 설정할 때는 앱이 포함 목록과 제외 목록 중 어디에 속하는지 확인하세요.

다운로드 Android 클라이언트

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 후 화면 안내에 따라 지원되는 설정을 가져오고, 프록시 그룹에서 선택할 수 있는 노드가 있는지 확인한 다음 시스템 VPN 설정 추가를 허용하세요.

Wi-Fi와 모바일 네트워크를 전환하면 DNS 환경과 사용할 수 있는 출구가 달라질 수 있습니다. 웹페이지가 계속 로딩된다면 구독 새로고침 실패인지, 노드 연결 실패인지, 특정 도메인의 규칙 문제인지 먼저 구분하세요. 데스크톱 클라이언트의 확장 스크립트가 모바일에서도 그대로 작동한다고 가정하지 마세요.

다운로드 iOS 클라이언트

Linux

데스크톱에서는 Clash Verge Rev와 FlClash를 먼저 살펴보고, 서버나 라우터에서는 mihomo 코어를 고려하세요. 패키지 형식, 프로세서 아키텍처, 배포판의 실행 환경을 함께 확인해야 합니다. 파일 이름에 Linux가 포함되어 있다는 이유만으로 호환된다고 판단할 수는 없습니다.

명령줄 도구에는 보통 프록시 환경 변수를 별도로 설정해야 합니다. 시스템 서비스가 현재 터미널의 설정을 자동으로 이어받는 것도 아닙니다. 투명 프록시를 활성화하기 전에 로컬 프록시 포트로 기본 연결을 확인한 다음 라우팅, DNS, 방화벽을 점검하세요. 여러 네트워크 설정을 한꺼번에 바꾸면 원인을 찾기 어렵습니다.

다운로드 Linux 클라이언트

설치 파일은 실행 환경을 준비하고, 구독은 연결 설정을 제공합니다. 이 사이트에서는 클라이언트와 설정 정보를 안내하지만, 소프트웨어 설치 후에는 유효하고 사용 권한이 있는 노드나 구독을 직접 준비해야 합니다. 공개 스크린샷, 문의 글, 공유 설정에 구독 주소나 인증 정보를 노출하지 마세요.

전체 클라이언트 보기 →
오픈소스 생태계 / SOURCE

Clash, 클라이언트, mihomo

세 이름은 자주 함께 언급되지만 같은 것을 가리키지는 않습니다. 클라이언트는 사용 편의성을 기준으로 고르고, 설정 항목은 코어 문서에서 확인하며, 문제 해결은 실제 실행 설정을 살펴보세요. 각각의 역할을 구분해야 '프로그램을 바꾸니 해결됐다'는 문제도 구체적인 원인을 찾을 수 있습니다.

mihomo 오픈소스 저장소 보기 ↗

Clash 프로젝트에서 이어지는 오픈소스 생태계

Clash는 규칙 기반 프록시 코어와 YAML 설정을 바탕으로 널리 쓰이는 사용 방식을 만들었습니다. 원래 Clash 프로젝트와 일부 초기 GUI 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티는 각기 다른 방향으로 개발을 이어왔습니다. 어떤 프로젝트는 인터페이스와 구독 관리에 집중하고, 다른 프로젝트는 코어의 프로토콜과 규칙 기능을 확장합니다. 따라서 'Clash 설정'은 생태계에서 흔히 쓰는 표현일 뿐, 모든 소프트웨어가 같은 설정 항목을 지원한다는 호환성 보장은 아닙니다.

Clash for Windows 지원 종료 후 대체 클라이언트를 고를 때는 현재 유지 관리 여부, 운영체제 지원, 설정 이전 비용을 기준으로 삼으세요. 익숙한 인터페이스인지 여부만으로 결정하지 않는 편이 좋습니다. 예전 가이드의 메뉴 위치, 보조 서비스 설치 방법, 기본 설정값은 현재 클라이언트와 다를 수 있습니다. 기존 설정을 참고용으로 보관하는 것은 유용하지만, 다시 가져온 뒤에는 구문 분석 결과와 프록시 그룹 참조, 시스템 트래픽 처리 방식을 확인해야 합니다.

GUI와 코어는 역할이 다릅니다

GUI 클라이언트는 보통 구독 다운로드, 설정 전환, 트레이 메뉴, 로그 표시를 담당합니다. mihomo 같은 코어는 설정 해석, 규칙 매칭, 도메인 확인, 연결 수립을 처리합니다. 인터페이스에 특정 스위치가 있다고 해서 설정 파일에 같은 이름의 항목이 반드시 있는 것은 아닙니다. 반대로 코어가 지원하는 확장 설정을 모든 클라이언트의 화면에서 직접 편집할 수 있는 것도 아닙니다. 문서를 확인할 때는 클라이언트 이름과 코어 종류를 함께 확인하세요.

mihomo는 Clash 생태계의 설정 방식을 바탕으로 기능을 확장해 왔으며, GPL-3.0 라이선스를 적용합니다. 저장소에서 소스 코드와 변경 내역, 이슈 논의를 확인할 수 있습니다. 이 라이선스는 해당 오픈소스 프로젝트에 적용되며 모든 서드파티 GUI, 앱 스토어 앱, 관련 서비스에 일괄 적용되는 것은 아닙니다. 이 사이트는 커뮤니티 정보를 정리하며, 각 클라이언트의 배포와 스토어 정보, 기능 범위는 해당 프로젝트가 결정합니다.

업데이트 전에는 변경 사항을, 후에는 결과를 확인하세요

클라이언트 업데이트, 코어 업데이트, 구독 새로고침은 서로 다른 작업입니다. 클라이언트를 업데이트하면 인터페이스와 시스템 연동이 바뀔 수 있고, 코어 업데이트는 설정 해석과 연결 동작에 영향을 줄 수 있습니다. 구독을 새로고침하면 주로 노드와 규칙 정보가 바뀝니다. 문제가 생기면 최근에 변경한 항목이 어느 계층인지 먼저 기록하세요. 구독 오류를 설치 파일 탓으로 돌리거나, 노드 하나가 작동하지 않는다고 소프트웨어를 반복해서 재설치하지 않도록 합니다.

현재 정상 작동하는 설정을 보관하고 한 번에 한 종류의 설정만 변경하는 것이 안전합니다. 다시 불러온 뒤 로그 오류를 확인하고 대상 앱의 실제 요청이 제대로 처리되는지 테스트하세요. 노드를 시험할 때는 조건을 일정하게 유지하고, 연결이 실패하면 발생 시각과 대상 도메인, 적용된 규칙을 기록하세요. 로그를 공유하기 전에는 서버 인증 정보와 구독 매개변수를 삭제하세요. 오류 화면만 담은 스크린샷보다 재현 가능한 절차가 문제 해결에 더 도움이 됩니다.

소스 코드 확인 · 로컬에 Git이 설치되어 있어야 합니다

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

저장소를 복제하면 소스 코드와 문서를 살펴볼 수 있지만, 클라이언트가 자동으로 설치되거나 사용할 노드가 제공되지는 않습니다. 일상적으로 사용하려면 다운로드 페이지에서 GUI 클라이언트를 선택하세요.

최근 게시물 / NOTES

구독 가져오기와 연결 문제 해결

먼저 설정을 가져오는 단계, 설정을 해석하는 단계, 연결을 수립하는 단계 중 어디에서 문제가 발생했는지 확인하세요. 각 글은 구체적인 상황을 중심으로 설명하므로 모든 설정 문서를 먼저 읽을 필요는 없습니다. 오류 메시지와 실제 설정을 함께 살펴보면 다음 조치를 찾기 쉽습니다.

입문 가이드

Clash 구독 링크 가져오기: URL·Base64·YAML 형식 차이

플랫폼별 클라이언트에서 구독을 가져오는 방법을 안내하고 전체 YAML 설정, Base64 노드 목록, 단일 노드 링크의 차이를 비교합니다. 먼저 콘텐츠 형식을 확인한 뒤 바로 가져올지 변환 도구를 사용할지 결정하세요. 형식이 호환되지 않는 문제를 링크 오류로 오해하지 않도록 주의하세요.

게시물 읽기 →
클라이언트 다운로드