오픈 소스 커널 · 모든 플랫폼용 클라이언트
Clash 튜토리얼
구독 가져오기부터 규칙 기반 라우팅까지, 플랫폼별 클라이언트를 찾아보고 항목별로 mihomo 설정을 점검하세요.
설정 점검 / CONFIG DESK
연결이 성립하는지, 트래픽이 어디로 흐르는지, 도메인을 어디서 조회하는지는 서로 다른 문제입니다. 해당 점검 항목을 먼저 찾아 설정 하나만 바꾸고 결과를 확인하세요. 모든 설정을 한꺼번에 건드리면 원인을 찾기 어렵습니다.
구독 주소는 설정을 업데이트하는 경로이지, 서버 주소 입력란에 바로 넣는 노드 주소가 아닙니다. 클라이언트의 설정 또는 구독 화면에서 원격 설정을 추가하고 전체 링크를 붙여 넣으세요. 업데이트가 성공하면 해당 설정을 선택해 활성화합니다. 파싱 오류가 나면 제공업체가 웹페이지나 로그인 안내, 다른 클라이언트용 노드 목록이 아닌 Clash YAML을 반환하는지 먼저 확인하세요. 노드를 하나씩 입력하는 방식보다 구독이 일괄 업데이트에 편리하지만, 다음 업데이트 때 로컬 수정 내용이 덮어써질 수 있습니다. 유지할 규칙은 클라이언트가 지원하는 오버라이드나 병합 설정에 넣으세요. 화면을 공유할 때는 접근 정보가 포함된 경우가 많은 구독 링크를 가리세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info이 내용은 필드를 확인하기 위한 발췌본이며 노드가 포함된 완전한 설정 파일이 아닙니다. 구독 가져오기 단계 보기 →
규칙 모드는 목록을 위에서 아래로 확인하며, 처음 일치한 규칙의 정책을 적용합니다. 정확한 도메인 규칙은 대상을 넓게 지정하는 지역 규칙보다 앞에 두고, MATCH는 마지막에 배치해 나머지 연결을 처리하세요. 규칙 끝에는 이미 정의된 프록시 그룹이나 내장 정책 이름을 입력해야 하며, 이름과 대소문자도 정확히 일치해야 합니다. 전역 모드와 달리 규칙 모드에서는 대상별로 출구를 다르게 지정할 수 있지만, 연결이 먼저 커널에 전달되어야 하고 상위 경로에서 도메인 정보가 사라지지 않아야 합니다. 테스트할 때는 웹페이지가 열리는지만 보지 말고 연결 상세 정보에서 적용된 규칙을 확인하세요. 기존 연결에는 변경 전 정책이 계속 적용될 수도 있습니다.
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT - MATCH,PROXY프록시 그룹은 규칙에 지정하는 정책 이름과 실제 출구를 분리합니다. select는 직접 선택할 때, url-test는 연결 테스트 결과에 따라 후보 출구를 자동 선택할 때 적합합니다. 두 방식의 용도는 다릅니다. 먼저 그룹에 사용 가능한 후보가 있는지 확인하고 현재 선택 항목을 살펴보세요. 그룹을 선택했다고 모든 연결이 그 그룹을 통과하는 것은 아닙니다. 규칙에서 해당 그룹을 참조하는지 확인해야 합니다. 규칙마다 노드 이름을 직접 넣는 것보다 프록시 그룹을 사용하면 노드를 바꿀 때 반복 수정이 줄어듭니다. 테스트 결과는 지정된 테스트 주소의 연결 상태만 보여줄 뿐 다운로드 속도를 의미하지 않습니다. 실제 연결이 실패하면 대상 서비스와 프로토콜 지원 여부도 확인하세요.
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT이 예시에는 직접 연결 후보만 있습니다. 실제로 사용할 때는 설정에 정의된 노드나 프록시 그룹을 추가하세요. 프록시 그룹 용어 보기 →
Fake-IP 모드에서는 도메인에 매핑 주소를 할당하고, 커널이 매핑 정보를 바탕으로 원래 도메인을 복원해 연결합니다. 예약 주소 대역이 보인다고 DNS 오류인 것은 아닙니다. 연결을 시작한 트래픽도 같은 커널에서 처리되는지가 중요합니다. 실제 주소를 반환하는 방식보다 Fake-IP는 DNS 조회와 트래픽 전달 경로의 연동이 중요합니다. 로컬 네트워크 기기 검색, 일부 게임, 특수 기기는 예외 처리가 필요할 수 있습니다. 클라이언트의 내장 DNS가 실제로 활성화됐는지 먼저 확인하고, 필요한 도메인만 필터링하세요. 앱 하나 때문에 전체 설정을 바꾸는 것은 권장하지 않습니다. 시스템 캐시와 브라우저 자체의 암호화 DNS도 테스트 결과에 영향을 줄 수 있습니다.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"시스템 프록시는 시스템 설정을 따르는 앱에 프록시 경로를 제공하지만 모든 프로그램의 트래픽을 자동으로 가져오지는 않습니다. TUN은 가상 네트워크 인터페이스를 통해 트래픽을 전달하며, 보통 별도의 권한과 라우팅 설정, DNS 연동이 필요합니다. 먼저 시스템 프록시로 구독과 규칙을 확인한 뒤 앱 요구에 따라 TUN을 활성화하세요. 한 번에 변수를 너무 많이 늘리지 않는 것이 좋습니다. 브라우저 프록시만 변경하는 것보다 TUN의 적용 범위가 넓지만, 다른 VPN이나 가상 네트워크 어댑터, 보안 프로그램과 라우팅 충돌이 생길 가능성도 큽니다. 문제를 점검할 때는 중복으로 트래픽을 가로채는 도구를 먼저 끄고 새 연결 로그를 확인하세요. 클라이언트를 종료한 뒤 네트워크에 문제가 생기면 시스템 프록시가 원래대로 복구됐는지도 살펴보세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53클라이언트에서 TUN을 관리한다면 설정이 서로 덮어쓰이지 않도록 우선 앱 화면의 스위치를 사용하세요. 트래픽 가로채기 문제 해결 보기 →
설치 경로 / PLATFORM BAY
데스크톱 설치 파일, 모바일 앱, 명령줄 커널은 서로 다른 배포 형태입니다. 먼저 운영체제를 확인하고 프로세서 아키텍처를 선택한 다음 필요한 프로토콜과 설정 기능을 확인하세요. 다운로드 페이지에서 플랫폼별 클라이언트와 설치 경로, 유지 관리 상태를 확인할 수 있습니다. 홈페이지에는 설치 파일을 섞어 두지 않습니다.
처음 사용하는 경우 Clash Plus를 먼저 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. Clash for Windows 대체 앱을 찾는다면 화면이 비슷한지만 보지 말고 구독 호환성, 서비스 모드, 설정 오버라이드 방식을 확인하세요.
설치 전에 운영체제와 프로세서 종류를 확인하세요. 처음 실행하면 설정을 가져온 뒤 시스템 프록시를 켜세요. 브라우저는 되는데 다른 프로그램이 연결되지 않으면 해당 앱이 시스템 프록시를 따르는지 확인한 뒤 TUN을 고려하세요. 시작 프로그램 설정과 백그라운드 서비스는 별개이며 권한 요청도 각각 처리해야 합니다.
다운로드 Windows 클라이언트먼저 Apple Silicon과 Intel 중 어떤 프로세서인지 확인한 다음 Clash Plus, Clash Verge Rev, FlClash에 맞는 설치 파일을 선택하세요. 기기 외관보다 시스템 설정의 칩 정보가 정확합니다. 아키텍처가 맞지 않으면 실행되지 않거나 별도의 호환 환경이 필요할 수 있습니다.
처음 실행할 때는 시스템 안내에 따라 권한을 허용하세요. 네트워크를 가로채기 전에 다른 도구가 프록시나 라우팅을 동시에 변경하고 있지 않은지 확인합니다. 기존 설정을 옮길 때는 원본 파일을 복사해 두고 로컬 경로, 외부 규칙 파일, 프로세스 규칙을 중점적으로 확인하세요. 다른 운영체제에서 쓰던 내용을 그대로 옮길 수 없는 경우가 있습니다.
다운로드 macOS 클라이언트필요에 따라 Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 앱마다 구독 형식, 스크립트 기능, 커널이 다릅니다. 특정 노드 링크를 가져올 수 있다고 해서 Clash 설정 전체와 호환되는 것은 아닙니다.
연결을 시작할 때는 보통 시스템 VPN 권한을 확인해야 합니다. 장시간 백그라운드에서 사용할 경우 기기의 배터리 관리 설정에서 백그라운드 제한을 확인하세요. 모든 권한을 무조건 허용할 필요는 없습니다. 모바일 데이터와 Wi-Fi를 전환한 뒤 문제가 생기면 연결을 다시 설정하고 DNS 및 앱별 프록시 설정을 확인하세요.
다운로드 Android 클라이언트다운로드 페이지에서 Clash Plus의 App Store 페이지와 공식 사이트 clashplus.io를 확인할 수 있습니다. 가져오기 전에 구독 형식이 앱 기능과 호환되는지 확인하세요. 설정 파일에 특정 필드가 있어도 모든 모바일 앱에서 해당 기능이 적용되는 것은 아닙니다.
처음 연결을 활성화할 때 시스템 안내에 따라 VPN 구성을 추가한 다음 현재 설정과 정책 선택을 확인하세요. 모바일 기기는 시스템 네트워크 확장 기능의 제약을 받으므로 데스크톱의 서비스 모드, 프로세스 매칭, 로컬 파일 작업을 그대로 적용할 수 없습니다. 앱에서 실제로 제공하는 옵션과 안내를 기준으로 설정하세요.
다운로드 iOS 클라이언트데스크톱 사용자는 Clash Verge Rev와 FlClash를 비교하고 배포판에 맞는 패키지를 선택하세요. GUI 클라이언트는 데스크톱 환경과 시스템 구성 요소에 의존합니다. 설치는 완료됐는데 창이 열리지 않으면 구독을 반복해서 바꾸기보다 누락된 의존성과 실행 로그부터 확인하세요.
서버와 라우터에서는 다운로드 페이지에서 mihomo 커널을 찾아 아키텍처와 실행 환경에 맞게 설치할 수 있습니다. 명령줄 커널에는 완전한 데스크톱 인터페이스가 포함되지 않으므로 설정 디렉터리, 권한, 서비스 실행, 로그 순환을 직접 관리해야 합니다. 원격으로 디버깅할 때 제어 인터페이스를 공용 네트워크에 직접 노출하지 마세요.
다운로드 Linux 클라이언트업스트림 및 유지 관리 / SOURCE NOTES
클라이언트는 사용자 인터페이스를 제공하고, 커널은 연결과 규칙을 처리하며, 구독은 설정 내용을 제공합니다. 이 세 계층을 나눠 봐야 설정을 바꿀지, 구성을 교체할지, 업스트림 문서를 확인할지 판단할 수 있습니다.
Clash는 YAML 설정, 프록시 그룹, 규칙 매칭을 중심으로 한 사용 방식을 구축했습니다. 이후 여러 커뮤니티 포크와 GUI 클라이언트가 등장했습니다. Clash.Meta는 이 생태계의 확장 포크이며, 관련 커널 프로젝트는 이후 mihomo라는 이름으로 개발을 이어가고 있습니다. 오래된 가이드에서는 Meta, Clash Meta, mihomo라는 이름이 함께 쓰일 수 있습니다. 이는 프로젝트의 발전과 명칭 변경을 반영하는 것으로, 서로 완전히 별개의 사용자 인터페이스 세 가지를 뜻하지는 않습니다.
원래 프로젝트와 확장 커널은 지원 기능의 범위가 서로 다릅니다. 새 프로토콜, DNS 필드, 규칙 기능, 플랫폼 지원 여부는 클라이언트 이름에 Clash가 들어 있는지가 아니라 실제 실행 중인 커널을 기준으로 확인해야 합니다. 이 사이트는 다운로드 및 한국어 가이드 참고용이며 각 클라이언트나 커널 프로젝트의 공지 채널을 대신하지 않습니다. 구현 세부 정보를 확인하려면 해당 프로젝트의 문서, 소스 코드, 릴리스 노트를 참조하세요.
같은 커널을 여러 클라이언트에서 사용할 수 있고, 비슷한 인터페이스의 클라이언트라도 서로 다른 커널을 쓸 수 있습니다. GUI는 구독 관리, 프록시 전환, 시스템 연동, 로그 표시를 담당하고, 커널은 설정 문법, 연결 프로토콜, 규칙 실행을 결정합니다. 화면에 특정 스위치가 없다고 해서 커널에서 설정할 수 없는 것은 아닙니다. 반대로 구독 파일을 불러올 수 있더라도 모든 필드가 지원되어 적용되는 것은 아닙니다.
선택하기 전에 필요한 기능을 정리하세요. 규칙 오버라이드가 필요한지, 특정 프로토콜에 의존하는지, 앱별 트래픽 처리가 필요한지, 여러 기기에서 설정을 옮겨 써야 하는지 확인합니다. 그런 다음 클라이언트 안내와 실행 로그에서 커널 정보를 살펴보세요. 프로토콜 차이와 모바일 환경의 리소스 제약은 기술 참고 자료에서 항목별로 비교할 수 있습니다. 단 한 번의 연결 테스트나 인터페이스의 녹색 상태만으로 결론 내리지 마세요.
구독 업데이트는 원격 설정을 가져오고, 소프트웨어 업데이트는 앱이나 함께 제공되는 커널을 교체합니다. 한쪽이 다른 쪽을 대신하지 않습니다. 구독 내용이 바뀌면 노드 이름, 규칙 대상, 프록시 그룹 참조가 달라질 수 있습니다. 소프트웨어 업데이트로 새 필드가 추가되거나 기본 동작이 바뀌고 호환성 문제가 해결될 수도 있습니다. 업데이트 전에 설정과 로컬 오버라이드를 보관하고, 업데이트 후에는 로그를 확인한 다음 자주 쓰는 앱으로 검증하세요. 모든 스위치를 처음부터 다시 설정할 필요는 없습니다.
원격 구독이 로컬 변경 사항을 덮어쓴다면 업데이트를 전부 중단하지 말고 클라이언트의 영구 오버라이드 기능을 찾아보세요. GeoIP, GeoSite, 규칙 세트는 각각 데이터 출처와 업데이트 주기가 다릅니다. 라우팅이 달라졌다면 먼저 설정이나 데이터 파일이 바뀌었는지 확인한 뒤 소프트웨어 자체를 점검하세요. 이 순서대로 살펴보면 어제까지 되던 연결이 오늘 갑자기 안 되는 문제도 검증 가능한 원인별로 나눌 수 있습니다.
소스 코드의 장점은 기능 구현, 설정 예시, 문제 논의, 변경 기록을 직접 확인할 수 있다는 점입니다. 다운로드 전에 프로젝트 이름과 클라이언트가 일치하는지 확인하고, 설정을 살펴볼 때는 현재 커널의 문서를 우선 참고하세요. 오래된 화면 캡처는 해당 필드가 아직 유효한지 확인해야 합니다. 저장소의 별이 많다고 모든 기기에 적합한 것은 아니며, 활발한 논의가 곧 수정 사항의 출시를 뜻하지도 않습니다. 실제 문서와 릴리스 내용을 기준으로 판단하세요.
문제를 제보할 때는 운영체제, 클라이언트 이름, 커널 정보, 재현 단계, 민감 정보를 제거한 로그를 제공하세요. 전체 구독 링크, 노드 비밀번호, 제어 인터페이스 인증 정보를 공개하지 말고 설정 파일 전체를 공개 토론에 붙여 넣지 마세요. 최소한의 설정으로 재현할 수 있으면 원인을 찾기 쉽습니다. 관련 없는 규칙과 오버라이드를 먼저 제거하고 오류가 계속되는지 확인한 뒤 필요한 맥락을 추가하세요.
기술 노트 / WORK LOG
입문 가이드에서는 연결 절차를 안내하고, 기술 노트에서는 세부 필드와 예외 상황을 다룹니다. 수정 전에 설정을 관리하는 주체를 확인하고, 수정 후에는 새 연결로 결과를 검증하세요. 한 번에 한 항목만 바꿔야 로그를 비교하기 쉽습니다.
Fake-IP가 198.18.0.1/16 주소 대역을 사용해 DNS 응답을 처리하는 방식을 설명합니다. redir-host 방식과의 차이, fake-ip-filter의 용도, 로컬 네트워크 및 게임에서 유의할 점도 함께 살펴봅니다.
노트 읽기 →DOMAIN, DOMAIN-SUFFIX, IP-CIDR, PROCESS-NAME 등 규칙 유형의 문법을 정리하고, 위에서 아래로 적용되는 우선순위와 no-resolve의 의미, MATCH 기본 규칙 작성법을 설명합니다.
노트 읽기 →GeoIP와 GeoSite 데이터 파일의 역할과 출처를 설명하고, mihomo의 geox-url 및 자동 업데이트 설정 방법과 GEOIP, GEOSITE 규칙의 올바른 작성법을 안내합니다.
노트 읽기 →