문제 진단 · 증상별 확인

Clash 문제 해결 가이드

처음 설치하고 구성을 가져와 연결하는 과정이라면 사용 가이드의 빠른 시작을 따라가세요. 이 가이드는 이미 문제가 발생했을 때 참고할 수 있도록 마련했습니다. 목차에서 가장 가까운 증상을 선택해 비교 테스트를 진행한 다음, 튜토리얼의 해당 단계를 다시 확인하세요. 한 번에 한 항목만 변경하고 이전 값, 테스트 시간, 결과를 기록하세요. 효과가 확인되지 않은 변경은 되돌리세요.

인터넷 연결 안 됨: 먼저 직접 연결을 복구한 뒤 트래픽 가로채기 범위를 확인하세요

클라이언트 없이 기준 연결 상태 확인하기

먼저 기기 전체가 인터넷에 연결되지 않는지, 특정 웹사이트나 앱만 열리지 않는지 확인하세요. 진행 중인 작업을 저장한 뒤 클라이언트에서 시스템 프록시와 TUN을 차례로 끄고 정상 종료하세요. 창만 닫지 마세요. 데스크톱 클라이언트는 트레이에서 계속 실행되는 경우가 많아 창이 사라져도 수신 대기 포트가 닫힌 것은 아닙니다. 종료한 다음 시스템 네트워크 설정에서 프록시 상태를 확인하고, 로컬 주소를 가리키는 설정이 남아 있지 않은지 살펴보세요. 회사나 학교에서 설정한 프록시는 오류로 남은 설정이 아닙니다. 원래 값을 기록하고 임의로 삭제하지 마세요.

평소 접속할 수 있는 서로 무관한 웹사이트 두 곳을 다시 열고, 같은 네트워크에 연결된 다른 기기에서도 확인하세요. 두 기기 모두 접속할 수 없다면 클라이언트를 다시 설치하기보다 Wi-Fi 인증, 게이트웨이 또는 상위 네트워크를 먼저 점검하세요. 게스트 네트워크는 로그인 페이지에서 이용 약관에 동의해야 할 수 있습니다. 트래픽 가로채기를 끈 상태에서 로그인한 뒤 다시 테스트하세요. 현재 기기만 직접 연결에 실패한다면 유효한 IP 주소와 기본 게이트웨이를 할당받았는지, 다른 VPN이나 네트워크 필터링 프로그램이 트래픽을 가로채고 있지는 않은지 확인하세요. ping이 한 번 실패했다고 연결이 끊긴 것은 아닙니다. 일부 서버는 ICMP 요청에 응답하지 않습니다.

앱 요청부터 실제 외부 연결까지 추적하기

직접 연결이 복구되면 클라이언트를 다시 시작하고 트래픽 가로채기 방식 하나만 켜세요. 데스크톱 브라우저는 먼저 시스템 프록시로 테스트하고 TUN은 동시에 켜지 마세요. TUN이 필요한 앱에서만 문제가 생긴다면 시스템 프록시는 끈 채 TUN 상황만 재현하세요. 매번 같은 주소로 요청을 한 번 보내고, 바로 연결 목록에서 같은 시각의 기록을 찾으세요. 연결 목록은 기록 보관용이 아니므로 짧은 요청은 금세 사라질 수 있습니다. 재현 전에 로그를 열어 두면 기록이 없다는 이유만으로 요청이 커널에 전달되지 않았다고 오해하는 일을 줄일 수 있습니다.

관찰 결과다음 확인 항목
앱에서 요청했지만 커널에 해당 로그가 없음앱이 시스템 프록시를 사용하는지, 대상 주소를 우회하는지, 로컬 수신 대기가 시작됐는지 확인하세요.
규칙에 매칭되어 DIRECT로 연결됨같은 대상으로 직접 연결을 테스트해 해당 규칙이 예상대로 적용되는지 확인하세요.
REJECT에 매칭됨적용된 거부 규칙을 찾으세요. 잘못된 매칭임을 확인한 경우에만 해당 대상의 규칙을 조정하세요.
프록시 그룹에 진입한 뒤 연결 오류가 발생함정책 경로를 펼쳐 그룹 이름뿐 아니라 최종 선택된 노드까지 확인하세요.

클라이언트에 구성을 가져왔다는 표시는 파일이 관리 목록에 추가됐다는 뜻일 뿐입니다. 해당 구성이 현재 구성으로 선택됐고 커널이 정상적으로 불러왔는지 확인하세요. 오버라이드 스크립트나 병합 구성을 수정했다면 화면에 보이는 원본 구독이 현재 실행 중인 설정과 다를 수 있습니다. 적용된 구성과 해당 연결의 매칭 기록을 우선 확인하세요. 규칙은 일반적으로 위에서 아래로 적용되므로 앞쪽의 범위가 넓은 규칙이 대상을 먼저 가로채면 뒤에 있는 올바른 규칙은 실행되지 않을 수 있습니다.

모드를 전환해 비교 테스트하기

규칙 모드에서 실패하지만 정상 작동이 확인된 같은 노드로 잠시 전역 모드를 사용했을 때 대상이 열린다면 규칙 모드의 매칭 항목을 확인하세요. 전역 모드와 규칙 모드는 정책 그룹 선택을 각각 저장할 수 있습니다. 전환하기 전에 실제 노드가 같은지 확인하지 않으면 규칙과 노드 두 가지 변수가 함께 바뀝니다. 두 모드 모두 실패하지만 트래픽 가로채기를 끄자마자 정상 작동한다면 대상 하나만 정해 로컬 수신 대기와 외부 연결을 각각 확인하세요. 브라우저에서만 실패하고 다른 앱은 정상이라면 클라이언트보다 브라우저의 개별 프록시 설정과 확장 프로그램을 먼저 점검하세요.

