Clash 구독 링크 가져오기 가이드: URL·로컬 YAML 파일 가져오기와 구독 형식 비교

가져오기 전: 구독 주소, 설정 파일, 노드 링크 구분하기

Clash 구독을 제대로 가져왔는지는 주소가 현재 커널의 설정 요구사항에 맞는 내용을 반환하는지에 달려 있습니다. 링크가 .yaml로 끝나는지는 중요하지 않습니다. 액세스 토큰이 포함된 HTTPS 주소가 완전한 설정을 반환할 수도 있고, config.yaml이라는 다운로드 링크가 실제로는 로그인 페이지나 오류 메시지를 반환할 수도 있습니다.

데스크톱 클라이언트는 구독 저장, 업데이트 다운로드, 설정 전환을 담당하고, Clash 또는 mihomo 커널은 설정을 파싱하고 연결을 구성하며 규칙을 적용합니다. 화면에 ‘다운로드 완료’라고 표시되어도 클라이언트가 응답을 받았다는 뜻일 뿐, 커널이 모든 항목을 받아들였다는 의미는 아닙니다.

구독 URL: 원격 콘텐츠를 가져오는 주소입니다. 완전한 Clash YAML일 수도 있고, 다른 형식의 노드 모음일 수도 있습니다.
완전한 설정: 일반적으로 proxies 또는 proxy-providers와 함께 proxy-groups, rules 등의 설정이 포함됩니다.
노드 링크: ss://, vmess://, trojan:// 등으로 시작하는 단일 연결 정보입니다. 보통 트래픽 분기 규칙은 포함되지 않습니다.

방법 1: URL로 원격 구독 가져오기

장기간 사용할 경우 원격 구독을 이용하는 것이 좋습니다. 클라이언트에 주소를 저장하면 노드와 규칙을 다시 가져올 수 있지만, 로컬 파일은 특정 시점의 복사본일 뿐입니다. 제공업체가 ‘Clash’, ‘Clash Meta’, ‘mihomo’ 형식을 제공한다면 현재 클라이언트에서 사용하는 커널을 확인한 뒤 해당 주소를 복사하세요.

구독 페이지에서 다운로드하고 활성화하기

아래 안내는 Clash Verge Rev에서 흔히 볼 수 있는 메뉴 이름을 기준으로 합니다. 버전에 따라 ‘구독’이 ‘설정’으로 표시될 수 있으니 메뉴 이름보다 기능을 기준으로 찾으세요. 노드 선택 화면에서 구독 가져오기 입력란을 찾지 마세요.

클라이언트를 열고 왼쪽의 ‘구독’ 페이지로 이동한 뒤, 상단의 구독 링크 입력란에 HTTPS 주소 전체를 붙여 넣으세요.
주소 앞뒤에 공백이나 줄바꿈, 메신저가 덧붙인 문장 부호가 없는지 확인한 다음 ‘가져오기’를 클릭하세요. 링크를 일부러 .yaml로 끝나게 바꿀 필요는 없습니다.
구독 카드가 생성될 때까지 기다리세요. 오류가 표시되면 다운로드 또는 파싱 메시지를 먼저 확인하고, 같은 주소를 연달아 다시 추가하지 마세요.
해당 구독 카드를 클릭해 현재 설정으로 지정하세요. 일부 클라이언트에서는 이 작업을 ‘사용’ 또는 ‘활성화’라고 표시합니다.
‘프록시’ 페이지로 이동해 정책 그룹이 표시되는지 확인한 다음 사용할 노드를 선택하세요. 가져오기가 완료되어도 시스템 프록시가 켜진 것은 아닙니다.

일부 서비스 페이지의 ‘원클릭 가져오기’는 실제로 사용자 지정 URL 프로토콜을 통해 클라이언트를 실행합니다. 이를 사용하려면 시스템에 해당 프로토콜 처리기가 등록되어 있어야 합니다. 클릭해도 반응이 없다면 구독 주소를 직접 복사해 가져오세요. 시스템에서 클라이언트를 실행하지 못한 것인지, 구독 자체를 다운로드할 수 없는 것인지 구분하기 쉽습니다.

업데이트 옵션은 항목별로 확인하기

구독 카드 메뉴에서 ‘편집’ 또는 구독 설정을 열고 업데이트 간격과 다운로드 시 프록시 사용 옵션을 확인하세요. 자동 업데이트는 클라이언트 기능이며 최상위 rules가 제어하지 않습니다. 화면의 단위가 분이면 360은 6시간이고, 초라면 21600을 입력해야 합니다. 이는 설정 예시이며 모든 클라이언트의 기본값은 아닙니다.

