Clash 전체 플랫폼
설치·설정 가이드

01 · 공통 준비

클라이언트·코어·구독 구분하기

Clash 클라이언트는 설정 관리, 모드 선택, 연결 로그와 시스템 연동을 담당합니다. 코어는 규칙을 해석하고 연결을 수립하며, 구독은 설정 제공자가 노드·그룹·규칙 등을 담아 전달합니다. 클라이언트를 설치해도 사용할 수 있는 노드가 자동으로 생기지는 않으며, 구독을 가져왔다고 시스템 트래픽을 모두 처리하게 되는 것도 아닙니다. 문제를 확인할 때는 이 세 가지를 구분하세요. 먼저 설정을 불러올 수 있는지, 선택한 출구 노드에 연결되는지, 마지막으로 앱 트래픽이 클라이언트로 전달되는지 확인합니다.

이 사이트에서는 지원 플랫폼에 Clash Plus를 우선 추천하며, 다른 클라이언트는 운영체제와 사용 방식에 따라 선택할 수 있습니다. mihomo는 Clash 생태계에서 계속 개발되고 있는 코어 중 하나지만, 모든 클라이언트가 같은 설정 항목을 지원한다고 볼 수는 없습니다. 모바일 앱과 데스크톱 앱은 설정 해석기, 코어 버전, 인터페이스 기능이 다를 수 있습니다. 기기 간 설정을 옮기기 전 구독 제공자가 제공한 형식을 확인하고, 대상 클라이언트가 해당 프로토콜·규칙 유형·DNS 옵션을 지원하는지 살펴보세요.

시스템 아키텍처와 설치 출처 확인

시스템의 기기 정보나 정보 페이지에서 운영체제, 프로세서 아키텍처, 남은 저장 공간을 확인하세요. 데스크톱에서는 x64와 ARM64가 흔하며, Mac은 Intel과 Apple Silicon을 구분해야 합니다. Linux는 패키지 형식도 확인하세요. 컴퓨터 브랜드만 보고 설치 파일을 선택하지 마세요. 클라이언트 다운로드 페이지에서 플랫폼에 맞는 항목을 확인하고, 최소 시스템 요구 사항은 선택한 클라이언트의 릴리스 안내를 기준으로 판단하세요. 다른 클라이언트의 요구 사항을 그대로 적용하면 안 됩니다.

설치 전 기존 프록시 프로그램을 종료하고 현재 시스템 프록시, DNS, 다른 VPN의 상태를 기록해 두세요. 회사 기기는 관리 정책으로 설정이 고정되어 있을 수 있으니 권한 범위를 먼저 확인해야 합니다. 기존 설정은 복구할 수 있도록 개인 로컬 폴더에 내보내 백업해 두세요. 구독 주소가 포함된 스크린샷이나 설정 파일, QR 코드를 공개된 게시판에 올리지 마세요. 구독 주소의 접근 매개변수는 보통 인증 정보와 같으므로 노출되면 제공자 페이지에서 다시 발급받으세요.

설정 출처와 트래픽 처리 방식 파악

원격 구독은 이후 업데이트에 편리하고, 로컬 YAML은 고정 설정을 보관하기 좋습니다. Base64로 인코딩된 노드 목록이 완전한 Clash 설정 파일인 것은 아닙니다. 가져오는 중 필드가 없다는 오류가 뜨면 형식부터 확인하고, 오류가 난 줄을 임의로 삭제하지 마세요. 출처를 신뢰할 수 있고 데이터 처리 방식을 이해한 경우에만 변환 도구를 사용하세요. 세 가지 형식을 비교하려면 구독 URL·YAML·Base64 형식 안내를 참고하세요.

시스템 프록시는 앱에 프록시 주소를 알려 줄 뿐, 모든 프로세스가 이를 따르도록 강제하지 않습니다. TUN은 가상 인터페이스와 라우팅을 통해 트래픽을 처리하므로 보통 추가 권한이 필요하며 다른 VPN과 충돌할 가능성도 큽니다. 처음에는 클라이언트가 권장하는 기본 방식으로 설정하고 연결을 확인한 뒤 범위를 넓히세요. 방식을 바꿀 때는 한 번에 하나씩만 변경하고 로그 시점을 기록해야 노드, DNS, 라우팅 중 무엇이 달라졌는지 구분할 수 있습니다.

반복 가능한 기준으로 연결 확인하기

안정적으로 직접 연결되는 사이트 하나와 특정 출구 노드가 필요한 사이트 하나를 준비한 뒤, 각각 DNS 조회와 접속 여부, 로그의 규칙 일치 결과를 기록하세요. 처음에는 규칙 모드를 사용하고 그룹에서 출구 노드를 직접 선택해 자동 선택으로 문제가 가려지지 않게 합니다. 브라우저 캐시, 기존 장기 연결, 앱 자체 프록시 설정이 확인 결과에 영향을 줄 수 있습니다. 설정을 바꾼 뒤 새 연결을 만들어 확인하고, 페이지를 한 번 새로고침한 것만으로 네트워크 전체가 복구됐다고 판단하지 마세요.

클라이언트가 대상 서비스의 이용 정책을 바꾸는 것은 아닙니다. 사용 전 거주 지역의 법률, 회사 네트워크 규정, 서비스 약관을 확인하세요. 준비를 마쳤고 빠르게 연결만 해보려면 빠른 시작 튜토리얼로 이동하세요. 특정 플랫폼의 권한, 백그라운드 실행, 라우팅 문제를 해결 중이라면 아래 해당 챕터로 바로 이동한 뒤 마지막 챕터의 순서에 따라 확인하면 됩니다.

