FAQ / 사용 및 문제 해결

Clash 자주 묻는 질문

구독 가져오기부터 프록시 적용, 노드 시간 초과까지. 문제가 발생한 단계를 먼저 확인하고 관련 설정과 로그를 살펴보세요.

BASICS

입문 가이드

클라이언트, 커널, 로컬 포트, 원격 노드의 차이를 확인하세요.

설정 항목 확인
Clash 클라이언트와 mihomo 커널은 어떻게 다른가요?

클라이언트는 사용자 인터페이스와 시스템 연동을 제공하고, 커널은 설정을 읽어 규칙을 적용하고 연결을 설정합니다. 설치 파일은 보통 클라이언트 프로젝트에서 배포하며, 지원하는 설정 항목은 실제로 실행되는 커널과 버전에 따라 다릅니다. ‘알 수 없는 필드’ 오류가 나면 클라이언트의 정보 화면이나 시작 로그에서 커널을 확인한 뒤 해당 버전의 문서를 살펴보세요. 인터페이스만 업데이트해도 커널은 그대로일 수 있습니다. 같은 설정 파일을 사용하더라도 기기마다 커널 버전이 다르면 동작이 달라질 수 있습니다.

규칙, 전역, 직접 연결 모드는 어떻게 선택하나요?

일상적인 사용에는 규칙 모드를 권장합니다. 커널은 설정 순서대로 트래픽을 확인하고, 처음으로 일치하는 규칙에 지정된 정책을 적용합니다. 전역 모드는 잠깐 비교할 때 유용합니다. 전역 정책에 정상 작동하는 출구 노드를 지정하고 같은 요청을 다시 시도하세요. 직접 연결 모드에서는 커널에 들어온 트래픽을 바로 전송하지만 시스템 프록시나 TUN을 자동으로 끄지는 않습니다. 앱이 커널을 거치지 않고 인터넷에 연결되는지 확인하려면 해당 트래픽 가로채기 기능을 별도로 끄고 새 연결을 만들어 테스트하세요.

mixed-port는 원격 노드의 포트인가요?

아닙니다. mixed-port는 커널이 로컬 기기에서 수신 대기하는 혼합 포트로, HTTP와 SOCKS 프록시 연결을 받습니다. 노드 설정의 port가 원격 서버 포트입니다. 로컬 앱에 직접 설정할 때 주소는 보통 127.0.0.1을 사용하며, 포트는 현재 설정이나 클라이언트에 표시된 실제 수신 대기 값을 확인하세요. 모든 설정에서 7890을 사용하는 것은 아닙니다. 로컬에서만 사용할 경우 같은 네트워크의 다른 기기에 프록시가 노출되지 않도록 LAN 접근을 꺼 두세요.

구독 링크, YAML 파일, 노드 링크는 서로 바꿔 쓸 수 있나요?

세 가지는 용도가 다릅니다. 구독 링크는 필요할 때 다시 가져올 수 있는 원격 콘텐츠를 가리키므로 클라이언트에서 새로고침할 수 있습니다. 로컬 YAML 파일은 별도 파일이라 가져온 뒤에는 원래 구독과 자동으로 동기화되지 않는 경우가 많습니다. 단일 노드 링크에는 보통 출구 연결 정보만 담겨 있고 로컬 포트, 정책 그룹, 규칙 전체는 포함되지 않습니다. 노드 링크만 있다면 클라이언트가 단일 노드 가져오기를 지원하는지 먼저 확인하세요. 전체 설정만 받는 입력란에 붙여 넣으면 안 됩니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 문의 게시물에 올리지 마세요.

SETUP

설치 및 설정

설치 파일을 선택하고 설정이 로드됐는지 확인한 다음 트래픽 가로채기를 켜세요.

가져오기 절차 확인
클라이언트를 설치하기 전에 어떤 시스템 요구 사항을 확인해야 하나요?

