SETUP GUIDE · 사용 튜토리얼 센터

전 플랫폼 설치
및 설정 튜토리얼

설치부터 구독 가져오기, TUN 모드 설정까지 Windows, macOS, Android, iOS, Linux에서 Clash 클라이언트를 시작하는 방법을 단계별로 안내합니다.

Windows macOS Android iOS Linux Core · Mihomo

Windows 설치 튜토리얼

Windows 10 / 11용 Clash 클라이언트 설치 및 설정 가이드입니다. 지속적으로 업데이트되며 TUN 전체 프록시와 구독 관리를 지원하는 Clash Verge Rev 또는 FlClash 사용을 추천합니다.

Clash Verge Rev — Windows 설치 튜토리얼
Rust + Tauri 기반으로 제작되었으며 Clash.Meta 커널을 내장하고 있습니다. Windows 플랫폼에서 가장 활발하게 업데이트되는 그래픽 클라이언트이자 원조 Clash for Windows의 최고의 대안입니다.
Clash Verge Rev 다운로드 바로가기
1
설치 파일 다운로드

다운로드 페이지에서 Clash Verge Rev를 찾고 PC 아키텍처에 맞는 버전을 선택하세요:

· x64 (권장): Intel / AMD 프로세서를 사용하는 대부분의 Windows PC
· ARM64: 퀄컴 스냅드래곤 프로세서를 탑재한 Copilot+ PC (예: Surface Pro X)

버전이 확실하지 않나요? Windows 설정 → 시스템 → 상세 정보에서 '시스템 종류'를 확인하세요. 'x64 기반 프로세서'라고 되어 있으면 x64 버전을 선택합니다.
2
설치 프로그램 실행

다운로드한 .exe 설치 파일을 더블 클릭하고 안내에 따라 '다음'을 눌러 설치를 완료하세요. 설치가 끝나면 프로그램이 자동 실행되며 시스템 트레이(우측 하단)에 아이콘이 나타납니다.

Windows Defender나 백신 소프트웨어에서 설치를 차단하는 경우 이는 오탐(False Positive)입니다. Clash Verge Rev는 오픈 소스 소프트웨어이며 GitHub에서 모든 소스 코드를 확인할 수 있습니다. 경고 창에서 '실행'을 클릭하여 설치를 계속 진행하세요.
3
구독 링크 가져오기

Clash Verge Rev 실행 후 구독 설정을 진행하세요:

1. 왼쪽 메뉴에서 '설정(Profiles)'을 클릭합니다.
2. 상단 입력창에 Clash 구독 링크를 붙여넣습니다.
3. '다운로드(Import)' 버튼을 클릭하고 설정 파일 분석이 완료될 때까지 기다립니다.
4. 새로 생성된 프로필 카드를 클릭하여 활성화 상태로 만듭니다(카드 테두리가 파란색으로 변함).

구독 링크는 이용 중인 프록시 서비스 제공업체에서 제공하며, 보통 서비스 홈페이지의 '구독' 또는 '대시보드' 페이지에서 확인할 수 있습니다. Clash 자체적으로는 노드 서비스를 제공하지 않습니다.
4
노드 선택 및 프록시 활성화

1. 왼쪽 메뉴에서 '프록시(Proxies)'를 클릭하여 사용 가능한 노드를 확인합니다.
2. 전략 그룹 내에서 노드를 선택하거나 'Global' 모드에서 개별 노드를 직접 선택합니다.
3. 홈 화면으로 돌아와 '시스템 프록시(System Proxy)' 스위치를 켭니다.

'프록시' 페이지에서 노드 우측의 '지연 시간 테스트' 아이콘을 클릭하여 가장 속도가 빠른(지연 시간이 낮은) 노드를 선택하세요.
5
(선택 사항) TUN 모드 켜기 — 전체 트래픽 프록시

시스템 프록시는 브라우저처럼 프록시 설정을 지원하는 앱만 제어할 수 있습니다. 명령줄 도구나 게임 등 모든 프로그램에 프록시를 적용하려면 TUN 모드를 활성화하세요:

