mihomo 코어 · 전체 플랫폼 클라이언트 업데이트

Clash 중국 공식 사이트전체 플랫폼 클라이언트 다운로드

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기, 규칙 기반 라우팅, 문제 해결 단계를 확인하세요.

오픈소스 생태계YAML 설정한국어 가이드

규칙 기반 라우팅
클라이언트 주요 설정

설정 가이드 보기

Clash 사용 과정은 세 단계로 나눌 수 있습니다. 설정은 사용할 프록시와 규칙을 정하고, 모드는 연결을 처리하는 방식을 결정하며, 시스템 프록시나 TUN은 어떤 트래픽을 클라이언트로 보낼지 정합니다. 먼저 각 단계의 역할을 구분한 뒤 기능을 하나씩 켜면 여러 설정을 한꺼번에 바꾸는 것보다 결과를 재현하고 문제를 찾기 쉽습니다.

아래 화면은 설정 예시이며 실제 실행 중인 클라이언트 화면이 아닙니다. 앱마다 메뉴 이름과 위치는 다를 수 있지만 구독, 프록시 그룹, 규칙, DNS의 기본적인 관계는 같습니다. 탭을 선택해 기능별 설명을 볼 수 있으며, 직접 조작하면 선택한 탭이 유지됩니다.

Clash · 구독 관리 예시

구독 추가

구독 링크 · 예시
+https://example.com/sub?token=xxxx
설정 업데이트다운로드가 완료된 것을 확인한 뒤 활성화하세요
설정 가져오기

클라이언트 다운로드
운영체제와 아키텍처에 맞게 선택

전체 클라이언트 보기 →

클라이언트는 조작 화면과 백그라운드 기능이 결합된 앱으로, 운영체제마다 설치 방법, 권한 승인 절차, 네트워크 연결 방식이 다릅니다. 처음 선택한다면 다운로드 센터에서 우선 추천하는 Clash Plus를 사용해 볼 수 있습니다. Linux 사용자는 Clash Verge Rev와 FlClash도 확인하세요. 기존 설정이 있다면 옮기기 전에 코어 호환성과 필요한 기능을 확인하세요. 화면이 달라졌다는 이유만으로 구독과 규칙까지 한꺼번에 바꿀 필요는 없습니다.

설치 전에 시스템 정보에서 프로세서 아키텍처를 확인하세요. 이름이 비슷한 설치 파일도 서로 다른 아키텍처용일 수 있으므로 파일 크기만으로 판단하면 안 됩니다. 다운로드 페이지에서 클라이언트와 시스템 요구 사항을 한눈에 확인할 수 있습니다. 홈페이지의 플랫폼 바로가기는 해당 운영체제 정보를 찾도록 안내할 뿐, 설치 파일을 바로 내려받지 않습니다. 이전 클라이언트의 보관 버전에는 유지보수 상태가 표시되어 일상 사용과 과거 설정 참고용을 구분할 수 있습니다.

Windows

데스크톱 브라우저와 일반 앱 사용에 적합합니다. 먼저 시스템 요구 사항과 프로세서 아키텍처를 확인한 뒤 필요에 따라 시스템 프록시나 서비스 모드를 활성화하세요. 클라이언트를 실행해도 모든 프로그램이 자동으로 프록시에 연결되는 것은 아닙니다.

다운로드 페이지로 이동

macOS

Apple Silicon용과 Intel용 설치 파일을 구분하세요. 처음 실행할 때는 시스템 안내에 따라 권한을 승인하고, 네트워크 기능을 켜기 전에 시스템 프록시 설정을 확인하세요. 앱을 종료한 뒤 기존 네트워크 상태가 복구되었는지도 살펴보세요.

다운로드 페이지로 이동

Android

설치 후 설정을 가져오고 처음 연결할 때 시스템 VPN 권한을 승인하세요. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 노드만 반복해서 바꾸지 마세요.

다운로드 페이지로 이동

iOS

Clash Plus의 App Store 페이지를 확인하세요. 공식 사이트는 clashplus.io입니다. 설치 후 앱 안내에 따라 설정을 추가하고 VPN 권한을 승인한 다음, 연결 전에 사용할 구독과 프록시 그룹이 선택되어 있는지 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 그래픽 클라이언트를 우선 사용하고 배포판에 맞는 패키지 형식을 선택하세요. 서버나 라우터 사용자는 코어 섹션을 참고해 설정 경로, 프로세스 권한, 백그라운드 서비스를 직접 관리할 수 있습니다.

다운로드 페이지로 이동

