Clash 구독 URL 가져오기 가이드: URL·YAML·Base64 형식 차이

URL은 가져올 주소, YAML과 Base64는 콘텐츠 형식

Clash 구독을 가져오지 못할 때는 먼저 주소에 접속할 수 있는지, 응답 내용을 파싱할 수 있는지 구분해 확인하세요. URL은 원격 리소스의 주소이고, YAML은 설정을 표현하는 형식이며, Base64는 인코딩 방식입니다. 서로 다른 계층이므로 세 가지를 서로 배타적인 구독 유형으로 나눌 수 없습니다. HTTPS 구독 URL은 전체 YAML, Base64로 인코딩된 노드 목록, 로그인 페이지 등 다양한 응답을 반환할 수 있습니다.

mihomo 커널을 사용하는 클라이언트라면 서비스 제공자가 Clash Meta 또는 mihomo용으로 안내한 구독 경로를 우선 선택하세요. 이름은 호환 대상만 나타낼 뿐, 실제 사용 가능 여부는 응답 필드와 로컬 커널의 지원 여부에 달려 있습니다. 클라이언트에 URL을 저장할 수 있다고 해서 응답 내용까지 해석할 수 있는 것은 아닙니다.

받는 콘텐츠	일반적인 구성	가져오기 위치와 제한
구독 URL	프로토콜, 서버 주소, 경로 및 인증 토큰	원격 설정 메뉴에 붙여 넣으면 클라이언트가 실제 콘텐츠를 요청합니다
전체 YAML 설정	노드 또는 노드 제공자, 프록시 그룹, 규칙 및 선택적 DNS 설정	설정 파일로 불러올 수 있지만 필드와 정책 참조를 확인해야 합니다
노드 제공자 YAML	일반적으로 최상위에 `proxies:` 노드 목록이 있습니다	보통 `proxy-providers`에서 참조하며, 전체 기본 설정과는 다릅니다
Base64 노드 목록	인코딩된 여러 줄의 노드 URI입니다. 예: `ss://`, `vmess://`	클라이언트가 해당 형식 파싱을 명시적으로 지원해야 합니다. 그렇지 않다면 대상 커널이 지원하는 설정으로 변환해야 합니다

가져오기 전에 구독 주소와 호환 커널을 준비하세요

클라이언트 커널을 확인하세요.「정보」 또는 「설정」에서 커널 정보를 확인해 mihomo를 사용하는지 살펴보세요. 그래픽 클라이언트 버전과 커널 버전은 서로 다른 번호이므로 호환성 문제를 문의할 때 각각 기록해야 합니다.
서비스 관리 페이지에서 전용 주소를 복사하세요.Clash, Clash Meta 또는 mihomo용으로 표시된 주소를 선택하세요. 요금제 페이지나 로그인 페이지, 브라우저 주소창의 현재 주소를 복사하면 안 됩니다.
쿼리 매개변수를 그대로 유지하세요.주소에서 ? 뒤에 오는 토큰이나 형식 매개변수는 인증과 콘텐츠 선택에 사용될 수 있으므로 도메인과 경로만 남겨서는 안 됩니다.
복사할 때 따라온 문자를 정리하세요.앞뒤 공백과 줄바꿈, 한글 인용 부호를 제거하세요. 주소 안의 퍼센트 인코딩, 대소문자, 매개변수 순서는 임의로 변경하지 마세요.

구독 주소에는 보통 .yaml 확장자가 없습니다. 서버는 경로와 쿼리 매개변수 또는 요청 헤더에 따라 반환 형식을 정할 수 있으므로 파일명만으로 호환성을 판단할 수 없습니다. 브라우저에서 관리 페이지가 열리더라도 클라이언트가 구독 API를 요청할 때 같은 로그인 상태를 사용한다는 뜻은 아닙니다.

주소가 이미 노출되었다면 서비스 관리 페이지에서 구독 토큰을 재설정한 뒤 클라이언트의 기존 주소를 새 주소로 바꾸세요. 채팅 기록이나 로컬 설정을 삭제하는 것만으로는 이미 복사된 인증 정보를 무효화할 수 없습니다.