1. 왼쪽 메뉴에서 '설정(Settings)'을 클릭합니다.
2. 'TUN 모드' 옵션을 찾아 활성화합니다.
3. 시스템 UAC 권한 요청이 뜨면 '예'를 클릭해 승인합니다(TUN은 가상 네트워크 카드 생성을 위해 관리자 권한이 필요합니다).

TUN 모드를 켜면 모든 네트워크 트래픽이 Clash를 거치게 됩니다. 국내 직접 연결 트래픽이 프록시 노드로 잘못 전달되지 않도록 구독 규칙 설정을 다시 한번 확인하세요.
FlClash — Windows 설치 튜토리얼
Flutter 기반의 크로스 플랫폼 Clash 클라이언트로 Material You 디자인이 특징입니다. 여러 기기(Windows / macOS / Android / Linux)를 동시에 사용하는 분들에게 적합합니다.
FlClash 다운로드 바로가기
1
FlClash 다운로드 및 설치

다운로드 페이지에서 FlClash Windows x64 버전(.exe 파일)을 받아 실행한 뒤 안내에 따라 설치하세요. 완료 후 바탕화면의 FlClash 바로가기를 더블 클릭해 실행합니다.

2
구독 설정 파일 추가

1. FlClash를 실행하고 왼쪽 하단의 '설정(Profiles)' 탭이나 '+' 아이콘을 클릭합니다.
2. 'URL에서 가져오기'를 선택합니다.
3. 구독 링크를 붙여넣고 '확인'을 클릭한 뒤 다운로드가 완료될 때까지 기다립니다.
4. 해당 프로필을 클릭하여 활성화합니다.

3
노드 선택 및 프록시 시작

'프록시(Proxies)' 페이지로 이동하여 전략 그룹 내 노드를 선택한 뒤, 우측 상단이나 상단의 '활성화' 스위치를 켜면 FlClash가 자동으로 Windows 시스템 프록시를 설정합니다.

FlClash는 '앱 분산' 기능을 지원하여 특정 앱만 프록시를 거치거나 직접 연결되도록 유연하게 설정할 수 있습니다.
Clash Nyanpasu — Windows 설치 튜토리얼
다중 커널 전환(Clash Premium / Clash.Meta / Clash.rs) 및 JavaScript/Lua 스크립트 확장 기능을 지원하여 고급 사용자와 개발자에게 적합합니다.
Clash Nyanpasu 다운로드 바로가기
1
다운로드 및 설치

Clash Nyanpasu Windows x64 설치 파일을 다운로드하여 .exe를 실행하고 안내에 따라 설치하세요. 처음 실행 시 필요한 커널 파일을 자동으로 다운로드합니다(인터넷 연결 필요).

2
커널 선택 (선택 사항)

'설정 → 커널(Kernel)'에서 다음 중 하나로 전환할 수 있습니다:
· Clash.Meta (권장): 최신 기능 및 가장 폭넓은 프로토콜 지원
· Clash Premium: 안정적인 호환성
· Clash.rs: Rust 기반의 고성능 버전

3
구독 가져오기 및 프록시 켜기

'설정(Profiles)' 페이지에 구독 링크를 붙여넣어 가져온 뒤, 프로필을 활성화하고 홈 화면에서 시스템 프록시 스위치를 켜세요.

Clash for Windows — 사용 튜토리얼 (히스토리 버전)
원작자가 2023년에 프로젝트를 중단하여 더 이상 업데이트나 보안 패치가 없습니다. 아래는 기존 사용자를 위한 기본 가이드이며, 가급적 Clash Verge Rev나 FlClash로 전환하시길 강력히 권장합니다.
주의: Clash for Windows는 유지보수가 중단되었으며 보안 패치가 제공되지 않습니다. 신규 사용자는 Clash Verge Rev 또는 FlClash를 사용하시기 바랍니다.
1
설치 및 실행

다운로드한 Setup.exe를 실행해 설치하세요. 실행 후 프로그램은 시스템 트레이에 나타납니다.

2
구독 가져오기

트레이 아이콘을 클릭해 화면을 열고 'Profiles' 탭으로 이동합니다. URL 입력창에 구독 링크를 붙여넣고 Enter를 눌러 다운로드하세요. 성공 후 프로필 이름을 클릭해 활성화합니다.

3
시스템 프록시 켜기