어떤 클라이언트를 선택할지 모르겠다면 먼저 클라이언트 비교를 확인하세요. 플랫폼 지원, 설정 관리, 네트워크 트래픽 처리 방식을 중점적으로 비교하면 됩니다. 클라이언트 이름과 코어 이름, 구독 서비스를 혼동하지 마세요. 프로그램을 설치하는 것만으로 사용할 수 있는 프록시 노드가 생기지는 않습니다.

구독 가져오기
연결 확인까지 3단계

전체 가이드 보기 →

처음 설정할 때는 사용할 수 있는 설정 하나, 명확하게 선택한 프록시 그룹 하나, 활성화된 네트워크 연결 기능 하나로 최소한의 구성을 먼저 완성하세요. 다른 옵션은 그대로 둔 채 연결이 정상인지 확인한 다음 자동 업데이트, 라우팅 예외, LAN 공유 설정을 추가하세요. 이렇게 하면 문제가 생겼을 때 어느 단계에서 달라졌는지 쉽게 찾을 수 있습니다.

구독을 가져와 활성화

클라이언트의 구독 또는 설정 페이지에서 전체 주소를 붙여 넣고 가져오기를 실행하세요. 설정 이름이 표시되면 현재 사용할 설정으로 지정했는지 확인하고 프록시 그룹이 로드되었는지도 살펴보세요. 형식 오류가 표시되면 링크가 설정 내용으로 응답하는지 먼저 확인하세요. 일반 웹페이지 주소를 구독 주소로 입력하면 안 됩니다.

구독 가져오기 단계 보기 →

모드와 네트워크 연결 방식 선택

규칙 모드를 선택하고 해당 프록시 그룹에서 사용할 수 있는 노드를 지정하세요. 데스크톱에서는 먼저 시스템 프록시를 켜고, 시스템 프록시를 따르지 않는 앱까지 처리해야 한다면 TUN을 테스트하세요. 모바일에서는 안내에 따라 VPN 권한을 승인하고 같은 종류의 네트워크 연결을 사용하는 다른 앱이 동시에 실행되지 않도록 하세요.

프록시 모드 설명 보기 →

연결 상태와 로그 확인

접속할 사이트를 열고 클라이언트의 연결 목록에서 요청이 표시되는지, 어떤 규칙이 적용되었는지, 어떤 경로로 나가는지 확인하세요. 연결이 정상이라면 다른 앱도 테스트하면 됩니다. 요청 기록이 없다면 노드 프로토콜이나 DNS를 바꾸기 전에 먼저 트래픽이 클라이언트로 들어오는지 확인하세요.

인터넷 연결 문제 해결 방법 보기 →

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

설정 가이드 읽기

클라이언트·코어·설정의 역할 구분하기

Clash 생태계에서 그래픽 클라이언트는 구독 관리, 프록시 선택, 시스템 연동을 제공하고, 코어는 프로토콜 연결, DNS 처리, 규칙 매칭을 수행합니다. 설정 파일은 노드, 프록시 그룹, 규칙 간의 관계를 정의합니다. 화면에 표시되는 앱 이름이 실제 사용 중인 코어 이름과 다를 수 있습니다. 설정을 다른 앱으로 옮길 수 있는지는 대상 코어가 지원하는 필드와 프로토콜, 클라이언트의 오버라이드 방식에 따라 달라집니다. 파일 확장자가 같다는 이유만으로 호환된다고 판단하지 마세요.

mihomo는 Clash Meta의 기술적 방향을 이어받은 프로젝트로, 현재 Clash 생태계에서 널리 쓰이는 오픈소스 코어입니다. 과거 문서에는 Clash, Clash Meta, 현재 클라이언트 이름이 혼용될 수 있으므로 구체적인 프로젝트를 확인하며 읽어야 합니다. 오픈소스라고 해서 모든 클라이언트의 화면과 기본 설정이 동일한 것은 아닙니다. 문제를 찾을 때 클라이언트 이름, 운영체제, 실제 코어 정보를 기록하면 현재 환경에 맞지 않는 해결 방법을 적용하는 일을 줄일 수 있습니다.

공개 저장소에서 구현과 변경 내역 확인

mihomo 프로젝트는 GPL-3.0 라이선스로 공개되어 있으며 소스 코드, 커밋 기록, 이슈 논의를 공개 저장소에서 확인할 수 있습니다. 변경 내역을 살펴보면 설정 필드, 프로토콜 지원, 네트워크 동작이 바뀌었는지 판단하는 데 도움이 됩니다. 별 수, 다운로드 수, 지연 시간으로 연결 품질을 나타내지는 않습니다. 프록시 사용 경험은 서버, 네트워크 경로, 로컬 설정에도 영향을 받습니다. 공개 소스는 구현을 추적할 근거이지 모든 연결의 성능을 보장하지 않습니다.

