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

01 / PREREQUISITES

공통 준비 사항: 클라이언트, 구독, 트래픽 적용 방식

GUI 클라이언트, 코어, 서비스 설정 구분하기

Clash 생태계에서 GUI 클라이언트는 구독 관리, 정책 선택, 시스템 연동을 담당하고 코어는 설정을 해석하고 규칙을 매칭해 연결을 수립합니다. mihomo는 계속 발전 중인 코어 프로젝트지만, Clash라는 이름을 쓰는 모든 앱이 같은 코어를 사용하거나 동일한 설정 항목을 지원하는 것은 아닙니다. 설정을 준비하기 전에 클라이언트의 정보 또는 코어 설정 화면에서 실제 사용 중인 코어를 확인하고, 구독 제공업체가 안내하는 설정 형식과 비교하세요. 앱 이름이 비슷하다는 이유만으로 호환된다고 판단해서는 안 됩니다.

일반적인 데스크톱 및 모바일 사용자는 Clash Plus부터 시작하세요. 다운로드 페이지에서 필요에 따라 다른 클라이언트도 선택할 수 있습니다. Linux 사용자는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 백그라운드 서비스, 라우터 배포 또는 직접 설정 관리가 꼭 필요한 경우에만 독립형 Mihomo 코어를 사용하세요. 프로젝트 간 관계는 Clash, mihomo 및 클라이언트 생태계의 관계에서 확인할 수 있습니다. 클라이언트 설치가 끝났다고 해서 사용할 수 있는 프록시 출구까지 준비된 것은 아닙니다.

구독을 준비하고 복구 가능한 백업 보관하기

구독은 보통 설정 텍스트를 반환하는 HTTPS 주소이며, 접근 자격 증명이 포함될 수 있습니다. 일반적인 안내 웹페이지나 단일 노드 공유 링크와는 다릅니다. 복사할 때 줄바꿈, 공백, 메신저가 덧붙인 문장부호가 포함되지 않았는지 확인하세요. 자격 증명이 포함된 전체 주소를 공개 게시판에 올리지 마세요. 서비스 상태, 유효 기간, 기기 제한도 확인해야 합니다. 서비스 제공업체가 일반 형식과 mihomo 형식을 따로 제공한다면, 여러 주소를 무작정 시도하지 말고 현재 코어에 맞는 형식을 선택하세요.

처음 설정하기 전에 기존 시스템 프록시 상태, 실행 중인 VPN, 네트워크 인터페이스 이름을 기록하세요. 기존 설정은 먼저 내보내거나 별도 디렉터리에 복사하고 수동으로 선택한 정책도 메모해 두세요. 원격 구독을 업데이트하면 로컬 수정 사항이 덮어써질 수 있으므로 사용자 규칙은 클라이언트가 지원하는 재정의 또는 병합 기능에 넣는 것이 좋습니다. 내보낸 설정과 로그에는 서버 주소, 사용자 이름, 구독 주소가 포함될 수 있습니다. 화면을 공유하기 전에 노드 이름만 가리지 말고 민감한 정보를 항목별로 모두 가리세요.

모드를 구분한 뒤 트래픽 적용 방식을 선택하세요

규칙, 전역, 직접 연결은 트래픽이 나갈 경로를 결정하고 시스템 프록시와 TUN은 트래픽이 코어로 들어오는 방식을 결정합니다. 서로 다른 계층입니다. 규칙 모드는 위에서부터 규칙을 매칭하고, 전역 모드는 코어로 들어온 요청을 전역 정책으로 보냅니다. 직접 연결 모드에서는 프록시 출구를 거치지 않습니다. 처음에는 규칙 모드에서 사용할 수 있는 노드를 하나 명확히 선택한 뒤 연결 기록을 확인하세요. 규칙 문제를 진단할 때 전역 모드로 바꿔 볼 수 있지만, 만료된 구독이나 연결 불가 노드를 해결해 주지는 않습니다.

TUN은 가상 네트워크 인터페이스와 라우팅을 통해 요청을 처리하므로 보통 시스템 프록시보다 더 많은 트래픽을 적용 대상으로 삼습니다. 다만 실제 범위는 시스템 제한, 제외 규칙, 클라이언트 구현에 따라 달라집니다. 모바일에서는 시스템 VPN 설정 권한이 필요할 수 있고, 데스크톱에서는 특권 서비스가 필요할 수 있습니다. 처음 설치할 때 여러 트래픽 처리 도구를 동시에 사용하지 마세요. 먼저 한 가지 경로를 확인한 다음 TUN을 추가하세요. 문제가 생기면 화면의 연결 스위치만 볼 것이 아니라 해당 요청이 실제로 어느 경로로 들어갔는지 확인해야 합니다.

최소 검증 기준 만들기

직접 연결할 수 있는 웹사이트 하나와 선택한 프록시 경로가 필요한 대상 하나를 각각 테스트하세요. 네트워크, 클라이언트 모드, 선택한 정책 그룹, 오류 발생 시간을 기록한 다음 연결 페이지에서 같은 도메인을 찾아 규칙, 정책 체인, 출구를 확인합니다. 지연 시간 테스트는 특정 시점의 테스트 요청이 완료됐다는 뜻일 뿐, 모든 도메인, UDP, 로그인 절차가 정상 작동한다는 보장은 아닙니다. 기본 네트워크 자체에 문제가 있다면 트래픽 적용을 해제해 일반 인터넷 연결을 복구한 다음 클라이언트를 점검하세요.

02 / WINDOWS

Windows: 설치, 시스템 프록시, 서비스 권한

시스템 아키텍처에 맞는 설치 파일 선택하기

