다운로드·파싱·설정 적용 단계 구분하기

원격 구독을 가져오는 과정은 콘텐츠 다운로드, 설정 파일 읽기, 설정 적용의 세 단계로 나뉩니다. 한 화면에서 연달아 진행되더라도 각 단계의 오류 원인은 다릅니다. 가져오기를 눌렀을 때인지, 수동 업데이트 중인지, 새 설정으로 전환할 때인지 먼저 기록하세요. Clash Verge Rev에서는 사이드바의 ‘구독’에서 설정을 관리하고, ‘로그’에서 설정 전환 후 코어가 출력한 오류를 확인할 수 있습니다. 버전에 따라 버튼 위치는 다를 수 있습니다. 다운로드에 실패했다면 구독 화면의 안내도 보관하세요. 콘텐츠가 코어에 전달되기 전에 요청이 실패했을 수 있습니다.

처음 나타난 구체적인 오류에 맞춰 점검하세요
오류 또는 증상먼저 확인할 항목
HTTP 401, 403, 404 또는 410서버가 접근을 거부했거나 경로를 사용할 수 없습니다. 현재 구독 주소와 계정 상태를 확인하세요.
no such host 또는 lookup … timeout구독 도메인 이름 조회와 현재 네트워크의 DNS 상태를 확인하세요.
certificate has expired or is not yet valid기기 시각, 인증서 유효 기간, 오류 메시지에 표시된 도메인을 확인하세요.
yaml: line 12와 같은 안내응답 본문이 YAML인지 확인한 다음, 로컬 파일의 12번째 줄과 그 앞부분을 살펴보세요.
설정은 가져왔지만 적용할 때 정책 그룹을 찾을 수 없다는 메시지가 표시됨규칙의 대상, 그룹 이름, 설정 병합 후의 참조 관계를 확인하세요.

구독 링크가 만료되었거나 사용할 수 없거나 로그인 페이지가 반환됨

  1. 구독 서비스 계정 페이지에서 서비스 상태를 확인하고 해당 클라이언트용 구독 주소를 다시 복사하세요. 주소가 예상한 https://로 시작하는지, 복사 과정에서 따옴표나 줄바꿈 또는 전체 안내 문구가 포함되지 않았는지 확인하세요. 쿼리 매개변수는 임의로 삭제하지 마세요.
  2. 서비스 제공자가 최근 구독 토큰을 재설정했는지 확인하세요. 계정 유효 기간과 링크 유효성은 별개입니다. 계정이 유효해도 토큰 재설정으로 기존 링크가 만료될 수 있습니다. 먼저 현재 사용할 수 있는 설정을 보관한 뒤, 제공자의 안내에 따라 주소를 갱신하거나 새 항목을 만들어 테스트하세요.
  3. 서비스 상태와 HTTP 응답을 함께 확인하세요. 401은 주로 인증 문제, 403은 서버의 요청 거부를 뜻하며 접근 정책이 원인일 수 있습니다. 404는 경로를 잘못 입력한 경우에도 발생합니다. 429는 요청이 너무 많다는 뜻입니다. Retry-After가 있으면 안내된 시간만큼 기다리고, 새로고침을 반복해서 누르지 마세요.

HTTP 200은 응답을 받았다는 뜻일 뿐입니다. 로그인 페이지, 공용 Wi-Fi 인증 페이지, 서버 오류 안내도 200으로 반환될 수 있습니다. 서비스에서 응답을 로컬에 저장할 수 있다면 텍스트 편집기로 앞부분을 확인하세요. <!doctype html>이나 <html>이 보이면 YAML을 수정하기 전에 웹페이지가 반환된 원인을 확인해야 합니다. 브라우저는 로그인 쿠키를 보낼 수 있지만 클라이언트 요청은 보통 같은 세션을 공유하지 않습니다. 따라서 브라우저에서 열리는 것만으로 구독을 가져올 수 있다고 단정할 수 없습니다.

네트워크 시간 초과·DNS·인증서 오류

먼저 구독 서버까지 요청이 도달하는지 확인하세요

HTTPS 주소에 포트가 명시되지 않았다면 보통 TCP 443으로 연결합니다. no such host는 도메인 이름 조회 단계의 오류입니다. dial tcp 뒤에 연결 시간 초과가 표시된다면 로그에 대상 IP가 나왔는지 확인하세요. timeout만으로는 DNS, 연결 수립, 서버 응답 지연 중 무엇이 원인인지 판단하기 어렵습니다. 먼저 현재 네트워크에서 필요한 로그인을 완료한 뒤, 사용할 권한이 있는 신뢰할 수 있는 다른 네트워크에서 한 번 비교 테스트하세요. 이때 링크와 설정은 그대로 두고 네트워크만 바꾸세요.

로그에 127.0.0.1의 특정 포트에 연결할 수 없다고 명시되어 있다면, 해당 포트와 로컬 클라이언트에 표시된 실제 수신 포트를 먼저 비교하세요. 시스템 프록시가 이미 종료된 클라이언트를 가리키거나, 아직 실행되지 않은 프록시를 통해 구독을 업데이트하도록 설정되어 있을 수 있습니다. 현재 설정을 기록한 다음 로컬 네트워크 연결을 정상화하고 다시 시도하세요. TUN을 켜도 만료된 토큰이나 잘못된 파일 형식은 해결되지 않습니다. 첫 가져오기 오류에 대한 기본 해결책으로 TUN을 켜는 것은 적절하지 않습니다.

기기 시간을 확인한 뒤 인증서 오류 원인을 구분하세요

