오픈 소스 코어 mihomo · 모든 플랫폼의 클라이언트를 지속적으로 업데이트

Clash 클라이언트 다운로드 및규칙 설정

Clash 다운로드 사용 가이드 보기

기기에 맞는 클라이언트를 선택하고 규칙 기반 라우팅으로 트래픽을 처리하세요. 중국어 문서를 따라 구독, 시스템 프록시, DNS를 설정할 수 있습니다.

오픈 소스 코어규칙 및 프록시 그룹설정 예시
SETTINGS / CONFIG

Clash 설정 및 구성 예시

먼저 트래픽이 클라이언트로 들어오는 방식을 확인한 다음, 요청을 어디로 보낼지 정하세요. 여섯 가지 설정 예시는 자주 사용하는 항목을 보여 줍니다. 인터페이스 명칭은 클라이언트마다 다를 수 있으며, 설정 필드는 실제 사용 중인 코어를 기준으로 확인하세요.

설정 / config.yaml

일상적인 사용은 규칙 모드부터

아웃바운드 모드
✓ 규칙전역직접 연결
mode: rule

규칙 모드는 설정에 정의된 규칙에 따라 아웃바운드를 결정하므로, 직접 연결과 프록시를 함께 사용할 때 적합합니다. 전역 모드는 코어에 들어온 요청을 모두 전역 정책으로 처리합니다. 규칙이 잘못 매칭되는지 확인할 때 잠시 사용할 수 있지만, 모든 앱의 트래픽을 자동으로 가져오는 기능은 아닙니다. 직접 연결 모드에서는 해당 요청이 대상에 바로 연결됩니다. 모드를 바꾼 뒤 요청을 다시 보내고 연결 기록에서 매칭된 규칙과 아웃바운드 이름을 확인하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 종료한 뒤 다시 시도해야 합니다. 평소에는 규칙 모드를 선택하고 프록시 그룹에서 실제로 어떤 아웃바운드가 선택됐는지 확인하세요.

아웃바운드 모드 설명 보기 →

설정 파일, 클라이언트, 코어의 역할

Profile에는 프록시 항목, 프록시 그룹, 라우팅 규칙, DNS 등의 설정이 저장됩니다. 클라이언트는 구독을 가져오고 연결 정보를 표시하며 시스템 프록시와 서비스 권한을 관리합니다. 코어는 최종 설정을 읽어 DNS 해석, 규칙 매칭, 트래픽 전달을 수행합니다. 인터페이스의 스위치를 바꿔도 원본 구독 파일이 수정되는 것은 아닙니다. 문제를 해결할 때는 구독 원문만 비교하지 말고 클라이언트가 생성한 실행 설정을 확인하세요.

위 YAML은 일부 항목만 보여 주는 예시입니다. 복사하기 전에 현재 정상적으로 작동하는 설정을 백업하고 들여쓰기, 프록시 그룹 이름, 코어 지원 여부를 확인하세요. 처음 연결할 때는 설정 하나와 트래픽 처리 방식 하나만 검증하세요. 결과를 재현할 수 있게 된 뒤 규칙 세트, 오버라이드, 자동 선택을 추가하면 됩니다. 각 필드를 차례로 이해하려면 용어 설명부터 살펴본 뒤 고급 설정 가이드에서 전체 예시를 확인하세요.

PLATFORM / CLIENT

플랫폼별 Clash 클라이언트 선택

전체 클라이언트 보기 →

운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 클라이언트를 선택하세요. 같은 코어를 사용하더라도 인터페이스, 권한 설정, 오버라이드 방식은 다를 수 있습니다. 다운로드 센터에서 설치 경로와 시스템 요구 사항을 확인할 수 있으며, 홈에서는 플랫폼별 안내만 제공하고 설치 파일은 직접 배포하지 않습니다.

Windows