설정의 시스템 정보 페이지에서 프로세서 유형과 시스템 아키텍처를 확인한 다음 Windows 클라이언트 다운로드로 이동하세요. 우선 권장 클라이언트는 Clash Plus이며, Clash Verge Rev, FlClash, Clash Nyanpasu도 선택할 수 있습니다. Clash for Windows는 지원이 종료된 보관용 옵션이므로 새 기기에서 일반적인 선택으로 권장하지 않습니다. PC 브랜드가 같다는 이유로 다른 PC의 설치 파일을 그대로 사용하지 마세요. 아키텍처와 앱별 시스템 요구 사항을 각각 확인해야 합니다.

설치 프로그램을 실행할 때 게시자 정보와 설치 경로를 확인하고, 일반 앱 디렉터리에 설치하세요. 브라우저의 임시 다운로드 디렉터리에서 장기간 실행하지 마세요. 보안 소프트웨어가 차단하면 파일 출처와 차단 세부 정보를 확인하고 보안 기능 전체를 끄지 마세요. 앱을 실행한 뒤에는 시스템 프록시와 TUN을 끈 상태로 인터페이스, 설정 저장 위치, 로그가 정상인지 확인하세요. 이후 프록시 클라이언트 하나만 실행해 다른 프로그램이 백그라운드에서 프록시 설정을 반복해서 바꾸지 않도록 하세요.

구독을 가져오고 현재 활성 설정 확인하기

설정 또는 구독 화면에서 주소 가져오기를 선택하고 알아보기 쉬운 이름을 지정한 뒤 다운로드와 파싱이 완료될 때까지 기다리세요. 가져오기에 성공했는데 노드가 보이지 않으면 전체 설정을 가져온 것인지, 프록시 모음만 가져온 것인지 먼저 확인하세요. 노드만 포함된 내용은 provider 또는 템플릿 지원이 필요할 수 있습니다. 다운로드 완료 메시지가 설정 활성화를 뜻하는 것은 아닙니다. 목록에서 방금 가져온 항목을 선택하고 프록시 페이지에 해당 설정의 정책 그룹이 나타나는지 확인하세요.

규칙 모드로 전환하고 수동 선택 그룹에서 노드를 하나 선택하세요. 자동 테스트 그룹은 테스트 결과에 따라 출구를 바꿀 수 있으므로 처음 문제를 해결할 때는 변수를 줄이기 위해 명확한 수동 선택을 사용하는 것이 좋습니다. 구독 업데이트 후 정책 그룹 이름이 바뀌면 이전 선택이 더 이상 유효하지 않을 수 있습니다. 앱만 다시 시작하지 말고 설정을 다시 확인하세요. 클라이언트에 설정 검사 기능이 있으면 문법 오류와 정책 참조 오류를 먼저 해결한 뒤 시스템 프록시를 켜세요.

시스템 프록시로 브라우저 트래픽 확인하기

클라이언트에서 시스템 프록시를 켠 다음 Windows 설정의 네트워크 및 프록시 페이지에서 수동 프록시가 로컬 루프백 주소와 실제 수신 포트를 가리키는지 확인하세요. 흔히 사용하는 주소는 127.0.0.1이며 포트는 클라이언트 설정에 따릅니다. 루프백 주소는 현재 PC를 가리킵니다. 다른 기기에 입력해도 이 Windows PC를 가리키지 않습니다. LAN 연결 허용을 켜기 전에 접근할 기기와 방화벽 경계를 명확히 정하세요.

브라우저는 인터넷에 연결되지만 터미널에서는 연결되지 않는다면 터미널 도구가 시스템 프록시를 읽지 않는 경우가 많습니다. 아래 명령으로 공개 HTTPS 사이트에 HTTP 프록시를 지정해 테스트할 수 있습니다. 포트는 현재 실제 값으로 바꾸세요. HTTP 응답이 오면 해당 요청이 지정한 경로를 통과했다는 뜻입니다. 프록시 인증 오류나 대상 사이트의 거부 응답이 나오면 요청 경로, 출구, 사이트 정책을 구분해 점검하세요. 성공하지 않았다는 이유만으로 포트 문제라고 단정해서는 안 됩니다.

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

TUN, 루프백 제한, 포트 충돌

시스템 프록시를 따르지 않는 앱의 트래픽까지 처리해야 한다면 클라이언트가 제공하는 서비스 모드와 TUN을 활성화하세요. 서비스 모드는 보통 시스템 권한으로 가상 인터페이스와 라우팅을 관리합니다. 일반 인터페이스를 열 수 있다고 해서 서비스가 설치되거나 실행 중이라는 뜻은 아닙니다. 클라이언트 안내에 따라 한 번 권한을 승인한 뒤 로그에서 가상 인터페이스 생성과 라우팅 설정이 성공했는지 확인하세요. 출처가 불분명한 스크립트에 TUN 테스트를 위해 관리자 권한을 주거나 같은 라우팅을 처리하는 VPN을 동시에 켜지 마세요.

일부 UWP 앱은 루프백 접근이 제한되어 브라우저는 정상인데 로컬 프록시에 연결하지 못할 수 있습니다. 먼저 해당 앱이 시스템 프록시를 실제로 사용하는지 확인한 다음 UWP 루프백 예외 설정 방법을 참고해 대상 앱만 처리하세요. 모든 앱의 접근을 일괄 허용하지 마세요. TUN을 켠 뒤 동작이 달라졌다면 연결 기록에서 요청이 코어로 들어갔는지 확인해 앱의 로그인 또는 인증서 오류를 루프백 문제로 오인하지 않도록 하세요.

포트가 사용 중이면 PowerShell에서 Get-NetTCPConnection -LocalPort 7890 -ErrorAction SilentlyContinue를 실행한 뒤 프로세스 ID로 점유 중인 프로그램을 확인하세요. 이전 클라이언트가 종료된 것을 확인한 후 현재 클라이언트를 실행하세요. 정체를 알 수 없는 시스템 프로세스를 종료하지 마세요. 수신 포트를 바꾸면 시스템 프록시, 브라우저 확장 프로그램, 터미널 변수도 함께 변경해야 합니다. 종료하기 전에 트래픽 적용을 해제하세요. 비정상 종료 후 웹페이지가 모두 연결되지 않으면 먼저 시스템 프록시를 기존 상태로 복구한 뒤 클라이언트를 다시 시작하고 로그를 확인하세요.

