CLASH 설정 가이드 · 전 플랫폼
구독 가져오기부터 규칙 분기까지, 순서대로 클라이언트를 설정하고 연결을 확인하세요.
CONFIG.YAML / 설정 주석
먼저 설정 항목이 어떤 문제를 해결하는지 살펴본 뒤 사용할지 결정하세요. 아래 예시는 각 필드를 설명하기 위한 것으로, 그대로 연결할 수 있는 완성 설정이 아닙니다. 노드, 정책 그룹, 리졸버는 구독과 네트워크 환경에 맞게 추가해야 합니다.
mixed-port: 7890allow-lan: falsemode: rulelog-level: info규칙 모드는 설정에 정의된 조건에 따라 직접 연결할지 프록시를 사용할지 결정하므로, 로컬 리소스와 원격 서비스를 함께 이용할 때 적합합니다. 클라이언트의 모드 메뉴에서 ‘규칙’을 선택하고, 사용 중인 구독에 규칙과 정책 그룹이 포함되어 있는지 확인하세요. 전역 모드는 가로챈 트래픽을 전역 정책으로 보내므로 문제를 잠시 비교·진단할 때는 유용하지만, 시스템 프록시나 TUN을 대신하지는 않습니다. 특정 사이트가 잘못된 경로로 연결된다면 연결 기록에서 적용된 규칙을 확인한 뒤 수정하세요. 모드를 계속 바꾸면 실제 원인을 찾기 어려워집니다. 클라이언트마다 버튼 이름은 다를 수 있지만 코어의 분기 방식은 같습니다.
tun: enable: true stack: mixed auto-route: true auto-detect-interface: trueTUN은 가상 네트워크 인터페이스와 라우팅으로 트래픽을 처리해 게임이나 명령줄 도구처럼 시스템 프록시를 사용하지 않는 프로그램에 적합합니다. 데스크톱 클라이언트는 서비스 설치나 관리자 권한이 필요한 경우가 많고, 모바일에서는 시스템 VPN 연결 요청을 승인해야 합니다. 먼저 시스템 프록시로 구독이 작동하는지 확인한 다음 TUN을 따로 테스트하면 권한 문제를 노드 장애로 오해하지 않을 수 있습니다. TUN은 속도를 높이는 기능이 아니며 모든 트래픽을 반드시 처리하는 것도 아닙니다. 다른 VPN, 가상 머신의 네트워크 인터페이스, 사용자 지정 라우팅이 결과에 영향을 줄 수 있습니다. 활성화 후 로컬 네트워크 기기에 접근할 수 없다면 규칙을 모두 삭제하기보다 라우팅 제외 항목을 확인하세요.
dns: enable: true enhanced-mode: fake-ip fake-ip-range: 198.18.0.1/16fake-ip는 도메인에 가상 IP를 할당해 코어가 연결 단계에서 도메인 정보를 유지하고 트래픽을 분기하도록 돕습니다. 실제 DNS 처리 방식과 함께 설정해야 하며, 이 항목만 바꾼다고 모든 DNS 요청이 클라이언트로 전달되는 것은 아닙니다. 먼저 클라이언트에서 DNS가 활성화되어 있는지 확인하고 TUN의 DNS 하이재킹, 브라우저의 보안 DNS, 시스템의 비공개 DNS도 점검하세요. 일부 로컬 네트워크 서비스나 실제 IP에 의존하는 앱은 필터 목록에 추가해야 할 수 있습니다. 가상 IP가 보인다고 DNS 오류인 것은 아닙니다. 호환성 문제가 발생하면 해당 도메인만 예외로 지정하고 캐시를 지운 뒤 다시 테스트하세요.
proxy-providers: service: type: http url: "https://example.com/proxies.yaml" path: ./providers/service.yaml interval: 86400프록시 제공자 설정을 사용하면 노드 목록을 주기적으로 가져올 수 있어 노드가 바뀔 때마다 로컬 규칙을 다시 작성하지 않아도 됩니다. 예시 주소는 구조를 설명하기 위한 것이므로 실제 사용 시에는 서비스 제공자가 지원하는 프록시 제공자 주소를 입력하고 정책 그룹에서 use로 참조하세요. 업데이트 간격의 단위는 초이며, 지나치게 자주 갱신할 필요는 없습니다. 클라이언트의 ‘구독 설정 업데이트’와 코어의 프록시 제공자 업데이트는 서로 다른 기능입니다. 전체 설정 구독을 프록시 제공자로 바로 사용할 수 있는 것도 아닙니다. 업데이트에 실패하면 응답 내용, 주소 유효 기간, 다운로드 경로 권한부터 확인하고 필요한 경우 네트워크 접근 방식을 조정하세요. 클라이언트를 반복해서 재설치하지 않아도 됩니다.
rules: - DOMAIN-SUFFIX,example.com,DIRECT - GEOIP,CN,DIRECT - MATCH,DIRECT규칙은 순서대로 확인합니다. 구체적인 도메인 조건을 더 포괄적인 조건보다 앞에 두고 마지막에 기본 규칙을 배치하세요. 예시는 직접 연결 대상을 사용해 문법을 보여줍니다. 프록시를 사용하려면 설정에 이미 존재하는 정책 그룹 이름으로 바꾸고 대소문자까지 일치시켜야 합니다. 구독을 업데이트하면 직접 추가한 규칙이 덮어써질 수 있으므로, 지속적으로 수정할 규칙은 클라이언트의 오버라이드나 병합 설정에 두는 편이 좋습니다. 문제를 확인할 때는 연결 기록에서 도메인, 적용된 규칙, 최종 출구를 살펴보세요. 웹페이지가 열리는지만으로 분기가 올바른지 판단할 수 없습니다. 규칙 세트 다운로드 실패와 노드 연결 실패도 각각 따로 확인해야 합니다.
CLIENTS / 기기별 선택
먼저 운영체제를 선택한 뒤 프로세서 아키텍처와 클라이언트 요구 사항을 확인하세요. 데스크톱과 모바일에서 같은 서비스의 구독을 사용할 수는 있지만 화면 구성, 지원 필드, 시스템 트래픽 처리 방식은 다를 수 있습니다. 한 기기의 설정을 통째로 복사하는 것은 권장하지 않습니다.
Clash Plus부터 살펴보고 Clash Verge Rev, FlClash 등의 클라이언트와 비교해 보세요. 시스템의 ‘정보’에서 기기 아키텍처를 확인한 다음 다운로드 페이지의 안내에 따라 설치 파일을 선택하세요. 구형 Clash for Windows는 더 이상 유지 관리되지 않습니다. 장기간 보관된 프로그램에 의존하기보다 기존 설정을 보존해 새 클라이언트로 옮기는 편이 좋습니다.
시스템 프록시는 브라우저 등 일반 앱에 적합합니다. TUN을 활성화하기 전에 관련 서비스 구성 요소가 설치되어 있는지 확인하세요. 다른 네트워크 처리 도구를 함께 실행 중이라면 먼저 하나를 끄고 라우팅과 연결 기록을 점검하세요.
다운로드 Windows 클라이언트다운로드 전에 ‘이 Mac에 관하여’에서 Apple Silicon과 Intel을 구분하세요. Clash Plus, Clash Verge Rev, FlClash는 각각 사용 방식에 차이가 있습니다. 기존 설정이 있다면 메뉴 막대 모양보다 오버라이드 규칙, 프록시 포트, 로그인 시 실행 설정을 꼼꼼히 확인하세요.
처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정해야 합니다. 시스템 프록시와 네트워크 확장 권한은 별개이므로 설치를 마쳤다고 트래픽이 자동으로 처리되는 것은 아닙니다. 자세한 방법은 전체 문서의 플랫폼별 항목을 확인하세요.
다운로드 macOS 클라이언트Clash Plus, Clash Meta for Android, FlClash 중 평소 사용 방식에 맞는 클라이언트를 선택하세요. 설치 파일 아키텍처는 기기에 맞아야 합니다. 최신 기기는 대부분 ARM64를 사용하지만 시스템 정보에서 직접 확인하는 것이 좋습니다. 구독을 가져온 뒤 해당 설정이 선택되어 있는지 확인하고 시스템 VPN 연결 요청을 승인하세요.
백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 관리와 백그라운드 실행 제한을 확인하세요. 연결 유지를 위해 모든 상시 실행 기능을 무작정 켜지 마세요. 잦은 속도 측정과 지나치게 짧은 업데이트 간격도 배터리 소모를 늘립니다.
다운로드 Android 클라이언트Clash Plus는 App Store에서 설치할 수 있으며 공식 사이트는 clashplus.io입니다. 앱에서 구독을 가져와 설정을 선택한 다음 VPN 구성 추가를 허용하세요. 데스크톱 설정 중 시스템 서비스와 관련된 필드는 모바일에 그대로 적용하지 마세요.
연결은 시스템 네트워크 확장에서 관리하므로 백그라운드 동작이 데스크톱과 다릅니다. 연결에 문제가 생기면 먼저 설정이 유효한지 확인한 뒤 앱 로그를 살펴보세요. 주문형 연결을 사용할지는 평소 네트워크 전환 방식에 맞춰 결정하면 됩니다.
다운로드 iOS 클라이언트데스크톱에서는 Clash Verge Rev와 FlClash를 비교하고 배포판에 맞는 패키지 형식을 선택하세요. 서버와 라우터에서는 mihomo 코어 안내를 참고해 시작 서비스, 파일 경로, 실행 권한을 별도로 설정하는 편이 적합합니다. 그래픽 인터페이스를 설치할 필요는 없습니다.
데스크톱 환경의 시스템 프록시가 터미널 프로그램에 적용되지 않을 수 있습니다. 먼저 앱이 환경 변수, 명시적 프록시 인수, TUN 중 어떤 방식을 사용하는지 확인하고 요청이 코어에 도달하는지 살펴보세요. 원격으로 작업할 때는 기존 관리 연결을 특히 주의해 유지해야 합니다.
다운로드 Linux 클라이언트전체 클라이언트 보기 → 시스템 요구 사항, 아키텍처 옵션, 이전 버전 안내는 다운로드 페이지에서 확인할 수 있습니다.
QUICK START / 3단계 미리보기
클라이언트는 설정과 네트워크 요청을 처리하는 도구일 뿐 노드를 제공하지 않습니다. 시작하기 전에 서비스 제공자가 발급한 유효한 구독 링크를 준비하고, 기기 시간이 정확하며 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하세요. 구독 링크에는 접속 정보가 포함될 수 있으므로 공개 게시판이나 스크린샷에 올리지 마세요.
클라이언트에서 ‘설정’, ‘구독’ 또는 ‘Profiles’ 메뉴를 찾아 링크 가져오기를 선택하세요. 전체 주소를 붙여 넣고 업데이트를 실행합니다. 가져오기에 성공하면 해당 설정을 선택하고 정책 그룹이 표시되는지 확인하세요. 구독 이름만 보이고 노드가 없다면 먼저 업데이트 로그를 살펴 주소 만료, 응답 형식 오류, 네트워크 요청 실패를 구분하세요. 곧바로 전역 모드를 켜고 반복해서 시도하지 마세요.
서비스 제공자가 여러 형식의 링크를 제공한다면 현재 코어와 호환되는 Clash 또는 mihomo 설정을 선택하세요. 직접 편집하기 전에 원본 파일을 백업하고 YAML의 들여쓰기와 콜론 뒤 공백에 유의하세요. 노드 비밀번호 등 민감한 정보는 다른 사람에게 보내 문제를 확인하지 마세요. 구독 가져오기 단계 보기 →
처음 사용할 때는 규칙 모드를 선택하고 정책 그룹에서 연결 가능한 노드를 고른 다음 시스템 프록시를 켜세요. 모바일에서는 시스템 안내에 따라 VPN 연결을 허용해야 합니다. 시스템 프록시를 따르지 않는 앱이 있을 때만 TUN을 시험하고 필요한 권한이 부여되었는지 확인하세요. 기존 VPN, 가속기, 다른 프록시 도구가 라우팅을 차지할 수 있습니다. 문제를 확인하는 동안에는 트래픽 처리 방식을 하나만 사용해 변수를 줄이세요.
전역 모드는 클라이언트에 들어온 트래픽의 출구를 어떻게 선택하는지를 말합니다. 모든 기기 요청이 자동으로 프록시를 통과한다는 뜻은 아닙니다. 규칙 모드에서 직접 연결되는 것도 클라이언트가 작동하지 않는다는 의미가 아닙니다. 접속 대상과 적용된 규칙 기록을 함께 확인하세요. 모드 선택 안내 보기 →
테스트할 웹사이트를 열면서 클라이언트의 연결 기록을 확인하세요. 새 요청이 들어왔는지, 예상한 규칙이 적용되었는지, 올바른 정책을 사용했는지 살펴봅니다. 이어서 국내 웹사이트, 로컬 네트워크 기기, 자주 쓰는 앱도 테스트해 분기 설정이 정상적인 접속을 방해하지 않는지 확인하세요. 지연 시간 테스트는 특정 시점의 측정값일 뿐 실제 다운로드 속도나 모든 사이트의 접속 가능성을 보장하지 않습니다.
브라우저만 되고 터미널은 연결되지 않는다면 먼저 터미널의 프록시 인수를 확인하세요. 모든 앱이 연결되지 않는다면 구독, 노드, 트래픽 처리 설정을 차례로 점검합니다. 연결이 안정된 뒤에 시작 프로그램 등록과 자동 업데이트를 켜고, 변경한 항목을 기록해 두면 다음에 문제를 찾기 쉽습니다.
전체 가이드 보기 → 처음 시작할 때는 기본 사용 흐름을 확인하고, 플랫폼 권한과 고급 설정은 전체 문서에서 살펴보세요.
OPEN SOURCE / 프로젝트와 유지 관리
클라이언트를 고를 때는 그래픽 인터페이스, 프록시 코어, 구독 서비스를 구분해서 살펴보세요. 각각 조작 화면, 트래픽 처리, 노드 제공을 담당합니다. 어느 한 부분에 문제가 생겨도 단순히 ‘Clash가 작동하지 않는다’고 단정해서는 안 됩니다.
Clash는 규칙 기반 트래픽 분기와 YAML 설정으로 널리 사용되기 시작했고, 이후 데스크톱과 모바일 클라이언트가 다양하게 등장했습니다. 원본 프로젝트와 일부 구형 클라이언트의 유지 관리가 중단된 뒤에도 생태계에는 여러 선택지가 남았습니다. Clash.Meta가 관련 기능 개발을 이어 갔고 이후 mihomo라는 이름을 사용하게 됐습니다. 오래된 가이드에서는 두 이름이 함께 등장할 수 있습니다.
이름이 비슷하다고 설정을 모두 함께 쓸 수 있는 것은 아닙니다. 최신 프로토콜, 규칙 문법, DNS 매개변수는 특정 코어에서만 지원될 수 있으므로 이전할 때는 파일 확장자만 YAML로 바꾸지 말고 각 필드를 확인해야 합니다. 기존 설정을 가져올 수 있더라도 모든 항목이 인식된다는 뜻은 아닙니다.
mihomo는 설정을 해석하고 연결을 생성하며 규칙을 실행합니다. 그래픽 클라이언트는 구독 관리, 노드 선택, 시스템 프록시 전환, 로그 표시를 담당합니다. 클라이언트가 자체 오버라이드, 병합 설정, 설정 템플릿을 추가할 수도 있어 화면에 표시되는 옵션이 코어에 전달되는 최종 파일과 반드시 일치하지는 않습니다.
문제를 확인할 때는 실행 중인 설정과 실제 로그를 먼저 살펴보세요. 화면에서는 꺼져 있지만 구독 설정에서는 켜져 있거나, 업데이트로 로컬 변경 사항이 덮어써진 경우 ‘바꿨는데도 효과가 없는’ 상황이 생길 수 있습니다. 다른 클라이언트로 옮길 때는 구독 주소와 사용자 지정 규칙을 각각 따로 저장하세요.
mihomo는 GPL-3.0 라이선스를 따르며 소스 코드, 커밋 기록, 이슈 논의는 프로젝트 저장소에서 확인할 수 있습니다. 오픈 소스는 구현과 라이선스 조건을 살펴볼 수 있다는 뜻이지, 제3자 서비스의 노드 품질을 보장하거나 실제 네트워크 환경에서의 테스트를 대신한다는 뜻은 아닙니다. 이 사이트는 설정 안내와 다운로드 링크를 정리하며 코어 프로젝트나 모든 클라이언트의 공식 운영 주체가 아닙니다.
소프트웨어 결함이 의심되면 가능한 한 간단한 설정으로 재현하고 운영체제, 클라이언트, 코어 정보와 오류 내용을 기록하세요. 문제를 제출하기 전에 구독 주소, 노드 인증 정보, 개인 네트워크 정보를 삭제하세요. 설정 파일 전체를 그대로 올리는 것보다 안전한 공개 협업에 도움이 됩니다.
클라이언트 업데이트, 코어 업데이트, 구독 새로고침, 규칙 데이터 업데이트는 각각 다른 문제를 해결합니다. 화면이 업데이트되어도 코어까지 함께 바뀌는 것은 아니며, 구독을 새로고침해도 시스템 권한이 자동으로 복구되지는 않습니다. 업데이트 전에 정상 작동 중인 설정을 보관하고 프로젝트의 변경 사항을 읽어 보세요. 호환성에 영향을 주는 변경이 있다면 일상적으로 사용할 환경을 전환하기 전에 설정부터 확인하세요.
GeoIP나 규칙 세트 다운로드에 실패하면 리소스 경로, 접근 조건, 로그의 구체적인 오류를 확인하세요. 특정 노드만 느리다면 먼저 다른 노드와 비교해 보세요. 여러 항목을 한꺼번에 업데이트하거나 재설치하고 DNS까지 바꾸기보다 원인을 단계별로 좁히는 편이 유효한 단서를 보존하기 쉽습니다. 관련 용어는 용어집에서 하나씩 확인할 수 있습니다.
저장소: MetaCubeX/mihomo. 아래 명령은 소스 코드를 내려받으며 그래픽 클라이언트를 설치하지 않습니다. 일상적인 사용만 필요하다면 다운로드 페이지에서 클라이언트를 선택하세요.
git clone https://github.com/MetaCubeX/mihomo.gitFIELD NOTES / 설정 기록
기본 연결을 마쳤다면 실제 문제에 맞는 주제별 안내를 확인하세요. 클라이언트를 옮길 때는 기존 설정을 보존하고, DNS를 조정할 때는 요청 경로를 먼저 확인하며, 코어를 비교할 때는 필요한 기능부터 살펴보세요. 한 번에 조건 하나만 변경해야 어떤 단계에서 차이가 생겼는지 알 수 있습니다.
테스트 페이지로 DNS 유출을 확인하고 fake-ip, nameserver-policy, TUN 하이재킹을 단계별로 설정해 DNS 요청이 외부로 새지 않도록 하는 방법을 안내합니다.
구형 클라이언트의 유지 관리가 중단된 뒤 설정을 옮기는 방법을 안내합니다. 구독과 사용자 지정 규칙을 내보내고 플랫폼별로 업데이트가 계속되는 대체 클라이언트를 골라 원활하게 전환하세요.
세대별 코어의 발전 과정을 살펴보고 프로토콜 지원, 규칙 문법, DNS 기능 차이를 비교합니다. 기존 설정을 mihomo로 옮길 때 어떤 필드를 수정해야 하는지도 설명합니다.
구독을 가져오지 못했다면 Clash 구독 업데이트 실패 안내를 확인하세요. 속도 측정 결과가 크게 달라진다면 Clash 노드 지연 시간 설명과 비교해 보세요. 플랫폼별 설치와 설정에 관한 자주 묻는 질문은 전체 문서의 자주 묻는 질문에 정리되어 있으므로 모든 설정을 처음부터 읽을 필요는 없습니다.