전 플랫폼 가이드 · 설치 및 설정 안내

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

기기별 설치 절차와 네트워크 단계별 연결 문제 해결 방법을 확인하세요. 이 페이지에서는 플랫폼별 차이와 권한 범위, 설정을 설명합니다. 먼저 연결을 한 번 설정하려면 빠른 시작 가이드부터 진행한 다음, 해당 장에서 세부 내용을 확인하세요.

클라이언트 선택 구독 및 설정 시스템 프록시 및 TUN

1. Clash 설치 전 공통 준비

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

클라이언트는 인터페이스를 제공하고 설정을 저장하며 코어를 실행하고 시스템 권한을 요청합니다. 코어는 규칙을 해석하고 프록시 연결을 구성하며 DNS를 처리합니다. 구독은 설정을 전달하는 방식으로, 일반적으로 노드와 정책 그룹, 규칙을 포함하지만 프록시 목록만 제공하기도 합니다. 이 셋은 서로 다른 요소입니다. 클라이언트를 설치해도 프록시가 자동으로 제공되지는 않으며, 링크를 가져왔다고 해서 현재 코어가 모든 항목을 지원하는 것도 아닙니다.

새로 설치한다면 설치 파일 페이지에서 Clash Plus를 먼저 선택한 다음 필요에 따라 다른 클라이언트와 비교하세요. Clash for Windows는 지원이 종료되었으므로 기존 환경을 위한 자료로만 참고하는 것이 좋습니다. 예전 사용법에 익숙하다는 이유로 유지 관리 상태를 간과하지 마세요. 클라이언트마다 버튼 이름은 다를 수 있습니다. 이 가이드에서는 ‘설정 관리, 정책 선택, 트래픽 연결’을 기준으로 설명하므로 Profiles, Proxies 같은 영문 메뉴는 현재 인터페이스에서 이에 해당하는 항목을 찾으면 됩니다.

기기 아키텍처와 설정 출처 확인

다운로드하기 전에 운영체제, 프로세서 아키텍처, 소프트웨어 요구 사항을 확인하세요. 데스크톱 기기는 브랜드만으로 아키텍처를 판단할 수 없고, 휴대전화도 Android 버전만으로 설치 파일 유형을 알 수 없습니다. 설치 파일 페이지에서 기기 정보에 맞는 플랫폼 및 아키텍처를 선택하세요. 기존 클라이언트를 업그레이드하기 전에는 클라이언트 이름, 설정 출처, 트래픽 연결 방식을 기록하고 보존할 설정을 내보내세요. 그래야 이전 과정의 문제를 네트워크 문제로 오인하지 않습니다.

구독 링크에는 계정 접근 정보가 포함될 수 있으므로 본인의 서비스 계정에서 확인하세요. 링크 전체를 공개 댓글, 스크린샷 또는 로그 공유 페이지에 올리지 마세요. 가져오기 전에 서비스 안내에서 Clash 또는 대상 클라이언트와 호환되는 형식을 제공하는지 확인하세요. 일반 웹 주소나 로그인 페이지, 다른 소프트웨어 전용 링크는 사용할 수 없습니다. 서비스 이용 기간 만료, 요금제 데이터 소진, 링크 재설정도 가져오기나 노드 연결 실패의 원인이 될 수 있으며, 클라이언트를 다시 설치해도 해결되지 않습니다.

세 가지 트래픽 연결 방식의 범위 이해하기

방식적용 대상주의 사항
시스템 프록시시스템 프록시 설정을 따르는 앱모든 프로그램이 사용하는 것은 아님
명시적 프록시프록시 주소를 직접 설정할 수 있는 개별 프로그램주소, 포트, 프록시 프로토콜이 일치해야 함
TUN가상 네트워크 인터페이스와 라우팅으로 연결하는 트래픽권한, 라우팅, DNS 설정이 함께 필요

처음 설정할 때는 더 단순한 방식부터 사용하세요. 데스크톱에서는 로컬 프록시 포트와 시스템 프록시를 먼저 확인하고, 시스템 프록시를 따르지 않는 앱이 있을 때 TUN을 고려하세요. 모바일 기기는 일반적으로 시스템 VPN 인터페이스를 통해 트래픽을 연결합니다. VPN 표시는 로컬 트래픽 연결이 설정되었다는 뜻이지, 클라이언트가 원격 서비스를 자동으로 제공한다는 의미는 아닙니다. TUN 자체는 프록시 모드가 아닙니다. TUN을 켠 뒤에도 Rule, Global, Direct 중 어떤 정책을 사용할지 설정해야 합니다.

정해진 순서에 따라 첫 연결 확인하기

권장 순서는 클라이언트 설치 및 실행, 설정 가져오기, 설정 선택, 정책 그룹 확인, 연결 방식 하나 활성화, 실제 앱으로 테스트입니다. 각 단계에서 확인 가능한 결과를 남기세요. 설정 이름이 표시되고, 정책 그룹을 선택할 수 있으며, 코어가 정상 작동하고, 연결 기록에서 요청을 찾을 수 있어야 합니다. 트레이 아이콘이나 시스템 VPN 표시만으로 원격 연결 성공을 판단할 수 없습니다. 성공률을 높이겠다며 클라이언트를 여러 개 동시에 실행하지 마세요.

테스트할 때는 먼저 평소 직접 접속할 수 있는 사이트를 열어 기본 네트워크가 정상인지 확인한 다음 프록시가 필요한 대상에 접속하세요. 이어서 요청에 어떤 규칙과 정책이 적용되었는지 확인합니다. 정책을 선택했다고 도메인 이름이 정상적으로 해석되는 것은 아니며, 브라우저에서 접속된다고 명령줄에서도 프록시를 사용한다는 뜻은 아닙니다. 각 단계를 따로 확인하면 문제 범위를 좁힐 수 있고, 연결 실패 때마다 DNS, 포트, 노드를 한꺼번에 바꾸는 일을 피할 수 있습니다.