03 / MACOS

macOS: 아키텍처, 네트워크 권한, 프록시 복구

칩 종류 확인 후 앱 설치하기

Apple 메뉴의 이 Mac에 관하여를 열어 Apple 칩인지 Intel 프로세서인지 확인한 뒤 macOS 다운로드에서 알맞은 설치 파일을 선택하세요. 우선 권장 클라이언트는 Clash Plus이며, 인터페이스와 기능에 따라 Clash Verge Rev 또는 FlClash를 선택할 수도 있습니다. ClashX Meta는 지원이 종료된 보관용 옵션입니다. 예전 안내의 메뉴 위치와 코어 기능을 현재 클라이언트에 그대로 적용하지 마세요.

디스크 이미지로 설치할 때는 앱을 응용 프로그램 폴더로 드래그한 다음 해당 폴더에서 실행하세요. 마운트된 이미지에서 계속 실행하면 업데이트, 권한 연결, 보조 서비스 경로에 문제가 생길 수 있습니다. 처음 열 때 시스템 보안 알림이 나타나면 먼저 출처와 앱 정보를 확인한 다음 시스템 설정의 개인정보 보호 및 보안 안내에 따라 처리하세요. 앱이 손상되었거나 확인할 수 없다는 오류가 발생하면 먼저 올바른 아키텍처의 파일을 다시 받으세요. 보안 속성을 재귀적으로 제거하는 방법을 모든 오류에 일괄 적용해서는 안 됩니다.

실제 기능에 필요한 권한만 승인하기

시스템 프록시, 특권 보조 서비스, 네트워크 확장은 서로 다른 방식입니다. 일부 클라이언트는 현재 네트워크 서비스의 프록시 설정만 변경하면 됩니다. 일부 TUN 구현은 보조 서비스에 의존하고 다른 앱은 시스템 네트워크 확장을 사용합니다. 클라이언트가 실제로 요청하고 해당 기능에 필요한 권한만 승인하세요. 앱이 사용하지 않는 스위치를 시스템 설정에서 찾을 필요는 없습니다. 권한을 승인한 뒤 앱으로 돌아와 상태를 확인하세요. 변경 사항에 따라 앱을 다시 시작하거나 시스템 안내에 따라 다시 연결해야 할 수 있습니다.

키체인 대화상자는 보통 앱이 자격 증명을 저장하거나 읽으려 할 때 표시됩니다. 허용하기 전에 대화상자의 앱 이름, 키체인 항목, 요청 작업을 확인하세요. 프록시 관련 메시지가 보인다는 이유만으로 모든 암호 접근을 항상 허용으로 설정하지 마세요. 앱을 실행할 때마다 대화상자가 반복되면 앱 이동 여부, 서명 ID 변경 여부, 보조 구성 요소 경로가 여전히 올바른지 확인하세요. 경로별 차이는 macOS 네트워크 확장 및 키체인 권한 안내를 참고하세요.

구독 가져오기 및 네트워크 서비스 확인

클라이언트 설정 화면에서 구독 주소를 추가하고 다운로드가 끝나면 해당 항목을 활성화한 뒤 프록시 페이지에서 정책 그룹을 확인하세요. macOS에서는 메뉴 막대와 기본 창에 연결 상태와 설정 목록이 각각 표시될 수 있으며, 창을 닫아도 앱이 종료되는 것은 아닙니다. 메뉴 막대에서 다른 클라이언트가 여전히 네트워크를 처리하고 있는지 확인하세요. 앞에 보이는 앱과 시스템 프록시를 설정한 앱이 서로 다를 수 있습니다. 규칙 모드에서 노드를 명확히 선택한 다음 대상 사이트를 테스트하세요.

시스템 프록시를 켠 뒤 현재 Wi-Fi 또는 유선 네트워크의 세부 설정에서 프록시 항목을 확인하세요. macOS는 네트워크 서비스별로 설정을 저장하므로 도킹 스테이션 네트워크 카드, 유선 네트워크, 새 Wi-Fi로 전환하면 설정이 달라질 수 있습니다. 아래 명령으로 현재 적용 중인 프록시 정보를 확인할 수 있습니다. 특정 항목 하나만 찾지 말고 활성화 여부, 서버, 포트를 확인하세요. 터미널 도구가 시스템 프록시를 읽지 않는다면 프록시를 직접 지정하거나 프로세스 환경 변수를 설정해야 합니다.

scutil --proxy
networksetup -listallnetworkservices
lsof -nP -iTCP:7890 -sTCP:LISTEN

TUN 및 잠자기 후 복구 방법

더 많은 앱의 트래픽을 처리해야 한다면 클라이언트 절차에 따라 해당 서비스를 설치하거나 시작한 뒤 TUN을 켜세요. 권한 부족, 인터페이스 생성 실패, 라우팅 충돌이 로그에 표시되지 않는지 확인하세요. 회사 기기는 관리 정책의 제한을 받을 수 있으며 시스템 설정에 항목이 보여도 일반 사용자가 변경할 수 있다는 뜻은 아닙니다. 회사 VPN도 함께 사용한다면 라우팅 범위와 사용 요건을 먼저 확인하세요. 트래픽을 강제로 처리하기 위해 기기 관리 설정을 삭제하지 마세요.