처음 구독을 가져올 때는 사용할 수 있는 프록시가 아직 없을 수 있습니다. 이때 구독 다운로드에 프록시를 강제로 사용하면 순환 의존성이 생길 수 있습니다. 직접 연결로 가져올 수 없는 것이 확인되고 사용 가능한 출구가 있을 때만 업데이트 시 프록시 옵션을 시험하세요. 최상위 원격 구독의 업데이트 주기와 proxy-providers 안의 interval도 혼동하지 마세요. 후자는 커널이 프로바이더를 가져오는 간격이며 단위는 초입니다.

방법 2: 로컬 YAML 설정 파일 가져오기

서비스 제공업체가 설정 파일을 직접 제공하거나 오프라인 백업이 필요할 때, 또는 원격 다운로드 문제를 확인할 때는 로컬 가져오기가 적합합니다. 파일 선택기로 가져오면 클라이언트가 보통 자체 설정 사본을 관리합니다. 따라서 이후 원본 다운로드 파일을 수정해도 현재 실행 중인 설정에는 반영되지 않을 수 있습니다.

Windows의 ‘다운로드’ 폴더처럼 찾기 쉬운 위치에 설정 파일을 저장하고, 확장자가 .yaml 또는 .yml인지 확인하세요. 확장자가 숨겨져 .yaml.txt가 된 파일은 사용할 수 없습니다.
클라이언트의 ‘구독’ 또는 ‘설정’ 페이지에서 ‘로컬 파일 가져오기’를 선택하세요. 파일 끌어 놓기를 지원하는 버전이라면 파일을 해당 페이지에 끌어다 놓아도 됩니다.
파일을 선택하고 저장한 다음 해당 설정을 활성화하세요. 파싱 오류가 발생하면 텍스트 편집기로 오류가 발생한 줄과 바로 앞 줄을 확인하세요.
정책 그룹과 로그를 열어 설정이 정상적으로 적용되었는지 확인하세요. 클라이언트 외부의 파일을 수정했다면 다시 가져오거나 클라이언트에서 제공하는 다시 불러오기 기능을 사용해야 합니다.

YAML 문법이 올바르다고 해서 프록시 연결에 적합한 설정인 것은 아닙니다

아래는 구조를 이해하기 위한 최소 예시입니다. 직접 연결만 포함되어 있어 프록시 노드는 제공하지 않으며, 서비스 제공업체의 구독을 대신할 수 없습니다. mixed-port: 7890은 여기서 HTTP와 SOCKS가 함께 사용하는 포트로 명시한 값이며, 모든 클라이언트의 기본 출고값은 아닙니다.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxies: []

proxy-groups:
  - name: 수동 선택
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,수동 선택

YAML 들여쓰기에는 공백을 사용하고 Tab은 사용하지 마세요. 목록 항목은 -로 시작하며, 키와 값 사이에는 올바른 콜론과 공백이 필요합니다. 일반 YAML 파서에서 문법 오류가 없더라도 존재하지 않는 정책 이름, 지원하지 않는 프로토콜 필드, 인증 매개변수 누락 때문에 커널이 설정을 거부할 수 있습니다.

방법 3: 클립보드에서 설정 또는 노드 정보 가져오기

클립보드 가져오기는 완전한 설정 텍스트를 확보했거나 클라이언트가 단일 노드 링크 인식을 명시적으로 지원할 때 적합합니다. 클라이언트마다 지원 기능은 크게 다릅니다. ‘구독 주소 붙여넣기’와 ‘클립보드에서 노드 파싱’은 서로 다른 기능이므로, 복사해 붙여 넣는다는 이유만으로 같은 메뉴라고 생각하면 안 됩니다.

전체 YAML 텍스트: 클라이언트에서 ‘로컬 설정 만들기’ 또는 설정 편집기를 지원한다면 새 로컬 설정을 만든 뒤 내용을 붙여 넣고 저장한 다음 활성화하세요.
단일 노드 링크: 메뉴에 ‘클립보드에서 가져오기’가 명시되어 있고 해당 프로토콜을 지원할 때만 사용하세요. 가져온 뒤에는 어떤 설정과 정책 그룹에 추가되었는지도 확인해야 합니다.
여러 줄 노드 목록: 클라이언트에서 일괄 파싱을 지원해야 합니다. 지원하지 않는다면 먼저 호환되는 설정으로 변환하세요. 노드 목록을 구독 URL 입력란에 그대로 붙여 넣으면 안 됩니다.