운영체제 버전, 프로세서 아키텍처, 설치 파일 형식을 먼저 확인하세요. 데스크톱에서는 시스템 정보에서 x64인지 ARM64인지 확인할 수 있습니다. Mac은 ‘이 Mac에 관하여’에서 Intel 프로세서인지 Apple 칩인지 확인하세요. Linux에서는 배포판의 패키지 형식도 확인해야 합니다. 파일 이름이 비슷하다는 이유만으로 호환된다고 판단하지 마세요. 업데이트 전에 설치 파일이 해당 클라이언트의 공식 배포 경로에서 제공되는지 확인하세요. 시스템에서 지원하지 않는다고 표시되거나 실행이 차단되면 최소 지원 OS 버전과 아키텍처를 확인하고, 보안 설정을 전역으로 끄지는 마세요.

구독을 가져온 뒤 설정이 적용됐는지 어떻게 확인하나요?

가져오기에 성공했다고 설정이 활성화된 것은 아닙니다. 클라이언트의 설정 페이지에서 ‘링크에서 가져오기’와 같은 메뉴를 선택하고, 저장한 뒤 가져오기가 끝날 때까지 기다리세요. 그런 다음 해당 설정을 직접 선택해야 합니다. 프록시 페이지로 이동해 표시된 정책 그룹이 새 설정에 포함된 것인지 확인하고, 로그에 파싱 또는 시작 오류가 있는지도 살펴보세요. 목록에는 파일이 있는데 프록시 페이지에 이전 그룹이 표시된다면 현재 활성 설정을 확인한 뒤 새 파일이 로드되지 않았는지 점검하세요. 마지막으로 접속 가능한 사이트를 열고 연결 또는 로그 페이지에서 요청이 실제로 커널에 들어왔는지 확인하세요.

TUN을 켤 수 없고 권한 부족 메시지가 표시되면 어떻게 하나요?

먼저 클라이언트가 현재 운영체제에서 TUN을 지원하는지 확인한 다음, 어떤 권한 부여 방식이 필요한지 살펴보세요. 데스크톱 클라이언트는 프록시 서비스를 설치하고 실행해야 하거나 처음 활성화할 때 관리자 권한을 요청할 수 있습니다. Linux에서는 장치 접근 및 네트워크 관리 권한이 필요할 수 있으니 배포판과 클라이언트 문서에 따라 허용하세요. 시스템 VPN 인터페이스를 사용하는 모바일 클라이언트는 보통 시스템 팝업에서 연결 요청을 승인해야 합니다. 권한을 허용한 뒤에도 실패한다면 서비스 상태와 첫 번째 시작 오류를 확인하고, 다른 VPN이나 가상 네트워크 어댑터가 경로를 가로채는지 점검하세요.

클라이언트를 업그레이드하기 전에 로컬 설정과 오버라이드를 어떻게 보존하나요?

클라이언트 버전을 변경하기 전에 설정과 오버라이드를 백업하세요. 클라이언트의 내보내기 기능으로 로컬 YAML, 오버라이드 파일, 보존할 설정을 저장하세요. 내보내기 기능이 없다면 해당 클라이언트 문서에서 설정 폴더를 확인하세요. 백업은 본인만 접근할 수 있는 위치에 보관하고 원격 구독 주소도 인증 정보처럼 취급하세요. 업데이트 후에는 기존 설정을 선택해 정책 그룹과 규칙이 예상대로인지 확인한 다음 트래픽 가로채기를 켜세요. 업데이트 후 파싱 오류가 발생하면 오류 내용을 보관하고 새 커널과 이전 커널의 관련 설정 항목 지원 여부를 비교하세요.

USAGE

사용 팁

요청이 어디서 커널에 들어오는지, 어떤 규칙이 적용되는지, 도메인 이름을 어디서 확인하는지 살펴보세요.

규칙 문법 확인
시스템 프록시와 TUN 중 무엇을 먼저 켜야 하나요?

