Clash 구독 링크 가져오기: 설정 형식 확인, 업데이트 및 자주 발생하는 오류

구독을 가져오기 전에 링크와 클라이언트 상태를 확인하세요

Clash 구독 링크는 일반적으로 액세스 인증 정보가 포함된 HTTPS 주소입니다. 클라이언트가 이 주소로 요청을 보내면 서버는 Clash 설정 파일, 노드 목록 또는 요청 특성에 따라 변환된 설정 내용을 반환합니다. 가져오기는 소프트웨어에 URL을 저장하는 것만으로 끝나지 않습니다. 클라이언트는 네트워크 요청을 보내고, 응답을 읽고, 텍스트 형식을 판별하고, 프록시 필드를 파싱한 뒤 결과를 Clash Meta(mihomo) 코어에 전달해 로드해야 합니다. 따라서 브라우저에서 링크가 열린다고 해서 현재 클라이언트가 반드시 이를 인식할 수 있는 것은 아닙니다.

작업을 시작하기 전에 사용 중인 구독 주소가 아직 유효한지 확인하세요. 복사할 때 메신저가 만든 줄임표, 줄바꿈, 링크 양쪽의 공백이 포함되지 않도록 하고, 물음표 앞까지만 복사하지도 마세요. 일부 구독은 경로 또는 쿼리 매개변수에 인증 정보를 넣으므로 문자 하나만 빠져도 로그인 페이지, 오류 페이지 또는 빈 응답이 반환될 수 있습니다. 구독 주소는 설정에 접근하기 위한 인증 정보와 같으므로 스크린샷, 로그 공유 페이지 또는 공개 코드 저장소에 올리지 않는 것이 안전합니다.

Clash Verge Rev와 mihomo 코어가 정상적으로 시작되는지도 확인해야 합니다. 클라이언트가 코어 시작 실패, 포트 사용 중 또는 설정 디렉터리 쓰기 불가 상태라면 다운로드에 성공해도 설정이 적용되지 않을 수 있습니다. 먼저 클라이언트의 설정 또는 실행 상태 영역을 열어 코어가 실행 중인지 확인한 다음 원격 설정을 가져오세요.

Clash 구독 형식은 어떻게 확인하나요?

Clash Verge Rev에 바로 가져오기에 가장 적합한 형식은 구조가 완전한 Clash YAML 설정입니다. 일반적으로 포트, 실행 모드, DNS, 프록시 노드, 정책 그룹 및 규칙 등의 필드를 포함합니다. 서비스마다 생성하는 필드 수는 다르지만, 일반적인 구성은 다음과 같습니다.

mixed-port: 7890
mode: rule
proxies:
  - name: Example-HK
    type: ss
    server: edge.example.net
    port: 443
    cipher: aes-128-gcm
    password: sample-password
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - Example-HK
      - DIRECT
rules:
  - MATCH,Proxy

위 내용은 YAML 구조를 보여 주기 위한 예시일 뿐입니다. 실제 설정의 노드 유형, 인증 필드와 전송 매개변수는 서버에서 올바르게 생성해야 합니다. YAML은 들여쓰기에 민감하며 계층은 보통 공백으로 표시합니다. Tab 문자, 잘못된 들여쓰기 또는 닫히지 않은 따옴표가 파일에 포함되면 파싱에 실패할 수 있습니다.

완전한 Clash 설정

완전한 설정은 일반적으로 proxies, proxy-groups, rules를 함께 제공하므로 가져온 뒤 바로 선택 가능한 정책 그룹을 구성할 수 있습니다. 최신 설정에는 rule-providers, proxy-providers, dns, tun, sniffer 등의 필드가 추가로 포함될 수 있습니다. mihomo는 Clash Meta 확장 필드를 폭넓게 지원하지만, 설정은 해당 버전의 필드 정의를 따라야 합니다.

Base64로 인코딩된 노드 목록

또 다른 유형의 구독은 Base64로 인코딩된 URI 목록을 반환합니다. 디코딩하면 여러 줄의 ss://, trojan://, vmess:// 또는 vless:// 주소가 표시될 수 있습니다. 이 형식은 범용 노드 구독이며 완전한 Clash 설정이 아닐 수 있습니다. 정책 그룹, 규칙 및 DNS 설정이 없는 경우가 많아 바로 가져올 수 있는지는 클라이언트 버전, 구독 변환 기능 및 서버의 반환 방식에 따라 달라집니다. 가져온 뒤 형식이 잘못되었다는 메시지가 표시되면 동일한 범용 링크를 반복해서 제출하지 말고, 구독 서비스의 형식 옵션에서 Clash 또는 Clash Meta를 선택하세요.

단일 노드 URI와 웹 페이지 내용

