Clash Plus
권장처음 설치하는 사용자에게 적합한 선택입니다. 설치 후 구독을 가져와 구성을 선택하고, 아웃바운드 모드와 시스템 프록시를 확인하세요. 프록시 출구가 아직 설정되지 않았다면 스위치만 켜지 마세요. 여러 기기에서 사용할 경우 구독 형식과 로컬 설정을 각각 확인해야 합니다.
클라이언트 / 설치 파일 / 커널
Clash 다운로드
운영체제와 프로세서 아키텍처에 맞는 클라이언트를 선택하세요. Windows, macOS, Android, iOS에는 Clash Plus를 권장하며, Linux에서는 Clash Verge Rev를 먼저 확인하세요. 서비스를 직접 배포할 때는 Mihomo 커널을 선택하면 됩니다.
Windows 클라이언트
먼저 “설정 → 시스템 → 정보”에서 시스템 유형을 확인하세요. 아래 GUI 클라이언트는 x64 설치 파일입니다. ARM 기기에서는 시스템의 앱 호환 조건을 먼저 확인해야 하며, x64와 ARM64를 같은 네이티브 패키지로 보면 안 됩니다.
Clash Verge Rev
Windows · x64구성, 규칙, 프록시 트래픽 처리 방식을 관리하는 데 적합한 데스크톱 클라이언트입니다. 시스템 프록시와 TUN은 서로 다른 트래픽 처리 방식입니다. 먼저 시스템 프록시가 작동하는지 확인한 다음, 필요에 따라 TUN과 관련 서비스 권한을 설정하세요.
FlClash
Windows · AMD64데스크톱에서 설정을 가져오고 정책을 선택할 수 있습니다. 기존 YAML을 옮길 때는 파일 경로, 규칙 세트 위치, 외부 컨트롤 설정을 먼저 확인하세요. 다른 기기의 로컬 경로를 현재 환경에 그대로 가져오지 않도록 주의해야 합니다.
Clash Nyanpasu
Windows · x64데스크톱에서 구성을 관리하는 또 다른 선택지입니다. 클라이언트를 바꾸기 전 기존 클라이언트를 종료하고 시스템 프록시나 가상 네트워크 어댑터를 통한 트래픽 처리를 해제하세요. 여러 프로세스가 수신 포트를 동시에 사용하지 않도록 하고, 설정을 가져온 뒤 현재 적용된 구성을 다시 확인하세요.
Clash for Windows
지원 종료이전 환경을 재현하거나 기존 설정을 옮길 때 참고할 수 있는 보관용 다운로드입니다. 구형 클라이언트가 현재 Mihomo의 모든 기능을 지원하는 것은 아니며, 새 프로토콜과 DNS 매개변수, 규칙 문법에 차이가 있을 수 있습니다. 새 환경에는 위의 클라이언트를 권장합니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 및 아키텍처 | 선택한 클라이언트가 지원하는 Windows 버전을 사용하세요. 이 섹션의 설치 파일은 x64 / AMD64용이며, 최소 시스템 버전은 설치 프로그램 안내를 확인하세요. |
| 권한 | 일반 설정 가져오기와 TUN 서비스 설치에는 서로 다른 권한이 필요합니다. 시스템 서비스를 설치해야 한다면 클라이언트 안내에 따라 관리자 권한을 부여하세요. |
| 트래픽 처리 충돌 | 다른 프록시나 VPN 클라이언트를 먼저 종료하세요. 포트를 사용 중인 프로세스가 있다면 여러 트래픽 처리 옵션을 동시에 켜는 대신 로그에서 해당 프로세스를 확인하세요. |
macOS 클라이언트
“이 Mac에 관하여”에서 칩 유형을 확인하세요. Apple Silicon은 ARM64로 명시된 파일을, Intel은 x64를 선택하는 것이 좋습니다. 현재 목록에서는 일부 클라이언트의 두 아키텍처 버튼이 동일한 x64 파일을 가리킵니다. 아래에 실제 파일 유형을 표시했습니다.
Clash Plus
권장ARM64와 x64 파일을 각각 제공합니다. 디스크 이미지 파일을 열고 설치 안내에 따라 앱을 응용 프로그램 폴더로 옮긴 뒤 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 권한 요청을 처리하고, 이후 구성을 가져와 시스템 프록시가 적용되는지 확인하세요.
Clash Verge Rev
현재 파일 · x64구독, 규칙, 데스크톱 트래픽 처리 설정을 관리할 수 있습니다. 현재 목록의 Apple Silicon 버튼에서도 네이티브 ARM64가 아닌 x64 디스크 이미지를 받습니다. 사용 전에 Rosetta 호환 여부를 확인하세요. 기기 이름만 보고 파일 아키텍처를 판단하지 마세요.
FlClash
현재 파일 · AMD64설정을 옮길 때 DNS, 규칙 세트 캐시, 시스템 프록시 상태를 각각 확인하세요. 현재 macOS 다운로드 버튼 두 개는 모두 AMD64 파일을 가리킵니다. Apple Silicon 사용자는 호환 실행 조건을 확인하세요. 네이티브 ARM64 파일이 필요하면 위에서 아키텍처를 명확히 구분해 제공하는 클라이언트를 선택하세요.
ClashX Meta
지원 종료이전 환경 이전을 위한 보관용 다운로드입니다. 현재 목록의 두 버튼은 모두 x86_64 파일을 가리키며, 네이티브 ARM64 설치 파일이 아닙니다. 기존 설정을 사용할 때는 커널 기능과 시스템 권한의 차이를 확인하세요. 새로 설치할 때는 계속 지원되는 클라이언트를 권장합니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 칩 | Apple Silicon과 Intel에 맞춰 ARM64와 x64를 각각 확인하세요. 호환 실행이 네이티브 아키텍처 지원을 뜻하지는 않습니다. |
| 운영체제 버전 | 선택한 클라이언트의 현재 설치 파일에 명시된 시스템 요구 사항을 확인하세요. macOS를 업그레이드하기 전에 보조 서비스와 네트워크 트래픽 처리 방식이 계속 지원되는지 확인하세요. |
| 권한 | 시스템 설정에서 구체적인 보안 알림을 확인하세요. 보조 서비스, 네트워크 확장 또는 키체인 접근을 요청하는 경우 현재 설치한 클라이언트의 요청인지 먼저 확인하세요. |
Android 클라이언트
최근 출시된 휴대폰 대부분은 ARM64를 사용하지만, 실제 앱 실행 환경을 확인해야 합니다. APK를 설치하기 전에 다운로드가 완료됐는지 확인하세요. 처음 연결할 때 시스템에서 VPN 권한을 요청할 수 있습니다. 이 권한은 네트워크 요청을 처리하기 위한 것으로, 프록시 출구 설정이 완료됐다는 뜻은 아닙니다.
Clash Plus
권장이 다운로드는 ARM64 설치 파일입니다. 설치 후 유효한 구독을 가져와 구성이 로드됐는지 확인하고, 프록시 정책을 선택한 뒤 연결을 시작하세요. 화면을 잠근 뒤 연결이 끊긴다면 구독을 반복해서 바꾸기보다 시스템의 배터리 관리와 백그라운드 제한을 먼저 확인하세요.
Clash Meta for Android
ARM64 / ARMv7 / 범용기기 아키텍처에 맞는 설치 파일을 선택하세요. 확인하기 어렵다면 범용 패키지가 현재 시스템과 호환되는지 살펴보세요. 앱별 트래픽 분기 설정을 사용하는 경우 대상 앱이 트래픽 처리 범위에 포함됐는지도 확인해야 합니다. 클라이언트를 우회하는 요청을 규칙 미적용으로 오해하지 않도록 주의하세요.
FlClash
ARM64 / ARMv7두 가지 ARM 아키텍처의 APK를 제공합니다. 아키텍처별 파일은 기능 등급이 다른 것이 아니라 시스템 호환성이 다릅니다. 현재 시스템에서 실행할 수 있는 패키지를 선택하세요. 앱이 설치되지 않는다는 메시지가 표시되면 기존 앱의 서명, 아키텍처, 시스템 호환성을 먼저 확인하고, 삭제하기 전에 로컬 설정을 백업하세요.
Surfboard
Android · 범용 패키지다른 설정 체계를 사용하는 대체 클라이언트입니다. Surfboard 설정 형식은 Mihomo YAML과 호환되지 않으므로 가져오기 전에 서비스 제공자가 지원하는 형식과 프로토콜을 확인하세요. 파일 확장자만 바꿔서는 한 형식의 설정을 다른 형식으로 변환할 수 없습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 실행 환경 | 시스템이 ARM64 또는 ARMv7 앱을 지원하는지 확인하세요. 범용 패키지도 클라이언트 자체의 최소 Android 버전을 충족해야 합니다. |
| 설치 권한 | 브라우저나 파일 관리자에서 앱 설치를 허용하라는 메시지가 표시될 수 있습니다. 실제로 사용하는 설치 출처에만 권한을 부여하세요. |
| 연결 권한 | 같은 사용자 환경에서는 다른 VPN 앱이 현재 연결을 대체할 수 있습니다. 새 클라이언트를 확인하기 전에 기존 연결을 종료하세요. |
iOS 및 iPadOS 클라이언트
App Store에서 Clash Plus를 설치하세요. iPhone과 iPad의 구체적인 시스템 요구 사항 및 기기 호환 범위는 App Store 상세 페이지를 확인하세요. 설치 후 구독을 가져오고 연결을 시작할 때 시스템의 VPN 구성 권한 요청을 승인하면 됩니다.
Clash Plus
권장App Store에서 설치를 시작한 다음 안내에 따라 구독이나 설정을 추가하세요. iPad 분할 화면으로 문서와 설정 화면을 함께 볼 수 있지만, 화면 배치가 규칙 적용 여부를 결정하지는 않습니다. 연결 기록, 정책 선택, 대상 요청을 통해 트래픽 처리 결과를 확인하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 호환성 | App Store 상세 페이지에서 필요한 시스템 버전과 호환 기기를 확인한 뒤 안내에 따라 설치하세요. |
| 네트워크 권한 | 연결을 시작할 때 시스템 안내에 따라 VPN 구성을 허용하세요. 다른 네트워크 트래픽 처리 앱으로 전환할 때는 현재 어떤 연결이 적용 중인지 다시 확인하세요. |
| 설정 출처 | 클라이언트에서 지원하는 구독 형식을 사용하세요. 구독을 가져온 뒤에도 구성을 선택하고 정책 그룹의 출구를 확인해야 합니다. |
Linux 클라이언트
데스크톱 환경에서는 배포판의 패키지 관리 체계를 확인한 다음 프로세서 아키텍처를 확인하세요. 아래 GUI 클라이언트 파일은 AMD64 / x86_64용입니다. 서버와 라우터에 배포할 경우 아래 커널 항목을 확인하고, 데스크톱 설치 파일을 명령줄 서비스용 파일로 사용하지 않도록 주의하세요.
Clash Verge Rev
권장DEB와 RPM은 서로 다른 패키지 관리 체계용이며, 서로 바꿔 쓸 수 있는 압축 형식이 아닙니다. 설치할 때는 배포판의 패키지 관리자로 의존성을 처리하세요. 처음 실행한 뒤 데스크톱 시스템 프록시, 커널 실행, 서비스 권한을 각각 확인하세요.
FlClash
Linux · DEB이 섹션에서는 AMD64용 DEB 파일을 제공합니다. 해당 패키지 관리 체계를 사용하는 데스크톱 환경에 적합합니다. 창이 정상적으로 열려도 앱에서 프록시를 사용하지 않는다면 데스크톱 프록시 설정을 앱이 읽는지 먼저 확인하세요. 다른 트래픽까지 처리해야 한다면 TUN과 라우팅 설정을 검토하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 배포판 | DEB는 Debian 패키지 체계와 호환되는 배포판용이며, RPM은 RPM 패키지 체계와 호환되는 배포판용입니다. 시스템 라이브러리 버전도 클라이언트 요구 사항을 충족해야 합니다. |
| 아키텍처 및 데스크톱 | 이 섹션의 GUI 클라이언트는 AMD64 / x86_64용이며 지원되는 데스크톱 환경이 필요합니다. uname -m 명령으로 아키텍처를 확인할 수 있습니다. |
| 권한 및 라우팅 | TUN을 사용하려면 가상 네트워크 어댑터와 라우팅 권한이 필요합니다. 원격으로 관리하는 기기에서는 기본 경로를 변경한 뒤 연결이 끊기지 않도록 복구 경로를 먼저 확보하세요. |
명령줄 배포
Mihomo 커널 파일
서버, 라우터 또는 프로세스를 직접 관리하는 사용자를 위한 파일입니다. 일반 데스크톱과 모바일 사용자는 위의 GUI 클라이언트를 권장합니다. 커널 파일 자체에는 구독 관리 화면이 없습니다.
| 시스템 | 아키텍처 | 파일 형식 | 다운로드 |
|---|---|---|---|
| Windows | AMD64 | ZIP | AMD64 ZIP 다운로드 |
| Windows | ARM64 | ZIP | ARM64 ZIP 다운로드 |
| macOS | Intel · AMD64 | GZ | Intel GZ 다운로드 |
| macOS | Apple Silicon · ARM64 | GZ | ARM64 GZ 다운로드 |
| Linux | AMD64 | DEB | AMD64 DEB 다운로드 |
| Linux | AMD64 | GZ | AMD64 GZ 다운로드 |
| Linux | ARM64 | GZ | ARM64 GZ 다운로드 |
| Linux | ARMv7 | GZ | ARMv7 GZ 다운로드 |
| Linux | MIPS · softfloat | GZ | MIPS GZ 다운로드 |
커널 실행 및 설정 확인
ZIP과 GZ 파일은 먼저 압축을 풀어야 합니다. GZ는 압축된 커널 파일이지 GUI 설치 마법사가 아닙니다. Unix 계열 시스템에서는 실행 권한도 확인해야 합니다. 먼저 설정 검사 명령으로 YAML을 확인한 뒤 명시적인 설정 경로를 지정해 실행하세요. 사용 중인 바이너리를 바로 덮어쓰고 검증을 생략하지 마세요.
mihomo -t -f config.yaml
mihomo -f config.yaml위 명령은 커널이 명령 검색 경로에 있고 현재 디렉터리에 사용할 수 있는 config.yaml이 있다고 가정합니다. 설정 검사를 통과했다는 것은 문법 및 관련 로드 검사에 성공했다는 뜻일 뿐, 프록시 출구 연결을 보장하지 않습니다. DNS, 규칙 세트 로드, 실제 연결 기록을 계속 확인하세요. 배포 방법은 Mihomo 설정 안내서를 참고하세요.
설치 전 확인 및 첫 연결
다운로드 파일이 대상 기기에 맞는지 확인
운영체제, 프로세서 아키텍처, 패키지 형식을 차례로 확인하세요. Windows의 EXE, macOS의 DMG, Android의 APK, Linux의 DEB와 RPM은 각각 설치 절차가 다릅니다. 브라우저에서 다운로드가 끝난 것을 확인한 뒤 파일 관리자에서 실제 파일을 여세요. 파일에 임시 다운로드 표시가 남아 있다면 완료될 때까지 기다리세요. 확장자만 바꿔 설치를 시도하지 마세요.
아키텍처 표시는 파일이 대상으로 하는 실행 환경을 설명하며 성능 순위를 뜻하지 않습니다. AMD64와 x64는 일반적으로 64비트 x86을 가리키며, ARM64와 ARMv7은 서로 바꿔 쓸 수 없습니다. 호환 실행이 가능한 기기도 운영체제와 클라이언트 의존성의 제약을 받습니다. 특히 macOS에서는 버튼 옆에 실제 x64 파일이라고 표시된 다운로드를 네이티브 Apple Silicon 패키지로 오해하지 마세요.
설정을 보관한 뒤 기존 클라이언트 교체
업그레이드하거나 옮기기 전에 로컬 설정, 오버라이드 스크립트, 사용자 지정 규칙, 복원할 설정을 보관하세요. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷, 포럼 게시물, 공유 로그에 넣지 마세요. 새 클라이언트를 실행하기 전에 기존 클라이언트의 시스템 프록시와 네트워크 트래픽 처리를 끄면 포트 점유, 프록시 설정 잔류, 가상 네트워크 어댑터 충돌을 줄일 수 있습니다.
이름이 같은 클라이언트라도 배포 패키지에 따라 서명과 설정 디렉터리가 다를 수 있습니다. 설치 프로그램에서 충돌 알림이 표시되면 오류를 기록하고 기존 앱의 출처를 확인하세요. 설치 문제를 해결하려고 앱 데이터를 모두 삭제하지 마세요. 앱을 제거해야 한다면 백업을 복원할 수 있는지 확인하고, 구독 서비스에서 요구하는 가져오기 형식을 기록해 두세요.
설정을 가져온 뒤 트래픽 처리 결과 확인
클라이언트를 설치해도 프록시 서비스를 사용할 수 있게 되는 것은 아닙니다. 유효한 구독을 가져오거나 설정을 직접 작성하고, 현재 사용할 구성을 선택한 뒤 규칙 모드와 정책 그룹을 확인하세요. 일반적인 트래픽 분기에는 Rule을 사용합니다. Global은 아웃바운드 선택 방식을 바꾸는 기능으로, 구독 오류를 해결하거나 원래 사용할 수 없던 출구를 복구하는 방법이 아닙니다.
데스크톱에서는 먼저 시스템 프록시가 작동하는지 확인하고 필요에 따라 TUN을 활성화하세요. 모바일에서는 시스템 네트워크 권한을 설정해야 합니다. 연결한 뒤 대상 서비스를 열고 클라이언트 연결 기록을 확인하세요. 기록이 없다면 트래픽이 클라이언트에 전달됐는지 먼저 살펴보세요. 기록은 있지만 요청이 실패한다면 적용된 규칙, DNS 해석, 출구 연결 순으로 점검하세요. 자세한 방법은 구독 가져오기, 시스템 프록시 설정, 연결 확인을 참고하세요.
설치 및 선택
다운로드 관련 자주 묻는 질문
패키지 유형, 아키텍처, 설치 환경부터 확인하세요.
처음 설치할 때는 클라이언트와 Mihomo 커널 중 무엇을 선택해야 하나요?
데스크톱과 모바일 사용자는 GUI 클라이언트를 먼저 선택하세요. Windows, macOS, Android, iOS에는 Clash Plus를 권장하며, Linux에서는 Clash Verge Rev를 확인해 보세요. 커널 파일은 설정을 직접 작성하고 프로세스와 라우팅을 관리하는 서버·라우터 사용자에게 적합합니다.
ARM64, AMD64, 범용 패키지는 어떻게 다른가요?
AMD64와 x64는 일반적으로 같은 64비트 x86 아키텍처를 가리키며, ARM64는 다른 계열의 프로세서 아키텍처입니다. Android용 ARMv7 패키지는 호환되는 32비트 환경용이고, 범용 패키지에는 여러 아키텍처가 포함됩니다. 기기 브랜드만으로 판단하지 말고 시스템 정보와 패키지 안내를 확인하세요.
Apple Silicon 다운로드 버튼에서 x64 파일을 받을 수 있는 이유는 무엇인가요?
현재 목록에서 일부 클라이언트는 Apple Silicon과 Intel 다운로드 버튼이 동일한 x64 파일을 가리킵니다. 해당 버튼 옆에 실제 패키지 유형을 표시했습니다. 이 파일은 네이티브 ARM64 패키지가 아닙니다. Apple Silicon 사용자는 Rosetta 호환 여부를 확인하거나 ARM64 파일을 명시적으로 제공하는 클라이언트를 선택하세요.
설치했는데도 바로 프록시 연결을 사용할 수 없는 이유는 무엇인가요?
클라이언트 설치 파일에는 사용할 수 있는 프록시 서비스가 포함되어 있지 않습니다. 유효한 구독을 가져오거나 프록시 출구를 직접 설정하고, 구성을 선택한 뒤 정책 그룹을 지정하세요. 다음으로 시스템 프록시를 켜고 필요하면 TUN을 활성화합니다. 마지막으로 연결 기록에서 요청이 클라이언트에 전달됐는지, 적용된 규칙과 출구가 무엇인지 확인하세요.
설치에 실패하거나 클라이언트가 열리지 않을 때 무엇부터 확인해야 하나요?
먼저 운영체제, 프로세서 아키텍처, 설치 파일 형식을 확인한 다음 다운로드 완료 여부, 디스크 공간, 시스템 보안 알림을 살펴보세요. 설치를 반복해서 덮어쓰지 마세요. TUN이나 보조 서비스가 필요하다면 클라이언트 안내에 따라 관리자 권한을 부여하고 구체적인 오류 로그를 확인하세요.
클라이언트를 업그레이드하기 전에 어떤 설정을 보관해야 하나요?
구독 주소, 로컬 YAML 파일, 오버라이드 설정, 사용자 지정 규칙, 복원할 정책 그룹 선택을 보관하세요. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 안전한 곳에 저장해야 합니다. 업그레이드 후에는 설정 파싱, DNS, 프록시 트래픽 처리 상태를 확인한 뒤 자동 업데이트 등 평소 설정을 복원하세요.