오픈 소스 클라이언트 · mihomo 커널

Clash 중국어 허브 모든 플랫폼용 클라이언트 다운로드

클라이언트 다운로드 정보를 찾고 규칙 기반 프록시를 이해한 뒤, 중국어 설정 가이드에 따라 구독을 가져오고 연결을 확인하세요.

오픈 소스 코드설정 시작하기프로토콜 참고

Clash 설정, 규칙 기반 프록시부터

먼저 클라이언트, 커널, 설정 파일의 차이를 알아본 다음 요청이 지나가는 경로를 따라 설정을 확인하세요. 아래 다섯 단계에서는 처음 사용할 때 자주 찾는 설정 항목을 다룹니다.

설정 단계 보기

규칙 기반 프록시: 목적지에 따라 연결 경로 선택

규칙 모드를 사용하면 직접 연결과 프록시 연결을 구분할 수 있어 모든 요청을 같은 경로로 보낼 필요가 없습니다. 커널은 설정된 순서에 따라 도메인, 주소 또는 규칙 세트를 확인하고, 일치하는 항목을 해당 정책 그룹으로 전달합니다. 웹사이트가 열리지 않으면 연결 기록에서 대상 도메인을 찾아 적용된 규칙과 실제 연결 경로를 확인한 뒤 규칙 순서를 조정하세요. 아래 도메인 접미사 규칙은 해당 도메인과 하위 도메인에 모두 적용되며, 정책 그룹 이름은 설정과 일치해야 합니다. 규칙 모드는 전체 프록시를 단순히 켜는 방식보다 로컬 서비스와 원격 리소스를 함께 이용하기에 적합하고, 각 연결이 어떤 경로를 선택했는지 확인하기도 쉽습니다.

↳규칙 문법 예시
DOMAIN-SUFFIX,github.com,Proxy

github.com 및 하위 도메인과 일치하는 요청을 Proxy 정책 그룹으로 전달합니다.

mihomo 커널: 설정 호환성 먼저 확인

그래픽 인터페이스와 프록시 커널을 나누어 이해하세요. 클라이언트는 구독, 권한, 조작 메뉴를 관리하고, mihomo는 설정을 해석해 연결을 만들고 트래픽을 분기합니다. Clash Meta는 이 커널의 발전 과정에서 널리 쓰인 이름이며, 현재 자료에서는 보통 mihomo라는 명칭을 사용합니다. 인터페이스에 표시된 이름만으로 프로토콜 지원 여부를 판단하지 마세요. 같은 클라이언트도 버전에 따라 탑재된 커널이 다를 수 있습니다. 설정을 가져올 때 알 수 없는 필드나 프로토콜 오류가 발생하면 먼저 클라이언트의 커널 정보와 설정 형식을 확인한 다음 업데이트 여부를 결정하세요. 기존 Clash 설정의 기본 필드는 상당수 그대로 쓸 수 있지만, 확장 프로토콜과 새 기능은 각각 호환성을 확인해야 합니다.

≡설정 읽기
config.yaml → mihomo
↳문제 해결 순서
커널 확인 → 필드 점검 → 로그 확인

TUN 모드: 트래픽 처리 범위 확대

먼저 시스템 프록시로 기본 연결을 확인한 뒤 TUN 사용을 검토하세요. 시스템 프록시는 앱이 시스템 설정을 따르는 경우에만 작동합니다. TUN은 가상 네트워크 인터페이스를 통해 라우팅되는 트래픽을 받아 시스템 프록시를 사용하지 않는 일부 프로그램도 처리할 수 있지만, 라우팅 설정과 제외 항목, 시스템 권한의 영향을 받습니다. 활성화하기 전에 서비스 모드, 네트워크 인터페이스 권한, DNS 설정을 확인하고 다른 가상 네트워크 도구와 라우팅을 동시에 변경하지 마세요. 브라우저는 접속되는데 명령줄 프로그램이나 게임은 연결되지 않는다면 처리 범위를 넓혀야 하는지 살펴보세요. TUN은 노드 프로토콜을 바꾸지 않으며 만료된 구독을 복구하지도 않습니다. 연결 문제가 발생하면 트래픽 처리 문제와 연결 경로 문제를 구분해야 합니다.