시스템 프록시를 따르는 브라우저나 앱만 프록시를 사용하면 된다면 시스템 프록시부터 설정하세요. 이 기능은 해당 설정을 지원하는 소프트웨어에 로컬 프록시 주소를 제공하지만 모든 프로그램의 트래픽을 커널로 보내지는 않습니다. 앱이 시스템 프록시를 사용하지 않는다면 앱 자체의 프록시 설정을 확인하거나, 클라이언트가 지원하는 경우 TUN을 고려하세요. TUN은 라우팅 계층에서 설정된 범위의 트래픽을 가로채므로 LAN, 회사 VPN, DNS에 영향을 줄 수 있습니다. 처음 문제를 확인할 때는 한 가지 진입 방식만 켜고 같은 요청이 로그에 나타나는지 확인한 뒤 가로채기 범위를 조정하세요.

UWP 앱에만 루프백 예외가 필요한 이유는 무엇인가요?

Windows 앱 컨테이너에서 실행되는 일부 앱은 기본적으로 루프백 연결이 제한되어 127.0.0.1의 프록시에 연결하지 못할 수 있습니다. 일반 데스크톱 브라우저는 같은 포트로 연결되지만 특정 컨테이너 앱만 연결되지 않는 경우가 흔합니다. 클라이언트에 ‘UWP 루프백’ 관리 메뉴가 있다면 시스템 안내에 따라 로컬 프록시가 필요한 문제 앱에만 예외를 설정하세요. 앱을 완전히 종료한 뒤 다시 열어 테스트하고, 목록 전체를 일괄 허용하지 마세요. 그래도 문제가 해결되지 않으면 해당 앱이 시스템 프록시를 사용하는지 확인하세요.

규칙을 설정에 추가했는데 왜 적용되지 않나요?

먼저 규칙 모드가 선택되어 있는지 확인하고 연결에 실제로 적용된 규칙을 살펴보세요. 커널은 규칙을 순서대로 확인합니다. 너무 포괄적인 규칙이 앞에 있으면 뒤쪽의 구체적인 규칙이 적용되지 않을 수 있습니다. MATCH는 보통 마지막에 기본 규칙으로 둡니다. 로그의 대상과 설정에 적은 도메인이 일치하는지, 정책 그룹 이름이 정확히 같은지도 확인하세요. 로그에 대상 IP만 표시된다면 현재 트래픽 가로채기 방식이 커널에 도메인 정보를 전달하는지 확인하세요. 한 번에 한 항목만 변경하고 설정을 저장한 뒤 다시 불러오세요. 브라우저의 기존 연결이 아닌 새 연결로 테스트해야 합니다.

설정에서 DNS를 켜면 모든 앱이 해당 DNS를 사용하나요?

반드시 그런 것은 아닙니다. 커널 DNS를 활성화해도 관련 DNS 기능을 사용할 수 있다는 뜻일 뿐, 시스템의 모든 DNS 요청이 커널로 전달되는 것은 아닙니다. 먼저 테스트할 앱의 DNS 경로를 확인하세요. 시스템 리졸버를 사용하는지, 브라우저 자체의 암호화 DNS를 사용하는지, TUN에서 클라이언트가 가로챈 요청인지 살펴보면 됩니다. 테스트할 때 클라이언트 모드와 브라우저 설정을 기록하고 한 번에 하나씩 바꿔 새 DNS 요청을 보내 로그를 확인하세요. 한 번의 DNS 테스트 결과나 반환된 IP만으로 시스템 DNS가 우회됐다고 판단하지 마세요. 브라우저 캐시와 도메인별 DNS 정책도 결과에 영향을 줄 수 있습니다.

DIAGNOSIS

문제 해결

첫 번째 오류부터 확인한 다음 구독, 로컬 프록시 연결, 원격 연결 중 어디에 문제가 있는지 판단하세요.