수정한 뒤에는 클라이언트 아이콘 색상만 확인하지 말고, 원래 실패했던 작업을 다시 실행해 보세요. 자주 쓰는 사이트가 직접 연결되는지, 프록시가 필요한 대상은 예상한 정책에 매칭되는지 확인하세요. 재시작 후에만 문제가 다시 생긴다면 로그인 시점에 클라이언트가 이미 실행 중이었는지, 그 뒤 커널이 정상적으로 준비됐는지, 시스템이 이전 프록시 설정을 먼저 복구했는지 기록하세요. 재현 순서로 시작 시점의 문제와 지속적인 설정 오류를 구분할 수 있습니다.

노드 시간 초과: 탐지 실패, 핸드셰이크 실패, 대상 연결 불가를 구분하세요

일괄 속도 측정을 비교 가능한 단일 요청으로 줄이기

클라이언트에 표시되는 밀리초 값은 대개 테스트 주소로 보낸 요청의 결과이며, 노드와 기기 사이의 왕복 시간과는 다릅니다. 테스트에는 DNS 확인, 연결 설정, 프로토콜 협상, 대상 서버 응답 등이 포함될 수 있고, 측정 범위는 커널 구현에 따라 다릅니다. 시간 초과는 정해진 시간 안에 요청이 완료되지 않았다는 뜻입니다. 모든 노드에서 동시에 시간 초과가 발생한다면 클라이언트의 실제 인터넷 연결, 테스트 주소의 작동 여부, 최근 구성 업데이트 여부를 먼저 확인하세요. 일부 노드에서만 발생한다면 테스트 주소와 로컬 네트워크를 고정하고 정상 노드 하나와 실패 노드 하나를 각각 테스트하세요.

정책 화면에서 노드 하나를 직접 선택한 다음 지연 시간 테스트와 다른 자주 쓰는 대상으로 접속하고, 연결 상세 정보에서 실제로 해당 노드를 거쳤는지 확인하세요. 자동 그룹이 노드를 전환하는 동안 수동으로 문제를 확인하지 마세요. 한 페이지에서 여러 요청이 발생할 수 있고 노드가 바뀌면 전후 로그를 직접 비교하기 어렵습니다. 테스트 주소는 실패하지만 실제 서비스는 정상이라면 제공업체가 권장하는, 안정적인 소량 응답을 반환하는 주소로 다시 확인하세요. 실제 서비스도 실패한다면 첫 오류를 보존하고 오류가 발생한 단계에 따라 점검하세요.

오류가 발생한 단계 파악하기

로그의 no such host는 대개 DNS 확인 실패를 뜻하지만, 확인에 실패한 대상이 노드 서버인지 접속하려는 대상인지 살펴보세요. 노드 서버의 DNS 확인이 실패하면 프록시 서버에 연결조차 할 수 없어 브라우저를 바꿔도 해결되지 않을 수 있습니다. 접속 대상의 DNS 문제라면 프로토콜, 라우팅 정책, DNS 확인 위치를 함께 확인하세요. connection refused는 어느 지점에서 연결이 명시적으로 거부됐다는 뜻입니다. 대상 포트에서 수신 대기 중이 아니거나 중간 장비가 거부 응답을 반환했을 수 있습니다. 연결 시간 초과가 계속되는 경우에는 이처럼 명확한 응답이 없으므로, 해당 로그 한 줄만으로 서비스 중단, 라우팅 패킷 손실, 경로 제한을 구분할 수 없습니다.

로그에 인증서 만료, 이름 불일치, 신뢰할 수 없는 인증서가 표시된다면 먼저 시스템 날짜, 시간대, 시간을 동기화하세요. 이어서 노드 구성의 서버 주소, 서버 이름, 전송 설정이 제공업체의 원본 설정과 일치하는지 확인하세요. 주소 필드와 인증서 검증에 사용되는 이름은 서로 다를 수 있으므로 다르다는 이유만으로 동일하게 바꾸지 마세요. 인증서나 핸드셰이크 오류를 검증 비활성화로 덮어서는 안 됩니다. 인증 실패가 발생했다면 현재 최신 구성으로 연결 중인지 확인하고, 자격 증명을 갱신해야 한다면 제공업체에서 받으세요. 로그에서 복사하거나 공개하지 마세요.

단일 노드 문제인지, 네트워크 문제인지, 탐지 설정 문제인지 확인하기

같은 노드를 다른 네트워크에서도 테스트하세요. 기존 네트워크에서 실패했다면 사용 권한이 있는 휴대전화 핫스팟으로 바꿔 볼 수 있습니다. 두 네트워크에서 모두 실패하지만 같은 그룹의 다른 노드는 정상이라면 노드 이름과 오류 발생 시각을 기록해 제공업체에 상태를 확인하세요. 특정 네트워크에서만 실패한다면 같은 기기, 노드, 대상으로 반복 테스트하세요. 결과가 계속 같을 때 해당 네트워크의 외부 연결 경로를 조사할 근거가 생깁니다. 핫스팟 테스트 결과는 데이터 요금제, 신호 상태, 휴대전화 설정의 영향을 받을 수 있으므로 한 번의 성공이나 실패는 참고 정보로만 활용하세요.

자동 그룹 탐지와 구독 업데이트는 서로 다른 기능입니다. url-test는 그룹에 포함된 후보 노드에 탐지 요청을 보내고 정책에 따라 선택하며, 프록시 제공자의 health-check는 제공자에 등록된 노드를 대상으로 합니다. 두 곳 모두 탐지를 설정했다면 현재 확인 중인 결과가 어느 쪽에서 나온 것인지 먼저 확인하세요. 시간 초과를 해결하려고 간격을 지나치게 짧게 설정하지 마세요. 짧은 간격의 요청이 몰리면 일시적 혼잡이 커지고 로그를 해석하기도 어려워집니다. 먼저 한 번의 테스트가 성공하는지 확인한 뒤 주기적 탐지를 켜고, 몇 차례 실행한 결과가 안정적인지 살펴보세요.

노드 전환 시에만 연결이 끊긴다면 새 요청과 이미 연결된 요청을 나눠 살펴보세요. 새 요청은 새 노드를 사용하더라도 장시간 연결은 계속 유지되거나 앱에서 다시 연결해야 할 수 있습니다. 테스트 페이지를 닫았다가 다시 열거나 단일 전송을 끝낸 뒤 다시 시도하세요. 모든 연결을 초기화할 필요는 없습니다. 결과를 해석하는 방법은 노드 지연 시간 테스트 원리를 참고하세요.

