mihomo 코어 · 오픈 소스 클라이언트 지속 업데이트

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

Clash 코어 사이트에서 플랫폼별 클라이언트, 구독 가져오기, 규칙 분류를 확인하고 설정 순서에 따라 하나씩 적용하세요.

  • GPL-3.0 오픈 소스
  • mihomo 코어
  • 규칙 / 프록시 그룹 / TUN
규칙 → 프록시 그룹 → 아웃바운드config.yaml
REJECT거부
Proxy프록시 그룹
DIRECT직접 연결
GEOSITEcategory-ads-all
일치하면 연결 거부
DOMAIN-SUFFIXgithub.com
DOMAIN-KEYWORDgoogle
MATCH설정 마지막의 기본 처리 규칙
GEOIPCN
IP-CIDR192.168.0.0/16

아웃바운드 유형별로 표시한 것으로, 설정 파일의 나열 순서를 뜻하지 않습니다. 실제 규칙은 위에서부터 매칭되므로 MATCH는 마지막에 두세요.

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

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 그래픽 클라이언트를 선택하세요. 설치 파일, 시스템 요구 사항, 유지 관리 상태는 다운로드 페이지에서 확인할 수 있습니다.

Windows

데스크톱에서 일상적으로 사용한다면 Clash Plus를 먼저 살펴보고, Clash Verge Rev와 FlClash도 비교해 보세요. 처음 설치할 때 시스템 아키텍처를 확인하고, 서비스나 TUN을 활성화할 때는 안내에 따라 관리자 권한을 허용하세요. 권한 문제를 설정 오류로 오해하지 않도록 주의해야 합니다.

다운로드 페이지로 이동 →

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하고, 처음 실행할 때 권한을 허용한 다음 시스템 프록시를 설정하세요. 더 많은 앱의 연결을 처리하려면 TUN을 추가로 설정할 수 있습니다. 보조 서비스와 권한 허용 절차는 클라이언트마다 다르므로 각각의 안내를 확인하세요.

다운로드 페이지로 이동 →

Android

모바일에서는 Clash Plus, Clash Meta for Android, FlClash를 비교해 보세요. 설정을 가져온 뒤 시스템 VPN 권한을 허용해야 합니다. 백그라운드에서 연결이 끊긴다면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 구독을 반복해서 삭제할 필요는 없습니다.

다운로드 페이지로 이동 →

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동해 개발자 정보를 확인하세요. 지원되는 설정을 가져오고 VPN 권한을 허용한 뒤 프록시 그룹을 확인하면 됩니다. 모바일 운영체제의 네트워크 처리 방식은 데스크톱 시스템 프록시와 다르므로 클라이언트 안내를 따르세요.

다운로드 페이지로 이동 →

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 받으세요. 서버와 라우터에서 사용할 경우 mihomo 코어 섹션을 확인하고 설정 디렉터리, 서비스 권한, 시작 방식을 직접 관리할 수 있습니다. 그래픽 클라이언트와 코어 패키지는 설치 대상이 서로 다릅니다.

다운로드 페이지로 이동 →

클라이언트는 설정 가져오기, 연결 제어, 인터페이스 조작을 담당하고 코어는 연결을 처리합니다. 클라이언트를 바꾸기 전 사용자 지정 규칙을 내보내고 새 클라이언트가 기존 설정 항목을 지원하는지 확인하세요. 보관된 프로젝트는 과거 사용법을 살펴보는 데 참고하고, 새로 선택할 때는 지속적으로 관리되는 프로젝트를 우선하세요.

전체 클라이언트 보기 →

규칙, 프록시 그룹, 네트워크 처리

모든 스위치를 한꺼번에 켜기보다 기능별로 설정을 이해하세요. 아래 내용은 기존 설정에 합쳐야 하는 항목 예시입니다. Proxy는 프록시 그룹 이름일 뿐, 기본 제공 프록시 노드가 아닙니다.

규칙이 연결을 전달할 아웃바운드를 결정합니다

규칙 모드에서는 설정된 순서대로 하나씩 매칭하며, 일치하는 규칙을 찾으면 보통 그 아래는 확인하지 않습니다. 특정 사이트에는 도메인 접미사 규칙을, 로컬 네트워크 주소에는 IP 대역 규칙을 사용할 수 있습니다. 지역별 데이터 규칙을 쓰려면 해당 데이터베이스도 사용할 수 있어야 합니다. 모든 연결의 아웃바운드를 하나로 고르는 전역 모드와 달리, 규칙 모드에서는 한국 내 서비스를 직접 연결하면서 지정한 사이트만 프록시 그룹으로 보낼 수 있습니다. 문제를 확인할 때는 먼저 로그에서 매칭된 규칙을 확인하고, 다음으로 프록시 그룹의 현재 선택 항목을 살펴보세요. 노드만 바꾸고 규칙 순서를 바로잡지 않으면 문제가 해결되지 않을 수 있습니다. 마지막의 MATCH는 그 밖의 연결을 처리합니다.

