Clash 생태계 · 클라이언트 및 설정 자료
플랫폼에 맞는 클라이언트를 선택하고 mihomo 커널, 규칙 기반 라우팅, 구독 가져오기 방법을 확인하세요.
CONFIGURATION / 설정 흐름
연결 경로부터 도메인 조회까지 네 단계로 설정을 이해하세요. 탭을 선택하면 내용을 계속 볼 수 있습니다.
규칙 모드는 설정에 적힌 순서대로 연결을 판별한 뒤 직접 연결, 프록시 그룹 또는 차단 정책으로 보냅니다. 먼저 구독에 포함된 규칙을 유지하고 사용할 수 있는 노드를 선택한 다음, 연결 기록에서 실제 적용된 규칙을 확인하세요. 모든 요청을 하나의 경로로 보내는 전역 모드와 달리 규칙 모드는 로컬 네트워크, 일반 웹사이트, 특정 도메인을 각각 다르게 처리할 수 있습니다. 규칙을 수정할 때는 구체적인 조건을 앞에, 기본 처리 규칙은 맨 뒤에 둡니다. 정책 그룹만 바꿔도 규칙 순서는 달라지지 않으며, 모든 앱의 트래픽이 프록시를 거치는 것도 아닙니다.
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,PROXYDNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. mihomo의 Fake-IP 모드는 도메인에 매핑 주소를 할당하고, 이후 연결에서도 도메인 정보를 유지해 규칙 판별에 활용합니다. 실제 주소를 바로 반환하는 조회 방식과는 다르므로 시스템 조회 결과만으로 문제를 판단하면 안 됩니다. 기기 검색, 로컬 네트워크 도메인 또는 특정 앱에 문제가 생기면 먼저 조회 요청이 커널에 전달되는지 확인하고, 필터 항목과 상위 DNS 서버를 점검하세요. 조회 모드를 바꾼 뒤에는 관련 캐시를 지우고 연결을 다시 설정해 이전 기록이 검증에 영향을 주지 않도록 합니다.
dns:
enable: true
enhanced-mode: fake-ip구독 가져오기는 원격 설정을 불러오는 기능이지 노드를 자동으로 만드는 기능이 아닙니다. 서비스 제공자가 안내한 호환 링크를 복사해 클라이언트의 구독 또는 설정 화면에 붙여넣고 가져오세요. 정책 그룹이 표시되는지 확인한 뒤 활성화하면 됩니다. 노드를 하나씩 직접 입력하는 방식과 달리 구독은 노드와 규칙을 한곳에서 업데이트하기 편리하지만, 클라이언트마다 지원하는 필드가 다를 수 있습니다. 업데이트에 실패하면 먼저 응답 내용을 확인해 로그인 페이지나 오류 페이지 등 엉뚱한 형식이 반환된 것은 아닌지 살펴보세요. 개인 설정을 덧붙일 때는 클라이언트가 지원하는 오버라이드 기능을 사용하세요. 구독 파일을 직접 수정하면 다음 업데이트 때 변경 내용이 사라질 수 있습니다.
proxy-providers:
remote:
type: http
interval: 3600여러 기기에서 같은 규칙을 활용할 수는 있지만 설정 전체가 모든 클라이언트에서 그대로 작동한다고 가정하면 안 됩니다. 데스크톱은 보통 시스템 프록시를 사용하고, 모바일은 로컬 VPN 인터페이스로 트래픽을 처리하며, 서버는 대개 커널과 서비스 관리자를 함께 사용합니다. 구독 동기화만으로는 설정 이전이 끝나지 않습니다. 포트, 파일 경로, 권한, DNS 동작도 확인해야 합니다. 먼저 한 기기에서 가져오기와 연결 검증을 마친 뒤 나머지 기기로 옮기세요. 라우팅이나 프록시 설정이 서로 덮어쓰는 일을 줄이려면 트래픽을 처리하는 도구는 한 번에 하나만 실행하세요.
mixed-port: 7890
allow-lan: false설정 예시는 필드 간 관계를 설명하기 위한 것으로, 그대로 사용할 수 있는 완성된 연결 설정이 아닙니다. 예시의 PROXY는 실제로 존재하는 정책 그룹이어야 합니다. 활성화하기 전에 클라이언트의 설정 검사 결과를 확인하세요.
CLIENTS / 플랫폼별 다운로드
운영체제를 먼저 선택한 다음 프로세서 아키텍처를 확인하세요. 설치 파일, 앱 스토어 링크, 커널 도구는 다운로드 페이지에서 각각 확인할 수 있습니다.
처음이라면 Clash Plus를 사용하거나 인터페이스와 설정 방식에 따라 Clash Verge Rev, FlClash 등을 선택할 수 있습니다. 시스템 설정의 ‘시스템 정보’에서 프로세서 유형을 확인한 뒤 맞는 설치 파일을 고르세요. 실행 후 설정을 가져오고 로컬 포트를 확인한 다음 시스템 프록시를 켭니다.
브라우저에서는 접속되지만 일부 앱이 직접 연결된다면 해당 앱이 시스템 프록시를 따르는지 먼저 확인하세요. 트래픽을 더 폭넓게 처리해야 한다면 TUN 및 권한 안내를 살펴보세요. 같은 수신 포트를 두고 여러 클라이언트를 동시에 실행하지 마세요.
다운로드 페이지로 이동먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon과 Intel을 구분하세요. 다운로드 페이지에는 각각에 맞는 파일이 안내되어 있으니 파일 확장자만 보고 호환 여부를 판단하지 마세요. 그래픽 인터페이스가 있는 클라이언트는 정책 변경, 구독 업데이트, 연결 기록 확인에 편리합니다.
설치 후 시스템 안내에 따라 필요한 권한을 허용하고 현재 네트워크 서비스의 프록시 설정을 확인하세요. Wi-Fi, 유선 네트워크 등 네트워크 서비스를 바꾼 뒤에는 프록시가 계속 작동하는지 다시 확인해야 합니다. 클라이언트를 종료하기 전에 트래픽 처리 기능을 끄면 기존 네트워크 경로로 복구하기 쉽습니다.
다운로드 페이지로 이동Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 기기 아키텍처와 클라이언트가 지원하는 설정 형식을 확인한 뒤 맞는 파일을 설치하세요. 처음 연결할 때는 시스템 안내에 따라 VPN 인터페이스 사용을 허용하고, 클라이언트에서 사용할 정책 그룹을 선택합니다.
백그라운드 연결이 끊기면 배터리 최적화 설정, 백그라운드 실행 권한, 다른 VPN 앱의 인터페이스 사용 여부를 확인하세요. 앱별 트래픽 분기와 도메인 규칙은 서로 다른 문제입니다. 한쪽을 바꾼 뒤에는 대상 앱을 다시 열어 연결 기록을 확인하세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 전에 스토어 페이지에서 시스템 호환성을 확인하세요. 구독을 가져온 다음 안내에 따라 VPN 구성을 추가하고 클라이언트로 돌아와 연결을 시작합니다.
상태 표시줄에 VPN 아이콘이 나타나도 인터페이스가 활성화됐다는 뜻일 뿐, 노드와 규칙이 제대로 작동한다는 의미는 아닙니다. 처음 테스트할 때는 직접 연결되어야 할 대상과 프록시를 거쳐야 할 대상을 각각 방문해 정책 선택을 확인하세요. 문제가 생기면 오류 메시지를 보존한 뒤 모바일 문제 해결 절차를 따르세요.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 사용하세요. mihomo 커널만 실행하는 방식은 서버, 라우터, 명령줄 환경에 적합합니다. 이 경우 설정 디렉터리, 실행 옵션, 서비스 관리 방식을 직접 준비해야 합니다.
프로세스 실행과 데스크톱 앱의 프록시 사용은 별개의 문제입니다. 먼저 수신 주소와 포트를 확인한 다음 시스템 또는 앱 프록시를 설정하세요. 명령줄 도구에는 별도의 환경 변수가 필요할 수도 있습니다. 장기간 실행할 계획이라면 먼저 포그라운드에서 설정 오류를 확인한 뒤 systemd에 등록하세요.
다운로드 페이지로 이동FIRST CONNECTION / 첫 연결
설치한 뒤 순서대로 진행하세요. 한 번에 한 종류의 설정만 바꾸면 문제 원인을 찾기 쉽습니다.
클라이언트의 ‘구독’ 또는 ‘설정’ 화면을 열고 원격 설정을 추가한 다음 호환 링크를 붙여넣으세요. 가져오기가 끝나면 해당 설정을 선택하고 노드와 정책 그룹이 표시되는지 확인합니다. 파일을 가져올 때는 서비스 제공자가 제공한 YAML 파일을 선택하세요. 웹페이지 내용을 설정 파일로 저장하면 안 됩니다.
구독 링크에는 계정 인증 정보가 포함되는 경우가 많습니다. 문제를 확인할 때는 링크에서 개인을 식별할 수 있는 정보를 가리고, 전체 주소를 공개 댓글이나 스크린샷에 올리지 마세요. 가져오기 오류가 나면 오류가 표시된 줄과 필드 이름을 확인한 뒤 네트워크 요청 실패인지 설정 내용 해석 실패인지 구분하세요.
작동 모드를 규칙으로 바꾸고 실제 프록시 연결에 사용하는 정책 그룹에서 노드를 선택하세요. 정책 그룹이 다른 그룹을 참조할 수 있으므로 최종 연결 경로까지 확인해야 합니다. 우선 구독의 기본 규칙과 DNS 설정을 유지하고 사용자 오버라이드는 추가하지 마세요. 반복해서 검증할 수 있는 기준 상태를 만드는 것이 좋습니다.
데스크톱에서는 먼저 시스템 프록시를 사용해 보세요. 모바일에서는 안내에 따라 VPN 인터페이스를 활성화합니다. TUN은 별도의 트래픽 처리 방식이지 노드를 빠르게 만드는 버튼이 아니며, 원격 서비스의 장애를 해결해 주지도 않습니다. 기본 연결을 확인한 뒤 앱에 필요한 경우에만 사용하세요.
직접 연결해야 할 대상과 프록시를 거쳐야 할 대상을 각각 열고 연결 화면에서 도메인, 적용 규칙, 최종 정책을 확인하세요. 노드 지연 시간 테스트가 성공해도 특정 테스트 요청에 응답했다는 뜻일 뿐, 대상 앱이 같은 경로로 연결된다는 보장은 없습니다. 앱에서 확인한 결과를 연결 기록과 비교하세요.
연결 기록이 없다면 먼저 트래픽이 제대로 전달되는지 확인하세요. 기록은 있지만 연결에 실패한다면 노드, DNS, 원격 응답을 살펴보세요. 작업 순서와 오류 정보를 기록한 뒤 문제 증상별 안내를 참고하세요. 기본 설정으로 되돌리기 전에 설정 사본을 보관해 정상 작동하던 기준을 잃지 않도록 합니다.
SOURCE / 오픈소스 자료
소스 코드, 설정 문서, 변경 내역을 살펴보고 기능의 범위를 파악하세요. 인터페이스의 이름만으로 실제 동작을 단정하지 마세요.
Clash 생태계에는 커널, 그래픽 클라이언트, 설정 도구, 규칙 자료가 포함됩니다. 원래의 Clash 프로젝트와 이후 생겨난 생태계 프로젝트를 하나의 제품으로 간주할 수는 없습니다. mihomo는 Clash Meta의 개발 흐름을 이어받아 Clash 설정 방식을 지원하는 네트워크 프록시 커널을 제공합니다. 클라이언트에 해당 커널이 포함될 수도 있고 다른 구현을 사용할 수도 있으므로 각 프로젝트의 안내를 확인하세요.
그래픽 인터페이스의 스위치는 시스템 기능을 호출하거나 커널 설정을 생성합니다. 같은 이름의 옵션이 다르게 작동하면 사용 중인 클라이언트, 커널, 플랫폼부터 확인한 뒤 관련 문서를 살펴보세요. 이전 설정을 새 클라이언트로 옮길 때 파일을 복사하자마자 기존 설정을 덮어쓰면 안 됩니다. 필드 지원 여부, 경로 참조, 정책 그룹 이름을 확인하고 항목별로 검증한 뒤 일상적으로 사용하는 설정을 바꾸세요.
mihomo 소스 코드는 GPL-3.0 라이선스로 공개되어 있습니다. 소스 저장소에서 구현을 읽고, 이슈 논의를 살펴보고, 변경 배경을 확인할 수 있습니다. 코드를 배포하거나 수정할 때는 라이선스 전문을 읽고 해당 의무를 이행해야 합니다. 오픈소스 커널에 적용된 라이선스가 모든 그래픽 클라이언트, 규칙 모음, 구독 서비스에도 똑같이 적용되는 것은 아니므로 각각의 프로젝트 안내를 확인하세요.
문제를 제보할 때는 재현 단계, 실행 플랫폼, 관련 설정 필드, 개인정보를 제거한 로그를 제공하세요. 구독 링크의 계정 인증 정보, 노드 자격 증명 등 개인 정보는 삭제하고 문제를 설명하는 데 필요한 최소한의 내용만 남기세요. ‘연결할 수 없음’이라는 화면 캡처만으로는 로컬 트래픽 처리, 도메인 조회, 원격 서비스 중 무엇이 문제인지 구분하기 어렵습니다.
클라이언트 업데이트, 커널 업데이트, 구독 업데이트는 각각 별개의 작업입니다. 클라이언트 업데이트는 인터페이스와 시스템 연동을 바꿀 수 있고, 커널 업데이트는 필드 동작과 프로토콜 구현에 영향을 줄 수 있습니다. 구독 업데이트는 노드, 정책 그룹, 규칙을 바꿀 수 있습니다. 문제가 생기면 최근에 어떤 종류의 변경이 있었는지 먼저 확인하세요. 여러 요소를 한꺼번에 이전 상태로 되돌리면 원인을 찾기 어렵습니다.
업데이트 전에 현재 설정과 사용자 오버라이드를 저장하고 프로젝트 릴리스 노트를 확인하세요. 업데이트 후에는 자주 사용하는 앱을 다시 테스트합니다. 이 사이트의 메인 페이지에서는 클라이언트 선택과 설정 흐름을 안내하며 설치 파일은 다운로드 페이지에 모아 두었습니다. 구체적인 시스템 요구 사항은 다운로드 페이지와 해당 프로젝트 자료를 확인하세요. 오래된 가이드와 실제 화면이 다르면 현재 클라이언트의 설정 이름과 설정 검사 결과를 기준으로 판단하세요.
클라이언트와 커널은 로컬 연결을 처리할 뿐, 사용할 수 있는 원격 서비스를 자동으로 제공하지 않습니다. 구독 출처, 서비스 이용 권한, 노드 상태, 로컬 네트워크 환경을 각각 확인해야 합니다. 설정을 성공적으로 불러왔다는 것은 문법과 일부 참조 항목이 검사를 통과했다는 뜻일 뿐, 모든 노드에 연결할 수 있거나 모든 앱이 분기 규칙을 따른다는 의미는 아닙니다.
처음에는 한 기기에서 최소한의 설정을 완료한 뒤 여러 기기 간 동기화, 로컬 네트워크 공유, 라우터 설치를 고려하세요. 로컬 네트워크 접근을 허용하기 전에 수신 주소와 접근 제어 방식을 이해하고, 공유할 때는 허용할 기기 범위를 명확히 정하세요. 네트워크 도구를 사용할 때는 해당 지역의 법률과 네트워크 서비스 약관을 준수하세요. 업무용 네트워크를 변경해야 한다면 먼저 필요한 승인을 받으세요.
FIELD NOTES / 설정 노트
게시일 내림차순입니다. 플랫폼 설치, 연결 시간 초과, 로컬 네트워크 구성을 각각 확인하고 서로 다른 문제를 한 번에 수정하지 마세요.
iOS에서 Clash 설정과 호환되는 클라이언트를 App Store에서 받는 방법부터 구독 링크 가져오기, VPN 프로파일 승인, 첫 연결 확인까지 안내합니다.
가져오기 단계 보기 →지연 시간 테스트가 모두 실패하거나 특정 노드에 연결할 수 없을 때 로컬 네트워크, 시스템 시간, 테스트 주소, 프로토콜 설정, 서버 상태를 차례로 확인해 시간 초과 원인을 찾습니다.
문제 해결 순서 보기 →라우터 또는 우회 라우터에서 커널을 직접 실행하는 방법을 살펴보고 TProxy와 Redir의 차이, 로컬 네트워크 기기의 게이트웨이 설정, DNS 트래픽 처리 요점을 설명합니다.
구성 방법 읽기 →