Clash 배포 스테이션 · mihomo 코어 클라이언트와 한국어 문서

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

Clash 다운로드 가이드 보기

플랫폼 선택부터 규칙 기반 라우팅까지, 실제 설정과 로그를 통해 mihomo 코어 사용법을 안내합니다.

오픈소스 생태계 구독 관리 한국어 설정 안내
GPL-3.0 오픈소스 mihomo 코어 Windows / macOS / Linux / Android / iOS
설정/config.yaml
규칙 모드
시스템 프록시 TUN 모드
규칙위에서부터 순서대로 매칭 · 화면 예시
  1. 1DOMAIN-SUFFIX,github.com,Proxy
  2. 2DOMAIN-KEYWORD,google,Proxy
  3. 3DOMAIN-SUFFIX,example.com,Proxy
  4. 4IP-CIDR,127.0.0.0/8,DIRECT
  5. 5GEOIP,CN,DIRECT
  6. 6MATCH,Proxy
로그정적 로그 예시
  • [TCP] 127.0.0.1 --> api.github.com:443 match DomainSuffix(github.com) using Proxy
  • [TCP] 127.0.0.1 --> www.example.com:443 match DomainSuffix(example.com) using Proxy
  • [TCP] 127.0.0.1 --> 127.0.0.1:8080 match IPCIDR(127.0.0.0/8) using DIRECT

오픈소스 코드 / 설정 문법 / 추적 가능한 연결 로그

Clash 생태계와코어의 관계

mihomoGPL-3.0YAML 설정규칙 기반 라우팅

클라이언트 인터페이스와 프록시 코어

Clash는 프록시 도구 생태계에서 널리 쓰이는 이름이며, 모든 클라이언트가 같은 팀에서 개발된 것은 아닙니다. 그래픽 클라이언트는 프록시 그룹 표시, 구독 가져오기, 시스템 프록시 관리, 설정 저장을 담당합니다. 프록시 코어는 설정을 해석하고 규칙을 매칭해 연결을 수립합니다. 프로그램을 선택할 때는 클라이언트의 유지보수 여부와 실제로 사용하는 코어를 함께 확인하세요. 이 사이트는 다운로드 링크와 한국어 안내를 정리하며, 해당 클라이언트의 공식 개발자가 아닙니다.

Clash Meta에서 mihomo로

mihomo는 Clash Meta 프로젝트의 기술적 방향을 이어갑니다. 예전 가이드의 Clash Meta라는 이름은 현재 mihomo 문서와 유사한 설정 체계를 가리키는 경우가 많지만, 버전에 따라 지원하는 필드가 다를 수 있습니다. 알 수 없는 설정 항목, 시작 실패, 미지원 프로토콜이 나타나면 파일명만으로 호환성을 판단하지 말고 현재 클라이언트의 코어 정보와 해당 문서를 먼저 확인하세요.

오픈소스 라이선스와 프로젝트 범위

mihomo의 코드 저장소에는 소스 코드, 릴리스 안내, 이슈 논의가 공개되어 있으며 GPL-3.0 라이선스를 적용합니다. 오픈소스 라이선스는 코드의 사용 및 배포 조건을 설명할 뿐, 클라이언트가 네트워크 서비스를 제공하거나 임의의 구독 콘텐츠가 신뢰할 수 있음을 뜻하지 않습니다. 클라이언트, 코어, 구독 제공자는 서로 다른 구성 요소입니다. 도구를 설치한 뒤에도 연결하려면 적법하게 취득한 설정이나 직접 관리하는 서버 정보가 필요합니다.

업데이트 전에 되돌릴 수 있는 설정 보관

클라이언트, 코어, 구독 업데이트는 각각 구분해야 합니다. 클라이언트 업데이트는 메뉴와 권한 처리 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 및 설정 지원을 변경할 수 있으며, 구독 업데이트는 프록시 항목과 규칙을 교체할 수 있습니다. 변경 전에 현재 설정을 내보내고 릴리스 안내를 확인하세요. 업데이트한 뒤에는 시작 로그와 규칙 매칭 결과를 살펴보세요. 한 번에 한 종류의 설정만 바꾸면 변경 원인을 파악하기 쉽습니다.

mihomo 소스 코드 저장소

소스 코드와 릴리스 기록을 확인하세요. 저장소를 복제하려면 로컬에 Git을 설치해야 하며, 클라이언트를 일상적으로 사용하는 데 필요한 절차는 아닙니다.

오픈소스 프로젝트 보기 ↗ 
git clone https://github.com/MetaCubeX/mihomo.git