'General' 탭에서 'System Proxy' 스위치를 켭니다. 또한 'Proxies' 페이지에서 'Rule' 모드로 전환하면 규칙에 따라 국내외 트래픽이 자동 분류됩니다.

macOS 설치 튜토리얼

macOS용 Clash 클라이언트 설치 및 설정 가이드입니다. Apple Silicon(M 시리즈 칩)과 Intel 아키텍처를 모두 지원합니다.

Clash Verge Rev — macOS 설치 튜토리얼
Apple Silicon(M1/M2/M3/M4)과 Intel용 네이티브 버전을 모두 지원하는 macOS 최고의 올인원 Clash 클라이언트입니다.
Clash Verge Rev 다운로드 바로가기
1
아키텍처에 맞는 버전 다운로드

· 애플 실리콘 (권장): M1, M2, M3, M4 칩을 탑재한 2020년 이후 출시된 Mac
· Intel x64: 2019년 이전 출시된 Intel 프로세서 탑재 Mac

좌측 상단 Apple 메뉴 → 이 Mac 관하여를 클릭해 '칩' 항목을 확인하세요. 'Apple M1 / M2 / M3 / M4'라면 Apple Silicon 버전을, 'Intel Core'라면 Intel x64 버전을 선택합니다.
2
.dmg 파일 마운트 및 설치

다운로드한 .dmg 파일을 더블 클릭하고 팝업창에서 Clash Verge Rev 아이콘을 Applications(응용 프로그램) 폴더로 드래그합니다. 완료 후 디스크 이미지를 추출하고 런치패드나 /Applications 폴더에서 앱을 찾아 실행하세요.

3
macOS Gatekeeper 보안 차단 해제

처음 실행 시 '확인되지 않은 개발자' 메시지가 뜰 수 있습니다. 해결 방법:

· 방법 1: 앱 아이콘 우클릭 → '열기' 선택 → 팝업창에서 다시 '열기' 클릭
· 방법 2: 시스템 설정 → 개인정보 보호 및 보안 → 보안 섹션에서 차단된 앱 확인 후 '확인 없이 열기' 클릭

이 작업은 한 번만 수행하면 되며 이후에는 더블 클릭으로 바로 실행 가능합니다. Clash Verge Rev는 GitHub에 소스가 공개된 오픈 소스 소프트웨어입니다.
4
구독 링크 가져오기

1. 왼쪽 메뉴에서 '설정(Profiles)'을 클릭합니다.
2. 상단 URL 입력창에 구독 링크를 붙여넣고 '다운로드'를 클릭합니다.
3. 가져온 프로필 카드를 클릭하여 활성화합니다.

5
시스템 프록시 켜기

홈 화면에서 '시스템 프록시(System Proxy)' 스위치를 켜면 Clash Verge Rev가 macOS 네트워크 프록시 설정을 자동 구성합니다. 처음 실행 시 권한 승인 요청이 뜨면 '확인'을 클릭하세요.

6
(선택 사항) TUN 강화 모드 켜기

'설정 → TUN 모드'에서 활성화하세요. 보조 프로그램(Helper) 설치 요청이 뜨면 시스템 암호를 입력해 승인합니다. TUN 모드는 터미널 도구를 포함한 모든 앱의 트래픽을 완벽하게 제어합니다.

FlClash — macOS 설치 튜토리얼
통합된 사용 경험을 제공하며 Apple Silicon 및 Intel 네이티브 설치 파일을 모두 지원하여 여러 운영체제를 오가는 사용자에게 최적입니다.
FlClash 다운로드 바로가기
1
다운로드 및 설치

Mac의 칩 종류에 맞춰 애플 실리콘 또는 Intel 버전의 .dmg를 선택해 다운로드하고 응용 프로그램 폴더로 드래그하여 설치하세요.

2
첫 실행 (Gatekeeper)

Clash Verge Rev와 마찬가지로 앱 우클릭 → '열기'를 선택하여 보안 차단을 우회하세요.

3
구독 추가 및 프록시 활성화

'설정(Profiles)' 페이지에서 구독 URL을 가져오세요. 활성화 후 메인 화면의 '활성화' 스위치를 켜면 FlClash가 자동으로 시스템 프록시를 설정합니다.