잠자기에서 깨어난 뒤 연결되지 않으면 일반 네트워크가 복구됐는지 먼저 확인하고 코어가 계속 실행 중인지, 구독 설정이 활성 상태인지 살펴보세요. Wi-Fi를 전환하면 기본 경로와 DNS가 바뀔 수 있고 기존 연결이 아직 재수립되지 않았을 수도 있습니다. 연결을 중지하고 네트워크가 안정될 때까지 기다린 다음 다시 연결해 새 요청으로 확인하세요. 오래 연결된 웹페이지를 새로 고치는 것만으로 판단하지 마세요. 명시적 프록시는 정상인데 TUN만 실패한다면 모든 설정을 다시 설치하기보다 가상 인터페이스, 라우팅, DNS를 우선 점검하세요.

앱을 제거하거나 옮기기 전에 앱에서 시스템 프록시와 TUN을 끈 다음 클라이언트 안내에 따라 보조 서비스를 제거하세요. 앱이 비정상 종료된 경우 현재 네트워크 서비스에 로컬 프록시 설정이 남아 있는지 확인하고 필요하면 설치 전 상태로 복구하세요. 모든 네트워크 위치나 키체인 항목을 함부로 삭제하지 마세요. 다른 앱에도 영향을 줄 수 있습니다. 일반 인터넷 연결이 복구된 것을 확인한 뒤 새 클라이언트를 설치하고 백업에서 설정을 가져오세요. 문제 원인을 설정과 시스템 연동 중 어느 쪽인지 파악하기 쉽도록 한 번에 한 계층씩 복원하세요.

04 / ANDROID

Android: 구독 형식, VPN 권한, 백그라운드 실행

설치 파일 및 호환 설정 선택하기

Android 다운로드에서 Clash Plus를 우선 확인하세요. 다른 선택지는 Clash Meta for Android, FlClash, Surfboard 순입니다. 다운로드 전에 기기 아키텍처와 앱의 최소 시스템 요구 사항을 확인하세요. 최신 스마트폰 대부분은 ARM64를 사용하지만 구형 기기나 특수 시스템은 겉모습만으로 판단할 수 없습니다. 설치 파일이 호환되지 않는다고 나오면 같은 파일을 반복해서 받지 말고 아키텍처, 시스템, 기존 앱의 서명을 확인하세요.

브라우저나 파일 관리자를 통해 설치하면 해당 출처의 앱 설치를 허용하라는 메시지가 표시될 수 있습니다. 현재 사용하는 출처에만 일시적으로 권한을 부여하고 설치가 끝나면 필요에 따라 해제하세요. 업그레이드 전에 구독 주소와 로컬 설정을 보관하세요. 서명이 달라 기존 앱 위에 설치할 수 없다고 해서 바로 삭제하지 마세요. 앱을 삭제하면 데이터가 사라질 수 있습니다. 같은 이름의 다른 앱을 설치했거나 배포 경로가 달랐는지 먼저 확인한 뒤 백업 상태에 따라 이전 방법을 결정하세요.

클라이언트가 지원하는 설정 형식을 별도로 확인해야 합니다. Clash Plus, Clash Meta for Android, FlClash의 세부 항목 지원 여부는 코어와 구현에 따라 다릅니다. Surfboard는 Clash YAML과 다른 설정 체계를 사용하므로 전체 Clash 설정을 그대로 붙여 넣어도 호환되지 않습니다. 구독 제공업체가 여러 형식을 제공한다면 현재 앱에서 지원한다고 명시된 형식을 선택하세요. 변환 서비스는 구독 정보를 취급할 수 있으므로 출처를 확인한 뒤 사용하세요. 자격 증명이 포함된 주소를 정체를 알 수 없는 웹사이트에 입력하지 마세요.

가져온 뒤 설정을 확인하고 연결하기

설정 또는 프로필 화면에서 원격 주소를 추가하고 다운로드가 끝나면 정책 그룹과 노드가 표시되는지 확인한 뒤 해당 설정을 현재 항목으로 지정하세요. 원격 주소 요청에 성공하더라도 내용이 로그인 페이지, 만료 안내, 오류 HTML이면 파싱에 실패할 수 있습니다. 구독 상태와 오류 요약을 먼저 확인하세요. 휴대폰 브라우저에서 자격 증명이 포함된 주소를 반복해서 공개로 열거나 오류를 피하려고 YAML 구조를 임의로 삭제하지 마세요.

Android에서 처음 연결하면 시스템 VPN 권한 대화상자가 일반적으로 표시됩니다. 방금 설치한 앱에서 요청한 것이 맞는지 확인한 뒤 승인하고 시스템 VPN 상태와 앱 연결 로그를 확인하세요. 여기서 말하는 VPN은 앱이 시스템 인터페이스를 통해 트래픽을 처리하는 방식이며, 특정 프록시 노드에 연결됐다는 뜻은 아닙니다. 상태 표시줄에 VPN 아이콘이 나타나도 정책 그룹이 직접 연결을 선택하거나 노드가 작동하지 않을 수 있습니다. 대상 요청으로 실제 출구를 확인하세요.

앱별 트래픽 분기와 다른 VPN의 관계

Android의 VPN 인터페이스는 일반적으로 여러 일반 VPN 앱이 동시에 사용할 수 없습니다. 회사 VPN, 광고 차단기, VPN 기반 네트워크 도구가 실행 중이면 현재 클라이언트를 시작할 때 기존 연결이 끊길 수 있습니다. 유지할 트래픽 경로를 먼저 정하고 시스템에서 VPN 항상 사용이 설정되어 있는지 확인하세요. 조직 정책으로 해당 항목이 잠겨 있다면 기기 관리 요건을 따르세요. 시스템 네트워크를 초기화해 우회하지 마세요.

앱별 프록시에는 보통 허용 목록과 제외 목록이라는 두 가지 방식이 있습니다. 허용 목록에서는 선택한 앱만 트래픽 처리 대상이 되고, 제외 목록에서는 선택한 앱이 처리 대상에서 빠집니다. 변경 후 현재 모드 설명을 확인하고 대상 앱을 다시 시작해 새 연결을 만드세요. 메신저는 정상인데 브라우저가 안 된다면 노드 문제가 아니라 두 앱이 서로 다른 목록에 포함됐을 수 있습니다. 설정을 변경한 뒤 기존 연결과 새 연결도 구분하세요. 이전 세션은 출구가 바로 바뀌지 않을 수 있습니다.