클라이언트를 종료하기 전에 클라이언트가 설정한 시스템 프록시나 트래픽 연결을 먼저 해제하세요. 특히 다른 클라이언트로 바꾸려는 경우에는 반드시 확인해야 합니다. 정상 작동할 때의 포트, 정책, 연결 방식 기록은 노드 목록 전체를 캡처한 이미지보다 문제 해결에 더 유용합니다. 이후 장에서도 같은 확인 절차를 따르며, 플랫폼별 설치와 권한, 백그라운드 실행 차이를 추가로 설명합니다.

2. Windows 설치, 시스템 프록시, TUN

설치 파일 선택 및 첫 실행

Windows 설치 파일에서는 Clash Plus를 먼저 선택하세요. 다른 선택지로는 Clash Verge Rev, FlClash, Clash Nyanpasu가 있습니다. Clash for Windows는 지원이 종료된 보관용 클라이언트로 남겨 두었습니다. 먼저 ‘설정 → 시스템 → 시스템 정보’에서 시스템 유형을 확인한 다음 다운로드 페이지에 표시된 아키텍처에 맞는 파일을 선택하세요. x64와 ARM64는 서로 바꿔 쓸 수 있는 이름이 아닙니다.

설치 프로그램은 안내에 따라 설치하세요. 압축 파일은 고정된 디렉터리에 먼저 풀고 주 프로그램을 실행해야 하며, 압축 프로그램의 임시 디렉터리에서 바로 실행하지 마세요. 처음 실행할 때 보안 경고가 표시되면 파일 출처와 게시자 정보를 확인하세요. 시스템 보호 기능을 전부 끄는 것은 해결 방법이 아닙니다. 일반적인 인터페이스 사용에는 항상 관리자 권한이 필요한 것은 아니지만, 서비스 설치, 가상 네트워크 카드, 라우팅 변경에는 별도의 권한이 필요할 수 있습니다.

구독 가져오기 및 현재 설정 확인

설정 관리 페이지를 열고 서비스에서 제공한 구독 주소를 붙여 넣어 가져오세요. Clash for Windows에서는 Profiles의 다운로드 메뉴에 해당합니다. 가져온 뒤 해당 설정을 선택하고 코어가 로드될 때까지 기다리세요. 설정 이름만 표시되고 정책 그룹이 없다면 파싱 로그를 확인하세요. 응답 내용이 로그인 페이지는 아닌지, 프록시 목록만 들어 있는데 완전한 설정으로 사용하려는 것은 아닌지 확인해야 합니다. 오류를 확인하지 않은 채 가져오기 버튼을 계속 누르지 마세요.

프록시 또는 정책 그룹 페이지로 이동해 일상적인 사용에는 보통 규칙 모드를 선택한 다음, 수동 선택 그룹에서 사용할 수 있는 정책을 지정하세요. 자동 정책 그룹의 결과는 설정에 정의된 테스트 주소와 매개변수에 따라 달라지며, 실제 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 대상 앱을 열고 연결 기록으로 돌아와 적용된 규칙과 연결 경로를 확인하세요. 새 기록이 없다면 노드를 바로 바꾸지 말고 앱이 로컬 프록시에 연결되고 있는지 먼저 살펴보세요.

시스템 프록시로 로컬 포트를 먼저 확인

클라이언트에 표시된 HTTP 또는 mixed 수신 포트를 확인한 뒤 System Proxy를 켜세요. 예시로 자주 나오는 7890은 모든 클라이언트에 고정된 값이 아닙니다. 현재 설정을 기준으로 하세요. Windows 시스템 프록시, 브라우저 자체 프록시 확장 프로그램, 앱별 프록시가 동시에 작동할 수 있으므로 테스트할 때는 명확한 연결 방식을 하나만 사용하세요. LAN 액세스 허용은 이 기기에서 인터넷을 사용하는 데 필요하지 않습니다. 공유할 일이 없다면 꺼 두세요.

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

위 명령은 로컬 수신 포트가 실제로 7890이고 HTTP 프록시를 지원할 때만 사용하세요. 프록시를 명시적으로 지정하므로 앱이 시스템 설정을 읽는지 여부에 영향을 받지 않습니다. 로컬 포트에 연결할 수 없다는 메시지가 나오면 코어 실행 여부, 수신 주소, 포트 사용 중 여부를 확인하세요. 로컬 프록시까지 연결되지만 원격 연결이 실패한다면 정책, 서비스 상태, DNS를 확인하세요. 터미널이 시스템 프록시를 자동으로 사용하는지는 도구에 따라 다릅니다.

TUN이 필요할 때만 서비스와 권한 확인

대상 앱이 시스템 프록시를 따르지 않거나 특정 UDP 트래픽을 연결해야 할 때 클라이언트 안내에 따라 서비스를 설치하고 TUN을 켜세요. 구버전 Clash for Windows에서는 Service Mode와 TUN Mode를 각각 확인해야 하며, 다른 클라이언트도 고유한 서비스 방식을 사용할 수 있습니다. 권한을 승인한 뒤 가상 인터페이스, 라우팅, DNS 설정이 적용되었는지 확인하세요. 스위치가 켜졌다는 표시만으로 실제 연결을 확인할 수는 없습니다.

기업 VPN, 가상 머신 네트워크, 컨테이너 네트워크, 기타 프록시가 라우팅을 바꿀 수 있습니다. TUN을 켠 뒤 LAN 기기에 연결할 수 없다면 먼저 TUN을 끄고 비교 테스트한 다음 사설 네트워크 우회 설정과 기존 라우팅을 확인하세요. 정체를 모르는 가상 네트워크 카드를 바로 삭제하지 마세요. 절전 모드에서 깨어난 뒤 연결이 끊기면 먼저 코어를 다시 시작하고 트래픽 연결을 다시 활성화하세요. 문제가 반복되면 로그에서 인터페이스 변경을 확인하세요.

종료 후 남은 설정 및 구형 클라이언트 이전 처리

클라이언트가 비정상적으로 종료된 뒤 브라우저에 프록시 서버에 연결할 수 없다는 메시지가 표시되면 Windows의 ‘네트워크 및 인터넷’ 프록시 설정을 열어 중지된 로컬 포트를 계속 가리키는지 확인하세요. 먼저 시스템 네트워크를 복구한 뒤 클라이언트를 다시 시작하세요. ‘자동으로 설정 검색’, ‘설정 스크립트’, ‘수동 프록시’를 무작정 바꾸지 마세요. 원래 값을 기록하고, 특히 조직에서 관리하는 기기의 설정을 덮어쓰지 않도록 주의하세요.