구독 오류: 다운로드, 파싱, 적용 단계를 구분하세요

먼저 다운로드가 성공했는지 확인하기

구성 관리 화면에서 해당 구독을 선택해 한 번 수동 업데이트하고 알림, 실행 시각, 로그를 확인하세요. 다운로드 단계에서 실패한다면 도메인 확인 실패, 연결 시간 초과, 인증서 오류가 있는지 먼저 살펴보세요. HTTP 응답을 받았다면 상태 코드를 확인하세요. 401은 대개 인증과 관련이 있고, 403은 권한, 접근 정책 또는 서비스 측 제한을 뜻할 수 있습니다. 404는 이전 링크가 만료됐거나 해당 리소스가 공개되지 않았다는 의미일 수 있습니다. 상태 코드는 다음 확인 단계를 정하는 기준이지, 계정이 미납되거나 정지됐다는 증거는 아닙니다.

제공업체의 관리 페이지에서 구독이 유효한지 확인하고 현재 클라이언트나 Clash 형식에 맞는 링크를 복사하세요. 경로와 쿼리 매개변수를 기억에 의존해 수정하지 마세요. 복사할 때 공백이나 줄 바꿈이 섞이지 않았는지, 웹페이지 공유 주소를 잘못 복사하지 않았는지 확인하세요. 제공업체가 링크를 새로 발급했다면 기존 링크가 더 이상 작동하지 않을 수 있습니다. 브라우저에서 관리 페이지가 열린다고 클라이언트에서도 구독을 다운로드할 수 있다는 뜻은 아닙니다. 두 연결은 서로 다른 프록시를 사용하거나 다른 요청 헤더를 보내고 로그인 상태를 공유하지 않을 수 있습니다. 구독 링크를 공개 변환 사이트나 온라인 진단 도구에 입력하지 마세요.

업데이트 요청이 현재 프록시를 사용하지만 사용 가능한 노드가 하나도 없다면 업데이트로 문제를 해결할 수 없을 수 있습니다. 클라이언트에서 다운로드 방식을 별도로 지정할 수 있는지 확인하세요. 현재 네트워크에서 제공업체에 직접 연결할 수 있다면 업데이트 작업에 한해서만 다운로드 방식을 바꾸세요. 그렇지 않다면 연결 가능 여부가 확인된 다른 네트워크에서 다시 시도하세요. 업데이트가 끝나면 원래 설정으로 되돌리세요. 현재 작동 중인 기존 구성을 처음부터 삭제하지 마세요. 실패할 경우를 대비해 복구할 수 있도록 먼저 사본을 남겨 두세요.

요청은 성공했지만 가져온 내용을 구성으로 불러올 수 없음

HTTP 200은 서버가 어떤 내용이든 성공적으로 반환했다는 뜻일 뿐입니다. 로그인 페이지, 인증 페이지, 오류 안내나 다른 클라이언트 전용 공유 링크가 반환될 수도 있습니다. 전체 구성과 proxy-providers에 사용하는 노드 목록은 용도가 다릅니다. 전체 구성에는 정책 그룹과 분할 라우팅 규칙이 포함될 수 있고, 노드 목록은 대개 기본 구성에서 참조합니다. 노드 목록을 전체 구성으로 가져오면 가져오기 성공으로 표시되더라도 필요한 정책이 없을 수 있습니다. 먼저 링크 유형을 확인한 다음 클라이언트에서 어느 단계에 오류가 표시되는지 살펴보세요.

줄 번호가 포함된 YAML 오류가 나오면 해당 줄과 바로 위 몇 줄을 오프라인에서 확인하세요. 흔한 원인은 잘못된 들여쓰기, 탭을 이용한 들여쓰기, 정렬되지 않은 목록 항목, 문자열로 처리하지 않은 콜론 뒤 공백이 있는 일반 텍스트입니다. 파서가 더 이상 진행할 수 없게 된 줄이 오류 위치로 표시될 수 있으므로 실제 문제는 앞부분에 있을 수도 있습니다. 지원되지 않는 프로토콜, 필드 또는 그룹 유형을 가리킨다면 알 수 없는 항목을 삭제하기보다 현재 사용하는 커널을 먼저 확인하세요. 필드를 임의로 삭제하면 파일은 불러올 수 있어도 프로토콜 매개변수, 정책 참조 또는 규칙 동작이 사라질 수 있습니다.

업데이트는 성공했지만 이전 구성이나 노드를 계속 사용함

구독 목록에서 어떤 항목이 현재 구성으로 선택됐는지 확인한 다음 커널이 정상적으로 다시 불러왔는지 살펴보세요. 다운로드 성공이 해당 구성으로 자동 전환됐다는 뜻은 아닙니다. 업데이트 후 정책 그룹에서 기존 노드를 찾을 수 없다면 노드 이름이 바뀌었거나 서비스가 종료됐는지 확인하고, 아직 존재하는 노드를 직접 선택하세요. 로컬 오버라이드, 병합, 필터를 사용 중이라면 새 구독을 별도 구성으로 검증한 뒤 로컬 변경 사항을 단계별로 다시 적용하세요. 원격 구성에 많은 내용을 직접 수정하면 다음 다운로드에서 덮어쓸 수 있습니다.

때로는 기본 구성이 업데이트됐지만 중첩된 프록시 제공자는 이전 캐시를 계속 사용합니다. 이 경우 기본 구성의 업데이트 시각만 보지 말고 제공자 화면에서 마지막 업데이트 시각, 오류, 노드 수를 확인하세요. proxy-providers의 HTTP 제공자에 있는 interval은 초 단위입니다. 한 번 수동 업데이트해 실제 가져오기가 되는지 확인하고, 주기 설정은 다운로드와 적용이 모두 성공한 뒤 조정하세요. 각 필드의 의미는 구성 파일 항목별 해설에서 확인할 수 있습니다. 클라이언트를 바꿔야 한다면 다운로드 센터에서 기기에 맞는 권장 옵션인 Clash Plus 또는 다른 호환 클라이언트를 선택하세요. 이전하기 전에 로컬 규칙을 백업하세요.

