클라이언트 / 설치 파일 / 아키텍처
운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 일상적인 설정과 연결에, 독립 mihomo 코어는 직접 배포할 때 사용합니다.
Windows / x64
현재 GUI 설치 파일은 대부분 x64입니다. “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인한 뒤 클라이언트를 선택하세요.
GUI에서 구독을 관리하고 프록시 모드를 선택하거나 연결 상태를 확인하려는 사용자에게 적합합니다. 다운로드한 설치 프로그램을 실행해 안내에 따라 설치한 뒤 기존 설정을 가져오세요. 프로그램 설치만으로 시스템 프록시가 활성화되는 것은 아니므로 클라이언트에서 실행 상태와 프록시 스위치를 확인해야 합니다.
처음에는 규칙 모드로 기본 연결을 확인한 뒤 필요에 따라 TUN을 활성화하세요. 다른 프록시 프로그램을 사용 중이라면 여러 클라이언트가 같은 시스템 설정을 동시에 변경하지 않도록 시스템 프록시를 관리하는 프로그램을 확인하세요.
여러 설정, 정책 그룹, 규칙을 관리하는 데스크톱 사용자에게 적합합니다. 설치 후 설정을 선택하고 로그에서 정상적으로 불러왔는지 확인한 다음 시스템 프록시를 켜세요. 설정 편집과 구독 업데이트는 별개의 작업이며, 구독을 업데이트하면 원격 설정 내용이 교체될 수 있습니다.
서비스 모드나 TUN을 사용할 때는 프로그램 안내에 따라 권한을 설정하세요. 서비스 시작에 실패하면 서비스 상태와 보안 소프트웨어 알림부터 확인하고, 설정의 네트워크 스위치를 모두 한꺼번에 켜지 마세요.
일반적인 데스크톱 사용에는 설치 버전이 적합하며, 프로그램 폴더를 직접 관리하려면 압축 파일을 선택하세요. 압축 파일은 먼저 완전히 푼 다음 실행해야 합니다. 압축 파일 미리보기 창에서 바로 실행하지 마세요. 프로그램 폴더와 설정 저장 위치가 다를 수도 있습니다.
업그레이드 전에 현재 정상적으로 작동하는 설정을 저장하고, 이전 프로세스를 종료한 다음 프로그램 파일을 교체하세요. 다른 클라이언트로 옮길 때는 비슷한 인터페이스 이름만 믿지 말고 정책 선택과 시스템 프록시 포트를 다시 확인하세요.
GUI에서 설정을 전환하고 실행 상태를 확인하려는 사용자를 위한 데스크톱 설정 관리 기능을 제공합니다. 설정을 가져온 뒤 클라이언트가 실제로 사용하는 코어를 확인하고, 해당 코어에서 지원하지 않는 필드나 프로토콜이 포함되어 있는지 점검하세요.
시스템 프록시는 해당 설정을 따르는 프로그램에만 영향을 줍니다. 일부 앱은 프록시를 별도로 설정해야 하고, 다른 트래픽은 TUN으로 처리해야 할 수 있습니다. 먼저 트래픽이 들어오는 경로를 파악한 뒤 처리 범위를 정하세요.
이전 설정 마이그레이션, 과거 인터페이스 확인, 기존 환경 재현을 위해 보관된 버전입니다. 보관 버전은 유지보수가 종료되었다는 뜻이며, 새 프로토콜이나 규칙 유형, 시스템 버전에 계속 대응한다는 의미는 아닙니다. 처음 설치한다면 위의 유지보수 중인 클라이언트를 우선 확인하세요.
마이그레이션 전에 로컬 설정을 내보내고 포트와 정책 그룹 선택을 기록한 다음 새 클라이언트에서 하나씩 확인하세요. 이전 프로그램의 데이터 폴더를 새 프로그램 폴더에 통째로 덮어쓰지 마세요. 인터페이스 상태와 설정 저장 형식이 다를 수 있습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 버전 | 지원이 계속 제공되는 Windows 10 / 11 사용을 권장합니다. 최소 버전은 선택한 클라이언트의 릴리스 노트를 확인하세요. |
| 프로세서 | 이 섹션의 설치 파일은 x64용입니다. Windows on ARM에서 호환 모드로 실행할 수 있다고 해서 ARM64 네이티브 지원을 의미하지는 않습니다. |
| 실행 권한 | 일반 설정 작업과 TUN 및 서비스 설치에 필요한 권한은 다릅니다. 후자의 경우 관리자 권한 승인이 필요할 수 있습니다. |
macOS / ARM64 · x64
“이 Mac에 관하여”에서 칩 종류를 확인하세요. Apple Silicon은 ARM64로 명확히 표시된 빌드를, Intel은 x64를 우선 선택하세요.
Apple Silicon과 Intel용 설치 파일을 각각 제공합니다. 디스크 이미지를 연 뒤 앱을 “응용 프로그램” 폴더로 옮기고 해당 폴더에서 실행하세요. 마운트된 이미지에서 계속 실행하지 않는 것이 좋습니다. 처음 실행할 때 필요한 권한은 시스템 안내에 따라 설정하세요.
설정을 가져온 뒤 현재 설정이 활성화되어 있는지 확인하고 시스템 프록시를 설정하세요. 더 폭넓게 트래픽을 처리해야 한다면 네트워크 확장, 보조 서비스 또는 TUN 권한에 대한 클라이언트 안내를 확인하세요.
구독 설정과 규칙, 데스크톱 프록시 상태를 관리하는 데 적합합니다. 현재 목록의 두 아키텍처 링크는 모두 x64 파일 하나로 연결되므로 두 번째 링크를 ARM 네이티브 패키지로 간주해서는 안 됩니다. Apple Silicon 기기에서는 Rosetta 호환 실행 조건을 확인하세요.
설치 후 보조 서비스가 정상적으로 실행되는지 확인하세요. 시스템 프록시를 켰는데도 브라우저가 직접 연결된다면 로컬 수신 포트와 시스템 프록시 포트가 일치하는지 확인한 뒤 연결 로그를 살펴보세요.
FlClash 설정 방식을 그대로 사용하려는 데스크톱 사용자에게 적합합니다. 현재 두 링크 모두 AMD64 파일로 연결됩니다. Apple Silicon 사용자는 호환 실행을 지원하는지 먼저 확인하세요. 네이티브 빌드가 필요하면 위의 ARM64 표시가 있는 설치 파일을 선택할 수 있습니다.
앱을 업그레이드하기 전에 실행 중인 이전 프로세스를 종료하고 “응용 프로그램” 폴더의 파일을 교체하세요. 구독 주소와 로컬 덮어쓰기 설정은 보존하고, 업그레이드 후 정책 그룹 선택을 다시 확인하세요. 설정 오류를 해결하려고 반복해서 재설치할 필요는 없습니다.
기존 환경을 참고하거나 설정을 마이그레이션할 때 사용하는 보관 링크입니다. 현재 두 아키텍처 링크는 동일한 x86_64 파일로 연결됩니다. Apple Silicon에서 사용하기 전에 호환성을 확인하세요. 지원이 종료된 버전은 새 시스템이나 새 프로토콜에 대응할 기본 선택으로 적합하지 않습니다.
다른 클라이언트로 옮길 때는 이전 프로그램의 시스템 프록시를 먼저 끈 다음 새 프로그램을 활성화하세요. 원본 YAML은 나중에 확인할 수 있도록 보관하되, 이전 설정을 모두 그대로 사용하지 말고 새 코어의 지원 여부에 따라 필드를 조정하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 버전 | 클라이언트마다 지원하는 최소 macOS 버전이 다릅니다. 설치 전에 해당 릴리스 노트와 시스템 안내를 확인하세요. |
| 칩 종류 | Apple M 시리즈는 ARM64, Intel은 x64입니다. 호환 실행 링크가 ARM 네이티브 빌드를 제공한다는 뜻은 아닙니다. |
| 설치 위치 | 앱을 “응용 프로그램” 폴더에 넣으세요. 네트워크 관련 권한은 시스템과 클라이언트 안내에 따라 설정하세요. |
Android / ARM64 · ARM
최근 출시된 스마트폰은 대부분 ARM64를 사용합니다. 처음 연결할 때 VPN 권한을 허용해야 하며, 백그라운드 안정성은 시스템의 배터리 절약 정책에도 영향을 받습니다.
휴대폰에서 구독 가져오기, 모드 선택, 연결 관리를 하려는 사용자에게 적합합니다. 이 링크는 ARM64 설치 파일입니다. 기기에서 설치할 수 없다는 안내가 표시되면 같은 파일을 반복해서 다운로드하지 말고 시스템 아키텍처와 버전을 먼저 확인하세요.
처음 연결할 때 Android에서 VPN 연결 권한을 요청합니다. 권한을 허용한 뒤 알림 표시줄과 클라이언트 상태를 확인하고 실제 접속도 테스트하세요. 백그라운드에서 계속 실행하려면 기기 설정에서 백그라운드 활동을 허용하고 배터리 최적화 설정을 확인하세요.
아키텍처에 맞춰 설치하고 Clash 설정과 프록시 상태를 관리하려는 Android 사용자에게 적합합니다. ARM64와 ARM 32비트는 서로 다른 빌드입니다. 기기 아키텍처를 모른다면 먼저 시스템 정보를 확인하고, 필요할 때 범용 버전을 고려하세요.
구독을 가져온 뒤 설정 다운로드가 완료될 때까지 기다린 다음 해당 설정을 선택하고 서비스를 시작하세요. VPN 권한은 시스템이 로컬 트래픽 처리 경로를 허용했다는 뜻일 뿐, 원격 프록시를 사용할 수 있다는 뜻은 아닙니다. 정책 그룹과 연결 로그도 확인해야 합니다.
ARM64, ARM 32비트, x86_64 설치 파일을 제공합니다. 일반 ARM 스마트폰은 시스템이 “64비트”라고 표시된다는 이유만으로 x86_64를 선택하면 안 됩니다. x86_64는 해당 아키텍처의 기기나 에뮬레이션 환경에 주로 사용됩니다.
다른 클라이언트로 전환하기 전에 기존 VPN 연결을 중지하세요. Android VPN 연결은 일반적으로 이러한 앱 두 개가 동시에 사용할 수 없습니다. 권한 요청이 반복되거나 연결이 교체된다면 다른 VPN 앱이 실행 중인지 확인하세요.
Clash YAML과 다른 설정 체계를 사용하므로 호환되는 구독을 보유했거나 해당 문법에 익숙한 사용자에게 적합합니다. 임의의 Clash 설정을 Surfboard 설정으로 바로 가져올 수는 없습니다. 구독 제공자가 출력하는 형식을 먼저 확인하세요.
설정을 변환할 때 규칙 유형, 정책 그룹, 프로토콜 지원 차이를 확인하세요. 가져오기에 성공해도 모든 필드가 동일하게 유지되는 것은 아닙니다. 처음 연결한 뒤 중요한 규칙과 앱의 접속 동작을 하나씩 검증하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 및 아키텍처 | 클라이언트가 지원하는 Android 버전을 확인하세요. arm64-v8a는 ARM64, armeabi-v7a는 ARM 32비트입니다. |
| 설치 권한 | 브라우저나 파일 관리자로 APK를 설치할 때는 시스템 안내에 따라 해당 출처의 앱 설치를 허용하세요. |
| 실행 권한 | 처음 연결할 때 VPN 권한이 필요합니다. 백그라운드에서 연결이 끊기면 배터리 최적화, 백그라운드 활동, 자동 시작 제한을 확인하세요. |
iOS / App Store
App Store에서 기기 호환성을 확인한 뒤 설치하세요. 시스템 버전 요구 사항은 스토어 상세 페이지에 표시되는 최신 정보를 따릅니다.
스토어 상세 페이지에서 설치를 시작하고, 설치가 끝나면 앱을 열어 사용 권한이 있는 구독이나 설정을 가져오세요. 처음 연결할 때 iOS 안내에 따라 VPN 설정 추가를 허용하고, 필요하면 기기 인증을 완료하세요.
연결 상태와 정책 선택은 각각 확인해야 합니다. 시스템에 VPN 연결됨으로 표시되면 트래픽 처리 경로가 설정된 것입니다. 실제로 원하는 방식으로 트래픽이 분기되는지는 현재 모드, 설정 규칙, 선택한 정책에 따라 달라집니다.
이후 앱 업데이트는 App Store에서 관리합니다. 기기를 바꾸기 전에 구독과 필요한 로컬 설정을 기록해 두세요. 다시 설치한 뒤 기본 연결부터 확인하고, 앱이나 도메인별 트래픽 분기 설정을 복원하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 호환성 | App Store 상세 페이지에서 현재 최소 시스템 요구 사항과 지원 기기를 확인하세요. |
| 설치 방법 | 스토어에서 설치 및 업데이트한 뒤 앱에서 설정을 가져오세요. |
| 연결 권한 | 처음 사용할 때 시스템 안내에 따라 VPN 설정을 추가한 뒤 현재 정책과 규칙 모드를 확인하세요. |
Linux / AMD64
데스크톱에서는 배포판에 맞는 DEB 또는 RPM을 선택하세요. GUI가 없는 서버는 아래의 독립 코어 섹션을 확인할 수 있습니다.
DEB는 일반적으로 Debian, Ubuntu 및 파생 배포판에서 사용합니다. RPM은 Fedora, openSUSE 등 해당 패키지 관리 체계를 사용하는 배포판에서 쓰입니다. 패키지 형식만 맞추면 되는 것은 아니며 데스크톱 런타임 라이브러리와 시스템 버전도 클라이언트 요구 사항을 충족해야 합니다.
설치 후 데스크톱 실행 항목으로 시작해 설정과 코어 상태를 확인하세요. 터미널 프로그램은 데스크톱 시스템 프록시 설정을 따르지 않을 수 있으므로, 각 도구가 지원하는 방식으로 프록시 환경 변수를 설정해야 합니다. TUN을 사용하려면 추가 라우팅과 권한 설정이 필요합니다.
이 섹션에서는 AMD64 데스크톱용 DEB 패키지를 제공합니다. 설치 전에 배포판이 해당 패키지 관리 체계를 사용하는지 확인하고, 시스템 패키지 관리자로 의존성을 처리하세요. ARM64 기기에서는 이 AMD64 설치 파일을 직접 사용할 수 없습니다.
부팅 시 실행하려면 데스크톱 로그인 후 자동 시작과 시스템 서비스를 구분해야 합니다. 자동 시작은 그래픽 세션에 의존하고, 시스템 서비스는 별도의 권한과 실행 디렉터리 설정이 필요합니다. 서버 환경에는 코어를 직접 배포하는 편이 일반적으로 더 적합합니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 | uname -m으로 아키텍처를 확인하세요. x86_64는 이 섹션의 AMD64 GUI 설치 파일에 해당합니다. |
| 배포판 | 패키지 관리 체계에 맞춰 DEB / RPM을 선택하세요. 구체적인 의존성과 최소 배포판 요구 사항은 클라이언트 안내를 확인하세요. |
| 실행 환경 | GUI 클라이언트에는 데스크톱 세션과 관련 런타임 라이브러리가 필요합니다. GUI가 없는 서버에서는 독립 코어를 우선 고려하세요. |
core / mihomo
서버, 라우터에서 서비스를 직접 관리하는 사용자를 위한 코어입니다. 일반 데스크톱 및 모바일 사용자는 위의 GUI 클라이언트를 우선 설치하세요.
코어는 설정을 읽고 규칙에 따라 트래픽을 처리하며 프록시 연결을 설정하지만, 완전한 데스크톱 설정 관리 기능은 포함하지 않습니다. 사용 전에 config.yaml, 실행 디렉터리, 시작 방법을 준비하세요. 부팅 시 자동 실행하려면 시스템 서비스도 설정해야 합니다. 압축 파일에서 추출한 실행 파일은 기기의 운영체제와 프로세서에 맞아야 합니다.
Linux 라우터에서는 펌웨어, 명령어 집합, 실행 환경도 확인해야 합니다. MIPS-softfloat는 해당 소프트웨어 부동소수점 대상에만 맞으며 모든 MIPS 기기에서 사용할 수 있는 범용 옵션이 아닙니다. TUN을 켜기 전에 라우팅 변경 범위를 파악하고, 원격 서버를 설정할 때는 기존 관리 연결을 유지하세요.
config.yaml 설정 항목 보기 →| 시스템 | 아키텍처 | 파일 형식 | 다운로드 |
|---|---|---|---|
| Windows | AMD64 / x64 | ZIP | AMD64 다운로드 |
| Windows | ARM64 | ZIP | ARM64 다운로드 |
| macOS | Intel / AMD64 | GZ | Intel 다운로드 |
| macOS | Apple Silicon / ARM64 | GZ | Apple Silicon 다운로드 |
| Linux | AMD64 | DEB | DEB 다운로드 |
| Linux | AMD64 | GZ | AMD64 다운로드 |
| Linux | ARM64 | GZ | ARM64 다운로드 |
| Linux | ARMv7 | GZ | ARMv7 다운로드 |
| Linux | MIPS-softfloat | GZ | MIPS 다운로드 |
다운로드한 파일은 프로그램을 설치하고, 설정과 시스템 권한은 트래픽이 프록시로 전달되는 방식을 결정합니다.
클라이언트를 바꾸거나 업그레이드하기 전에 현재 사용 중인 구독 주소, 로컬 YAML, 덮어쓰기 내용, 필요한 정책 그룹 설정을 저장하세요. 구독에는 접속 인증 정보가 포함될 수 있으므로 스크린샷이나 문의 내역에 공개하지 마세요. 새 클라이언트가 설정을 정상적으로 읽은 뒤 자주 사용하는 접속 환경을 확인하고 이전 환경을 비활성화하세요.
처음 사용할 때는 “설정 가져오기 → 설정 선택 → 규칙 모드와 정책 선택 → 프록시 켜기 → 로그 확인” 순서로 진행하면 됩니다. 프로그램을 설치해도 프록시 서비스가 자동으로 제공되는 것은 아닙니다. 기존 설정도 프로토콜, 규칙 유형, 필드 차이로 인해 다른 세대의 코어에서 바로 읽히지 않을 수 있습니다. 자세한 단계는 Clash 사용 가이드를 참고하세요.
시스템 프록시, Android 및 iOS의 VPN 권한, 데스크톱 TUN, 백그라운드 서비스는 각각 별개의 설정입니다. 최소한의 설정으로 연결을 확인한 뒤 트래픽 처리 범위를 단계적으로 넓히세요. 문제가 생기면 로그에 기록된 시간, 오류 유형, 당시 작업을 보존하세요. DNS, 라우팅, 프록시 모드를 동시에 바꾸면 원인을 찾기 어려워질 수 있습니다.
아키텍처, 호환성, 사용 환경에 따라 설치 파일을 선택하세요.
Windows, macOS, Android, iOS에서는 Clash Plus를, Linux에서는 Clash Verge Rev를 먼저 살펴보세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하면 됩니다. 기존 설정을 이어서 사용하려면 클라이언트가 사용하는 코어가 설정에 포함된 프로토콜과 필드를 지원하는지도 확인하세요.
ARM64와 x64는 서로 다른 프로세서 아키텍처입니다. AMD64는 일반적으로 x64를 가리킵니다. Android의 armeabi-v7a는 ARM 32비트 빌드이며, 범용 버전에는 여러 아키텍처용 구성 요소가 포함됩니다. 기기 브랜드만 보고 고르지 말고, 시스템 정보와 설치 파일의 실제 아키텍처를 확인하세요.
현재 목록에서 Clash Verge Rev와 FlClash의 macOS 아키텍처별 링크는 모두 x64 또는 amd64로 표시된 파일을 가리킵니다. ClashX Meta 링크도 x86_64 파일로 연결됩니다. 이 파일들이 ARM 네이티브 빌드라는 뜻은 아닙니다. Apple Silicon 사용자는 해당 클라이언트가 Rosetta 실행을 지원하는지 확인하거나 ARM64로 명시된 설치 파일을 선택하세요.
구버전은 계속 실행될 수 있지만, 이후 유지보수나 새로운 코어 기능이 제공되지는 않습니다. 이전 환경을 재현하거나 마이그레이션 전에 기존 설정을 확인할 때 주로 사용하세요. 새로 설치할 때는 유지보수 중인 클라이언트를 우선 선택하고, 마이그레이션 전에 설정을 내보낸 뒤 규칙, 정책 그룹, 구독 호환성을 다시 확인하세요.
설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 프록시 서비스는 제공되지 않습니다. 설치 후 사용 권한이 있는 구독이나 설정을 가져오고, 프록시 모드와 정책을 선택하세요. 플랫폼에 따라 시스템 프록시를 활성화하거나 VPN 권한을 허용해야 합니다. TUN으로 트래픽을 처리할 때는 추가 권한이 필요할 수 있습니다.
서버, 라우터, 컨테이너에서 서비스를 직접 관리하는 사용자는 독립 코어가 필요할 수 있습니다. 일반적인 데스크톱 및 모바일 사용자는 GUI 클라이언트를 설치하면 됩니다. 독립 코어를 사용하려면 설정 파일, 실행 디렉터리, 권한, 서비스 관리 방식을 직접 준비해야 하며, 클라이언트 인터페이스의 모든 기능을 대체하지는 않습니다.