Clash for Windows에서 이전할 때는 원본 구독을 다시 가져온 뒤 규칙과 덮어쓰기를 하나씩 옮기는 것이 좋습니다. 새 클라이언트의 데이터 디렉터리를 그대로 덮어쓰지 마세요. 코어 차이로 구형 설정 항목이 작동하지 않을 수 있고 TUN 매개변수도 달라질 수 있습니다. 새 클라이언트가 기본 연결 방식으로 작동하는지 먼저 확인한 다음 시작 프로그램 등록 같은 편의 설정을 복구하세요. 두 클라이언트를 장기간 함께 보관할 때는 한 번에 하나만 시스템 프록시나 TUN을 담당하도록 하세요.

3. macOS 설치, 권한 승인, 네트워크 확장

칩 종류에 맞는 클라이언트 선택

Apple 메뉴의 ‘이 Mac에 관하여’를 열어 Apple Silicon인지 Intel 프로세서인지 확인한 다음 macOS 설치 파일에서 맞는 빌드를 선택하세요. Clash Plus를 우선 추천하며 Clash Verge Rev와 FlClash도 선택할 수 있습니다. ClashX Meta는 지원이 종료된 보관용 클라이언트입니다. 오래된 문서에 특정 인터페이스가 나온다고 해서 설치 절차를 모든 클라이언트에 그대로 적용하지 마세요.

다운로드한 파일이 디스크 이미지라면 열어서 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 디스크 이미지나 임시 다운로드 폴더에서 바로 실행하면 업데이트, 보조 구성 요소 경로, 권한 기록에 문제가 생길 수 있습니다. 처음 실행할 때 시스템이 차단하면 다운로드 출처와 앱을 먼저 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에 표시된 안내를 살펴보세요. 권한을 재귀적으로 변경하거나 시스템 보안 기능을 끄는 명령부터 실행하지 마세요.

프록시 권한, 보조 서비스, 네트워크 확장 구분

macOS 클라이언트는 네트워크 프록시 변경, 보조 서비스 설치, 네트워크 확장 추가를 요청할 수 있습니다. 각각 다른 기능이며 모든 클라이언트가 전부 사용하는 것은 아닙니다. 시스템 프록시만 사용할 때와 TUN을 실행할 때 필요한 권한은 다를 수 있습니다. 권한 요청 창은 관련 작업 직후 표시되고 앱 이름과 일치해야 합니다. 출처가 불분명한 창은 취소한 다음 클라이언트로 돌아가 작업을 다시 수행해 요청이 어디에서 발생하는지 확인하세요.

네트워크 확장을 승인하는 위치는 시스템 버전과 클라이언트 구현에 따라 달라질 수 있습니다. 앱 안내에 따라 시스템 설정에서 확인하세요. 승인 후 서비스를 다시 연결하거나 앱을 재시작해야 할 수도 있습니다. ‘확장 허용됨’과 ‘프록시 연결됨’은 같은 뜻이 아닙니다. 관리되는 컴퓨터에서는 구성 프로파일이 네트워크 확장을 제한할 수 있으므로 기기 관리 정책을 따르세요. 권한을 우회하려고 설치를 반복하지 마세요.

설정을 가져오고 정책 선택 확인

설정 페이지에서 구독 링크를 추가하고 가져온 뒤 사용할 설정을 명확하게 선택하세요. 클라이언트가 원격 구독과 로컬 파일을 모두 지원한다면 현재 어떤 설정을 편집하는지 먼저 확인하세요. 로컬 파일을 수정해도 다른 원격 설정이 계속 실행될 수 있습니다. 가져온 다음 정책 그룹이 표시되는지, 규칙 모드가 선택되었는지 확인하고 사용할 수 있는 정책을 선택하세요. 구독 업데이트에 실패했을 때 기존 설정을 보존하면 기존 연결 문제와 업데이트 요청 문제를 구분하기 쉽습니다.

테스트할 때는 먼저 브라우저에서 대상을 열고 연결 기록을 확인하세요. 일부 앱은 자체 네트워크 설정을 갖고 있고 브라우저 확장 프로그램이 시스템 프록시를 덮어쓸 수도 있습니다. 브라우저는 연결되지만 터미널은 연결되지 않는다면 명령에 프록시를 명시해 테스트하세요. 특정 앱만 실패하면 해당 앱의 프록시, 인증서, 네트워크 권한을 확인하세요. 앱 하나가 실패했다고 시스템 DNS나 모든 네트워크 서비스의 순서를 바로 바꾸지 마세요.

시스템 프록시와 TUN을 따로 테스트

시스템 프록시를 켠 뒤 현재 네트워크 서비스의 프록시 설정에서 대상 주소와 포트를 확인하세요. Wi-Fi, 유선 네트워크 카드, 도킹 스테이션을 바꾸면 활성 네트워크 서비스가 달라질 수 있으며, 기존 프록시 설정이 새 서비스에는 적용되지 않을 수 있습니다. 클라이언트 스위치만 보지 말고 현재 네트워크를 다시 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에 적용되며 모든 프로세스와 프로토콜을 연결한다고 보장할 수 없습니다.

TUN을 켜기 전에 라우팅을 담당하는 다른 도구를 끄고 클라이언트의 보조 서비스나 확장이 정상 작동하는지 확인하세요. TUN이 작동하지 않으면 먼저 TUN을 끈 상태의 네트워크와 비교한 다음 DNS 및 라우팅 로그를 살펴보세요. 원격 데스크톱, LAN 프린터, 네트워크 저장소에 문제가 생기면 LAN 우회와 사설 주소 규칙을 확인하세요. 사이트 하나를 열기 위해 모든 로컬 네트워크를 원격 프록시로 보내지 마세요.

앱 오류 및 네트워크 전환 처리