ClashX Meta — macOS 설치 튜토리얼
네이티브 macOS 메뉴바 클라이언트로 범용(Universal) 패키지를 제공합니다. 가볍고 리소스 소모가 적어 사용이 매우 간편합니다.
ClashX Meta 다운로드 바로가기
1
DMG 마운트 후 응용 프로그램 폴더로 이동

ClashX_Meta_arm64.dmg 파일을 다운로드해 더블클릭으로 마운트한 후 ClashX Meta.app을 /Applications 폴더로 옮기세요. 완료 후 디스크 이미지를 꺼내세요.

2
첫 실행 및 권한 승인

앱 우클릭 → '열기'로 ClashX Meta를 실행하세요. 처음 실행 시 보조 도구(Helper Tool) 설치 요청이 뜨면 시스템 암호를 입력해 네트워크 설정 수정 권한을 승인합니다.

3
구독 링크 가져오기

macOS 상단 메뉴바의 ClashX Meta 아이콘(고양이 모양)을 클릭하고 'Config → Remote Config → Manage'를 선택합니다. 팝업창에서 'Add'를 클릭해 구독 링크를 붙여넣고 'OK'를 눌러 설정을 다운로드 및 활성화합니다.

4
시스템 프록시 켜기

메뉴바 아이콘을 클릭하고 'Set as System Proxy(시스템 프록시로 설정)'를 활성화하세요. 'Proxy Mode'에서 'Rule(규칙)'을 선택하면 지능형 분산이 적용됩니다.

Android 설치 튜토리얼

Google Play 없이 APK를 직접 설치합니다. 설치 전 시스템 설정에서 '출처를 알 수 없는 앱 설치 허용'을 활성화해야 합니다.

FlClash — Android 설치 튜토리얼
Material You 디자인의 직관적인 인터페이스, 앱 단위 트래픽 분산, 저전력 백그라운드 구동을 지원하는 안드로이드 입문자용 최적의 클라이언트입니다.
FlClash APK 다운로드 바로가기
1
올바른 APK 버전 선택

· arm64 (권장): 2016년 이후 출시된 대부분의 안드로이드 폰
· armeabi-v7a: 2016년 이전 출시된 구형 기기

아키텍처를 잘 모르시겠나요? 그냥 arm64 버전을 다운로드하세요. 현재 시판되는 최신 안드로이드 폰의 99%가 arm64를 지원합니다.
2
'출처를 알 수 없는 앱 설치 허용' 활성화

APK 파일이 Google Play가 아닌 외부 파일이므로 수동으로 설치 권한을 승인해야 합니다.

· 안드로이드 8 이상: 설정 → 앱 → 특별한 앱 액세스 → 알 수 없는 앱 설치 → '파일 관리자' 또는 '브라우저'를 찾아 권한 활성화
· 삼성 / LG / 샤오미 등: 설치 시 시스템에서 자동으로 권한 요청 팝업이 뜨면 안내에 따라 허용하세요.

3
APK 설치

파일 관리자에서 다운로드한 APK 파일을 찾아 탭하여 설치하세요. 설치가 완료되면 앱 목록에서 FlClash를 찾아 실행합니다.

4
구독 설정 가져오기

FlClash 실행 후:
1. 하단 '설정' 탭 터치
2. 우측 상단 '+' 터치 → 'URL에서 가져오기' 선택
3. Clash 구독 링크 붙여넣고 '확인' 터치
4. 다운로드 완료 후 해당 프로필을 터치해 활성화

'QR 코드 스캔'을 통해 구독을 가져올 수도 있습니다. 서비스 제공업체에서 구독 QR 코드를 제공하는 경우, 링크를 직접 입력할 필요 없이 스캔만으로 즉시 인포트가 가능합니다.
5
VPN 활성화 및 노드 선택

1. '프록시' 페이지에서 노드 선택
2. 홈 화면의 '시작' 버튼 터치
3. 시스템의 VPN 연결 요청 팝업에서 '확인' 승인
4. 상태 표시줄에 VPN 아이콘이 나타나면 프록시 적용 완료

