오픈 소스 생태계 · 5개 플랫폼 설치 경로

Clash 설치 패키지 다운로드 및 설정

Clash 다운로드 사용 문서 보기

사용 중인 기기에 맞는 Clash 그래픽 클라이언트 또는 mihomo 코어를 선택한 다음 구독 가져오기, 정책 그룹 선택, 프록시 활성화를 차례로 진행합니다. 이 페이지에서는 멀티플랫폼 설치 경로, 한국어 설정 단계, YAML 필드 참고 자료를 한곳에 정리해 첫 실행부터 규칙 분기와 문제 진단까지 이어서 확인할 수 있습니다.

  • 완전 무료
  • 오픈 소스
  • 멀티플랫폼 클라이언트
  • 한국어 문서
  • 규칙 및 YAML 참고

CONTROL PANEL / 기능 자료 브라우저

Clash 핵심 기능과 사용 범위

Clash 클라이언트의 역할은 연결을 단순히 전환하는 데 그치지 않습니다. 구독 설정, 프록시 노드, 정책 그룹, 규칙 및 시스템 네트워크 설정을 점검 가능한 실행 흐름으로 구성합니다. 각 모듈의 역할을 먼저 이해한 뒤 설정을 수정하면 클라이언트를 반복해서 재설치하는 것보다 효과적인 경우가 많습니다.

SUBSCRIPTION / PROVIDERS

구독 가져오기: 원격 설정을 클라이언트에 불러오기

구독 주소는 일반적으로 서비스 제공자가 관리하는 설정을 반환하며, 프록시 노드, 정책 그룹, 규칙 및 DNS 설정이 포함될 수 있습니다. 가져올 때는 클라이언트의 설정 또는 구독 페이지에서 전체 주소를 붙여 넣고 다운로드나 업데이트를 실행한 뒤 새 설정이 선택되었는지 확인해야 합니다. 설정 이름만 보인다고 연결을 이미 제어하는 것은 아니므로 정책 그룹과 시스템 프록시 상태도 점검해야 합니다.

노드를 하나씩 수동으로 입력하는 것보다 구독은 서버 목록과 정책 구조를 지속적으로 업데이트하는 데 적합합니다. 가져온 뒤 노드가 보이지 않으면 먼저 주소에 접속할 수 있는지와 설정 업데이트 시간이 변경되었는지 확인하고, 클라이언트 로그에서 YAML 형식 오류나 네트워크 오류를 확인하세요. 같은 주소를 반복해서 추가하는 것은 해결책이 아닙니다.

  • 가져온 후 설정이 현재 활성 상태인지 확인하세요.
  • 구독을 업데이트하기 전에 작동 중인 기존 설정을 보존하세요.
  • 구독 내용이 바뀌면 정책 그룹 선택을 다시 확인하세요.
선택됨: 구독 가져오기 화살표 키로 전환 · Home/End로 이동

PLATFORM SELECT / 기기 선택

5개 플랫폼용 Clash 설치 경로

현재 사용 중인 기기에 맞는 탭으로 이동한 뒤 프로세서 아키텍처, 설치 형식 및 유지 관리 상태를 확인하세요. 데스크톱 플랫폼은 보통 그래픽 클라이언트를 우선 선택하고, 서버·라우터·자동화 환경은 mihomo 코어를 직접 실행하는 방식이 적합합니다.

Windows

Windows 10 및 Windows 11 데스크톱 기기에 적합합니다. 다운로드 전에 x64 아키텍처를 확인하고, 처음 실행한 뒤 구독 가져오기, 정책 그룹 선택, 시스템 프록시 활성화를 차례로 진행하세요. 완전한 그래픽 관리가 필요하다면 Clash Plus, Clash Verge Rev, FlClash 및 Clash Nyanpasu를 비교할 수 있습니다.

다운로드로 이동

macOS

Apple Silicon과 Intel 모델은 서로 다른 설치 패키지를 선택해야 합니다. 설치 후 시스템에서 네트워크 확장 또는 프록시 권한을 요청하면 시스템 설정에서 승인하세요. 대표적인 그래픽 클라이언트로는 Clash Plus, Clash Verge Rev, FlClash가 있으며, 기존 설정을 이전할 때는 코어 필드의 호환성도 확인해야 합니다.

