오픈소스 프로젝트 · 전 플랫폼 클라이언트 지속 업데이트

Clash 배포 페이지클라이언트 다운로드 및 설정

Clash 다운로드 가이드 보기

플랫폼에 맞는 클라이언트를 선택하고 구독 가져오기부터 규칙 기반 라우팅까지 살펴보세요. mihomo 커널 기반 설정 방법도 안내합니다.

오픈소스 코드YAML 설정한국어 문서
설정 기능

규칙부터 네트워크 연결 처리까지

클라이언트는 조작 인터페이스를, 커널은 연결 처리를 담당합니다. 필요한 기능을 확인하고 기본 설정부터 시작해 하나씩 확장하세요.

규칙 기반 라우팅: 규칙 순서에 따라 연결 경로 결정

규칙 모드에서는 대상마다 서로 다른 정책을 적용할 수 있어 모든 연결이 같은 경로를 사용할 필요가 없습니다. 커널은 위에서 아래로 규칙을 확인하고, 일치하는 규칙을 찾으면 지정된 프록시 그룹이나 직접 연결 정책을 적용합니다. 따라서 구체적인 도메인 규칙은 범위가 넓은 규칙보다 앞에 두고, 마지막에는 MATCH로 나머지 연결을 처리하세요. 전역 모드보다 규칙 모드가 로컬 서비스와 원격 리소스를 함께 이용하기에 적합합니다. 설정을 수정할 때는 먼저 정책 이름이 실제로 있는지 확인하고, 연결 화면에서 일치한 규칙을 살펴보세요. 웹페이지가 열리는지만으로 라우팅 결과를 판단하지 않는 것이 좋습니다.

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

예시의 PROXY는 정책 이름이므로 프록시 그룹에서 별도로 정의해야 합니다. GeoIP 판정은 로컬 지리 데이터베이스를 사용하며, 모든 도메인 규칙을 대신할 수는 없습니다.

처음 연결을 준비한다면 시작 가이드에 따라 구독과 시스템 프록시를 설정하세요. 전체 설정 순서와 관리 방법은 사용 설명서에서 확인할 수 있습니다.

플랫폼별 다운로드

운영체제와 아키텍처에 맞는 설치 파일 선택

홈에서는 플랫폼별 링크를 제공합니다. 클라이언트와 설치 파일, 시스템 요구 사항은 다운로드 페이지에서 확인하세요. 먼저 기기의 아키텍처를 확인한 뒤 클라이언트별 시스템 연동 방식을 비교하세요.

Windows

트레이 메뉴, 시스템 프록시, 시작 시 자동 실행이 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev 등의 클라이언트를 확인할 수 있습니다. 선택하기 전에 시스템 설정에서 프로세서와 운영체제 종류를 확인하세요. PC 브랜드만으로 설치 파일 아키텍처를 판단하면 안 됩니다.

처음 설치한 뒤에는 설정을 가져오고 시스템 프록시를 켜세요. 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때만 서비스 모드와 TUN 권한을 확인하면 됩니다. 기존 클라이언트에서 옮길 때는 구독 출처와 사용자 지정 규칙을 보존하고, 새 클라이언트의 설정 디렉터리 전체를 그대로 덮어쓰지 마세요.

다운로드 Windows 클라이언트

macOS

메뉴 막대에서 프록시 관리, 구독 전환, 연결 확인을 원하는 사용자에게 적합합니다. Apple Silicon과 Intel 기기는 설치 파일이 다르므로 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. 현재 운영체제 요구 사항에 맞고 지속적으로 관리되는 클라이언트를 우선 선택하세요.

설치 후 안내에 따라 필요한 권한을 부여하고, 시스템 네트워크 프록시 상태가 클라이언트 표시와 일치하는지 확인하세요. 절전 모드에서 깨어난 뒤, Wi-Fi를 바꾼 뒤 또는 다른 VPN에 연결한 뒤 문제가 발생하면 현재 네트워크 인터페이스와 프록시 상태부터 확인하세요. 구독 전체를 다시 가져올 필요는 없습니다.