백그라운드 제한, DNS, 네트워크 전환

화면을 잠근 뒤 한동안 지나 연결이 끊기면 먼저 클라이언트 프로세스가 시스템에 의해 종료됐는지, VPN 상태가 사라졌는지 확인하세요. 휴대폰 제조업체의 배터리 설정에서 필요한 백그라운드 활동과 자동 시작을 허용하세요. 앱이 포그라운드 서비스 알림을 제공한다면 정상 실행에 필요한 조건을 유지하세요. 모든 앱의 절전 제한을 한 번에 해제하지 마세요. 같은 네트워크에서 화면이 켜진 상태, 잠금 상태, 잠금 해제 후 각각 요청을 테스트하고 연결이 끊기는 시점을 기록해 프로세스 관리 문제인지 네트워크 전환 문제인지 구분하세요.

Android의 비공개 DNS, 브라우저 보안 DNS, 클라이언트 DNS는 서로 다른 경로입니다. 도메인 조회에 실패하면 설정을 기록하고 한꺼번에 변경하지 마세요. 엄격한 비공개 DNS를 사용 중인데 해당 서버에 연결할 수 없으면 인터넷 연결에 영향을 줄 수 있습니다. 브라우저가 직접 조회하면 도메인 기반 트래픽 분기 결과도 다르게 보일 수 있습니다. 확인 가능한 기본 상태로 먼저 되돌린 뒤 하나씩 활성화하고 연결 로그에서 도메인과 오류 유형을 확인하세요. 노드 속도 테스트만으로 판단하지 마세요.

Wi-Fi에서 모바일 네트워크로 전환하면 통신사 네트워크, IPv6 경로, UDP 환경이 바뀔 수 있습니다. 먼저 연결을 일시 중지해 기본 네트워크가 정상인지 확인한 뒤 다시 연결하고 새 요청을 테스트하세요. 특정 프로토콜만 실패한다면 서비스 제공업체가 명시적으로 지원하는 다른 노드와 비교하세요. 기록 없이 여러 코어 매개변수를 한꺼번에 변경하지 마세요. 외출 전에 필요한 설정 사본을 보관할 수 있지만 노드 사용 가능 여부는 서비스 상태에 달려 있습니다. 로컬에 설정이 있다고 해서 원격 출구가 항상 연결되는 것은 아닙니다.

05 / IOS

iOS: Clash Plus 설치, 가져오기, 시스템 VPN

앱스토어에서 설치하고 지원 범위 확인하기

iPhone 및 iPad 사용자는 iOS 다운로드에서 Clash Plus를 선택하거나 App Store 페이지를 바로 열 수 있습니다. 클라이언트 공식 웹사이트는 clashplus.io입니다. 설치 전에 App Store 페이지에서 기기 호환성과 시스템 요구 사항을 확인하세요. 설치가 끝나면 앱을 열어 설정과 연결 메뉴를 확인하세요. macOS 메뉴 막대 안내를 그대로 따라 하거나 데스크톱 보조 서비스 절차를 휴대폰에 적용하지 마세요.

iOS의 네트워크 트래픽 처리는 시스템이 제공하는 확장 기능에 의존하므로 앱에서 표시되는 스위치가 데스크톱 클라이언트와 다릅니다. 컴퓨터에서 파싱되는 mihomo 설정이라고 해서 TUN, 파일 경로, 외부 제어, 스크립트 설정이 휴대폰에서도 작동한다고 가정하지 마세요. 가져오기 전에 앱이 지원하는 설정 안내를 확인하세요. 지원되지 않는 항목이 있다면 설정 전체를 무작정 삭제하기보다 구독 제공업체에 호환되는 형식을 요청하세요.

구독 가져오기 및 원격 업데이트

Clash Plus의 설정 또는 구독 메뉴에서 원격 주소를 추가하고 앱 안내에 따라 이름을 지정해 저장하세요. 붙여넣은 뒤 주소의 시작과 끝, 매개변수가 온전한지 확인하세요. 메모 앱이나 메신저에서 복사할 때 줄바꿈이 들어가지 않도록 특히 주의해야 합니다. 다운로드가 끝나면 해당 항목을 선택해 정책 그룹이 표시되는지 확인하고 노드를 선택하세요. 앱이 시스템 공유를 통한 가져오기를 지원하더라도 실제로 불러온 항목을 확인해 같은 이름의 구독이 중복되어 이전 설정으로 연결되지 않도록 하세요.

구독을 업데이트하면 보통 원격 콘텐츠를 다시 다운로드하며 수동 변경 사항이 모두 유지된다는 보장은 없습니다. 처음 연결에 성공하면 설정 이름, 모드, 정책 그룹 선택을 기록하세요. 업데이트 후 그룹이 바뀌면 다시 확인해야 합니다. 구독 주소를 공개 공유 메모나 스크린샷에 저장하지 마세요. 기기를 바꾸기 전에 앱이 지원하는 내보내기 또는 시스템 백업 방법으로 필요한 정보를 보관하고, 백업에 민감한 주소가 포함되는지 확인하세요. 동기화의 편리함이 접근 권한 관리를 대신하지는 않습니다.

VPN 설정 승인 후 실제 트래픽 확인하기

처음 연결하면 시스템에서 VPN 설정 추가를 요청하고 기기 암호나 생체 인증을 요구할 수 있습니다. 앱 이름을 확인한 뒤 승인하고 클라이언트로 돌아와 연결 결과를 기다리세요. 이전에 권한을 거부했다면 다시 연결을 시작하고 현재 시스템 안내에 따라 처리하면 됩니다. 시스템 설정의 VPN 목록에서 설정의 소유 앱을 확인할 수 있지만, 앱 하나를 사용하려고 다른 업무 또는 학습용 VPN 설정을 삭제하지 마세요.

