FAQ · 질문별 해결 방법

Clash 자주 묻는 질문

기기 플랫폼과 현재 설정을 먼저 확인한 뒤 증상에 따라 점검하세요. 질문을 펼치면 설정 위치와 판단 기준, 다음 단계가 표시됩니다. 메뉴 이름은 사용 중인 클라이언트와 시스템 버전에 따라 다를 수 있습니다.

기본 개념

클라이언트와 코어, 구독을 구분하고 모드와 시스템 인터페이스의 역할을 알아봅니다.

Clash 클라이언트, mihomo 코어, 구독은 각각 무엇인가요?

클라이언트는 설정을 가져오고 정책 그룹과 서비스를 관리하는 앱입니다. mihomo는 연결과 규칙을 처리하는 코어입니다. 구독은 서비스 제공자가 제공하는 설정 주소로, 보통 노드와 정책 그룹, 규칙이 포함됩니다. 클라이언트를 설치한 뒤에도 프록시를 사용하려면 해당 코어와 호환되는 설정을 가져와야 합니다. 문제를 확인할 때는 앱 실행 문제인지, 설정 불러오기 문제인지, 노드 연결 문제인지 먼저 구분하세요. 세 가지를 모두 구독 문제로 단정하지 않는 것이 좋습니다.

Android 상태 표시줄에 VPN 아이콘이 보이면 연결에 성공한 건가요?

VPN 아이콘은 클라이언트가 Android 기기에 VPN 인터페이스를 만들었다는 뜻일 뿐, 원격 노드가 정상적으로 작동한다는 의미는 아닙니다. VpnService는 기기의 네트워크 트래픽을 전달받는 Android 시스템 인터페이스이며, 클라이언트가 설정에 따라 연결을 처리합니다. 아이콘이 표시되면 정책 그룹에서 선택된 노드를 확인하고 실제 웹페이지나 앱으로 연결을 테스트하세요. 페이지가 열리지 않는다면 연결 로그에서 DNS 조회, 핸드셰이크 또는 시간 초과 오류를 확인하세요. 아이콘만 보고 앱을 반복해서 재설치할 필요는 없습니다.

Rule, Global, Direct 모드는 어떻게 선택하나요?

일반적인 사용에는 Rule, 즉 규칙 모드를 선택한 뒤 정책 그룹에서 노드를 고르면 됩니다. 규칙에 따라 연결을 직접 연결하거나 프록시로 전달합니다. Global은 코어로 들어온 연결을 전역 정책으로 처리하므로, 해당 정책에서 사용할 노드를 선택해야 합니다. Direct는 코어로 들어온 연결을 직접 연결합니다. 모드는 코어가 처리하는 트래픽에만 적용되며, 아직 코어가 맡지 않는 앱의 트래픽까지 자동으로 프록시 처리하지는 않습니다. 규칙 문제를 확인하기 위해 잠시 Global로 바꿔 테스트할 수 있지만, 테스트가 끝나면 원래 모드로 되돌리세요.

TUN과 Android VPN 권한은 같은 설정인가요?

서로 관련은 있지만 같은 설정은 아닙니다. TUN은 IP 계층의 트래픽을 받는 가상 네트워크 인터페이스 방식입니다. Android 클라이언트는 보통 VpnService를 이용해 시스템 트래픽을 처리하며, 앱에 따라 관련 설정이 VPN, 서비스 또는 TUN으로 표시될 수 있습니다. 데스크톱의 TUN은 관리자 권한, 서비스 구성 요소, 라우팅 설정이 필요할 수도 있습니다. PC용 안내에 나온 권한 명령을 그대로 적용하지 말고, 먼저 기기 플랫폼을 확인한 뒤 현재 클라이언트의 설정 안내를 따르세요.

같은 구독을 휴대폰과 PC에서 함께 사용할 수 있나요?

먼저 구독 제공자의 기기 수 및 동시 연결 제한을 확인하고, 두 클라이언트가 구독의 프로토콜과 설정 항목을 지원하는지 살펴보세요. 구독을 가져올 수 있다고 해서 모든 설정이 두 플랫폼에 적합한 것은 아닙니다. 수신 주소, 파일 경로, TUN 및 DNS의 시스템 처리 방식이 다를 수 있으므로 원격 구독은 공유하고 플랫폼별 차이는 각 기기의 로컬 오버라이드로 설정하는 편이 좋습니다. 오버라이드는 설정을 업데이트한 뒤에도 적용되는 로컬 수정 사항입니다. 다른 기기의 시스템 설정이 덮어써지지 않도록 앱 데이터 폴더 전체를 동기화하지 마세요.

용어집 보기: 코어, 규칙 및 시스템 작동 방식

설치 및 설정

권한, 구독, 백그라운드 설정부터 확인하세요. 변경하기 전에 기존 설정을 보존하세요.