02 · Windows 설치와 프록시

설치 파일 선택 및 첫 실행

먼저 설정의 시스템 정보에서 시스템 유형을 확인한 다음 Windows 다운로드로 이동하세요. Clash Plus를 우선 추천합니다. 다른 인터페이스나 작업 흐름이 필요하다면 Clash Verge Rev, FlClash, Clash Nyanpasu를 차례로 살펴보세요. Clash for Windows는 지원이 종료된 보관용 선택지이므로 새 시스템과의 호환성 문제를 해결하려고 구형 클라이언트로 계속 바꾸는 것은 권장하지 않습니다. 설치 파일의 아키텍처 지원 여부는 다운로드 항목의 설명을 확인하세요.

설치형은 안내에 따라 설치 폴더를 선택하고, 포터블 버전은 현재 계정에서 쓰기 가능한 고정 폴더에 압축을 푸세요. 압축 파일 안에서 바로 실행하지 마세요. 처음 실행할 때는 일반 사용자 권한을 유지하고 프로그램이 열리는지, 설정 폴더에 쓸 수 있는지 확인합니다. 시스템에서 앱 출처나 보안 위험을 알리면 다운로드 출처와 경고 내용을 확인하세요. 설치를 위해 시스템 보호 기능 전체를 끄면 안 됩니다. 조직에서 관리하는 PC라면 관리자에게 배포 가능 여부를 확인하세요.

구독 가져오기 및 출구 노드 선택

설정, 구독 또는 Profiles 화면에서 원격 가져오기 메뉴를 찾아 전체 구독 주소를 붙여 넣고 제출하세요. 성공하면 입력란에 주소만 남는 것이 아니라 선택 가능한 설정이 표시되어야 합니다. 해당 설정을 선택하고 그룹이 나타나는지 확인하세요. 목록이 비어 있다면 설정 로드 로그부터 확인합니다. 일부 클라이언트는 설정 다운로드와 활성화를 별도 작업으로 처리합니다. 업데이트가 끝난 뒤에도 현재 활성 항목을 확인해 이전 파일을 계속 사용하지 않도록 하세요.

출구 모드를 규칙으로 설정하고 프록시가 필요한 그룹에서 노드를 하나 선택하세요. 지연 시간 테스트는 특정 테스트 대상의 응답만 보여 주며 모든 프로토콜과 사이트에서 사용할 수 있다는 뜻은 아닙니다. 처음 연결을 확인할 때는 실제 접속과 연결 로그를 함께 살펴보세요. 구독 다운로드에 실패하면 직접 연결되는 네트워크에서 다시 시도하고 서비스 만료 여부와 주소가 로그인 페이지로 이동하는지 확인하세요. 웹페이지 내용을 YAML로 저장해 다시 가져오면 안 됩니다.

혼합 포트와 시스템 프록시 확인

설정에서 실제 리스닝 포트를 확인하세요. 혼합 포트 예시로 7890을 자주 사용하지만 기기에 따라 다른 포트일 수 있습니다. 혼합 포트는 보통 HTTP와 SOCKS 요청을 모두 받지만, 시스템 프록시에는 클라이언트가 안내하는 방식으로 설정해야 합니다. 시스템 프록시를 켠 뒤 Windows의 네트워크 및 인터넷 설정에서 수동 프록시 주소가 로컬 기기를 가리키는지 확인하세요. 원격 노드 서버 주소를 시스템 프록시 주소로 입력하지 마세요. 서로 다른 계층의 주소입니다.

Get-NetTCPConnection -State Listen -LocalPort 7890 |
  Select-Object LocalAddress, LocalPort, OwningProcess

위 PowerShell 명령은 포트 리스닝 상태를 확인합니다. 결과가 없다면 코어가 실행되지 않았거나 실제 포트가 다를 수 있습니다. 다른 프로세스가 사용 중이라고 표시되면 먼저 어떤 프로그램인지 확인한 다음 기존 클라이언트를 종료하거나 포트를 바꾸세요. 알 수 없는 시스템 프로세스를 바로 종료하면 안 됩니다. 포트를 변경했다면 앱에 직접 입력한 프록시 설정도 함께 바꾸세요. 설정 파일만 수정하고 클라이언트를 다시 불러오지 않으면 실행 중인 리스닝 포트는 이전 값으로 남을 수 있습니다.

TUN·UWP·방화벽 범위

브라우저는 정상인데 일부 앱만 프록시를 사용하지 않는다면 먼저 해당 앱이 시스템 설정을 따르는지 확인하세요. TUN이 필요하면 클라이언트 안내에 따라 서비스를 설치하거나 관리자 권한을 부여한 뒤 가상 인터페이스를 켭니다. 서비스 설치와 매번 관리자 권한으로 실행하는 것은 별개입니다. 서비스를 이미 설치한 클라이언트는 매번 권한을 올릴 필요가 없을 수 있습니다. 활성화 후 라우팅과 로그를 확인하고 네트워크가 끊기면 TUN을 먼저 끄고 기준 상태를 복구하세요. 다른 VPN이나 가속 프로그램을 계속 추가하지 마세요.

일부 UWP 앱에는 루프백 접근 제한이 있어 로컬 프록시가 정상이어도 연결되지 않을 수 있습니다. 우선 클라이언트의 루프백 관리 기능을 사용하고, 실제로 필요한 앱에만 예외를 설정하세요. 모든 앱의 제한을 일괄 해제하거나 루프백 문제를 규칙 오류로 오해하지 마세요. 관련 작업은 시스템 정책의 영향을 받습니다. 회사 기기에서 권한이 거부되면 반복해서 권한을 올려 우회하지 말고, 일반 브라우저에서 같은 대상에 접속되는지 먼저 확인하세요.

