오픈 소스 프로젝트 · 클라이언트 및 설정 자료

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

공식 Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 Mihomo 코어, 구독 설정, 규칙 분기를 중심으로 설치부터 일상적인 관리까지 필요한 자료를 정리했습니다.

  • 완전 무료
  • 소스 코드 공개
  • 5개 플랫폼 지원
  • 한국어 문서
OPEN SOURCEClash / Mihomo PLATFORMSWindows · macOS · Linux · Android · iOS FOCUS설정 · 규칙 · 문제 해결

Configuration map

연결 입구부터 규칙 출구까지, 주 경로로 이해하는 Clash

Clash 클라이언트는 설정 항목이 많지만 실제 사용 결과에 가장 큰 영향을 주는 것은 보통 설정 파일, 프록시 모드, 규칙 순서와 시스템 적용 방식입니다. 아래에서 각 주제를 하나씩 확인할 수 있는 분기 지점으로 나누어 설명합니다.

Rules / 규칙

각 연결을 올바른 정책 그룹으로 보내기

규칙 모드는 모든 트래픽을 하나의 노드로 보내는 방식이 아닙니다. 도메인, IP, 프로세스 또는 지역 규칙을 순서대로 확인한 뒤 결과를 해당 정책 그룹으로 전달합니다. 설정을 가져온 후에는 먼저 규칙 제공자와 정책 그룹 이름이 정상적으로 로드되었는지 확인하고, 클라이언트의 연결 기록에서 실제로 어떤 규칙이 적용되었는지 살펴보세요. 사용자 지정 규칙은 일반적으로 설정 파일의 규칙 영역에 작성하며 순서가 중요합니다. 더 구체적인 도메인 규칙을 범위가 넓은 기본 규칙보다 앞에 배치하고, 마지막에 MATCH를 마무리 규칙으로 사용합니다. 이렇게 하면 일상적인 접속이 편리해지고 특정 사이트가 직접 연결 또는 프록시로 처리된 이유도 쉽게 추적할 수 있습니다.

적합한 경우: 웹사이트, 애플리케이션 또는 주소 유형별로 연결을 나누어 처리해야 할 때

Quick start

처음 연결을 3단계로 완료하기

가이드 페이지는 명확한 순서로 구성되어 있습니다. 먼저 클라이언트를 설치하고, 설정을 가져온 다음, 프록시 동작을 확인하세요. 분기 문제가 발생하면 해당 장으로 돌아가 점검할 수 있습니다.

01

운영체제별 다운로드

다운로드 페이지에서 Windows, macOS, Linux, Android 또는 iOS에 맞는 클라이언트를 선택해 설치한 뒤 메인 화면을 엽니다.

02

구독 설정 가져오기

설정 파일 또는 구독 관리 메뉴에 구독 주소를 붙여 넣고 업데이트한 뒤 프록시 목록, 정책 그룹, 규칙에 모두 내용이 있는지 확인합니다.

03

모드 선택 및 확인

먼저 규칙 모드로 연결한 다음 테스트 주소에 접속하거나 연결 기록을 확인하세요. 결과가 이상하면 포트, DNS, 규칙 순서를 차례로 점검합니다.

전체 가이드 보기 →

Platform entry

기기에 맞는 클라이언트 찾기

플랫폼 입구는 다운로드 페이지의 해당 그룹으로 이동하는 역할만 합니다. 구체적인 클라이언트, 시스템 요구 사항, 설치 패키지 안내는 다운로드 페이지에서 관리합니다.

Windows데스크톱 클라이언트 및 설치 패키지다운로드로 이동 → macOSApple Silicon 및 Intel다운로드로 이동 → Android모바일 설정 및 애플리케이션다운로드로 이동 → iOSApp Store 클라이언트 입구다운로드로 이동 → Linux데스크톱 클라이언트 및 서버 구성다운로드로 이동 →
모든 클라이언트 보기 →

Open source context

클라이언트, 코어, 설정 파일부터 구분하기

Clash 생태계에서 그래픽 클라이언트는 화면과 시스템 통합을 담당하고, Mihomo는 설정 파싱, 규칙 매칭, 연결 수립을 담당합니다. 이 관계를 이해하면 클라이언트 이름, 코어 기능, 구독 서비스를 서로 혼동하는 일을 줄일 수 있습니다.

초기 Clash 프로젝트는 규칙 설정과 프록시 정책 그룹의 보급을 이끌었고, 이후 커뮤니티에서는 코어 기능, 데스크톱 패키징, 모바일 대응을 중심으로 다양한 프로젝트가 생겨났습니다. Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트는 화면 구성과 출시 주기가 서로 다르지만, 모두 설정 파일을 통해 프록시 동작을 결정합니다. 다운로드할 때는 먼저 운영체제를 확인한 다음 필요한 코어 기능을 클라이언트가 지원하는지 살펴보세요.

