먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. 설치 패키지는 인터페이스와 실행 환경을 제공하며, 실제 연결에는 사용할 수 있는 구독 또는 설정 파일이 필요합니다. 기존 설정을 사용한다면 소프트웨어 이름만으로 호환성을 판단하지 말고, 프로토콜과 프록시 그룹, 규칙을 대상 클라이언트가 지원하는지 확인하세요.
Clash Plus, Clash Verge Rev 같은 GUI 클라이언트부터 시작해 보세요. 설치 전 시스템 설정에서 기기 아키텍처를 확인하고, 실행 후 설정을 가져온 다음 시스템 프록시를 켜 브라우저 연결을 테스트하세요. 게임이나 명령줄 프로그램처럼 프록시 설정을 따르지 않는 앱의 트래픽까지 처리하려면 서비스 모드와 TUN 권한을 확인해야 합니다.
앱 스토어 앱에서만 문제가 발생한다면 UWP 루프백 제한을 확인하세요. 클라이언트를 바꾸기 전에는 기존 프로그램을 종료해 시스템 프록시 설정을 동시에 변경하거나 포트를 선점하는 상황을 방지하세요.
다운로드 페이지로 이동‘이 Mac에 관하여’에 표시된 칩에 따라 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. GUI 클라이언트에서는 구독과 프록시 그룹을 관리하고 메뉴 막대에서 기능을 전환할 수 있습니다. 웹 접속 확인은 시스템 프록시로 먼저 진행하고, TUN을 사용할 때는 별도의 네트워크 트래픽 가로채기 권한이 필요합니다. 구체적인 승인 절차는 클라이언트 안내를 따르세요.
터미널 요청 결과가 브라우저와 다르면 먼저 터미널의 프록시 환경 변수를 확인하세요. 시스템 프록시를 켜도 모든 명령줄 도구가 같은 경로를 자동으로 사용하는 것은 아닙니다.
다운로드 페이지로 이동Clash Plus, Clash Meta for Android, FlClash 등을 사용할 수 있습니다. 최신 스마트폰은 대부분 ARM64를 사용하지만 기기 정보에서 직접 확인하는 것이 좋습니다. 구독을 가져와 설정을 선택한 뒤 처음 실행하면 시스템 VPN 연결 요청을 허용해야 할 수 있습니다. 이 권한은 기기의 트래픽을 가로채는 로컬 연결 경로를 만드는 데 사용됩니다.
백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 먼저 확인하세요. 앱별 분기를 설정했다면 앱 목록이 올바른지 확인하고, 다른 VPN 앱이 시스템 연결을 사용 중인지도 살펴보세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있으며, 공식 웹사이트 clashplus.io도 확인할 수 있습니다. 설치 후 호환되는 구독을 가져오고 설정이 선택되었는지 확인하세요. 이어서 시스템 안내에 따라 VPN 구성을 추가하고 연결을 시작한 다음 대상 앱에서 접속을 확인하세요.
구독을 다운로드할 수 있는 것과 구독에 포함된 프록시에 연결할 수 있는 것은 별개의 문제입니다. 가져오기에 실패하면 링크와 형식을 확인하세요. 연결은 되지만 일부 사이트만 문제가 있다면 규칙, DNS, 프록시 서버 상태를 점검하세요.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 설치할 때 배포판에 맞는 DEB, RPM 등의 패키지 형식을 확인하세요. 서버, 컨테이너, 라우터에서는 mihomo 커널을 직접 배포하고 설정 파일과 서비스 관리자로 실행을 제어할 수 있습니다. 명령줄로 배포하려면 설정 디렉터리, 파일 권한, 로그, 부팅 시 자동 실행을 직접 관리해야 하며 GUI 클라이언트처럼 버튼 하나로 설정할 수 있는 것은 아닙니다.
처음 실행할 때는 포그라운드에서 설정 파일이 정상적으로 로드되는지 확인하고, 수신 주소를 확인한 뒤 systemd에 연결하세요. 원격 기기에서 TUN을 켜거나 기본 경로를 변경하기 전에는 별도의 관리 연결을 유지해야 프록시 경로 변경으로 SSH 세션이 끊기는 일을 방지할 수 있습니다. 일반 데스크톱 사용자는 설정 문제를 찾기 쉬운 GUI 클라이언트부터 사용하는 편이 좋습니다.
다운로드 페이지로 이동구형 클라이언트는 명확한 호환성 요구가 있는 경우에만 선택하세요. 새로 배포한다면 계속 유지 관리되는 옵션을 우선 고려하고, 구독 호환성·필요 권한·운영체제 지원 범위를 함께 비교하세요.
모든 클라이언트 보기 → 사용 환경에 맞는 클라이언트 선택 →설정은 연결 경로를 지정하고, 클라이언트는 설정을 관리하고 적용합니다. 아래 예시는 필드 간 관계를 보여 주며, 그대로 사용해 인터넷에 연결할 수 있는 완성된 구독은 아닙니다. 예시의 PROXY는 프록시 그룹 이름이므로 실제 설정에 정의된 이름과 일치해야 합니다. TUN과 DNS 매개변수도 실행 플랫폼에 맞게 조정해야 합니다.
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYrules는 위에서 아래 순서로 검사하며, 먼저 일치하는 규칙이 연결 경로를 결정합니다. 도메인 접미사 규칙은 특정 사이트 범위를 지정할 때 적합하고, GEOIP는 대상 IP의 지역을 기준으로 분기할 때 사용합니다. MATCH는 나머지 연결을 처리하도록 마지막에 둡니다. PROXY는 정의된 프록시 또는 프록시 그룹과 일치해야 합니다. 전역 모드와 달리 규칙 모드에서는 요청마다 다른 경로를 사용할 수 있습니다. 변경 전에 앱 트래픽이 커널에 들어오는지 확인하고 연결 기록에서 어떤 규칙이 적용됐는지 살펴보세요. 요청이 기록에 나타나지 않는다면 규칙을 계속 추가하기보다 시스템 프록시나 TUN부터 점검해야 합니다.
설정 필드와 규칙 알아보기 →proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- provider-main
url: https://www.gstatic.com/generate_204
interval: 300proxy-groups를 사용하면 규칙의 대상과 실제 프록시를 분리할 수 있습니다. select는 직접 선택할 때, url-test는 지정한 테스트 주소의 결과를 바탕으로 사용할 경로를 고를 때 사용합니다. 예시의 provider-main은 proxy-providers에 별도로 정의해야 하므로 이 부분만 복사해서는 실행할 수 없습니다. 규칙을 하나씩 수정하는 대신 프록시 그룹을 사용하면 규칙 이름은 유지하면서 그룹 내부의 선택만 바꿀 수 있습니다. 테스트 결과는 테스트 대상과의 연결 상태만 나타냅니다. 모든 사이트에서의 체감 속도나 트래픽 배율, 계정 잔여량, 대상 서비스의 지역 제한을 의미하지는 않습니다.
노드와 프록시 그룹 선택 기준 →tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53TUN은 가상 네트워크 인터페이스로 트래픽을 전달받아 해당 인터페이스로 라우팅되는 연결을 가로챕니다. 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. auto-route와 인터페이스 감지 설정은 라우팅에 영향을 주므로 운영체제 권한과 클라이언트 구현에 맞춰야 합니다. 시스템 프록시보다 더 많은 트래픽을 처리하는 경우가 많지만, DNS와 라우팅 설정, 다른 VPN의 상태에도 더 민감합니다. 먼저 시스템 프록시로 구독 연결을 확인한 다음 TUN을 켜고 로그에서 어댑터와 라우팅 정보를 확인하세요. 원격 연결이나 로컬 네트워크 접속에 문제가 생기면 전역 모드로 바로 전환하지 말고 라우팅 제외 설정부터 살펴보세요.
TUN과 시스템 프록시 작동 방식 비교 →구독 링크
↓ 클라이언트의 ‘프로필’에서 원격 프로필 추가
YAML 가져오기 및 파싱
↓ 프로필을 선택하고 로드 로그 확인
프록시 그룹 확인
↓ 시스템 프록시 또는 플랫폼 VPN 사용
대상 요청과 적용된 규칙 확인구독 링크는 설정을 가져오는 데 사용됩니다. 클라이언트를 설치하는 것만으로 사용할 수 있는 프록시가 생기지는 않습니다. 일반적으로 프로필 화면에서 원격 프로필을 추가하고 링크를 붙여 넣어 다운로드한 뒤 해당 프로필을 선택해 프록시 그룹을 확인합니다. 직접 로컬 YAML을 편집하는 것보다 원격 프로필이 서비스 제공자의 변경 사항을 동기화하기 편리하지만, 다운로드한 내용을 직접 수정하면 다음 업데이트 때 덮어써질 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 오버라이드 기능을 사용하세요. 링크에 계정 접속 정보가 포함되어 있다면 안전하게 보관해야 합니다. 업데이트에 실패하면 변환을 시도하기 전에 링크 유효성, 네트워크 연결, 형식을 확인하세요. 민감한 링크를 낯선 변환 서비스에 넘기지 마세요.
단계별 구독 가져오기 →클라이언트, 커널, 설정 출처를 구분해야 업데이트가 어느 계층에 영향을 주었는지 판단할 수 있습니다. Clash 가이드는 다운로드 경로와 한국어 설정 안내를 정리하며, 각 클라이언트의 프로젝트 공지를 대신하거나 프록시 구독을 제공하지 않습니다. 프로젝트의 상태와 기능 범위, 라이선스는 해당 프로젝트의 공개 자료를 확인하세요.
Clash는 처음에 규칙 기반 프록시 커널을 중심으로 설정 생태계를 형성했습니다. 원 프로젝트의 공개 유지 관리가 중단된 뒤 커뮤니티에서는 여러 커널과 클라이언트 개발 방향이 이어졌습니다. mihomo는 Clash Meta의 개발 방향을 이어받아 프록시 프로토콜 처리, 규칙 매칭, DNS, 트래픽 가로채기 기능을 제공합니다. 이름이 비슷하다고 모든 프로젝트를 같은 팀이 관리하는 것은 아니며, 설정 필드가 서로 다른 구현에서 모두 호환된다는 뜻도 아닙니다.
GUI 클라이언트는 보통 인터페이스 뒤에 커널을 포함하고 설정 관리, 구독 업데이트, 시스템 프록시 전환, 로그 표시를 담당합니다. 프로토콜이 지원되지 않거나 필드를 인식하지 못하거나 실행 중 오류가 발생하면 클라이언트 이름과 실제 사용 중인 커널 정보를 함께 기록해야 합니다. ‘Clash에 연결되지 않는다’는 설명만으로는 문제를 재현하기 어렵습니다. 같은 설정 파일이라도 커널에 따라 동작이 다를 수 있습니다.
커널과 클라이언트 용어 구분하기 →mihomo의 소스 코드, 라이선스, 릴리스 노트, 문제 논의는 공개 저장소에서 확인할 수 있습니다. 공개 코드를 통해 필드 구현과 동작 변경을 추적할 수 있지만, 로컬 설정 확인을 대신하지는 않습니다. 문제를 제보하기 전에 기존 논의를 확인하고 운영체제, 실행 방식, 오류 발생 단계, 필요한 로그를 함께 설명하세요. 설정 스위치 화면만 첨부하는 것은 피하는 편이 좋습니다.
로그와 설정에는 구독 주소, 프록시 인증 정보, 접속 기록이 포함될 수 있습니다. 공유하기 전에 계정 정보를 삭제하고 문제를 재현하는 데 필요한 최소한의 설정만 남기세요. 문제를 진단할 때는 설정 파싱, 포트 수신 대기, 트래픽 가로채기, 규칙 선택, 대상 연결 단계로 나눠 살펴볼 수 있습니다. 먼저 실패한 단계를 찾은 다음 관련 구현을 살펴보거나 제보하면 여러 매개변수를 한꺼번에 바꾸는 것보다 신뢰할 만한 결론을 얻기 쉽습니다.
mihomo 오픈 소스 저장소 보기 ↗이 명령을 실행하려면 로컬에 Git이 설치되어 있어야 합니다. 복제되는 것은 소스 코드이지 GUI 클라이언트 설치 파일이 아닙니다. 일반적인 설치는 다운로드 페이지를 이용하세요.
git clone https://github.com/MetaCubeX/mihomo.git클라이언트 업데이트는 인터페이스, 시스템 연동 또는 커널 구성 요소를 변경합니다. 구독 업데이트는 설정 내용을 다시 가져오는 작업이며 서로 별개입니다. 구독 업데이트에 성공해도 소프트웨어 자체가 최신 버전이 되는 것은 아닙니다. 설치 파일을 바꿔도 만료된 구독이 자동으로 복구되지는 않습니다. 업그레이드 전에는 정상 작동하는 설정과 필요한 오버라이드 규칙을 보관하세요. 업그레이드 후에는 로드 로그를 확인한 다음 시스템 프록시와 TUN이 실제로 동작하는지 점검하세요.
원격 설정의 규칙, 프록시 그룹, 프로바이더는 서비스 제공자가 관리할 수 있으므로 다운로드한 파일을 직접 편집하면 새로고침 후 변경 사항이 사라질 수 있습니다. 사용자 지정 규칙을 추가하려면 클라이언트가 어떤 오버라이드 또는 병합 방식을 지원하는지 확인하고 최종 적용 설정을 살펴보세요. 자동 업데이트 간격은 서비스 제공자의 안내에 맞추세요. 요청을 자주 보낸다고 유효하지 않은 구독이 복구되는 것은 아닙니다.
구독 업데이트 확인 순서 보기 →처음 설정할 때는 클라이언트 하나만 실행하세요. 구독을 가져온 뒤 설정이 정상적으로 파싱되는지, 로컬 포트가 수신 대기 중인지 차례로 확인합니다. 그런 다음 시스템 프록시나 플랫폼에서 제공하는 VPN 트래픽 가로채기를 켜고 대상 주소에 접속한 뒤 연결 기록을 살펴보세요. 브라우저는 작동하지만 다른 앱에서 접속되지 않는다면 프록시 서버가 중단됐다고 단정하지 말고 해당 앱이 시스템 프록시 설정을 따르는지 먼저 확인하세요.
TUN을 켰을 때만 문제가 발생하면 권한, DNS, 라우팅을 집중적으로 확인하세요. 모든 모드에서 실패한다면 구독 상태와 프록시 연결 가능성을 살펴보세요. 매개변수는 한 번에 하나씩 변경하고 변경 전후 로그 차이를 기록해야 합니다. 설정을 초기화해야 한다면 먼저 백업을 내보내 문제가 재현되는 상태와 기존 규칙을 함께 지우지 않도록 하세요. 전체 문서에서 플랫폼별 설치, 권한 승인, 일반적인 충돌을 점검하는 방법을 확인할 수 있습니다.
전체 플랫폼 설치 및 설정 문서 보기 →먼저 링크 응답이 로그인 페이지나 오류 안내가 아니라 호환되는 설정 파일인지 확인하세요. 원본 링크를 보관하고 유효기간과 네트워크 접속 상태를 점검하세요. 실제로 형식이 맞지 않을 때만 구독 변환을 고려하세요. 변환 과정에는 설정 내용과 인증 정보가 전달될 수 있으므로 데이터를 받는 곳과 처리 방식을 먼저 확인해야 합니다.
가져오기 문제 해결 →먼저 트래픽 처리 범위가 명확한 시스템 프록시로 기본 연결을 확인하세요. 대상 앱이 프록시 설정을 따르지 않거나 더 넓은 범위의 트래픽 처리가 꼭 필요할 때만 TUN을 켜세요. 처리 범위가 커지면 라우팅과 DNS 점검 항목도 늘어납니다. 스위치가 있다는 이유만으로 모든 기능을 켤 필요는 없습니다.
네트워크 트래픽 가로채기 용어 알아보기 →사용 가능한 합법적 설정 출처, 클라이언트와 호환되는 프로토콜, 운영체제에서 요구하는 네트워크 권한이 필요합니다. 클라이언트는 트래픽 관리 도구이며 설치했다고 프록시 서비스까지 제공되는 것은 아닙니다. 필요한 항목을 준비한 뒤 가이드에 따라 설정을 가져오고 프록시 그룹을 선택한 다음 연결을 확인하세요.
첫 설정 단계 보기 →구체적인 설정 문제를 중심으로 현상과 원리를 설명한 뒤 확인할 위치와 매개변수를 안내합니다. 최신 노트 세 편을 소개합니다. 기본 사용법은 튜토리얼에서, 플랫폼별 차이와 명령줄 배포는 전체 문서에서 확인하세요.
링크 만료, 업데이트 요청 차단, 프록시를 거치지 않는 요청, 형식 비호환의 차이를 정리합니다. 클라이언트의 업데이트 메뉴를 기준으로 자동 업데이트 간격과 업데이트 시 사용할 네트워크 경로를 확인하는 방법을 안내해 설정 다운로드 실패와 프록시 연결 실패를 구분할 수 있도록 합니다.
노트 읽기 →데스크톱 클라이언트 설치와 헤드리스 환경의 커널 배포를 각각 설명합니다. 설정 디렉터리, 실행 권한, 터미널 프록시 변수, systemd 서비스를 중심으로 절차를 정리해 포그라운드 테스트 성공과 장기 백그라운드 실행에 필요한 추가 설정을 구분할 수 있도록 합니다.
노트 읽기 →앱이 프록시 설정을 따르는 방식과 가상 인터페이스로 트래픽을 가로채는 방식의 차이를 비교합니다. DNS 처리, stack 옵션, 권한 요건을 설명하고 두 방식의 선택 기준을 안내해 브라우저는 연결되지만 다른 앱은 직접 연결되는 문제를 해결하는 데 도움을 줍니다.
노트 읽기 →