‘앱이 손상되었습니다’라는 메시지만으로 실제 파일이 손상되었거나 안전하지 않다고 단정할 수는 없습니다. 먼저 아키텍처를 잘못 선택했는지, 다운로드가 완료되었는지, 확인된 출처의 앱인지 확인한 다음 개발자 공지를 살펴보세요. 격리 속성이나 시스템 확장에 관련된 작업은 적용 범위를 먼저 이해해야 합니다. 권한 처리 방법은 macOS 네트워크 확장 및 키체인 설정을 참고하세요. 인터넷에서 찾은 한 줄 명령을 모든 경고의 해결책으로 사용하지 마세요.

업그레이드하거나 이전하기 전에 설정과 사용자 지정 덮어쓰기를 내보내세요. 클라이언트를 바꿀 때는 이전 클라이언트의 시스템 프록시와 트래픽 연결을 끈 뒤 새 클라이언트를 활성화하세요. 덮개를 닫았다 열거나 핫스팟을 바꾸거나 회사 네트워크에 연결한 뒤에는 기본 네트워크와 포털 인증이 완료되었는지 먼저 확인하세요. 필요한 경우 인증을 위해 프록시를 잠시 끊었다가 다시 연결하세요. 네트워크 접속이 아직 허용되지 않은 상황을 구독 노드 문제로 오인하지 않도록 할 수 있습니다.

4. Android 설치, VPN 권한, 백그라운드 실행

설치 파일 및 클라이언트 선택

Android 설치 파일에서 Clash Plus를 우선 선택하세요. 그 밖에 Clash Meta for Android, FlClash, Surfboard를 사용할 수 있습니다. 기기 아키텍처는 설치 가능한 앱 ABI와 관련이 있으므로 휴대전화 외관이나 프로세서 홍보 문구만으로 판단할 수 없습니다. 설치 파일이 호환되지 않으면 기기 정보와 다운로드 페이지의 빌드 유형을 확인하세요. 같은 파일을 반복해서 받거나 설치 실패를 네트워크 차단으로 단정하지 마세요.

브라우저나 파일 관리자에서 설치할 때는 현재 출처에 대한 설치 권한을 켜야 할 수 있습니다. 실제로 사용하는 출처에만 권한을 부여하고, 설치 후에는 필요에 따라 해제하세요. 설치 프로그램에서 앱 충돌을 알리면 같은 패키지 이름이지만 서명이 다른 앱이 있는지 확인하세요. 기존 앱을 삭제하면 설정과 로컬 데이터도 사라질 수 있으므로 먼저 백업하세요. 이유를 모른 채 모든 설치 문제를 해결하려고 데이터를 바로 삭제하지 마세요.

가져오기 전에 구독 형식 확인

설정 관리 메뉴를 열고 링크 가져오기를 선택한 다음 본인의 구독 주소를 붙여 넣어 저장하세요. 설정 다운로드가 끝난 뒤에는 해당 설정을 선택하고 활성화해야 합니다. 다운로드 목록에만 남겨 두어서는 안 됩니다. Clash Meta for Android, FlClash, Surfboard는 설정 형식이 완전히 같지 않습니다. 특히 Clash YAML을 Surfboard 설정으로 당연히 가져올 수 있다고 생각하지 마세요. Surfboard를 사용할 때는 서비스 제공자에게 호환 형식을 받은 뒤 해당 클라이언트의 절차에 따라 설정하세요.

가져오기 오류가 발생하면 링크가 완전한지, 복사 과정에서 불필요한 공백이 들어갔는지, 응답 내용이 예상한 설정인지 먼저 확인하세요. 모바일 데이터와 Wi-Fi에서 결과가 다르다면 현재 네트워크의 DNS, 포털 인증, 연결 제한이 원인일 수 있습니다. 오류 메시지를 보존한 뒤 다른 신뢰할 수 있는 네트워크에서 비교 테스트하세요. 문제 해결을 위해 구독 링크를 공개 온라인 변환 사이트에 붙여 넣지 마세요. 링크가 유출되었다면 서비스 계정에서 재설정하세요.

VpnService 권한 및 시스템 상태 이해

처음으로 트래픽 연결을 시작할 때 Android에 VPN 연결 요청이 표시됩니다. Clash 계열 클라이언트는 보통 VpnService로 로컬 가상 인터페이스를 만들어 트래픽을 코어에 전달합니다. 승인 후 상태 표시줄에 VPN 아이콘이 나타나면 인터페이스가 만들어진 것입니다. 원격 프록시를 사용할 수 있다는 뜻은 아닙니다. 실제 연결 여부는 설정이 로드되었는지, 정책을 올바르게 선택했는지, 대상 요청에 응답이 오는지 확인해야 합니다.

일반적인 개인 설정에서는 활성 VPN 서비스를 하나만 사용할 수 있는 경우가 많습니다. 회사 VPN, 다른 프록시 앱, VPN 인터페이스를 사용하는 일부 필터링 도구가 현재 클라이언트와 충돌할 수 있습니다. 시작 직후 연결이 끊기면 시스템에서 다른 VPN이 연결 중인지 먼저 확인하세요. 여러 앱을 동시에 켜서 인터페이스를 놓고 경쟁하게 하지 마세요. 회사 네트워크에 접속해야 한다면 조직의 VPN 사용 요건을 확인한 뒤 사용할 연결 방식을 결정하세요.

백그라운드 실행을 설정하되 필요한 제한은 유지

화면이 꺼진 뒤 연결이 끊긴다면 시스템 앱 설정에서 배터리 최적화, 백그라운드 실행, 자동 시작 권한을 확인하세요. 제조사마다 메뉴 이름이 다르므로 다른 휴대전화의 경로를 그대로 따라 하기보다 앱의 배터리 관리 페이지에서 찾으세요. 현재 사용하는 클라이언트의 백그라운드 제한은 완화할 수 있습니다. 화면이 켜져 있을 때만 연결이 복구되는 일을 막으려면 시스템 데이터 절약 모드가 백그라운드 네트워크 사용을 차단하지 않는지도 확인하세요.