Clash Meta for Android — 설치 튜토리얼
MetaCubeX에서 공식 제작한 버전으로, 전체 Clash.Meta 커널을 내장하여 Hysteria2, TUIC 등 최신 프로토콜을 지원하므로 고급 기능이 필요한 사용자에게 적합합니다.
APK 다운로드 바로가기
1
APK 버전 선택

· arm64-v8a: 최신 안드로이드 폰 대부분 (권장)
· armeabi-v7a: 32비트 구형 기기
· Universal (범용): 모든 아키텍처 대응 (파일 용량 큼)

2
APK 설치 (외부 출처 권한 필요)

FlClash 2단계와 마찬가지로 시스템 설정에서 '알 수 없는 앱 설치' 권한을 승인한 뒤 APK를 설치하세요.

3
설정 가져오기 및 실행

Clash Meta 실행 후 '설정' → '새 설정 → URL 가져오기'를 클릭해 구독 링크를 붙여넣어 다운로드하세요. 프로필 활성화 후 홈 화면에서 '시작'을 누르고 VPN 연결을 승인하면 됩니다.

Surfboard — Android 설치 튜토리얼
Clash 구독 형식과 호환되며 트래픽 패킷 분석 및 HTTP 스니핑 디버깅 기능을 내장하여 개발자와 고급 사용자에게 적합합니다.
Surfboard APK 다운로드 바로가기
1
범용 버전 APK 다운로드 및 설치

범용(Universal) APK를 다운로드하고 외부 출처 설치 권한 승인 후 설치하세요.

2
Clash 구독 가져오기

Surfboard 실행 후 '설정(Profiles)' → '+' → 'URL에서 다운로드'로 이동해 구독 링크를 붙여넣으세요. Surfboard는 변환 없이 Clash YAML 형식을 완벽하게 지원합니다.

3
연결 및 패킷 분석 기능 사용

VPN 연결 후 '요청(Requests)' 탭에서 모든 HTTP/HTTPS 트래픽을 실시간으로 확인할 수 있어 디버깅과 연결 문제 해결에 유용합니다.

iOS 사용 튜토리얼

iPhone / iPad 사용자는 App Store를 통해 Clash 설정 형식과 호환되는 프록시 클라이언트를 설치해야 합니다. 아래 앱들은 Clash 구독 링크를 완벽히 지원합니다.

iOS는 왜 APK 직접 다운로드가 불가능한가요?

Apple iOS 보안 정책상 iPhone / iPad는 App Store 이외의 경로로 앱을 설치할 수 없습니다. iOS 사용자는 한국 이외 지역의 Apple ID 계정으로 App Store에 로그인하여 아래의 호환 클라이언트를 구매 및 다운로드해야 합니다. 해당 앱들은 표준 Clash 구독 링크 및 YAML 규칙 세트 가져오기를 추가 설정 없이 지원합니다.

Stash
  1. 해외 Apple ID를 사용하여 App Store에서 Stash 구매 및 다운로드
  2. Stash 실행 후 '설정(Profiles)'으로 이동
  3. '+' 클릭 → 'URL 다운로드' 선택 후 Clash 구독 링크 붙여넣기
  4. 설정 다운로드 완료 후 클릭하여 활성화
  5. 홈 화면으로 돌아와 '활성화' 클릭, iOS 시스템의 VPN 승인 요청 시 '허용' 선택
  6. App Store에서 Shadowrocket 다운로드
Stash는 iOS 플랫폼에서 기능이 가장 완벽한 Clash 호환 클라이언트로, HTTP 트래픽 스니핑 및 패킷 분석 디버깅을 지원하여 고성능을 원하는 사용자에게 추천합니다.
App Store에서 다운로드
Shadowrocket
  1. 해외 Apple ID를 사용하여 App Store에서 Shadowrocket 구매 및 다운로드
  2. Shadowrocket 실행 후 우측 상단 '+' 아이콘 터치
  3. '유형(Type) → Subscribe(구독)' 선택
  4. URL 칸에 Clash 구독 링크를 붙여넣고 '완료(Done)' 터치
  5. 구독 노드가 자동으로 분석되어 인포트됨
  6. App Store에서 Quantumult X 다운로드
