· 문제 해결 · 약 7분 소요

Clash 구독 URL 오류와 가져오기 실패 해결 가이드

Clash 구독 가져오기가 실패하나요? 만료된 링크, 형식 호환성, 네트워크 차단, YAML 구문 오류를 원인별로 살펴보고 순서대로 점검하는 방법을 안내합니다.

먼저 실패한 단계 확인하기

현재 사용할 수 있는 기존 설정을 먼저 보존한 다음, Clash 클라이언트의 로그나 구독 업데이트 상세 정보를 엽니다. 수동 업데이트를 한 번 실행하고 시각을 기록한 뒤, 해당 시점의 첫 번째 오류를 찾으세요. 구독 가져오기는 응답 수신, 설정 파싱, 코어 로드의 세 단계를 거칩니다. 화면에 표시되는 ‘업데이트 실패’는 이 중 어느 단계에서든 발생할 수 있습니다.

오류 또는 증상우선 확인할 항목
401、403、404계정 상태, URL 전체 여부, 서버 접근 제한
no such host、timeout、x509도메인 확인, 연결 경로, 인증서 신뢰 여부
HTTP 200 응답인데 형식이 유효하지 않다고 표시됨응답이 설정 파일인지, 로그인 페이지인지, 일반 노드 목록인지
yaml: line 12 또는 unsupported proxy typeYAML 구조와 코어 지원 범위를 각각 확인

401·403·404 오류: URL과 계정 상태 확인

  1. 서비스 제공업체의 계정 페이지에서 URL을 다시 복사하세요. Clash 또는 mihomo용이라고 표시된 구독 항목을 선택합니다. 복사한 내용에 따옴표, 줄바꿈, 뒤에 붙은 공백이 없는지 확인하세요. 원래 쿼리 매개변수는 그대로 두고, ? 뒤의 내용을 직접 수정하거나 삭제하지 마세요. 화면에서 일부가 생략된 표시 텍스트를 복사하는 것도 피하세요.
  2. 유효 기간과 토큰 상태를 확인하세요. 계정에 로그인할 수 있다고 해서 기존 구독 URL도 유효한 것은 아닙니다. 최근에 결제를 갱신했거나 구독을 재설정했거나 서비스를 이전했다면, 계정 페이지에 현재 표시된 URL로 새 설정을 만든 뒤 정상적으로 로드되는 것을 확인하고 기존 항목을 교체하세요.
  3. 상태 코드로 원인을 좁히세요.401은 보통 인증 실패를 뜻합니다. 403은 요청이 거부된 상태로, 계정 권한이나 요청 빈도, 게이트웨이 정책이 원인일 수 있습니다. 404는 경로가 변경됐거나 서버가 리소스 상태를 숨기는 경우일 수 있습니다. 429는 요청이 너무 많다는 뜻이므로 서비스 제공업체의 안내에 따라 기다리고, 연속으로 새로고침하지 마세요.

브라우저에서는 열리는데 Clash 클라이언트에서 403 오류가 난다면 먼저 Safari에서 ‘파일’ → ‘새로운 비공개 윈도우’를 열어 확인하세요. 일반 윈도우에는 로그인 쿠키가 남아 있을 수 있지만, 구독 업데이트 프로그램은 브라우저 세션을 공유하지 않는 경우가 많습니다. 비공개 윈도우의 결과도 Clash 클라이언트와 완전히 같다고 볼 수는 없습니다. 요청 식별 정보와 연결 경로가 서로 다를 수 있기 때문입니다. 로그인해야만 내용이 보인다면 웹페이지 주소를 복사한 것은 아닌지 서비스 제공업체에 문의하세요.

시간 초과·파싱 실패·인증서 오류: macOS 네트워크 확인

현재 연결과 프록시 포트 확인

macOS 13 이상에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’를 엽니다. 웹 프록시와 보안 웹 프록시가 현재도 연결을 받는 주소를 가리키는지 확인하세요. 예를 들어 시스템 설정에는 127.0.0.1:7890이 입력되어 있는데 Clash 클라이언트의 혼합 포트가 7897로 바뀌었다면, 시스템 프록시를 사용하는 앱은 연결에 실패할 수 있습니다. 두 포트는 점검을 위한 예시이며 실제 설정은 Clash 클라이언트 화면을 기준으로 확인하세요.

