• Clash 생태계 · mihomo 설정 자료

Clash 클라이언트 허브전 플랫폼클라이언트 다운로드

운영체제에 맞는 클라이언트를 선택하고 한국어 가이드를 따라 구독을 가져오세요. mihomo 코어와 규칙 분기 설정도 확인할 수 있습니다.

  • 오픈 소스 코드
  • 규칙 설정
  • 구독 관리

Clash 규칙 및 설정 항목

먼저 트래픽이 코어로 들어오는 경로를 파악한 다음, 규칙 매칭과 정책 선택, 도메인 해석 방식을 결정하세요.

규칙 기반 트래픽 분기 원리

위에서부터 규칙을 확인하고 일치하는 첫 규칙의 정책을 적용합니다

규칙 모드에서는 도메인, 대상 IP 또는 규칙 세트를 코어가 순서대로 확인합니다. 유효한 규칙과 처음 일치하면 해당 규칙의 정책을 적용하고, 뒤의 규칙은 더 이상 확인하지 않습니다. 따라서 특정 사이트에만 적용할 예외 규칙은 범위가 넓은 규칙보다 앞에 두고, 마지막에는 최종 대체 규칙인 MATCH를 배치하세요. 출구를 하나로 정하는 전역 모드와 달리 규칙 모드에서는 직접 연결, 프록시, 차단을 함께 사용할 수 있습니다. 설정을 바꾼 뒤에는 연결 목록에서 매칭된 규칙을 확인하세요. 프록시 그룹 이름은 설정에 정의된 이름과 일치해야 하며, 규칙 세트는 먼저 rule-providers에 선언해야 합니다.

  • mode
  • rules
  • rule-providers
rule 모드
mode: rule
rules:
  - DOMAIN-SUFFIX,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

PROXY는 정의된 프록시 그룹 이름과 일치해야 합니다.

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

클라이언트는 그래픽 인터페이스와 시스템 연동을 담당하고, 코어는 프록시 프로토콜과 규칙 실행을 담당합니다. 설치 전에 플랫폼, 프로세서 아키텍처, 설정 호환성을 함께 확인하세요.

Windows

Clash Plus부터 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu도 비교해 보세요. 먼저 시스템 정보에서 프로세서 아키텍처를 확인한 다음 해당 설치 파일을 선택하세요. 처음 실행하면 설정을 가져오고 시스템 프록시를 활성화하세요. 처음부터 모든 네트워크 가로채기 옵션을 켤 필요는 없습니다.

브라우저에서는 접속되지만 다른 앱에서는 안 된다면 먼저 해당 앱이 시스템 프록시를 사용하는지 확인한 뒤 TUN 모드를 검토하세요. 시작 시 자동 실행, 실행 후 자동 연결, 서비스 모드는 서로 다른 설정이므로 각각 확인해야 합니다. 그래야 재부팅 후 클라이언트는 실행됐지만 트래픽이 코어에 전달되지 않는 상황을 피할 수 있습니다.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 다운로드 센터에서는 Clash Plus, Clash Verge Rev, FlClash 등을 제공합니다. 설치 후 네트워크 권한과 설정 가져오기 결과를 확인하세요. 시스템 프록시는 해당 설정을 지원하는 앱에 주로 적용되며, 터미널에서는 프록시 환경 변수를 별도로 지정해야 할 수 있습니다.

유선 네트워크, 무선 네트워크 또는 도킹 스테이션을 바꾼 뒤 연결 문제가 생기면 현재 네트워크 서비스와 기본 경로를 다시 확인하세요. TUN을 사용할 때는 다른 VPN과의 충돌에 유의하세요. 프록시를 중지하기 전에 네트워크 가로채기 모드를 정상 종료해야 시스템이 기존 네트워크 설정을 복원할 수 있습니다.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android, FlClash 또는 Surfboard를 선택할 수 있습니다. 설정 형식은 클라이언트별로 확인하세요. 설치 파일을 고를 때 ARM64와 다른 아키텍처를 구분해야 합니다. 처음 연결할 때 시스템 VPN 요청을 승인해야 합니다. 이는 앱이 VPN 인터페이스를 통해 네트워크를 가로챌 수 있다는 뜻이지, 사용할 출구가 이미 설정됐다는 뜻은 아닙니다.

