운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 일상적인 연결에, Mihomo 코어는 직접 배포할 때 사용합니다.
일상적인 사용에는 Clash Plus를 먼저 확인하세요. 아래 GUI 설치 파일은 x64용입니다. Windows ARM 기기에서는 앱 에뮬레이션과 네트워크 서비스 호환성을 별도로 확인해야 합니다. x64 설치가 완료됐다고 해서 모든 기능이 지원되는 것은 아닙니다.
설치부터 설정 가져오기, 프록시 그룹 선택까지 일상적인 사용에 적합합니다. 다운로드 후 설치 프로그램을 실행하고, 처음 시작할 때 구독이나 로컬 설정을 가져온 다음 시스템 프록시를 켜세요. TUN이 필요하다면 클라이언트 안내에 따라 서비스 권한을 설정하세요. 다른 클라이언트가 동시에 네트워크를 제어하지 않도록 주의하세요.
공식 웹사이트: clashplus.io. 기존 클라이언트를 사용 중이라면 사용자 지정 규칙을 먼저 백업한 뒤 설정을 옮기세요.
구독, 규칙, 실행 로그를 GUI로 관리하려는 데스크톱 사용자에게 적합합니다. 설치 후 서비스 상태와 로컬 수신 포트를 확인한 다음 시스템 프록시와 TUN 중 사용할 방식을 선택하세요. 시스템에서 실행 구성 요소가 없다고 알리면 설치 프로그램 안내에 따라 필요한 항목을 설치하세요. 문제를 확인하지 않은 채 반복해서 덮어 설치하지 마세요.
GUI를 제공하는 크로스 플랫폼 클라이언트입니다. 일반적인 데스크톱 설치에는 EXE를 권장합니다. ZIP은 프로그램 폴더를 직접 관리하려는 경우에 적합하며, 압축을 푼 뒤에도 실행 종속성과 서비스 권한을 확인해야 합니다. 프로그램 파일을 업데이트해도 구독은 갱신되지 않으므로 설치 후 설정과 프록시 그룹 상태를 각각 확인하세요.
데스크톱 GUI 클라이언트의 대안으로, 화면에서 설정을 조정하고 연결 상태를 확인하려는 사용자에게 적합합니다. 다른 클라이언트에서 옮길 때는 기존 구독을 먼저 가져온 뒤 오버라이드 설정을 하나씩 복원하세요. 클라이언트마다 설정을 병합하는 방식이 다를 수 있으므로 사용자 데이터 폴더 전체를 그대로 복사하지 않는 것이 좋습니다.
이전 환경을 재현하거나 마이그레이션할 때 참고할 수 있도록 제공합니다. 유지 관리가 종료된 클라이언트이므로 새 시스템과 새 설정 구문을 현재 관리 중인 클라이언트와 동일한 수준으로 지원하지 않습니다. 새로 설치할 때는 위의 클라이언트를 선택하세요. 아카이브 버전이 꼭 필요하다면 기존 설정을 복사해 두고, 이전 코어가 새 항목이 포함된 설정을 읽지 않도록 주의하세요.
| 확인 항목 | 선택 기준 | 설치 권장 사항 |
|---|---|---|
| 운영체제 | 지원되는 Windows 10 / 11 사용을 권장합니다. 최소 버전은 각 설치 프로그램의 요구 사항을 확인하세요. | 오래된 시스템은 실행 구성 요소의 지원 여부를 먼저 확인하세요. 아카이브 클라이언트로 시스템 유지 관리를 대신할 수는 없습니다. |
| 프로세서 아키텍처 | 설정 → 시스템 → 정보 → 시스템 종류. 이 섹션의 GUI 패키지는 x64용입니다. | 32비트 시스템에서는 x64 패키지를 사용할 수 없습니다. ARM 기기는 호환 여부를 먼저 확인하세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 필요한 권한이 다릅니다. | 서비스를 설치하면 UAC가 표시될 수 있습니다. 방화벽 권한은 실제 사용 범위에 맞게 허용하세요. |
설치 후 브라우저 접속을 확인한 다음 다른 앱을 테스트하세요. 브라우저에서만 사용할 수 있다면 설치 파일을 바꾸기 전에 해당 앱이 시스템 프록시를 따르는지 확인하세요. 자세한 절차는 Windows 설치 및 설정 가이드를 참조하세요.
이 Mac에 관하여에서 칩 종류를 확인하세요. Apple Silicon과 Intel을 구분해야 합니다. 일부 호환 다운로드 링크는 현재 x64 파일을 제공하며, 아래에 표시된 내용은 네이티브 ARM 빌드가 있다는 뜻이 아닙니다.
칩에 맞는 DMG를 다운로드하고 디스크 이미지를 연 다음 앱을 응용 프로그램 폴더로 옮겨 실행하세요. 처음 사용할 때 설정을 가져오고 프록시 그룹에 선택 가능한 항목이 있는지 확인한 뒤 시스템 프록시를 설정하세요. 네트워크 확장 기능이나 서비스 권한이 필요하면 시스템 안내에 표시된 앱 이름을 확인한 후 진행하세요.
공식 웹사이트: clashplus.io. 클라이언트를 바꾸기 전에 기존 프록시 프로그램을 종료해 시스템 프록시 설정이 서로 덮어쓰이지 않도록 하세요.
설정과 프록시 모드를 GUI로 관리할 수 있습니다. 현재 두 다운로드 링크 모두 대체 파일은 x64이며, Apple Silicon에서 사용하기 전에 Rosetta 및 관련 서비스의 호환성을 확인해야 합니다. 설치 후 코어가 실행되는지 확인한 다음 구독을 가져오세요. 화면이 정상적으로 열리더라도 네트워크 서비스까지 사용할 수 있다고 단정할 수는 없습니다.
여러 기기에서 비슷한 사용 환경을 원하는 사용자에게 적합합니다. 현재 호환 링크는 AMD64 파일이며, Apple Silicon에서는 변환 실행이 가능한지 먼저 확인해야 합니다. 설정을 옮길 때 구독 원문과 로컬 규칙을 보관하고, 첫 연결에서는 트래픽 제어 방식을 하나만 활성화해 권한 문제와 설정 문제를 구분하세요.
유지 관리가 종료되었으며 기존 환경의 마이그레이션과 이전 설정 확인을 위해 제공합니다. 현재 호환 링크도 x86_64 파일이며 네이티브 ARM 패키지가 아닙니다. 새 기기에서는 유지 관리 중인 클라이언트를 사용하세요. 마이그레이션 전에 기존 설정 경로, 수신 포트와 프록시 그룹 선택 내용을 기록해 두세요. 앱만 복사하고 로컬 설정을 빠뜨리지 않도록 주의하세요.
| 확인 항목 | 요구 사항 및 범위 | 확인 위치 |
|---|---|---|
| 시스템 버전 | 최소 지원 버전은 클라이언트마다 다릅니다. 설치 전에 앱 안내와 릴리스 정보를 확인하세요. | 시스템 설정 → 일반 → 이 Mac에 관하여 |
| 칩 종류 | Apple Silicon은 ARM64, Intel은 x64를 선택하세요. x64 호환 패키지는 Rosetta 지원 여부를 확인해야 합니다. | ‘칩’ 또는 ‘프로세서’ 항목 |
| 권한 및 폴더 | 앱을 응용 프로그램 폴더로 옮기세요. 네트워크 서비스를 사용하려면 권한이 필요할 수 있습니다. | 시스템 설정의 개인정보 보호 및 보안, 네트워크 관련 항목 |
실행이 차단되면 다운로드한 파일과 시스템 보안 안내를 먼저 확인하세요. 기기 전체의 보안 기능을 바로 해제하는 것은 권장하지 않습니다. 설치, 구독 가져오기 및 네트워크 권한 설정 순서는 macOS 설정 가이드를 참조하세요.
최근 출시된 스마트폰은 대부분 ARM64를 사용하지만, 실제 지원되는 앱 아키텍처를 확인해야 합니다. APK를 설치한 다음 설정을 가져오세요. 처음 연결할 때 시스템 VPN 권한 요청이 표시되면 선택한 클라이언트가 실행 중인지 확인하세요.
Android 스마트폰에서 구독과 프록시를 일상적으로 사용하기에 적합합니다. 다운로드한 파일을 설치할 때는 이번에 사용할 브라우저나 파일 관리자에만 설치 권한을 허용한 뒤 설정을 가져오세요. 앱을 전환한 뒤 연결이 끊기면 반복해서 재설치하지 말고 백그라운드 실행, 배터리 최적화와 제조사 절전 설정을 확인하세요.
공식 웹사이트: clashplus.io. 이 링크는 ARM64 패키지입니다. 32비트 기기에서는 아래에서 아키텍처에 맞는 클라이언트를 선택하세요.
ARM64, ARM 32비트, 범용 설치 파일을 제공합니다. 아키텍처를 알고 있다면 해당 패키지를 선택하세요. 확인하기 어렵다면 범용 패키지를 고려할 수 있지만 파일 크기가 더 큰 편입니다. 구독을 가져온 뒤 설정을 업데이트하고 파싱 결과를 확인한 다음 연결을 시작하세요. 설정 다운로드 실패를 APK 설치 문제로 오해하지 않도록 주의하세요.
스마트폰, 태블릿 및 아키텍처가 맞는 Android 환경에서 사용할 수 있습니다. 에뮬레이터는 일반 스마트폰과 달리 ARM64를 사용하지 않을 수 있으므로 에뮬레이터의 ABI에 맞는 패키지를 선택하세요. 설치 후 설정이 활성화되었는지 확인한 다음 VPN 권한을 허용하세요. 다른 VPN 앱을 함께 실행하면 연결 상태가 달라질 수 있으니 먼저 종료한 뒤 테스트하세요.
호환되는 설정 형식을 사용하는 Android 사용자용입니다. Surfboard의 설정 구문은 Clash YAML과 다르므로 파일 확장자만 바꿔 바로 가져올 수 없습니다. 다운로드 전에 구독 서비스가 호환 형식을 제공하는지, 프록시 프로토콜과 규칙을 지원하는지 확인한 다음 설치 및 연결을 테스트하세요.
| 확인 항목 | 선택 기준 | 주의 사항 |
|---|---|---|
| 시스템 버전 | 각 APK의 최소 시스템 요구 사항과 설치 프로그램 안내를 확인하세요. | 시스템 버전이 오래됐다면 클라이언트 지원 범위를 먼저 확인하세요. |
| 앱 아키텍처 | ARM64는 arm64-v8a, ARM 32비트는 armeabi-v7a에 해당합니다. | 확인하기 어렵다면 기기 사양을 확인하세요. 에뮬레이터는 x86_64 지원 여부도 확인해야 합니다. |
| 설치 및 실행 | 설치 출처 권한, 시스템 VPN 권한, 백그라운드 실행 조건 | 서명 충돌이 발생하면 설정을 먼저 백업하세요. 데이터가 사라질 수 있으므로 바로 삭제하지 마세요. |
설치 프로그램에서 ‘호환되지 않음’이 표시되면 시스템 버전과 아키텍처부터 확인하세요. ‘서명이 일치하지 않음’은 업데이트 출처 문제이므로 해결 방법이 다릅니다. 연결 및 배터리 절전 설정은 Android 설치 및 설정 가이드를 참조하세요.
App Store에서 Clash Plus를 설치하세요. 설치 전에 스토어 페이지에서 시스템 호환성 및 앱 정보를 확인하고, 설치 후 클라이언트에서 설정을 가져온 다음 VPN 권한을 허용하세요.
App Store 상세 페이지에서 앱 이름과 호환성을 확인한 뒤 설치하세요. 처음 실행하면 유효한 설정을 추가하고 시스템 안내에 따라 VPN 구성을 허용하세요. 프록시 그룹을 선택한 다음 연결을 시작하세요. 설정을 바꿀 때는 새 설정이 제대로 불러와졌는지 확인한 뒤 대상 앱에서 접속을 테스트하세요.
공식 웹사이트: clashplus.io. 설치 전에 스토어 페이지의 시스템 요구 사항과 앱 정보를 함께 확인하세요.
| 확인 항목 | 요구 사항 및 범위 | 설치 권장 사항 |
|---|---|---|
| 시스템 호환성 | 현재 App Store 상세 페이지의 안내를 따르세요. | 기기 지원 여부와 시스템 버전을 확인한 다음 앱을 설치하세요. |
| 네트워크 권한 | 처음 연결할 때 VPN 구성 추가를 허용해야 합니다. | 시스템 권한 요청 창에 표시된 앱 이름을 확인하세요. |
| 설정 준비 | 유효한 구독 또는 클라이언트에서 지원하는 설정 파일 | 설정을 가져온 뒤 프록시 그룹을 확인하세요. VPN 아이콘만으로 접속 여부를 판단하지 마세요. |
시스템에 VPN 연결 중이라고 표시되어도 터널이 활성화됐다는 뜻일 뿐입니다. 프록시 노드, DNS와 분기 규칙에 따라 앱별 접속 결과가 달라질 수 있습니다. 먼저 접속이 확실한 주소를 열어 본 다음 실제 사용하는 앱을 테스트하세요. 절차는 iOS 설정 가이드를 참조하세요.
데스크톱 환경에서는 GUI 클라이언트를 권장합니다. 아래 패키지는 AMD64용이며 배포판에 맞춰 DEB 또는 RPM을 선택하세요. 서버, 컨테이너와 라우터에서는 데스크톱 GUI 대신 Mihomo 코어를 확인하세요.
Linux 데스크톱에서 우선 고려할 클라이언트입니다. Debian·Ubuntu 계열 배포판은 보통 DEB, Fedora 등 RPM 계열 배포판은 RPM을 선택하며 최종적으로는 배포판의 패키지 관리 방식에 따르세요. 시스템 패키지 관리자로 설치하면서 종속성을 처리하세요. 실행 후 코어 상태를 확인하고 데스크톱 프록시와 설정을 적용하세요.
Debian 계열 데스크톱에서 GUI로 연결하고 설정을 관리하려는 사용자에게 적합합니다. 설치 전에 시스템이 AMD64인지, GUI 실행 종속성이 충족되는지 확인하세요. 터미널 앱은 보통 데스크톱 시스템 프록시를 자동으로 따르지 않습니다. 앱별로 프록시 환경 변수를 설정하거나 라우팅 범위를 확인한 뒤 TUN을 구성하세요.
| 확인 항목 | 확인 방법 | 요구 사항 및 권장 사항 |
|---|---|---|
| CPU 아키텍처 | uname -m 실행 | 이 섹션의 GUI 패키지는 x86_64 / AMD64용입니다. ARM 서버는 코어 섹션을 확인하세요. |
| 배포판 패키지 형식 | 배포판 문서와 패키지 관리자를 확인하세요. | 파일 이름만 바꿔 DEB와 RPM을 서로 변환할 수 없습니다. 설치 과정에서 종속성도 처리해야 합니다. |
| 실행 환경 | 데스크톱 세션, 런타임 라이브러리 및 서비스 권한을 확인하세요. | 명령줄 전용 환경에서는 독립 코어를 선택하세요. TUN을 사용하려면 네트워크 관리와 방화벽 규칙도 확인해야 합니다. |
화면은 열리지만 코어가 시작되지 않으면 실행 권한, 포트 사용 여부와 서비스 로그부터 확인하세요. 원격 시스템에서 기본 경로를 변경하기 전에 복구 가능한 관리 연결을 확보하세요. 배포 방법은 Linux 설치 및 설정 가이드를 참조하세요.
서버, 라우터 및 서비스를 직접 관리하려는 사용자를 위한 코어입니다. GUI 설정 화면은 제공하지 않으므로 일반 데스크톱과 스마트폰에서는 앞에 소개된 GUI 클라이언트를 권장합니다.
| 시스템 | 프로세서 아키텍처 | 파일 형식 | 다운로드 |
|---|---|---|---|
| Windows | AMD64 / x64 | ZIP | Windows AMD64 다운로드 |
| Windows | ARM64 | ZIP | Windows ARM64 다운로드 |
| macOS | Intel / AMD64 | GZ | macOS Intel 다운로드 |
| macOS | Apple Silicon / ARM64 | GZ | macOS ARM64 다운로드 |
| Linux | AMD64 | DEB | Linux AMD64 DEB 다운로드 |
| Linux | AMD64 | GZ | Linux AMD64 GZ 다운로드 |
| Linux | ARM64 | GZ | Linux ARM64 다운로드 |
| Linux | ARMv7 | GZ | Linux ARMv7 다운로드 |
| Linux | MIPS softfloat | GZ | Linux MIPS softfloat 다운로드 |
유효한 YAML 설정, 쓰기 가능한 데이터 폴더와 사용 가능한 수신 포트를 준비하세요. ZIP은 압축을 푼 뒤 실행하고, GZ는 압축을 풀어 바이너리를 얻은 다음 Unix 계열 시스템에서 실행 권한을 설정해야 합니다. DEB는 배포판 패키지 관리자로 설치해야 하며 단일 바이너리처럼 취급하면 안 됩니다.
Linux에서는 먼저 uname -m을 실행해 아키텍처를 확인한 뒤 펌웨어 정보를 살펴보세요. 아키텍처 이름이 비슷해도 ABI가 같다는 뜻은 아닙니다. 특히 MIPS, MIPSel, softfloat 패키지를 혼용하지 마세요. ‘바이너리 파일을 실행할 수 없음’ 오류가 발생하면 권한을 높여 반복 실행하지 말고 아키텍처부터 확인하세요.
압축을 푼 프로그램의 이름을 mihomo로 바꾸고 같은 작업 폴더에 config.yaml을 준비한 뒤 설정 구문을 테스트하세요. 테스트가 통과해도 설정을 파싱할 수 있다는 뜻일 뿐, 노드 연결과 DNS 경로는 별도로 확인해야 합니다. 서비스로 정식 실행하기 전에 작업 폴더, 실행 사용자와 로그 위치를 기록하세요.
./mihomo -t -f ./config.yaml
./mihomo -f ./config.yaml위 명령은 Unix 계열 터미널에서 수동으로 테스트할 때 사용합니다. Windows에서는 해당 실행 파일 이름으로 같은 옵션을 지정하세요. TUN이나 투명 프록시가 필요하면 시스템 기능에 맞춰 권한과 라우팅을 설정하세요. GUI 클라이언트의 서비스 설정을 라우터에 그대로 적용하지 마세요. 공통 준비 사항과 플랫폼별 차이는 전 플랫폼 가이드를 참조하세요.
설치, 설정과 네트워크 확인을 나눠 진행하면 문제가 발생한 단계를 쉽게 찾을 수 있습니다.
업그레이드 전에 현재 클라이언트 이름, 설정 저장 경로와 프록시 모드를 기록하고 직접 추가한 규칙과 오버라이드 내용을 백업하세요. 구독 링크에 접근 자격 증명이 포함될 수 있으므로 공개 댓글, 스크린샷이나 온라인 변환 도구에 붙여 넣지 마세요. 클라이언트를 바꿀 때는 기존 구독을 다시 가져온 뒤 필요한 로컬 변경 사항을 복원하는 것이 좋습니다.
한 기기에 클라이언트를 여러 개 설치해도 동시에 활성화해도 된다는 뜻은 아닙니다. 새 클라이언트를 설치하기 전에 기존 프로그램을 종료하고 시스템 프록시나 터널을 끄세요. 수신 포트, 가상 네트워크 어댑터와 DNS 설정이 충돌할 수 있습니다. 설치 프로그램에서 권한을 요청하면 출처와 용도를 확인한 후 진행하세요.
처음 실행할 때 코어 상태를 확인하고 구독이나 로컬 YAML 파일을 가져온 뒤 설정이 활성화됐는지, 프록시 그룹에서 항목을 선택할 수 있는지 확인하세요. 그다음 트래픽 제어 방식을 하나만 활성화하고 브라우저부터 실제 사용하는 앱 순서로 접속을 테스트하세요. 일부 앱은 시스템 프록시를 따르지 않으므로 별도 설정이 필요하거나 TUN을 사용할 수 있습니다.
접속에 실패하면 오류 메시지와 필요한 로그를 보관하고 설정 파싱, 노드 연결, 도메인 확인 및 라우팅 문제를 구분해 살펴보세요. 로그에 구독 주소, 도메인과 노드 정보가 포함될 수 있으므로 공유하기 전에 민감한 내용을 가리세요. 자세한 절차는 Clash 시작 가이드를, 용어 차이는 용어 빠른 찾아보기를 참조하세요.
패키지 선택, 업그레이드와 아카이브 클라이언트 사용 기준을 안내합니다. 연결 문제는 자주 묻는 질문에서 확인하세요.
Windows, macOS, Android, iOS에서는 Clash Plus를, Linux에서는 Clash Verge Rev를 먼저 확인하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 GUI 클라이언트를 다운로드하면 됩니다. 설정과 실행 옵션, 시스템 서비스를 직접 관리하려면 Mihomo 코어를 선택하세요.
기기 외관이 아니라 운영체제에 표시된 프로세서 아키텍처를 기준으로 선택하세요. Windows에서는 시스템 종류, Mac에서는 이 Mac에 관하여의 칩 정보를 확인할 수 있습니다. Android는 기기 사양을 확인하고, Linux에서는 uname -m을 실행하세요. 아키텍처를 확인하기 어려운 Android 기기는 범용 패키지를 사용할 수 있지만 파일 크기가 더 큰 편입니다. 일부 Mac 다운로드는 현재 x64 파일이므로 Apple Silicon 사용자는 Rosetta 호환 여부를 확인하세요.
클라이언트 설치와 프록시 설정은 별개의 단계입니다. 설치 후 유효한 구독이나 로컬 YAML 설정을 불러오고, 프록시 그룹을 선택한 다음 시스템 프록시를 켜거나 필요에 따라 TUN을 설정해야 합니다. 설치 파일에는 사용할 수 있는 프록시 노드가 포함되어 있지 않습니다. 연결되지 않으면 설정 불러오기 결과와 로그부터 확인하세요.
현재 클라이언트와 설정 경로, 사용 중인 프록시 모드를 기록하고 로컬 규칙, 오버라이드 내용과 설정 파일을 백업하세요. 포트나 가상 네트워크 어댑터가 충돌하지 않도록 기존 클라이언트를 종료한 뒤 설치 프로그램을 실행하세요. 클라이언트 간 이전 시 사용자 데이터 폴더 전체를 덮어쓰지 말고 설정을 다시 가져오는 것이 좋습니다.
Clash for Windows와 ClashX Meta는 이전 환경 재현 및 마이그레이션을 위한 아카이브 링크로 제공합니다. 유지 관리가 중단된 클라이언트는 향후 시스템 변경, 새 프로토콜 및 설정 항목을 지원한다고 보장할 수 없습니다. 새 기기에서는 유지 관리 중인 클라이언트를 선택하고, 기존 설정을 옮기기 전에 백업한 뒤 파싱 로그를 확인하세요.