Clash 안드로이드를 처음 실행할 때 VPN 연결 요청은 어떻게 처리하나요?

먼저 클라이언트에서 설정을 가져와 선택한 다음 프록시 서비스를 시작하세요. Android에서 VPN 연결 요청이 나타나면 요청 창의 앱 이름이 설치된 클라이언트와 일치하는지 확인하고 연결을 허용합니다. 요청 창이 뜨지 않으면 다른 VPN 앱을 먼저 종료한 뒤 서비스를 다시 시작하세요. 업무 프로필이나 기기 관리 정책이 권한을 제한할 수도 있습니다. 권한을 허용한 뒤 시스템 설정의 VPN 페이지에서 연결 상태를 확인하세요. VPN 연결을 허용하는 것은 노드 서비스 제공자에게 휴대폰 파일 접근 권한을 주는 것과 다릅니다.

URL에서 구독을 가져오지 못하면 어디부터 확인해야 하나요?

설정 페이지에서 URL 가져오기를 찾아 서비스 제공자에게서 구독 주소 전체를 다시 복사하세요. 주소 앞뒤에 공백이나 줄바꿈, 메신저에서 붙은 문장부호가 있는지 확인하고, 관리 페이지 주소가 아닌 구독 주소를 복사했는지도 살펴보세요. 그래도 실패하면 가져오기 로그를 확인하세요. 네트워크 시간 초과라면 다른 네트워크에서 테스트하고, 형식 오류라면 링크가 로그인 페이지나 오류 페이지를 반환하는지 확인합니다. 구독 주소에는 보통 접근 정보가 포함되므로 공개 포럼이나 스크린샷에 전체 주소를 올리지 마세요.

구독이 만료되었거나 권한이 없다고 나오거나, 업데이트 후 노드가 사라지면 어떻게 하나요?

먼저 서비스 제공자 관리 페이지에서 유효 기간과 남은 할당량을 확인하고 구독 주소가 재설정되었는지 살펴보세요. HTTP 401 또는 403은 보통 접근 권한과 관련이 있지만, 사이트의 접근 제한 때문에 발생할 수도 있으므로 상태 코드만으로 만료를 단정하지 마세요. 주소를 다시 복사해 수동으로 업데이트한 뒤 클라이언트에서 업데이트된 설정을 선택했는지 확인합니다. 다운로드는 성공했는데 노드가 없다면 잘못된 형식이나 빈 설정을 받은 것은 아닌지 살펴보세요. 이전 설정은 바로 삭제하지 말고 문제가 생겼을 때 되돌릴 수 있도록 남겨 두세요.

화면을 잠근 뒤 연결이 끊긴다면 배터리 및 백그라운드 권한을 어떻게 설정하나요?

앱 아이콘을 길게 눌러 앱 정보를 연 다음 배터리 또는 백그라운드 실행 설정에서 클라이언트를 제한 없음으로 설정하거나 백그라운드 활동을 허용하세요. 일부 시스템에서는 자동 시작을 허용하고 최근 앱 화면에서 앱을 잠가야 할 수도 있습니다. 메뉴 이름은 휴대폰 제조사마다 다르므로 실제 시스템 메뉴를 기준으로 설정하세요. 이후 서비스를 시작하고 몇 분간 화면을 잠근 뒤 연결을 테스트합니다. Wi-Fi와 모바일 네트워크를 전환할 때만 끊긴다면 네트워크 전환 로그도 확인하세요. 배터리 최적화 예외 설정으로 노드 자체의 연결 끊김이나 설정 오류를 해결할 수는 없습니다.

데스크톱에서 TUN을 켤 때 권한 부족 오류가 나오면 어떻게 하나요?

먼저 TUN을 끄고 클라이언트 설정에서 서비스 모드나 서비스 구성 요소가 설치되어 실행 중인지 확인하세요. Windows에서는 보통 안내에 따라 관리자 권한을 허용해야 합니다. macOS에서는 시스템 설정에서 관련 권한을 승인해야 할 수 있고, Linux에서는 클라이언트 문서에 따라 서비스나 네트워크 권한을 설정해야 할 수 있습니다. 설정을 마치면 클라이언트를 다시 시작한 뒤 TUN을 켜세요. 출처를 알 수 없는 프로그램을 높은 권한으로 계속 실행하거나 라우팅 명령을 반복해서 추가하지 마세요. 계속 실패하면 구체적인 오류 메시지를 기록하고 기존 VPN 가상 네트워크 어댑터와 충돌하는지도 확인하세요.

사용 안내에 따라 초기 설정하기

사용 팁

연결 기록으로 결과를 확인하고 구독 업데이트와 로컬 설정을 따로 관리하세요.