클라이언트에 URL을 붙여 넣고 설정 활성화하기

클라이언트마다 버튼 이름은 다르지만, 절차는 「원격 설정 추가, 콘텐츠 다운로드, 설정 선택, 정책 선택」의 네 단계로 나눌 수 있습니다. 여기서는 일반적인 「설정」 화면을 기준으로 안내합니다. 화면에 「구독」 또는 「Profiles」가 표시된다면 노드 입력란이 아니라 해당 원격 설정 목록으로 이동하세요.

처음 가져올 때 진행 순서

「설정」을 열고 구독 주소 입력란에 전체 URL을 붙여 넣으세요. 입력란이 없다면 「새로 만들기」를 선택한 뒤 유형을 「원격」으로 설정하세요.
「일상 구독」처럼 알아보기 쉬운 이름을 지정한 다음 「가져오기」 또는 「저장」을 누르세요. 다운로드가 끝날 때까지 기다리고, 같은 요청을 연달아 보내지 마세요.
설정 카드에 업데이트 시간이 표시되는지 확인하세요. 카드를 클릭하거나 「이 설정 사용」을 선택해 현재 설정으로 활성화하세요. 목록에 다운로드만 했다고 자동으로 활성화되는 것은 아닙니다.
「프록시」 화면에서 프록시 그룹과 노드 목록이 표시되는지 확인하세요. 사용할 노드를 선택하고 지연 시간을 한 번 테스트한 다음 실제 접속을 시도하세요.
필요에 따라 시스템 프록시를 켜세요. 시스템 프록시를 따르지 않는 트래픽까지 처리해야 할 때만 TUN 모드를 별도로 설정하고 필요한 권한을 부여하세요.

「가져오기 성공」, 「설정 활성화」, 「트래픽이 프록시를 통과」는 각각 확인해야 할 별개의 항목입니다. 가져오기 성공은 파일을 받아 해당 방식으로 처리했다는 뜻일 뿐, 노드 연결이 가능하다는 의미는 아닙니다. 시스템 프록시나 TUN 모드는 트래픽을 받아들이고 규칙과 프록시 그룹은 이후 트래픽을 분기합니다. TUN을 켜도 잘못된 구독 형식은 해결되지 않습니다.

가져온 뒤 확인할 필드

proxies 또는 proxy-providers: 노드가 있는지, 이름이 정상적으로 표시되는지 확인하세요.
proxy-groups: 규칙에서 참조하는 정책 그룹이 존재하는지, 그룹에 선택 항목이 있는지 확인하세요.
rules: 예상한 트래픽 분기 규칙이 있는지, 마지막에 나머지 트래픽을 처리하는 정책이 있는지 확인하세요.
로컬 수신 포트: 클라이언트에 현재 표시된 값을 사용하세요. 다른 안내서의 7890을 그대로 적용하지 마세요.

전체 YAML 설정과 노드 목록 구분하기

YAML은 구조를 나타내는 형식이며, 콘텐츠가 완전하다는 보장은 없습니다. proxies:만 있는 파일은 기본 설정에서 참조할 노드 리소스일 수도 있고, 클라이언트에서 프록시 그룹과 규칙을 추가해야 할 수도 있습니다. 반드시 구문 오류인 것은 아니지만, 기본 설정으로 바로 사용하면 필요한 프록시 선택 메뉴나 트래픽 분기 동작이 없을 수 있습니다.

아래는 각 계층의 관계를 보여 주는 최소 설정입니다. 직접 연결 정책만 있고 원격 노드는 없으므로 필드를 비교할 때만 참고하세요. 실제로 사용할 수 있는 프록시 구독 설정은 아닙니다.

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

proxies: []

proxy-groups:
  - name: 출구 선택
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,출구 선택