다운로드로 이동

Android

Android 설치 패키지는 보통 ARM64, ARM 또는 범용 아키텍처로 구분되며 최근 출시된 휴대전화 대부분은 ARM64를 사용합니다. 구독을 가져온 뒤에는 시스템이 VPN 연결을 설정하도록 허용해야 합니다. 인터페이스와 설정 호환성을 고려해 Clash Plus, Clash Meta for Android, FlClash 및 Surfboard 중에서 선택할 수 있습니다.

다운로드로 이동

iOS

iPhone과 iPad에서는 App Store를 통해 Clash Plus를 설치할 수 있습니다. 설치가 끝나면 구독 메뉴에서 설정을 추가하고 시스템의 VPN 구성 생성을 허용한 뒤 앱에서 정책을 선택하세요. 다운로드 센터에는 Clash Plus의 스토어 경로와 공식 사이트 clashplus.io를 함께 표시해 앱 정보를 확인하기 쉽게 했습니다.

다운로드로 이동

Linux 및 mihomo 코어

Linux 데스크톱에서는 Clash Verge Rev 또는 FlClash를 사용할 수 있으며, 서버·소프트웨어 라우터·컨테이너 환경에서는 보통 mihomo를 직접 실행합니다. 코어 파일을 선택할 때 AMD64, ARM64, ARMv7 또는 MIPS 등 아키텍처를 반드시 확인하고 서비스 관리, 설정 경로 및 실행 매개변수는 직접 준비해야 합니다. 처음 배포할 때는 먼저 포그라운드 명령으로 실행해 설정이 불러와지는지 확인한 뒤 systemd 또는 다른 프로세스 관리 방식에 연결하는 것이 좋습니다.

다운로드로 이동

전체 클라이언트 및 시스템 요구 사항 보기 →

QUICK SETUP / 3단계 초기 설정

Clash 첫 설정 순서

설치가 끝난 직후 많은 옵션을 동시에 수정하지 마세요. “설정 가져오기, 정책 선택, 프록시 활성화” 순서로 하나씩 확인하고 각 단계가 끝날 때마다 화면 상태를 점검하면 문제가 어느 단계에서 발생했는지 더 빠르게 파악할 수 있습니다.

  1. 01

    구독 또는 로컬 설정 가져오기

    클라이언트의 Profiles, 설정 또는 구독 페이지를 열고 전체 구독 주소를 붙여 넣어 가져오기를 실행하세요. 로컬 YAML을 사용하는 경우 파일 가져오기 메뉴에서 설정을 선택합니다. 완료 후 설정 이름, 업데이트 시간 및 로드 상태를 확인해 현재 활성화된 항목이 새 설정인지, 클라이언트에 포함된 빈 예시 설정이 아닌지 확인하세요.

    가져오기에 실패하면 먼저 오류 메시지를 확인하세요. 네트워크 접속 실패, 웹페이지 내용을 반환하는 주소, YAML 들여쓰기 오류 및 지원되지 않는 필드는 서로 다른 문제입니다. 복구와 교차 확인을 위해 원본 주소와 기존 설정을 보존하세요.

  2. 02

    모드, 정책 그룹 및 노드 선택

    초보자는 보통 규칙 모드부터 시작합니다. Proxies 또는 프록시 페이지에서 주요 정책 그룹을 하나씩 확인하고 사용 가능한 노드나 자동 선택 그룹을 선택하세요. 정책 그룹 이름은 설정 제공자가 정하므로 구독마다 완전히 다를 수 있습니다. 다른 사람의 화면 문구를 그대로 따르기보다 그룹 내 옵션과 규칙의 용도를 기준으로 판단해야 합니다.

    지연 시간 테스트는 한 번의 탐색 결과만 보여 주며 모든 웹사이트의 실제 속도를 직접 나타내지는 않습니다. 노드를 선택한 후에는 대상 페이지를 열어 확인하고 연결 기록에서 트래픽이 예상한 규칙에 매칭되는지 살펴보세요.

  3. 03

    시스템 프록시 활성화 및 연결 확인

    코어가 실행 중인지 확인한 다음 System Proxy 또는 시스템 프록시를 활성화하세요. 이후 확인하려는 사이트에 접속해 클라이언트 연결 목록에 새 기록이 나타나는지 확인하고, 기록의 규칙·정책 그룹·노드가 예상과 일치하는지 점검합니다. 브라우저에 기록이 생성되지 않으면 독립 프록시나 보안 DNS 설정을 사용 중인지 확인하세요.

    기본 확인을 마친 뒤 DNS, TUN, LAN 공유 및 사용자 지정 규칙을 조정하세요. 그러면 문제가 발생했을 때 어떤 추가 설정이 네트워크 동작을 바꿨는지 명확히 알 수 있습니다.