속도 저하: 노드, 연결 경로, 기기 부하를 비교해 원인을 찾으세요

먼저 어떤 속도 문제가 나타나는지 구분하기

웹페이지를 누른 뒤 한참 동안 빈 화면이 보인다면 DNS 확인, 연결 설정, 첫 바이트 수신까지의 대기 시간을 살펴보세요. 다운로드가 빠르게 시작한 뒤 곧 느려지면 지속 전송 속도와 짧은 시간 동안의 변동을 확인하세요. 화상 회의 화면이 끊긴다면 패킷 손실, 지터, 노드 전환 시점을 살펴보는 편이 좋습니다. 세 가지 증상이 함께 나타날 수 있지만, 한 번 측정한 지연 시간 순위로 모든 문제를 설명할 수는 없습니다. 반복해서 접속할 수 있고 테스트를 허용하는 대상을 하나 선택하세요. 대용량 파일을 테스트할 때는 같은 파일이나 서비스로 제한된 횟수만 전송하고, 데이터 사용량이 제한된 네트워크에서는 반복 다운로드를 피하세요.

테스트 대상, 기기, 위치를 동일하게 유지하세요. 먼저 트래픽 가로채기를 끈 직접 연결을 테스트하고, 다음으로 노드를 고정해 테스트한 뒤 노드만 바꿔 다시 확인하세요. 대상이 원래 직접 연결을 지원하지 않는다면 접근 가능한 다른 대상으로 로컬 기준을 확인할 수 있지만, 서로 다른 대상의 속도를 정확한 비교값으로 취급하지 마세요. 브라우저 캐시와 기존 연결 재사용으로 두 번째 접속은 더 빠를 수 있습니다. 새 세션으로 첫 접속을 다시 테스트해 첫 연결과 반복 접속 결과를 구분하세요. 전송 속도 단위도 확인해야 합니다. 초당 바이트와 초당 비트는 8배 차이가 있으므로 비교 전에 같은 단위로 변환하세요.

구간별 시간 측정으로 범위 좁히기

아래 두 명령은 curl을 사용할 수 있는 POSIX 셸용입니다. 첫 번째 명령은 프록시를 명시적으로 해제하고 두 번째 명령은 로컬 HTTP 프록시를 지정합니다. 7890을 클라이언트에서 사용하는 HTTP 또는 혼합 포트 번호로 바꾸세요. 직접 연결을 비교하기 전에 TUN을 끄세요. 앱의 프록시를 해제해도 시스템 라우팅을 우회할 수는 없습니다. 여기서 사용하는 작은 페이지는 핸드셰이크와 첫 바이트를 확인하기 위한 것이며, 지속적인 대역폭을 측정하는 용도가 아닙니다.

curl --noproxy '*' --max-time 20 -o /dev/null -sS \
  -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} first=%{time_starttransfer} total=%{time_total}\n' \
  https://example.com/
curl --noproxy '' --proxy http://127.0.0.1:7890 --max-time 20 -o /dev/null -sS \
  -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} first=%{time_starttransfer} total=%{time_total}\n' \
  https://example.com/

시간 값은 초 단위이며 요청 시작부터 누적된 값이지, 서로 독립된 다섯 구간의 소요 시간이 아닙니다. 로컬 프록시를 사용할 때 연결 시간은 주로 로컬 수신 대기와 연결되는 과정을 나타내며, 클라이언트의 DNS 측정이 원격 대상의 DNS 확인을 포함하지 않을 수도 있습니다. 따라서 프록시 명령의 connect 값이 작다고 연결 경로가 빠르다고 판단하지 마세요. 첫 바이트와 전체 소요 시간이 반복해서 길어지는지 살펴보고, 커널 로그를 함께 확인해 프록시에 진입하기 전 대기와 실제 외부 연결 후 대기를 구분하세요.

반복 확인할 수 있는 차이를 기준으로 대응하기

같은 네트워크에서 특정 노드 하나만 계속 느리다면 최저 지연 시간에 집착하기보다 안정적인 다른 노드로 바꿔 보세요. 여러 노드가 특정 시간대에만 느려진다면 같은 테스트를 시간대를 바꿔 반복 기록해 공유 경로의 혼잡과 관련이 있는지 확인하세요. 모든 노드와 직접 연결이 느리다면 클라우드 드라이브 동기화, 시스템 업데이트 등 대용량 작업을 먼저 일시 중지하세요. 가정용 Wi-Fi라면 유선 연결을 사용하거나 공유기 가까이에서 다시 테스트할 수 있습니다. 다른 네트워크에서 개선됐다고 원래 네트워크가 속도를 제한한다고 단정할 수는 없습니다. 채널 간섭이나 업로드 포화도 비슷한 증상을 일으킬 수 있습니다.

직접 연결과 시스템 프록시는 정상인데 TUN만 느리다면 같은 대상을 사용해 TUN이 추가 앱이나 DNS 요청까지 가로채고 있는지 확인하세요. 처음부터 MTU를 임의로 바꾸지 마세요. 작은 요청은 성공하지만 대용량 전송이 반복해서 멈추는 등 재현 가능한 증상이 있을 때만 클라이언트 문서를 따라 조금씩 시험하고 기존 값을 저장하세요. 브라우저 페이지의 일부 리소스만 느리다면 기본 웹사이트와 이미지·스크립트가 있는 다른 도메인 중 어느 쪽에서 실패하는지 살펴보고 각 연결이 어떤 규칙에 매칭됐는지 확인하세요. 기본 페이지와 정적 리소스가 서로 다른 경로를 거치는 것은 정상일 수 있습니다. 페이지가 완전히 표시되는지보다 실제로 실패한 요청을 기준으로 조정 여부를 판단하세요.