단일 프로토콜 URI는 연결 노드 하나만 설명하며 완전한 구독과는 다릅니다. 일부 클라이언트는 전용 메뉴에서 단일 노드를 추가할 수 있지만, 원격 설정 메뉴는 일반적으로 저장하고 업데이트할 수 있는 설정 내용을 기대합니다. 링크를 열었을 때 계정 센터, 인증 코드 페이지, 로그인 화면, JSON 오류 객체 또는 HTML 문서가 표시된다면 반환된 내용은 Clash YAML이 아닙니다. 주소를 잘못 복사했거나 인증이 만료되었거나 로그인이 필요하거나 요청이 중간 페이지로 리디렉션된 것이 흔한 원인입니다.

Proxy Provider 원격 노드 집합

proxy-providers는 Clash 설정에서 원격 노드 제공자를 구성하는 기능입니다. 기본 설정에서 원격 YAML 노드 집합을 참조하고 지정한 간격으로 업데이트할 수 있습니다. 이는 Clash Verge Rev 설정 페이지에서 전체 원격 구독을 추가하는 것과는 다른 계층입니다. 전자는 실행 중인 코어가 기본 설정에 따라 노드 집합을 가져오고, 후자는 클라이언트가 전체 설정 파일을 관리합니다. 문제를 해결할 때는 오류가 클라이언트의 설정 다운로드에서 발생했는지, 코어가 로드된 뒤 provider 업데이트에서 발생했는지 먼저 구분해야 합니다.

Clash Verge Rev에서 구독 링크 가져오기

버전에 따라 화면의 문구는 조금 다를 수 있지만, 일반적인 경로는 ‘구독’ 또는 ‘설정’ 페이지에 있습니다. 가져온 직후 모든 네트워크 문제를 노드 탓으로 돌리지 말고, 설정이 선택되었는지, 코어가 정상적으로 다시 로드되었는지, 프록시 진입점이 켜져 있는지 먼저 확인하세요.

전체 구독 주소를 복사합니다.
구독 서비스의 설정 페이지에서 Clash 또는 Clash Meta용 주소를 복사하세요. 여러 형식을 제공한다면 mihomo와 호환되는 설정을 우선 선택하고, QR 코드 이미지 주소나 웹 공유 주소를 구독 링크로 사용하지 마세요.
설정 관리 페이지를 엽니다.
Clash Verge Rev의 설정 또는 구독 영역으로 이동해 새로 만들기, URL 가져오기 또는 원격 설정 메뉴를 찾습니다. 원격 구독은 URL 입력란을 사용하고, 로컬에 저장한 YAML 파일은 로컬 파일 가져오기를 사용해야 합니다. 두 방식은 업데이트 방법이 다릅니다.
링크를 붙여 넣고 제출합니다.
주소가 정상적인 프로토콜로 시작하는지 확인하세요. 일반적으로 https://로 시작합니다. 제출한 뒤 클라이언트가 다운로드와 파싱을 완료할 때까지 기다리세요. 네트워크가 느릴 때 동일한 항목을 여러 개 연속으로 만들면 현재 사용 중인 설정을 확인하기 어려워질 수 있습니다.
이름과 업데이트 시간을 확인합니다.
가져오기에 성공하면 설정 목록에 새 원격 설정 항목이 표시됩니다. 합리적인 이름, 업데이트 시간 및 사용 가능 상태가 표시되는지 확인하세요. 이름이 무작위 문자열이라면 알아보기 쉬운 이름으로 바꿀 수 있지만 원격 주소 자체는 수정하지 마세요.
설정을 선택하고 활성화합니다.
설정을 목록에 추가했다고 해서 현재 설정이 되는 것은 아닙니다. 새 항목을 선택하고 코어 로드가 완료될 때까지 기다린 다음 프록시 페이지에서 정책 그룹을 확인하세요. 설정에 규칙 집합이 많다면 처음 로드할 때 rule provider 파일도 다운로드해야 할 수 있습니다.
정책을 선택하고 프록시 진입점을 켭니다.
프록시 페이지에서 주요 정책 그룹에 사용할 노드를 선택한 다음 사용 환경에 맞게 시스템 프록시 또는 TUN 모드를 켜세요. 시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에 주로 영향을 줍니다. TUN 모드는 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 가로채며 일반적으로 추가 시스템 권한이 필요합니다.

구독 업데이트, 자동 새로 고침 및 로컬 수정

원격 구독의 장점은 원본 주소에 다시 요청해 노드, 정책 그룹 및 규칙의 최신 버전을 가져올 수 있다는 점입니다. 수동 업데이트는 일반적으로 설정 항목의 업데이트 버튼으로 시작하고, 자동 업데이트는 클라이언트 또는 설정에서 정한 간격에 따라 실행됩니다. 업데이트에 성공하면 클라이언트가 새 내용을 저장하고 코어에 다시 로드하도록 알립니다.