Windows 11에서 ‘설정 → 시간 및 언어 → 날짜 및 시간’을 열고 ‘시간 자동 설정’을 확인한 다음 ‘지금 동기화’를 선택하세요. 표시된 날짜와 시간대도 확인해야 합니다. 시간을 동기화한 뒤에도 인증서 만료 오류가 계속되면 서비스 제공자에게 구독 도메인의 인증서 상태를 문의하세요. certificate signed by unknown authority가 표시되면 시스템의 신뢰 체인을 확인하거나 관리자에게 관리형 네트워크의 인증서 정책을 확인해 달라고 요청하세요. 구독을 가져오기 위해 인증서 검증을 끄지 마세요.

YAML 파싱 오류와 Clash·mihomo 형식 차이

구독은 콘텐츠를 전달하는 방식일 뿐, 형식이 하나로 정해져 있는 것은 아닙니다. 같은 제공자도 Clash 설정, mihomo용 설정, 일반 노드 목록을 각각 제공할 수 있습니다. 노드 URI 한 줄씩으로 구성된 텍스트나 인코딩된 노드 목록은 완전한 Clash YAML 설정으로 바로 가져올 수 없습니다. proxies 목록만 있는 파일은 예상한 프록시 그룹과 규칙이 포함된 기본 설정이 아니라, proxy-providers에서 참조하는 데이터일 수도 있습니다. 먼저 제공자 페이지에서 클라이언트 및 코어에 맞는 출력 형식을 선택하세요.

  • 문법 오류: 설정을 로컬에서 편집했다면 오류가 표시된 줄과 바로 앞부분의 들여쓰기 단계, 목록 항목 앞의 하이픈, 닫히지 않은 따옴표를 확인하세요. 들여쓰기에는 공백을 사용하세요. mapping values are not allowed in this context는 대개 구조에 문제가 있다는 뜻입니다. 오류 줄이 최초로 잘못 작성된 위치와 다를 수도 있습니다.
  • 지원하지 않는 필드 또는 프로토콜: Clash Meta는 이후 mihomo라는 이름으로 유지 관리되고 있습니다. 기존 Clash와 mihomo는 지원하는 설정 범위가 다릅니다. 예를 들어 기존 Clash는 hysteria2 노드를 지원하지 않습니다. 지원되지 않는 프록시 유형 오류가 발생하면 실제로 실행 중인 코어와 버전을 확인하세요. 클라이언트 이름만 봐서는 안 되며, 검증을 통과시키려고 프로토콜 이름을 다른 것으로 바꾸지 마세요.
  • 참조 오류: 설정을 읽었더라도 적용에 실패할 수 있습니다. 예를 들어 MATCH,手动选择 규칙은 ‘手动选择’이라는 정책을 참조합니다. 병합 및 덮어쓰기 과정에서 해당 정책의 이름이 바뀌거나 삭제되면 코어가 설정을 불러올 때 찾을 수 없다는 오류를 낼 수 있습니다. 원격 원본만 확인하지 말고 최종 적용된 설정을 살펴보세요.

원본 구독이 실제 설정 파일일 때만 로컬 복사본으로 문법 오류를 진단할 수 있습니다. 클라이언트가 로컬 파일 가져오기를 지원한다면 원본 그대로인 복사본으로 비교하세요. 로컬 파일은 적용되지만 원격 구독은 실패한다면 다운로드 경로와 응답 차이를 먼저 확인하세요. 둘 다 같은 줄에서 문법 오류가 난다면 원본 파일을 우선 점검하세요. 원격 업데이트로 로컬 수정 사항이 덮어써질 수 있습니다. 테스트를 마친 뒤 문제를 제공자에게 알리거나, 필요한 수정 사항을 클라이언트에서 지원하는 별도 덮어쓰기 설정에 보관하세요.

업데이트는 실패했지만 기존 설정은 남아 있을 때 재테스트하는 방법

기존 설정에 노드가 계속 표시된다면 클라이언트가 마지막으로 저장된 내용을 사용 중일 수 있습니다. 이것만으로 이번 업데이트에 성공했다고 판단할 수는 없습니다. 반대로 새 설정이 적용되었는데 사용할 노드가 없다고 해서 구독 가져오기 실패라고 단정할 수도 없습니다. 설정이 proxy-providers를 통해 노드를 별도로 가져온다면 기본 설정 URL과 제공자 URL은 서로 독립된 요청입니다. 로그에서 오류가 어느 항목과 관련된 것인지 확인한 뒤 기본 구독과 제공자 중 무엇을 점검할지 결정하세요.

  1. 현재 사용할 수 있는 설정을 보관하고 작업 시각, 클라이언트 및 코어 버전, 실패 단계, 처음 발생한 구체적인 오류를 기록하세요.
  2. 각 테스트에서는 조건을 하나만 바꾸세요. 예를 들어 계정 페이지에서 새로 복사한 링크로 바꾸거나 시간을 동기화합니다. 그런 다음 수동 업데이트를 한 번 실행하고 새 성공 기록이 생겼는지 확인하세요.
  3. 방금 업데이트한 설정이 적용되었는지 확인하세요. 예상한 정책 그룹과 노드 공급원이 불러와졌는지 살펴보세요. 노드 지연 시간 테스트는 설정 적용이 성공한 뒤에 진행해야 합니다. 지연 테스트 시간 초과가 발생했다면 노드나 테스트 대상을 별도로 확인해야 하며, 이를 근거로 구독이 만료되었다고 판단할 수는 없습니다.

원인을 찾지 못했다면 구독 제공자나 클라이언트 유지 관리 담당자에게 민감한 정보를 가린 기록을 전달하세요. 최초 가져오기 실패인지 업데이트 실패인지, 신뢰할 수 있는 다른 네트워크에서도 재현되는지, 로컬 복사본에서도 같은 오류가 발생하는지 설명하세요. 단순히 ‘가져오기가 안 된다’고 알리는 것보다 원인 범위를 좁히는 데 도움이 됩니다.