속도 저하의 단계별 진단 사례는 느린 인터넷 속도 단계별 문제 해결을 참고하세요. 마지막으로 처음 문제가 발생한 작업을 다시 실행해 지속 다운로드 속도, 페이지 첫 접속, 통화 안정성을 확인하세요. 지연 시간이 줄어든 것은 해당 탐지가 빨라졌다는 뜻일 뿐입니다.

DNS 문제: 누가 무엇을 조회해 어떤 결과를 받았는지 확인하기

DNS 확인 실패와 연결 실패 구분하기

사이트 이름만 기록하지 말고 오류가 발생한 도메인을 적어 두세요. 웹페이지 하나가 여러 도메인의 리소스를 요청할 수 있어 일부 리소스의 DNS 확인에 실패해도 브라우저에 제목이나 오래된 캐시가 표시될 수 있습니다. 먼저 아래 명령으로 시스템 기본 DNS 경로를 확인한 다음, 오류가 발생한 앱에서의 동작과 비교하세요. 조회에 성공했다는 것은 해당 명령에서 결과를 받았다는 뜻일 뿐, 브라우저, TUN, 프록시의 외부 연결이 같은 DNS 서버를 사용한다는 의미는 아닙니다.

nslookup -type=A example.com
nslookup -type=AAAA example.com

문제가 발생한 도메인으로 바꾸면 다시 확인할 수 있습니다. AAAA 레코드가 없다고 도메인이 존재하지 않는 것은 아닙니다. 주소가 반환된 뒤 연결에 실패했다면 외부 연결 경로, 포트, IPv6 연결 상태를 점검하세요. 확인한 IP 주소를 HTTPS 테스트용으로 브라우저 주소창에 바로 입력하지 마세요. 도메인은 인증서 검증과 가상 호스트 선택에 영향을 주므로 IP로 접속하지 못했다고 해당 주소에 연결할 수 없는 것은 아닙니다. 두 네트워크에서 비교할 때 공용 사이트가 서로 다른 주소를 반환하는 것도 분산 라우팅에 따른 정상 동작일 수 있습니다.

mihomo DNS 필드와 증상 연결하기

적용된 구성에서 먼저 dns.enable을 확인하고, 커널 DNS가 실제 요청을 받았는지 살펴보세요. 커널 DNS를 켰다고 모든 앱이 자동으로 해당 서버에 질의하는 것은 아닙니다. 앱 자체의 암호화 DNS를 사용하거나 시스템이 기존 DNS 서버로 계속 요청을 보낼 수 있습니다. 특정 브라우저에서만 문제가 발생한다면 브라우저의 보안 DNS 설정을 기록하고 시스템 DNS를 사용하는 방식으로 잠시 비교한 뒤 원래 값으로 되돌리세요. TUN을 사용할 때만 문제가 발생한다면 시스템 DNS 설정 화면만 보고 결론을 내리지 말고 클라이언트가 생성한 DNS 가로채기 설정과 커널 로그를 확인하세요.

필드기능진단 시 확인할 점
nameserver일반 도메인 조회에 사용할 상위 DNS 서버입니다.현재 네트워크에서 상위 DNS 서버에 연결할 수 있는지 확인하고 요청 시간 초과와 서버의 부정 응답을 구분하세요.
nameserver-policy조건에 맞는 도메인에 사용할 DNS 서버를 지정합니다.문제가 발생한 도메인이 잘못된 DNS 범위로 전달되지 않았는지 확인하세요.
proxy-server-nameserver프록시 노드 도메인을 조회할 상위 DNS 서버를 지정합니다.노드에 연결할 수 있어야 노드를 조회할 수 있는 순환 의존성을 방지하세요.
fake-ip-filter조건에 맞는 도메인에 fake-IP 할당을 제외합니다.호환되지 않는 것이 확인된 대상에만 예외를 설정하고 해당 앱에서 검증하세요.

도메인 이름을 사용하는 암호화 DNS 서버를 상위 서버로 지정할 때는 상위 서버의 최초 도메인 조회 방식도 고려해야 합니다. 시작 직후 연속해서 요청이 실패하다가 연결이 설정된 뒤 정상화된다면 상위 DNS 서버 도메인 확인, 노드 도메인 확인, DNS 가로채기 설정이 서로 의존하는지 살펴보세요. 사내 도메인에 조직 또는 로컬 네트워크의 DNS 서버가 필요하다면 전체 설정을 외부 DNS 서버로 바꾸지 마세요. 관리 가능한 도메인 범위에 한해 설정을 나누고 검증해 프린터, 파일 공유, 사내 서비스에 영향이 없는지 확인하세요.

fake-IP와 캐시가 결과에 미치는 영향 이해하기

fake-ip 모드에서는 커널이 매핑된 주소를 반환한 뒤 연결이 들어올 때 도메인을 복원할 수 있습니다. 매핑 주소가 보인다고 곧바로 DNS 오류는 아닙니다. 앱이 매핑 주소를 받았지만 이를 복원할 수 있는 트래픽 가로채기 경로를 거치지 않는 경우에만 가로채기 범위나 해당 도메인의 예외 설정을 확인하세요. 네트워크나 DNS 모드를 바꾼 뒤 문제가 시작됐다면 앱이 이전 응답을 캐시했을 수 있습니다. 영향을 받는 앱을 종료한 뒤 다시 실행하세요. 필요한 경우 운영체제 방식에 따라 기기의 DNS 캐시를 비운 다음 같은 네트워크에서 재확인하세요.

설정을 조정한 뒤 공용 도메인 하나, 원래 실패했던 도메인 하나, 업무에 필요한 로컬 네트워크 도메인 하나 이상을 다시 확인하세요. 각 대상에서 DNS 조회 결과와 연결 설정 결과를 모두 살펴보세요. 공용 사이트만 복구되고 사내 도메인에 문제가 생겼다면 완전히 해결된 것이 아닙니다. 커널별 필드와 기본 동작은 mihomo와 Clash 원본의 차이를 참고하세요. 다른 클라이언트용 구성을 현재 환경에 통째로 붙여 넣지 마세요.

시스템 프록시 미작동: 시스템 설정부터 앱 동작까지 확인하기

