clash / 오픈소스Clash 오픈소스 허브 · 전체 플랫폼 클라이언트 다운로드

Public

규칙 기반 트래픽 분기를 지원하는 오픈소스 프록시 클라이언트 다운로드 및 문서 사이트입니다. Windows, macOS, Android, iOS, Linux 5개 플랫폼의 설치 파일과 구독 가져오기, TUN 모드 설정법을 한국어 튜토리얼과 문제 해결 가이드로 정리했습니다.

clash-download quick-start all-platform-setup troubleshooting glossary
clash2027 / releases main · 5 platforms
windows/ Clash Plus · Clash Verge Rev · FlClash · Nyanpasu 설치 파일 — 3일 전 macos/ Intel과 Apple Silicon 듀얼 빌드, dmg 설치 이미지 — 지난주 android/ arm64-v8a / armeabi-v7a APK, 루팅 없이 전체 트래픽 캡처 — 5일 전 ios/ App Store 배포, Network Extension 기반 — 3일 전 linux/ deb / AppImage, 주요 데스크톱 배포판 지원 — 지난주
Clash 다운로드 튜토리얼 보기 GPL-3.0 · mihomo 커널 · 5개 플랫폼 빌드
docs/

핵심 기능

다음 다섯 개 문서는 Clash의 핵심 기능 다섯 가지에 대응합니다. 왼쪽 파일명을 클릭하면 오른쪽에서 설명과 실제 설정 예시를 볼 수 있습니다.

rules.md

Clash는 설정 파일의 rules 항목 순서대로 새 연결마다 규칙을 하나씩 매칭합니다: DOMAIN-SUFFIX는 도메인 접미사를 확인하고, DOMAIN-KEYWORD는 키워드 포함 여부를 확인하며, GEOIP는 대상 IP의 소속 국가로 판단하고, MATCH는 마지막 기본 규칙으로 사용됩니다. 먼저 일치하는 규칙이 우선 적용되고 그 즉시 매칭이 멈춥니다. 전체 트래픽을 한 번에 프록시로 넘기는 방식과 달리, 규칙 기반 분기는 로컬 네트워크와 자주 쓰는 직접 연결 사이트는 우회하지 않고, 프록시가 필요한 도메인만 정확히 프록시로 보낼 수 있습니다. 규칙은 구독에 내장된 것, 로컬에서 추가한 것, rule-providers 원격 규칙 목록 세 가지 방식으로 지정할 수 있으며, 저장하면 즉시 반영되어 클라이언트를 재시작할 필요가 없습니다.

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-KEYWORD,google,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
releases/

플랫폼별 클라이언트 받기

다섯 플랫폼은 각각 독립적으로 빌드를 관리합니다. 플랫폼 카드를 클릭하면 다운로드 페이지의 해당 섹션으로 이동하며, 각 플랫폼마다 여러 클라이언트를 선택할 수 있고 시스템 요구 사항과 설치 방법도 함께 안내합니다.

windows/ Windows 10 / 11, x64 설치 파일, 시스템 프록시와 TUN 서비스 모드 지원 다운로드 이동 → macos/ macOS 11 이상, Intel과 Apple Silicon 듀얼 빌드, 메뉴바 상주 실행 다운로드 이동 → android/ Android 7 이상, APK 직접 설치, VpnService로 루팅 없이 트래픽 캡처 다운로드 이동 → ios/ iOS 15 이상, App Store 배포, Network Extension 프레임워크 기반 다운로드 이동 → linux/ Debian / Ubuntu / Arch 등 주요 배포판, deb와 AppImage 두 가지 포맷 다운로드 이동 → all-clients 전체 클라이언트 목록: 플랫폼별 선택 가능한 클라이언트, 커널 빌드, 시스템 요구 사항 비교표 전체 클라이언트 보기 →
about/

오픈소스 생태계와 업데이트 방식

history.md

Clash는 2018년 Go 언어로 오픈소스화되었고, 규칙 기반 분기와 YAML 설정 방식으로 이 분야의 사실상 표준 설정 형식이 되었습니다. 원본 커널이 보관 처리된 뒤에는 커뮤니티 포크인 mihomo(이전 명칭 Clash Meta)가 유지보수를 이어받아 더 많은 프록시 프로토콜, DNS 정책, TUN 스택 구현을 추가하면서도 원본 설정 형식과의 호환성을 유지하고 있습니다. 오늘날 각 플랫폼의 주요 GUI 클라이언트는 대부분 내부적으로 mihomo 커널을 사용합니다.