포그라운드 서비스 알림은 트래픽 연결 상태를 유지하는 데 도움이 되므로 알림을 숨기기 위해 관련 서비스를 비활성화하지 않는 것이 좋습니다. 최근 앱 화면에서 앱을 고정하는 기능은 일부 시스템에서 보조적으로 도움이 될 뿐 백그라운드 권한을 대신하지 않습니다. 계속 연결이 끊기면 화면이 꺼졌을 때, 네트워크가 바뀌었을 때, 시스템이 앱을 정리한 뒤 중 언제 발생하는지 기록하고 로그를 확인하세요. 설정 방법은 Android VpnService 및 배터리 최적화 제외 가이드를 참고하세요. 증상에 맞춰 조정하고 모든 시스템 제한을 한꺼번에 끄지 마세요.

앱별 프록시 및 네트워크 전환

클라이언트가 앱별 연결을 지원한다면 ‘선택한 앱만’과 ‘선택한 앱 우회’의 의미를 먼저 확인하세요. 두 설정은 적용 방향이 반대입니다. 변경 후 인터페이스 설정을 갱신하기 위해 다시 연결해야 할 수 있습니다. 특정 앱만 연결되지 않으면 먼저 해당 앱이 제외되어 있는지 확인한 다음 규칙과 DNS를 살펴보세요. 시스템 다운로드 구성 요소, 브라우저, 앱 내 웹 페이지는 서로 다른 프로세스를 사용할 수 있으므로 앱 아이콘만 보고 모든 요청이 같은 경로를 따른다고 판단할 수 없습니다.

Wi-Fi에서 모바일 데이터로 전환하면 기존 연결을 다시 만들어야 할 수 있습니다. 네트워크가 안정될 때까지 기다린 뒤 클라이언트를 다시 연결하고 새 요청이 정상인지 확인하세요. 호텔이나 공항처럼 웹 인증이 필요한 네트워크에서는 먼저 포털 로그인을 완료하세요. 시스템의 ‘VPN 항상 사용’과 VPN을 거치지 않는 연결 차단이 켜져 있으면 클라이언트 연결을 끊은 동안 인증 페이지도 열리지 않을 수 있습니다. 설정을 바꾸기 전에 기기 전체에 미치는 영향을 확인하세요.

모바일 기기에서 데스크톱의 System Proxy 설정 안내를 그대로 적용하지 마세요. Android의 주요 트래픽 연결 방식, 권한 요청, 백그라운드 수명 주기는 데스크톱과 다릅니다. 설정한 뒤에는 앱을 사용 중일 때, 화면을 껐다 켠 뒤, 네트워크를 전환한 뒤 각각 테스트하세요. 모두 정상인지 확인한 다음 앱별 규칙 같은 사용자 설정을 하나씩 추가해야 어떤 변경이 동작에 영향을 주었는지 파악하기 쉽습니다.

5. iOS 설치, 구독, 터널 연결

스토어에서 Clash Plus 설치

iPhone과 iPad에서는 Clash Plus를 우선 선택하세요. 먼저 iOS 클라이언트 안내를 확인한 뒤 App Store의 Clash Plus 페이지로 이동하세요. 개발자 공식 사이트는 clashplus.io입니다. 설치하기 전에 스토어 페이지의 시스템 요구 사항과 앱 설명을 읽으세요. 검색 결과의 이름이 비슷하다는 이유만으로 앱을 판단하지 마세요.

iOS는 앱의 네트워크 확장과 VPN 설정을 관리하므로 데스크톱 시스템의 서비스 설치나 포트 연결 절차를 휴대전화에 그대로 적용할 수 없습니다. 이 가이드는 ‘호환 설정 가져오기, 정책 선택, 시스템 터널 승인, 실제 요청 확인’ 순서로 이해하세요. 클라이언트 인터페이스는 업데이트에 따라 바뀔 수 있으므로 현재 화면의 기능 이름을 기준으로 진행하면 됩니다. 예전 스크린샷과 같은 위치나 아이콘을 찾을 필요는 없습니다.

구독 가져오기 및 계정 정보 보호

서비스 계정에서 호환되는 구독을 복사한 뒤 앱으로 돌아가 설정 또는 구독 관리 메뉴에 붙여 넣고 저장하세요. 일부 웹페이지는 앱을 실행해 가져오기를 시도합니다. 앱으로 이동한 뒤에도 출처, 설정 이름, 내용을 확인하세요. 앱이 열렸다는 것만으로 가져오기가 완료된 것은 아닙니다. 클립보드 접근을 요청할 수 있습니다. 본인의 링크를 복사했는지 확인한 다음 허용해 다른 텍스트를 설정으로 저장하지 않도록 하세요.

구독 주소와 웹 로그인 주소는 보통 다릅니다. 로그인해야 볼 수 있는 웹페이지 주소를 복사하면 페이지 내용만 다운로드되는 경우가 많습니다. 가져오기에 실패하면 형식과 계정 상태를 먼저 확인한 다음 새로고침해 보세요. 전체 링크에는 접근 정보가 포함될 수 있으므로 공개 메모나 공유 스크린샷에 남기지 마세요. 도움을 요청할 때는 오류 유형과 발생 절차를 설명하되 주소의 개인 식별 정보와 인증 정보는 가리세요.

VPN 설정 승인 및 연결 시작

처음 연결을 시작하면 시스템에서 VPN 설정 추가 여부를 묻고 기기 인증을 요청할 수 있습니다. 이는 시스템에 네트워크 연결 설정을 등록하는 절차이지, 기기 암호를 구독 서비스에 알려주는 것이 아닙니다. 승인한 뒤 앱으로 돌아와 현재 설정과 정책 그룹을 확인하고 연결을 시작하세요. 조직에서 관리하는 기기, 제한된 구성 프로파일이 설치된 기기, 다른 VPN이 실행 중인 기기에서는 시스템 정책이 연결에 영향을 줄 수 있습니다.