방화벽에서 네트워크 접근을 허용하라는 메시지가 나오면 실제 용도에 맞는 네트워크 범위를 선택하세요. 기기에서만 사용할 경우 모든 공용 네트워크에 인바운드 연결을 허용할 필요는 없습니다. 로컬 네트워크에서 공유하려면 리스닝 주소, 인증, 신뢰할 수 있는 네트워크 범위를 별도로 확인하세요. 절전 모드에서 깨어난 뒤나 비정상 종료 후 클라이언트는 꺼졌는데 시스템 프록시가 로컬 포트를 계속 가리키면 시스템 설정에서 남은 프록시를 끈 뒤 클라이언트를 다시 시작하세요. 마지막으로 규칙 로그를 확인하고, 첫 점검 항목은 혼합 포트·모드·시스템 프록시 점검 목록에서 더 살펴보세요.

03 · macOS 설치와 권한 설정

프로세서 확인 후 응용 프로그램에 설치

Apple 메뉴의 이 Mac에 관하여에서 칩 정보를 확인하세요. Apple Silicon과 Intel용 빌드가 다르면 맞는 설치 파일을 선택한 뒤 macOS 다운로드로 이동하세요. Clash Plus를 우선 추천하며, 필요에 따라 Clash Verge Rev와 FlClash도 살펴볼 수 있습니다. ClashX Meta는 지원이 종료되었습니다. 보관용 설치 파일의 시스템 호환성과 기능 지원은 계속 업데이트되는 클라이언트와 같지 않으므로 이름이 비슷하다는 이유만으로 유지 관리 상태를 무시하지 마세요.

디스크 이미지를 다운로드해 연 다음 앱을 응용 프로그램 폴더로 드래그하고, 해당 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하지 마세요. 이렇게 하면 경로 변경으로 인한 업데이트 및 권한 문제를 줄일 수 있습니다. 처음 실행할 때 시스템이 차단하면 먼저 출처를 확인하고 개인정보 보호 및 보안의 구체적인 안내를 살펴보세요. 모든 앱의 보안 속성을 일괄 제거하는 명령을 사용하거나 단일 앱의 실행 경고를 우회하려고 시스템 보호 기능 전체를 끄지 마세요.

확장 프로그램·보조 서비스·키체인 이해하기

macOS 클라이언트는 시스템 프록시, 권한이 필요한 보조 서비스, 네트워크 확장 등을 이용해 네트워크와 연동할 수 있습니다. 구현 방식에 따라 권한 창도 다릅니다. 현재 클라이언트에서 실제로 표시되는 요청만 처리하세요. VPN 구성이나 네트워크 확장을 추가하라는 요청이 있으면 요청한 앱 이름을 확인하고, 보조 서비스 암호를 요구하면 대화상자의 출처를 확인하세요. 특정 종류의 팝업이 보이지 않는다고 설치가 잘못된 것은 아닙니다. 없는 설정을 찾아다니며 단계를 억지로 맞추지 마세요.

일부 권한은 시스템 설정에서 명시적으로 허용한 뒤 클라이언트에서 다시 시도해야 하며, 시스템 재시동이 필요할 수도 있습니다. 작업을 저장하고 안내에 따라 처리한 뒤 확장 프로그램 상태를 확인하세요. 키체인 창은 대개 인증 정보 저장이나 읽기와 관련이 있습니다. 입력해야 하는 것은 시스템이 지정한 키체인의 암호이지 구독 서비스 암호가 아닙니다. 거부 후 기능이 정상적으로 작동하지 않으면 앱 안내와 키체인 접근 권한을 확인하세요. 키체인 항목을 모두 삭제하면 안 됩니다.

구독 가져오기 및 메뉴 막대 조작

클라이언트의 설정 관리 화면에서 원격 구독을 추가하고 다운로드한 설정을 활성화하세요. 로컬 YAML 파일은 파일 가져오기나 설정 폴더 열기 메뉴를 통해 추가할 수 있습니다. 파일 확장자가 이중으로 붙지 않았는지 확인하세요. 설정 로드가 끝나면 그룹을 확인하고 메뉴 막대에서 규칙 모드와 출구 노드를 선택합니다. 메뉴 막대 아이콘이 보인다는 것은 프런트엔드가 실행 중이라는 뜻일 뿐입니다. 코어 상태, 현재 설정, 시스템 프록시가 적용됐는지도 확인해야 합니다.

처음에는 시스템 프록시를 사용해 새 브라우저 창에서 테스트 대상에 접속하고, 연결에 적용된 규칙을 확인하세요. 일부 명령줄 도구는 그래픽 환경의 시스템 프록시 설정을 읽지 않으므로 터미널에서 접속되지 않는다고 클라이언트가 고장 난 것으로 단정할 수 없습니다. 한 번 실행하는 명령에 프록시를 지정해 로컬 접속이 가능한지 확인할 수 있습니다. 아래에서 사용할 포트는 실제 클라이언트 포트로 바꾸세요. 이 명령은 터미널 환경을 영구적으로 변경하지 않습니다.

curl -I --proxy http://127.0.0.1:7890 https://example.com

TUN과 네트워크 위치 변경