연결한 뒤에도 규칙 모드와 프록시 그룹을 확인하세요. 화면을 잠근 뒤 자주 연결이 끊기면 배터리 최적화, 백그라운드 실행, 제조사별 절전 정책을 점검하세요. 일부 앱만 프록시를 사용하지 않는다면 앱별 분기 설정을 확인하세요. 모바일 네트워크를 바꾼 뒤에는 상태 표시줄 아이콘만 믿지 말고 대상 사이트에 실제로 접속되는지 확인하세요.

다운로드 페이지로 이동

iOS

다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 제품 공식 사이트는 clashplus.io입니다. 설치한 뒤 클라이언트에 맞는 설정을 가져오고 시스템 VPN 권한을 승인한 다음 규칙 모드와 프록시 그룹을 선택하세요. 구독 링크는 신뢰할 수 있는 출처에서 받아야 하며 설정이 정상적으로 구문 분석되는지도 확인하세요.

처음 사용할 때는 브라우저 접속을 확인한 뒤 특정 앱도 테스트하는 것이 좋습니다. 연결 버튼에 켜짐으로 표시되어도 터널이 시작됐다는 뜻일 뿐입니다. 출구와 규칙이 제대로 설정됐는지 별도로 확인하세요. 네트워크를 바꾼 뒤 문제가 생기면 다시 연결하고 설정을 점검하세요. 서로 경쟁하는 VPN 가로채기 도구를 동시에 활성화하지 마세요.

다운로드 페이지로 이동

Linux

데스크톱에서는 Clash Verge Rev와 FlClash를 우선 비교해 보세요. 서버나 라우터에는 mihomo 코어를 직접 설치할 수 있습니다. 그래픽 클라이언트를 설치하기 전에 배포판의 패키지 형식과 프로세서 아키텍처를 확인하세요. 명령줄 코어를 사용할 때는 설정 디렉터리, 실행 권한, 백그라운드 서비스 실행 방식을 직접 준비해야 합니다.

데스크톱 시스템 프록시, 터미널 환경 변수, TUN 라우팅은 서로 다른 트래픽 진입 경로입니다. 명령줄 프로그램에서 프록시가 작동하지 않으면 현재 프로세스에 환경 변수가 전달됐는지 먼저 확인하세요. 백그라운드로 배포할 때는 서비스 로그와 실제 수신 포트를 기록하고, 코어 실행, 설정 로드, 앱 요청 순서로 정상 작동 여부를 점검하세요.

다운로드 페이지로 이동

클라이언트 이름이 비슷해도 설정 기능은 확인이 필요합니다

Clash는 생태계의 이름이지 모든 앱이 같은 코어나 인터페이스를 사용한다는 뜻은 아닙니다. 지원 프로토콜, 규칙 문법, 설정 오버라이드 방식, TUN 구현은 클라이언트마다 다를 수 있습니다. 기존 구독이 있다면 구독 형식을 먼저 확인하고 클라이언트를 선택하세요. 다른 클라이언트로 옮길 때는 기존 설정을 보관하고 DNS, 프록시 그룹, 규칙 세트를 하나씩 확인하세요. 다운로드 센터에서는 유지 관리 상태와 플랫폼별 옵션을 구분해 안내합니다. 보관된 클라이언트는 기존 환경을 참고할 때 유용하며, 새로 설치할 때는 지속적으로 관리되는 옵션을 우선 비교하세요.

Clash 구독 가져오기 및 연결 방법

