mihomo 코어·GPL-3.0 오픈 소스·규칙 기반 라우팅

Clash 중국어 공식 사이트클라이언트 다운로드 및 설정

Clash 다운로드 가이드 보기

플랫폼별 클라이언트를 선택하고 구독 가져오기, 규칙 기반 라우팅, 중국어 설정 문서를 확인하세요.

클라이언트 선택YAML 설정네트워크 문제 해결

CONFIGURATION / 설정 기능

규칙, 트래픽 처리 및 DNS

클라이언트는 조작 화면을 제공하고 코어는 연결을 처리합니다. 먼저 트래픽이 코어로 들어오는 경로를 확인한 뒤 규칙과 DNS를 점검하면, 여러 설정을 한꺼번에 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.

순서대로 규칙을 적용하고 정책에 따라 연결

규칙 모드는 목적지별로 서로 다른 연결 경로를 지정하며, 모든 연결이 프록시를 거친다는 뜻은 아닙니다. 코어는 설정된 순서대로 규칙을 확인하고 처음 일치하는 규칙의 정책을 적용합니다. 따라서 구체적인 도메인 규칙은 포괄적인 규칙보다 앞에 두고, 기본 처리 규칙은 맨 마지막에 배치해야 합니다. 처음 설정할 때는 구독에서 제공한 정책 그룹을 그대로 사용하고, 연결 목록에서 도메인, 일치한 규칙, 최종 연결 경로를 확인하는 것이 좋습니다. 아래 예시는 문법만 보여 줍니다. 로컬 네트워크 도메인과 사설 주소는 직접 연결하고 나머지도 직접 연결하므로 프록시 노드는 생성되지 않습니다. 실제 프록시를 연결하려면 대상 정책을 설정에 이미 존재하는 정책 그룹 이름으로 바꿔야 합니다. 존재하지 않는 이름을 참조하지 않도록 주의하세요.

config.yaml / 규칙 예시
mode: rule
rules:
  - DOMAIN-SUFFIX,lan,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

이 설정 일부는 필드의 의미를 이해하기 위한 예시이며 전체 구독 설정을 대체하지 않습니다. 클라이언트가 설정 파일을 자동으로 생성할 수 있으므로 수정하기 전에 덮어쓰기 위치를 확인하세요. 그렇지 않으면 다음 구독 업데이트 때 변경 사항이 사라질 수 있습니다.

PLATFORM / 플랫폼

데스크톱 및 모바일 기기

운영체제와 프로세서 아키텍처에 맞는 패키지를 선택하세요. 조작 화면, 백그라운드 권한, 네트워크 트래픽 처리 방식은 플랫폼마다 다릅니다.

CORE / 코어

mihomo

프록시 프로토콜, 규칙 매칭, 연결 처리를 담당합니다. 화면에 표시된 이름만으로 코어의 기능을 판단할 수는 없습니다.

PROTOCOL / 프로토콜

설정과 코어의 지원 범위 확인

노드 프로토콜, 전송 방식, 서버 매개변수가 서로 맞아야 합니다. 구독 형식이 호환된다고 해서 모든 필드를 사용할 수 있는 것은 아닙니다.

PACKAGE INDEX / 플랫폼별 다운로드

Clash 클라이언트 다운로드

먼저 운영체제를 선택한 다음 칩 아키텍처와 시스템 요구 사항을 확인하세요. 다운로드 페이지에서 클라이언트, 유지 관리 상태, 설치 안내를 확인할 수 있으며, 기능은 각 프로젝트 정보를 기준으로 합니다.

Windows

Clash Plus, Clash Verge Rev 등 데스크톱 클라이언트부터 살펴보세요. 설치 후 구독을 가져오고 시스템 프록시를 활성화하세요. 서비스 설치나 가상 네트워크 어댑터에 권한이 필요하면 안내에 따라 허용하세요. 노드 문제와 권한 문제를 혼동하지 않도록 주의하세요.

다운로드 페이지로 이동

macOS