⌘설정 예시
tun:
  enable: true
  auto-route: true
예시 필드입니다. 활성화하기 전에 시스템 권한을 확인하세요.

구독 관리: 업데이트 후 활성화 상태 확인

구독 또는 설정 페이지에서 기존 주소를 가져오고, 클라이언트가 내용을 내려받아 해석할 때까지 기다린 뒤 사용할 설정을 직접 선택하세요. 구독 업데이트에 성공해도 설정을 가져왔다는 뜻일 뿐, 포함된 노드가 반드시 작동한다는 의미는 아닙니다. 유효 기간, 프로토콜 매개변수, 정책 그룹 선택, 연결 로그를 추가로 확인하세요. 규칙을 직접 추가할 때는 원격 업데이트로 덮어쓸 수 있는 파일을 바로 수정하지 말고 클라이언트의 덮어쓰기 또는 병합 기능을 우선 사용하세요. 구독 주소에는 개인 접근 정보가 포함될 수 있으므로 게시판에 올리거나 스크린샷에 노출하지 마세요. 도움을 요청할 때는 오류 내용을 남기되 전체 주소와 인증 정보는 숨기고, 문제가 생기기 전 변경 사항도 기록하세요.

↓구독 설정 순서
주소 가져오기 → 설정 업데이트 → 현재 설정으로 지정
≡로컬 규칙 관리
원격 구독과 로컬 덮어쓰기 설정은 따로 저장

크로스 플랫폼 클라이언트: 운영체제에 맞는 설치 파일 선택

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트별 설정 메뉴, 커널 기능, 유지 관리 상태를 비교하세요. 데스크톱에서는 시스템 프록시, 서비스 모드, 시작 시 실행 여부를 확인하고, 모바일에서는 VPN 권한, 백그라운드 실행, 네트워크 전환을 살펴보세요. 플랫폼마다 커널 구현이 다를 수 있습니다. 구독을 가져올 수 있더라도 모든 확장 필드가 그대로 호환되는 것은 아닙니다. 기기를 바꿀 때는 기본 설정을 먼저 가져와 규칙과 정책 그룹이 작동하는지 확인한 후 덮어쓰기 설정과 고급 기능을 하나씩 복원하세요. 이전 클라이언트에서 설정 파일이 열렸다는 이유만으로 현재 설정의 모든 프로토콜과 기능을 완전히 지원한다고 볼 수는 없습니다.

⚙설정 메뉴 예시
규칙 모드선택됨
시스템 프록시
현재 설정사용 중

기기에 맞는 Clash 클라이언트 선택

다운로드 페이지에서 플랫폼별 클라이언트, 설치 파일, 시스템 요구 사항을 확인할 수 있습니다. 먼저 운영체제를 선택하고 아키텍처를 확인한 다음 설치를 마치고 기존 설정을 가져오세요.

Windows

구독과 규칙을 컴퓨터에서 관리하기에 적합합니다. 시스템 정보에서 프로세서 아키텍처를 확인하고 설치한 뒤 시스템 트레이 메뉴, 시스템 프록시 스위치, 포트 사용 상태를 살펴보세요. TUN이 필요하면 클라이언트 안내에 따라 서비스를 설치하거나 시작하고 필요한 권한을 부여하세요. 구버전 대안을 찾을 때는 예전에 익숙했던 인터페이스 이름만 보지 말고 현재 유지 관리 중인 클라이언트를 우선 비교하세요.

다운로드 페이지로 이동

macOS