일반적인 데스크톱 사용자는 Clash Plus부터 살펴보세요. 규칙 관리에 익숙하다면 Clash Verge Rev, FlClash, Clash Nyanpasu도 비교해 볼 수 있습니다. 설치 전에 운영체제를 확인하고 프로세서 아키텍처와 운영체제 비트 수를 혼동하지 마세요.

처음 실행하면 구독을 가져오고 규칙 모드를 선택한 다음 시스템 프록시를 켜세요. 브라우저는 연결되지만 터미널은 연결되지 않는다면 터미널 앱이 시스템 프록시를 사용하는지 확인하세요. 앱에 필요한 기능을 파악한 뒤 TUN이나 서비스 모드를 사용할지 결정하고, 여러 설정을 한꺼번에 바꾸지 마세요.

Windows 다운로드 →

macOS

시스템 정보에서 Apple Silicon 또는 Intel인지 확인한 다음 해당 설치 파일을 다운로드하세요. Clash Plus, Clash Verge Rev, FlClash는 설정 관리 인터페이스가 서로 다릅니다. 기존 클라이언트에서 옮길 때는 구독과 로컬 오버라이드 내용을 먼저 저장하세요.

설치 후 시스템 안내에 따라 필요한 권한을 부여하고, 클라이언트가 현재 네트워크 서비스의 프록시를 설정했는지 확인하세요. Wi-Fi를 바꾸거나 도킹 스테이션을 연결하거나 다른 VPN을 사용한 뒤에는 프록시 설정을 다시 점검해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 끄면 앱이 더 이상 수신하지 않는 로컬 포트에 계속 연결하는 상황을 막을 수 있습니다.

macOS 다운로드 →

Android

다운로드 센터에서 Clash Plus, Clash Meta for Android, FlClash, Surfboard를 확인할 수 있습니다. 먼저 기기가 지원하는 아키텍처를 확인하고 설치 파일을 선택하세요. 설정 형식과 필드 지원 여부는 선택한 앱에 따라 다르므로 구독 링크를 붙여 넣을 수 있다는 이유만으로 호환된다고 판단하지 마세요.

처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 권한을 확인하고 클라이언트 로그를 살펴보세요. 앱별 라우팅과 도메인 규칙은 서로 다른 설정 단계입니다. 전자는 트래픽 처리 대상 앱을 정하고, 후자는 이미 처리 대상으로 들어온 요청의 아웃바운드를 정합니다.

Android 다운로드 →

iOS

iPhone 및 iPad 사용자는 다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 공식 웹사이트는 clashplus.io입니다. 설치 후 구독 또는 설정을 추가하고, 시스템 VPN 설정을 허용한 다음 클라이언트로 돌아와 연결을 시작하세요.

연결 아이콘은 트래픽 처리가 시작됐다는 뜻일 뿐, 모든 규칙이 예상대로 적용됐다는 의미는 아닙니다. 실제로 사용할 앱에서 접속을 확인하고 선택한 프록시와 설정 업데이트 시간을 점검하세요. 다른 VPN 설정이 있다면 현재 활성화된 항목을 확인하세요. 문제를 해결할 때는 한 가지 트래픽 처리 방식만 유지해야 설정을 반복해서 바꾸며 혼란이 생기지 않습니다.

iOS 다운로드 →

Linux

데스크톱 사용자는 배포판의 패키지 형식에 맞춰 Clash Verge Rev와 FlClash 중에서 선택할 수 있습니다. 서버와 라우터에서는 다운로드 센터의 mihomo 코어 항목을 확인하고 설정 디렉터리, 실행 옵션, 서비스 관리를 직접 구성하세요.

데스크톱 환경의 시스템 프록시가 명령줄 프로그램에 적용되지 않을 수 있습니다. 명령줄 도구에는 프록시 환경 변수를 별도로 설정해야 할 수도 있습니다. TUN을 사용한다면 권한, 라우팅, 방화벽도 확인하세요. 서비스를 장기간 운영하기 전에는 먼저 포그라운드에서 설정을 읽고 시작 로그를 확인해 포트가 정상적으로 수신되는지 점검한 뒤 서비스 관리자에 등록하세요.