전체 가이드 및 문제 해결 단계 보기 →

OPEN SOURCE / 프로젝트 관계

Clash 오픈 소스 생태계와 mihomo 코어

Clash 설정 체계부터 커뮤니티 클라이언트까지

Clash는 널리 사용되는 설정 구조를 형성했습니다. 프록시 노드는 연결 방식을 설명하고, 정책 그룹은 선택 관계를 구성하며, 규칙은 트래픽을 해당 정책으로 전달합니다. DNS와 수신 포트는 로컬 연결 방식을 결정합니다. 원본 프로젝트가 지속적인 개발을 중단한 뒤에도 기존 설정 방식은 사라지지 않았으며, 커뮤니티는 호환 코어, 그래픽 인터페이스 및 멀티플랫폼 설치 도구를 계속 유지 관리하고 있습니다.

현재 널리 쓰이는 데스크톱 및 모바일 클라이언트는 하나의 프로그램을 단순히 포장만 바꾼 것이 아닙니다. 서로 다른 인터페이스 기술, 업데이트 경로 및 설정 관리 방식을 사용할 수 있고, 내부에 mihomo 또는 다른 호환 구현을 통합하기도 합니다. 따라서 클라이언트를 선택할 때는 플랫폼 지원, 코어 출처, 설정 호환성 및 유지 관리 상태를 함께 확인해야 하며 이름에 Clash가 포함되었는지만으로 판단해서는 안 됩니다.

mihomo와 그래픽 클라이언트의 역할 분담

mihomo는 주로 설정 파싱, 규칙 매칭, 프록시 프로토콜, DNS 처리 및 네트워크 수신 같은 핵심 작업을 담당합니다. 그래픽 클라이언트는 그 위에서 구독 관리, 정책 선택, 로그 확인, 시스템 프록시 스위치 및 업데이트 메뉴를 제공합니다. 데스크톱 사용자는 보통 그래픽 클라이언트를 바로 설치하면 되지만, 서버나 라우터 사용자는 코어만 배포한 뒤 설정 파일, 명령줄 및 외부 제어 인터페이스로 관리할 수도 있습니다.

코어 기능과 인터페이스 기능은 나누어 판단해야 합니다. 특정 YAML 필드가 적용되는지는 먼저 코어의 지원 여부에 달려 있고, 기능을 편리하게 켤 수 있는지는 클라이언트가 해당 인터페이스를 제공하는지에 달려 있습니다. 기능 차이가 발생하면 먼저 클라이언트가 사용하는 코어와 설정 형식을 확인한 뒤 필드 설명을 찾아보세요. 막연히 “Clash가 왜 작동하지 않나요”라고 검색하는 것보다 정확한 결론에 도달하기 쉽습니다.

업데이트할 때 확인할 항목

클라이언트 업데이트에는 보통 인터페이스 프로그램, 통합 코어 및 설정 마이그레이션이라는 세 부분이 포함됩니다. 업데이트 전에 현재 작동하는 설정, 수신 포트, 시스템 프록시 상태 및 중요한 오버라이드 규칙을 기록하세요. 업데이트 후에는 기존 설정을 먼저 불러오고 시작 로그를 확인한 다음 정책 그룹과 자주 사용하는 웹사이트를 테스트합니다. 여러 주요 버전을 건너뛸 때 클라이언트, 코어 및 전체 설정을 동시에 교체하면 문제 발생 시 변경 원인을 찾기 어렵습니다.