업데이트하기 전에 현재 네트워크에서 구독 서버에 접속할 수 있는지 확인하세요. 기존 프록시 노드가 이미 작동하지 않고 구독 주소에도 프록시를 거쳐야 접근할 수 있다면 ‘업데이트하려면 먼저 연결해야 하지만 연결하려면 먼저 업데이트해야 하는’ 순환이 생길 수 있습니다. 이때는 시스템 프록시를 잠시 끄고 직접 연결해 업데이트하거나, 아직 사용할 수 있는 이전 노드로 전환하거나, 출처를 신뢰할 수 있는 경우 브라우저에서 구독 주소에 접근할 수 있는지 테스트하세요.

원격 설정을 직접 편집하면 일반적으로 변경 사항이 덮어써질 수 있습니다. 다운로드한 YAML에 규칙을 추가하거나 DNS를 수정하거나 정책 그룹을 조정해도 다음 원격 업데이트에서 서버 버전으로 교체될 수 있습니다. 오래 유지해야 하는 로컬 변경은 클라이언트가 지원하는 오버라이드, 설정 병합 또는 스크립트 기능을 사용하고 적용 순서를 명확히 관리하세요. 로컬 설정으로 단순 복사하면 수정 사항은 보존되지만 복사본은 원격 구독 업데이트를 자동으로 상속하지 않습니다.

업데이트 후 노드 이름이 바뀌면 로컬 오버라이드에도 영향을 줄 수 있습니다. 사용자 지정 규칙이 특정 정책 그룹 이름을 지정했는데 서버에서 해당 그룹의 이름을 바꾸거나 삭제하면 코어가 정책 대상을 찾을 수 없다고 보고합니다. 안정적인 오버라이드는 장기간 유지되는 정책 그룹을 참조하고, 큰 폭의 업데이트 후에는 로그를 확인하세요.

업데이트 성공이 노드 사용 가능을 의미하지는 않습니다

구독 업데이트는 설정 내용을 가져와 파싱할 수 있다는 것만 증명합니다. 노드 연결은 서버 상태, 도메인 해석, 전송 매개변수, 시스템 시간 및 현재 네트워크 환경의 영향을 받습니다. 설정 목록에 ‘업데이트 성공’이 표시되지만 정책 그룹의 속도 테스트가 모두 시간 초과된다면 구독을 반복해서 삭제하고 가져오기보다 노드 연결 로그를 계속 확인해야 합니다.

자주 발생하는 가져오기 오류와 해결 순서

링크가 유효하지 않거나 404, 403이 반환됨

404는 일반적으로 경로가 존재하지 않는다는 뜻입니다. 링크가 잘렸거나 구독이 초기화되었거나 이전 주소를 복사했을 수 있습니다. 403은 서버가 현재 요청을 거부했다는 의미로, 인증 만료, 접근 정책 제한 또는 요청 조건 불일치가 흔한 원인입니다. 먼저 구독 관리 페이지에서 해당 형식의 주소를 다시 복사하세요. token, 파일 확장자 또는 쿼리 매개변수를 추측으로 수정하지 마세요. 이러한 부분은 인증 및 형식 선택에 관여하는 경우가 많습니다.

응답 내용이 비어 있음

빈 응답은 서버의 일시적인 오류, 계정 상태 변경, 아직 생성되지 않은 노드 목록 또는 중간 네트워크 장비가 연결을 조기에 종료한 경우에 발생할 수 있습니다. 링크를 노출하지 않는 범위에서 발생 시간, HTTP 상태 및 클라이언트 로그를 기록한 뒤 구독 서비스 관리자 페이지에서 요금제와 구독 상태를 확인하세요. 브라우저에서 0바이트 파일이 다운로드된다면 문제는 대개 클라이언트 파싱 전에 발생한 것입니다.

YAML 파싱 실패 메시지가 표시됨

이런 오류는 로그에 표시된 줄 번호와 필드 이름을 확인해야 합니다. 흔한 원인은 들여쓰기 불일치, 콜론 뒤 공백 누락, 닫히지 않은 문자열 따옴표, 목록 계층 오류, 현재 코어가 인식하지 못하는 필드를 서버가 생성한 경우입니다. 구독 서버가 자동으로 생성한 내용이라면 원격 파일을 한 줄씩 직접 수정하기보다 Clash Meta 형식을 다시 선택하고 업데이트하세요.

Base64 텍스트 또는 URI 문자열을 다운로드함

서버가 범용 구독을 반환했다는 뜻입니다. 먼저 구독 관리 페이지에 클라이언트 유형 또는 설정 형식 옵션이 있는지 확인한 다음 Clash, Clash Meta 또는 mihomo에 맞는 링크를 생성하세요. 일부 서비스는 요청의 User-Agent에 따라 다른 형식을 반환하므로 브라우저에서 본 내용과 클라이언트 요청 결과가 다를 수 있습니다. 이 경우 클라이언트 로그와 실제 저장된 설정을 기준으로 판단하세요.