Mihomo 업데이트에는 설정 필드, DNS, TUN, 인바운드 포트, 규칙 처리 등이 포함됩니다. 클라이언트가 같은 날 업데이트되지 않을 수 있으므로 특정 설정 항목이 보이지 않는다면 클라이언트 버전 안내와 코어 지원 범위를 함께 확인해야 합니다. 이 사이트는 버튼 위치를 외우는 대신 자주 쓰는 개념을 나누어 설명해 문제에 맞는 자료를 찾기 쉽게 구성했습니다.

Repository reference

실제 설정 문법으로 문제 해결의 출발점 만들기

코어 동작을 확인하거나 테스트 설정을 준비할 때는 오픈 소스 저장소에서 문서와 예제를 확인할 수 있습니다. 아래 명령은 표준 Git 작업을 설명하기 위한 것이며, 실제 사용 시에는 프로젝트의 현재 공개 저장소 주소를 기준으로 삼으세요.

git clone https://github.com/MetaCubeX/mihomo.git

프로젝트 역사:Clash 생태계는 클라이언트, 코어, 설정 규칙으로 구성되며 다운로드 입구와 사용 가이드는 구분해서 살펴봐야 합니다.

관리 방식:버전 목록은 다운로드 버튼을 업데이트하는 용도로만 사용하며, 변경 가능성이 큰 버전 번호를 홈페이지 제목이나 장식 영역에 표시하지 않습니다.

실전 권장 사항:연결 문제가 발생하면 현재 설정을 보존하고 모드, 포트, DNS, 규칙 변경 사항을 하나씩 기록해 되돌리기와 재현이 쉽도록 하세요.

Common checks

자주 발생하는 문제를 판단하는 입구

아래의 짧은 답변은 방향을 빠르게 찾는 데 적합합니다. 전체 작업 순서가 필요하다면 가이드나 FAQ 페이지로 이동하세요.

구독을 가져온 뒤 정책 그룹이 보이지 않으면 어떻게 하나요?

먼저 구독 응답 내용을 현재 클라이언트가 파싱할 수 있는지 확인한 다음, 설정 파일이 업데이트되어 현재 사용 항목으로 지정되었는지 점검하세요.

문제 해결로 이동 →

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

일상적인 사용에는 규칙 모드를 우선 사용하세요. 특정 프록시 경로를 테스트할 때는 잠시 전체 모드를 사용한 뒤 규칙 모드로 돌아와 확인하면 됩니다.

모드 설명 보기 →

특정 애플리케이션이 시스템 프록시를 사용하지 않는 이유는 무엇인가요?

일부 터미널, 게임 또는 백그라운드 서비스는 시스템 프록시 설정을 사용하지 않습니다. 먼저 애플리케이션 자체의 프록시 메뉴를 확인한 뒤 TUN 적용을 검토하세요.

TUN 용어 보기 →

포트를 변경한 뒤 브라우저가 연결되지 않나요?

브라우저, 시스템 프록시, 클라이언트 수신 포트가 서로 일치하는지 확인하고 이전 프로세스가 기존 포트를 계속 사용하고 있는지도 점검하세요.

포트 점검 보기 →

Field notes

최근 글: 클라이언트 선택부터 문제 해결까지

클라이언트 관계, 플랫폼 배포, 프록시 모드, 자주 발생하는 네트워크 오류를 다룹니다. 기본 설치를 마친 뒤 이어서 읽기에 적합합니다.

문제 해결

Windows UWP 앱에서 Clash 프록시를 사용할 수 없을 때

UWP 루프백 격리의 증상과 해제 방법, 설정 후에도 연결되지 않을 때 확인할 프록시 포트와 애플리케이션 범위를 설명합니다.

전체 글 보기 →
플랫폼 배포

Mihomo 라우터 및 바이패스 라우터 배포 개요

메인 라우터와 바이패스 라우터의 두 가지 배포 방식을 정리하고, 투명 프록시, 전달 경로, 코어 직접 실행에 적합한 사용 환경을 설명합니다.

전체 글 보기 →
클라이언트 선택

Clash 오픈 소스 생태계의 프로젝트 관계와 클라이언트 선택

코어, 그래픽 클라이언트, 플랫폼 대응이라는 세 가지 관점에서 주요 프로젝트를 정리해 이름이 비슷한 소프트웨어가 각각 어떤 역할을 하는지 판단할 수 있도록 돕습니다.

전체 글 보기 →
모든 글 보기 →