다운로드 macOS 클라이언트

Android

시스템 VPN 인터페이스로 모바일 기기의 연결을 관리하려는 사용자에게 적합합니다. 다운로드할 때 ARM64, ARM, 범용 설치 파일을 구분하고 클라이언트 요구 사항을 확인하세요. 설치 후에는 로컬 트래픽을 처리할 통로를 만들기 위해 시스템 VPN 권한을 허용해야 합니다.

화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 실행, 제조사별 자동 시작 설정부터 확인한 다음 로그를 살펴보세요. 모든 백그라운드 제한을 한꺼번에 해제하지 마세요. 앱별 프록시를 사용할 때는 대상 앱이 트래픽 처리 범위에 포함되는지, 기기에서 다른 VPN 서비스가 실행 중인지도 확인해야 합니다.

다운로드 Android 클라이언트

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 후 구독 형식을 클라이언트가 인식하는지 확인하고, 시스템 안내에 따라 VPN 설정을 추가한 다음 사용할 프록시 정책을 선택하세요.

모바일 네트워크와 Wi-Fi를 전환한 뒤에는 클라이언트 상태뿐 아니라 실제 대상 앱의 연결도 확인하세요. VPN 아이콘만으로 원격 출구가 정상이라고 판단해서는 안 됩니다. 구독 유효 기간, 프록시 그룹 선택, 규칙 일치 여부를 각각 확인해야 합니다.

다운로드 iOS 클라이언트

Linux

데스크톱 사용자는 Clash Verge Rev와 FlClash를 비교한 뒤 배포판에 맞는 패키지 형식을 선택할 수 있습니다. 설치 후 데스크톱 환경의 프록시 지원, 트레이 동작, 필요한 권한을 확인하세요. 명령줄 프로그램은 데스크톱 시스템 프록시를 사용하지 않을 수 있으므로 프로그램 문서에 따라 환경 변수를 설정하거나 다른 트래픽 처리 방식을 사용해야 합니다.

서버 및 라우터 사용자는 mihomo 커널을 살펴볼 수 있지만 실행 인수, 설정 경로, 서비스 실행 주기를 직접 관리해야 합니다. 제어 인터페이스와 프록시 수신 주소는 필요한 범위로 제한하세요. LAN 연결을 허용하기 전에 방화벽과 접근 범위를 확인해 신뢰할 수 없는 네트워크에 로컬 서비스를 노출하지 않도록 주의하세요.

다운로드 Linux 클라이언트

모든 클라이언트 보기 →

오픈소스 생태계와 유지 관리

커널, 인터페이스, 설정 출처 구분하기

공개 코드, 프로젝트 문서, 릴리스 기록을 기준으로 판단하세요. 이름이 비슷한 클라이언트라도 유지 관리 상태, 기능 범위, 설정 동작이 모두 같지는 않습니다.

Clash에서 mihomo까지

Clash 생태계에는 프록시 커널, 그래픽 클라이언트, 설정 도구 등 서로 다른 프로젝트가 있습니다. 원본 Clash와 일부 초기 클라이언트의 유지 관리가 중단된 뒤 커뮤니티 포크가 계속 발전했고, Clash Meta라는 이름도 오래된 가이드와 설정 문서에서 자주 볼 수 있습니다. mihomo는 현재 생태계에서 널리 쓰이는 커널 프로젝트입니다. 오래된 자료를 참고할 때는 파일 이름에 Clash가 있는지만 보지 말고, 어느 시기의 어떤 커널을 설명하는지 먼저 확인하세요.

커널은 프로토콜 처리, 규칙 매칭, DNS, 연결 전달을 담당하고 그래픽 클라이언트는 구독 가져오기, 트레이 메뉴, 시스템 프록시, 권한 관리, 로그 표시를 담당합니다. Clash Verge Rev 같은 제품은 커널 기능을 조작 가능한 데스크톱 인터페이스로 제공합니다. 다만 인터페이스의 스위치와 커널 설정 필드가 항상 일대일로 대응하는 것은 아닙니다. 같은 구독도 클라이언트의 기본 덮어쓰기 설정과 시스템 트래픽 처리 방식에 따라 결과가 달라질 수 있습니다.