상태 표시줄이나 제어 센터의 VPN 표시는 시스템 터널이 활성 상태라는 뜻이지만 규칙, DNS, 원격 서비스가 모두 정상임을 증명하지는 않습니다. 실제 대상을 열고 연결 기록과 정책을 확인해야 합니다. 계속 연결 중으로 표시되면 앱의 오류 메시지를 먼저 확인한 다음 시스템 VPN 설정에서 충돌하는 설정이 있는지 살펴보세요. 같은 용도의 항목을 계속 추가하면 이후 원인을 파악하기 어려워지므로 반복해서 만들지 마세요.

규칙 모드와 모바일 트래픽 연결 이해

일상적인 사용에는 먼저 규칙 모드를 사용해 설정의 규칙이 직접 연결할 요청과 프록시를 사용할 요청을 결정하도록 하세요. 전역 모드는 코어에 들어온 요청을 전역 정책으로 처리하지만 시스템의 모든 동작에 적용되는 것은 아니며 작동하지 않는 노드를 고쳐 주지도 않습니다. 직접 연결 모드는 비교 테스트에 유용합니다. 세 가지 모드의 차이는 규칙·전역·직접 연결 모드 설명을 참고하세요. 모드를 바꾼 뒤에는 새 연결을 확인하세요. 기존 연결을 재사용하는 페이지를 새로고침하는 것만으로는 충분하지 않습니다.

iOS 네트워크 확장은 시스템의 수명 주기와 권한에 영향을 받으므로 데스크톱 백그라운드 프로세스와 완전히 같은 방식으로 작동한다고 기대해서는 안 됩니다. 앱 화면을 종료하는 것과 터널이 멈추는 것은 별개입니다. 연결이 유지되는지는 시스템과 클라이언트의 상태를 기준으로 확인하세요. 배터리 부족, 네트워크 변경, 확장 오류가 발생하면 앱에서 연결 상태를 확인하고 터널을 다시 구성하세요. 복구할 때마다 앱을 강제 종료하지 마세요.

핫스팟, 포털, 특정 앱 오류 처리

Wi-Fi에서 셀룰러 네트워크로 전환하면 기존 연결이 끊겼다가 다시 만들어질 수 있습니다. 먼저 셀룰러 데이터가 작동하고 클라이언트에 필요한 네트워크 권한이 있는지 확인한 뒤 다시 연결하세요. 개인용 핫스팟에 연결된 다른 기기의 트래픽이 휴대전화의 터널을 통과하는지는 시스템과 앱 기능에 따라 다릅니다. 휴대전화에서 작동한다고 핫스팟 기기도 프록시를 사용한다고 단정할 수 없습니다. 핫스팟 기기에서 따로 확인하고 필요하면 해당 기기에 클라이언트를 설정하세요.

웹 로그인이 필요한 공용 네트워크에서는 먼저 포털 인증을 마친 뒤 터널을 다시 연결하세요. 특정 앱만 열리지 않으면 해당 앱의 네트워크 권한, 계정 상태, 적용된 규칙을 확인하세요. 모드만 바꿔서는 해결 여부를 알 수 없습니다. 시스템 개인정보 보호 네트워크 기능, 기존 암호화 DNS 설정, 조직 관리 설정도 요청 경로를 바꿀 수 있습니다. 한 번에 하나씩 바꾸고 원래 값을 기록해 복구할 수 있는 기준을 유지하세요.

다른 기기로 설정을 옮길 때는 새 기기의 서비스 사용 권한과 시스템 요구 사항을 먼저 확인하세요. 출처가 불분명한 앱 데이터를 통째로 복사하는 것보다 구독을 다시 가져오는 편이 확인하기 쉽습니다. 가져온 뒤 정책 선택과 주문형 연결 설정을 확인하세요. 이런 로컬 설정이 구독과 함께 이전된다고 가정하지 마세요. 구독은 설정을 제공하지만 시스템 권한은 기기마다 따로 승인해야 합니다.

6. Linux 설치, 데스크톱 프록시, 서비스 실행

데스크톱 사용과 서버 배포를 구분

데스크톱 사용자는 Linux 설치 파일에서 Clash Verge Rev 또는 FlClash를 선택하고 배포판과 페이지에서 제공하는 형식에 맞춰 설치할 수 있습니다. 서버, 라우터, 프로세스를 직접 관리해야 하는 환경에서는 Mihomo 코어를 확인하세요. 그래픽 클라이언트는 설정 경로, 프로세스 실행, 일부 권한을 대신 관리하지만 코어를 직접 배포하면 이 작업을 직접 처리해야 하므로 문제 해결 방법도 다릅니다.

먼저 uname -m으로 기기 아키텍처를 확인한 다음 배포판, 패키지 형식, 의존성 요구 사항을 대조하세요. 파일 확장자가 같아도 모든 배포판에서 사용할 수 있는 것은 아닙니다. RPM 패키지를 Debian 패키지처럼 설치할 수 없습니다. 그래픽 데스크톱 앱은 일반 사용자 권한으로 실행하세요. 네트워크 관리 권한이 필요하면 클라이언트가 제공하는 명확한 승인 방식을 사용하고, 편의를 위해 데스크톱 전체를 계속 root 권한으로 실행하지 마세요.

패키지 관리자로 설치하고 출력 확인

설치하기 전에 설치 파일을 저장한 디렉터리로 이동해 파일 이름과 아키텍처를 확인한 다음 현재 배포판이 지원하는 패키지 관리 도구를 사용하세요. 의존성 관련 메시지가 표시되면 먼저 내용을 확인하세요. 출처가 불분명한 라이브러리를 내려받아 시스템 디렉터리에 덮어쓰지 마세요. 설치가 성공했는데 창이 열리지 않는다면 디스플레이 세션, 그래픽 의존성, 실행 환경이 원인일 수 있습니다. 이것만으로 구독이 잘못되었다고 볼 수는 없습니다. 먼저 터미널에서 앱을 실행해 실제 오류를 확인하세요.

uname -m
cat /etc/os-release
ss -lntp

이 명령은 아키텍처와 배포판 정보, TCP 수신 상태를 확인하는 데 도움을 줄 뿐 프록시를 자동으로 설정하지 않습니다. ss는 일반 사용자 권한으로 일부 프로세스 정보만 표시할 수 있지만 로컬 포트가 수신 중인지 확인할 수 있습니다. 출력을 공유하기 전에 개인 경로, 호스트 이름, 민감한 주소를 가리세요. 포트가 충돌하면 먼저 해당 포트를 사용하는 서비스를 찾고 현재 클라이언트의 포트를 바꿀지 결정하세요. 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요.

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

