플랫폼에 맞는 클라이언트를 설치하고 구독 링크를 가져온 다음, mihomo 코어와 규칙 설정의 관계를 알아보세요.
먼저 플랫폼과 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. GUI는 구독과 연결 상태를 관리하며, 지원 프로토콜과 규칙, 네트워크 모드는 사용 중인 코어에 따라 달라집니다.
데스크톱 브라우저, 개발 도구와 일상적으로 사용하는 앱에 적합합니다. 설치 전에 시스템 설정에서 기기 종류를 확인하고 아키텍처에 맞는 설치 파일을 선택하세요. 클라이언트를 실행한 뒤 설정을 활성화하고 시스템 프록시를 켜면 됩니다.
Clash Plus, Clash Verge Rev, FlClash는 메뉴 위치가 서로 다르지만, 구독·프록시 그룹·로그는 공통적인 문제 해결 경로입니다. 구버전 클라이언트에서 옮길 때는 설정 출처를 백업하세요. 프로그램 폴더만 복사해서는 안 됩니다.
다운로드 페이지로 이동 →먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel 프로세서인지 확인하세요. 클라이언트를 설치하고 실행한 뒤 시스템 안내에 따라 필요한 권한을 허용하고, 메뉴 막대의 실행 상태와 현재 설정을 확인합니다.
시스템 프록시와 TUN은 트래픽을 연결하는 서로 다른 방식입니다. 처음 설정할 때는 브라우저부터 테스트하고 규칙이 적용되는지 확인한 다음 다른 앱을 설정하세요. 여러 스위치를 동시에 바꾸면 문제 원인을 찾기 어렵습니다.
다운로드 페이지로 이동 →모바일에서는 보통 시스템 VPN 인터페이스를 통해 트래픽을 연결합니다. 구독을 가져와 설정을 선택한 다음 연결을 시작하고, 안내에 따라 권한을 허용하세요. 다른 VPN 앱이 실행 중이라면 같은 인터페이스를 두 앱이 함께 사용하려는 것은 아닌지 확인해야 합니다.
백그라운드 연결이 끊겼다고 해서 반드시 구독에 문제가 있는 것은 아닙니다. 배터리 관리, 백그라운드 실행 권한, 네트워크 전환 후의 로그를 각각 확인하세요. 설정 메뉴는 제조사마다 다르므로 기기에 표시되는 항목을 기준으로 확인하면 됩니다.
다운로드 페이지로 이동 →다운로드 페이지에서 Clash Plus의 App Store 설치 경로와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치한 뒤 구독 형식이 클라이언트에서 지원되는지 확인하고, 설정을 저장한 후 시스템 안내에 따라 VPN 설정을 추가하세요.
데스크톱에서 사용하던 YAML 전체가 모바일에서도 그대로 적용되는 것은 아닙니다. 가져오기에 실패하면 형식과 지원 필드를 확인하세요. 계정 페이지 주소를 구독 주소로 사용하지 말고, 공개 화면에 링크 매개변수가 노출되지 않도록 주의하세요.
다운로드 페이지로 이동 →데스크톱 사용자는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 고를 수 있습니다. 서버와 라우터에서는 GUI 클라이언트와 독립형 mihomo 코어를 구분해야 합니다. 프로그램 설치는 첫 단계일 뿐이며, 설정 파일 경로와 실행 권한, 서비스 시작 방식은 별도로 구성해야 합니다.
명령줄 도구가 데스크톱 환경의 시스템 프록시를 사용하지 않을 수도 있습니다. 브라우저는 접속되지만 터미널에서 실패한다면 먼저 앱의 프록시 프로토콜과 로컬 포트를 확인하고 환경 변수도 점검하세요. 특정 프로그램의 연결 문제를 해결하려고 수신 주소를 LAN 전체에 공개해서는 안 됩니다.
다운로드 페이지로 이동 →구독은 설정을 가져오는 출처이고, 프록시 그룹은 선택 경로이며, 규칙은 연결의 목적지를 결정합니다. 먼저 각 계층을 구분한 다음 필드를 수정하면 스위치를 하나씩 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.
아래는 mihomo 설정 필드와 옵션을 보여주는 예시이며, 실제로 연결할 수 있는 완전한 구독 설정이 아닙니다. 탭을 클릭하거나 포커스하면 자동 전환이 일시 중지됩니다.
구독 링크는 설정을 가져오는 주소이지 클라이언트에 내장된 연결 서비스가 아닙니다. '프로필' 또는 '구독' 화면에 기존 링크를 붙여 넣으세요. 다운로드가 완료된 뒤에도 해당 설정을 선택해 활성화해야 합니다. 원격 전체 설정에는 보통 프록시 그룹과 규칙이 포함됩니다. 프록시 제공자는 프록시 항목만 불러오므로 기본 설정의 프록시 그룹에서 참조해야 합니다. 업데이트하면 원격 내용을 다시 읽기 때문에 원격 파일을 직접 수정한 내용은 덮어쓰일 수 있습니다. 계속 유지할 설정은 클라이언트의 오버라이드 기능을 사용하세요. 링크에 포함된 접근 매개변수는 계정 인증 정보처럼 안전하게 관리해야 합니다.
구독 가져오기 단계 보기 →
# 로컬 구독 파일을 프록시 제공자로 사용
proxy-providers:
my-sub:
type: file
path: ./providers/my-sub.yaml
proxy-groups:
- name: PROXY
type: select
use: [my-sub]규칙 모드는 목록 순서대로 연결을 검사하며, 일반적으로 처음 일치한 규칙이 목적지를 결정합니다. 마지막의 MATCH 규칙은 나머지 연결을 처리합니다. 클라이언트에서 '규칙' 모드로 전환한 다음 연결 화면에서 적용된 규칙을 확인하세요. 웹페이지가 열리는지만 보고 추측할 필요가 없습니다. 도메인 규칙은 서비스별 분류에, 주소 규칙은 명확한 네트워크 범위 지정에 적합합니다. 전역 모드와 달리 규칙 모드에서는 직접 연결과 프록시 연결을 함께 사용할 수 있지만, 규칙에서 참조하는 이름은 실제 프록시 그룹이어야 합니다. 변경 전에 기존 설정을 저장하고, 한 번에 하나씩 수정한 뒤 다시 확인하세요.
규칙 및 코어 참고 자료 보기 →mode: rule
rules:
- DOMAIN-SUFFIX,example.com,PROXY
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,PROXY
# PROXY는 기본 설정에 정의해야 합니다프록시 그룹은 여러 프록시 항목을 묶어 규칙에서 참조할 수 있는 출구를 제공합니다. '프록시' 화면에서 해당 그룹을 펼치세요. 수동 선택은 보통 select 유형이며, 자동 검사와 장애 조치는 다른 그룹 유형으로 구현됩니다. 그룹 안의 항목을 바꿔도 규칙을 하나씩 다시 작성할 필요는 없습니다. 그렇다고 모든 앱이 즉시 같은 출구를 사용하는 것도 아니며, 기존 연결은 계속 유지될 수 있습니다. 문제를 확인할 때는 먼저 규칙이 어떤 그룹을 가리키는지 확인한 다음 그룹에서 실제로 선택된 항목을 살펴보세요. 목록의 그룹 이름을 프로토콜 이름과 혼동하지 마세요. 지원되는 프로토콜은 개별 프록시 항목과 코어에 따라 달라집니다.
모드와 프록시 선택 알아보기 →proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
use:
- my-sub
# my-sub은 프록시 제공자에 정의해야 합니다TUN은 가상 네트워크 인터페이스를 통해 트래픽을 연결하며, 시스템 프록시를 사용하지 않는 앱에 적용할 수 있습니다. 클라이언트 설정에서 켜기 전에 코어 지원 여부, 서비스 권한, 시스템 승인을 확인하세요. 모바일에서는 메뉴 이름이 다를 수 있습니다. TUN은 브라우저가 프록시 주소를 읽는 방식과 다르며 라우팅과 DNS에도 영향을 주므로 단순히 더 강력한 전역 모드로 보면 안 됩니다. 켠 뒤 로컬 네트워크에 문제가 생기면 먼저 TUN을 꺼서 기존 상태로 되돌린 다음 자동 라우팅, 서브넷 충돌, 다른 VPN 소프트웨어를 확인하세요. 구체적인 필드는 현재 사용 중인 클라이언트와 코어의 문서를 참고하세요.
네트워크 모드 문제 해결 보기 →# 연결 방식 예시, DNS는 별도 설정 필요
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
# 켜기 전에 실행 권한과 라우팅 충돌 확인오버라이드를 사용하면 원격 설정에 로컬 환경설정을 적용해 구독 업데이트 후 반복해서 수정하는 일을 줄일 수 있습니다. 클라이언트에 따라 '오버라이드', '병합', '확장 설정' 등으로 표시됩니다. 병합 순서와 배열 처리 방식도 클라이언트마다 다릅니다. 먼저 오버라이드가 적용되는 범위를 확인하고, 포트나 로그 수준 같은 항목 하나부터 시험하세요. 구독 원문을 직접 편집하는 것과 달리 수정 내용을 별도로 저장할 수 있지만, 모든 필드를 안전하게 추가할 수 있다는 뜻은 아닙니다. 규칙 삽입 위치, 중복 프록시 그룹 이름, DNS 설정은 최종 생성된 설정을 반드시 확인해야 합니다.
Profile 및 다중 설정 안내 보기 →# 일반적인 병합 필드; 메뉴와 우선순위는 클라이언트마다 다릅니다
mixed-port: 7890
allow-lan: false
log-level: info
# 저장 후 최종 설정을 확인하고 다시 불러오세요'설정 출처 → 규칙 출구 → 앱 연결' 순서로 진행하세요. 먼저 반복해서 확인할 수 있는 기본 상태를 만든 뒤 TUN, 사용자 지정 DNS, 복잡한 오버라이드를 설정하는 것이 좋습니다.
설치가 끝나면 클라이언트의 설정 관리 화면을 열고 링크 가져오기를 선택한 다음 서비스 제공업체가 안내한 구독 주소를 붙여 넣으세요. 다운로드 성공이 설정 적용을 뜻하지는 않습니다. 목록에서 해당 설정을 선택하고 코어가 정상적으로 불러왔는지 확인해야 합니다. 파싱 오류가 표시되면 주소에서 클라이언트가 지원하는 내용이 반환되는지 확인하세요. 웹 로그인 페이지나 오류 메시지가 반환되는 주소여서는 안 됩니다.
로컬 YAML 파일은 파일 가져오기로 불러올 수 있습니다. 원격 구독은 출처에서 업데이트되지만 로컬 파일은 사용자가 직접 관리하므로 이후 수정 방법이 다릅니다. 기기를 옮길 때는 설정 이름과 출처, 로컬 오버라이드도 함께 기록하세요. 로그를 공유하기 전에 구독 매개변수를 가려야 합니다. 안내된 순서대로 진행하면 가져오기 성공과 연결 성공을 혼동하지 않을 수 있습니다.
처음에는 설정에 미리 지정된 규칙 모드를 사용하고, 프록시 화면에서 규칙이 참조하는 그룹을 찾아 사용 가능한 항목을 선택하세요. 규칙 모드는 요청을 어떻게 분배할지 정하고, 프록시 그룹은 해당 그룹으로 분배된 요청이 어떤 출구를 사용할지 정합니다. 두 기능은 서로 다른 설정입니다. 어떤 규칙에서도 참조하지 않는 그룹만 바꾸면 실제 연결은 달라지지 않을 수 있습니다.
전역 모드는 임시 비교에는 유용하지만 모든 문제의 해결책은 아닙니다. 테스트 전에 원래 모드와 그룹 내 선택 항목을 기록하고 테스트 후 복원하세요. 기존 연결은 원래 경로를 계속 사용할 수 있으므로 변화를 확인하려면 요청을 새로 보내야 할 수 있습니다. 자동 선택과 수동 선택을 조정하기 전에 설정 작성자가 그룹을 어떻게 구성했는지 먼저 확인하세요. 다른 그룹에서 참조하는 이름을 삭제하지 않도록 주의해야 합니다.
데스크톱에서는 먼저 시스템 프록시를 켜고 평소 이용하는 사이트를 브라우저로 방문한 뒤, 클라이언트의 연결 화면에서 도메인과 적용 규칙, 출구를 확인하세요. 모바일에서는 안내에 따라 VPN 연결을 시작합니다. 요청 기록이 보이면 트래픽이 적어도 클라이언트까지 도달한 것입니다. 기록이 전혀 없다면 구독을 계속 업데이트하거나 프록시 항목을 바꾸기보다 앱의 연결 방식을 먼저 확인하세요.
브라우저는 정상인데 터미널에서 실패하면 터미널 환경 변수를 확인하세요. 모든 앱에서 실패한다면 설정 활성화 여부와 프록시 그룹 선택, 오류 로그를 차례로 확인합니다. 테스트 중에는 한 번에 조건 하나만 바꾸고 결과를 기록하세요. 그러면 구독 가져오기, 도메인 확인, 실제 연결 단계를 구분할 수 있어 클라이언트를 불필요하게 다시 설치하는 일을 줄일 수 있습니다.
Clash 구독 가이드에서는 설치 경로와 설정 방법을 안내하며 구독 서비스는 제공하지 않습니다. 현재 기기에 적합한 클라이언트인지는 유지 관리 상태와 프로토콜 지원, 실제 운영체제 환경을 고려해 판단해야 합니다.
Clash는 프록시 도구 생태계에서 널리 쓰이는 이름이며, 초기 코어와 이후 포크, GUI 클라이언트는 서로 다른 프로젝트입니다. 원본 Clash와 일부 초기 클라이언트는 유지 관리가 중단되었습니다. 커뮤니티 프로젝트가 비슷한 이름을 사용한다고 해서 개발 주체와 설정 기능, 업데이트 방식이 모두 같다는 뜻은 아닙니다. 소프트웨어를 선택할 때 아이콘이나 'Clash'라는 표기만 보지 말고 프로젝트의 전체 이름을 확인하세요.
구형 클라이언트가 실행된다고 해서 장기간 사용해도 괜찮다는 뜻은 아닙니다. 운영체제 업데이트와 프로토콜 변경, 새 설정 필드가 호환성에 영향을 줄 수 있습니다. 옮기기 전에 구독 출처와 로컬 설정을 백업하고, 새 클라이언트에서 다시 가져와 정상 작동을 확인한 다음 기존 소프트웨어의 자동 실행과 시스템 프록시, 백그라운드 서비스를 정리하세요. 구체적인 차이는 프로토콜 및 코어 참고 자료에서 확인할 수 있습니다. 비교를 위해 프록시 프로그램 여러 개를 동시에 실행할 필요는 없습니다.
GUI 클라이언트는 트레이 메뉴, 구독 관리, 설정 편집, 시스템 연동을 제공하고, 코어는 설정을 해석하고 규칙을 적용해 연결을 구성합니다. 서로 다른 GUI가 같은 코어를 사용할 수도 있고 다른 구현을 택할 수도 있습니다. 따라서 '화면에 해당 스위치가 있다'는 사실과 '현재 코어가 그 기능을 완전히 지원한다'는 사실은 별도로 확인해야 합니다. 오픈 소스 저장소의 문서와 릴리스 노트, 이슈 논의를 살펴보면 기능의 범위와 알려진 제한을 파악하는 데 도움이 됩니다.
이 사이트는 저장소의 인기도를 호환성 판단의 근거로 삼지 않고 실제 사용 사례를 중심으로 안내합니다. 클라이언트를 평가할 때는 대상 플랫폼 지원 여부와 설정 로드 가능 여부, 로그 확인 가능 여부, 업데이트 경로의 명확성을 우선 살펴보세요. 문제가 생기면 운영체제와 클라이언트 이름, 오류가 발생한 단계, 민감한 정보를 가린 로그를 기록해 주세요. '인터넷이 안 된다'는 설명만 제공하는 것보다 유용한 피드백을 받을 가능성이 높습니다.
Clash Meta는 Clash 생태계에서 이어진 포크이며, 이후 프로젝트는 mihomo라는 이름으로 계속 개발되고 있습니다. 오래된 문서와 클라이언트 메뉴, 설정 안내에는 여전히 Meta라는 이름이 쓰일 수 있습니다. 이름이 바뀌었다고 해서 모든 시기의 빌드가 같은 기능을 제공하는 것은 아닙니다. 프로토콜 종류와 DNS 동작, 규칙 필드, TUN 구현은 실제 실행 중인 코어의 문서를 기준으로 확인하세요.
기존 설정을 mihomo로 옮길 때는 먼저 파싱 로그를 확인한 뒤 프록시 제공자와 프록시 그룹, 규칙 간 참조 관계를 검증하세요. YAML을 읽을 수 있다는 것은 현재 단계에서 문법이나 구조가 통과했다는 뜻일 뿐, 모든 요청이 예상대로 처리된다는 의미는 아닙니다. 프로토콜을 선택할 때는 서버 측 지원 여부와 네트워크 품질, 기기 전력 소비도 고려해야 합니다. 프로토콜 이름만으로 연결 속도를 짐작할 수는 없습니다.
클라이언트 업데이트는 인터페이스나 시스템 연동을 바꾸고, 코어 업데이트는 연결 및 설정 기능을 바꾸며, 구독 업데이트는 원격 내용을 다시 가져옵니다. 각 작업은 별도 화면에서 진행될 수도 있고 클라이언트가 통합 관리할 수도 있습니다. 구독 업데이트가 실패할 때 앱을 반복해서 설치해도 링크가 만료된 문제는 해결되지 않습니다. 코어가 새 필드를 지원하지 않는다면 구독만 업데이트해도 해당 기능을 사용할 수 없습니다.
업데이트 전에 작동하는 설정을 저장하고 변경 사항을 확인한 뒤 로컬 오버라이드의 병합 방식을 점검하세요. 업데이트 후에는 익숙한 경로로 접속을 테스트하고 규칙 분기와 로컬 네트워크를 확인합니다. 업데이트 후에만 문제가 생겼다면 변경된 항목을 비교해 원인을 좁히세요. 업데이트 출처에서 잘못된 내용이 반환되면 출처 상태와 유효 기간을 확인해야 합니다. 더 많은 사례는 도움말 센터에서 확인하세요. 기초 지식, 설치 및 설정, 활용 팁, 문제 해결로 분류되어 있습니다.
시작 안내를 확인한 뒤 구체적인 문제에 맞는 글을 이어서 읽어보세요. 문제가 발생한 계층을 먼저 파악하고 알맞은 해결 방법을 선택하면 시스템 프록시와 구독 출처, 프로토콜 지원 문제를 한꺼번에 다루는 일을 피할 수 있습니다.
브라우저와 터미널을 나눠 시스템 프록시 문제를 확인합니다. 프록시 확장 프로그램 충돌과 PAC, 예외 목록을 점검하고 운영체제별 터미널 환경 변수 설정 방법을 안내합니다.
안내 읽기 →초보자가 자주 막히는 질문 10가지를 모았습니다. 구독 가져오기와 모드 선택, 노드 변경, 포트, 시작 시 자동 실행을 다루며 각 항목에 추가 안내를 연결합니다.
안내 읽기 →세대별 코어의 관계를 시간순으로 정리하고 프로토콜 지원과 규칙 유형, TUN 기능을 비교합니다. 기존 설정을 mihomo로 옮길 때 수정해야 하는 필드도 설명합니다.
안내 읽기 →