Linux 다운로드 →

클라이언트 이전 시 설정 출처 유지

다른 클라이언트의 작업 디렉터리 전체를 복사하기보다는 원본 구독을 다시 가져오는 것이 좋습니다. 인터페이스 설정, 서비스 설정, 캐시는 보통 그대로 옮겨 쓸 수 없습니다. 로컬 규칙은 새 클라이언트가 지원하는 오버라이드 방식에 맞춰 하나씩 이전하세요. 정상적으로 연결되는 설정을 하나 보관해 두고, 이전 검증이 끝난 뒤 기존 클라이언트를 정리하면 권한이나 DNS 차이가 생겼을 때 되돌리기 쉽습니다.

“전역 모드는 되지만 규칙 모드는 실패”한다면 먼저 규칙에서 참조하는 프록시 그룹이 있는지 확인한 뒤 매칭 순서를 살펴보세요. 모든 모드에서 실패하면 로컬 포트와 실제 아웃바운드부터 확인하세요. 모드는 요청을 보낼 경로를 결정하고, 시스템 프록시와 TUN은 트래픽 처리 범위를 결정합니다. 이 두 항목은 따로 검증해야 합니다. 관련 정의는 용어 설명에서 확인할 수 있습니다.

OPEN SOURCE / MIHOMO

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

이어지는 Clash 설정 체계

Clash는 프록시 항목, 프록시 그룹, 규칙 매칭을 하나의 설정 체계로 구성합니다. 앱마다 프록시 목록을 따로 관리하지 않아도 도메인, 주소 등의 조건에 따라 요청의 아웃바운드를 정할 수 있습니다. 구조를 이해해 두면 호환 클라이언트로 바꿔도 설정 방식의 대부분을 그대로 활용할 수 있습니다. 다만 호환된다고 해서 모든 필드, 인터페이스, 업데이트 방식이 완전히 같은 것은 아닙니다.

기존 Clash 프로젝트와 현재 유지 관리 중인 생태계 프로젝트는 구분해서 살펴봐야 합니다. 오래된 가이드에 나오는 클라이언트 이름, 설정 필드, 권한 설정 경로는 현재 기기와 다를 수 있습니다. 클라이언트를 고를 때는 플랫폼 지원뿐 아니라 프로젝트의 유지 관리 상태, 통합된 코어, 설정 처리 방식도 확인하세요. 다운로드 센터에서는 보관용 클라이언트를 별도로 표시해 이전 사용자가 구분할 수 있도록 안내합니다.

실행은 mihomo, 관리는 클라이언트

mihomo는 Clash 생태계에서 지속적으로 개발되는 오픈 소스 코어로, 프로토콜 처리, 규칙 매칭, DNS, 트래픽 전달을 담당합니다. 그래픽 클라이언트는 코어를 바탕으로 구독 관리, 프록시 그룹 선택, 연결 기록, 시스템 통합 기능을 제공합니다. 이 글의 설정 창은 개념 설명을 위한 예시입니다. 모든 클라이언트의 화면 구성이 같거나 모든 플랫폼에서 동일한 방식으로 네트워크 트래픽을 처리한다는 뜻은 아닙니다.

클라이언트를 비교할 때는 코어 기능과 인터페이스 기능을 구분해서 살펴보세요. 코어가 특정 필드를 지원하더라도 그래픽 인터페이스에 전용 스위치가 없을 수 있습니다. 인터페이스에서 오버라이드를 지원한다고 해서 원격 구독 원문이 영구적으로 수정되는 것도 아닙니다. 실제 동작을 확인하려면 버튼 이름만 비교하기보다 실행 설정, 앱 로그, 프로젝트 문서를 확인하는 편이 정확합니다.