먼저 Apple Silicon과 Intel 칩을 구분해 알맞은 설치 패키지를 선택하세요. 클라이언트를 실행한 뒤 메뉴 막대 상태와 시스템 프록시 설정을 확인합니다. 설치 중 필요한 시스템 권한과 연결에 사용할 정책 그룹은 서로 별개의 설정입니다.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android 등의 선택지를 확인하세요. 처음 연결할 때는 시스템 VPN 권한이 필요합니다. 장시간 백그라운드에서 사용하려면 배터리 최적화 설정도 확인하세요. 네트워크를 바꾼 뒤 연결이 끊기면 먼저 클라이언트가 계속 실행 중인지 확인하고, 다음으로 구독과 노드를 점검하세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 앱 안내에 따라 설정을 가져오고 VPN 연결을 허용한 다음 현재 설정이 활성화되어 있는지 확인하세요. 시스템에 VPN 연결 상태가 표시되더라도 대상 사이트의 트래픽이 프록시 규칙과 일치한다는 뜻은 아닙니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 Clash Verge Rev 또는 FlClash를 살펴보고, 배포판에 맞는 패키지 형식인지 먼저 확인하세요. 서버와 라우터에서는 독립 코어를 사용할 수도 있지만, 서비스 시작, 라우팅, 권한을 직접 관리해야 합니다. 그래픽 환경용 가이드를 데스크톱 환경이 없는 시스템에 그대로 적용하지 마세요.

다운로드 페이지로 이동

기존 클라이언트에서 옮길 때는 먼저 구독 출처, 사용자 지정 규칙, 정책 그룹 선택을 백업하세요. 시스템 프록시나 TUN 라우팅을 동시에 처리하는 클라이언트 두 개를 실행하면 포트, 시스템 설정, 가상 네트워크 어댑터가 서로 덮어쓸 수 있습니다. 보관된 클라이언트는 이전 설정을 확인하는 용도로만 사용하고, 익숙한 화면이라는 이유만으로 유지 관리 상태를 간과하지 마세요.

모든 클라이언트 보기 →

FIRST CONNECTION / 첫 설정

설치, 가져오기, 연결 확인

처음 설정할 때는 변경을 최소화하세요. 연결 하나가 제대로 작동하는지 확인한 다음 자동 속도 측정, 사용자 지정 규칙, 더 넓은 트래픽 처리 범위를 설정하세요.

  1. 환경에 맞는 클라이언트 선택

    다운로드 페이지에서 운영체제, 아키텍처, 유지 관리 상태를 확인하세요. 설치 후 클라이언트를 실행해 설정 목록과 연결 화면이 정상적으로 열리는지 확인합니다. 데스크톱에서는 기본 리스닝 포트를 우선 유지하고, 모바일에서는 시스템 VPN 권한을 준비하세요. PC에 다른 프록시 도구를 설치한 적이 있다면 이전 프로그램을 종료하고 남아 있는 시스템 프록시 설정을 확인하세요. 설치가 완료된 뒤에도 이전 포트로 연결되는 상황을 방지할 수 있습니다.

  2. 구독 설정 가져오기 및 활성화

    설정 또는 구독 페이지에서 기존 구독 주소를 추가하세요. 업데이트가 완료되면 해당 설정을 현재 설정으로 지정하고 노드와 정책 그룹이 표시되는지 확인합니다. 클라이언트 다운로드와 프록시 서비스는 별개입니다. 소프트웨어를 설치해도 사용할 수 있는 노드가 자동으로 생성되지는 않습니다. 구독 주소에는 보통 접근 정보가 포함되므로 공개 스크린샷이나 채팅방에 올리지 마세요. 가져오기에 실패하면 먼저 링크가 유효한지와 설정 형식이 맞는지 확인하세요.

  3. 규칙 모드에서 연결 확인

    사용할 수 있는 노드를 하나 선택하세요. 데스크톱에서는 시스템 프록시를 켜고 모바일에서는 안내에 따라 연결한 뒤, 대상 웹페이지에 접속해 연결 기록을 확인합니다. 요청이 코어에 들어왔는지, 올바른 규칙과 일치했는지, 연결 경로를 사용할 수 있는지 세 가지를 모두 확인해야 합니다. 앱 트래픽이 처리된다는 점은 실행 성공 메시지나 속도 측정 숫자만으로 입증되지 않습니다. 확인을 마친 뒤 필요에 따라 TUN을 활성화하세요.

설정을 조정할 때는 한 번에 한 항목만 바꾸고 변경 전 상태를 기록하세요. 웹페이지가 열리지 않으면 마지막으로 정상 접속했던 설정으로 되돌린 다음 구독, 노드, 모드, 트래픽 처리, DNS 순서로 확인하세요. 보통 재설치하는 것보다 원인을 찾기 쉽습니다.

