먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 클라이언트 다운로드 페이지에서 플랫폼별 설치 방법과 선택 가능한 클라이언트, 시스템 요구 사항을 확인할 수 있습니다. 구독 가져오기와 연결 방법은 사용 설명서에서 따로 다뤄 설치 파일 선택과 네트워크 설정을 구분했습니다.
먼저 Clash Plus를 사용해 보고, 인터페이스 취향에 따라 Clash Verge Rev, FlClash 또는 Clash Nyanpasu를 선택할 수 있습니다. 다운로드 전에 시스템 설정의 ‘시스템 정보’에서 기기 아키텍처를 확인하세요. 컴퓨터 브랜드만으로 판단하면 안 됩니다.
설치한 뒤 설정을 가져오고 시스템 프록시를 켜세요. 일반적인 브라우저 접속은 이 방법으로 먼저 확인할 수 있습니다. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 챕터를 살펴보세요. Clash for Windows는 유지 관리가 중단된 보관용 선택지로만 안내합니다.
다운로드 Windows 클라이언트먼저 Apple 메뉴에서 ‘이 Mac에 관하여’를 열어 Apple Silicon 칩인지 Intel 프로세서인지 확인한 뒤 알맞은 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 권한 안내와 설정 위치가 서로 다를 수 있습니다.
처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용하세요. 시스템 프록시와 TUN은 트래픽을 처리하는 서로 다른 방식이므로 모든 옵션을 동시에 켤 필요는 없습니다. ClashX Meta 다운로드 링크는 보관 자료로 제공하니, 선택하기 전에 유지 관리 상태를 확인하세요.
다운로드 macOS 클라이언트Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교해 보세요. 최근 기기는 대부분 ARM64를 사용하지만, 기기 정보로 직접 확인하는 것이 좋습니다. 설치할 수 없다는 메시지가 나오면 먼저 아키텍처와 시스템 요구 사항을 확인하세요.
구독을 가져와 실행하면 시스템에서 VPN 연결을 요청합니다. 출처를 확인한 뒤 허용하고 클라이언트의 연결 기록을 살펴보세요. 백그라운드로 전환한 뒤 연결이 끊긴다면 반복해서 재설치하기보다 배터리 최적화와 백그라운드 실행 제한을 확인하세요.
다운로드 Android 클라이언트다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 전에 스토어에서 시스템 요구 사항을 확인하고, 설치 후에는 클라이언트 설정 페이지에서 서비스 제공자가 안내한 구독 링크를 가져오세요.
처음 연결할 때 VPN 구성을 추가하도록 허용해야 합니다. 시스템 화면에서 권한을 승인한 뒤 클라이언트로 돌아와 현재 설정이 선택되어 있는지 확인하고 원하는 웹사이트에 접속해 보세요. 시스템에 VPN 표시가 나타나도 터널이 만들어졌다는 뜻일 뿐이므로 실제 연결은 별도로 확인해야 합니다.
다운로드 iOS 클라이언트데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 먼저 배포판의 패키지 형식을 확인한 다음 프로세서 아키텍처를 살펴보세요. 설치 후 데스크톱에서 클라이언트를 실행하고 최초 실행 안내와 서비스 권한 요청을 확인하세요.
서버나 라우터에서 사용할 경우 다운로드 페이지의 커널 섹션에서 mihomo를 확인하세요. 명령줄 커널은 설정 파일과 실행 디렉터리, 서비스 관리 방법을 직접 준비해야 합니다. 커널 압축 파일은 그래픽 인터페이스가 있는 데스크톱 설치 프로그램이 아닙니다.
다운로드 Linux 클라이언트처음 사용할 때는 클라이언트 하나만 실행하는 것이 좋습니다. 여러 클라이언트가 동시에 시스템 프록시를 바꾸거나 가상 네트워크 어댑터를 만들면 연결 경로를 파악하기가 더 어려워집니다.
모든 클라이언트 보기 → 사용 목적별 클라이언트 비교 →자주 사용하는 설정에서 관련 챕터로 이동하세요. 먼저 설정이 어떤 계층을 제어하는지 이해한 뒤 값을 변경하는 것이 좋습니다. 왼쪽에서 주제를 선택하면 오른쪽에서 용도와 구문 예시, 전체 매뉴얼을 확인할 수 있습니다. 예시는 관련 필드만 보여 주므로 기존 설정에 병합해 사용하세요.
규칙 기반 라우팅을 사용하면 모든 연결을 같은 방식으로 처리하는 대신, 대상마다 서로 다른 경로를 지정할 수 있습니다. 클라이언트가 Rule 모드일 때 규칙은 보통 위에서부터 순서대로 확인하며, 먼저 일치한 항목이 경로를 결정합니다. 도메인 규칙을 추가한 뒤 연결 기록에서 어떤 규칙이 일치했는지 확인하고, 최종 프록시 그룹도 살펴보세요. 전역 설정만 제공하는 도구와 달리 이 방식은 라우팅 근거를 명확히 확인할 수 있지만, 규칙 순서를 관리해야 합니다. 아래의 PROXY는 프록시 그룹 이름이므로 실제 설정에 정의되어 있어야 합니다. MATCH는 마지막에 기본 규칙으로 두세요.
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,PROXYTUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시 설정을 따르지 않는 일부 앱에도 적용할 수 있습니다. 트래픽이 커널로 들어가는 방식을 바꾸는 기능이지, 작동하지 않는 노드나 잘못된 규칙을 자동으로 고치는 기능은 아닙니다. 먼저 시스템 프록시로 구독과 연결 경로가 정상인지 확인하세요. 그런 다음 클라이언트 안내에 따라 서비스를 설치하거나 권한을 부여하고 TUN을 켜세요. 브라우저 프록시만 설정하는 것과 달리 라우팅과 시스템 권한이 관련되므로, 문제를 해결할 때 로그와 네트워크 어댑터 상태를 함께 확인해야 합니다. 아래는 mihomo에서 자주 쓰는 필드 예시이며, 실제 지원 여부는 사용 중인 커널과 시스템에 따라 다릅니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53여러 설정을 관리하면 구독 소스, 작업 환경 또는 로컬 테스트 설정을 따로 보관할 수 있습니다. Profile을 여러 개 가져왔더라도 일반적으로 현재 사용할 설정을 직접 선택해야 합니다. 목록에 이름이 나타났다고 해서 적용된 것은 아닙니다. 전환한 뒤 프록시 그룹, 실행 모드, 연결 기록을 확인해 클라이언트가 예상한 내용을 불러왔는지 살펴보세요. 같은 파일을 반복해서 직접 수정하는 것보다 용도에 따라 이름을 지정하면 이전 설정으로 되돌리기 쉽습니다. 구독 파일은 업데이트 중 교체될 수 있으므로 오래 유지할 변경 사항은 클라이언트가 지원하는 오버라이드 방식으로 관리하세요. 아래는 로컬 YAML의 프록시 그룹 예시이며, 화면의 설정 목록을 나타내는 것은 아닙니다.
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
- example-node
# example-node는 유효한 노드로 별도 정의해야 합니다클라이언트는 설정 관리와 메뉴, 시스템 연동을 담당하고 mihomo 커널은 설정을 해석해 프록시, DNS, 규칙 기능을 실행합니다. 둘은 함께 작동하지만 클라이언트를 업데이트해도 모든 필드가 지원되는 것은 아닙니다. 설정 해석 오류가 발생하면 먼저 정보 화면이나 실행 로그에서 커널 정보를 확인한 다음 해당 필드의 사용 조건을 살펴보세요. 화면의 버튼 이름만 보고 판단하기보다 실제 적용된 설정을 확인해야 호환성 문제를 찾기 쉽습니다. 아래의 mixed-port는 HTTP와 SOCKS 프록시 접속을 모두 제공합니다. 다른 프로그램이 사용 중이지 않은 포트를 지정하고 로컬 접속만 허용하세요. LAN에 무턱대고 공개하지 마세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info자동 업데이트는 구독 내용을 다시 가져오는 기능이지 구독의 유효성을 보장하지는 않습니다. 먼저 수동으로 업데이트해 노드와 프록시 그룹이 정상인지 확인한 뒤 적절한 간격으로 설정하세요. 실패하면 링크 유효성, 네트워크 연결, 형식 호환성 순으로 확인하세요. 그래픽 클라이언트의 전체 Profile 업데이트는 보통 인터페이스에서 설정하며, YAML의 proxy-providers 업데이트와는 다른 계층의 기능입니다. 두 기능을 하나의 옵션으로 혼동하지 말고 따로 관리하면 규칙이 교체된 이유를 파악하기 쉽습니다. 아래는 노드 제공자를 주기적으로 가져오는 구문 예시입니다. 예시 주소를 자신의 주소로 바꾸고 프록시 그룹에서도 참조해야 합니다.
proxy-providers:
subscription:
type: http
url: "https://example.com/subscription"
path: ./providers/subscription.yaml
interval: 86400처음 사용할 때 필요한 핵심 단계 세 가지만 안내합니다. 클라이언트 설치를 마쳤다면 구독 가져오기부터 시작하세요. 아직 설치하지 않았다면 다운로드 페이지에서 운영체제에 맞는 클라이언트를 선택하세요. 클라이언트마다 버튼 이름은 다를 수 있지만 설정, 프록시 그룹, 연결 기록의 역할은 같습니다.
클라이언트에서 ‘설정’, ‘구독’ 또는 Profile 페이지를 열고 링크에서 가져오기를 선택하세요. 서비스 제공자가 안내한 전체 주소를 붙여 넣고 저장합니다. 가져오기가 끝나면 설정 이름과 내용을 확인할 수 있습니다. 그런 다음 해당 설정을 선택해 현재 사용 중인 설정으로 지정하세요.
가져오기에 실패했다는 메시지가 나오면 웹페이지 주소나 안내 문구를 잘못 복사하지 않았는지, 불필요한 공백이 포함되지 않았는지 확인하세요. 구독 링크에는 계정 정보가 포함될 수 있으니 공개 게시판에 올리지 마세요. 클라이언트 자체에는 사용할 수 있는 연결 경로가 포함되어 있지 않으므로 설치 성공과 구독 유효성은 별개의 조건입니다.
프록시 페이지에서 실행 모드를 Rule 또는 ‘규칙’으로 설정하세요. 주요 프록시 그룹을 펼쳐 사용할 수 있는 경로를 선택한 다음 플랫폼에 맞게 시스템 프록시를 켜거나 VPN 연결을 설정하세요. 데스크톱에서 처음 사용할 때는 설정이 한꺼번에 바뀌지 않도록 TUN을 꺼 두세요.
프록시 그룹에서 DIRECT를 선택하면 해당 연결이 프록시를 거치지 않고 직접 접속할 수 있습니다. 설정에 용도가 다른 프록시 그룹이 여러 개 있다면 하나씩 확인하세요. 전체 스위치가 켜졌는지만 보고 설정을 끝내지 마세요. 규칙이 일치한 뒤 실제로 사용할 경로는 그룹에서 선택한 항목에 따라 결정됩니다.
확인이 필요한 웹사이트에 접속한 뒤 클라이언트의 ‘연결’ 또는 로그 페이지에서 해당 도메인을 찾으세요. 먼저 연결 기록이 있는지 확인하고, 그다음 일치한 규칙과 최종 연결 경로를 살펴보세요. 기록은 있지만 접속이 안 된다면 노드와 DNS, 대상 서비스 자체를 추가로 확인하세요.
기록이 전혀 없다면 앱이 시스템 프록시를 사용하는지, VPN이 실제로 연결되었는지 먼저 확인하세요. 한 번에 설정 하나만 바꾸고 다시 접속해 결과를 비교하세요. 기본 연결을 확인한 뒤에 시작 프로그램 등록, 자동 업데이트, TUN을 설정하면 처음 문제를 해결할 때 여러 계층이 동시에 얽히는 것을 피할 수 있습니다.
프로젝트마다 어떤 역할을 하는지 이해하는 것이 특정 화면의 버튼 위치를 외우는 것보다 유용합니다. 이 사이트에서는 클라이언트 다운로드 경로와 설정 안내를 정리하며, 각 프로젝트의 릴리스 안내를 대신하지는 않습니다. 기능 지원과 설치 요구 사항, 유지 관리 상태는 선택한 클라이언트의 공식 안내를 기준으로 확인하세요.
Clash는 YAML, 프록시 그룹, 규칙을 중심으로 한 설정 방식을 처음 정립했습니다. 원래 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환 설정을 기반으로 다양한 클라이언트와 커널을 발전시켜 왔습니다. 현재 검색되는 Clash 다운로드 링크는 인터페이스가 완전히 다른 앱으로 연결될 수 있으므로 이름이 비슷하다는 이유만으로 기능과 유지 관리 상태까지 같다고 보면 안 됩니다. 사용법을 읽을 때는 제품의 정식 이름을 확인하고, 클라이언트가 사용하는 커널과 각 설정 항목의 적용 여부도 차례로 살펴보세요.
mihomo는 이 생태계에서 활발히 개발 중인 오픈 소스 커널 중 하나입니다. 그래픽 클라이언트와는 별개의 프로젝트입니다. 커널은 네트워크 처리를 담당하고, 클라이언트는 구독 가져오기, 프록시 그룹 전환, 로그 확인, 시스템 연동 기능을 제공합니다. 클라이언트가 mihomo를 사용한다고 해서 모든 클라이언트의 오버라이드 화면이나 업데이트 방식, 권한 요청 방법이 같지는 않습니다. 매뉴얼에서는 공통 개념과 플랫폼별 사용법을 나누어 설명하므로 클라이언트를 바꾸더라도 기존 지식을 활용할 수 있습니다.
오픈 소스 저장소에서 설정 필드의 의미와 이슈 논의, 프로젝트 유지 활동을 확인할 수 있지만, 저장소가 있다고 해서 특정 연결 경로가 작동한다는 뜻은 아닙니다. 아래에는 mihomo 상류 저장소와 복제 명령을 안내합니다. 소스 코드를 읽거나 문서와 대조하려는 사용자에게 유용합니다. 일반 데스크톱 사용자는 저장소를 복제하거나 직접 빌드할 필요가 없습니다. 다운로드 페이지에서 그래픽 클라이언트를 선택하고 사용 설명서에 따라 설정하면 됩니다.
온라인 사용법과 클라이언트 화면이 다르면 먼저 안내된 제품과 운영체제, 커널 조건을 확인하세요. 오래된 안내에서 버튼 위치가 바뀌었을 수 있으며, 보관용 클라이언트는 현재 시스템에 적합하지 않을 수도 있습니다. 정상 작동 중인 환경을 화면과 똑같이 만들려고 억지로 다운그레이드하지 마세요. 현재 버전에서 같은 기능을 제공하는 메뉴를 찾고, 설정을 바꾸기 전에 복구 가능한 사본을 저장하세요.
앱 업데이트, 커널 업데이트, 구독 업데이트는 서로 다른 문제를 해결합니다. 앱 업데이트는 주로 인터페이스와 시스템 연동을 바꾸고, 커널 업데이트는 프로토콜과 설정 필드 지원에 영향을 줍니다. 구독 업데이트는 서비스 제공자의 노드나 규칙을 다시 가져옵니다. 네트워크에 갑자기 문제가 생기면 최근 어떤 종류의 변경이 있었는지 기록한 다음 해당 계층을 확인하세요. 모든 업데이트를 연달아 실행하지 마세요.
안정적으로 사용하게 되면 정상 작동하는 설정을 백업하고 용도를 알기 쉬운 이름으로 기록해 두세요. 구독 내용을 장기간 수정하기 전에 클라이언트가 병합이나 오버라이드를 지원하는지 확인하세요. 가져온 파일을 직접 편집하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 백업과 로그, 복구 순서는 유지 관리 챕터에서 자세히 확인하세요.
구독은 가져왔지만 웹사이트가 열리지 않는다고 해서 반드시 클라이언트 설치에 문제가 있는 것은 아닙니다. 먼저 연결이 커널에 전달되는지 확인하고, 규칙이 예상한 경로와 일치하는지 살펴본 뒤 노드와 대상 웹사이트를 확인하세요. 특정 앱만 이상하다면 시스템 프록시를 따르는 앱인지 비교하세요. 모든 대상에 접속할 수 없다면 현재 설정과 네트워크 연결, DNS 로그를 확인하세요. 계층별로 점검하면 프로그램을 계속 바꾸는 것보다 유용한 단서를 잘 보존할 수 있습니다.
클라이언트는 연결을 관리하는 도구이며 구독 서비스의 지속적인 유효성을 보장하지 않습니다. 네트워크 서비스를 이용할 때는 거주 지역의 법률과 서비스 약관, 이용 중인 네트워크의 관리 규칙을 준수하세요. 도움을 요청할 때 운영체제와 클라이언트 이름, 오류 메시지, 재현 절차를 설명하되 구독 주소의 인증 정보와 노드 비밀번호, 개인 정보는 삭제하세요. 더 알아보려면 고급 설정 챕터를 차례로 살펴보세요.
최근 기술 노트 세 편에서 속도 문제 진단, 여러 설정 관리, macOS 권한 처리를 다룹니다. 먼저 빠른 시작 안내에 따라 기본 연결을 완료한 뒤 구체적인 문제가 생기면 관련 노트를 확인하세요. 아직 겪지 않은 문제에 대비해 설정을 한꺼번에 너무 많이 바꾸지 않는 것이 좋습니다.
노드 품질, 회선과 통신사, 로컬 DNS와 규칙 설정의 세 계층으로 속도 저하 원인을 나누고, 각 단계의 확인 방법과 조정 항목을 안내합니다.
노트 읽기 →Profile과 구독, 로컬 YAML의 관계를 설명하고 여러 설정의 이름 지정과 전환, 자동 업데이트 간격 설정, 구독 업데이트로 변경 사항이 덮어써지지 않도록 오버라이드하는 방법을 소개합니다.
노트 읽기 →macOS에서 ‘열 수 없음’ 안내, 네트워크 확장 허용, 시스템 프록시와 TUN에 필요한 키체인 권한 및 관리자 암호 요청을 처리하는 순서를 설명합니다.
노트 읽기 →