ecosystem.md

생태계는 커널과 GUI 클라이언트 두 계층으로 구성됩니다. 커널은 프로토콜 구현, 규칙 매칭, 트래픽 전달을 담당하고, Clash Verge Rev, FlClash, Nyanpasu 같은 클라이언트는 구독 관리, 인터페이스, 시스템 통합을 담당합니다. 모두 오픈소스 라이선스 아래 개발되어 코드를 공개적으로 검토할 수 있습니다. 같은 설정 파일을 여러 클라이언트에서 공통으로 사용할 수 있어 클라이언트를 바꿔도 설정을 다시 만들 필요가 없습니다.

releases.md

커널과 각 클라이언트는 각자의 저장소에서 독립적인 일정으로 버전을 배포합니다. 본 사이트 다운로드 페이지의 버전 번호와 설치 파일 링크는 버전 목록을 기반으로 자동 갱신되므로, 수동 관리로 인한 오래된 링크가 남지 않습니다. 유지보수가 중단된 클라이언트는 보관 상태로 명확히 표시하고, 계속 관리되는 대체 클라이언트를 안내합니다.

커널 저장소 clone

개발자는 mihomo 커널 소스를 직접 clone하여 로컬에서 빌드하거나 프로토콜 구현 세부 사항을 살펴볼 수 있습니다:

git clone https://github.com/MetaCubeX/mihomo.git
Go 언어로 구현 GPL-3.0 라이선스 설정 형식 하위 호환 유지

일반 사용자는 소스 코드를 직접 다룰 필요가 없습니다. 다운로드 페이지에서 해당 플랫폼의 GUI 클라이언트를 받으면 커널이 이미 포함되어 있습니다. 커널 매개변수의 의미가 궁금하다면 본 사이트의 전체 문서와 용어 안내서를 참고하세요.

faq/

자주 묻는 질문 모음

  • 구독 업데이트가 실패하면 어떻게 하나요?먼저 브라우저로 구독 링크를 직접 열어 오류 페이지가 아니라 YAML이 반환되는지 확인한 뒤, 유효 기간과 형식을 점검하세요. 해결 단계 보기 →
  • 프록시를 켰는데도 웹페이지가 안 열리나요?노드 지연 시간 → 규칙 매칭 → DNS → 시스템 프록시 순서로 하나씩 확인하세요. 체크리스트 보기 →
  • TUN 모드와 시스템 프록시 중 무엇을 써야 하나요?브라우저만 쓴다면 시스템 프록시로 충분하고, 커맨드라인 도구나 게임은 네트워크 계층에서 처리하는 TUN이 필요합니다. 용어 확인하기 →
  • 7890 포트가 사용 중이라는 메시지가 뜨나요?포트를 점유한 프로세스를 찾거나, 클라이언트에서 mixed-port 값을 바로 바꾸세요. 명령어 확인하기 →
blog/

최신 기술 노트

문제 해결

Clash는 연결됐는데 웹페이지가 안 열릴 때: 노드 지연부터 DNS까지 점검 체크리스트

프록시 스위치는 켜져 있는데 브라우저가 계속 로딩만 된다면, 노드, 규칙, DNS, 시스템 프록시 중 어디서든 문제가 생길 수 있습니다. 쉬운 것부터 어려운 순서로 아홉 가지 점검 포인트를 정리했습니다.

전체 보기 →
문제 해결

Clash에서 포트 충돌 메시지가 뜰 때: 7890 포트를 점유한 프로세스 찾기와 혼합 포트 변경

실행 시 bind: address already in use 오류가 뜨면 기본 포트가 이미 사용 중이라는 뜻입니다. 세 플랫폼에서 점유 프로세스를 찾는 명령과 mixed-port 변경 전체 과정을 정리했습니다.

전체 보기 →
시작 가이드

Clash 클라이언트 화면 구성 한눈에 보기: 프록시, 설정, 로그 페이지가 하는 일

클라이언트를 처음 열면 낯선 화면에서 헤매기 쉽습니다. 노드와 정책 그룹, 구독 관리, 연결 기록이 각각 어떤 역할을 하는지, 자주 쓰는 기능은 어디에 있는지 구역별로 정리했습니다.

전체 보기 →

전체 글 보기 →

클라이언트 다운로드