일반 사용자는 코어를 직접 빌드할 필요가 없습니다. 그래픽 클라이언트를 사용한다면 해당 클라이언트의 업데이트 안내를 따르고 통합된 코어와 설정이 호환되는지 확인하세요. 코어를 직접 교체하면 권한, 경로, 인터페이스 호환성 문제가 생길 수 있으므로 설정을 복구할 수 있는 사용자에게 적합합니다. 서버에 배포할 때는 작업 디렉터리, 로그 위치, 시작 인수를 명확히 지정하세요. 데스크톱 클라이언트의 버튼 조작법을 백그라운드 서비스에 그대로 적용하면 안 됩니다.

mihomo / GPL-3.0

코어 소스 코드 가져오기

아래 명령은 공개 저장소를 복제해 소스 코드를 읽거나 개발 환경을 준비하는 용도입니다. 데스크톱 클라이언트를 설치하지 않으며 프록시도 자동으로 설정하지 않습니다.

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

설정과 문제 신고 시 유의사항

구독 주소에는 인증 정보가 포함될 수 있습니다. 다른 사람에게 도움을 요청할 때는 전체 링크, 계정 정보, 서버 인증 내용을 숨기세요. 로그에도 방문한 도메인, 기기 주소, 파일 경로가 포함될 수 있으므로 공유하기 전에 내용을 확인하고 불필요한 정보는 삭제하세요. 문제를 설명할 때는 증상, 재현 절차, 적용된 규칙, 오류 유형을 남기면 원인 파악을 시작하기에 충분합니다. 개인 설정 전체를 공개할 필요는 없습니다.

규칙 결과가 예상과 다르면 현재 활성화된 설정부터 확인한 다음 규칙 순서와 데이터 파일을 살펴보세요. 모든 노드가 연결되지 않으면 로컬 네트워크와 서비스 상태를 먼저 확인하세요. 사이트의 GeoIP 업데이트 안내와 규칙 문제 해결 섹션에서는 각각 데이터 로드와 라우팅 로직을 다룹니다. 모든 설정을 한꺼번에 바꾸기보다 증상에 맞는 항목을 확인하는 편이 안전합니다.

설정 자세히 알아보기
최근 사용 가이드

전체 글 보기 →

기본 연결을 완료한 뒤 실제 필요한 고급 내용을 살펴보세요. 설정 구조 글은 YAML을 수정하려는 사용자에게, 트래픽 처리 방식 비교 글은 TUN이 필요한지 판단하려는 사용자에게 적합합니다. 구독 업데이트 글에서는 링크 문제, 다운로드 실패, 로컬 설정 미전환을 구분할 수 있습니다. 각 글은 구체적인 작업 하나를 다루므로 사용을 시작하기 전에 모든 설정을 한꺼번에 읽을 필요는 없습니다.

고급 설정

Clash config.yaml 구조 자세히 보기: 포트·DNS·proxy-groups·rules 필드별 설명

설정 파일의 위에서 아래 순서대로 포트와 모드, dns, proxies, proxy-groups, rules 필드의 의미와 자주 쓰는 구문을 설명합니다. 먼저 참조 관계를 이해한 뒤 각 필드를 수정해 프록시 그룹 이름과 규칙 대상이 일치하지 않는 문제를 예방하세요.

전체 글 읽기 →
고급 설정

TUN 모드와 시스템 프록시 차이: 트래픽 처리 범위와 사용 환경 비교

트래픽 처리 단계, 명령줄 프로그램과 게임 지원, 권한 요구 사항, DNS 처리 방식의 네 가지 측면에서 두 연결 방식을 비교합니다. 더 많은 옵션을 켜는 것이 연결 안정성을 높인다고 생각하기보다 앱의 동작 방식에 맞춰 연결 방법을 선택하세요.

전체 글 읽기 →
입문 가이드

Clash 구독 자동 업데이트 설정: 업데이트 간격, 실패 알림, 수동 새로고침 방법

주요 클라이언트에서 구독 업데이트 간격을 설정하는 위치와 업데이트 실패의 일반적인 원인을 소개합니다. 수동으로 새로고침할 때와 네트워크 환경을 확인할 때를 구분하고, 업데이트 후에는 새 설정이 실제 연결에 적용되었는지 확인하세요.

전체 글 읽기 →

설치, 설정, 네트워크 연결 중 어떤 문제인지 모르겠다면 도움말 센터에서 유형별로 찾아보세요. 앱은 실행되지만 접속할 수 없다면 “로컬 네트워크 → 현재 설정 → 프록시 그룹 → 트래픽 연결 방식 → 규칙 및 DNS” 순서로 확인하고 각 단계의 결과를 기록하세요. 점검 과정에서 새로운 변수가 생기는 것을 막을 수 있습니다.