config.yaml · 규칙 예시
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-SUFFIX,github.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

이 예시는 기존 Proxy 프록시 그룹과 사용 가능한 GEOIP 데이터에 의존합니다.

규칙 매칭 순서 보기 →

Clash 설치 후 3단계 설정

검증 가능한 연결 하나를 먼저 만든 다음 복잡한 규칙을 추가하세요. 시작 과정에는 꼭 필요한 작업만 담고, 세부 설정과 플랫폼별 차이는 전체 문서에서 안내합니다.

설정을 가져와 활성화하기

클라이언트의 설정 또는 구독 화면을 열고 URL 가져오기를 선택한 다음, 신뢰할 수 있는 출처에서 받은 구독 주소를 붙여 넣고 저장하세요. 로컬 파일을 사용하는 경우 파일 가져오기를 선택하고 클라이언트에서 지원하는 형식인지 확인하세요. 가져오기에 성공한 뒤에는 해당 설정을 선택해 현재 설정으로 활성화해야 합니다. 목록에 항목이 표시되더라도 설정이 실제로 적용되었다는 뜻은 아닙니다.

이어서 로드 결과와 프록시 그룹 목록을 확인하세요. 지원하지 않는 항목, 들여쓰기 오류, 다운로드 실패가 표시되면 먼저 메시지를 기록하고 원본 파일을 바로 덮어쓰지 마세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 스크린샷이나 문의를 남기기 전에 전체 주소를 가리고, 낯선 변환 서비스에 제출하지 마세요.

규칙 모드와 아웃바운드 선택

모드 메뉴에서 규칙 모드를 선택한 뒤 설정에서 참조하는 프록시 그룹으로 이동해 사용할 수 있는 아웃바운드를 고르세요. 그룹 이름은 설정에 따라 다르며 반드시 Proxy인 것은 아닙니다. 데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 시스템 대화상자에서 VPN 권한을 허용하세요. 이 단계에서는 기본 DNS와 라우팅 설정을 유지해 동시에 바뀌는 항목을 줄이세요.

전역 모드에서는 보통 모든 연결을 전역 프록시 그룹으로 전달합니다. 임시 비교나 문제 확인에는 유용하지만 모든 앱의 트래픽이 코어로 들어온다는 뜻은 아닙니다. 시스템 프록시를 따르지 않는 앱은 프록시 매개변수를 별도로 설정하거나, 일반 연결이 확인된 뒤 TUN을 활성화해야 합니다.

실제 요청으로 연결 경로 확인

직접 연결되어야 하는 서비스와 프록시를 사용해야 하는 사이트에 각각 접속하면서 연결 기록이나 실행 로그를 확인하세요. 대상 도메인, 매칭 규칙, 최종 아웃바운드가 예상과 일치하는지 살펴보세요. 노드 테스트 성공은 테스트 주소에 연결할 수 있다는 뜻일 뿐, 웹페이지, 동영상, 특정 앱이 정상 작동하는지 대신 확인해 주지는 않습니다.

문제가 한 앱에서만 발생한다면 별도 프록시나 암호화 DNS를 사용하는지 먼저 확인하세요. 모든 연결이 실패하면 구독, 노드, 시스템 시간, 로컬 네트워크를 점검하세요. 기본 흐름이 안정적으로 작동하는 것을 확인한 뒤 현재 설정을 백업하고 규칙 세트, DNS 재정의, TUN 설정을 추가하세요.

첫 연결 전에 확인할 사항

Clash 클라이언트와 프록시 서비스는 서로 다른 것입니다. 클라이언트를 설치해도 사용할 수 있는 노드가 자동으로 생기지 않으며, 설정에 포함된 서버 정보도 제공자가 계속 관리해야 합니다. 사용하기 전에 서비스의 이용 범위와 트래픽 제한, 현지 네트워크 이용 규정을 확인하세요. 이 사이트의 문서는 설치와 설정 방법을 안내하며 계정, 구독 유효 기간, 노드 사용 가능 여부에 관한 서비스 제공자의 안내를 대신하지 않습니다.

설정을 업데이트할 때는 검증된 백업본을 보관하세요. 클라이언트 업그레이드, 코어 업데이트, 구독 새로고침, 규칙 세트 업데이트는 각각 다른 부분에 영향을 줍니다. 문제를 확인하는 동안 이 작업을 한꺼번에 실행하지 않는 것이 좋습니다. 오류가 발생하면 발생 시간, 사용 중인 네트워크, 직전에 변경한 내용을 기록한 뒤 로그를 따라 단계별로 살펴보세요. 반복해서 재설치하는 것보다 원인을 빠르게 좁힐 수 있습니다.