클라이언트 다운로드 / 운영체제별 선택

Clash 플랫폼별 다운로드

먼저 기기의 운영체제를 확인한 뒤 알맞은 클라이언트를 선택하세요. 데스크톱과 모바일은 권한, 네트워크 처리 방식, 백그라운드 실행 방식이 다르므로 같은 구독을 사용하더라도 각각 설정해야 할 수 있습니다.

다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash 등 플랫폼별 클라이언트를 확인하고, 계속 유지보수되는 프로젝트와 보관 처리된 프로그램을 구분할 수 있습니다. 처음 사용하는 경우 각 플랫폼의 추천 항목부터 살펴보세요. 기존 설정이 있다면 마이그레이션 전에 프로토콜, 규칙, 오버라이드 기능의 호환성을 확인하세요.

그래픽 클라이언트는 일상적인 관리에 적합합니다. 서버나 라우터에서 사용할 경우 코어 항목을 참고해 설정 파일과 실행 환경을 직접 준비하세요. 코어 파일에는 데스크톱 설정 화면이 포함되어 있지 않으며, 운영체제의 네트워크 설정을 자동으로 대체하지도 않습니다.

전체 클라이언트 보기 → 클라이언트 비교 리뷰 →
Windows데스크톱 설정 관리와 시스템 프록시를 지원합니다. TUN을 켜기 전에 서비스 모드, 관리자 권한, 다른 네트워크 프로그램과의 충돌 여부를 확인하세요. 다운로드 페이지로 macOSApple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 처음 실행할 때는 시스템 안내에 따라 네트워크 확장과 필요한 권한을 허용하세요. 다운로드 페이지로 AndroidVPN 서비스를 통해 기기의 연결을 처리합니다. 백그라운드 배터리 제한에 유의하고, 필요에 따라 앱별 라우팅과 부팅 시 자동 실행을 설정하세요. 다운로드 페이지로 iOSClash Plus의 App Store 페이지를 확인하세요. 설정을 가져온 뒤 VPN 구성을 추가하도록 허용하고, 실제 기능은 클라이언트 지원 범위를 확인하세요. 다운로드 페이지로 Linux데스크톱에서는 그래픽 클라이언트를 선택하세요. 서버에 배포하기 전에는 배포판, 프로세서 아키텍처, 서비스 관리 방식을 확인하세요. 다운로드 페이지로
설정 작업 공간 / 네 가지 핵심 단계

규칙, 정책 및네트워크 처리

아래 내용은 설정 구조와 항목을 보여 주는 예시이며 특정 클라이언트의 전체 화면을 나타내지는 않습니다. 클라이언트마다 메뉴 이름이 조금씩 다를 수 있으므로 실제 조작 시에는 현재 화면을 기준으로 확인하세요.

순서대로 확인하는규칙 매칭

규칙 모드는 앱 이름만 보고 연결 경로를 추측하는 방식이 아닙니다. 코어가 위에서부터 규칙을 검사해 연결이 조건에 맞는지 판단합니다. 도메인 접미사, 키워드, IP 범위는 서로 다른 조건을 표현하는 데 쓰입니다. 조건이 일치하면 연결은 지정된 정책으로 전달되며, 일반적으로 뒤의 규칙은 더 이상 검사하지 않습니다. 구체적인 예외 규칙은 일반 규칙보다 앞에 두고, 마지막에는 기본 처리용 MATCH를 배치하세요. 변경한 뒤에는 로그에서 대상 도메인을 찾아 매칭된 규칙 유형과 정책 이름을 확인한 다음 순서를 조정할지 판단하세요. 그래야 연결 문제를 프록시 그룹 문제로 오해하지 않습니다.

Clash 사용자 규칙 보기 →
규칙 문법

DOMAIN-SUFFIX, GEOIP, MATCH는 각각 역할이 다릅니다.

로그로 문제 추적

대상 주소, 매칭된 규칙, 최종 정책을 함께 확인하세요.

설정 / config.yaml
rules:
  - DOMAIN-SUFFIX,github.com,Proxy
  - DOMAIN-KEYWORD,google,Proxy
  - IP-CIDR,127.0.0.0/8,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

Proxy는 설정에 정의된 프록시 또는 프록시 그룹이어야 합니다.

프록시 그룹과정책 선택