앱이 시스템 프록시를 따르지 않을 때 클라이언트가 지원하는 TUN이나 네트워크 확장을 통한 처리를 고려하세요. 활성화하기 전에 다른 VPN을 종료하고 필요한 권한이 허용됐는지 확인해야 합니다. 가상 인터페이스를 만든 뒤에도 DNS와 출구 라우팅을 점검하세요. 연결 표시가 보인다고 모든 트래픽이 예상한 정책을 따르는 것은 아닙니다. 회사 내부망, 프린터, 로컬 개발 서비스도 따로 테스트하고 필요하다면 실제 네트워크 대역에 맞춰 직접 연결을 설정하세요. 출처가 불분명한 라우팅 제외 목록을 통째로 복사하지 마세요.

Wi-Fi에서 유선 네트워크로 바꾸거나 핫스팟에 연결하고 절전 모드에서 깨어난 뒤에는 시스템 프록시가 적용되는 네트워크 서비스가 달라질 수 있습니다. 브라우저 접속이 갑자기 되지 않으면 먼저 현재 네트워크로 직접 연결할 수 있는지 확인한 뒤 클라이언트의 리스닝과 프록시 설정을 살펴보세요. 프록시 도구를 여러 개 동시에 사용하면 나중에 실행한 프로그램이 앞서 설정한 값을 덮어쓸 수 있습니다. 시스템 네트워크를 처리하는 클라이언트는 하나만 남기고, 다른 도구는 네트워크 처리 기능을 끈 뒤 하나씩 확인하세요.

종료 전 시스템 프록시를 끄거나 터널을 끊어 비정상 종료 후 로컬 프록시 주소가 남지 않게 하세요. 제거할 때는 우선 앱 내 기능으로 설치한 보조 서비스를 삭제하고 시스템 설정에서 관련 VPN이나 확장 프로그램도 확인하세요. 다른 클라이언트의 경로를 따라 파일을 직접 지우지 마세요. 같은 종류의 소프트웨어라도 식별자가 다를 수 있습니다. 권한 거부 후 복구 절차가 필요하다면 macOS 확장 프로그램 및 키체인 권한 안내를 참고해 실제로 표시된 창에 맞춰 확인하세요.

04 · Android 설치와 백그라운드 실행

아키텍처와 설치 권한 선택

Android 다운로드에서 Clash Plus를 우선 선택하고, 이어서 Clash Meta for Android, FlClash, Surfboard를 살펴볼 수 있습니다. 최신 기기의 대부분은 ARM64를 사용하지만 구형 기기나 특수 시스템은 프로세서와 앱 지원 여부를 따로 확인해야 합니다. 범용 패키지 제공 여부는 다운로드 페이지에서 확인하세요. Surfboard는 자체 설정 체계를 사용하므로 모든 Clash YAML을 바로 가져올 수 있다고 가정하면 안 됩니다. 설정 제공자에게 대상 클라이언트가 지원하는 형식으로 요청하세요.

APK를 설치할 때 Android에서 현재 브라우저나 파일 관리자의 알 수 없는 앱 설치를 허용하라고 할 수 있습니다. 이 권한은 특정 앱에만 적용되며 설치가 끝나면 필요에 따라 끌 수 있습니다. 파싱 오류가 발생하면 다운로드가 완료됐는지, 시스템 요구 사항과 아키텍처가 맞는지 먼저 확인하세요. 업데이트 중 서명 충돌이 발생하면 설치 출처나 빌드가 다를 수 있습니다. 곧바로 앱을 삭제하지 말고 설정을 내보내 계정 정보와 로컬 설정을 복구할 수 있는지 확인한 뒤 이전 여부를 결정하세요.

설정 가져오기 및 VPN 요청 승인

구독 관리에서 원격 주소를 추가하고 다운로드가 끝날 때까지 기다린 다음 해당 설정을 선택하세요. 로컬 파일을 사용한다면 시스템 파일 선택기에서 읽기 권한을 부여해야 합니다. 다른 앱의 비공개 폴더에 있는 파일은 바로 접근하지 못할 수 있으므로 직접 관리할 수 있는 폴더에 먼저 저장하세요. 구독 목록에 이름이 표시된다고 내용이 유효한 것은 아닙니다. 노드나 그룹이 로드됐는지 확인하고, 오류가 나면 다운로드 응답과 설정 파싱 로그를 살펴보세요.

시작을 누르면 Android에 VPN 연결 요청이 표시되는 경우가 많습니다. 요청한 앱이 방금 설치한 클라이언트인지 확인한 다음 허용하세요. 여기서 VPN은 시스템이 제공하는 로컬 트래픽 처리 인터페이스를 의미하며, 원격 VPN 서버를 자동으로 제공한다는 뜻은 아닙니다. 실제 출구는 설정에 들어 있는 노드와 규칙에 따라 결정됩니다. 연결이 성공하면 상태 표시줄이나 VPN 설정에서 상태를 볼 수 있지만 아이콘만으로 대상 사이트 접속 여부를 확인할 수는 없습니다.

앱별 트래픽·규칙 모드·DNS

모바일 클라이언트에는 터널을 사용할 앱을 지정하는 기능이 있는 경우가 많습니다. 목록이 포함 방식인지 제외 방식인지 먼저 확인하세요. 두 방식은 의미가 반대입니다. 포함 방식은 선택한 앱만 처리하고, 제외 방식은 선택한 앱을 우회합니다. 설정을 바꾼 뒤 연결을 다시 설정해야 하며 일부 앱은 완전히 종료한 뒤 다시 실행해야 합니다. 특정 앱이 연결 로그에 나타나지 않으면 노드부터 바꾸거나 모든 분할 규칙을 끄지 말고 앱 필터를 먼저 확인하세요.