VPN 아이콘은 관련 연결 상태가 있음을 보여줄 뿐 대상 사이트가 선택한 프록시를 거친다는 보장은 아닙니다. 먼저 규칙 모드에서 노드를 명확히 선택하고 새 웹페이지를 연 다음 클라이언트 연결 기록에서 도메인과 정책을 찾으세요. DIRECT에 매칭되면 규칙이 직접 연결을 선택한 것입니다. 프록시 정책으로 들어갔는데 시간이 초과되면 출구와 대상 사이트를 확인하세요. 처음 테스트할 때는 일반 브라우저 페이지를 사용하고 로그인 캐시, 앱스토어 세션, 푸시 연결만으로 판단하지 마세요.

Wi-Fi 프록시와 네트워크 확장 설정을 혼용하지 않기

iOS의 Wi-Fi 세부 정보에는 HTTP 프록시 설정이 있지만 클라이언트가 설정하는 VPN 확장과는 별개의 경로입니다. 과거에 로컬 또는 LAN 프록시를 수동으로 입력했다면 먼저 기록하고 아직 적용 중인지 확인하세요. 모바일 네트워크는 특정 Wi-Fi의 수동 프록시 설정을 이어받지 않으므로 Wi-Fi에서는 되지만 셀룰러에서는 안 되는 문제를 각각 진단해야 합니다. 처음 문제를 해결할 때는 필요한 경로 하나만 남겨 중복 적용을 줄이세요.

같은 기기의 다른 VPN 설정, 콘텐츠 필터링 도구, 기기 관리 정책도 연결에 영향을 줄 수 있습니다. 연결 직후 다른 도구로 바뀐다면 시스템 VPN 상태와 관련 도구의 자동 연결 설정을 먼저 확인한 뒤 유지할 항목을 결정하세요. 앱에 온디맨드 연결 기능이 있다면 수동 연결이 안정된 뒤 활성화하고 트리거 조건을 확인하세요. 아직 검증되지 않은 설정에서 모든 자동 재연결 옵션을 켜 편의성을 우선하지 마세요.

화면 잠금, 네트워크 전환, 모바일 문제 해결

iOS 앱 인터페이스와 네트워크 확장은 수명 주기가 다릅니다. 앱을 백그라운드로 보냈다고 확장이 반드시 중지되는 것은 아니며, 앱 화면이 계속 보인다고 확장이 정상이라는 보장도 없습니다. 화면을 잠그거나 네트워크를 전환한 뒤 연결되지 않으면 먼저 기본 네트워크를 확인하고 클라이언트에서 연결 상태와 최근 로그를 살펴보세요. 앱을 반복해서 강제 종료하는 것을 정기적인 해결 방법으로 삼지 마세요. 강제 종료로 현재 상태가 달라져 문제가 재현되지 않을 수 있습니다.

셀룰러 연결 문제는 앱의 셀룰러 데이터 사용 허용 여부, 요금제 네트워크 상태, 노드의 현재 네트워크 지원 여부를 확인하세요. 특정 앱만 문제가 있다면 브라우저는 정상인지 비교하고 도메인 규칙과 대상 서비스 제한을 점검하세요. 로그에 DNS 오류가 있으면 먼저 이름 해석을 해결하고, 연결 시간 초과라면 출구를 확인하세요. 인증서 오류가 있으면 기기 시간과 대상 사이트 인증서를 점검해야 하며 인증서 검사를 무시해 해결하려 해서는 안 됩니다. 클라이언트를 끊은 뒤에도 문제가 계속되면 Wi-Fi에 남아 있는 프록시 설정과 다른 VPN 상태를 확인하세요.

06 / LINUX

Linux: 패키지, 세션 프록시, 코어 서비스

데스크톱 클라이언트와 독립형 코어 구분하기

데스크톱 사용자는 Linux 다운로드에서 Clash Verge Rev를 우선 고려하고 FlClash를 선택할 수도 있습니다. 배포판의 패키지 관리 체계에 맞는 설치 형식을 고른 뒤 프로세서 아키텍처를 확인하세요. Debian 계열과 RPM 계열 패키지는 확장자만 바꿔 서로 사용할 수 없습니다. 다운로드 페이지에 원하는 조합이 없다면 다른 아키텍처 파일도 실행될 것이라고 가정하지 마세요. 독립형 Mihomo는 명령줄, 서버, 라우터 배포가 필요한 사용자를 위한 선택입니다.

데스크톱 소프트웨어를 설치하기 전에 패키지 관리자의 의존성 안내를 읽으세요. 그래픽 실행 환경이 없다는 문제를 의존성을 강제로 무시해 해결하려 하지 마세요. 최소 구성 서버에는 완전한 데스크톱 세션이 없는 경우가 많으며 GUI 앱을 설치해도 백그라운드 서비스 용도로 적합하지 않습니다. 설치가 끝나면 일반 사용자로 GUI를 실행해 구독 디렉터리에 쓸 수 있는지, 설정을 불러올 수 있는지 확인하세요. TUN 또는 서비스 작업에 필요한 경우에만 클라이언트 절차에 따라 권한을 부여하세요.

설정을 가져오고 데스크톱 환경 프록시 확인하기

GUI 클라이언트에서 구독 주소를 추가하고 다운로드 후 설정을 활성화한 다음 프록시 페이지에서 노드를 선택하세요. Linux 데스크톱 시스템 프록시는 GNOME, KDE 등의 설정 방식에 의존합니다. 스위치가 데스크톱 설정에 반영됐다고 해서 모든 앱이 이를 읽는 것은 아닙니다. 샌드박스 앱, 브라우저, 터미널은 각각 다른 경로를 사용할 수 있습니다. 먼저 프록시를 직접 지정해 코어가 요청을 수신하는지 확인한 뒤 데스크톱 설정이 전달되는 단계에서 문제가 생겼는지 판단하세요. 처음부터 TUN을 조정하지 마세요.