구독 업데이트 프로그램이 시스템 프록시를 사용하는지는 Clash 클라이언트와 다운로드 설정에 따라 다릅니다. 설정을 바꾸기 전에는 업데이트가 됐다면 기존 설정으로 되돌려 확인하세요. 시스템 프록시나 TUN이 테스트에 영향을 줄 수 있다면, 허용된 네트워크에서 한 번에 설정 하나만 바꾸고 같은 구독 URL의 결과를 비교하세요. Safari에서 페이지가 열린다는 이유만으로 업데이트 프로그램도 접속할 수 있다고 단정하지 마세요.

DNS·시간 초과·TLS 오류 구분하기

  • no such host: 도메인 철자를 먼저 확인한 다음, 현재 네트워크 서비스의 ‘세부사항’에서 ‘DNS’를 확인하세요. 공용 Wi-Fi에 연결되어 있다면 네트워크 로그인 페이지에서 인증을 완료했는지도 살펴보세요.
  • i/o timeout: 오류가 이름 확인, 연결, 응답 대기 중 어느 단계에서 발생하는지 확인하세요. 가능하다면 허용된 다른 네트워크에서 다시 테스트합니다. 특정 네트워크에서만 실패한다면 해당 네트워크의 프록시나 접근 정책을 먼저 점검하고, 구독을 바로 재설정하지 마세요.
  • x509: certificate signed by unknown authority 또는 인증서 만료: ‘시스템 설정’ → ‘일반’ → ‘날짜 및 시간’에서 시스템 시간이 올바른지 확인하세요. 문제가 계속되면 네트워크 관리자나 서비스 제공업체에 문의하세요. 인증서 검증을 끄거나 출처가 불분명한 루트 인증서를 설치하지 마세요.

HTTP 200 응답인데 파싱 실패: 응답 형식 확인

200은 서버가 내용을 반환했다는 뜻일 뿐, 그 내용이 설정 파일이라는 뜻은 아닙니다. Clash 클라이언트에서 응답 미리보기를 지원한다면 첫 부분과 주요 필드를 확인하세요. <!doctype html>, 로그인 안내, 게이트웨이 안내가 보이면 응답이 웹페이지로 바뀐 원인을 찾아야 합니다. JSON 오류 객체가 보이면 서버의 오류 메시지부터 확인하세요. 파일 확장자를 .yaml로 바꿔도 형식은 달라지지 않습니다.

  • 완전한 설정 파일: 보통 proxies: 또는 proxy-providers:가 있으며, proxy-groups:와 rules:가 포함될 수도 있습니다. 최상위 필드와 참조 관계가 현재 코어의 요구 사항에 맞아야 합니다.
  • 프록시 제공자 참조용 데이터: 일부 YAML 파일에는 노드 목록만 들어 있으며 기존 설정의 proxy-providers에서 사용됩니다. 이런 URL을 받았다면 서비스 제공업체에 완전한 설정을 받을 수 있는지 먼저 문의하세요. 전체 설정을 그대로 대체할 수 있다고 단정하지 마세요.
  • 일반 노드 구독: 응답은 Base64 텍스트일 수도 있고 ss:// 같은 URI가 줄마다 나열된 형태일 수도 있습니다. 가져올 수 있는지는 Clash 클라이언트가 해당 형식을 명시적으로 지원하는지에 달려 있습니다. 지원하지 않는다면 서비스 제공업체가 안내하는 형식을 사용하세요.

같은 URL도 요청 식별 정보에 따라 서로 다른 형식으로 응답할 수 있습니다. 브라우저 미리보기와 로그의 내용이 다르다면 현재 사용하는 Clash 클라이언트용으로 서비스 제공업체가 안내한 URL을 우선 사용하세요. 로그에서 기본 설정 URL과 프록시 제공자 URL을 구분할 수 있다면 어느 쪽에서 실패했는지도 확인해야 합니다. 기본 설정 다운로드에 성공했다고 해서 그 설정이 참조하는 노드 데이터까지 업데이트된 것은 아닙니다.