그래픽 클라이언트에서 먼저 호환되는 구독을 추가하고 설정을 선택한 다음 정책 그룹을 확인하세요. 이후 필요한 연결 방식을 켭니다. Linux 데스크톱 환경마다 시스템 프록시 방식이 다릅니다. 일부 앱은 데스크톱 설정을 읽고, 일부는 환경 변수를 읽으며, 또 일부는 자체 프록시 설정을 사용합니다. 따라서 데스크톱 프록시 스위치만으로 터미널 명령, 패키지 관리자, 백그라운드 서비스가 모두 같은 설정을 사용한다고 보장할 수 없습니다.

curl --proxy http://127.0.0.1:7890 https://example.com/
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

로컬 포트가 7890이고 HTTP 프록시를 지원할 때만 이 예시를 사용하세요. 환경 변수는 현재 셸에서 이후에 시작되는 프로세스 중 해당 변수를 지원하는 항목에만 적용됩니다. 이미 실행 중인 앱의 설정은 바뀌지 않습니다. https_proxy의 프록시 주소에는 HTTP 프로토콜을 사용할 수 있습니다. 프록시까지 연결하는 방식을 나타내기 때문입니다. 테스트가 끝나면 unset http_proxy https_proxy로 현재 세션의 설정을 지울 수 있습니다.

TUN 권한, 라우팅, DNS 관리자 확인

Linux의 TUN은 대개 가상 인터페이스, 라우팅 테이블, 관련 네트워크 권한이 필요합니다. 그래픽 클라이언트는 서비스 모드를 제공할 수 있지만 코어를 직접 실행한다면 배포 환경에 맞게 권한을 설정해야 합니다. 다른 운영체제의 매개변수를 그대로 복사하지 마세요. 활성화 후 인터페이스와 라우팅이 생성되었는지 확인하고 DNS 요청의 경로를 살펴보세요. 컨테이너, 네트워크 네임스페이스, 호스트는 서로 다른 범위입니다. 컨테이너 안에서 실행한다고 호스트 트래픽까지 연결되는 것은 아닙니다.

NetworkManager, systemd-resolved, 배포판 기본 도구가 DNS를 함께 관리할 수 있습니다. /etc/resolv.conf를 직접 덮어쓰면 네트워크 전환 때 다시 만들어지거나 기존 심볼릭 링크 관계가 손상될 수 있습니다. 먼저 어떤 도구가 파일을 관리하는지 확인한 다음 해당 도구의 방식으로 조정하세요. 특히 SSH로 원격 작업할 때는 주의해야 합니다. 기본 경로나 방화벽을 변경하기 전에 현재 세션을 유지하고 별도의 복구 방법을 준비하세요. 관리 연결까지 끊길 수 있습니다.

코어를 직접 실행할 때 설정 디렉터리 명시

Mihomo를 사용할 때는 설정 파일, 규칙 데이터, 실행 디렉터리의 위치와 소유자를 명확히 정하세요. 코어를 실행 가능한 경로에 두고 개인 설정을 고정 디렉터리에 저장한 다음 포그라운드에서 먼저 확인할 수 있습니다. 아래 예시는 사용자 설정 디렉터리를 사용하며 해당 디렉터리를 만들고 유효한 config.yaml을 준비해야 합니다. 테스트가 성공한 뒤 서비스로 등록하세요. 백그라운드 재시작으로 실제 파싱 오류가 가려지지 않게 해야 합니다.

mihomo -t -d "$HOME/.config/mihomo"
mihomo -d "$HOME/.config/mihomo"

장기간 실행하려면 시스템 서비스를 사용해 프로세스를 관리할 수 있지만 실행 사용자, 작업 디렉터리, 설정 경로, 필요한 권한을 명확히 해야 합니다. 서비스가 시작되었다는 것은 프로세스가 실행되었다는 뜻일 뿐입니다. 코어 로그에서 설정이 정상적으로 로드되었는지 확인하세요. 설정을 변경한 뒤에는 문법을 검사하고 실제 배포 방식에 맞게 다시 로드하세요. 서비스를 중지한 뒤에도 서비스가 설정한 라우팅이나 프록시를 복구해야 합니다. 실행 파일만 삭제했다고 네트워크가 원상태로 돌아가는 것은 아닙니다.

7. 설정 파일, DNS, 연결 문제 해결

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

설정 오류가 발생하면 먼저 문법 오류와 의미상 호환성 문제를 구분하세요. YAML은 들여쓰기가 중요하며 일반적으로 탭이 아닌 공백을 사용합니다. 같은 단계의 항목은 들여쓰기를 맞추고 목록 항목 앞에는 하이픈을 둡니다. 파싱에 성공해도 현재 코어가 모든 기능을 지원한다는 뜻은 아닙니다. 다음 예시는 로컬 연결 지점, 모드, 최종 규칙을 이해하기 위한 것입니다. 직접 연결만 사용하며 원격 프록시를 포함하지 않으므로 작동하는 노드 설정으로 사용해서는 안 됩니다.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

mixed-port는 HTTP와 SOCKS를 모두 지원하는 로컬 혼합 연결 지점을 제공합니다. allow-lan은 관련 수신 포트에 LAN 기기가 연결할 수 있는지 제어하며 실제 연결 가능 여부는 바인딩 주소와 방화벽에도 영향을 받습니다. mode는 정책 처리 방식을 결정합니다. 규칙은 순서대로 적용되며 MATCH,DIRECT는 마지막 기본 직접 연결 규칙입니다. 사용자 규칙은 기본 규칙 앞에 추가하세요. 요청이 기본 규칙에 먼저 일치하면 이후 규칙은 적용되지 않습니다.

구독 업데이트와 Mixin 덮어쓰기 별도 관리