설정은 파싱되지만 코어 로드에 실패함

YAML 파싱은 첫 단계일 뿐입니다. 코어는 정책 그룹 참조, 규칙 대상, provider 경로, 수신 포트 및 기능 필드도 검증합니다. 예를 들어 규칙이 존재하지 않는 정책 그룹을 가리키거나, 두 인바운드가 같은 포트를 사용하거나, provider 파일 형식이 잘못되면 로드에 실패할 수 있습니다. 로그를 열어 명확한 첫 번째 오류를 찾고, 이후 연속해서 나타나는 다시 로드 실패 메시지만 확인하지 마세요.

인증서 오류 또는 연결 시간 초과

인증서 오류는 시스템 시간이 부정확하거나 인증서 체인에 문제가 있거나 도메인이 잘못된 주소로 해석되거나 네트워크 중간 장비가 개입할 때 발생할 수 있습니다. 먼저 시스템 날짜, 시간 및 시간대를 맞춘 다음 같은 네트워크에서 접근 상태를 테스트하세요. 연결 시간 초과는 DNS 조회 시간 초과, TCP 연결 설정 시간 초과, TLS 핸드셰이크 시간 초과를 구분해야 합니다. 로그에서 오류가 발생한 단계에 따라 해결 방향도 달라집니다.

업데이트 후 정책 그룹이 비어 있음

설정은 로드되지만 정책 그룹에 노드가 없다면 노드 provider 업데이트 실패, 필터 표현식이 모든 노드를 제외한 경우 또는 서버에서 반환한 노드 이름과 정책 그룹 참조가 일치하지 않는 경우일 수 있습니다. proxy-providers의 상태와 업데이트 로그를 확인하고, 그룹에서 정적 proxies를 사용하는지 동적 use 참조를 사용하는지 점검하세요.

가져오기 완료 후 연결 확인

설정이 정상적으로 로드되면 먼저 프록시 페이지에서 정책 그룹이 비어 있지 않은지 확인하고 주요 선택 그룹에 노드를 지정하세요. 지연 시간 테스트를 한 번 실행할 수 있지만, 지연 시간 결과는 해당 시점에 테스트 주소가 응답했는지만 보여 줄 뿐 모든 웹사이트와 프로토콜이 항상 작동한다는 뜻은 아닙니다. 그런 다음 시스템 프록시를 켜고 시스템 프록시 설정을 따르는 브라우저로 일반 웹 페이지에 접속하면서 로그에 해당 도메인과 규칙 일치 결과가 표시되는지 확인하세요.

로그에는 요청이 어떤 규칙과 일치했는지, 어느 정책 그룹에 할당되었는지, 최종적으로 어떤 노드를 사용했는지가 표시되어야 합니다. 연결이 DIRECT로 전달되었다면 직접 연결된 것입니다. REJECT와 일치했다면 설정에 의해 차단된 것입니다. 프록시 그룹으로 들어갔지만 연결에 실패한다면 노드 핸드셰이크 또는 DNS 관련 오류를 계속 확인해야 합니다. 웹 페이지가 열리는지만 보는 것보다 이 방법이 문제 위치를 파악하기 쉽습니다.

시스템 프록시는 정상인데 일부 앱에 트래픽이 없으면 해당 앱이 시스템 프록시를 무시하거나 독립 네트워크 스택을 사용하거나 UDP를 직접 전송하는 경우일 수 있습니다. 이때 TUN 모드 사용을 검토할 수 있습니다. 활성화한 뒤 운영체제의 안내에 따라 권한을 부여하고 가상 네트워크 카드, 라우팅 테이블 및 DNS 가로채기 상태를 확인하세요. TUN은 구독 형식을 수정하는 도구가 아닙니다. 설정 자체를 파싱할 수 없거나 노드 매개변수가 잘못된 경우 트래픽 가로채기 방식을 바꿔도 문제가 해결되지 않습니다.

마지막으로 설정을 체계적으로 관리하는 습관을 들이세요. 원격 구독에는 알아보기 쉬운 이름을 지정하고 정기적으로 업데이트하며, 중요한 변경 사항은 오버라이드 기능으로 관리하세요. 구독 주소를 바꾼 뒤에는 만료된 항목을 삭제해 이전 설정을 잘못 선택하지 않도록 합니다. 문제가 발생하면 ‘다운로드 응답, 형식 파싱, 코어 로드, 트래픽 가로채기, 노드 연결’ 순서로 확인하세요. 이 순서를 따르면 비슷해 보이는 현상을 구체적인 단계로 나누어 반복적인 가져오기와 무작정 설정을 바꾸는 일을 줄일 수 있습니다.