로컬 수신 대기를 확인한 뒤 시스템 연결 설정 점검하기

시스템 프록시는 해당 설정을 따르는 앱에 요청을 전달할 주소를 알려 줄 뿐, 직접 수신 대기를 하지는 않습니다. 먼저 커널이 실행 중인지, 구성의 mixed-port 또는 HTTP 수신 대기 포트와 시스템에 입력된 포트가 일치하는지 확인하세요. 데스크톱의 시스템 프록시는 일반적으로 127.0.0.1 같은 기기의 루프백 주소를 가리킵니다. 클라이언트에서 포트 재설정에 실패했는데 시스템 프록시만 설정됐다면 브라우저는 수신 대기 중인 서비스가 없는 주소에 접속하려고 합니다. 커널 시작 로그에서 포트 바인딩 오류를 확인하세요. 포트가 이미 사용 중이라면 먼저 해당 프로세스가 무엇인지 확인하고, 현재 클라이언트에 비어 있는 포트를 지정한 뒤 시스템 설정에도 같은 포트를 입력하세요.

curl을 사용할 수 있는 터미널에서 실제 HTTP 또는 혼합 포트를 지정해 아래 명령으로 프록시 연결을 테스트하세요. Windows PowerShell에서는 명령을 curl.exe로 입력할 수 있습니다. 클라이언트에서 SOCKS 수신만 지원한다면 HTTP 문법으로는 확인할 수 없습니다. 실제 프로토콜을 사용하거나 HTTP 프록시 설정을 사용하는 앱에 맞게 해당 수신 기능을 켜세요. 요청에 성공한 뒤에도 연결 상세 정보에서 정책이 예상대로 적용됐는지 확인하세요. 상태 코드 응답을 받았다는 것은 연결이 HTTP 응답 단계까지 도달했다는 뜻일 뿐입니다.

curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 15 -I https://example.com/

앱이 어느 설정을 읽는지 확인하기

플랫폼설정 경로혼동하기 쉬운 동작
Windows설정 → 네트워크 및 인터넷 → 프록시데스크톱 앱, WinHTTP를 사용하는 프로그램, 서비스가 같은 프록시 설정을 사용하는 것은 아닙니다.
macOS시스템 설정 → 네트워크 → 현재 네트워크 서비스 → 세부사항 → 프록시네트워크 어댑터를 전환하면 새 네트워크 서비스의 프록시 설정이 다를 수 있습니다.
Linux데스크톱 환경의 네트워크 프록시 설정 또는 앱 자체 설정명령줄 도구는 환경 변수나 자체 설정 파일만 읽을 수 있습니다.

프록시를 직접 지정한 요청은 성공하지만 일반 실행한 앱에서 실패한다면 앱이 시스템 프록시, 별도의 수동 프록시, 자동 구성 스크립트 중 무엇을 사용하는지 또는 직접 연결하는지 확인하세요. 우회 목록도 점검하세요. 로컬 주소를 우회하는 것은 일반적으로 의도된 동작이지만 도메인 접미사 범위가 너무 넓으면 대상까지 잘못 우회할 수 있습니다. 터미널 도구는 https_proxy, no_proxy 같은 환경 변수를 사용하는 경우가 많습니다. 데스크톱 설정을 바꿔도 이미 실행 중인 터미널 프로세스의 환경 변수는 바뀌지 않을 수 있습니다. 새 앱 창을 열거나 앱을 완전히 다시 시작해 비교하고, 기존 연결을 재사용하고 있지 않은지 확인하세요.

브라우저 확장 프로그램, 네트워크 관리 소프트웨어, 다른 클라이언트가 번갈아 시스템 프록시 설정을 덮어쓸 수도 있습니다. 먼저 스위치를 켰을 때 시스템 설정 화면이 실제로 바뀌는지 확인하고 잠시 기다린 뒤 설정이 되돌아가는지 살펴보세요. 조직 정책이 프록시 설정을 복구한다면 기존 정책을 유지하고 관리자 지침에 따라 설정하세요. 자동 구성 스크립트를 사용하는 경우에는 원래 값을 확인할 수 있고 변경 권한이 있는 환경에서만 수동 프록시와 분리해 임시로 테스트하세요. 용도를 알 수 없는 설정을 바로 삭제하면 기존 네트워크 연결이 끊길 수 있습니다.

TUN 사용 여부를 결정하고 종료 후 설정 복구 확인하기

시스템 프록시를 사용하지 않는 앱이 있거나 시스템 프록시로 처리할 수 없는 트래픽을 다뤄야 한다면 TUN 사용을 검토하세요. 처음 테스트할 때는 다른 트래픽 가로채기 방식을 끄고 가상 네트워크 어댑터, 라우팅, DNS가 클라이언트의 예상대로 설정됐는지 확인하세요. TUN은 추가 권한과 라우팅 범위를 사용하며 로컬 네트워크 연결을 바꿀 수도 있습니다. 브라우저만 프록시를 사용하려는 경우에는 기기 전체에서 TUN을 켜기보다 브라우저와 시스템 프록시의 연동을 먼저 해결하세요.

조정 후 연결 로그에서 대상이 예상한 규칙에 매칭되는지 확인하세요. 이어서 클라이언트에서 프록시를 정상 종료하고 앱을 닫은 뒤, 종료된 포트를 가리키는 시스템 설정이 남지 않았는지 확인하세요. 부팅 후에만 문제가 발생한다면 클라이언트 두 개가 자동 실행되는지, 시스템이 이전 프록시 주소를 먼저 복구하는지, 앱이 시작될 때 커널이 준비됐는지 살펴보세요. 최초 연결의 전체 확인 순서는 구독을 가져온 뒤 첫 연결하기를 참고하세요.

클라이언트 충돌: 인터페이스 종료, 커널 종료, 구성 로드 거부 구분하기

문제 상황을 보존하고 어느 구성 요소가 종료됐는지 확인하기