Shadowrocket은 한 번의 구매로 평생 이용 가능하며 저렴하고 사용이 간편하여 iOS 사용자에게 가장 인기 있는 선택지 중 하나입니다.
App Store에서 다운로드
Quantumult X
  1. 해외 Apple ID를 사용하여 App Store에서 Quantumult X 구매 및 다운로드
  2. Quantumult X 실행 후 우측 하단 '⚙️ 설정(Settings)' 터치
  3. '서버(Server)' 섹션에서 '구독' 선택
  4. Clash 구독 링크를 붙여넣어 노드 가져오기
  5. '정책(Policy)'을 터치하여 분산 규칙 설정
  6. 홈 화면으로 돌아와 아이콘을 클릭해 VPN 활성화 (승인 후 적용)
Quantumult X는 스크립트 확장과 정교한 분산 기능을 지원하여 iOS 플랫폼 최고의 고급 프록시 클라이언트로 꼽히며, 기술적 커스터마이징을 원하는 사용자에게 적합합니다.
App Store에서 다운로드

Linux 설치 튜토리얼

Ubuntu, Debian, Fedora, CentOS 등 주요 Linux 배포판에 적용 가능하며 .deb와 .rpm 두 가지 패키지 형식을 제공합니다.

Clash Verge Rev — Linux 설치 튜토리얼
Debian/Ubuntu (.deb) 및 Fedora/CentOS (.rpm) 형식을 모두 제공하며 amd64 및 arm64 아키텍처를 지원합니다. 기능은 Windows/macOS 버전과 동일합니다.
Linux 설치 파일 다운로드 바로가기
1
사용 중인 배포판에 맞는 설치 파일 선택

· Ubuntu / Debian / Linux Mint: .deb 패키지 다운로드 (amd64 또는 arm64)
· Fedora / CentOS / RHEL / openSUSE: .rpm 패키지 다운로드 (x86_64)

2
패키지 설치

터미널을 열고 패키지 관리자를 사용하여 설치하세요.

# Debian / Ubuntu — install .deb
sudo dpkg -i clash-verge-rev_linux_amd64.deb

# Fedora / CentOS / RHEL — install .rpm
sudo rpm -i clash-verge-rev_linux_x86_64.rpm
명령줄 대신 .deb/.rpm 파일을 더블 클릭하여 시스템 기본 소프트웨어 설치 프로그램으로 그래픽 기반 설치도 가능합니다.
3
Clash Verge Rev 실행

설치 완료 후 앱 메뉴(GNOME, KDE 등)에서 Clash Verge Rev를 찾아 실행하세요. 터미널에서 다음 명령으로도 실행 가능합니다.

clash-verge
4
구독 가져오기 및 프록시 설정

과정은 Windows 버전과 동일합니다: '설정(Profiles)' 이동 → 구독 링크 붙여넣어 다운로드 → 프로필 활성화 → 시스템 프록시 켜기.

5
(선택 사항) TUN 모드 켜기

'설정 → TUN 모드'에서 활성화하세요. Linux에서는 권한 승인 또는 root 권한으로 보조 프로세스 실행이 필요할 수 있습니다. 일부 배포판은 iproute2 의존성이 필요합니다.

# Ubuntu / Debian
sudo apt install iproute2
FlClash — Linux 설치 튜토리얼
amd64 아키텍처용 Debian/Ubuntu .deb 설치 파일을 제공하며, Windows/macOS/Android 버전과 인터페이스가 동일하여 멀티 플랫폼 전환이 매우 편리합니다.
FlClash Linux 다운로드 바로가기
1
.deb 패키지 설치
sudo dpkg -i FlClash-0.8.93-linux-amd64.deb
2
실행 및 구독 가져오기

앱 메뉴에서 FlClash를 실행하세요. 단계는 Windows/macOS 버전과 같습니다. '설정'에서 구독 URL을 가져오고 활성화 후 프록시를 켜면 됩니다.

핵심 엔진 Mihomo 배포 가이드

Linux 서버, Docker, 소프트 루터(OpenWrt) 및 GUI가 없는 환경을 위한 Mihomo(구 Clash.Meta) 코어 명령줄 배포 가이드입니다. 일반 PC 사용자는 그래픽 클라이언트를 사용하면 되므로 이 섹션은 건너뛰어도 됩니다.