전체 가이드 보기 →

SOURCE / 오픈 소스 및 유지 관리

Clash 생태계와 mihomo 코어

프로젝트, 클라이언트, 서비스 출처를 구분하세요. 설정의 호환성을 판단할 때는 소프트웨어 이름만 비교하지 말고 실제 코어, 필드 지원 여부, 프로젝트 유지 관리 정보를 확인해야 합니다.

프로젝트 이름과 코어의 발전 과정

Clash는 초기 프로젝트의 이름이자 규칙 기반 프록시 클라이언트 유형을 통칭하는 말로도 널리 쓰입니다. 원래 프로젝트와 일부 구형 클라이언트의 유지 관리가 중단된 뒤에도 생태계에는 독립적으로 관리되는 코어와 그래픽 인터페이스가 남아 있습니다. mihomo는 Clash Meta의 기술 방향을 이어받아 규칙 매칭, 프록시 프로토콜, 네트워크 스택 관련 기능을 제공합니다. 오래된 가이드의 버튼 이름이나 필드 작성 방식은 현재 클라이언트와 다를 수 있습니다. 문서를 참고할 때는 먼저 어떤 프로젝트를 다루는지 확인하고, 이름이 같거나 비슷하다고 해서 동일한 소프트웨어로 간주하지 마세요.

그래픽 클라이언트와 코어 프로세스

데스크톱 클라이언트는 보통 설정 관리, 정책 선택, 로그, 시스템 프록시 전환을 하나의 화면에 모은 뒤 코어를 호출해 연결을 처리합니다. 코어에서 특정 필드를 인식하더라도 모든 클라이언트가 해당 필드를 화면에서 설정할 수 있는 것은 아닙니다. 반대로 클라이언트의 덮어쓰기 기능이 구독의 원래 설정을 바꿀 수도 있습니다. 문제를 해결할 때는 편집기의 원본 파일만 볼 것이 아니라 실제 실행에 적용된 설정을 확인해야 합니다. 클라이언트를 변경할 때는 특히 설정 병합 순서, 규칙 덮어쓰기, 로컬 포트를 점검하세요.

코드 공개와 사용 범위

mihomo의 소스 코드, 라이선스, 변경 내역은 프로젝트 저장소에서 확인할 수 있습니다. 공개된 코드를 통해 구현을 살펴보고 문제를 제보하거나 수정 사항을 추적할 수 있지만, 오픈 소스 소프트웨어라는 사실이 제3자 구독 서비스의 품질을 보장하지는 않습니다. 클라이언트, 노드 제공업체, 대상 웹사이트는 각각 별개의 구성 요소입니다. 연결 기록은 문제 해결에 도움이 되지만 서비스 약관이나 사용 권한을 대신하지 않습니다. 네트워크 도구를 사용할 때는 거주 지역의 법률, 네트워크 관리 규정, 서비스 제공업체의 약관을 준수하세요.

업데이트 및 설정 관리

클라이언트 프로그램, 코어, 구독, 규칙 모음 업데이트는 각각 구분해서 확인해야 합니다. 프로그램 업데이트는 화면이나 연동 방식을 바꿀 수 있고, 코어 업데이트는 설정 필드와 네트워크 동작에 영향을 줄 수 있습니다. 구독 업데이트는 노드나 설정을 바꾸며, 규칙 모음 업데이트는 규칙 적용 범위를 변경합니다. 업데이트 전에 복구할 수 있도록 설정을 보관하고, 업데이트 후에는 직접 연결, 프록시, 로컬 네트워크, DNS를 각각 확인하세요. 이전과 동작이 달라졌다면 변경 내역을 참고해 원인을 좁히세요. 클라이언트, 노드, 전체 규칙을 한꺼번에 바꾸면 문제 원인을 파악하기 어렵습니다.

핵심 개념부터 일상적인 관리까지, 전체 가이드 읽기 →

TECHNICAL NOTES / 기술 노트

연결 문제 해결 및 설정 원리

증상에 맞는 안내를 확인하세요. 포트 리스닝, 트래픽 처리, 도메인 조회, 원격 연결을 구분한 뒤 해당 항목을 점검하면 모든 네트워크 문제를 노드 탓으로 돌리는 일을 줄일 수 있습니다.

모든 글 보기 →