아래 환경 변수는 현재 셸과 이후 실행되는 하위 프로세스에만 적용되며 이미 실행 중인 프로그램에는 소급 적용되지 않습니다. 포트는 클라이언트와 일치해야 합니다. no_proxy는 로컬 연결을 프록시에서 제외할 때 사용하며 실제 제외 항목은 앱 지원 여부에 따라 설정하세요. 테스트가 끝나면 터미널을 닫거나 변수를 제거하면 됩니다. 테스트 값을 전역 시작 파일에 바로 넣지 마세요. 클라이언트가 실행되지 않았을 때 이 변수를 사용하는 패키지 관리자와 개발 도구의 연결이 모두 실패할 수 있습니다.

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,::1
curl --head https://example.com/
unset http_proxy https_proxy no_proxy

독립형 코어는 먼저 확인한 뒤 실행하기

독립형 Mihomo를 사용할 때는 다운로드 페이지의 코어 항목에서 플랫폼과 아키텍처를 선택하세요. 압축을 푼 뒤 관리되는 디렉터리에 넣고 실행 권한을 설정합니다. 설정 디렉터리와 config.yaml을 준비하고 실행 계정에 설정 읽기 및 필요한 캐시 쓰기 권한이 있는지 확인하세요. 아래 명령은 실행 파일 이름이 mihomo이고 설정이 현재 사용자의 지정 디렉터리에 있다고 가정합니다. 먼저 설정을 검사하고 전면 실행으로 오류를 확인하세요. 안정적으로 작동하는 것을 확인한 뒤에만 서비스로 구성하세요.

chmod u+x ./mihomo
./mihomo -t -d "$HOME/.config/mihomo"
./mihomo -d "$HOME/.config/mihomo"

설정 검사를 통과했다는 것은 정적 구조와 관련 검사를 통과했다는 뜻일 뿐 원격 노드의 온라인 상태, 규칙 리소스 다운로드, 시스템 라우팅 설정 성공을 보장하지 않습니다. 전면 실행 후 수신 주소, 포트, 설정 로드 결과를 확인하고 프록시를 직접 지정해 요청을 보내세요. 서비스로 구성할 때는 절대 경로를 사용하고 실행 계정, 작업 디렉터리, 설정 디렉터리를 명확히 지정해야 합니다. 대화형 터미널의 환경 변수는 시스템 서비스로 자동 전달되지 않으며 데스크톱 계정의 홈 디렉터리와 서비스 프로세스의 홈 디렉터리는 다를 수 있습니다.

TUN, DNS, 권한 제어

TUN은 일반적으로 /dev/net/tun에 접근하고 네트워크를 설정할 권한이 필요합니다. 컨테이너, 제한된 호스트, 라우터 펌웨어에서는 같은 조건을 제공하지 않을 수 있습니다. 장치가 없거나 작업이 허용되지 않는다는 오류가 발생하면 먼저 호스트 환경이 지원되는지 확인하세요. DNS를 계속 바꿔 권한 문제를 해결하려 하지 마세요. 클라이언트가 지원하는 서비스 방식을 우선 사용하세요. 직접 서비스를 작성한다면 최소 권한 원칙을 검토해야 합니다. 그래픽 세션 전체를 root로 실행하는 방식은 표준 해결책이 아닙니다.

Linux에서는 NetworkManager, systemd-resolved, 로컬 DNS 서비스가 함께 작동할 수 있습니다. DNS를 처리하기 전에 수신 프로세스와 이름 해석 경로를 확인하세요. /etc/resolv.conf는 시스템이 관리하며 로컬 스텁을 가리킬 수 있으므로 바로 덮어쓰지 마세요. 변경 직후에는 잠시 정상인데 네트워크를 다시 연결한 뒤 실패한다면 관리 서비스가 파일을 다시 작성했을 가능성이 큽니다. 기존 설정을 보관하고 어느 계층이 이름 해석을 관리하는지 확인한 다음 클라이언트 지원 방식에 맞춰 통합하세요.

포트를 진단할 때는 ss -lntp, 라우팅을 확인할 때는 ip route를 사용할 수 있습니다. 다른 사용자의 프로세스 정보를 보려면 추가 권한이 필요할 수 있습니다. 프록시 포트나 제어 인터페이스를 모든 주소에 바인딩한 뒤 인터넷에 그대로 노출하지 마세요. 종료하거나 제거할 때는 서비스를 먼저 중지하고 프록시 환경 변수를 해제한 뒤 트래픽 적용 라우팅을 복구하고 일반 연결을 확인하세요. 시스템 프록시는 정상인데 특정 터미널 프로그램만 실패한다면 해당 프로그램 자체의 프록시 설정도 확인해야 합니다. 세션 설정 문제를 코어 오류로 오인하지 마세요.

07 / CONFIGURATION & DIAGNOSTICS

설정 관련 자주 묻는 질문: 요청 경로를 따라 단계별 진단

설정 파싱 성공이 사용 가능한 출구를 뜻하지는 않습니다

YAML은 공백으로 계층을 표현하고 목록 항목에는 하이픈을 유지해야 합니다. 탭을 섞어 쓰지 마세요. 설정 조각을 병합하기 전에 기존 최상위 키를 확인하세요. rules 또는 proxy-groups를 두 번 작성하면 앞선 내용이 덮어써지거나 설정이 거부될 수 있습니다. 정책 그룹에서 참조하는 이름이 실제로 존재하는지, 대소문자와 문장부호가 일치하는지도 확인하세요. 아래는 mihomo에서 사용할 수 있는 최소 직접 연결 진단 설정입니다. 수신, 모드, 규칙 체인만 확인하며 원격 프록시 노드는 포함하지 않으므로 프록시 서비스가 사용 가능한지 판단하는 데 사용할 수 없습니다.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxy-groups:
  - name: CHECK
    type: select
    proxies:
      - DIRECT