1
Mihomo 바이너리 다운로드

다운로드 페이지에서 서버 아키텍처에 맞는 버전을 선택하세요:
· amd64: x86_64 아키텍처 (대부분의 VPS / 클라우드 서버)
· arm64: ARM64 아키텍처 (라즈베리 파이 4/5, 일부 ARM VPS)
· armv7: ARMv7 구형 기기
· mips-softfloat: 일부 MIPS 아키텍처 루터

# Example: download for Linux amd64
wget -O mihomo.gz https://clashsky.com/assets/clients/core/mihomo-linux-amd64.gz
2
압축 해제 및 실행 권한 부여
# Extract the binary
gunzip mihomo.gz

# Grant execute permission
chmod +x mihomo

# Move to system path (optional)
sudo mv mihomo /usr/local/bin/mihomo
3
설정 디렉토리 및 config.yaml 생성
# Create config directory
mkdir -p ~/.config/mihomo

# Create a minimal config.yaml
cat > ~/.config/mihomo/config.yaml << 'EOF'
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

# Add your proxy-providers or proxies below
proxy-providers:
  my-sub:
    type: http
    url: "https://your-subscription-url"
    interval: 86400
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300
EOF
https://your-subscription-url 부분을 실제 Clash 구독 링크로 교체하세요.
4
Mihomo 실행
# Start with default config directory
mihomo -d ~/.config/mihomo

실행 성공 후 Mihomo는 7890 포트(HTTP/SOCKS5 혼합 프록시)에서 대기합니다. 웹 관리 화면은 http://127.0.0.1:9090/ui 로 접속 가능합니다(대시보드 설치 필요).

5
(선택 사항) systemd 자동 실행 설정
# Create systemd service file
sudo cat > /etc/systemd/system/mihomo.service << 'EOF'
[Unit]
Description=Mihomo Proxy Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /root/.config/mihomo
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# Enable and start the service
sudo systemctl daemon-reload
sudo systemctl enable mihomo
sudo systemctl start mihomo

# Check service status
sudo systemctl status mihomo
1
설정 파일 준비

로컬에 설정 디렉토리를 만들고 config.yaml 파일을 넣으세요. (내용은 Linux 서버 섹션 3단계 참조)

mkdir -p ~/mihomo/config
2
Docker로 Mihomo 실행
docker run -d \
  --name mihomo \
  --network host \
  --restart unless-stopped \
  -v ~/mihomo/config:/root/.config/mihomo \
  metacubex/mihomo:latest \
  -d /root/.config/mihomo
TUN 모드와 투명 프록시 설정을 위해 --network host 옵션을 사용하여 컨테이너가 호스트 네트워크를 직접 쓰도록 합니다.
3
실행 상태 확인
# View container logs
docker logs mihomo

# Check running status
docker ps | grep mihomo
1
루터 CPU 아키텍처 확인

SSH로 OpenWrt에 접속하여 아키텍처 정보를 확인하세요.

uname -m
# mipsel / mips / arm / aarch64 / x86_64

· mipsel / mips: mips-softfloat 버전 다운로드
· arm / armv7: armv7 버전 다운로드
· aarch64: arm64 버전 다운로드
· x86_64: amd64 버전 다운로드

2
Mihomo 업로드 및 배포
# Upload binary to router via scp
scp mihomo-linux-mips-softfloat.gz [email protected]:/tmp/

# SSH into router, extract and install
ssh [email protected]
gunzip /tmp/mihomo-linux-mips-softfloat.gz
chmod +x /tmp/mihomo-linux-mips-softfloat
mv /tmp/mihomo-linux-mips-softfloat /usr/bin/mihomo
3
설정 및 실행

루터에서 /etc/mihomo/config.yaml 파일을 생성하고 구독 proxy-provider 설정을 입력(Linux 서버 섹션 참조)한 뒤 실행하세요:

mihomo -d /etc/mihomo &
OpenWrt의 /etc/init.d/ 메커니즘을 사용해 자동 실행 스크립트를 만들거나, OpenClash 같은 통합 솔루션을 이용해 설정을 간소화하는 것이 좋습니다.
GitHub · MetaCubeX/mihomo — 전체 문서 보기
FAQ.
Clash 설정 및 사용 자주 묻는 질문(FAQ)
Clash 구독 링크는 어디서 구하나요? +
구독 링크는 이용 중인 유료 또는 무료 프록시 서비스 업체에서 제공합니다. 보통 업체 홈페이지의 '내 구독', '대시보드' 또는 '원클릭 가져오기' 페이지에서 Clash 형식의 구독 링크를 찾을 수 있습니다. Clash 클라이언트는 도구일 뿐 노드 서비스를 자체 제공하지 않으므로 사용자가 직접 프록시 서비스를 준비해야 합니다.
TUN 모드와 시스템 프록시의 차이는 무엇이며, 언제 TUN을 켜야 하나요? +
시스템 프록시는 HTTP/SOCKS5 프로토콜로 작동하며 브라우저처럼 프록시 설정을 지원하는 앱만 제어합니다. 반면 TUN 모드는 운영체제 네트워크 계층에 가상 네트워크 카드를 생성하여 프록시 설정을 지원하지 않는 게임 클라이언트, 명령줄 도구 등 모든 앱의 TCP/UDP 트래픽을 가로챌 수 있습니다. curl, npm, pip 같은 터미널 도구나 게임에 프록시를 적용하려면 TUN 모드를 켜는 것이 가장 쉽습니다.
구독을 가져왔는데 노드에 '타임아웃'이 뜨거나 연결이 안 되면 어떡하죠? +
다음 단계를 확인해 보세요: 1) 클라이언트 '프록시' 페이지의 '지연 시간 테스트'로 정상인 노드를 찾으세요. 2) 로컬 인터넷 연결을 확인하고 Wi-Fi/유선 랜을 전환해 보세요. 3) 모든 노드에 타임아웃이 뜬다면 구독 기간이 만료되었을 수 있으니 서비스 업체 대시보드에서 계정 상태를 확인하세요. 4) 특정 노드 자체가 불안정할 수 있으니 다른 노드로 바꿔보세요.
Clash의 규칙 모드(Rule), 글로벌 모드(Global), 직접 연결 모드(Direct)의 차이는 무엇인가요? +
트래픽 처리 정책의 차이입니다. 규칙 모드(Rule, 권장)는 설정 파일의 분산 규칙에 따라 해외 사이트는 프록시, 국내 사이트는 직접 연결하도록 처리하며 가장 많이 쓰입니다. 글로벌 모드(Global)는 모든 트래픽을 프록시로 통과시키며 일시적으로 전체 프록시가 필요할 때 씁니다. 직접 연결 모드(Direct)는 프록시 없이 모든 트래픽을 직접 연결하며 프록시 기능을 끄는 것과 같습니다.
구독 설정을 자동으로 업데이트하려면 어떻게 하나요? +
Clash Verge Rev, FlClash 등 그래픽 클라이언트는 구독 자동 업데이트를 지원합니다. '설정(Profiles)' 페이지에서 구독 설정 파일을 우클릭하고 'Settings'를 선택하면 자동 업데이트 주기(예: 24시간마다 또는 실행 시마다)를 구성할 수 있습니다. 이를 통해 수동 작업 없이 노드 정보를 항상 최신으로 유지할 수 있습니다.
Clash가 게임 지연 시간(렉)에 영향을 주나요? 게임 직접 연결은 어떻게 설정하나요? +
규칙(Rule) 모드에서 게임 서버(특히 국내 게임)는 보통 '직접 연결(DIRECT)' 규칙에 일치하여 프록시를 거치지 않으므로 추가 지연이 발생하지 않습니다. 만약 게임이 프록시를 거쳐 지연 시간이 높아진다면, 설정 파일의 rules 섹션에 게임 도메인이나 IP 대역을 DIRECT로 추가하거나 클라이언트의 'Rules' 페이지에서 수동으로 직접 연결 규칙을 추가하세요.
아직 설치 파일이 없으신가요?

FREE DOWNLOAD
ALL PLATFORMS.

다운로드 페이지에서 Windows, macOS, Android, iOS, Linux 및 Mihomo 코어 엔진용 전 플랫폼 설치 파일을 받으세요. 모두 오픈 소스 무료입니다.

Clash 클라이언트 다운로드 바로가기