창을 열 때, 구성을 불러올 때, TUN을 켤 때, 구독을 업데이트할 때, 절전 모드에서 깨어날 때 중 언제 문제가 발생했는지 기록하세요. 작업 표시줄 아이콘이 사라져도 핵심 프로세스가 종료된 것은 아닐 수 있고, 창이 응답하지 않아도 인터페이스만 멈췄을 수 있습니다. 트레이 아이콘, 프로세스 목록, 기존 시작 로그를 먼저 확인하세요. 인터페이스가 사라졌지만 프록시 요청은 계속 처리된다면 인터페이스 프로세스를 우선 점검하세요. 인터페이스가 실행 중인데 커널 오프라인 메시지가 표시된다면 커널의 종료 원인과 로컬 수신 대기를 살펴보세요. 가져오기 중 줄 번호가 표시된 검사 오류가 발생했다면 대개 구성이 거부된 것입니다. 클라이언트 전체가 충돌했다는 뜻은 아닙니다.

종료 전후의 짧은 로그 구간과 처음 나타난 오류를 먼저 저장하세요. 마지막에 반복해서 기록된 재시작은 대개 결과일 뿐입니다. 그보다 앞에 나온 바인딩 실패, 파일 읽기 오류, 권한 거부가 원인 파악에 더 중요합니다. 유지관리 담당자에게 보낼 때는 민감 정보를 가린 사본을 사용하세요. 클라이언트가 종료된 뒤 시스템 프록시가 닫힌 수신 포트를 계속 가리킨다면 인터넷 연결 안 됨 항목에 따라 원래 네트워크 설정을 복구하세요. 다운로드나 파일 쓰기가 진행 중일 때는 정상적으로 종료하세요. 강제 종료를 반복해 운에 맡기지 마세요.

최소한의 변경으로 구성과 실행 환경 분리하기

업데이트나 가져오기 후에만 문제가 생겼다면 로컬 구성, 규칙, 오버라이드를 백업한 뒤 이전에 작동했던 구성으로 전환해 보세요. 인터페이스에 접근할 수 있다면 먼저 화면에서 이전 상태로 되돌리세요. 시작할 때마다 즉시 종료된다면 해당 클라이언트 문서에서 사용자 데이터 폴더를 확인하고 관련 프로세스를 모두 종료한 뒤 문제가 의심되는 구성 파일이나 폴더의 이름을 바꾸어 보존하세요. 그런 다음 기본 상태로 시작하세요. 용도를 모르는 상태에서 앱 데이터를 통째로 삭제하지 마세요. 폴더에는 구독, 로그, 기본 설정, 제공자 캐시가 함께 들어 있을 수 있습니다. 삭제하면 문제 증거와 복구 지점을 모두 잃을 수 있습니다.

독립형 mihomo를 사용하고 명령줄에서 실행할 수 있다면 내장 테스트 모드로 구성 파일 하나를 확인할 수 있습니다. 아래 명령은 현재 폴더에 config.yaml이 있다고 가정합니다. 구성에서 제공자 파일, 규칙 집합 또는 다른 의존 항목을 참조한다면 진단 환경의 데이터 폴더와 커널을 실제 실행 환경과 동일하게 맞추세요. 다른 커널에서 테스트를 통과해도 데스크톱 클라이언트에서 통과한다고 볼 수는 없습니다. 구성 테스트는 실제 실행과 다르며 포트, 시스템 권한, 트래픽 가로채기 기능이 정상인지 보장하지도 않습니다.

mihomo -t -f ./config.yaml

기본 상태로 실행할 수 있다면 오버라이드와 기존 캐시는 복원하지 말고 기본 구성만 먼저 적용하세요. 정상적으로 불러온 것을 확인한 다음 변경 항목을 하나씩 복원하세요. 특정 항목을 복원했을 때 종료된다면 최소한의 재현 환경을 보존하고 같은 환경에서 다시 확인하세요. TUN을 켤 때만 종료된다면 서비스 권한, 가상 네트워크 어댑터, 다른 VPN과의 충돌을 중점적으로 확인하세요. 항상 관리자 권한으로 실행하는 것을 기본 해결책으로 삼지 마세요. 일반 권한에서 발생하는 경로 문제나 서비스 설치 오류를 가릴 수 있습니다.

설치 파일과 시스템 환경 확인하기

기본 상태에서도 반복해서 종료된다면 운영체제, 프로세서 아키텍처, 클라이언트 릴리스 정보를 확인하세요. 커널 실행과 그래픽 인터페이스 실행은 다릅니다. 전자는 후자의 인터페이스 의존성이 없어도 작동할 수 있습니다. 시스템의 앱 오류 기록에서 문제 모듈을 확인하세요. 프로그램 파일이 격리됐거나 시스템 정책에 의해 차단됐다는 메시지가 나타나면 보호 기능을 끄지 마세요. 먼저 프로그램 출처와 조직 기기의 설치 요건을 확인하세요. 업데이트 전후를 비교할 때는 가능한 한 같은 구성으로 테스트해 새 구성의 호환성 문제를 설치 파일의 회귀 문제로 오해하지 않도록 하세요.

클라이언트를 바꿔야 한다면 먼저 클라이언트 비교를 확인하고 다운로드 센터에서 운영체제와 아키텍처에 맞는 항목을 선택하세요. 지원되는 플랫폼에서는 Clash Plus를 우선 선택할 수 있습니다. 문제를 해결한 뒤에는 정상 종료와 재시작을 한 번 이상 진행하고 기본 구성, 기존 구성, 충돌이 발생했던 작업을 각각 확인하세요. 계속 재현된다면 운영체제와 아키텍처, 발생 순서, 기본 상태에서 실행되는지, 처음 나타난 오류를 알려 주세요. 사용자 데이터 폴더 전체를 제출할 필요는 없습니다.

모바일 문제: VPN 트래픽 가로채기, 백그라운드 실행, 네트워크 전환

시스템 권한과 현재 트래픽 가로채기 앱 확인하기