앱 트래픽이 터널에 들어간 뒤에도 도메인, 주소, 규칙 집합에 따라 출구가 결정됩니다. 앱 필터와 규칙 기반 분기는 서로 다른 단계입니다. 특정 앱을 허용했다고 모든 연결이 반드시 직접 연결되는 것은 아닙니다. 로컬 기기 검색, 화면 공유, 홈 네트워크 서비스를 사용할 때는 로컬 네트워크 우회와 DNS도 확인하세요. Android의 비공개 DNS와 앱 내 보안 DNS는 조회 경로를 바꿀 수 있습니다. 문제를 확인할 때는 기존 설정을 기록하고 잠시 비교 테스트한 뒤 조정 여부를 결정하세요.

배터리 관리 및 네트워크 전환

화면을 끄면 연결이 끊기는 경우 배터리 최적화, 백그라운드 활동, 자동 시작, 알림 권한을 먼저 확인하세요. 제조사마다 메뉴 이름이 다르므로 모든 앱을 일괄 허용하지 말고 시스템 앱 정보에서 해당 클라이언트의 설정을 찾으세요. 백그라운드 실행을 허용하면 배터리 사용량이 늘 수 있으니 시스템의 앱 종료가 실제 원인인지 먼저 확인하는 것이 좋습니다. 모바일 데이터에서만 연결이 끊긴다면 앱의 백그라운드 데이터 제한 여부와 요금제 또는 네트워크의 연결 제한도 확인하세요.

Wi-Fi와 모바일 데이터 사이를 전환하면 기본 연결이 다시 설정되어 기존 장기 연결이 끊길 수 있습니다. 네트워크가 복구된 뒤 클라이언트가 자동으로 다시 연결되는지 확인하고, 필요하면 VPN 연결을 끊었다가 다시 시작하세요. 여러 모드를 연달아 빠르게 바꾸면 로그에 사용자가 직접 끊은 기록과 실제 오류가 섞일 수 있습니다. 시스템에서 상시 VPN이나 VPN이 없을 때 연결 차단을 켰다면 클라이언트가 중지될 때 설정에 따라 기기의 네트워크 연결이 차단될 수 있습니다. 시스템 VPN 페이지에서 동작을 확인하고 관리하세요.

같은 사용자 환경에서는 보통 시스템 VPN 인터페이스를 사용하는 앱 하나만 활성화할 수 있습니다. 로컬 방화벽, 광고 차단 도구, 다른 VPN이 인터페이스를 선점할 수 있으니 실행 전에 충돌 원인을 확인하세요. 학교나 회사에서 관리하는 기기는 사용자의 VPN 추가를 금지할 수도 있으므로 관리 정책을 따라야 합니다. 로컬 네트워크 공유가 필요하다면 휴대전화 연결만 확인해서는 안 됩니다. 핫스팟 트래픽이 터널을 통과하는지는 시스템과 클라이언트 기능에 따라 다르며 자동 지원된다고 가정할 수 없습니다.

설정 후 앱을 열어 둔 상태, 잠금 화면에서 일정 시간 지난 뒤, 네트워크를 한 번 전환한 뒤 각각 접속을 확인하고 로그의 출구도 살펴보세요. 사용을 마치면 클라이언트에서 연결을 끊고 시스템 VPN 표시가 사라졌는지 확인합니다. 구독 업데이트는 성공했는데 그룹이 바뀌지 않았다면 현재 활성 설정과 로컬 덮어쓰기 설정을 확인하세요. 다른 구독을 업데이트했을 가능성이 흔한 원인이며, 코어가 새 노드를 받지 못해서라고 단정할 수는 없습니다.

05 · iOS 설치 및 연결 설정

App Store에서 Clash Plus 설치

iPhone과 iPad에서는 Clash Plus를 우선 사용하세요. iOS 다운로드로 이동하거나 해당 App Store 페이지에서 설치할 수 있습니다. 공식 웹사이트는 clashplus.io입니다. 설치 전 스토어에 표시된 최신 시스템 호환 요구 사항과 앱 정보를 확인하세요. 설치 가능 여부는 계정과 기기 상태에 따라 달라지므로 다른 플랫폼의 설치 파일이나 시스템 요구 사항을 iOS에 적용하지 마세요.

설치 후 처음 실행하면 구독, 그룹, 연결 화면의 위치를 먼저 확인한 다음 설정을 가져오세요. 나중에 어떤 설정을 사용하는지 헷갈리지 않도록 이름이 같은 설정을 여러 개 가져오지 마세요. 다른 프록시 앱을 사용 중이라면 기존 설정과 시스템 VPN 상태를 기록하고 이전 연결을 중지하세요. iOS는 앱 샌드박스와 백그라운드 네트워크 확장을 별도로 관리하므로 데스크톱처럼 상시 실행 프로세스, 리스닝 서비스, 드라이버 설치 메뉴를 찾으면 안 됩니다.

구독 및 로컬 설정 추가

설정 또는 구독 메뉴에서 원격 주소를 추가하고 전체 링크를 붙여 넣은 뒤 저장하고 업데이트하세요. QR 코드로 가져올 때는 카메라 권한과 코드의 출처를 확인하세요. QR 코드 스캔은 입력 방법일 뿐 주소의 신뢰성을 보장하지 않습니다. 로컬 파일은 시스템 파일 선택기에서 실제 YAML 파일을 선택하세요. 파일이 클라우드에만 있고 아직 다운로드되지 않았다면 파일을 사용할 수 있을 때까지 기다린 뒤 다시 가져오세요. 파일을 읽지 못한 문제를 문법 오류로 오해하지 않도록 합니다.