프록시 그룹은 규칙에 지정된 정책 이름을 실제 연결 경로와 연결합니다. select는 직접 선택할 때 적합하고, url-test는 설정된 검사 조건에 따라 사용할 수 있는 경로를 선택하며, fallback은 지정된 순서에 따라 대체 경로를 사용합니다. 그룹 이름은 자유롭게 정할 수 있지만 규칙에서 참조하는 이름과 정확히 일치해야 합니다. 규칙 모드에서는 규칙이 참조하지 않는 그룹을 수정해도 대상 연결 경로가 바뀌지 않습니다. 전역 모드는 전역 정책으로 연결을 처리하므로 잠깐 비교하며 문제를 확인할 때 유용합니다. 선택을 마친 뒤 새 테스트 연결을 만들어 확인하세요. 기존 연결은 이전 경로를 계속 사용할 수 있습니다.

Clash Verge Rev 가이드 보기 →
그룹 이름 참조

규칙의 정책 이름은 프록시 그룹 정의와 일치해야 합니다.

모드 비교

문제 확인을 위해 잠시 모드를 바꾼 뒤, 평소에는 필요에 따라 규칙 모드로 되돌리세요.

프록시 / 정책 그룹 유형 예시
Proxyselect
Autourl-test
Fallbackfallback
Mediaselect

여기에는 그룹 이름과 정책 유형만 표시됩니다. 실제 연결 경로는 가져온 설정에 따라 달라집니다.

구독 업데이트와로컬 오버라이드

구독 링크는 설정을 가져오는 데 사용되며, 업데이트할 때 프록시 목록, 정책 그룹, 규칙이 다시 기록될 수 있습니다. 내려받은 파일을 직접 편집하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 오버라이드, 확장 스크립트 또는 병합 기능으로 관리하고, 업데이트된 설정에 변경 사항이 적용되는지 확인하세요. 업데이트에 실패하면 링크가 유효한지, 로그인이 필요한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 먼저 살펴보세요. 로그나 스크린샷을 다른 사람에게 보낼 때는 구독 링크에 포함된 인증 정보를 가리세요.

구독 가져오기 및 업데이트 단계 보기 →
업데이트 구분하기

구독 업데이트는 클라이언트나 코어 업그레이드와 다릅니다.

변경 사항 유지

클라이언트가 지원하는 오버라이드 기능으로 로컬 규칙을 관리하세요.

설정 / 구독 설정 예시
설정 출처원격 구독
자동 업데이트
업데이트 간격구독 안내에 따라 설정
로컬 오버라이드별도 관리

업데이트 위치와 병합 순서는 클라이언트에 따라 다릅니다. 변경하기 전에 현재 설정을 내보내세요.

시스템 프록시와TUN 모드

시스템 프록시는 시스템 설정을 따르는 앱에 로컬 프록시 주소를 제공합니다. 데스크톱에서 처음 설정할 때 시작점으로 적합합니다. 일부 명령줄 도구, 게임, 자체 네트워크 스택을 사용하는 앱은 이 설정을 읽지 않으므로 스위치가 켜져 있다는 이유만으로 모든 연결이 처리된다고 판단할 수 없습니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 연결을 처리하며 라우팅, DNS, 시스템 권한과도 관련됩니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 서비스 모드와 권한을 설정하세요. 충돌이 발생하면 다른 VPN이나 네트워크 처리 프로그램을 끄고 비교해 보세요. 여러 연결 경로를 동시에 바꾸지 않는 것이 좋습니다.

Clash 시스템 프록시 설정 보기 →
필요한 연결만 처리

앱이 시스템 프록시를 사용하는지에 따라 적절한 방식을 선택하세요.

단계별 문제 해결

권한, 연결 로그, DNS, 라우팅을 차례로 확인하세요.

설정 / 네트워크 처리 예시
시스템 프록시
TUN 모드
실행 권한활성화 전에 확인
DNS 설정네트워크 처리 방식에 맞게 설정

스위치는 정적인 예시입니다. 모바일에서는 보통 시스템 VPN 권한을 통해 연결을 처리합니다.

빠른 시작 / 가져오기부터 연결 확인까지

첫 설정을 위한세 단계