현재 버전에 텍스트 가져오기 메뉴가 없다면 전체 YAML을 UTF-8 인코딩의 로컬 파일로 저장한 뒤 로컬 파일 가져오기 절차를 따르세요. YAML을 한 줄로 합치거나 들여쓰기를 직접 삭제하지 마세요. 단일 노드를 인식하더라도 클라이언트가 예상한 DNS, 규칙, 정책 그룹을 자동으로 만들어 준다는 뜻은 아닙니다.

구독 형식 비교: Clash YAML, Base64, 프로바이더 파일

‘구독’은 콘텐츠를 가져오고 업데이트하는 방식을 뜻할 뿐, 하나의 파일 형식을 가리키지 않습니다. 호환성을 판단할 때는 콘텐츠 구조와 프로토콜 종류, 커널 지원 범위를 함께 살펴보세요. 파일 확장자와 웹페이지의 버튼 이름은 참고 정보일 뿐입니다.

콘텐츠 유형	주요 특징	가져오기 전 확인 사항
전체 Clash YAML	노드 또는 프로바이더와 정책 그룹, 규칙 등의 설정 항목이 포함됩니다	대개 설정으로 가져올 수 있지만, 커널에서 지원하는 필드와 프로토콜인지 확인해야 합니다
Base64 노드 목록	겉으로는 인코딩된 텍스트이며, 디코딩하면 여러 줄의 노드 URI가 나오는 경우가 많습니다	대개 완전한 Clash 설정으로 바로 불러올 수 없으며, 클라이언트에서 인식하거나 변환해야 합니다
단일 노드 URI	ss, vmess, trojan 등 프로토콜 이름으로 시작합니다	클라이언트의 프로토콜 가져오기 기능이 필요하며 전체 규칙 설정은 포함하지 않습니다
프록시 프로바이더 YAML	일반적으로 최상위 항목이 `proxies:`이며, 주로 노드 목록을 담고 있습니다	대개 `proxy-providers`에서 참조하며, 완전한 설정으로 바로 사용하면 안 됩니다
다른 클라이언트의 설정	JSON 형식이거나 다른 구조의 필드일 수 있습니다	확장자만 바꿔서는 호환되지 않습니다. 변환 도구가 원본 형식을 지원하는지 확인해야 합니다

Base64는 인코딩 방식이지 프로토콜 호환 계층이 아닙니다

Base64를 디코딩하면 인코딩된 텍스트를 복원할 수 있을 뿐입니다. 노드 URI가 자동으로 Clash YAML 필드로 변환되거나 규칙, DNS, 정책 그룹이 추가되는 것은 아닙니다. 일부 노드 URI의 일부분도 Base64를 사용하므로, 긴 문자열이 보인다는 이유만으로 응답 전체가 Base64 구독이라고 단정할 수 없습니다.

Clash와 mihomo의 호환 범위는 완전히 같지 않습니다

mihomo는 Clash Meta의 기능을 이어받아 확장했습니다. mihomo용으로 생성된 설정에는 구버전 Clash에서 지원하지 않는 프로토콜이나 매개변수가 포함될 수 있습니다. 따라서 서비스 제공업체에서 여러 형식을 제공한다면 현재 클라이언트의 커널에 맞는 형식을 선택하세요. 커널이 지원하지 않는 노드는 설정의 프로토콜 이름만 바꿔도 사용할 수 없습니다.

형식이 호환되지 않을 때: 기본 출력 형식을 먼저 선택하고 변환은 나중에 검토하세요

가장 간단한 해결 순서는 서비스 제공업체가 원하는 형식을 지원하는지 확인하고, 클라이언트 커널을 확인한 다음, 마지막으로 변환을 시도하는 것입니다. 변환 도구는 설정을 표현하는 형식만 처리할 수 있습니다. 원격 서버의 프로토콜 지원 기능을 바꾸거나 원본 데이터에서 빠진 인증 정보를 복구할 수는 없습니다.