가져온 뒤 설정 상태가 정상인지, 그룹과 출구 항목이 표시되는지 확인한 다음 현재 설정으로 지정하세요. 일부 제공자는 노드 구독만 제공하므로 클라이언트에서 자체 규칙 템플릿을 적용해야 할 수 있습니다. 완전한 설정에는 규칙과 DNS가 포함될 수 있습니다. 두 방식을 혼동하지 말고 클라이언트의 가져오기 안내를 확인하세요. 지원하지 않는 필드가 있다면 호환되는 설정을 제공자에게 요청하세요. 알 수 없는 필드를 반복해서 삭제하면 제공자가 의도한 분기 로직이 바뀔 수 있습니다.

VPN 설정 승인 및 규칙 확인

처음 연결할 때 시스템에서 VPN 설정 추가를 요청하고 기기 암호나 생체 인증을 요구할 수 있습니다. 요청한 앱을 확인한 뒤 허용하세요. 승인은 앱이 네트워크 터널을 만들 수 있게 할 뿐, 구독이나 노드가 정상이라는 뜻은 아닙니다. 클라이언트로 돌아가 연결을 시작하고 규칙 모드를 선택한 뒤 그룹에서 출구 노드를 지정하세요. 새로 접속해 연결 기록에서 규칙이 적용됐는지 확인합니다. 상태 표시줄의 VPN 표시만으로 결과를 판단하지 마세요.

iOS에서는 보통 시스템 네트워크 확장으로 트래픽을 처리하므로 데스크톱처럼 모든 앱에 로컬 시스템 프록시 주소를 입력할 필요가 없습니다. 별도 프록시 메뉴, 로컬 네트워크 설정, 그 밖의 처리 옵션이 제공되는지는 실제 클라이언트 기능을 확인하세요. 처음에는 기본 설정을 유지해야 기준 상태를 만들기 쉽습니다. 앱 호환성이나 로컬 네트워크 접근 문제가 실제로 발생할 때만 우회 설정과 DNS를 확인하고 여러 네트워크 옵션을 한꺼번에 바꾸지 마세요.

백그라운드·온디맨드 연결·네트워크 변경

홈 화면으로 돌아간 뒤 앱 화면과 네트워크 확장은 서로 다른 상태일 수 있습니다. 화면에 연결 기록이 잠시 보이지 않는다고 터널이 중지된 것은 아닙니다. 시스템 VPN 상태와 실제 접속 결과를 함께 확인하세요. 반대로 앱을 강제 종료하면 복구 절차에 영향을 줄 수 있으므로 일상적인 연결 해제 방법으로 사용하지 않는 것이 좋습니다. 프록시를 끌 때는 먼저 앱 내 연결 스위치를 사용하고 시스템 설정에서 연결 상태가 갱신됐는지 확인하세요.

온디맨드 연결을 켜 두면 조건이 충족될 때 시스템이 VPN을 다시 시작해 수동으로 끊은 뒤에도 자동으로 연결될 수 있습니다. 이때 앱을 반복해서 삭제하지 말고 클라이언트의 온디맨드 정책과 시스템 VPN 설정을 확인하세요. 회사 관리 기기는 개인 VPN이 제한될 수 있고 조직 설정이 네트워크 동작을 덮어쓸 수도 있습니다. 용도를 모르는 기기 관리 프로파일을 삭제하지 마세요. 먼저 용도를 확인하고 관리자의 안내에 따라 처리해야 회사 계정과 인증서에 영향을 주지 않습니다.

집 Wi-Fi에서 모바일 네트워크로 바꾸면 기존 연결을 다시 설정해야 할 수 있습니다. 먼저 해당 앱의 모바일 데이터 사용이 허용됐는지 확인하고 현재 출구에 연결할 수 있는지 살펴보세요. 로컬 네트워크 서비스 하나만 연결되지 않는다면 같은 네트워크에 있는 기기 주소로 테스트하고 규칙에서 프록시로 전달하고 있는지 확인하세요. 시스템의 다른 개인정보 보호 네트워크 기능이나 앱 내 보안 DNS도 결과를 바꿀 수 있습니다. 문제를 확인할 때는 설정을 하나씩 기록하고 임시로 비교 테스트하세요. 특정 기능을 무조건 영구적으로 꺼야 한다고 단정하지 마세요.

구독 업데이트에 실패하면 서비스 상태와 응답 내용을 먼저 확인한 뒤 직접 연결되는 네트워크에서 수동 업데이트를 한 번 시도하세요. 연결 중 웹페이지에 접속된다고 구독 다운로드도 반드시 같은 경로를 사용하는 것은 아닙니다. 백그라운드 업데이트는 클라이언트 구현과 시스템 스케줄의 영향을 받으므로 정해진 시각에 항상 실행된다고 가정하지 마세요. 기기를 옮기기 전에는 구독 출처와 필요한 설정을 안전하게 보관하세요. 새 기기에서 수동으로 가져오고 연결을 확인한 뒤 이전 기기의 설정을 정리하세요.

06 · Linux 클라이언트와 코어 실행

데스크톱 클라이언트와 명령줄 코어 구분하기

Linux 데스크톱 사용자는 Linux 다운로드에서 Clash Verge Rev와 FlClash를 확인하세요. Clash Verge Rev를 우선 추천합니다. 패키지를 선택할 때 배포판, 프로세서 아키텍처, 패키지 관리자를 함께 확인하세요. Debian 계열은 보통 deb를 사용하고 일부 배포판은 rpm을 사용하지만 확장자만 보고 모든 의존성이 호환된다고 판단할 수는 없습니다. 서버와 라우터 사용자는 mihomo 코어를 고려할 수 있습니다. 명령줄 코어에는 데스크톱용 구독 관리나 시스템 프록시 인터페이스가 포함되어 있지 않습니다.