시스템 프록시 설정 확인
구독 새로고침에 실패했을 때 링크 문제인지 네트워크 문제인지 어떻게 구분하나요?

업데이트 로그에서 요청이 어느 단계에서 실패했는지 먼저 확인하세요. 401 또는 403이 표시되면 계정 상태와 링크 권한을 확인하고, 구독 제공처가 주소를 변경했는지도 살펴보세요. 404라면 이전 링크를 계속 사용하고 있는지 확인하세요. 도메인 확인 실패, 연결 시간 초과, 인증서 오류가 로그에 있다면 현재 네트워크와 시스템 시간, 클라이언트의 구독 업데이트 경로부터 점검해야 합니다. 이런 오류만으로 구독이 만료됐다고 단정할 수는 없습니다. 콘텐츠를 받았는데 YAML 파싱 오류가 발생한다면 응답이 로그인 페이지나 오류 페이지인지도 확인하세요. 새 구독이 정상적으로 로드될 때까지 현재 사용 가능한 설정은 보존하세요.

Clash 노드 전체가 시간 초과될 때와 일부만 시간 초과될 때는 어떻게 점검하나요?

전체 노드에서 시간 초과가 발생하면 공통 구간부터 확인하고, 일부 노드만 문제라면 해당 노드를 점검하세요. 기기 자체가 인터넷에 연결되는지, 활성 설정이 로드됐는지, 현재 네트워크에서 속도 측정 대상에 접근할 수 있는지 먼저 확인하세요. 특정 노드로 웹사이트가 열리는데 속도 측정만 시간 초과됐다면 노드를 사용할 수 없다고 단정하지 마세요. 속도 측정과 실제 요청이 모두 실패한다면 첫 연결 오류를 확인해 도메인 확인 실패, 원격 연결 시간 초과, 핸드셰이크 실패를 구분하세요. 일부 노드만 문제라면 같은 기기와 측정 대상으로 정상 노드와 비교한 뒤 설정을 새로고침할지 제공처에 문의할지 결정하세요.

시스템 프록시를 켰는데 왜 앱 트래픽이 프록시를 통과하지 않나요?

연결 페이지나 로그를 확인해 요청이 커널에 들어오지 않았는지, 들어온 뒤 규칙에 따라 직접 연결된 것인지 먼저 구분하세요. 기록이 없다면 시스템 프록시 주소와 포트가 커널의 수신 대기 설정과 일치하는지 확인하세요. 앱이 자체 프록시를 사용하는지, 시스템 우회 목록에 포함됐는지, 다른 소프트웨어가 프록시 설정을 덮어썼는지도 살펴보세요. 기록은 있지만 DIRECT로 표시된다면 시스템 프록시를 계속 켰다 끄지 말고 모드와 규칙을 확인하세요. 설정을 변경한 뒤에는 테스트 앱을 다시 실행하거나 새 연결을 만들어야 합니다. 기존 연결 때문에 변경 사항이 반영되지 않은 것처럼 보일 수 있습니다.

시작할 때 포트가 사용 중이라는 메시지가 표시되면 어떻게 해야 하나요?

시작 로그에서 충돌한 포트가 혼합 포트인지, 제어 포트인지, 다른 수신 대기 포트인지 먼저 확인하세요. 그런 다음 시스템 네트워크 모니터링 도구로 해당 포트를 사용하는 프로세스를 찾으세요. 백그라운드에서 이전 클라이언트가 계속 실행 중이거나 두 클라이언트가 같은 포트를 사용하는 경우가 흔합니다. 용도를 모르는 프로세스는 강제로 종료하지 마세요. 확인된 이전 인스턴스를 종료하거나 현재 클라이언트의 포트를 사용 가능한 값으로 바꿀 수 있습니다. 혼합 포트를 변경했다면 시스템 프록시와 프록시를 직접 설정한 앱의 포트도 함께 바꾸고, 커널을 다시 시작해 정상적으로 수신 대기하는지 확인하세요.

Clash 다운로드