모바일 클라이언트는 대개 시스템 VPN 인터페이스로 트래픽을 가로챕니다. 클라이언트에서 연결 버튼을 눌렀다는 것과 시스템 VPN이 실제로 활성화됐다는 것은 별개의 문제입니다. 처음 연결할 때는 시스템 권한을 승인해야 합니다. 승인한 뒤 시스템 VPN 설정에서 현재 연결된 항목의 이름을 확인하고 고정된 대상에 접속해 클라이언트 연결 기록과 비교하세요. 시스템의 VPN 아이콘은 VPN 기능이 연결 상태라는 뜻일 뿐, 선택한 노드가 작동한다는 증거는 아닙니다. 다른 VPN, 콘텐츠 필터, 조직에서 관리하는 네트워크 설정이 있다면 실제로 어떤 항목이 트래픽을 가로채는지 확인하세요. 조직에서 설정한 항목은 제거하지 마세요.

Android에는 항상 켜짐 VPN과 VPN을 사용할 수 없을 때 트래픽을 차단하는 설정도 있을 수 있습니다. 클라이언트를 끈 뒤 기기 전체에서 인터넷이 되지 않는다면 노드만 바꿔 보지 말고 이러한 설정이 켜져 있는지 확인하세요. 업무 프로필이나 앱별 제외 목록을 사용한다면 개인 앱과 업무 앱의 트래픽 가로채기 범위가 다를 수 있습니다. 특정 앱에서만 프록시가 적용되지 않는다면 허용 목록 또는 제외 목록에 해당 앱이 있는지 확인한 뒤 다른 앱에서 같은 도메인에 접속해 비교하세요. 공용 IP 조회 결과 하나만으로 기기 전체의 라우팅을 판단하지 마세요.

화면 잠금 후 연결 끊김과 네트워크 전환 후 연결 끊김 분리하기

먼저 변수를 나눠 두 가지로 테스트하세요. 첫 번째 테스트에서는 같은 Wi-Fi와 같은 노드를 유지한 채 앱을 앞에 둔 상태에서 연결한 뒤 화면을 잠그세요. 몇 분 후 잠금을 해제하고 VPN 상태와 새 요청이 계속되는지 기록하세요. 두 번째 테스트에서는 화면을 켠 상태로 Wi-Fi에서 모바일 데이터로 전환하고 시스템이 새 네트워크를 사용할 수 있다고 확인한 뒤 요청을 다시 시작하세요. 첫 번째 테스트에서 실패하면 백그라운드 제한을 확인하고, 두 번째 테스트에서 실패하면 새 네트워크의 연결 가능성, 터널 재설정, 앱의 장시간 연결을 살펴보세요. 기존 연결이 끊겼다고 재연결되지 않았다는 뜻은 아니므로 새 요청을 보내 확인하세요.

Android의 절전 및 백그라운드 관리 경로는 기기마다 다릅니다. 화면이 잠긴 뒤 클라이언트가 종료됐다는 근거가 있을 때만 시스템이 백그라운드 실행을 제한하는지 확인하세요. 기존 값을 기록하고 설정 하나만 변경한 뒤 화면 잠금 해제 동작과 대기 중 배터리 사용량을 비교하세요. Android의 백그라운드 유지 방법을 iOS에 그대로 적용할 수는 없습니다. iOS에서는 시스템 VPN 상태, 클라이언트의 주문형 연결 지원 여부, 오류 시점의 네트워크 변경 기록을 확인하세요. 잠금 해제 후 수동으로 연결해야만 복구된다면 현재 네트워크에 주문형 규칙이 적용되는지, 관리 정책이 동작을 제한하는지 살펴보세요.

Wi-Fi에서는 되지만 모바일 데이터에서는 작동하지 않는다면 먼저 트래픽 가로채기를 끄고 해당 앱과 클라이언트에 모바일 데이터 사용 권한이 있는지 확인한 뒤 다시 켜서 테스트하세요. 반대로 특정 Wi-Fi에서만 연결할 수 없다면 먼저 네트워크 인증을 마치고, 노드 주소 확인 실패인지 연결 시간 초과인지 특정 대상만 사용할 수 없는 정책으로 처리되는지 기록하세요. 액세스 포인트를 바꾸면 라우팅과 DNS 결과가 모두 달라질 수 있습니다. 같은 노드와 대상으로 비교해야 결과를 근거로 활용할 수 있습니다.

로컬 네트워크, 앱별 라우팅, 복구 순서 확인하기

TV 화면 공유, 프린터 검색, 로컬 파일 접근은 로컬 네트워크 경로를 사용하며 일부 기능은 브로드캐스트나 멀티캐스트에도 의존합니다. 공용 인터넷에 접속된다고 로컬 네트워크 서비스까지 작동하는 것은 아닙니다. 먼저 VPN을 끈 상태에서 대상 기기에 접속하고 양쪽 기기가 서로 접근할 수 있도록 허용된 네트워크에 연결됐는지 확인하세요. 게스트 Wi-Fi는 기기 간 통신을 차단할 수 있습니다. VPN을 켰을 때만 찾을 수 없다면 클라이언트에 로컬 네트워크 트래픽 우회나 앱별 설정이 있는지 확인하고 시스템의 로컬 네트워크 접근 권한도 점검하세요. 검색 기능을 고치려고 클라이언트의 수신 대기를 로컬 네트워크 전체에 개방하지 마세요. 두 설정은 서로 다른 기능입니다.

복구 순서에 따라 확인하세요. 먼저 Wi-Fi에서 새 연결을 테스트하고, 다음으로 모바일 데이터에서 새 연결을 테스트한 뒤 마지막으로 화면 잠금과 이전 네트워크에서 전환하는 동작을 살펴보세요. 변경 사항이 원인이라면 기존 값으로 되돌린 뒤 같은 조건에서 한 번 더 테스트해 일시적인 신호 변화를 배제하세요. 클라이언트를 다시 설치하거나 바꿔야 한다면 구독 링크와 로컬 구성을 먼저 보존하세요. Android 다운로드 또는 iOS 다운로드에서 기기에 맞는 항목을 선택하세요. 클라이언트마다 설정 이름이 다를 수 있으므로 시스템의 트래픽 가로채기 상태와 실제 연결 기록을 기준으로 진단하세요.

최신 Clash 다운로드