다운로드한 패키지는 배포판의 소프트웨어 설치 프로그램이나 패키지 관리자로 설치하고 의존성 안내를 확인하세요. 의존성을 맞추려고 서로 다른 배포판의 저장소를 섞지 말고, 출처를 알 수 없는 스크립트를 높은 권한의 셸에 바로 전달하지 마세요. 데스크톱 클라이언트를 실행한 뒤 설정 폴더에 쓸 수 있는지, 코어가 정상적으로 시작되는지 확인합니다. 트레이 아이콘이 표시되지 않는 것은 데스크톱 환경과의 연동 차이일 수 있으며 앱이 종료됐다는 뜻은 아닙니다. 창 상태와 로그를 확인하세요.

구독 가져오기 및 데스크톱 프록시 설정

그래픽 클라이언트에서도 구독 추가, 설정 다운로드, 설정 활성화 순으로 진행한 뒤 규칙 모드와 출구를 선택합니다. 일부 데스크톱 환경은 HTTP, HTTPS, SOCKS 프록시를 각각 설정하므로 클라이언트가 안내하는 포트와 프로토콜을 입력하세요. 혼합 포트가 여러 종류의 연결을 받을 수 있다고 해서 모든 프로토콜 항목을 임의로 바꿔도 되는 것은 아닙니다. 브라우저에 자체 프록시 설정이 있을 수 있고 명령줄 프로그램은 환경 변수만 읽을 수도 있으니 각각 확인하세요.

curl -I --proxy http://127.0.0.1:7890 https://example.com
ss -lntp 'sport = :7890'

첫 번째 명령은 지정한 HTTP 프록시 주소를 테스트하고, 두 번째는 로컬 TCP 리스닝 상태를 확인합니다. 포트는 실제 설정에 맞춰야 하며 프로세스 정보는 현재 권한에 따라 제한될 수 있습니다. 프록시 테스트는 성공했지만 데스크톱 앱에서 실패한다면 데스크톱 환경의 프록시나 앱 자체 설정을 확인하세요. 로컬 연결부터 거부된다면 코어 실행과 포트 문제를 먼저 해결해야 합니다. 리스닝 서비스에 요청이 도달하지도 않은 상태에서 원격 노드 설정을 반복해서 바꾸지 마세요.

명령줄 코어 점검 및 실행

mihomo를 사용할 때는 실행 파일과 개인 설정을 경로가 분명한 폴더에 두고 실제 파일 이름에 맞춰 명령을 실행하세요. 실행 계정은 설정을 읽고 데이터 폴더에 쓸 수 있어야 합니다. 설정에 구독과 노드 정보가 있다면 다른 계정에 불필요한 읽기 권한을 주지 마세요. 먼저 문법을 검사한 다음 포그라운드에서 실행해 오류 출력을 확인합니다. 아래 명령은 현재 폴더에 실행 가능한 mihomo와 완전한 config.yaml이 있다고 가정합니다.

./mihomo -t -d . -f ./config.yaml
./mihomo -d . -f ./config.yaml

문법 검사 통과는 설정을 해석할 수 있다는 뜻일 뿐 노드 연결, 규칙 리소스, 포트 충돌까지 확인된 것은 아닙니다. 포그라운드 실행이 성공한 뒤 서비스로 등록하세요. 그래야 시작 인수, 작업 디렉터리, 권한 문제를 한꺼번에 숨기지 않을 수 있습니다. systemd를 사용할 때는 서비스의 실행 파일·설정·데이터 디렉터리에 실제 절대 경로를 지정하고 서비스 계정에 필요한 파일의 읽기 및 쓰기 권한이 있는지 확인하세요. 서비스 유닛을 변경한 뒤에는 관리자 설정도 다시 불러와야 합니다.

TUN 권한·DNS·원격 복구

TUN에는 가상 인터페이스, 라우팅, 네트워크 관리 권한이 필요하므로 설정에서 스위치만 켠다고 작동하지 않습니다. 먼저 시스템에서 TUN 장치를 제공하는지 확인하고 선택한 클라이언트가 권장하는 서비스나 권한 방식을 사용하세요. 컨테이너에서 실행할 때는 장치 전달과 네트워크 네임스페이스도 고려해야 합니다. 호스트에서 사용할 수 있다고 컨테이너에서도 되는 것은 아닙니다. 편의를 위해 모든 프로그램에 네트워크 관리 권한을 계속 부여하거나 용도를 모른 채 데스크톱 세션 전체를 최고 권한으로 실행하지 마세요.

DNS는 NetworkManager, systemd-resolved, 데스크톱 설정, 클라이언트의 영향을 함께 받을 수 있습니다. 수동으로 바꾸기 전에 DNS를 관리하는 주체부터 확인하세요. 시스템이 파일을 즉시 덮어쓸 수 있습니다. Fake-IP를 켰다면 DNS 요청이 실제로 코어를 통과하는지도 확인해야 합니다. 강화 모드만 바꾸고 우회 DNS를 그대로 두면 규칙 로그와 실제 트래픽이 달라질 수 있습니다. 내부 도메인은 가능한 한 기존 로컬 DNS 경로를 유지하세요.