Apple Silicon과 Intel용 설치 파일을 구분하고 클라이언트의 최소 시스템 요구 사항을 확인하세요. 처음 실행할 때 시스템 안내에 따라 권한을 부여하고 메뉴 막대에서 클라이언트가 실행 중인지 확인하세요. 강화된 트래픽 처리 기능을 사용한다면 네트워크 확장 프로그램이나 보조 서비스의 상태도 점검하세요. 클라이언트를 바꾸기 전에는 기존 프록시를 종료해 두 도구가 동시에 네트워크 설정을 변경하지 않도록 하세요.

다운로드 페이지로 이동

Android

기기 아키텍처에 맞는 설치 파일을 선택하고 설정을 가져온 뒤 VPN 연결을 허용하세요. 일부 시스템에서는 백그라운드 실행이 제한될 수 있으므로 기기 설정에서 배터리 최적화와 백그라운드 활동 권한을 확인해야 합니다. Wi-Fi와 모바일 네트워크를 전환한 뒤 연결이 끊기면 먼저 VPN 상태와 노드 연결 기록을 확인하고 네트워크 환경이나 DNS 문제인지 살펴보세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 앱 스토어로 이동해 앱을 설치한 뒤 안내에 따라 VPN 설정을 추가하세요. 구독을 가져오기 전에 클라이언트가 지원하는 형식과 프로토콜을 확인하고, 데스크톱 설정의 모든 확장 필드를 그대로 사용할 수 있다고 가정하지 마세요. 연결한 뒤 현재 정책 그룹과 규칙 모드를 확인하세요. 특정 앱에서 문제가 발생하면 주문형 연결 설정과 해당 앱의 네트워크 설정도 점검해야 합니다.

다운로드 페이지로 이동

Linux

배포판에 맞는 설치 파일 형식을 선택하고 데스크톱 환경과 실행 종속성을 확인하세요. 그래픽 클라이언트는 일상적인 구독 관리에 적합하며, 서버나 라우터 사용자는 별도의 커널 사용 방법을 살펴볼 수 있습니다. 터미널 프로그램은 데스크톱 시스템 프록시를 사용하지 않을 수 있으므로 필요한 경우 환경 변수나 TUN 라우팅을 확인하세요. 브라우저 접속만으로 모든 프로그램의 트래픽이 처리된다고 판단해서는 안 됩니다.

다운로드 페이지로 이동

첫 설정, 세 단계로 완료

먼저 기본 연결을 확인한 다음 고급 설정을 추가하세요. 작동하는 설정을 하나 보관하고 이후에는 한 번에 한 항목씩만 변경하면 문제 원인을 찾기 쉽습니다.

  1. 구독 가져오기 및 활성화

    구독 또는 설정 관리 페이지를 열고 기존 구독 주소를 붙여 넣은 뒤 업데이트하세요. 설정 항목이 표시되면 현재 설정으로 지정하세요. 해석에 실패하면 먼저 주소가 완전한지, 응답 내용이 클라이언트 요구 사항에 맞는지 확인하세요. 클라이언트는 연결과 트래픽 분기 기능을 제공하며, 노드와 구독은 별도로 준비해야 합니다.

  2. 규칙 모드와 정책 그룹 선택

    실행 모드를 규칙으로 설정한 다음 프록시가 필요한 정책 그룹에서 사용 가능한 노드를 선택하세요. 데스크톱에서는 시스템 프록시를 켜고 모바일에서는 VPN 연결을 허용하세요. 처음 설정할 때 여러 옵션을 동시에 바꾸면 문제 원인을 구분하기 어려우므로 DNS와 트래픽 처리 설정은 우선 기본값으로 유지하세요.

  3. 대상 웹사이트를 열고 연결 기록 확인

    접속 확인이 필요한 웹사이트를 방문한 다음 클라이언트의 연결 또는 로그 페이지를 여세요. 요청이 커널에 전달되고 예상한 규칙과 올바른 연결 경로가 적용됐는지 확인하세요. 일부 앱에서만 실패한다면 앱의 프록시 설정과 TUN 필요 여부를 살펴보세요. 자동 업데이트와 시작 시 실행은 연결 확인을 마친 뒤 설정하세요.