공개 코드를 통해 확인할 수 있는 정보

프로젝트 저장소에서는 설정 필드, 릴리스 안내, 알려진 문제와 수정 논의를 확인할 수 있습니다. 문제가 해결됐는지 판단하려면 관심도만 보지 말고 문제 설명, 변경 기록, 실제 릴리스 패키지를 함께 살펴보세요. 이 사이트는 검증되지 않은 다운로드 수나 평점을 추천 기준으로 삼지 않습니다. 기기 호환성, 지속적인 유지 관리 여부, 필요한 기능을 기준으로 선택하세요.

mihomo 저장소는 GPL-3.0 라이선스를 명시합니다. 그래픽 클라이언트, 부가 리소스, 타사 의존성은 각 프로젝트의 라이선스 안내를 확인해야 합니다. 오픈소스 코드는 검토와 연구에 사용할 수 있지만 설치 파일, 구독 서비스, 타사 설정은 각각 출처가 다릅니다. 낯선 설정을 가져오기 전에 원격 규칙, 스크립트, 제어 인터페이스 등이 실제 용도에 적합한지 확인하고 구독 주소의 접근 자격 증명을 보호하세요.

클라이언트 업데이트와 함께 커널 및 설정도 확인하세요

클라이언트, 커널, 구독, GeoIP 등의 규칙 리소스 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 주로 인터페이스와 시스템 연동에 영향을 주고, 구독 업데이트는 원격으로 제공되는 노드나 규칙을 바꿉니다. 한 항목을 업데이트했다고 나머지도 동기화된 것은 아닙니다. 호환성에 변화가 생기면 릴리스 안내를 먼저 읽고 복구할 수 있도록 기존 설정을 보관하세요.

사용자 지정 규칙과 덮어쓰기 파일은 별도로 백업하고 수정 목적을 기록하세요. 업데이트 후에는 영향을 받은 기능만 확인하면 됩니다. 커널, DNS, 라우팅 규칙을 한꺼번에 바꾸면 연결이 복구되더라도 원인이 무엇인지 파악하기 어렵습니다. 안정적으로 사용하려면 매개변수를 계속 추가하기보다 설정을 이해하기 쉽게 유지하는 편이 중요합니다.

연결 기록으로 실제 동작 확인하기

처음 사용할 때는 설정 활성화, 프록시 그룹 선택, 시스템 트래픽 처리 활성화 순서로 확인한 뒤 대상 앱에 접속하세요. 연결 화면에서 대상 도메인, 일치한 규칙, 실제 적용된 정책을 확인할 수 있습니다. 전역 모드는 규칙 문제를 구분하는 데 잠시 활용할 수 있지만 모든 프로그램이 클라이언트에 연결되도록 보장하지는 않습니다. 시스템 프록시와 TUN은 트래픽이 들어오는 방식을, 프록시 모드는 들어온 뒤 처리할 방식을 결정합니다.

웹페이지는 열리지만 스토어 앱에 문제가 있다면 UWP 루프백 관련 안내를 확인하세요. 도메인 접속만 실패한다면 DNS 경로를 중점적으로 살펴보세요. 증상별 해결 방법은 자주 묻는 질문에서, 전체 학습 순서는 사용 설명서에서 확인할 수 있습니다. 문제가 해결되면 임시 테스트 설정을 정리해 전역 모드나 과도한 로그가 남지 않도록 하세요.

최신 글

클라이언트 구성과 시스템 문제 해결

기본 연결을 마친 뒤 구체적인 증상에 맞춰 자세한 내용을 확인하세요. 각 글은 운영체제 제한, 클라이언트 설정, 커널 동작을 구분해 여러 계층을 오가며 반복해서 테스트하는 일을 줄여줍니다.

전체 글 보기 →