원격 서버에서 자동 라우팅을 켜기 전 관리 연결과 대역 외 복구 방법을 반드시 확보하고 SSH, 내부망, 상위 노드의 우회 범위를 분명히 하세요. 라우팅 오류로 관리 세션이나 프록시 자체 연결이 터널로 되돌아갈 수 있습니다. 설정 후에는 로컬 프록시, 대상 출구, 원격 관리 연결을 모두 테스트한 뒤 부팅 시 자동 시작을 고려하세요. 서비스를 중지한 뒤에도 인터넷이 되지 않으면 남은 라우팅, 데스크톱 프록시, 환경 변수를 확인해 설치 전 상태로 복구하세요. 실행 파일만 삭제해서는 해결되지 않습니다.

07 · 설정 항목과 자주 발생하는 문제

최소 설정으로 항목 이해하기

문제는 설정 로드, 로컬 리스닝, 시스템 처리, DNS, 규칙, 대상 출구 순으로 확인하세요. 한 번에 변수 하나만 바꾸고 시각과 결과를 기록해야 어떤 변경이 해결에 영향을 줬는지 판단할 수 있습니다. 아래 YAML은 항목과 들여쓰기를 설명하기 위한 예시입니다. 직접 연결 규칙만 있고 프록시 노드가 없으며 구독 제공자의 전체 정책도 포함하지 않습니다. 별도의 테스트 설정에서 구조를 익히는 용도로 사용하고 현재 사용 중인 구독 설정을 덮어쓰지 마세요.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - https://dns.alidns.com/dns-query

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

YAML 계층에는 공백을 사용하고 탭을 섞지 마세요. 같은 수준의 키는 줄을 맞추고 목록 항목 앞의 하이픈은 문법의 일부입니다. 완전한 프록시 설정에는 참조 가능한 출구나 그룹이 필요하며 규칙에서 지정한 대상 이름도 실제 항목과 일치해야 합니다. 구독을 업데이트하면 파일 전체가 다시 생성될 수 있으므로 다운로드된 파일을 직접 수정하면 변경 사항이 사라지기 쉽습니다. 변경을 유지하려면 클라이언트에서 명시적으로 지원하는 덮어쓰기, 병합, 확장 설정 기능을 사용하고 병합 결과를 확인하세요.

구독 오류와 리소스 업데이트 오류를 구분해 처리

구독 업데이트에 실패하면 URL이 완전한지, 만료되지 않았는지, 서버가 유효한 설정을 응답했는지 먼저 확인하세요. 인증 오류는 제공자에게 문의하고, 시간 초과는 다운로드 경로와 네트워크를 확인합니다. 로그인, 리디렉션, 서버 오류로 인해 설정 대신 웹페이지가 반환되는 경우도 흔합니다. GeoIP, GeoSite, 규칙 집합 업데이트는 별도의 리소스 요청입니다. 구독을 가져오는 데 성공했어도 이 리소스가 다운로드됐다는 뜻은 아닙니다. 로그에서 실제로 실패한 리소스를 찾아 경로, 권한, 네트워크를 확인하고 모든 문제를 노드 탓으로 돌리지 마세요.

DNS·Fake-IP·규칙 순서

도메인 조회에 실패하면 시스템, 앱, 코어가 각각 어떤 DNS 경로를 사용하는지 구분하세요. Fake-IP는 도메인에 대응하는 가상 주소를 할당하므로 이런 주소가 보인다고 실제 서버 주소가 잘못된 것은 아닙니다. 중요한 것은 이후 연결이 도메인 정보를 복원할 수 있는 코어를 계속 통과하는지입니다. 터널을 우회하는 앱이 가상 주소를 사용하면 연결에 실패할 수 있으니 처리 범위와 필터 규칙을 확인하세요. 자세한 원리는 Fake-IP와 Redir-Host 비교를 참고하세요.

규칙은 보통 순서대로 검사해 처음 일치한 결과를 사용합니다. 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 마지막 MATCH는 기본 처리 규칙이므로 앞선 규칙을 이해하지 못한 채 바로 바꾸지 마세요. 한 사이트가 여러 도메인에 연결될 수도 있습니다. 메인 페이지는 열리지만 리소스가 실패하면 연결을 하나씩 확인하세요. GeoIP는 주소 정보를 사용하며 일부 규칙 옵션은 DNS 조회 여부에도 영향을 줍니다. 규칙 문구만 보고 모든 트래픽이 지역에 따라 정확히 분기된다고 판단할 수 없습니다.

지연·시간 초과·복구 순서

노드 지연 테스트에 성공해도 실제 대상에 연결된다는 보장은 없고, 실패하더라도 테스트 주소에 도달하지 못한 것일 수 있습니다. 시간 초과가 발생하면 로컬 포트 연결 실패, 원격 노드 연결 실패, 원격 노드에서 대상에 접근하는 과정의 실패를 구분하세요. 같은 시각의 로그를 확인하고 이미 사용 가능한 다른 출구로 비교해 보세요. 일시적으로 로그 상세 수준을 높여 단서를 찾은 뒤에는 원래 수준으로 되돌리세요. 공유 전에는 주소, 계정, 접속 기록 등 민감한 정보를 삭제하세요. 사례는 실행 로그 오류 안내를 참고하세요.

모든 앱에서 접속이 안 되면 리스닝과 트래픽 처리부터 확인하세요. 앱 하나에서만 실패하면 자체 프록시, 루프백, 앱 필터, 캐시를 살펴보고 사이트 하나만 실패하면 규칙과 출구를 확인합니다. 복구한 뒤 실제 포트, 현재 설정 이름, 필요한 권한을 기록해 두되 실제 구독 인증 정보는 적지 마세요. 다른 간단한 질문은 자주 묻는 질문에서, 용어는 용어집에서 확인하세요. 플랫폼마다 이름이 같은 설정의 동작이 완전히 같다고 가정하지 마세요.