사용자 지정 규칙은 어디에 추가해야 하며, 추가 후 적용되지 않는 이유는 무엇인가요?

클라이언트에서 오버라이드, 규칙 편집 또는 확장 설정 메뉴를 찾아 계속 유지할 규칙을 로컬 오버라이드에 작성하세요. 그래야 구독 업데이트 후 규칙이 덮어써지지 않습니다. 규칙은 보통 위에서 아래로 확인하며 먼저 일치한 규칙이 적용되므로, 특정 도메인 규칙은 포괄적인 규칙이나 최종 기본 규칙보다 앞에 두세요. 규칙을 추가한 뒤 설정을 다시 불러오고 연결 기록에서 어떤 규칙이 적용됐는지 확인합니다. 규칙에서 지정한 정책 그룹 이름은 설정과 정확히 일치해야 합니다. 이름이 다르면 가장 가까운 노드로 자동 전환되는 것이 아니라 설정을 불러오지 못할 수 있습니다.

속도 측정 결과만 보지 않고 특정 앱이 실제로 프록시를 사용하는지 확인하려면 어떻게 하나요?

클라이언트의 연결 화면을 열고 대상 앱에서 새로운 요청을 보내 해당 도메인과 적용된 규칙, 최종 정책을 확인하세요. 기존 연결이 계속 이전 경로를 사용할 수 있으므로 노드를 바꾼 뒤에는 대상 앱을 종료했다가 다시 여는 것이 좋습니다. Android에서 앱별 프록시를 사용한다면 대상 앱이 처리 범위에 포함되어 있는지도 확인하세요. 노드 속도 측정은 지정된 테스트 주소만 확인하므로 대상 앱의 서버에 연결할 수 있다는 뜻은 아닙니다. 실제 서비스 페이지로 테스트하고 요청 시간과 로그 시간을 대조하세요.

휴대폰과 PC의 설정을 동기화하면서 각 기기의 로컬 수정 사항을 유지하려면 어떻게 하나요?

두 기기에 같은 원격 구독을 각각 추가한 다음, 각 기기에서 로컬 오버라이드를 만들고 유지할 DNS, 규칙, 플랫폼 설정을 기록하세요. 먼저 구독을 수동 업데이트하고 오버라이드가 계속 활성화되어 있는지 확인한 뒤 설정을 다시 불러옵니다. 클라이언트마다 설정 항목을 병합하는 방식이 다를 수 있으므로 규칙을 뒤에 추가하는지, 앞에 넣는지, 기존 규칙을 대체하는지 확인하세요. 마이그레이션 전에 필요한 로컬 설정을 내보내고 정책 그룹 선택 기록도 저장하세요. 실행 중인 설정 파일을 파일 동기화 도구로 바로 덮어쓰면 쓰는 도중 파일이 불러와질 수 있으므로 권장하지 않습니다.

VPN 항상 사용과 VPN을 사용하지 않는 연결 차단을 켜야 하나요?

Android 시스템의 VPN 설정에서 현재 클라이언트 옆의 설정 메뉴를 열고 두 옵션을 확인하세요. VPN 항상 사용은 시스템이 VPN 서비스를 유지하거나 다시 연결하도록 합니다. VPN을 사용하지 않는 연결 차단은 해당 VPN을 거치지 않는 네트워크 연결을 제한하므로, 서비스에 문제가 생기면 기기 전체에서 인터넷이 끊길 수 있습니다. 먼저 클라이언트가 이 기능을 지원하는지 확인하고 재시작 및 네트워크 전환 테스트를 마친 뒤 필요에 따라 켜세요. 켠 뒤 인터넷이 끊기면 해당 페이지에서 연결 차단 옵션을 끄고 설정과 앱별 처리 범위를 확인하세요.

구독과 클라이언트 중 무엇을 먼저 업데이트해야 하나요?

문제가 어느 부분에서 발생하는지 먼저 확인하세요. 노드 목록이 오래되었거나 서비스 제공자가 주소를 바꿨다면 구독을 업데이트합니다. 설정에서 지원하지 않는 프로토콜이나 항목을 알리는 경우에는 클라이언트와 코어 업데이트가 필요한지 확인하세요. 정상적으로 사용 중이라면 모든 설정을 한꺼번에 바꿀 필요는 없습니다. 클라이언트를 업데이트하기 전에 로컬 오버라이드와 중요한 설정을 저장하고, 업데이트 후에는 기존 설정을 불러와 테스트하세요. 클라이언트와 구독, DNS, 모드를 동시에 바꾸면 문제가 생겼을 때 원인을 파악하기 어렵습니다. 한 번에 하나씩 변경하고 변경 전후의 연결 상태를 기록하세요.

초보자부터 고급 사용자까지 안내서 읽기

문제 해결

요청이 클라이언트에 들어왔는지 확인한 다음 DNS 조회, 노드, 대상 서비스 순으로 점검하세요.