기본 구독 형식 우선: 서비스 제공업체 페이지에서 현재 커널에 맞는 Clash 또는 mihomo 형식을 선택하고 주소 전체를 다시 복사하세요.
원본 콘텐츠 확인: 노드 URI, Base64 목록, 전체 YAML, 프로바이더 파일을 구분하세요. 웹페이지의 HTML을 구독 콘텐츠인 것처럼 변환 도구에 넣지 마세요.
신뢰할 수 있는 변환 환경 선택: 서비스 제공업체가 제공하는 변환 기능을 우선 사용하거나, 직접 관리하는 로컬 환경에서 변환 도구를 실행하세요. 원격 변환 서비스에 구독 토큰과 노드 인증 정보가 노출될 수 있습니다.
대상 형식과 템플릿 확인: 출력물이 완전한 설정인지 노드 프로바이더인지 확인하고, 생성된 정책 그룹 이름과 규칙의 출구, DNS 설정을 점검하세요.
가져온 뒤 항목별로 검증: 먼저 설정이 로드되는지 확인하고, 노드와 정책 그룹이 제대로 포함되었는지 살핀 다음 실제 연결을 테스트하세요. 변환 페이지에 성공 메시지가 표시되는 것만으로 판단하지 마세요.

변환한 설정에는 원본 형식에만 있는 필드가 빠지거나 템플릿의 규칙이 기존 규칙을 대체될 수 있습니다. 특히 UDP, TLS, 전송 계층, 인증서 관련 매개변수가 유지되었는지 확인하세요. 인증서 오류가 발생하면 기기 시간, 서버 이름, 서비스 제공업체 안내를 점검하세요. 인증서 검증을 끄는 방법을 일반적인 변환 절차로 사용하지 마세요.

가져오기 오류와 적용 여부 확인: 다운로드, 파싱, 라우팅 순서로 점검

다운로드 실패와 잘못된 콘텐츠를 구분해 해결하기

HTTP 401 또는 403: 구독 토큰이 만료되지 않았는지, 주소가 빠짐없이 복사되었는지, 서비스 제공업체가 접근을 제한했는지 확인하세요. 로컬 프록시 포트만 계속 바꾸지 마세요.
요청 시간 초과: 네트워크 연결, 구독 도메인 이름 확인, 업데이트 시 프록시 사용 옵션을 점검하세요. 브라우저에서 서비스 제공업체 홈페이지가 열려도 구독 API에 연결된다는 보장은 없습니다.
응답이 HTML로 시작함: 로그인 페이지, 인증 페이지 또는 오류 페이지를 받은 것일 수 있습니다. HTTP 200 응답도 이런 콘텐츠를 반환할 수 있으므로 상태 코드만 보지 말고 실제 응답을 확인하세요.
프록시 또는 정책을 찾을 수 없다는 메시지: proxy-groups에서 참조하는 이름과 규칙 마지막에 지정한 출구 이름이 실제로 존재하는지 확인하세요. 대소문자와 공백도 일치해야 합니다.
지원하지 않는 프록시 유형 또는 필드: 실제 커널과 구독 대상 형식이 일치하는지 확인하세요. 화면 테마를 바꾸거나 파일 이름을 변경해도 커널 호환성 문제는 해결되지 않습니다.

설정을 활성화한 뒤에는 앱의 트래픽이 클라이언트를 거치는지 확인하세요

클라이언트에서 현재 설정 이름이 올바른지 확인하고, 실수로 직접 연결 모드로 바뀌지 않았는지 살펴보세요. 규칙 모드를 사용해야 합니다.
사용할 정책 그룹을 열고 작동하는 노드를 선택하세요. 지연 시간 테스트가 성공해도 테스트 요청에 응답했다는 뜻일 뿐, 모든 웹사이트와 프로토콜이 작동한다는 보장은 없습니다.
시스템 프록시 설정을 따르는 데스크톱 앱이라면 클라이언트의 ‘시스템 프록시’를 켜세요. 프록시를 직접 설정하는 경우 실제 수신 주소와 포트를 확인해야 합니다. 설정이 mixed-port: 7890이라면 로컬 주소로 127.0.0.1:7890을 사용할 수 있습니다.
브라우저에서 새 요청을 보내고 ‘연결’ 또는 ‘로그’ 화면에서 대상 도메인, 적용된 규칙, 최종 출구를 확인하세요. 필요하다면 기존 연결을 닫고 다시 시도하세요.

시스템 프록시를 따르지 않는 앱은 트래픽을 처리하기 위해 TUN 모드가 필요할 수 있지만, 이는 가져오기 이후의 라우팅 설정입니다. TUN 작동 여부는 서비스 권한과 라우팅, DNS 설정에도 영향을 받습니다. 잘못된 구독 형식을 고치거나 비어 있는 설정에 노드를 추가해 주지는 않습니다.