먼저 최소한의 설정으로 연결을 확인한 다음 사용자 지정 규칙을 조정하세요. 단계마다 확인할 결과가 있어 문제가 생기면 해당 과정부터 다시 점검할 수 있습니다.

  1. 1단계

    클라이언트 설치 후 설정 가져오기

    다운로드 센터에서 운영체제와 아키텍처에 맞는 클라이언트를 선택하세요. 설정 또는 구독 페이지를 열어 링크나 로컬 파일을 가져오세요. 메뉴 이름은 설정, Profiles 또는 구독일 수 있습니다. 가져온 뒤 해당 설정이 활성화됐는지, 프록시 그룹과 노드 목록이 표시되는지 확인하세요. 클라이언트만 설치해서는 프록시 연결이 되지 않습니다.

    가져오기에 실패하면 네트워크 요청, 응답 내용, YAML 구문 분석 중 어느 단계에서 오류가 났는지 먼저 확인하세요. 웹 로그인 페이지, 구독 만료 안내, 다른 형식의 노드 목록은 완전한 설정으로 바로 사용할 수 없습니다. 원래 오류 메시지를 보관하고 구독 주소의 개인 매개변수는 가린 뒤 문제 해결 가이드의 순서에 따라 확인하세요.

  2. 2단계

    규칙 모드와 프록시 그룹 선택

    규칙 모드를 선택하고 프록시 트래픽을 처리하는 그룹에서 사용 가능한 노드를 고르세요. 구독마다 그룹 이름이 다르므로 고정된 이름만 찾지 말고 그룹의 용도를 확인해야 합니다. 데스크톱에서는 먼저 시스템 프록시를 활성화하고, 모바일에서는 안내에 따라 VPN 인터페이스를 승인하세요. 처음 테스트할 때는 DNS와 규칙을 그대로 유지해 여러 설정을 동시에 바꿔 생기는 혼란을 줄이세요.

    직접 연결은 로컬 네트워크 출구를 사용하고, 프록시는 선택한 노드를 거치며, 차단은 코어가 연결을 막습니다. 전역 모드는 노드가 작동하는지 확인하는 데 참고할 수 있지만 규칙 오류를 감추는 용도로 적합하지 않습니다. 노드 테스트로 후보 출구를 좁힌 뒤 실제 사이트 접속 여부도 별도로 확인하세요.

  3. 3단계

    접속 경로 확인 후 작동하는 설정 저장

    직접 연결될 사이트와 프록시를 사용할 사이트에 각각 접속해 보세요. 연결 목록에서 대상 도메인, 매칭된 규칙, 적용된 정책 그룹을 확인해 결과가 예상과 일치하는지 점검하세요. 브라우저에서는 접속되지만 다른 앱에서 실패한다면 구독 전체를 바로 바꾸지 말고 트래픽 진입 경로부터 확인하세요. 더 많은 트래픽을 가로채야 한다면 TUN 권한과 라우팅 안내를 확인하세요.

    검증이 끝나면 작동하는 설정을 저장한 뒤 시작 시 자동 실행, DNS, 사용자 지정 규칙을 하나씩 조정하세요. 한 번에 한 종류의 설정만 바꾸고 구성을 다시 불러온 뒤 재검증하면 문제가 생겼을 때 정확히 되돌릴 수 있습니다. 클라이언트를 종료하기 전에 네트워크 가로채기를 끄세요. 네트워크가 복구되지 않으면 시스템 프록시와 백그라운드에서 실행 중인 서비스를 확인하세요.

오픈 소스 코어와 클라이언트 생태계

프로젝트 간 관계와 설정 출처를 이해하면 앱 이름만 볼 때보다 호환성과 업데이트 위험을 더 정확히 판단할 수 있습니다.

Clash, Clash Meta, mihomo 비교

Clash 설정 모델은 프록시, 정책 그룹, 트래픽 분기 규칙을 하나의 파일로 구성합니다. 여러 그래픽 클라이언트가 이 모델을 바탕으로 설정 관리와 시스템 연동 기능을 제공합니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티에서는 다양한 구현이 이어졌습니다. mihomo는 한때 Clash Meta라는 이름으로 알려졌으며 관련 설정 방식은 유지하면서 프로토콜, 규칙, 네트워크 스택 기능을 확장했습니다. 이름이 비슷해도 기능이 완전히 같지는 않으므로 오래된 가이드를 참고할 때는 현재 코어 문서를 확인하세요.