원격 구독은 원본으로 유지하고 사용자 지정 항목은 클라이언트가 지원하는 Mixin, 병합, 덮어쓰기 기능으로 관리하는 것이 좋습니다. 클라이언트마다 배열 항목을 추가, 교체 또는 특별 병합하는 방식이 다르므로 기능 이름만 보고 동작을 추측하지 마세요. 특히 규칙 목록과 정책 그룹을 잘못 병합하면 그룹 이름이 없거나 기본 규칙 위치가 바뀌거나 그룹 정의 전체가 덮어써질 수 있습니다. 수정 후에는 편집 창의 내용만 보지 말고 최종 적용된 설정을 확인하세요.

업데이트 후에만 문제가 생겼다면 모든 데이터를 즉시 지우지 말고 업데이트 전후의 설정과 덮어쓰기를 비교하세요. 구독에서 정책 그룹 이름을 변경했는데 사용자 규칙이 이전 이름을 참조하면 오류가 발생할 수 있습니다. 자동 정책 그룹의 매개변수는 용도에 맞게 설정해야 합니다. url-test, fallback, load-balance 비교를 참고하세요. 복구하려면 최근 추가한 덮어쓰기를 먼저 비활성화한 다음 하나씩 확인해 문제 범위를 좁히세요.

DNS 서버를 바꾸기 전에 이름 해석 경로 확인

DNS 오류는 시스템, 앱, 코어, 원격 연결 등 여러 단계에서 발생할 수 있습니다. 도메인은 열리지 않지만 알고 있는 IP 주소로 연결된다고 해서 특정 DNS 서버의 장애라고 단정할 수는 없습니다. 먼저 로그에서 이름 해석 실패, 로컬 연결 실패, 원격 시간 초과 중 무엇인지 확인한 다음 DNS 요청이 코어에 들어가는지 살펴보세요. 앱에 내장된 암호화 DNS는 별도 경로를 사용할 수 있습니다. TUN의 DNS 가로채기 설정도 모든 암호화된 DNS 요청을 자동으로 연결하는 것은 아닙니다.

fake-ip는 합성 주소를 사용해 코어가 도메인과의 연결을 유지하도록 하는 기능이지 원격 웹사이트의 실제 주소가 아닙니다. redir-host는 다른 매핑 방식을 사용하며 호환성도 다릅니다. LAN 도메인이나 특정 앱에 문제가 생기면 증상에 맞춰 필터링과 이름 해석 설정을 확인하세요. 공용 DNS 서버를 계속 바꾸는 것만으로 해결하려 하지 마세요. nameserver, fallback, 필터 규칙의 조합은 Clash DNS 설정 상세 가이드를 참고하세요. 변경하기 전에 현재 코어가 해당 항목을 지원하는지 확인하세요.

요청 경로에 따라 문제 해결 순서 정하기

증상우선 확인할 항목비교 방법
로컬 프록시 연결이 거부됨코어, 수신 주소, 포트수신 상태 확인 후 프록시를 명시해 테스트
연결 기록에 요청이 없음앱 연결 지점, 시스템 프록시, 라우팅연결 방식을 하나만 바꾼 뒤 새 요청 실행
요청에 잘못된 정책이 적용됨규칙 순서 및 그룹 이름적용된 규칙과 최종 연결 경로 확인
프록시 연결 후 시간 초과서비스 상태, 원격 연결, 이름 해석사용 가능한 정책을 명시적으로 선택하고 로그 비교

기본 네트워크가 정상인지 먼저 확인한 다음 로컬 연결 지점, 설정 로드, 규칙, 원격 연결, DNS를 차례로 살펴보세요. 한 번에 변수 하나만 바꾸고 같은 대상으로 반복 테스트하세요. 브라우저는 이름 해석 결과를 캐시하고 연결을 재사용할 수 있으므로 모드를 바꾼 뒤에는 새 연결을 시도해야 합니다. 그렇지 않으면 이전 경로를 계속 확인하게 될 수 있습니다. 로그 수준을 임시로 높였다면 확인 후 원래대로 돌리고, 공유할 때는 구독, 인증 정보, 개인의 접속을 식별할 수 있는 내용을 삭제하세요.

자주 발생하는 설정 문제의 해결 방법

구독 다운로드는 성공했는데 왜 인터넷에 연결되지 않나요?

다운로드 성공은 내용이 전달되었다는 뜻일 뿐입니다. 설정을 선택했는지, 코어가 정상적으로 파싱했는지, 정책 그룹에 사용할 수 있는 연결 경로가 있는지, 플랫폼에 맞는 연결 방식을 켰는지 확인하세요. 마지막으로 연결 기록에서 요청 경로를 확인하세요. 구독 목록의 업데이트 시간만으로는 충분하지 않습니다.

전역 모드를 켰는데 왜 문제가 해결되지 않나요?

전역 모드는 코어에 들어온 요청의 정책을 바꿀 뿐, 프록시에 들어오지 않는 앱이나 작동하지 않는 서비스, 로컬 포트 오류를 해결하지 않습니다. 먼저 프록시 연결 지점을 명시적으로 테스트한 다음 전역 정책에서 어떤 연결 경로가 선택되었는지 확인하세요. 평소처럼 트래픽을 나누려면 규칙 모드로 돌아가세요.

클라이언트를 종료한 뒤 인터넷이 끊기면 무엇부터 복구해야 하나요?

데스크톱에서는 먼저 시스템 프록시가 여전히 로컬 포트를 가리키는지 확인한 다음 TUN, 라우팅, DNS가 복구되었는지 살펴보세요. 모바일 기기에서는 VPN 상태와 VPN을 거치지 않는 연결을 차단하는 설정을 확인하세요. 조직 네트워크의 원래 설정은 유지하고 모든 네트워크 설정을 바로 초기화하지 마세요.

검증 절차를 처음부터 다시 정리하려면 빠른 시작 가이드로 돌아가 순서대로 진행하세요. 클라이언트를 바꾸려면 설치 파일 페이지에서 플랫폼과 유지 관리 상태를 먼저 확인하세요. 설정은 단계별로 조정하되 언제든 복구할 수 있어야 합니다. 원본 구독을 보존하고 로컬 변경 사항을 기록한 다음 이전 연결을 종료하고 새 설정을 활성화하세요.