mixed-port: 7890은 HTTP와 SOCKS가 하나의 로컬 포트를 함께 사용한다는 뜻이고, mode: rule은 규칙에 따라 트래픽을 분기한다는 뜻입니다. 마지막 규칙은 나머지 연결을 「출구 선택」으로 전달합니다. 여기서 그룹 이름은 규칙에 지정된 이름과 일치해야 합니다. 실제 클라이언트는 실행 중 설정으로 포트와 모드를 덮어쓸 수 있으므로 최종 적용된 설정도 확인하세요.

원격 리소스를 proxy-providers에 사용할 경우 기본 설정에서 제공자를 정의하고 프록시 그룹이 use로 이를 참조하도록 해야 합니다. 제공자 업데이트와 전체 Profile 업데이트는 서로 다른 계층의 작업입니다. 전체 기본 설정 주소를 노드 제공자 필드에 임의로 입력하지 말고, 모든 Base64 목록을 현재 커널이 제공자로 바로 읽을 수 있다고 가정하지도 마세요.

Base64를 디코딩해도 전체 설정이 되지는 않습니다

일반적인 Base64 구독은 디코딩하면 여러 줄의 노드 URI가 나옵니다. 각 줄에는 노드의 프로토콜, 서버, 포트와 인증 매개변수가 있지만 보통 rules, DNS, 프록시 그룹은 포함되지 않습니다. 디코딩은 텍스트를 복원할 뿐 Clash에 필요한 설정 구조를 자동으로 만들지는 않습니다.

혼동하기 쉬운 또 다른 점은 vmess:// 노드 URI 자체에도 Base64 인코딩된 콘텐츠가 들어갈 수 있다는 것입니다. 이는 구독 전체가 Base64로 인코딩된 경우와 다른 계층입니다. 전체 텍스트를 반복해서 디코딩해도 구독 형식에 맞게 파싱하는 작업을 대신할 수 없습니다. 서비스 제공자가 안내하는 mihomo 전용 경로를 다시 가져오는 편이 안전합니다.

자동 업데이트를 설정하고 사용자 지정 규칙 유지하기

처음 가져온 설정이 정상 작동하는지 확인한 다음 자동 업데이트를 켜세요. 설정 카드의 「편집」 또는 「설정」에서 「자동 업데이트」, 「업데이트 간격」 등의 항목을 찾으세요. 단위가 분이라면 360은 6시간마다 업데이트한다는 뜻입니다. 초 단위라고 명시된 경우 같은 주기는 21600으로 설정해야 합니다. 두 단위를 혼용하지 마세요.

먼저 「업데이트」를 직접 한 번 실행해 구독 주소가 여전히 유효하고 업데이트 시간이 바뀌는지 확인하세요.
6시간마다 업데이트하는 등 적절한 주기를 설정하세요. 서비스 제공자가 요청 횟수를 제한한다면 해당 기준을 따르세요.
「시작할 때 업데이트」 또는 실패 시 재시도 기능을 지원하는지 확인하세요. 클라이언트가 꺼져 있으면 내부 예약 작업은 보통 실행되지 않으며, 절전 중에는 업데이트가 지연될 수도 있습니다.
업데이트 후 현재 선택된 노드와 프록시 그룹, 규칙을 확인하세요. 노드 이름이 바뀌거나 삭제되면 이전에 선택한 항목이 유지되지 않을 수 있습니다.

원격 구독에서 다운로드한 YAML의 규칙을 직접 수정한 채 장기간 사용하지 마세요. 다음 업데이트에서 수정 내용이 덮어써질 수 있습니다. 클라이언트에서 오버라이드, 병합 또는 스크립트 기능을 제공한다면 해당 기능에 맞는 위치에 사용자 지정 내용을 추가하고 업데이트 후에도 최종 설정에 반영되는지 확인하세요. 클라이언트마다 병합 순서가 다르므로 편집기에 규칙이 보인다는 이유만으로 실제 적용되었다고 판단해서는 안 됩니다.

구독을 가져오지 못하면 오류 유형별로 해결하세요