구독 가져오기 및 업데이트 문제 →

Clash 생태계와 오픈 소스 관리

과거 프로젝트, 프록시 코어, 그래픽 클라이언트를 구분해야 다운로드 파일, 설정 호환성, 업데이트 안내를 올바르게 이해할 수 있습니다.

mihomoClash Verge RevFlClashClash Meta for Android

프로젝트 역사

Clash의 규칙과 설정 형식은 여러 후속 프로젝트에서 이어져 익숙한 항목 이름이 다양한 클라이언트에 나타납니다. 원본 프로젝트, 커뮤니티 포크, 새로운 그래픽 인터페이스는 동일한 릴리스 이력을 공유하지 않습니다. 가이드를 참고할 때는 먼저 어떤 코어와 클라이언트를 대상으로 하는지 확인한 다음 설정을 적용하세요. 과거 클라이언트는 이전 설정 방식을 유지하고 있을 수 있으며 최신 항목을 지원하지 않을 수도 있습니다. 오래된 스크린샷의 버튼 이름을 현재 인터페이스에 그대로 적용하면 안 됩니다.

코어 관계

mihomo는 널리 사용되는 Clash 설정 생태계의 코어 중 하나로, 프로토콜 처리, 규칙 매칭, DNS 등을 담당합니다. Clash Verge Rev와 FlClash 같은 그래픽 클라이언트는 이를 바탕으로 설정 관리, 시스템 프록시, 사용자 인터페이스를 제공합니다. 인터페이스가 업데이트되더라도 코어가 함께 바뀌는 것은 아닙니다. 클라이언트에서 파일을 가져올 수 있다고 해서 코어가 그 안의 모든 항목을 지원하는 것도 아닙니다. 호환성을 판단할 때는 프로그램 이름만 보지 말고 클라이언트에서 사용하는 코어, 항목 지원 여부, 플랫폼 권한을 함께 확인해야 합니다.

오픈 소스 라이선스

mihomo 저장소는 GPL-3.0 라이선스를 따릅니다. 구체적인 권리와 의무는 프로젝트의 라이선스 전문을 확인하세요. 다른 클라이언트와 해당 의존성은 서로 다른 라이선스를 사용할 수 있으므로 코어의 라이선스가 모든 소프트웨어에 공통으로 적용되는 것은 아닙니다. 소스 코드를 읽거나 문제를 제보하거나 재배포할 때는 각 저장소의 안내를 따로 확인하세요. Clash 코어 사이트는 다운로드 링크와 한국어 자료를 정리한 사이트이며 각 프로젝트의 개발자를 대표하지 않습니다. 프로젝트 이름은 소프트웨어와 설정 간의 관계를 식별하기 위한 것이며 공동 개발이나 공식 제휴를 의미하지 않습니다.

업데이트 방식

앱 업데이트는 주로 인터페이스, 시스템 통합, 패키지 의존성을 바꿉니다. 코어 업데이트는 프로토콜 지원과 설정 항목의 동작에 영향을 줄 수 있고, 구독이나 규칙 세트 새로고침은 설정 데이터를 갱신합니다. 업데이트 안내가 표시되면 먼저 어느 계층에 해당하는지 확인하고 변경 사항을 읽은 뒤 백업을 보관하세요. 업데이트 후 문제가 생기면 모든 사용자 설정을 바로 지우지 말고 변경 전후의 설정과 로그를 먼저 비교하세요. 다운로드 페이지에서 클라이언트 링크와 관리 상태를 확인할 수 있습니다. 이 문서는 특정 릴리스의 요구 사항이 앞으로도 계속 적용된다고 가정하지 않습니다.

mihomo 소스 코드에서 구현 확인

설정 항목의 동작을 확인하거나 코어 문제를 제보하려면 프로젝트 저장소에서 자세한 내용을 살펴보세요. 복제 명령은 소스 코드를 가져올 뿐 그래픽 클라이언트를 설치하거나 기기의 프록시를 설정하지 않습니다. 일반 사용자는 다운로드 페이지에서 클라이언트를 선택하면 됩니다. 개발과 빌드 방법은 저장소 문서를 참고하세요.

mihomo 오픈 소스 저장소 보기 ↗
터미널 · 소스 코드 받기
git clone https://github.com/MetaCubeX/mihomo.git

Linux 펭귄 그래픽은 Font Awesome에서 제공하며 CC BY 4.0에 따라 사용합니다. 나머지 플랫폼 그래픽은 Simple Icons에서 제공됩니다.

설정 팁과 플랫폼별 사용 가이드

기본 연결을 설정한 뒤 권한, 모바일 설정 가져오기, 규칙 매칭 등 필요한 주제를 살펴보세요. 각 문서는 한 가지 상황을 중심으로 설명하므로 구체적인 문제를 해결하면서 이어서 읽기 좋습니다.