설치가 끝났다고 해서 클라이언트가 실행된다는 뜻일 뿐입니다. 먼저 설정을 가져오고, 모드와 네트워크 처리 방식을 선택한 다음, 새 연결로 결과를 확인하세요. 세 단계를 각각 점검하면 문제를 더 쉽게 찾을 수 있습니다.

  1. 사용 가능한 설정 가져오기

    「설정」 페이지에서 링크 가져오기 또는 로컬 YAML 파일 가져오기를 선택하세요. 저장한 뒤 해당 설정을 현재 설정으로 지정합니다. 링크는 신뢰할 수 있는 출처에서 받아야 하며, 일반 웹페이지 주소는 구독 주소를 대신할 수 없습니다. 가져온 뒤 파싱 오류가 표시되면 오류가 난 줄과 들여쓰기를 먼저 확인하고, 시스템 프록시를 반복해서 전환하지 마세요. 다른 클라이언트의 설정을 사용 중이라면 마이그레이션 전에 별도 파일로 저장해 원본을 덮어쓰지 않도록 하세요.

  2. 모드 선택 및 연결 처리

    「프록시」 페이지에서 규칙 모드를 선택하고, 규칙에서 사용하는 정책 그룹을 확인한 뒤 사용할 수 있는 경로를 고르세요. 데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 시스템 안내에 따라 VPN 연결을 허용하세요. 대상 앱이 시스템 프록시를 사용하지 않거나 더 넓은 범위의 연결 처리가 필요한 경우에만 가이드에 따라 TUN을 설정하세요. 네트워크를 처리하는 클라이언트를 여러 개 동시에 실행하면 프록시 주소와 라우팅 설정이 서로 덮어쓸 수 있습니다.

  3. 로그로 연결 경로 확인

    테스트 페이지를 새로 열고 「로그」 또는 「연결」 페이지에서 해당 도메인을 찾으세요. 먼저 연결이 코어에 전달됐는지 확인한 뒤 매칭된 규칙, 정책 그룹, 연결 경로를 점검합니다. 로그에 대상 연결이 보이지 않으면 네트워크 처리 방식을 먼저 살펴보세요. 기록은 있지만 연결에 실패하면 연결 경로와 DNS를 확인하세요. 테스트가 끝나면 평소 사용하는 로그 수준으로 되돌리고, 문제 해결 정보를 공유할 때는 구독 인증 정보와 개인 네트워크 정보를 가리세요.

전체 가이드 보기 →

설정 전에 준비할 사항

클라이언트는 연결 관리 기능을 제공할 뿐, 사용할 수 있는 서버를 자동으로 만들어 주지 않습니다. 선택한 클라이언트와 호환되는 설정을 준비하고 기기의 날짜, 네트워크, 저장 공간이 정상인지 확인하세요. 기존 클라이언트에서 옮기는 경우 로컬 프록시 포트, 오버라이드 규칙, DNS 설정을 기록해 두세요. 구독 링크가 같더라도 이러한 로컬 설정까지 함께 동기화되는 것은 아닙니다.

Android 기기에서는 화면이 꺼진 뒤 시스템이 서비스를 중단하지 않도록 백그라운드 실행과 배터리 관리 설정도 확인하세요. 앱별 라우팅을 설정할 때는 규칙이 앱과 도메인 중 무엇을 대상으로 하는지 먼저 확인한 뒤 제외 항목을 설정하세요. 자세한 내용은 Android 설정 안내를 참고하세요.

자주 묻는 질문

구독을 가져왔는데도 접속이 안 되는 이유는 무엇인가요?

가져오기는 설정을 불러오는 단계일 뿐입니다. 설정을 활성화하고 정책 그룹을 선택한 다음 기기에 맞는 네트워크 처리 방식도 켜야 합니다. 먼저 로그에 대상 연결이 표시되는지 확인하고, 문제 해결 절차 →에 따라 항목별로 점검하세요.

규칙 모드와 전역 모드는 어떻게 선택하나요?

규칙 모드는 규칙 목록에 따라 연결마다 경로를 결정하고, 전역 모드는 전역 정책으로 연결을 처리합니다. 전역 모드는 잠시 비교해 볼 때 사용할 수 있지만 규칙 순서와 그룹 이름을 점검하는 과정을 대신할 수는 없습니다. 규칙 설정 안내 →를 참고하세요.

TUN을 켠 뒤 DNS도 설정해야 하나요?

TUN은 DNS 처리와 연관되어 있으므로 클라이언트에서 제공하는 관련 설정을 함께 확인해야 합니다. 이름 해석 문제가 발생하면 기존 설정을 보관한 뒤 항목별로 테스트하세요. DNS 주소와 라우팅 옵션을 한꺼번에 모두 바꾸지 마세요. 네트워크 문제 해결 →을 참고하세요.

설정 가이드 / 문제별로 찾아보기

최근설정 및 문제 해결 가이드

화면 메뉴, 기기 간 동기화, DNS 강화 모드까지 현재 문제에 맞춰 살펴보세요. 네트워크 설정을 변경하기 전에 기존 설정을 보관하고, 변경할 때마다 실제 결과를 확인하세요.

전체 글 보기 →
Clash 다운로드