Clash / mihomo
Clash 자주 묻는 질문
설정 로드, 트래픽 가로채기, 규칙 매칭을 먼저 구분하세요. 증상에 맞는 항목을 선택한 뒤 업데이트 로그나 연결 목록에서 문제가 발생한 단계를 확인하세요.
기본 개념
클라이언트, 코어, 설정, 트래픽 진입 경로를 구분하세요. 화면에서 모드를 선택했다고 해서 트래픽이 실제로 코어에 들어오는 것은 아닙니다.
Clash 클라이언트와 mihomo 코어는 어떤 관계인가요?
클라이언트는 설정 가져오기, 정책 전환, 연결 상태 표시를 담당하고, mihomo 코어는 트래픽 수신, 규칙 매칭, DNS 처리를 담당합니다. 두 구성 요소의 버전은 서로 독립적입니다. 메뉴가 보이지 않으면 먼저 클라이언트 문서를 확인하세요. 설정 항목을 인식하지 못하면 시작 로그를 확인한 다음 실제로 로드된 코어 버전을 살펴보세요. 일부 클라이언트는 코어를 별도로 업데이트하므로 문제를 진단할 때 두 버전을 각각 기록해야 합니다. 클라이언트를 바꾸려면 먼저 구독 형식과 사용 중인 프로토콜을 지원하는지 확인한 뒤 설정을 옮기세요.
구독 링크, config.yaml, 노드는 어떻게 다른가요?
구독 링크는 설정이나 노드 목록을 가져오는 주소입니다. 완전한 config.yaml에는 포트, DNS, 규칙, 정책 그룹도 포함될 수 있습니다. 노드는 선택적으로 사용할 수 있는 아웃바운드 연결 하나일 뿐, 전체 설정을 대신하지는 않습니다. 가져온 뒤 노드만 표시되고 예상한 규칙이 없다면 링크가 전체 Clash 설정을 반환하는지 노드 목록만 반환하는지 먼저 확인하세요. 그런 다음 서비스 제공자의 설정을 사용할지, 기존 설정에 노드를 추가할지 결정하면 됩니다. 구독 주소에는 계정 식별 정보가 포함되는 경우가 많으니 스크린샷이나 공개 로그에 올리지 마세요.
규칙, 전역, 직접 연결 모드는 어떻게 선택하나요?
일상적인 사용에는 규칙 모드를 선택하세요. 코어는 설정에 적힌 규칙 순서에 따라 아웃바운드를 선택합니다. 전역 모드는 코어로 들어온 트래픽을 GLOBAL 정책 그룹에 전달하므로 짧은 비교 테스트에 적합합니다. 전환한 뒤에는 해당 그룹에서 어떤 아웃바운드가 선택되어 있는지도 확인해야 합니다. 직접 연결 모드는 코어로 들어온 트래픽을 프록시 아웃바운드 없이 전달하지만, 트래픽 가로채기 자체를 끄지는 않습니다. 클라이언트를 켰을 때와 껐을 때를 비교하려면 해당 시스템 프록시나 TUN을 끈 다음 다시 연결을 시도하세요.
시스템 프록시와 TUN은 어떻게 다르며, 둘 다 켜야 하나요?
시스템 프록시는 운영체제의 프록시 설정을 통해 요청을 클라이언트로 전달하며, 해당 설정을 따르는 앱에만 적용됩니다. TUN은 가상 네트워크 인터페이스와 라우팅을 사용해 트래픽을 가로채므로 시스템 프록시를 사용하지 않는 앱에도 적용할 수 있지만, 시스템 권한과 라우팅 설정이 필요합니다. 처음 설정할 때는 한 가지 방식만 켜고, 연결 목록에서 대상 요청이 코어에 들어오는지 확인하세요. 두 방식을 함께 켠 뒤 문제가 생기면 먼저 하나를 끄고 비교하세요. DNS, 아웃바운드, 분할 라우팅 규칙을 한꺼번에 바꾸지는 마세요.
설치 및 설정
가져오기에 실패하면 구독 업데이트 로그를 먼저 확인하고, 시작에 실패하면 코어 로그를 먼저 확인하세요. 두 로그의 오류는 서로 다른 단계를 가리킵니다.
구독 가져오기구독 업데이트에 401, 403, 404가 표시되면 만료된 건가요?
먼저 업데이트 로그에서 요청 결과를 확인하세요. 401은 보통 인증이 필요하거나 자격 증명이 승인되지 않았다는 뜻입니다. 403은 요청이 거부되었다는 뜻이며, 서비스 제공자가 요청 출처를 제한한 경우도 있습니다. 404는 주소가 변경되었을 수 있습니다. 서비스 제공자의 계정 페이지에서 구독 상태와 지원 형식을 확인한 뒤 새 Clash 또는 mihomo 구독 주소를 복사하세요. 새 설정이 정상적으로 검증될 때까지 기존 설정은 보관하세요. 로그에 HTTP 상태 코드 없이 시간 초과만 표시된다면 구독을 초기화하기보다 네트워크 연결부터 확인하세요.
설정을 가져왔는데 노드 목록이 비어 있는 이유는 무엇인가요?
먼저 가져온 설정이 현재 설정으로 지정되어 있는지 확인하세요. 그런 다음 시작 로그에서 YAML 파싱 실패, 지원되지 않는 항목, 존재하지 않는 정책 그룹 참조가 있는지 살펴보세요. proxy-providers를 사용하는 경우 설정 가져오기에 성공했더라도 기본 설정만 읽힌 것일 수 있으며, 원격 노드는 별도로 가져와야 합니다. 클라이언트의 제공자 페이지에서 업데이트 결과를 확인하고 로그인 페이지나 오류 페이지가 반환되지 않았는지 살펴보세요. 노드는 가져왔는데 정책 그룹이 비어 있다면 그룹의 use 참조와 필터 조건을 확인하세요.
TUN을 켤 때 권한 부족 오류가 표시되면 무엇을 확인해야 하나요?
Windows에서는 클라이언트 문서에서 서비스 모드 설치 및 활성화를 요구하는지 먼저 확인하고, 서비스가 실행 중인지 살펴보세요. 권한 상승이 필요하다면 명확한 설치 또는 시작 단계에만 권한을 부여하세요. Android에서는 시스템 VPN 설정에서 해당 클라이언트에 권한을 부여했는지 확인하고, 다른 VPN이 연결을 사용 중인지 살펴보세요. 그래도 시작되지 않으면 로그에 표시된 장치 또는 라우팅 오류를 기록하고, 클라이언트가 지원하는 범위에서 관련 설정을 확인하세요. 시스템 보안 기능부터 끄지는 마세요.
시작할 때 mixed-port가 사용 중이라고 나옵니다. 포트를 바꾸면 되나요?
바꿀 수 있지만 먼저 다른 인스턴스가 해당 포트를 사용 중인지 확인하세요. 기존 클라이언트가 시스템 트레이에서 계속 실행 중이거나 그래픽 클라이언트와 독립 코어가 동시에 실행되는 경우가 흔합니다. 중복 실행 중이라면 하나를 종료하고 정상적으로 다시 시작하세요. 두 인스턴스를 함께 실행해야 한다면 각각 다른 로컬 포트를 할당하고 프록시 주소를 수동으로 설정한 앱도 함께 수정하세요. 마지막으로 시스템 프록시가 현재 인스턴스를 가리키는지 확인해, 화면에는 정상으로 표시되지만 요청은 이전 포트로 전송되는 상황을 방지하세요.
Clash 노드 속도 테스트에서 시간 초과가 나오면 사용할 수 없는 건가요?
반드시 그런 것은 아닙니다. 속도 테스트 결과는 해당 노드로 지정된 테스트 주소에 접속한 결과일 뿐, 모든 대상에 대한 상태를 나타내지는 않습니다. 먼저 같은 그룹의 다른 노드와 비교한 뒤 실제로 접속하려는 사이트를 테스트하고, 연결 목록에서 사용 중인 아웃바운드를 확인하세요. 테스트 주소 하나에만 연결되지 않으면 해당 주소에 접속할 수 있는지 먼저 확인하세요. 하나의 노드로 여러 대상에 계속 연결할 수 없다면 해당 노드 상태를 확인하거나 서비스 제공자의 공지를 살펴보세요. 한 번의 테스트 결과만으로 설정을 삭제하지 말고, 같은 네트워크에서 다시 테스트하면 원인을 찾기 쉽습니다.
규칙 모드에서 프록시를 사용해야 할 사이트가 DIRECT로 연결되는 이유는 무엇인가요?
규칙은 순서대로 매칭되며, 처음 일치한 규칙으로 대상 정책이 결정됩니다. 연결 목록에서 해당 요청을 열고 매칭된 규칙과 최종 아웃바운드를 확인하세요. 포괄적인 직접 연결 규칙이 먼저 적용됐다면 더 구체적인 규칙을 그 앞에 배치하세요. 예상한 규칙이 적용됐는데도 직접 연결된다면 해당 정책 그룹에서 DIRECT가 선택되어 있는지 확인하세요. 로그에 도메인 없이 IP만 표시되면 매칭 범위를 바로 넓히지 말고 코어가 도메인 정보를 가져올 수 있는지 먼저 확인하세요. 수정한 뒤에는 기존 연결을 닫고 요청을 다시 보내세요.
구독을 업데이트한 뒤 로컬에서 수정한 규칙이 사라지는 이유는 무엇인가요?
클라이언트가 구독을 새로고침할 때 원격 설정의 로컬 복사본을 새 내용으로 덮어쓸 수 있어, 복사본을 직접 수정하면 변경 사항이 사라집니다. 사용자 지정 규칙을 별도의 오버라이드 또는 병합 설정으로 저장한 다음, 클라이언트 문서에 따라 대상 구독에 연결하세요. 먼저 적용되어야 하는 규칙은 규칙 목록 앞부분에 추가하고, MATCH 뒤에 넣지 마세요. 저장한 뒤 실행 중인 설정에서 새 규칙의 존재 여부와 위치, 참조 정책 그룹의 유효성을 확인하세요. 마지막으로 구독을 직접 새로고침해 변경 사항이 유지되는지 확인하세요.
TUN을 켠 뒤 프린터나 NAS에 접속할 수 없으면 어떻게 복구하나요?
먼저 TUN을 끄고 로컬 네트워크 접속이 복구되는지 확인한 다음, 장치의 실제 IP 주소와 서브넷을 기록하세요. TUN을 다시 켠 뒤 IP 주소로 직접 접속해 보세요. IP로는 접속되지만 장치 이름으로는 안 된다면 로컬 네트워크 DNS나 장치 검색 기능을 먼저 확인하세요. IP로도 접속할 수 없다면 라우팅이 겹치는지 확인하고, 클라이언트가 지원하는 방식으로 실제 사용 중인 로컬 네트워크 서브넷을 제외하세요. 수정한 뒤 로컬 장치와 외부 사이트를 각각 테스트하고, 모든 사설 주소 대역을 한꺼번에 제외하지 마세요.
시스템 프록시를 켰는데 앱이 Clash를 사용하지 않습니다. 원인을 어떻게 찾나요?
먼저 브라우저에서 새 페이지를 열고 클라이언트의 연결 목록을 확인하세요. 브라우저 요청은 기록되는데 대상 앱은 기록되지 않는다면 해당 앱이 시스템 프록시를 따르지 않거나 별도 설정을 사용하는 경우가 많습니다. 앱의 프록시 옵션을 확인하거나 TUN으로 비교 테스트해 보세요. 둘 다 기록되지 않으면 시스템 프록시 주소와 수신 대기 포트, 코어 실행 상태를 확인하고 시스템이 이전 자동 프록시 설정을 계속 사용하는지도 살펴보세요. 연결은 기록되지만 직접 연결된다면 매칭된 규칙과 정책 그룹을 확인하세요.
브라우저는 정상인데 Windows UWP 앱에서 로컬 프록시를 사용할 수 없습니다. 어떻게 해야 하나요?
앱이 127.0.0.1을 가리키는 시스템 프록시를 사용한다면 먼저 일반 데스크톱 앱에서 같은 포트를 사용할 수 있는지 확인하세요. 일부 UWP 앱에서만 문제가 발생할 때 AppContainer의 로컬 루프백 제한을 고려하면 됩니다. 클라이언트에 UWP 루프백 설정이 있다면 안내에 따라 문제가 있는 앱에만 예외를 적용한 뒤 해당 앱을 완전히 종료하고 다시 시작하세요. 설정을 바꿔야 할지 확실하지 않다면 시스템에서 허용하는 범위 내에서 TUN을 먼저 테스트하세요. 조직에서 관리하는 장치는 관리자 정책을 따르세요.
Clash DNS 유출이나 예상과 다른 DNS 조회 경로를 어떻게 확인하나요?
먼저 사용하려는 업스트림 리졸버와 로컬 DNS로 조회해야 하는 도메인을 확인하세요. 트래픽 가로채기 방식은 일시적으로 하나만 사용하고, 문제가 발생한 도메인과 테스트 시간을 기록한 뒤 클라이언트 로그 및 시스템 DNS 설정과 비교하세요. 브라우저의 보안 DNS는 다른 경로를 사용할 수 있으므로 같은 네트워크에서 기능을 켰을 때와 껐을 때를 각각 테스트하세요. 테스트 페이지에 표시된 리졸버의 위치만으로는 유출 여부를 판단할 수 없습니다. 실제 요청 경로와 설정에서 기대한 동작을 기준으로 판단하세요.
Clash를 종료한 뒤에도 인터넷에 연결할 수 없으면 어떻게 복구하나요?
클라이언트를 다시 열고 화면에서 시스템 프록시와 TUN을 끈 다음 정상적으로 종료하세요. 클라이언트를 시작할 수 없다면 시스템 네트워크 설정에서 프록시가 더 이상 연결을 받지 않는 로컬 포트를 가리키는지 확인하세요. 이번에 직접 활성화한 설정만 해제하고, 회사나 학교에서 설정한 프록시는 그대로 두세요. DNS를 수동으로 변경했다면 기존 값으로 되돌린 다음 네트워크에 다시 연결해 확인하세요. 모든 네트워크 설정을 초기화하면 기존 고정 IP나 내부 네트워크 설정이 사라질 수 있으므로 피하세요.