인터페이스 업데이트와 코어 업데이트는 다릅니다

클라이언트 인터페이스는 구독 가져오기, 프록시 그룹 선택, 서비스 설치, 시스템 프록시 설정을 담당합니다. 코어는 연결 처리, DNS, 규칙 실행을 담당합니다. 클라이언트에 코어가 함께 포함될 수도 있고 별도로 교체할 수도 있습니다. 설정 호환성 문제가 생기면 앱 이름뿐 아니라 실제 실행 중인 코어 유형도 확인하세요. 설정을 이전할 때는 인터페이스의 스위치 구성만 비교하지 말고 새 프로토콜, 규칙 세트 형식, TUN 매개변수를 중점적으로 확인해야 합니다.

소스 코드 저장소

MetaCubeX / mihomo

프로젝트 저장소에서 소스 코드, 라이선스 파일, 변경 기록을 확인할 수 있습니다. 아래 명령은 저장소를 현재 디렉터리에 복제하며 열람이나 개발용입니다. 소스 코드를 복제해도 클라이언트가 자동으로 설치되거나 프록시 노드가 제공되지는 않습니다.

git clone https://github.com/MetaCubeX/mihomo.git
저장소 보기 ↗

커뮤니티의 이슈 기록을 살펴보면 알려진 동작을 이해하는 데 도움이 됩니다. 이슈를 제출하기 전에 재현 절차, 시스템 환경, 관련 로그를 정리하고 노드 인증 정보와 구독 링크의 개인정보를 삭제하세요. 비공개 구독 전체를 올리는 것보다 필요한 부분만 담은 간결한 설정이 문제를 파악하는 데 더 유용합니다.

업데이트 전에 작동하는 설정을 보관하세요

앱 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 앱 업데이트는 권한과 시스템 연동을 바꿀 수 있고, 코어 업데이트는 설정 구문 분석과 네트워크 스택에 영향을 줄 수 있습니다. 구독 업데이트는 노드, 규칙, DNS 설정을 바꿀 수 있습니다. 업데이트 전에 현재 모드, 프록시 그룹 선택, 오버라이드 설정을 기록하고 작동하는 사본을 보관하세요. 업데이트 후에는 기본 접속부터 테스트한 다음 복잡한 규칙을 다시 적용하세요. 문제가 생기면 전체 설정을 초기화하지 말고 최근에 바꾼 항목부터 되돌리세요.

한국어 자료의 이용 범위

이 사이트는 플랫폼 선택, 시작 절차, 설정 설명을 중심으로 정보를 제공합니다. 사이트 이름이 각 클라이언트를 같은 팀에서 개발했다는 뜻은 아닙니다. 구체적인 시스템 요구 사항, 라이선스, 기능 동작은 앱 안내와 코어 문서를 함께 확인하세요. 가이드의 설정 예시는 항목 간 관계를 설명하기 위한 것이며 실제 매개변수는 네트워크 환경에 맞게 조정해야 합니다. 프록시 서비스의 가용성, 트래픽, 구독 상태는 해당 서비스 제공자가 결정합니다. 클라이언트 설치 성공 여부와 네트워크 출구 사용 가능 여부는 따로 확인하세요.

설정 항목을 찾으려면 용어집을 확인하세요. 구독 업데이트 실패, 노드 시간 초과, DNS 문제, 시스템 프록시 미작동이 발생하면 문제 해결 페이지에서 증상별로 확인할 수 있습니다. 일반적인 사용 문의는 도움말 센터를 참고하세요. 문제가 발생한 계층부터 파악하고 적절한 조치를 선택하면 노드를 반복해서 바꾸거나 앱을 다시 설치하는 일을 줄일 수 있습니다.

Clash 사용 팁과 설정 기록

노드 선택, 속도 진단, 코어별 차이를 중심으로 입문 가이드에서 다루지 않은 판단 기준을 소개합니다.