이 사이트의 다운로드 센터는 플랫폼별로 현재 유지 관리되는 클라이언트와 보관 프로젝트를 나열하며, 버전은 각 클라이언트 카드에 표시합니다. 버전 정보는 통합 목록에서 불러옵니다. 상위 프로젝트에 사용 가능한 버전 필드가 일시적으로 없을 때는 클라이언트 이름과 설치 경로만 유지하고 빈 버전 표시는 보여 주지 않습니다.

HELP TOPICS / 자주 묻는 질문 모음

설치 후 먼저 확인할 4가지

처음 사용할 때 발생하는 대부분의 문제는 설정, 정책, 프록시 및 앱 적용 범위로 나누어 점검할 수 있습니다. 먼저 상태를 확인한 뒤 설정을 수정해 구독 문제를 클라이언트 설치 문제로 오해하지 않도록 하세요.

구독을 가져온 후 노드가 보이지 않는 이유는 무엇인가요?

먼저 구독 업데이트가 성공했는지, 현재 선택한 설정이 방금 가져온 설정인지 확인하세요. 업데이트 시간이 바뀌지 않았다면 구독 주소에 접속할 수 있는지 확인하고, 설정 로드에 실패했다면 로그의 YAML 필드 또는 들여쓰기 안내를 살펴보세요. 일부 설정은 프록시 provider를 통해 노드를 지연 로드하므로 provider 업데이트가 끝날 때까지 기다려야 할 수도 있습니다. 자세한 방법은 구독 가져오기 단계를 참고하세요.

Clash가 실행 중인데 브라우저가 여전히 연결되지 않는 이유는 무엇인가요?

코어 실행, 시스템 프록시 활성화 및 정책 그룹 사용 가능 여부는 서로 독립된 조건입니다. 시스템 프록시가 켜져 있는지, 로컬 수신 포트가 시스템 설정과 일치하는지 확인한 다음 브라우저가 독립 프록시를 사용하는지 살펴보세요. 이어서 연결 목록을 확인합니다. 기록이 없으면 트래픽이 클라이언트에 들어오지 않은 경우가 많고, 기록은 있지만 실패한다면 매칭 규칙, 정책 그룹 및 노드 상태를 계속 점검해야 합니다.

규칙 모드, 전역 모드 및 직접 연결 모드는 어떻게 선택하나요?

일상적인 사용에는 설정의 규칙에 따라 각 트래픽이 프록시를 사용할지 직접 연결할지 결정하는 규칙 모드를 주로 선택합니다. 전역 모드는 대부분의 트래픽을 하나의 정책으로 보내므로 노드를 잠시 테스트할 때 적합하고, 직접 연결 모드는 임시로 프록시를 우회할 때 사용합니다. 문제를 진단할 때 모드를 잠시 전환해 비교할 수 있지만 테스트가 끝나면 현재 설정에 맞는 모드로 되돌리세요.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 운영체제의 HTTP 또는 SOCKS 프록시 설정을 따르는 앱을 주로 대상으로 하며 활성화가 간단하고 적용 범위가 명확합니다. TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 트래픽을 가로채며 관리자 권한, 라우팅 및 DNS 설정이 필요할 수 있습니다. 처음 설정할 때는 먼저 시스템 프록시를 확인한 뒤 프록시 설정을 읽지 않는 앱의 필요에 따라 TUN을 검토하는 것이 좋습니다.

사용 문서에서 계속 문제 해결하기 →

TECH NOTES / 최신 글

Clash 설정 및 네트워크 문제 해결 노트

기술 노트는 실제 사용 흐름을 중심으로 구성했습니다. 먼저 초보자가 자주 접하는 개념을 설명한 다음 시스템 프록시, TUN, 노드 회선 및 로컬 설정의 관계를 나누어 살펴봅니다. 클라이언트 문서를 대신하지 않고 “왜 이렇게 설정하는지”, “문제가 생기면 어디부터 확인하는지”를 보충합니다.

전체 기술 노트 보기 →