소스 코드와 이슈 기록 확인

mihomo의 소스 코드, 라이선스, 릴리스 노트, 이슈 논의는 프로젝트 저장소에서 확인할 수 있습니다. 릴리스 노트를 읽으면 프로토콜 수정, 플랫폼 제한, 설정 변경 사항을 파악할 수 있습니다. 이슈를 등록하기 전에 같은 로그 키워드가 있는지 검색하고 간소화한 설정에서도 재현되는지 확인하세요. 이 사이트는 다운로드 안내와 중국어 사용 가이드를 제공하며, 개발 및 릴리스 기록은 프로젝트 유지 관리자의 저장소를 기준으로 합니다.

설정 문제를 해결하려면 전체 상황을 알아야 하지만 구독 전체를 공개해서는 안 됩니다. 로그나 재현 자료를 공유하기 전에 구독 주소, 인증 정보, 실제 서버 주소를 삭제하세요. 필요한 규칙 구조, 운영체제, 클라이언트 이름, 오류가 표시된 부분만 남기면 됩니다. 최소 설정으로 먼저 재현하면 서로 관련 없는 설정을 한 이슈에 섞는 일을 줄일 수 있습니다.

세 가지 업데이트 구분

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스와 시스템 통합에 영향을 주고, 코어 업데이트는 프로토콜과 설정 실행에 영향을 줍니다. 구독 업데이트는 원격에서 제공하는 프록시와 규칙 내용을 바꿉니다. 구독을 새로고침해도 프로그램 업데이트를 대신할 수 없으며, 클라이언트를 업그레이드해도 원격 설정 호환성이 자동으로 보장되지는 않습니다. 업데이트하기 전에 해결하려는 문제가 무엇인지 먼저 확인하세요.

되돌릴 수 있도록 설정을 보관하고 변경 사항을 확인한 뒤 업데이트하는 것이 좋습니다. 업데이트가 끝나면 설정이 로드되는지 확인하고 자주 사용하는 앱, 규칙 매칭, DNS 해석을 점검하세요. 장기간 실행하는 기기라면 사용하는 트래픽 처리 방식과 로컬 오버라이드를 기록해 두고 문제가 생겼을 때 하나씩 되돌리세요. 연결 아이콘이나 한 번의 테스트 성공만으로 전체 설정이 검증됐다고 판단하지 마세요.

mihomo 소스 코드 가져오기

아래 명령은 소스 코드 저장소를 복제하며 그래픽 클라이언트를 설치하지 않습니다. 일반 데스크톱 사용자는 다운로드 센터를 이용하세요. 개발자는 저장소에서 빌드 방법과 라이선스를 확인할 수 있습니다.

git clone https://github.com/MetaCubeX/mihomo.git
mihomo 프로젝트 저장소 보기 ↗
NOTES / GUIDES

Clash 설정 및 플랫폼별 문서

전체 글 보기 →

각 글은 구체적인 문제를 중심으로 관찰 가능한 증상을 설명하고 점검 방법을 안내합니다. 처음 설치한다면 사용 문서부터 읽어 보세요. 연결은 되지만 권한, 트래픽 처리, 노드 선택을 더 알아보고 싶다면 해당 주제를 확인하면 됩니다. 여러 문제를 한꺼번에 섞어 설정하지 마세요.

현재 단계에 맞는 문서 선택

아직 설정을 가져오지 않았다면 사용 문서부터 시작하세요. 연결을 마쳤고 프록시 그룹, 규칙 세트, DNS를 조정하려면 고급 설정을 확인하세요. Profile, fake-ip, 혼합 포트 같은 용어가 낯설다면 용어 설명부터 살펴보세요. 한 번에 설정 하나만 바꾸고 변경 전후 결과를 저장해야 규칙, DNS 해석, 트래픽 처리 방식 중 무엇이 영향을 줬는지 확인할 수 있습니다.