rules:
  - MATCH,CHECK

이 설정으로 프록시를 직접 지정한 요청이 성공하지만 기존 구독에서는 실패한다면 원래 설정의 노드, 그룹 참조, 규칙 리소스를 확인하세요. 로컬 수신 포트에도 접근할 수 없다면 프로세스, 포트, 방화벽부터 점검해야 합니다. 유일한 구독 파일을 진단 설정으로 덮어쓰지 말고 새 로컬 항목을 만들어 원본을 보관하세요. 진단 후 원래 설정으로 돌아가 현재 활성 항목을 다시 확인하세요. 순수 직접 연결 테스트 설정을 프록시 연결로 착각하지 않도록 주의해야 합니다.

구독 실패와 규칙 미적용 구분하기

구독 다운로드 실패는 오류 유형별로 확인하세요. 연결 실패라면 기본 네트워크와 구독 도메인을 점검하고, 인증 실패라면 주소의 자격 증명과 서비스 상태를 확인하세요. 다운로드는 성공했지만 파싱에 실패하면 응답 내용과 형식을 살펴보세요. 일부 구독 주소는 기존 프록시가 있어야 접근할 수 있는데 프록시는 해당 구독에 의존해 시작하지 못하는 경우가 있습니다. 서비스 제공업체에 접속 가능한 주소를 요청하거나 이전에 유효했던 로컬 백업을 사용하세요. 노드가 없는 상태에서 전역 모드를 반복해서 켠다고 자동으로 해결되지는 않습니다.

규칙은 순서대로 매칭되므로 범위가 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 도메인 규칙을 추가할 때 브라우저 주소창의 주소만 복사하지 말고 실제 요청 도메인을 확인하세요. 로그인, 이미지, API가 서로 다른 도메인에 있을 수 있습니다. 연결 기록에 표시된 매칭 규칙과 정책 체인을 근거로 확인하세요. GeoIP 데이터가 필요한 규칙은 리소스 로드에도 의존합니다. 데이터베이스 형식과 업데이트 경로는 현재 코어에 맞춰야 하며 예전 안내의 파일 이름과 디렉터리를 혼용하지 마세요.

자동 정책 그룹의 테스트 결과는 테스트 주소, 간격, 네트워크 상태에도 영향을 받습니다. url-test는 주로 테스트 결과를 기준으로 선택하고, fallback은 순서에 따른 사용 가능 여부를 확인하며, load-balance는 알고리즘에 따라 연결을 분배합니다. 세 가지는 서로 다른 프록시 프로토콜이 아닙니다. 노드가 자주 바뀐다면 먼저 서비스에 고정 출구가 필요한지 확인한 뒤 정책을 조정하세요. 자세한 항목은 자동 정책 그룹 비교 및 설정 방법을 참고하세요.

진입 경로부터 이름 해석, 출구, 대상 사이트까지

DNS 관련 설정에서는 특히 순환 참조를 피해야 합니다. 코어가 업스트림 DNS를 요청하는데 해당 업스트림 연결이 아직 해석되지 않은 프록시 서버 도메인에 의존하면 시작하지 못할 수 있습니다. 설정에 따라 프록시 서버용 DNS를 별도로 지정해 의존성을 처리할 수 있으며, 구체적인 항목은 실제 코어에 맞춰야 합니다. fake-ip를 활성화한 경우 시스템에서 조회한 합성 주소를 실제 공인 IP로 간주해 공유하거나 고정 규칙에 넣지 마세요. 앱 호환성 문제는 임의로 DNS 설정 전체를 바꾸기보다 명확한 필터 정책으로 진단하세요.

TCP는 정상인데 게임, 음성 통화 또는 다른 UDP 서비스가 실패한다면 먼저 노드 프로토콜, 서버, 클라이언트가 필요한 UDP 경로를 모두 지원하는지 확인한 다음 실제 트래픽이 처리되고 있는지 점검하세요. TUN을 켜도 원래 지원하지 않는 출구에 UDP 기능이 추가되지는 않습니다. IPv6도 시스템, 코어, DNS, 출구의 네 계층을 함께 확인해야 합니다. 한 계층만 끄면 결과가 서로 달라질 수 있습니다. 변경할 때마다 새 연결로 테스트하고 필요하면 앱의 정상적인 종료 절차에 따라 기존 세션을 끝내세요.

기록 보관 및 안전한 원상 복구

문제 발생 시 로그 수준을 임시로 높이고 발생 시각, 대상 도메인, 매칭 규칙, 오류 요약을 기록한 뒤 재현이 끝나면 일반 수준으로 되돌리세요. 문제를 제출하기 전에 구독 자격 증명, 서버 인증 정보, 불필요한 접근 기록을 가리세요. 시스템, 클라이언트, 코어, 모드, 트래픽 적용 방식을 함께 설명하면 연결 실패 화면 한 장보다 원인을 파악하기 쉽습니다. 인터페이스 영역의 의미가 명확하지 않다면 프록시·설정·로그 페이지 빠르게 살펴보기를 먼저 읽어 보세요.

변경 사항은 역순으로 되돌리세요. TUN을 중지하고 시스템 프록시를 끈 다음 임시 환경 변수를 해제하고 일반 네트워크를 확인합니다. 기본 네트워크가 복구되면 설정, 수동 출구, 시스템 프록시를 차례로 복원하고 마지막에 TUN과 자동 정책을 테스트하세요. 한 번에 하나의 항목만 바꾸고 결과를 기록해야 합니다. 전체 설정 절차를 다시 따라가려면 빠른 시작 가이드로 돌아가세요. 클라이언트를 바꾸려면 다운로드 페이지에서 지원 범위와 설치 요건을 먼저 확인하세요. 클라이언트 이전으로 문제 진단을 건너뛰어서는 안 됩니다.