먼저 클라이언트, 커널, 설정 파일의 역할을 구분하세요. 클라이언트는 조작 화면을 제공하고, mihomo 커널은 네트워크 연결을 처리하며, 설정 파일은 노드·정책 그룹·규칙의 동작을 정합니다. 왼쪽 항목을 살펴보며 각 설정의 의미를 확인한 다음 클라이언트에서 하나씩 점검하세요. 여러 스위치를 한꺼번에 켜면 어떤 변경이 영향을 줬는지 파악하기 어렵습니다.
mihomo는 설정을 해석하고 규칙을 적용해 프록시 연결을 만드는 커널입니다. 그래픽 클라이언트는 그 위에 구독 목록, 모드 전환, 로그 화면을 제공합니다. 따라서 화면에 표시되는 이름이 다르더라도 기반 설정이 완전히 다르다는 뜻은 아닙니다. 클라이언트를 선택할 때는 지원하는 커널과 설정 항목을 먼저 확인한 뒤 기존 구독을 가져오세요. 설정 해석 오류가 발생하면 클라이언트가 실행되는지만 보고 호환된다고 판단하지 말고, 로그에 표시된 항목명을 확인하세요. 아래는 기본 항목을 설명하기 위한 예시이며, 바로 연결할 수 있는 완성 설정은 아닙니다.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info구독은 설정 내용을 가져오는 주소이고, YAML은 흔히 사용하는 설정 파일 형식입니다. 클라이언트의 설정 또는 구독 화면에서 URL 가져오기를 선택한 뒤 서비스 제공자가 안내한 전체 주소를 붙여 넣고, 업데이트가 끝나면 해당 설정을 선택하세요. 로컬 파일은 파일 가져오기 메뉴를 사용해야 합니다. 노드 공유 문자열이 완전한 설정으로 바로 사용할 수 있는 형식은 아닐 수 있으니, 먼저 형식을 확인하고 필요한 경우 변환하세요. 구독 URL에는 인증 정보가 포함될 수 있습니다. 문제를 문의할 때는 오류 내용만 공유하고 전체 URL은 공개하지 마세요.
https://example.com/sub?token=xxxx형식 예시이며 실제로 사용할 수 있는 구독 서비스는 제공하지 않습니다.
구독 가져오기 단계 보기 →규칙 기반 라우팅은 도메인이나 주소 등의 조건에 따라 직접 연결할지 프록시를 사용할지 결정하는 방식입니다. 커널은 보통 위에서 아래 순서로 규칙을 확인하며, 먼저 일치하는 항목이 연결 경로를 정하므로 규칙의 순서와 내용이 모두 중요합니다. 구독을 가져온 뒤에는 규칙 모드를 사용하고 정책 그룹에서 사용할 수 있는 노드를 선택했는지 확인하세요. 전역 모드는 더 많은 연결을 전역 정책으로 보내지만, 사용할 수 없는 노드까지 복구해 주지는 않습니다. 예시의 DIRECT는 직접 연결을 뜻하며, 일치하는 도메인 접미사에만 적용됩니다. 모든 Apple 서비스가 직접 연결된다는 뜻은 아닙니다.
rules:
- DOMAIN-SUFFIX,apple.com,DIRECT시스템 프록시는 컴퓨터의 운영체제 설정에 로컬 프록시 주소를 등록합니다. 이 설정을 따르는 앱은 연결을 클라이언트로 전달합니다. 처음에는 이 방식을 켜고 브라우저에서 연결을 확인한 다음, 연결 기록에 요청이 나타나는지 살펴보세요. 터미널 도구나 일부 앱은 시스템 프록시 설정을 따르지 않을 수 있으므로 프록시 주소를 별도로 지정하거나 TUN을 사용해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 끄세요. 프로그램이 비정상 종료된 뒤 웹페이지가 열리지 않는다면 시스템 설정이 이미 수신을 중단한 로컬 포트를 가리키고 있는지도 확인해야 합니다.
# 포트는 클라이언트에 설정된 실제 값에 맞추세요
HTTP / SOCKS: 127.0.0.1:7890
mixed-port: 7890TUN은 가상 네트워크 인터페이스로 네트워크 트래픽을 받아 처리하는 방식으로, 시스템 프록시 설정을 따르지 않는 프로그램에 적합합니다. 보통 클라이언트에서 보조 서비스를 설치하고 시스템 권한을 허용해야 합니다. 먼저 일반 프록시 연결이 정상인지 확인한 다음 TUN을 켜고 로그와 DNS 조회가 제대로 동작하는지 살펴보세요. VPN, 다른 프록시 프로그램, 컨테이너 네트워크는 라우팅 충돌을 일으킬 수 있으니 문제를 확인할 때는 트래픽을 처리하는 방식을 한 번에 하나만 사용하세요. TUN은 트래픽을 처리하는 범위를 넓힐 뿐, 최종 연결이 직접 연결될지 프록시를 거칠지는 모드와 규칙이 결정합니다.
tun:
enable: true
auto-route: true
auto-detect-interface: trueApple 메뉴에서 ‘이 Mac에 관하여’를 열어 ‘칩’ 항목에 Apple 칩 이름이 표시되면 Apple Silicon 또는 ARM64 설치 파일을 선택하세요. Intel 프로세서가 표시되면 Intel 또는 x64 설치 파일을 선택하면 됩니다. 네이티브 아키텍처를 사용하면 에뮬레이션 환경에 대한 의존도를 줄일 수 있지만, 클라이언트에 표시된 시스템 요구 사항도 충족해야 합니다. 설치 전에 기존 클라이언트를 종료하고 앱을 Applications 폴더로 옮긴 다음 실행하세요. 클라이언트를 바꿀 때는 설정과 사용자 지정 규칙을 백업하고, 두 프로그램이 동시에 시스템 프록시를 변경하지 않도록 주의하세요.
uname -m
# arm64: Apple Silicon 네이티브 환경
# x86_64: Intel 환경 또는 에뮬레이션 중인 터미널기능 설명은 8초마다 바뀝니다. 클릭하거나 키보드로 조작하거나 포커스를 맞추면 전환이 멈춥니다. 항목 예시는 설정의 의미를 설명하며, 실제 구성은 선택한 클라이언트와 구독 내용에 따라 달라집니다.
먼저 운영체제를 고른 다음 아키텍처를 선택하세요. 데스크톱에서는 그래픽 클라이언트를 우선 사용하고, 서버와 라우터에서는 커널을 직접 실행하는 방식을 고려하세요. 아래 링크는 다운로드 페이지의 해당 플랫폼 항목으로 이동하며 다운로드를 바로 시작하지는 않습니다. 시스템 요구 사항과 유지 관리 상태, 설치 안내를 확인한 뒤 사용할 클라이언트를 선택하세요.
Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. Clash Plus를 우선 살펴보고 Clash Verge Rev와 FlClash도 비교해 보세요. DMG 디스크 이미지를 연 뒤 앱을 Applications 폴더로 드래그하고, 설치 창이 아니라 응용 프로그램 폴더에서 앱을 실행하세요.
처음 실행할 때는 시스템 안내에 따라 개발자 출처를 확인하세요. TUN이 필요하면 클라이언트 안내에 따라 보조 서비스를 설치하면 됩니다. 시스템이 실행을 차단하면 다운로드 출처와 시스템 요구 사항, 표시된 안내를 먼저 확인하세요. 시스템 보안 기능을 끄는 것을 일반적인 설치 방법으로 여기지 마세요. 보관된 클라이언트는 이전 설정을 살펴볼 때 유용하지만, 일상적으로 사용할 앱은 현재 유지 관리되는 제품을 우선 고려하세요.
Clash Plus, Clash Verge Rev, FlClash 등의 데스크톱 클라이언트를 살펴보고 현재 운영체제와 프로세서에 맞는 앱을 선택하세요. 설치가 끝나면 설정을 가져오고 정책 그룹에서 노드를 선택한 뒤 시스템 프록시를 켜세요. 가상 네트워크 인터페이스로 트래픽을 처리하려면 클라이언트 안내에 따라 서비스를 설치하거나 권한을 허용해야 합니다.
Clash for Windows는 유지 관리가 중단되었습니다. 다운로드 페이지에는 보관용 안내가 남아 있으며, 현재도 관리되는 클라이언트와 같은 선택지로 보아서는 안 됩니다. 일부 스토어 앱은 UWP 루프백 제한의 영향을 받으므로 앱 유형에 따라 따로 확인해야 합니다. 브라우저에서는 웹페이지가 열리지만 다른 프로그램이 연결되지 않는다면, 해당 프로그램이 시스템 프록시를 사용하는지 먼저 확인하세요. 곧바로 다시 설치할 필요는 없습니다.
Clash Plus, Clash Meta for Android, FlClash, Surfboard의 설치 방법을 확인하세요. 최신 스마트폰 대부분은 ARM64를 사용하지만, 기기 정보를 확인한 뒤 설치 파일을 선택해야 합니다. 설치 후 클라이언트가 지원하는 설정 형식을 가져오세요. 처음 연결할 때는 시스템에서 VPN 연결 권한을 요청합니다.
Android의 VPN 권한은 기기 내 트래픽을 처리하는 연결 경로를 만들기 위한 것으로, 사용할 수 있는 프록시 노드가 확보되었다는 뜻은 아닙니다. 연결이 백그라운드에서 자주 끊기면 배터리 최적화, 백그라운드 활동 제한, 다른 VPN 앱의 사용 여부를 확인하세요. 클라이언트마다 지원하는 구독 형식이 다를 수 있으므로 링크가 브라우저에서 열린다는 이유만으로 바로 가져올 수 있다고 판단하면 안 됩니다.
다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동한 뒤, 스토어에서 기기 호환성과 앱 설명을 확인하세요. 클라이언트 공식 사이트는 clashplus.io입니다. 설치가 끝나면 설정을 추가하고 시스템 안내에 따라 VPN 구성을 허용한 다음 앱으로 돌아와 연결을 켜세요.
스마트폰과 Mac에서 같은 서비스의 구독을 사용할 수 있지만, 설정 형식과 기기 수 제한은 확인해야 합니다. Wi-Fi와 모바일 네트워크를 전환한 뒤 연결에 문제가 생기면 앱 상태와 구독 유효 기간을 살펴보고 다시 연결하세요. 권한 팝업은 시스템이 트래픽을 처리하도록 허용할 뿐, 노드가 사용 가능한지는 확인하지 않습니다. 노드와 규칙, DNS는 클라이언트에서 별도로 점검해야 합니다.
데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 배포판에 맞는 패키지 형식을 고르고 소프트웨어 패키지의 아키텍처를 확인하세요. 설치 후 그래픽 인터페이스에서 구독을 가져온 다음 데스크톱 환경의 프록시 설정을 살펴보세요. 데스크톱마다 설정 메뉴가 다르며, 그래픽 클라이언트에서 프록시를 켜도 터미널 프로그램은 이를 자동으로 사용하지 않을 수 있습니다.
서버나 헤드리스 기기에서는 mihomo를 직접 실행하고 systemd로 프로세스를 관리할 수 있습니다. 이 경우 설정 파일 경로, 실행 사용자, 수신 주소, 로그 권한을 직접 관리해야 합니다. 제어 인터페이스를 인터넷에 직접 노출하지 말고, 연결을 편하게 하려고 로컬 네트워크 수신을 무작정 허용하지 마세요. 명령줄 배포와 데스크톱 설치의 차이는 전체 설치 안내에서 항목별로 확인할 수 있습니다.
Clash for Mac은 Mac 사용자를 위한 다운로드 및 설정 정보 사이트로, 여러 클라이언트의 설치 경로와 사용 방법을 정리합니다. 이 사이트는 각 클라이언트나 커널 프로젝트의 관리 주체와는 별개입니다. 기능 지원 여부와 유지 관리 상태는 이름에 Clash가 들어가는지만 보지 말고 해당 프로젝트의 릴리스 안내를 확인하세요.
커널 저장소에서 설정 구현 방식과 이슈, 릴리스 안내를 확인할 수 있습니다. 명령을 복사해도 소스 코드만 가져올 뿐 그래픽 클라이언트가 설치되거나 프록시 연결이 자동으로 만들어지지는 않습니다.
git clone https://github.com/MetaCubeX/mihomo.gitClash 생태계는 원 프로젝트와 여러 분기, 커뮤니티 클라이언트의 발전을 거쳐 왔습니다. mihomo는 Clash Meta 계보를 이어 기능을 확장했으며, 여러 그래픽 클라이언트가 이를 사용해 프록시 연결을 처리합니다. 예전 가이드에 과거 이름과 화면이 남아 있을 수 있지만, 현재 메뉴 위치와 설정 항목 지원 여부, 유지 관리 상태까지 같다고 단정할 수는 없습니다.
자료를 확인할 때는 먼저 글이 커널과 그래픽 인터페이스 중 무엇을 다루는지 파악한 뒤 사용 중인 클라이언트를 확인하세요. Clash for Windows와 ClashX Meta의 보관 패키지는 이전 환경을 이해하는 데 참고할 수 있지만, 운영체제 호환 문제가 있다면 오래된 화면 안내를 반복해서 따라가기보다 현재 유지 관리되는 클라이언트로 옮길지 검토하세요.
오픈소스 저장소에서는 설정 해석과 규칙 동작, 문제 수정 내용을 확인할 수 있습니다. 그렇다고 모든 클라이언트가 같은 기능을 지원하거나 커널 프로젝트가 구독 서비스를 제공한다는 뜻은 아닙니다. 그래픽 클라이언트와 프록시 노드, 구독 제공자는 각각 역할이 다르므로 문제를 해결할 때도 따로 점검해야 합니다.
로그에 지원하지 않는 설정 항목이 표시되면 커널 문서와 클라이언트 릴리스 안내를 먼저 대조하세요. 설정은 불러와졌지만 모든 노드 연결에 실패한다면 구독 유효 기간과 네트워크 연결 가능 여부, 노드 정보를 확인하세요. 공개적으로 질문할 때는 구독 인증 정보와 계정 정보, 관리 인터페이스 키를 숨기고 재현 단계와 필요한 오류 내용만 남기세요.
클라이언트 업데이트는 화면이나 보조 서비스, 커널 포함 방식을 바꿀 수 있고 커널 업데이트는 프로토콜 지원과 규칙 처리, 네트워크 동작에 영향을 줄 수 있습니다. 두 업데이트가 항상 동시에 배포되는 것은 아닙니다. 업그레이드 전에 변경 사항을 읽고 사용자 지정 규칙과 현재 설정을 저장하세요. 업데이트 후에는 구독을 불러온 다음 시스템 프록시와 TUN을 차례로 확인하세요.
웹페이지가 한 번 열리지 않았다고 소프트웨어가 오래된 탓으로 단정하지 마세요. 먼저 특정 사이트에서만 문제가 생기는지 확인한 뒤 도메인 조회, 규칙 매칭, 노드 연결을 차례로 살펴보세요. 여러 클라이언트를 연달아 바꾸기보다 점검 순서를 지키는 편이 원인을 찾기 쉽습니다. 다운로드 페이지에서 선택 가능한 설치 파일을 확인할 수 있으며, 홈페이지에는 금방 바뀔 수 있는 구체적인 버전 정보를 표시하지 않습니다.
구독 업데이트는 원격 설정을 다시 가져오는 작업이지 클라이언트 업그레이드가 아닙니다. 업데이트 간격은 제공자의 안내와 노드 변경 주기에 맞추세요. 너무 자주 요청하면 서비스 제한이 적용될 수 있습니다. 유지해야 할 사용자 지정 규칙은 클라이언트에서 지원하는 덮어쓰기 또는 병합 기능으로 관리해 다음 업데이트 때 원격 설정에 덮어쓰이지 않도록 하세요.
클라이언트를 종료하기 전에 프록시 연결을 끊으면 시스템이 로컬 프록시를 계속 가리키는 문제를 줄일 수 있습니다. TUN을 오랫동안 사용하지 않는다면 보조 서비스와 라우팅 상태를 확인하세요. 문제가 생기면 발생 시각과 네트워크 환경, 모드, 오류 메시지를 기록한 뒤 전체 설치 가이드의 점검 순서에 따라 살펴보세요. 여러 설정을 한꺼번에 바꾼 뒤 이전 상태를 기억해 내려고 하지 마세요.
가져오기는 설정이 저장되었다는 뜻일 뿐입니다. 해당 설정을 선택했는지, 정책 그룹에서 사용할 수 있는 노드를 골랐는지, 시스템 프록시나 TUN을 켰는지 확인하세요. 연결 기록에서 요청이 커널에 전달되는지도 살펴보세요. 요청이 없다면 트래픽 처리 설정을 확인하고, 요청은 있지만 실패한다면 노드와 DNS를 점검하세요. 자주 묻는 질문에서 문제 해결 안내 보기 →
시스템 프록시는 앱이 요청을 클라이언트로 전달할지를 결정하고, 규칙 모드와 전역 모드는 요청이 커널에 들어온 뒤 어느 경로로 보낼지를 정합니다. 서로 다른 단계의 설정이므로 대체할 수 없습니다. 처음에는 규칙 모드를 선택하고 브라우저 연결을 확인한 다음, 앱에 따라 트래픽 처리 방식을 조정하세요. 모드 선택 단계 보기 →
두 방식을 함께 사용할지는 클라이언트 구현과 사용 환경에 따라 다릅니다. TUN은 대체로 더 많은 연결을 처리하지만 라우팅과 DNS, 우회 설정은 여전히 확인해야 합니다. 처음 문제를 점검할 때는 두 방식을 각각 시험해 정상 동작하는지 확인한 뒤 클라이언트 안내에 따라 함께 사용하세요. 여러 프록시나 VPN 앱이 동시에 네트워크 경로를 바꾸지 않도록 주의하세요. 연결 방식 관련 질문과 답변 보기 →
설치를 마친 뒤에는 문제가 생긴 부분의 원리를 찾아보세요. 클라이언트를 바꿀 때는 지원 플랫폼과 조작 방식을 비교하세요. 터미널이나 게임, 로컬 네트워크 기기가 연결되지 않는다면 시스템 프록시와 가상 네트워크 인터페이스, 라우터에서 처리하는 트래픽의 범위를 먼저 구분해야 합니다. 아래 세 편의 글은 서로 다른 관점에서 설명하므로 데스크톱 스위치를 다른 기기에 그대로 적용하는 일을 피할 수 있습니다.
플랫폼 지원 범위와 커널 호환성, 인터페이스, 사용 난이도를 기준으로 주요 클라이언트를 비교하고 Mac·Windows·모바일 사용자별 선택 기준을 안내합니다. 기기와 유지 관리 상태를 확인한 뒤 기존 설정을 옮길지 결정하세요.
설정 노트 읽기 →시스템 프록시와 TUN 가상 네트워크 인터페이스가 처리하는 트래픽 범위를 비교하고 터미널 명령과 게임, DNS가 어떻게 다뤄지는지 설명합니다. 요청이 커널에 전달되는지 먼저 확인한 뒤 트래픽 처리 방식을 바꿀지, 규칙과 노드를 더 살펴볼지 판단하세요.
설정 노트 읽기 →메인 라우터와 보조 라우터의 역할, 게이트웨이와 DNS 설정을 정리하고 구성 선택과 리소스 사용량, 자주 발생하는 네트워크 끊김 원인을 설명합니다. 데스크톱 프록시 사용법을 알고 LAN 기기까지 트래픽 처리 범위를 넓히려는 사용자에게 적합합니다.
설정 노트 읽기 →