메시지 또는 증상	우선 확인할 항목	해결 방법
HTTP 401 또는 403	토큰 만료, 접근 권한, 서비스 측 제한	관리 페이지에서 주소를 다시 복사하고 계정 상태를 확인하세요. 필요하면 서비스 제공자에게 문의해 요청이 거부된 이유를 확인하세요.
HTTP 429	업데이트 요청이 너무 잦음	연속 재시도를 멈추고 서비스 제공자의 제한 시간만큼 기다린 뒤 자동 업데이트 주기를 늘리세요.
HTTP 200이지만 파싱 실패	응답이 HTML 로그인 페이지, JSON 오류 또는 노드 목록일 수 있습니다	로컬에서 응답의 첫 부분을 확인해 상태 코드만 보지 말고 원하는 형식이 반환되었는지 확인하세요.
YAML 줄 번호 오류	들여쓰기, 탭, 콜론 또는 잘린 콘텐츠	오류가 발생한 줄과 바로 앞 줄을 확인하세요. 들여쓰기에 공백을 사용하고 원본 파일을 다시 다운로드해 비교하세요.
지원되지 않는 프록시 유형 또는 필드	설정 대상과 로컬 커널이 호환되지 않음	커널 버전을 확인하고 호환되는 구독 경로를 사용하거나 해당 기능을 지원하는 클라이언트와 커널로 업그레이드하세요.
다운로드 시간 초과 또는 TLS 오류	DNS, 네트워크 경로, 시스템 시간 및 인증서 신뢰	먼저 시스템 시간을 맞춘 뒤 연결 로그와 네트워크를 확인하세요. 인증서 검증을 끄는 방식으로 문제를 계속 우회하지 마세요.

형식이 호환되지 않을 때 처리 순서

먼저 서비스 페이지에서 올바른 형식의 구독 경로를 찾으세요. 다음으로 클라이언트가 노드 목록 가져오기를 명시적으로 지원하는지 확인하고, 마지막으로 변환을 고려하세요. 변환 도구는 구현된 프로토콜과 필드만 처리할 수 있습니다. 원본에 없는 전송 매개변수와 TLS 설정, 규칙은 변환으로 만들어지지 않습니다.

서비스 제공자의 변환 기능이나 로컬에서 실행하는 신뢰할 수 있는 도구를 우선 사용하세요. 토큰이 포함된 URL을 공개 변환 서비스에 제출하면 해당 서비스에 구독을 읽을 권한을 넘기는 것과 같습니다. 변환 결과에서 프록시 유형과 전송 설정, 프록시 그룹, 규칙도 확인해야 합니다. 파일을 저장할 수 있다는 것만으로 호환된다고 판단해서는 안 됩니다.

가져온 뒤 확인할 세 가지

업데이트가 제대로 되는지 확인하세요.수동으로 한 번 업데이트하고 성공 시간을 기록하세요. 실패하면 기존 설정을 유지한 채 구독 요청 오류부터 해결하세요. 아직 사용할 수 있는 설정을 반복해서 삭제하고 다시 만들 필요는 없습니다.
정책에 따른 연결을 확인하세요.프록시 그룹과 노드를 명확하게 선택하고 대상 웹사이트를 연 다음 연결 로그에서 적용된 규칙과 정책, 연결 결과를 확인하세요. 지연 시간 테스트에 숫자가 표시되어도 모든 웹사이트에 접속할 수 있는 것은 아닙니다.
트래픽 유입 경로를 확인하세요.대상 앱이 시스템 프록시를 따르는지 확인하고, 필요한 경우에만 TUN을 설정하세요. 외부 IP 정보를 확인할 때는 로그도 함께 살펴보세요. 직결 규칙이 적용된 요청 하나만으로 전체 설정이 작동하지 않는다고 판단해서는 안 됩니다.

세 가지 확인을 마친 뒤 예약 업데이트와 사용자 지정 규칙을 설정하세요. 구독 가져오기, 설정 파싱, 노드 연결, 시스템 트래픽 전달을 나누어 확인하면 「가져오기는 성공했는데 인터넷이 안 되는」 문제를 더 빠르게 좁힐 수 있습니다. 연결 방법과 포트 안내는 사용 가이드에서, 규칙 설정은 사용자 지정 규칙 안내에서 확인하세요.