사용 튜토리얼 센터
5분 만에 Clash 설정하기, 전 플랫폼 상세 튜토리얼
설치부터 지능형 분산까지 Clash의 모든 설정을 단계별로 안내합니다. Windows, macOS, Android, iOS, Linux와 Mihomo Core / CLI 서버 배포까지 지원하며 초보자부터 고급 사용자도 쉽게 따라 할 수 있습니다.
Clash 설정을 완료하는 3단계
어떤 플랫폼을 사용하든 핵심 프로세스는 동일합니다. 아래 플랫폼별 튜토리얼에서 더 상세한 안내를 확인하세요.
클라이언트 다운로드 및 설치
운영 체제에 맞는 Clash GUI 클라이언트를 선택하세요. Windows에는 Clash Verge Rev 또는 FlClash(둘 다 활발히 유지 관리·무료)를, macOS에는 Clash Verge Rev 또는 FlClash(둘 다 Apple Silicon과 Intel 지원)를, Linux에는 Clash Verge Rev(.deb / .rpm / AUR) 또는 FlClash(.deb, amd64)를, Android에는 FlClash(arm64·Material Design 3), Clash Meta for Android(범용 APK·전 아키텍처 지원)또는 Surfboard(경량 Material You 스타일)를, iOS에는 Stash 또는 Shadowrocket을, 서버·NAS·라우터·Docker 등 GUI 없는 환경에는 Mihomo Core(커맨드라인 바이너리)를 추천합니다.
다운로드 페이지로 이동유료 노드 구독 링크 가져오기
서비스 제공업체로부터 Clash 형식의 구독 URL을 받으세요. 클라이언트의 '설정' 또는 '구독' 페이지에 복사하여 붙여넣고 업데이트를 클릭하면 됩니다. 클라이언트가 노드 목록과 분산 규칙을 자동으로 분석하므로 수동으로 YAML 파일을 작성할 필요가 없습니다.
노드 선택 및 프록시 활성화
노드 목록에서 지연 시간이 낮은 프록시 노드를 선택하고 '시스템 프록시'(경량 모드) 또는 'TUN 모드'(글로벌 투명 프록시)를 활성화하세요. Clash가 트래픽을 자동으로 분산하여 국내 사이트는 직결되고 해외 서비스는 프록시를 거치며 시름리스하게 전환됩니다.
Windows 클라이언트 다운로드 및 설치
다운로드 페이지로 이동하세요. Windows에서 현재 활발히 유지 관리되는 두 가지 무료 클라이언트를 선택할 수 있습니다:
Clash Verge Rev
Tauri 프레임워크 기반, 모던 UI에 낮은 리소스 사용량. 커뮤니티에서 가장 활발히 추천하는 Clash 클라이언트. x64와 ARM64 모두 지원.
- 대부분의 사용자:
Clash%20Verge_2.4.7_x64-setup.exe(일반 데스크톱/노트북) - Surface Pro X 등 ARM 기기:
clash-verge-rev-win-arm64.exe
FlClash
Flutter 기반 크로스 플랫폼 클라이언트. Material Design 3 UI로 Windows·macOS·Android·Linux를 단일 코드베이스에서 지원. 멀티 디바이스 사용자에게 적합.
FlClash-0.8.93-windows-amd64-setup.exe다운로드 (현재 x64만 제공. ARM64 기기는 Clash Verge Rev를 선택하세요)
유료 노드 구독 링크 가져오기
Clash Verge Rev를 실행하고 왼쪽 탐색 바에서 '구독'(Profiles)을 클릭한 다음:
- 오른쪽 상단의 '새로 만들기' 또는 입력 상자를 클릭합니다
- 제공업체에서 받은 Clash 구독 URL을 붙여넣습니다
- '가져오기'를 클릭하거나 Enter 키를 눌러 확인합니다
- 구독 다운로드가 완료될 때까지 기다리면 목록에 구성 파일이 나타납니다
- 구성 파일 오른쪽의 '이 설정 사용'을 클릭하여 활성화합니다
https://your-airport.com/api/v1/client/subscribe?token=xxxxxxxx&flag=clash
프록시 노드 확인 및 선택
왼쪽 탐색 바에서 '프록시'(Proxies)를 클릭하면 사용 가능한 모든 노드와 정책 그룹을 확인할 수 있습니다:
- 임의의 정책 그룹('Proxy' 등)을 클릭하고 아래 노드 목록에서 지연 시간이 낮은 노드를 선택합니다
- 노드 오른쪽의 번개 아이콘을 클릭하여 수동 속도 테스트를 수행하고 실시간 지연 시간을 확인할 수 있습니다
- '자동 선택' 정책은 지연 시간에 따라 최적의 노드로 자동 전환해주므로 수동 관리를 원하지 않는 사용자에게 적합합니다
시스템 프록시 활성화
Clash Verge Rev 오른쪽 상단에서 '시스템 프록시' 스위치를 찾아 클릭하여 켭니다 (파란색으로 변경됨).
- 시스템 프록시 모드는 Windows의 시스템 프록시 설정을 자동으로 구성하며 브라우저 등 시스템 프록시를 지원하는 앱에 즉시 적용됩니다
- Clash는 기본적으로
127.0.0.1:7890(HTTP 프록시) 및127.0.0.1:7891(SOCKS5 프록시)를 사용합니다 - 적용 확인: 브라우저에서 google.com에 접속하여 정상적으로 열리면 설정 성공입니다
TUN 모드 활성화 (글로벌 투명 프록시)
TUN 모드는 게임, 명령줄 도구 등 시스템 프록시를 지원하지 않는 프로그램을 포함한 모든 트래픽을 프록시 경유하게 할 수 있습니다. 숙련된 사용자에게 권장합니다:
- Clash Verge Rev 설정 페이지에서 'TUN 모드' 스위치를 찾아 켭니다
- UAC 권한 요청 팝업이 나타나면 '예'를 클릭하여 관리자 권한을 부여하세요 (가상 네트워크 카드 생성에 필요함)
- TUN 모드가 활성화되면 시스템 프록시 스위치를 꺼도 됩니다. TUN이 모든 트래픽을 처리합니다
Windows 사용 자주 묻는 질문
PROCESS-NAME,xxx.exe,DIRECT 규칙을 추가하거나 클라이언트의 프록시 규칙 페이지에서 직접 수동으로 추가하세요.macOS 클라이언트 다운로드 및 설치
다운로드 페이지로 이동하세요. macOS에서 현재 활발히 유지 관리되는 두 가지 무료 클라이언트를 선택할 수 있습니다:
Clash Verge Rev
Tauri 프레임워크 기반, 모던 UI에 낮은 리소스 사용량. 커뮤니티에서 가장 활발히 추천하는 Clash 클라이언트. macOS와 Linux 모두 지원.
- M1 / M2 / M3 / M4 칩 Mac:
Clash%20Verge_2.4.7_aarch64.dmg - Intel 칩 Mac (2020년 이전):
Clash%20Verge_2.4.7_x64.dmg
FlClash
Flutter 기반 크로스 플랫폼 클라이언트. Material Design 3 UI로 Windows·macOS·Android·Linux를 단일 코드베이스에서 지원. 멀티 디바이스 사용자에게 적합.
- M1 / M2 / M3 / M4 칩 Mac:
FlClash-0.8.93-macos-arm64.dmg - Intel 칩 Mac (2020년 이전):
FlClash-0.8.93-macos-amd64.dmg
.dmg 파일을 더블 클릭하고 앱 아이콘을 Applications(응용 프로그램) 폴더로 드래그하여 설치를 완료합니다. 두 클라이언트 모두 구독 가져오기·노드 선택·프록시 활성화 단계가 거의 동일합니다. 이 튜토리얼은 Clash Verge Rev를 기준으로 설명합니다.macOS Gatekeeper 제한 해제
클라이언트를 처음 열 때 macOS에서 '확인되지 않은 개발자가 배포했기 때문에 열 수 없습니다'라고 표시될 수 있습니다. 이는 정상입니다 (Clash Verge Rev와 FlClash 모두 Apple 공증을 받지 않은 오픈 소스 소프트웨어입니다). 다음 두 가지 방법으로 해결할 수 있습니다.
시스템 설정을 통해 허용
- '시스템 설정' → '개인정보 보호 및 보안' 열기
- 아래로 스크롤하여 차단된 앱 관련 메시지 찾기
- '확인 없이 열기' 버튼을 클릭하고 비밀번호를 입력하여 확인
터미널 명령 방법
'터미널' 앱을 열고 선택한 클라이언트에 맞는 명령어를 실행하세요.
sudo xattr -r -d com.apple.quarantine /Applications/ClashVergeRev.app
sudo xattr -r -d com.apple.quarantine /Applications/FlClash.app
유료 노드 구독 링크 가져오기
Clash Verge Rev를 열고 왼쪽 탐색 바에서 '구독'을 클릭합니다.
- '새로 만들기' 버튼 클릭
- URL 입력 상자에 유료 노드 구독 링크 붙여넣기
- (선택 사항) 여러 구독을 구분하기 위해 별칭 입력
- '가져오기'를 클릭하고 구성 파일 다운로드가 완료될 때까지 대기
- 구성 파일을 클릭하여 현재 사용할 설정으로 지정
노드 선택 및 시스템 프록시 활성화
'프록시' 페이지에서 노드를 선택한 후 오른쪽 상단의 '시스템 프록시' 스위치를 켭니다.
- macOS에서 네트워크 권한 요청 팝업이 뜨면 '허용' 클릭
- Clash Verge Rev가 macOS 시스템 프록시를 자동으로 구성하며 Safari, Chrome 등 브라우저에 즉시 적용됩니다.
- 메뉴바에 Clash 상태 아이콘이 나타나며 클릭하여 빠르게 노드 전환 가능
google.com에 접속하여 정상적으로 로드되면 설정 성공입니다.향상된 모드 (TUN) 활성화
시스템 프록시를 지원하지 않는 명령줄 도구, 게임 등 모든 트래픽을 프록시 경유하게 하려면 향상된 모드를 활성화하세요.
- 설정에서 'TUN 모드' 또는 '향상된 모드' 찾기
- 활성화 시 시스템 확장 프로그램 설치 요청이 뜨면 macOS 비밀번호를 입력하여 확인
- '개인정보 보호 및 보안'에서 시스템 확장 프로그램 설치 허용
- Clash Verge Rev를 재시작하면 TUN 모드가 적용됨
macOS 사용 자주 묻는 질문
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890Android 클라이언트 APK 다운로드 및 설치
다운로드 페이지에서 세 가지 추천 Android 클라이언트 중 선택하세요.
- FlClash (추천):
FlClash-0.8.93-android-arm64-v8a.apk다운로드 — 2016년 이후 최신 안드로이드 폰에 최적. Material Design 3 UI, 크로스 플랫폼 일관성 우수(Windows / macOS / Android / Linux 단일 앱으로 커버) - Clash Meta for Android / CMFA (범용): 범용 APK 다운로드 — ARM64·ARMv7·x86_64 전 아키텍처 호환. 기기 아키텍처를 모를 때 선택
- Surfboard (경량): 범용 APK 다운로드 — Material You 디자인, Clash YAML 구독 완전 호환. 간편한 사용 경험을 선호하는 사용자에게 적합
구독 설정 가져오기
클라이언트(FlClash / CMFA / Surfboard)를 실행하고 하단 탐색에서 '구성'을 클릭합니다.
- 오른쪽 상단의 '+' 버튼을 클릭하고 'URL'을 선택합니다.
- 이름 필드에 별칭을 입력하고 URL 필드에 유료 노드 구독 링크를 붙여넣습니다.
- 오른쪽 상단 저장 아이콘을 클릭한 다음 '업데이트'를 클릭하여 구성을 다운로드합니다.
- 다운로드 완료 후 구성 이름 옆의 원을 클릭하여 현재 사용할 설정으로 선택합니다.
노드 선택 및 프록시 시작
- 하단 탐색에서 '프록시'를 클릭하여 정책 그룹 내의 노드를 확인하고 선택합니다.
- 노드 오른쪽의 속도 측정 아이콘을 클릭하여 지연 시간을 테스트하고 지연 시간이 낮은 노드를 선택합니다.
- 홈으로 돌아가 큰 '정지됨' 버튼(재생 아이콘)을 클릭합니다.
- 시스템에서 VPN 연결 권한 요청 팝업이 뜨면 '확인'을 클릭합니다.
- 상태가 '실행 중'으로 바뀌고 알림창에 VPN 아이콘이 나타나면 프록시가 적용된 것입니다.
TUN 모드 설정 (글로벌 프록시)
FlClash와 CMFA는 기본적으로 Android VPN API를 사용하여 트래픽을 처리하므로 별도 설정 없이 TUN과 유사한 글로벌 프록시 효과를 냅니다. 더 세밀하게 제어하려면:
- '설정 → 재정의'에서 프록시 모드(규칙/글로벌/직결)를 사용자 지정할 수 있습니다.
- '로컬 네트워크 우회' 옵션을 켜면 로컬 트래픽이 프록시를 거치지 않습니다 (권장).
- '설정 → 액세스 제어'에서 프록시를 사용할 앱을 설정할 수 있습니다 (앱별 필터링); Surfboard 사용자는 '앱 프록시' 섹션에서 설정할 수 있습니다.
Android 사용 자주 묻는 질문
비중국권 Apple ID로 전환 및 구매
- App Store를 열고 오른쪽 상단 아이콘을 클릭, 맨 아래로 스크롤하여 '로그아웃' 클릭
- 미국 또는 홍콩 Apple ID로 재로그인 (지인 계정 대여 또는 직접 가입)
- 'Stash' 또는 'Shadowrocket'을 검색하여 유료 구매 및 다운로드
- 다운로드 완료 후 다시 원래 Apple ID로 전환해도 구매한 앱은 사라지지 않습니다.
Stash에서 구독 가져오기
- Stash를 실행하고 하단 '홈' 클릭
- '구성 파일 추가' → 'URL에서 다운로드' 클릭
- 유료 노드 구독 URL 붙여넣고 '다운로드' 클릭
- 다운로드 성공 후 자동으로 해당 구성이 활성화됨
- '정책 그룹' 페이지에서 노드를 선택하거나 자동 선택 사용
Shadowrocket (소로켓)에서 구독 가져오기
- Shadowrocket을 열고 오른쪽 상단의 '+'를 클릭합니다.
- '유형'에서 'Subscribe(구독)'를 선택합니다.
- URL 란에 유료 노드 구독 링크를 붙여넣고 별칭을 추가합니다.
- 오른쪽 상단의 '완료'를 클릭하고 노드 로딩이 끝날 때까지 기다립니다.
- 노드 목록에서 지연 시간이 낮은 노드를 선택합니다.
프록시 시작
구성을 가져오고 노드를 선택한 후, 앱 홈 화면에서 '연결되지 않음' 옆의 스위치를 켭니다.
- iOS에서 '이 앱이 VPN 구성을 추가하려고 합니다'라는 권한 요청이 뜨면 '허용'을 클릭하고 Face ID 또는 암호를 입력하세요.
- 상태가 '연결됨'으로 바뀌고 상태 표시줄에 VPN 아이콘이 나타나면 프록시가 적용된 것입니다.
- Safari에서 google.com에 접속하여 정상 작동하는지 확인하세요.
iOS 사용 자주 묻는 질문
?flag=clash 파라미터를 추가한 후 다시 시도해 보세요.Linux 클라이언트 다운로드 및 설치
다운로드 페이지로 이동하세요. Linux에서 현재 활발히 유지 관리되는 두 가지 무료 클라이언트를 선택할 수 있습니다:
Clash Verge Rev
Tauri 프레임워크 기반 — 가장 기능이 풍부한 Linux GUI 클라이언트. .deb, .rpm, AUR 세 가지 형식을 제공하여 모든 주요 배포판을 지원합니다.
- Ubuntu / Debian:
Clash%20Verge_2.4.7_amd64.deb다운로드 - Fedora / RHEL / openSUSE:
Clash%20Verge-2.4.7-1.x86_64.rpm다운로드 - Arch Linux / Manjaro (AUR): 아래 명령어 참조
sudo apt install ./Clash%20Verge_2.4.7_amd64.deb
sudo rpm -i Clash%20Verge-2.4.7-1.x86_64.rpm
paru -S clash-verge-rev
# 또는 yay 사용
yay -S clash-verge-rev
FlClash
Flutter 기반 크로스 플랫폼 클라이언트. Material Design 3 UI로 Windows·macOS·Android·Linux를 하나의 앱으로 지원. 멀티 디바이스 사용자에게 적합.
- Ubuntu / Debian (amd64):
FlClash-0.8.93-linux-amd64.deb다운로드 - RPM 기반 배포판 (Fedora / RHEL) 또는 ARM 사용자는 Clash Verge Rev를 선택하세요
sudo apt install ./FlClash-0.8.93-linux-amd64.deb
구독 설정 가져오기
Windows / macOS 버전과 조작법이 동일합니다.
- Clash Verge Rev(또는 FlClash)를 열고 '구독' 페이지를 클릭합니다.
- '새로 만들기'를 클릭하고 유료 노드 구독 URL을 붙여넣습니다.
- '가져오기'를 클릭하고 구성 다운로드가 완료될 때까지 기다립니다.
- 구성을 클릭하여 현재 사용할 설정으로 지정합니다.
프록시 활성화
Linux 환경의 Clash는 두 가지 프록시 방식을 제공합니다.
시스템 프록시 (GNOME / KDE)
Clash Verge Rev 또는 FlClash에서 '시스템 프록시'를 켜면 GNOME 및 KDE 데스크톱 환경의 프록시 설정을 자동으로 구성합니다.
터미널 환경 변수 방식
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7891"
TUN 모드를 켜서 글로벌 투명 프록시를 구현할 수도 있습니다 (root 권한 필요). 설정에서 TUN 옵션을 찾아 활성화하세요.
Linux 사용 자주 묻는 질문
gnome-settings-daemon이 설치되어 있는지 확인하세요. KDE 사용자는 시스템 설정의 프록시 구성을 확인하세요. 일부 배포판은 네트워크 설정에서 수동으로 프록시를 추가해야 합니다: 호스트 127.0.0.1, 포트 7890.~/.config/autostart/clash-verge-rev.desktop 파일을 만드세요.WAYLAND_DISPLAY=""를 설정하여 XWayland 환경에서 강제 실행해 보세요. FlClash는 Flutter 기반으로 Wayland 호환성이 일반적으로 더 좋습니다.Mihomo 코어 바이너리 다운로드
다운로드 페이지 → Core / CLI에 접속하여 대상 기기의 OS와 아키텍처에 맞는 바이너리를 선택하세요:
- Linux x86_64 서버 / VPS / NAS:
mihomo-linux-amd64.gz(압축 바이너리) 또는mihomo-linux-amd64.deb(Debian/Ubuntu 패키지·권장) - Linux ARM64(Raspberry Pi·ARM 서버): GitHub Releases에서
mihomo-linux-arm64.gz다운로드 - Windows x64:
mihomo-windows-amd64.zip다운로드
Clash 설정 파일 준비
Mihomo는 단일 YAML 설정 파일(config.yaml)로 동작합니다. 두 가지 방법으로 얻을 수 있습니다:
구독 링크를 config.yaml로 다운로드
curl 또는 wget으로 서비스 제공업체의 Clash 구독을 직접 config.yaml로 다운로드하는 가장 빠른 방법입니다.
mkdir -p ~/.config/mihomo
curl -L "https://your-airport.com/api/v1/client/subscribe?token=xxxx&flag=clash" \
-o ~/.config/mihomo/config.yaml
최소 설정 파일 수동 작성
처음부터 구성하는 경우를 위한 최소 config.yaml 예시입니다:
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- 8.8.8.8
- 1.1.1.1
proxies:
- name: "my-node"
type: vmess
server: example.com
port: 443
uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
alterId: 0
cipher: auto
tls: true
proxy-groups:
- name: "Proxy"
type: select
proxies: ["my-node", "DIRECT"]
rules:
- MATCH,Proxy
~/.config/mihomo/, Windows는 %USERPROFILE%\.config\mihomo\입니다. -d <디렉터리> 플래그로 사용자 정의 디렉터리를 지정할 수도 있습니다.Linux — .deb 설치 및 systemd 서비스 등록(권장)
Debian / Ubuntu에서는 .deb 패키지 설치를 권장합니다. systemd 서비스가 자동 등록되어 자동 시작과 프로세스 감시가 편리해집니다:
# .deb 패키지 설치(systemd 서비스 자동 등록)
sudo apt install ./mihomo-linux-amd64.deb
# 설정 파일을 서비스 디렉터리에 배치
sudo mkdir -p /etc/mihomo
sudo cp ~/.config/mihomo/config.yaml /etc/mihomo/config.yaml
# mihomo 서비스 활성화 및 즉시 시작
sudo systemctl enable --now mihomo
# 상태 확인
systemctl status mihomo
# 실시간 로그 확인
journalctl -u mihomo -f
# 서비스 중지
sudo systemctl stop mihomo
# 설정 변경 후 재시작
sudo systemctl restart mihomo
# 자동 시작 비활성화
sudo systemctl disable mihomo
# 최근 100줄 로그 확인
journalctl -u mihomo -n 100
/etc/mihomo/, systemd 유닛 파일은 /etc/systemd/system/mihomo.service입니다. 설정 변경 후 sudo systemctl restart mihomo를 실행하세요.Linux — 독립 실행 바이너리(.gz)
.deb 패키지를 사용하지 않는 경우 압축 바이너리를 압축 해제하여 직접 실행할 수 있습니다:
# 압축 해제 및 실행 권한 부여
gunzip mihomo-linux-amd64.gz
chmod +x mihomo-linux-amd64
sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo
# 설정 디렉터리 생성
mkdir -p ~/.config/mihomo
# (~/.config/mihomo/에 config.yaml 배치)
# 포어그라운드 실행(디버깅용)
mihomo -d ~/.config/mihomo
# 백그라운드 실행
nohup mihomo -d ~/.config/mihomo > ~/.config/mihomo/mihomo.log 2>&1 &
echo $! > ~/.config/mihomo/mihomo.pid
.deb를 사용하지 않을 때 systemd 유닛 파일 수동 생성:
[Unit]
Description=Mihomo Clash Meta Service
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
RestartSec=5s
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now mihomo
Windows — PowerShell로 Mihomo 실행
Windows에서는 PowerShell을 통해 직접 실행하거나 작업 스케줄러로 자동 시작을 등록할 수 있습니다:
# zip 아카이브 압축 해제
Expand-Archive mihomo-windows-amd64.zip -DestinationPath .\mihomo
# 디렉터리로 이동
cd .\mihomo
# 설정 디렉터리 생성 및 config.yaml 배치
New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\mihomo"
# 포어그라운드 실행
.\mihomo.exe -d "$env:USERPROFILE\.config\mihomo"
작업 스케줄러에 로그인 시 자동 시작 등록(관리자 권한으로 실행):
$action = New-ScheduledTaskAction `
-Execute "C:\path\to\mihomo.exe" `
-Argument "-d `"$env:USERPROFILE\.config\mihomo`""
$trigger = New-ScheduledTaskTrigger -AtLogOn
$settings = New-ScheduledTaskSettingsSet -ExecutionTimeLimit 0
Register-ScheduledTask -TaskName "Mihomo" `
-Action $action -Trigger $trigger `
-Settings $settings -RunLevel Highest -Force
Docker 컨테이너 배포
Docker는 서버에 Mihomo를 배포하는 가장 깔끔한 방법으로 의존성을 수동으로 관리할 필요가 없습니다:
services:
mihomo:
image: metacubex/mihomo:latest
container_name: mihomo
restart: unless-stopped
network_mode: host # TUN 모드에 필요
cap_add:
- NET_ADMIN # TUN 모드에 필요
devices:
- /dev/net/tun:/dev/net/tun
volumes:
- ./config:/root/.config/mihomo # 설정 디렉터리 마운트
environment:
- TZ=Asia/Seoul
# ./config/에 config.yaml 배치 후 시작
docker compose up -d
# 로그 팔로우
docker compose logs -f mihomo
# 이미지 업데이트 후 재시작
docker compose pull && docker compose up -d
# 컨테이너 중지 및 삭제
docker compose down
cap_add·devices·network_mode: host를 제거하고 일반 포트 매핑(ports: - "7890:7890" - "9090:9090")을 사용하면 컨테이너 격리성이 향상됩니다.Web 대시보드 사용
Mihomo에는 RESTful API가 내장되어 있어 오픈소스 Web 대시보드로 실시간 트래픽 모니터링, 노드 전환, 연결 현황 확인이 가능합니다.
먼저 설정 파일에서 외부 컨트롤러가 활성화되어 있는지 확인하세요:
external-controller: 127.0.0.1:9090 # 원격 접근은 0.0.0.0:9090으로 변경
secret: "your-secret-key" # API 시크릿(원격 접근 시 반드시 설정)
# 선택 사항: 로컬에 대시보드 내장
external-ui: ui
external-ui-url: "https://github.com/MetaCubeX/metacubexd/archive/refs/heads/gh-pages.zip"
Mihomo 시작 후 브라우저에서 아래 대시보드 중 하나에 접속하여 컨트롤러 주소와 시크릿을 입력하세요:
- MetaCubeXD(권장): d.metacubex.one
- Yacd-meta: yacd.metacubex.one
- 로컬 내장 대시보드(external-ui 설정 후):
http://127.0.0.1:9090/ui
external-controller를 0.0.0.0:9090으로 설정하여 외부에 공개하는 경우 반드시 강력한 시크릿을 설정하세요. 설정하지 않으면 포트에 접근할 수 있는 누구나 프록시 노드를 제어할 수 있습니다.Core / CLI 자주 묻는 질문
?flag=clash 추가 시도); ③ 파일 인코딩이 UTF-8이 아님. mihomo -t -d ~/.config/mihomo로 서비스 시작 없이 설정 파일을 검증할 수 있습니다.mixed-port를 다른 사용 가능한 포트(예: 7892)로 변경하세요. 충돌 프로세스 확인: Linux에서는 lsof -i :7890, Windows에서는 netstat -ano | findstr 7890을 실행하여 충돌 프로세스를 종료한 후 Mihomo를 재시작하세요.allow-lan: true를 설정하고 방화벽에서 mixed-port에 대한 LAN 접근을 허용하세요. 다른 기기는 네트워크 설정에서 HTTP 프록시를 Mihomo가 실행 중인 기기의 LAN IP(예: 192.168.1.100:7890)로 설정하면 프록시를 공유할 수 있습니다.proxy-providers에 구독 URL과 interval(초 단위)을 설정하면 Mihomo가 백그라운드에서 자동으로 노드 목록을 갱신합니다(서비스 재시작 불필요). 또는 cron 작업으로 config.yaml을 재다운로드하고 API로 핫 리로드할 수도 있습니다: curl -X PUT http://127.0.0.1:9090/configs?force=true -d '{"path":"/etc/mihomo/config.yaml"}'Clash 고급 활용 팁
다음 팁들을 익히면 Clash의 기능을 더 강력하게 활용하고 개인별 맞춤 프록시 환경을 구축할 수 있습니다.
DNS 유출 방지 설정
YAML 구성의 dns 필드에서 enhanced-mode: fake-ip를 설정하고, DoH(https://8.8.8.8/dns-query) 또는 DoT를 fallback DNS로 구성하여 DNS 쿼리로 인한 실제 IP 유출을 방지하세요.
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- 114.114.114.114
- 223.5.5.5
fallback:
- https://8.8.8.8/dns-query
- https://1.1.1.1/dns-query
Rule Provider 규칙 세트 구독
Rule Provider를 사용하여 원격 규칙 세트를 구독하면 규칙을 수동으로 관리할 필요 없이 자동으로 최신 상태를 유지할 수 있습니다. Clash Meta는 DOMAIN, IPCIDR 등 다양한 형식을 지원합니다.
rule-providers:
reject:
type: http
behavior: domain
url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
interval: 86400
정책 그룹 (Proxy Group) 설정
정책 그룹을 통해 고급 트래픽 제어 전략을 구현하세요: url-test는 최저 지연 노드 자동 선택, fallback은 장애 시 자동 전환, load-balance는 멀티 노드 부하 분산을 지원합니다.
proxy-groups:
- name: "Auto"
type: url-test
proxies: [Node-HK, Node-US, Node-JP]
url: http://www.gstatic.com/generate_204
interval: 300
외부 제어 패널 (Dashboard)
Clash Meta는 RESTful API를 내장하고 있어 웹 패널을 통해 실시간 트래픽 모니터링 및 노드 관리가 가능합니다. d.metacubex.one에 접속하여 제어 주소(기본값 127.0.0.1:9090)와 비밀번호를 입력하세요.
사용 튜토리얼 자주 묻는 질문
Clash 설정 및 사용 과정에서 가장 자주 발생하는 문제들을 정리하여 빠른 해결을 돕습니다.
ifconfig.me에 접속하여 표시되는 IP가 프록시 노드 지역의 IP인지 확인하세요. Clash의 '연결' 탭에서도 실시간 기록을 확인할 수 있습니다.allow-lan: true로 설정하고 방화벽에서 7890 포트 접근을 허용하세요. 다른 기기의 네트워크 설정에서 HTTP/HTTPS 프록시를 Clash 실행 기기의 내부 IP(예: 192.168.1.100:7890)로 지정하면 됩니다.무료 Clash 다운로드, 지금 바로 설정을 시작하세요
Windows, macOS, Linux, Android, iOS 전 플랫폼 지원, 완전 무료 오픈 소스. 이 가이드와 함께라면 5분 만에 설정을 마치고 지능형 프록시를 즐길 수 있습니다.