전체 가이드 보기 →

오픈 소스 생태계와 커널 출처

프로젝트 출처, 클라이언트 유지 관리, 설정 호환성을 각각 확인하세요. 오픈 소스 저장소에서는 구현과 릴리스 정보를 확인할 수 있으며, 이 사이트는 다운로드 목록과 중국어 사용 자료를 제공합니다.

Clash에서 mihomo로

Clash 생태계는 커널, 그래픽 클라이언트, 설정 도구로 이루어져 있습니다. 초기 Clash는 많은 사용자에게 익숙한 규칙, 정책 그룹, 구독 사용 방식을 정립했고 이후 커뮤니티 프로젝트가 이를 바탕으로 발전했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤 클라이언트를 고를 때는 이름에 Clash가 포함됐는지만 보지 말고 실제 사용 커널, 지원 운영체제, 최근 유지 관리 상태를 확인하세요. 기존 설정은 마이그레이션의 출발점으로 활용할 수 있지만 모든 새 클라이언트에서 완벽하게 작동한다고 보장할 수는 없습니다.

인터페이스 업데이트와 커널 업데이트는 따로 확인

mihomo는 Clash Meta의 발전 방향을 이어받아 규칙 처리와 다양한 프로토콜 구현을 제공합니다. 그래픽 클라이언트는 커널을 바탕으로 구독 관리, 연결 확인, 권한 요청 기능을 제공하며 두 구성 요소의 업데이트 일정은 서로 다를 수 있습니다. 인터페이스를 업데이트한 뒤에도 커널이 함께 변경됐는지 확인하세요. 커널 업데이트 후에는 DNS, 라우팅, 설정 필드의 동작이 달라졌는지도 살펴봐야 합니다. 구현 내용을 확인하려면 아래 mihomo 저장소에서 소스 코드, 문서 링크, 릴리스 기록을 볼 수 있습니다.

릴리스 정보를 확인하고 업데이트 결정

먼저 변경 기록에서 현재 문제와 관련된 수정 사항을 찾은 뒤 업데이트 여부를 결정하세요. 업데이트 전에는 구독 외에 로컬 덮어쓰기 설정, 규칙, 설정 기록을 저장해 두세요. 업데이트 후에는 같은 대상으로 연결과 규칙 적용 결과를 확인하세요. 클라이언트에서 설정을 내보낼 수 있다면 로컬 수정 사항도 포함되는지 확인해야 합니다. 업데이트 후 문제가 다시 생기면 단순히 “연결되지 않음”이라고 설명하는 것보다 시스템 환경, 커널 정보, 오류 로그, 재현 절차를 기록하는 편이 커뮤니티에서 원인을 찾는 데 도움이 됩니다.

자료 사이트와 소프트웨어 프로젝트 구분하기

Clash 중국어 허브는 클라이언트 다운로드 경로와 사용 방법을 정리하며, 각 클라이언트 프로젝트의 개발팀을 대표하거나 프록시 노드 및 구독 서비스를 제공하지 않습니다. 페이지의 설정 예시는 사용 방법을 설명하기 위한 것이며, 실제 필드 지원 여부는 사용 중인 클라이언트와 커널 문서를 기준으로 확인하세요. 기기 권한, 라우팅, 백그라운드 실행을 변경할 때는 시스템 안내를 확인하고 영향을 이해해야 합니다. 네트워크 도구를 사용할 때는 해당 지역의 법률, 서비스 이용 약관, 네트워크 관리 규정을 준수하세요.

자료 관리 원칙 보기 → · 커널 관계 및 프로토콜 참고 →

Clash 설정 및 사용 가이드

첫 설치, 로컬 네트워크 공유, 클라이언트 선택 관련 자료를 확인하세요. 현재 단계의 문제를 해결한 뒤 고급 기능을 설정하세요.