Clash Plus
처음 설치하거나 구독을 일상적으로 관리하는 경우에 적합합니다. 먼저 GUI에서 설정을 가져오고 프록시 그룹과 시스템 프록시를 설정한 다음, 필요하면 TUN을 활성화하세요.
설치가 끝나면 먼저 설정을 가져온 뒤 시스템 프록시를 켜세요. 시스템 프록시를 사용하지 않는 앱까지 TUN으로 처리하려면 클라이언트의 서비스 및 권한 안내를 별도로 확인하세요.
PACKAGE WORKBENCH / 설치 파일 및 아키텍처
Clash 다운로드와플랫폼별 설치 파일
운영체제를 먼저 선택한 뒤 CPU 아키텍처를 확인하세요. GUI 클라이언트는 설정과 제어를 담당하고 Mihomo 커널은 연결을 처리합니다. 일반 사용자는 클라이언트부터 시작하면 됩니다.
선택 순서
운영체제 → CPU 아키텍처 → 설치 파일 형식. 설치 파일에는 프록시 서비스가 포함되어 있지 않습니다. 연결을 설정하기 전에 구독 주소나 YAML 설정을 준비하세요.
운영체제별 다운로드
플랫폼 탭을 눌러 설치 파일 목록을 전환할 수 있습니다. 공유 주소에 플랫폼 앵커를 포함하면 상대방이 해당 운영체제 항목으로 바로 이동합니다. 각 카드에는 기본 설치 파일을 먼저, 대체 아키텍처 파일을 그 아래에 표시합니다.
Windows GUI 클라이언트
아래 데스크톱 설치 파일은 대부분 x64용입니다. 설정 → 시스템 → 정보에서 시스템 종류를 확인하세요. Windows on ARM 기기는 x64 앱 호환 여부를 먼저 확인해야 합니다. x64는 네이티브 ARM64가 아닙니다.
추천
Clash Verge Rev
데스크톱에서 구독, 규칙, 오버라이드 설정을 관리하려는 경우에 적합합니다. 기존 설정을 옮길 때는 원본 구독을 보존하고 로컬 변경 사항을 항목별로 이전하세요.
실행 오류가 발생하면 오류 메시지 전체를 기록하세요. GUI 실행 환경 누락, 서비스 설치 실패, 설정 문법 오류는 각각 원인이 다르므로 따로 해결해야 합니다.
FlClash
데스크톱과 모바일에서 비슷한 방식으로 사용하고 싶은 경우에 적합합니다. 설치 후 현재 기기의 프록시 포트를 다시 확인하고 다른 클라이언트의 포트 설정을 그대로 적용하지 마세요.
여기서 AMD64는 x86 64비트 아키텍처를 뜻합니다. Intel과 AMD의 해당 프로세서에서 모두 사용할 수 있으며 AMD 전용 패키지가 아닙니다.
Clash Nyanpasu
데스크톱에서 설정을 관리할 수 있으며 YAML 사용 경험이 있고 로컬 설정을 조정하려는 사용자에게 적합합니다. 가져오기 전에 설정에서 요구하는 커널 기능을 확인하세요.
사용자 지정 규칙은 먼저 복사본에서 테스트하세요. 커널이 정상적으로 시작되는지 확인한 뒤 로그인 시 자동 실행을 켜야 잘못된 설정이 매번 로그인할 때 적용되는 일을 막을 수 있습니다.
Clash for Windows
기존 환경의 호환성 확인, 설정 내보내기 및 이전을 위한 보관 다운로드입니다. 새로 설치할 때는 위에 있는 유지 관리 중인 클라이언트를 우선 사용하고 구버전을 기본 선택으로 삼지 마세요.
구형 커널은 새로운 프로토콜, 규칙 유형 또는 DNS 필드를 인식하지 못할 수 있습니다. unknown field 같은 오류가 나면 반복해서 재설치하기보다 지원 기능의 차이인지 먼저 확인하세요.
Windows 시스템 및 설치 확인
| 확인 항목 | 요구사항 또는 권장 사항 | 확인 위치 |
|---|---|---|
| 운영체제 | 지원 중인 Windows 10 / 11 사용을 권장합니다. 최소 버전은 설치 프로그램 안내를 확인하세요. | 설정 → 시스템 → 정보 |
| 프로세서 | 이 페이지에서 제공하는 데스크톱 패키지는 주로 x64 / AMD64입니다. | 시스템 종류와 파일명의 x64 표기를 대조하세요. |
| 설치 권한 | 설치 폴더, 서비스 구성요소 및 TUN에 관리자 권한이 필요할 수 있습니다. | 시스템 권한 안내를 확인한 후 승인하세요. |
| 실행 환경 | 일부 GUI에는 WebView2 등의 실행 환경이 필요합니다. | 설치 프로그램 오류에 따라 필요한 구성요소를 추가하세요. |
새 클라이언트를 테스트하기 전에 기존 클라이언트를 종료하고 시스템 프록시를 끄세요. 두 프로그램이 같은 mixed-port를 사용하면 나중에 실행한 프로그램이 포트를 열지 못할 수 있습니다. 인터페이스를 바꿔도 포트가 자동으로 비워지지는 않습니다.
macOS GUI 클라이언트
Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 ARM64, Intel은 x64입니다. 일부 다운로드 항목은 현재 동일한 x64 파일을 제공합니다. 아래 설명을 확인하고 버튼의 표기만으로 네이티브 아키텍처를 판단하지 마세요.
Clash Plus
칩에 맞는 DMG를 선택하세요. 설치 후 앱을 ‘응용 프로그램’으로 옮기고, 처음 실행할 때 필요한 네트워크 권한을 승인한 다음 구독과 설정을 가져오세요.
디스크 이미지에서 앱을 계속 실행하지 마세요. 설치를 마친 뒤 이미지를 추출하고 로그인 시 자동 실행과 시스템 프록시를 설정하세요.
Clash Verge Rev
구독과 오버라이드 설정을 한곳에서 관리하려는 경우에 적합합니다. 현재 Apple Silicon과 Intel 다운로드 항목은 같은 x64 DMG를 가리킵니다. Apple Silicon에서 실행하기 전에 Rosetta 호환성을 확인하세요.
네이티브 ARM64가 필요하다면 arm64 파일을 명확히 제공하는 클라이언트를 선택하세요. 다운로드한 실제 파일명과 설치 프로그램 안내를 버튼 이름보다 우선 확인해야 합니다.
FlClash
모바일과 비슷한 설정 방식으로 데스크톱을 사용하려는 경우에 적합합니다. 현재 두 칩용 다운로드 항목 모두 AMD64 DMG를 제공합니다. Apple Silicon에서 사용하려면 호환 실행 조건을 확인하세요.
다른 클라이언트에서 옮길 때는 먼저 같은 구독을 가져와 테스트하세요. 프록시 그룹과 규칙이 정상인지 확인한 다음 기존 클라이언트의 로그인 시 자동 실행을 해제하면 됩니다.
ClashX Meta
기존 환경의 설정 관리와 이전을 위한 보관 메뉴 막대 클라이언트입니다. 두 칩용 다운로드 항목 모두 x86_64 파일이므로 네이티브 ARM64 패키지로 사용할 수 없습니다.
시스템 업그레이드 후 프록시 보조 구성요소가 작동하지 않으면 먼저 시스템 네트워크 설정을 복구한 뒤 유지 관리 중인 클라이언트로 옮기세요. 종료된 프로세스를 가리키는 프록시 설정이 남지 않도록 주의하세요.
macOS 시스템 및 설치 확인
| 확인 항목 | 요구사항 또는 권장 사항 | 확인 방법 |
|---|---|---|
| 운영체제 버전 | 최소 지원 버전은 클라이언트마다 다릅니다. 앱 설치 및 실행 안내를 확인하세요. | 이 Mac에 관하여 → macOS 버전 |
| Apple Silicon | arm64가 명시된 파일을 우선 선택하세요. x64 파일은 호환 실행 조건을 확인해야 합니다. | 칩 항목에 Apple 칩이라고 표시됨 |
| Intel | x64, x86_64 또는 AMD64 파일 사용 | 프로세서 항목에 Intel이라고 표시됨 |
| 네트워크 권한 | 시스템 프록시, 보조 서비스, TUN은 필요한 기능에 맞게 권한을 부여하세요. | 시스템 설정에 표시되는 관련 권한 안내 |
macOS에서 앱을 열 수 없다면 출처, 시스템 호환성, 전체 오류 메시지를 확인한 뒤 시스템 설정의 권한 부여 절차를 따르세요. 출처가 불분명한 터미널 명령으로 보안 제한을 일괄 해제하지 마세요.
Android 설치 파일
최근 출시된 휴대전화 대부분은 ARM64를 사용합니다. 구형 기기는 프로세서가 64비트를 지원하더라도 32비트 Android를 실행할 수 있어 ARM64 앱을 설치하지 못할 수 있습니다. 기기에서 실제로 지원하는 ABI에 맞춰 선택하세요.
Clash Plus
해당 아키텍처의 Android 휴대전화에 적합한 ARM64 APK입니다. 구독을 가져온 뒤 VPN 연결을 시작하고, 처음 연결할 때 시스템 안내에 따라 네트워크 제어 권한을 승인하세요.
브라우저에서 다운로드한 경우 실제 설치에 사용할 출처에만 설치 권한을 허용하세요. 설치가 끝나면 권한을 취소할 수 있습니다. 백그라운드 실행 제한은 기기별 설정을 확인하세요.
Clash Meta for Android
시스템 ABI에 따라 ARM64 또는 ARM 패키지를 선택하세요. 잘 모르겠다면 범용 패키지를 사용할 수 있습니다. 지원하는 설정 문법은 포함된 커널에 따라 다르므로 앱 이름만 보고 판단하지 마세요.
범용 패키지는 여러 아키텍처를 포함하는 경우가 많아 파일 크기가 더 클 수 있습니다. 설치에 실패하면 먼저 APK 파싱 오류나 서명 충돌 안내를 확인하세요. 설치 문제를 해결하려고 구독을 연이어 바꾸지는 마세요.
FlClash
ARM64 및 ARM 32비트 패키지를 제공합니다. 데스크톱과 모바일에서 비슷한 설정 방식을 유지하고 싶은 사용자에게 적합합니다.
화면을 잠그면 연결이 끊기는 경우 배터리 최적화, 백그라운드 활동, 자동 시작 설정을 확인하세요. 먼저 시스템이 프로세스를 종료했는지 확인한 뒤 DNS 설정을 변경하세요.
Surfboard
별도의 설정 체계를 사용하는 Android 클라이언트로, 호환되는 설정을 이미 보유한 사용자에게 적합합니다. Clash YAML을 Surfboard 설정으로 바로 가져올 수 있다고 가정하지 마세요.
가져오기 전에 서비스 제공자가 안내한 설정 형식과 프로토콜 지원 여부를 확인하세요. 형식 변환은 표현 방식만 바꿀 뿐, 클라이언트가 지원하지 않는 기능을 자동으로 추가하지 않습니다.
Android 시스템 및 설치 확인
| 확인 항목 | 요구사항 또는 권장 사항 | 확인할 내용 |
|---|---|---|
| 시스템 호환성 | APK 설치 프로그램에 표시된 최소 Android 버전을 확인하세요. | 휴대전화 정보 → Android 버전 |
| CPU 및 ABI | ARM64는 arm64-v8a, ARM은 armeabi-v7a에 해당합니다. | 프로세서 사양만 보지 말고 기기 시스템의 ABI를 확인하세요. |
| VPN 연결 | 일반적으로 동일한 사용자 환경에서는 일반 VPN 연결 하나만 활성화할 수 있습니다. | 다른 VPN, 방화벽 또는 필터링 앱을 확인하세요. |
| 백그라운드 실행 | 필요한 경우 백그라운드 활동을 허용해 화면 잠금 후 프로세스가 종료되지 않도록 하세요. | 배터리 최적화 및 제조사별 백그라운드 관리 설정 |
새 앱과 기존 앱의 서명이 다르면 시스템에서 덮어쓰기를 거부할 수 있습니다. 먼저 설정을 내보내고 백업이 정상인지 확인한 다음 기존 앱을 삭제할지 결정하세요. 앱을 삭제하면 로컬 데이터가 지워지고 구독 기록도 사라질 수 있습니다.
iOS 클라이언트
App Store에서 Clash Plus를 설치하세요. 기기 호환성, 시스템 버전, 현재 스토어 정보는 앱 상세 페이지를 기준으로 확인하고 설치 후 지원되는 구독이나 설정을 가져오세요.
Clash Plus
스토어 상세 페이지에서 개발자, 호환 기기, 기능 설명을 확인하세요. 설치 후 앱을 열어 설정을 가져오고 프록시 정책을 선택한 다음 시스템 안내에 따라 VPN 구성을 추가하세요.
네트워크를 바꾸거나 규칙을 수정한 뒤에는 먼저 연결 로그를 확인하고 재연결이 필요한지 판단하세요. 상태 표시줄에 VPN 아이콘이 보인다고 해서 모든 라우팅 규칙이 예상대로 작동한다는 뜻은 아닙니다.
iOS 시스템 및 설치 확인
| 확인 항목 | 요구사항 또는 권장 사항 | 확인 위치 |
|---|---|---|
| 운영체제 버전 | App Store 상세 페이지의 호환성 정보를 기준으로 확인하세요. | 스토어 상세 페이지 → 호환성 |
| 설치 경로 | 이 페이지에 있는 Clash Plus App Store 링크를 사용하세요. | 앱 이름과 상세 설명을 확인하세요. |
| 연결 권한 | 처음 연결할 때 VPN 구성 추가를 승인하세요. | 시스템 권한 승인 창 및 VPN 설정 |
| 구독 설정 | 유효한 구독 주소 또는 지원되는 로컬 설정이 필요합니다. | 앱 내 설정 목록 및 업데이트 로그 |
이미 다른 VPN 구성이 있다면 현재 실제로 활성화된 구성을 먼저 확인하세요. 구독을 가져온 뒤 업데이트 결과와 프록시 그룹을 살펴보세요. 주소가 저장됐다는 이유만으로 설정까지 정상적으로 다운로드됐다고 판단하지 마세요.
Linux 데스크톱 클라이언트
Debian, Ubuntu 등에서는 DEB를, Fedora 등 RPM 기반 시스템에서는 RPM을 선택하세요. 이 페이지의 GUI 클라이언트 패키지는 AMD64용입니다. GUI가 없는 서버나 다른 아키텍처 기기는 아래 Mihomo 커널 섹션을 확인하세요.
Clash Verge Rev
DEB와 RPM을 제공하며 데스크톱 환경에서 구독과 규칙을 관리하는 데 적합합니다. 배포판의 패키지 관리자로 설치하면 사용 가능한 소프트웨어 의존성도 함께 처리할 수 있습니다.
데스크톱 트레이 표시 여부는 데스크톱 환경과 관련 확장 기능에 따라 달라집니다. 창은 열리는데 트레이가 보이지 않는다고 커널 문제로 단정하지 말고 데스크톱 통합 상태부터 확인하세요.
FlClash
Debian 계열 데스크톱용 AMD64 DEB를 제공합니다. 설정을 가져온 뒤 수신 주소를 확인하고 시스템 프록시와 TUN 중 사용할 방식을 결정하세요.
터미널 프로그램은 데스크톱 프록시 설정을 따르지 않을 수 있습니다. 프록시가 필요한 명령줄 도구에는 프록시 환경 변수를 별도로 설정하거나, 라우팅에 미치는 영향을 파악한 뒤 TUN을 사용하세요.
Linux 시스템 및 설치 확인
| 확인 항목 | 요구사항 또는 권장 사항 | 확인 방법 |
|---|---|---|
| 프로세서 | 이 페이지의 GUI 패키지는 AMD64 / x86_64용입니다. | uname -m |
| 배포판 패키지 형식 | 패키지 관리 체계에 맞춰 DEB 또는 RPM을 선택하고 서로 다른 형식을 섞어 설치하지 마세요. | cat /etc/os-release |
| 데스크톱 의존성 | 그래픽 세션과 설치 프로그램에 명시된 런타임 라이브러리가 필요합니다. | 패키지 관리자의 의존성 정보를 확인하세요. |
| TUN 권한 | 필요한 네트워크 권한과 사용 가능한 TUN 장치가 있어야 합니다. | 서비스 로그와 /dev/net/tun 확인 |
설치가 끝나면 일반 사용자 세션에서 GUI를 먼저 실행하세요. 권한이 필요한 서비스는 클라이언트 안내에 따라 별도로 설정하고 데스크톱 프로그램 전체를 root로 계속 실행하지 마세요. 원격 장비에서 TUN을 켜기 전에 사용할 수 있는 관리 연결을 하나 더 확보하세요.
CORE PACKAGES / 명령줄 및 서비스 배포
Mihomo 커널 다운로드
서버, 라우터, 프로세스를 직접 관리하는 사용자를 위한 패키지입니다. 커널 패키지에는 GUI가 포함되어 있지 않습니다. 일반 사용자는 위의 GUI 클라이언트를 사용하면 됩니다. 별도 배포가 필요한 경우에만 여기에서 파일을 다운로드하세요.
| 시스템 | 아키텍처 | 형식 및 용도 | 로컬 패키지 |
|---|---|---|---|
| Windows | AMD64 | ZIP, 64비트 x86 호스트 | AMD64 ZIP 다운로드 |
| Windows | ARM64 | ZIP, Windows ARM 호스트 | ARM64 ZIP 다운로드 |
| macOS | Intel AMD64 | GZ，Intel Mac | Intel GZ 다운로드 |
| macOS | Apple Silicon ARM64 | GZ, Apple Silicon Mac | ARM64 GZ 다운로드 |
| Linux | AMD64 | DEB, Debian 계열 패키지 | AMD64 DEB 다운로드 |
| Linux | AMD64 | GZ, 독립 실행 파일 압축 패키지 | AMD64 GZ 다운로드 |
| Linux | ARM64 | GZ, 64비트 ARM 기기 | ARM64 GZ 다운로드 |
| Linux | ARMv7 | GZ, 호환되는 32비트 ARM 기기 | ARMv7 GZ 다운로드 |
| Linux | MIPS softfloat | GZ, 소프트 플로트 ABI를 사용하는 MIPS 기기 | MIPS GZ 다운로드 |
압축을 푼 뒤 설정 테스트
GZ 파일은 먼저 압축을 풀어야 합니다. 해당 바이너리의 이름을 mihomo로 바꾼 다음 별도 디렉터리에 설정을 두고 문법을 테스트하세요. 아래 명령은 Unix 계열 환경용이며 서비스 자동 시작을 설정해 주지는 않습니다.
terminal / 설정 문법 테스트
chmod +x ./mihomo
./mihomo -v
./mihomo -t -d ./profile설정을 profile/config.yaml로 저장하세요. 테스트 통과는 설정을 파싱할 수 있다는 뜻일 뿐입니다. 프록시 연결, DNS, 라우팅은 실행 후 각각 확인해야 합니다.
수신 주소 및 서비스 경계
서버에서는 프록시 포트와 제어 인터페이스가 어디에서 수신하는지 먼저 확인하세요. 로컬에서만 사용할 때는 루프백 주소로 유지하고 테스트 편의를 위해 제어 인터페이스나 프록시 포트를 인터넷에 직접 노출하지 마세요.
별도 배포 시에는 데이터 디렉터리, 로그, 권한, 프로세스 재시작, 리소스 파일도 직접 관리해야 합니다. 라우터 시스템에는 전용 관리 구성요소가 포함될 수 있으므로 수동으로 교체하기 전에 구성요소가 요구하는 커널 형식을 확인하세요.
플랫폼별 작업 절차는 전체 플랫폼 설치 및 설정 가이드 →를 확인하세요. 설정 항목의 의미는 설정 용어 설명에서 볼 수 있습니다.
다운로드 완료 후 확인 순서
01 / INSTALL
설치 및 첫 실행
파일 다운로드가 끝났는지 확인하고 설치 프로그램 안내에 따라 진행하세요. 업그레이드 전에는 기존 프로세스를 종료하세요. 클라이언트를 바꿀 때는 구독과 로컬 규칙을 먼저 내보내고 프로그램 폴더 전체를 그대로 복사하지 마세요.
02 / CONFIG
구독 가져오기 및 정책 선택
유효한 구독이나 로컬 YAML을 가져온 뒤 업데이트 로그와 프록시 그룹을 확인하세요. 먼저 규칙 모드로 테스트하고 앱의 요구사항에 따라 시스템 프록시, VPN 또는 TUN 중 사용할 방식을 선택하세요.
03 / VERIFY
연결 및 DNS 확인
커널이 실행 중인지, 포트가 수신 중인지, 규칙이 적용되는지 확인하세요. 연결에 문제가 있으면 로그를 따라 항목별로 점검하고 포트, DNS, 규칙을 한꺼번에 변경하지 마세요. 그래야 문제 원인을 좁힐 수 있습니다.
DOWNLOAD NOTES / 자주 묻는 질문
설치 파일 선택 및 다운로드 문제
Clash를 처음 설치한다면 어떤 클라이언트를 선택해야 하나요?
Windows, macOS, Android, iOS에서는 Clash Plus를, Linux에서는 Clash Verge Rev를 먼저 살펴보세요. 일반 데스크톱 사용자는 GUI 클라이언트를 선택하면 되며 Mihomo 커널을 따로 다운로드할 필요는 없습니다. 설치 파일에는 바로 사용할 수 있는 프록시 서비스가 포함되어 있지 않으므로 설치 후 구독이나 설정을 가져와야 합니다.
ARM64, AMD64, x64, 범용 버전 중 무엇을 선택해야 하나요?
AMD64와 x64는 보통 64비트 x86 아키텍처를 뜻하고, ARM64는 해당 ARM 프로세서용입니다. 먼저 시스템의 프로세서 정보나 Mac 정보를 확인한 뒤 다운로드 파일명을 대조하세요. Android에서 아키텍처를 모르겠다면 제공되는 범용 패키지를 선택할 수 있습니다. macOS도 표시된 아키텍처가 실제 파일명과 일치하는지 확인하세요. x64 파일은 네이티브 ARM64 패키지가 아닙니다.
다운로드를 눌렀는데 실패하거나 파일이 열리지 않으면 어떻게 하나요?
먼저 브라우저의 다운로드 기록에서 다운로드가 완료됐는지, 파일 확장자가 올바른지 확인하세요. 실패했다면 잠시 후 다시 시도하고 디스크 공간, 네트워크 연결, 브라우저의 차단 알림을 점검하세요. 다운로드가 끝났는데 실행되지 않는다면 시스템 아키텍처와 설치 프로그램 안내를 먼저 확인하세요. 웹페이지를 설치 파일로 저장하거나 시스템 보안 기능을 무작정 끄지 마세요.
클라이언트를 업데이트하기 전에 무엇을 백업해야 하나요?
설정을 내보내거나 클라이언트 설정 폴더를 백업하고 구독 주소, 사용자 지정 규칙, 오버라이드 설정, 로컬 수신 포트를 기록해 두세요. 기존 클라이언트를 종료한 다음 새 버전을 설치합니다. 클라이언트를 바꿀 때 기존 폴더 전체를 덮어쓰지 말고 설정을 다시 가져온 뒤 항목별로 옮기세요. 구독 주소와 로그에 포함된 인증 정보는 공개하지 마세요.
Clash for Windows와 ClashX Meta는 왜 보관된 클라이언트인가요?
두 클라이언트는 유지 관리가 중단됐습니다. 기존 환경의 호환성과 이전을 위해 다운로드 경로만 남겨 두었습니다. 새로 설치할 때는 현재 유지 관리 중인 대체 클라이언트를 우선 선택하세요. 구형 커널은 새로운 프로토콜이나 설정 필드를 지원하지 않을 수 있습니다. 설정을 가져오는 중 오류가 발생하면 구독을 반복해서 업데이트하기보다 커널의 지원 여부를 확인하세요.
설치가 끝났는데 왜 바로 인터넷에 연결되지 않나요?
클라이언트 설치는 프로그램을 준비하는 단계일 뿐입니다. 유효한 구독이나 설정을 가져오고, 사용할 수 있는 프록시 그룹을 선택한 다음 커널을 실행해야 합니다. 플랫폼에 따라 시스템 프록시, VPN 연결 또는 TUN도 활성화하세요. 설정 로드 상태, 수신 포트, 프록시 모드, DNS 로그를 차례로 확인하고 자세한 방법은 사이트의 빠른 시작 가이드를 참고하세요.