모든 노드에서 시간 초과가 발생하면 어떤 순서로 확인해야 하나요?

먼저 프록시 서비스를 중지하고 기기의 기본 네트워크로 자주 이용하는 사이트에 접속할 수 있는지 확인하세요. 그런 다음 구독 유효 기간과 할당량, 노드 목록이 최신인지 살펴봅니다. 시스템 날짜와 시간이 자동으로 동기화되는지 확인하고 로그에서 DNS 조회 실패, 연결 시간 초과 또는 핸드셰이크 오류가 있는지 확인하세요. 다른 노드와 다른 네트워크를 각각 사용해 교차 테스트하고 실제 웹페이지도 열어 봅니다. 속도 측정만 실패하고 웹페이지는 정상이라면 테스트 주소에 접근할 수 없는 경우일 수 있습니다. 처음부터 클라이언트를 재설치하지 마세요. 기존 설정을 잃을 수 있고 원격 노드 문제도 해결되지 않습니다.

Windows 시스템 프록시를 켰는데 브라우저에서 작동하지 않는 이유는 무엇인가요?

먼저 클라이언트에서 로컬 프록시 포트가 수신 대기 중인지 확인한 다음 Windows의 네트워크 및 인터넷 설정에서 프록시 주소와 포트가 일치하는지 살펴보세요. 브라우저 확장 프로그램, 별도 프록시 설정, 일부 업무용 정책이 시스템 프록시보다 우선 적용될 수 있습니다. 관련 확장 프로그램을 끄거나 시스템 설정을 따르도록 변경한 뒤 브라우저를 다시 여세요. 클라이언트 연결 기록에 해당 요청이 나타나는지도 확인합니다. 기록이 전혀 없다면 먼저 트래픽이 들어오는 경로를 확인하세요. 기록은 있는데 접속이 실패한다면 정책, 노드, DNS를 점검하고 시스템 프록시를 반복해서 켰다 끄지 마세요.

브라우저는 인터넷에 연결되는데 명령줄 터미널에서 연결에 실패하면 어떻게 하나요?

많은 명령줄 도구는 데스크톱 시스템 프록시를 자동으로 사용하지 않습니다. 먼저 해당 도구가 지원하는 프록시 옵션이나 환경 변수를 확인한 뒤, 클라이언트에서 실제로 수신 대기 중인 주소와 포트, 프로토콜을 입력하세요. HTTP 프록시와 SOCKS 프록시는 포트만 바꾸고 프로토콜을 무시하면 안 됩니다. 일부 프로그램은 ALL_PROXY도 필요할 수 있으므로 도구 문서를 확인하세요. 설정한 뒤 새 터미널에서 테스트하고 연결 기록을 살펴봅니다. 여러 프로그램의 트래픽을 처리해야 한다면 TUN 사용도 고려할 수 있습니다. 인증 정보가 포함된 환경 변수 출력이나 터미널 전체 화면을 공개하지 마세요.

도메인으로 접속할 수 없고 로그에 DNS 오류가 표시되면 어떻게 해야 하나요?

먼저 로그에서 조회에 실패한 도메인이 대상 사이트인지 노드 서버인지 확인한 다음, 설정된 DNS 업스트림에 현재 네트워크로 접근할 수 있는지 살펴보세요. 암호화 DNS 서버 주소도 먼저 도메인 조회가 필요할 수 있으므로 접근할 수 없는 다른 주소로 임의 변경하지 마세요. Android 비공개 DNS, 브라우저 보안 DNS, 클라이언트 DNS는 서로 다른 조회 경로를 사용할 수 있습니다. 테스트할 때는 한 번에 하나만 변경하세요. fake-ip, 즉 합성 주소 모드를 사용한다면 브라우저 캐시만 지우지 말고 클라이언트의 DNS 트래픽 처리가 정상인지 확인하세요.

Windows UWP 앱이 프록시를 사용하지 않을 때 루프백 제한은 어떻게 확인하나요?

먼저 문제가 발생한 앱이 제한된 앱 컨테이너에서 실행되는지 확인하고, 데스크톱 브라우저가 같은 프록시로 인터넷에 연결되는지도 살펴보세요. 일부 UWP 앱은 기본적으로 127.0.0.1 같은 로컬 루프백 주소에 접근할 수 없어 클라이언트의 로컬 프록시 포트에 연결하지 못합니다. 클라이언트에 UWP 루프백 도구가 있다면 필요한 앱에 예외를 추가하고 안내에 따라 권한을 허용하세요. 도구가 없다면 Windows의 CheckNetIsolation 문서를 확인합니다. 필요한 앱에만 적용한 뒤 대상 앱을 다시 시작하고 연결 기록을 확인하세요.

클라이언트 다운로드