YAML 행 번호 오류와 코어 오류: 나눠서 해결하기

행 번호가 표시되면 들여쓰기와 목록부터 확인

설정 파일을 복사한 뒤 로컬 일반 텍스트 편집기에서 엽니다. 로그에 12번째 행이 표시되더라도 11번째 행과 같은 깊이의 필드도 확인하세요. 파서는 다음 항목을 읽을 때 앞 항목의 따옴표, 콜론, 목록 표시가 빠진 사실을 발견하는 경우가 많습니다. 들여쓰기에는 탭 대신 공백을 사용하고, 같은 수준의 항목은 맞춰 정렬하세요. 아래는 규칙 목록 작성 방식만 보여 주는 예시이며 완전한 설정 파일은 아닙니다.

rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

원격 구독을 업데이트하면 직접 수정한 내용이 덮어써질 수 있습니다. 방금 받은 원본 응답부터 구문 오류가 있다면 민감 정보를 가린 행 번호와 오류 유형을 서비스 제공업체에 전달하세요. 오버라이드를 적용한 뒤에만 오류가 생긴다면 최근에 수정한 오버라이드부터 비활성화하고 복사본을 다시 가져와 확인하세요.

파싱은 되지만 로드되지 않는다면 코어 확인

unsupported proxy type은 들여쓰기 오류가 아닙니다. 현재 로더가 설정에 지정된 노드 유형을 지원하지 않는다는 뜻입니다. Clash 클라이언트의 ‘정보’ 화면이나 시작 로그에서 클라이언트 버전과 코어 버전을 확인하세요. 예를 들어 로그에 mihomo v1.19.0이라고 표시될 수 있습니다. 앱 화면의 버전은 코어 버전을 대신할 수 없습니다. Clash Meta(mihomo)용 설정에는 기존 Clash 코어가 인식하지 못하는 프로토콜이나 필드가 포함될 수 있으므로 서비스 제공업체의 안내와 코어 문서를 대조하세요.

프록시나 정책 그룹을 찾을 수 없다는 오류가 나오면 이름 참조를 확인하세요. rules의 대상은 내장 정책, 노드 또는 정책 그룹과 일치해야 합니다. 정책 그룹에 나열된 노드 이름도 실제로 존재해야 합니다. 특히 오버라이드에서 그룹 이름만 바꾸고 규칙은 그대로 두지 않았는지 살펴보세요. 오류가 난 행을 무작정 삭제하지 마세요. 마지막 기본 규칙을 지우거나 정책을 잘못 바꾸면 설정은 로드되더라도 트래픽 경로가 달라질 수 있습니다.

수정한 뒤 업데이트·로드·연결을 각각 확인

  1. 업데이트 확인. 수동 업데이트를 한 번 실행하고 해당 항목의 업데이트 시각과 로그를 확인해 새 응답인지 오래된 캐시인지 구분하세요. 원격 프록시 제공자를 사용한다면 그 업데이트 결과도 확인합니다.
  2. 로드 확인. 방금 가져온 설정을 직접 선택하고 코어가 이를 받아들였는지, 노드와 정책 그룹이 표시되는지 확인하세요. 업데이트에 성공했어도 설정을 전환하지 않았다면 화면에 기존 노드가 계속 표시될 수 있습니다.
  3. 연결 확인. 직접 연결될 것으로 예상되는 사이트와 프록시를 사용할 것으로 예상되는 사이트를 각각 열어 비교하고, 연결 로그에서 규칙과 아웃바운드가 예상대로인지 확인하세요. 노드만 시간 초과된다면 문제는 구독 가져오기가 아니라 노드 연결로 넘어간 것이므로 구독 URL을 계속 바꿀 필요는 없습니다.

문제가 계속되면 macOS 버전, Clash 클라이언트 버전, 코어 버전, 업데이트 시각, HTTP 상태 코드, 민감 정보를 가린 첫 번째 오류를 기록하세요. 허용된 다른 네트워크에서도 재현되는지 함께 적어 두면 좋습니다. 연결과 트래픽 처리 문제는 설정 문제 진단을 참고하세요.

Clash 다운로드