가져오기 전에: 구독 주소인지 단일 노드 링크인지 확인
Clash Verge Rev의 구성 페이지에서 구성 파일을 관리합니다. 원격 구독은 구성 내용을 반환하는 주소입니다. 클라이언트가 해당 주소에 접속해 구성을 다운로드한 다음 코어에 전달하여 불러옵니다. 구독 서비스는 노드와 관련 구성을 제공하고, 클라이언트는 이를 가져와 파싱하고 사용합니다. 서로 다른 대상입니다.
먼저 서비스 제공업체가 안내한 내보내기 형식을 확인하세요. ‘Clash’, ‘Clash Meta’ 또는 ‘mihomo’로 표시된 구독을 우선 선택하고 현재 코어와 호환되는지 확인합니다. Clash Verge Rev는 mihomo 코어를 사용하지만, 임의의 프로토콜 링크나 모든 클라이언트의 구성을 사용 가능한 YAML로 자동 변환한다는 뜻은 아닙니다.
https://로 시작: 구독 주소일 수도 있고 계정 페이지일 수도 있습니다. 실제 응답 내용을 확인해야 사용할 수 있는지 알 수 있습니다.ss://,vmess://또는trojan://으로 시작: 대개 단일 노드 공유 링크이며, 완전한 Clash 구성과는 다릅니다..yaml또는.yml로 끝나는 파일: 구성 파일일 수 있지만, 확장자만으로 내용이 완전하거나 문법에 맞는지 확인할 수는 없습니다.- QR 코드: 텍스트를 담는 방식일 뿐입니다. 코드에는 구독 주소, 단일 노드 링크 또는 다른 클라이언트를 여는 전용 링크가 들어 있을 수 있습니다.
방법 1: 구성 페이지에 구독 URL 붙여넣기
원격 URL은 장기간 사용하기에 적합합니다. 노드가 바뀌어도 기존 주소에서 다시 가져올 수 있습니다. 작업하기 전에 전체 주소를 복사하세요. 웹페이지 버튼 옆의 설명까지 함께 선택하지 말고 물음표 뒤의 매개변수도 삭제하지 마세요.
- Clash Verge Rev를 열고 왼쪽의 ‘구성’ 페이지로 이동합니다.
- 구독 링크 입력란을 찾아 서비스 제공업체에서 받은 Clash 또는 mihomo 구독 주소를 붙여넣습니다.
- ‘가져오기’를 클릭하고 구성이 카드로 표시될 때까지 기다립니다. 버튼 위치는 클라이언트 버전에 따라 달라질 수 있으니 현재 화면의 메뉴명을 기준으로 진행하세요.
- 새로 가져온 구성 카드를 선택해 현재 사용할 구성으로 지정합니다. 카드가 표시되는 것만으로 전환이 완료된 것은 아닙니다.
- ‘프록시’ 페이지로 이동해 정책 그룹과 노드가 표시되는지 확인한 뒤, 필요에 따라 노드나 자동 선택 그룹을 선택합니다.
가져온 뒤에는 구성과 트래픽을 각각 확인
먼저 구성이 정상적으로 로드되는지 확인합니다. 로그에 YAML 파싱 오류가 계속 표시되거나 정책 그룹이 존재하지 않는 노드를 참조해서는 안 됩니다. 다음으로 트래픽이 제대로 전달되는지 확인합니다. 일반 브라우저는 대개 ‘시스템 프록시’를 켜야 합니다. 시스템 프록시를 따르지 않는 앱은 별도로 프록시를 설정하거나 TUN 모드를 사용해야 할 수 있습니다. ‘웹페이지가 열리지 않는다’고 해서 곧바로 ‘구독을 가져오지 못했다’고 단정하지 마세요.
테스트할 때는 먼저 트래픽을 가로채는 방식 하나만 활성화해 문제 해결 변수를 줄이세요. ‘연결’ 페이지에서 대상 요청에 어떤 규칙이 적용되었고 어떤 정책 그룹을 사용했는지 확인할 수 있습니다. 노드 지연 시간 테스트 결과는 해당 테스트 요청에만 해당하며, 모든 웹사이트·프로토콜·앱이 정상이라는 뜻은 아닙니다.
방법 2: 로컬 YAML 구성 파일 가져오기
로컬 파일은 오프라인으로 옮기거나, 정상 작동이 확인된 구성을 보관하거나, 직접 작성한 규칙을 디버깅할 때 유용합니다. ‘구성’ 페이지에서 ‘새로 만들기’ 또는 파일 가져오기 메뉴를 사용해 로컬 유형을 선택하고 파일을 가져오세요. 메뉴 이름과 위치는 버전에 따라 다를 수 있습니다. 현재 버전에서 파일 끌어놓기를 지원한다면 화면 안내에 따라 진행하세요. 모든 버전에 고정된 가져오기 방식이라고 생각하고 끌어놓기를 시도하지는 마세요.
- 신뢰할 수 있는 출처에서 YAML 파일을 받아 텍스트 편집기로 확인하세요. 로그인 페이지나 오류 안내, 다운로드 설명이 아니라 실제 구성 텍스트인지 살펴봅니다.
- 원본 사본을 보관하고 파일에
proxies,proxy-groups,rules등 필요한 구성 섹션이 있는지 확인합니다. - 가져온 뒤 해당 구성을 선택하고 로그와 프록시 페이지를 확인합니다. 파싱 오류가 발생하면 들여쓰기, 콜론, 정책 그룹 이름부터 점검하세요.
로컬 구성에는 정기적으로 가져올 원격 출처가 없는 경우가 많습니다. 서비스 제공업체가 노드를 추가하거나 비밀번호를 변경해도 기존 파일은 자동으로 갱신되지 않으므로 새 파일을 받아 다시 가져와야 합니다. 파일 안에 원격 proxy-providers가 설정되어 있다면 각 제공업체가 설정에 따라 업데이트될 수 있습니다. 이는 파일 내부 리소스를 갱신하는 것이지 로컬 파일 전체를 교체하는 것은 아닙니다.
최소 구성으로 YAML 구조 이해하기
아래는 필드와 들여쓰기를 확인하기 위한 최소 예시입니다. 모든 연결은 직접 연결되며 프록시 노드는 포함하지 않습니다. 7897은 예시용 혼합 포트입니다. 실제 수신 포트는 클라이언트 ‘설정’의 포트 구성과 최종 적용된 구성에서 확인하세요.
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 수동 선택
type: select
proxies:
- DIRECT
rules:
- MATCH,수동 선택YAML은 들여쓰기로 계층 구조를 표현합니다. 여기서는 공백 두 칸을 사용하며 탭으로 들여쓰기를 대신할 수 없습니다. rules에서 참조하는 ‘수동 선택’은 정책 그룹 이름과 일치해야 합니다. 그룹 이름만 바꾸고 규칙을 수정하지 않으면 참조 오류가 발생합니다. 원격 구독 파일은 클라이언트의 오버라이드 설정에 영향을 받을 수도 있으므로 원본 파일을 수정하기 전에 다음 업데이트 때 변경 사항이 덮어써지는지 확인하세요.
방법 3: QR 코드를 스캔해 내용을 확인한 뒤 가져오기
QR 코드 스캔의 핵심은 텍스트를 얻는 것이며, 별도의 구성 형식은 아닙니다. 현재 데스크톱 버전에 QR 코드 스캔 기능이 없다면 휴대폰이나 로컬 QR 코드 인식 도구로 텍스트를 읽으세요. 그런 다음 신뢰할 수 있는 방법으로 구독 URL을 컴퓨터에 전송하고 ‘구성’ 페이지에 붙여넣어 가져옵니다. 토큰이 포함된 QR 코드를 낯선 온라인 인식 사이트에 업로드하지 마세요.
- 결과가 HTTPS 구독 주소인 경우: 도메인이 서비스 제공업체의 주소와 일치하는지 확인한 뒤 URL 가져오기 절차를 따릅니다.
- 결과가 단일 노드 URI인 경우: 서비스 제공업체 페이지로 돌아가 Clash 또는 mihomo 구독 내보내기를 선택하세요. 단일 노드 주소를 완전한 YAML 구성으로 사용하지 마세요.
- 결과가 특정 클라이언트를 여는 링크인 경우: 대상 클라이언트와 실행할 작업을 확인하세요. 해당 프로토콜을 처리하는 프로그램이 없으면 브라우저에서 링크를 열 수 없습니다. 이때는 원래 구독 주소를 사용하면 됩니다.
휴대폰에서 컴퓨터로 복사한 뒤 주소가 메신저에서 잘리지 않았는지, 줄바꿈이나 한글 문장 부호, 끝 공백이 붙지 않았는지 확인하세요. QR 코드에서 텍스트를 읽을 수 있다는 사실은 구독이 여전히 유효하거나 반환 형식이 Clash Verge Rev에 적합하다는 뜻이 아닙니다.
YAML과 Base64: 구성 구조와 인코딩 방식의 차이
Clash YAML은 계층형 필드로 구성된 텍스트로, 노드·정책 그룹·규칙·DNS 등의 내용을 정의할 수 있습니다. Base64는 인코딩 방식이지 프록시 프로토콜이 아니며 암호화도 아닙니다. 흔히 ‘Base64 구독’이라 부르는 내용은 디코딩하면 여러 줄의 노드 공유 링크로 이루어져 있습니다. 일반적으로 완전한 Clash 정책 그룹과 분기 규칙은 포함하지 않습니다.
| 확인 항목 | Clash YAML | 일반적인 Base64 노드 목록 |
|---|---|---|
| 텍스트 형식 | 필드, 콜론, 들여쓰기, 목록 | 인코딩된 텍스트이며 디코딩하면 보통 여러 줄의 URI로 표시 |
| 노드 정의 | 대개 proxies 또는 프록시 제공자에 정의 | 대개 각 공유 링크에 노드 정보가 포함됨 |
| 정책 및 규칙 | proxy-groups와 rules를 포함할 수 있음 | 대개 별도로 생성해야 함 |
| 가져오기 처리 | 코어가 해당 필드와 프로토콜을 지원하는지 확인한 뒤 불러오기 | 출처에서 Clash 형식으로 내보낸 파일을 받는 것이 우선 |
| 개인정보 위험 | 노드 비밀번호와 원격 리소스 주소가 포함될 수 있음 | 디코딩하면 내용을 읽을 수 있으므로 공개하지 마세요 |
확장자를 바꿔 형식을 변환하지 마세요
Base64 텍스트를 subscription.yaml로 저장해도 proxies와 rules가 생성되지는 않습니다. 마찬가지로 파일 이름을 .txt에서 .yaml로 바꿔도 문법 오류가 해결되지 않습니다. 파일 이름이나 다운로드 버튼의 아이콘, URL의 끝부분이 아니라 실제 내용으로 형식을 판단해야 합니다.
같은 구독 서비스도 내보내기 옵션, 요청 매개변수, User-Agent에 따라 다른 내용을 반환할 수 있습니다. 브라우저에는 노드 목록이 표시되고 클라이언트에는 YAML이 전달되더라도 반드시 문제가 있는 것은 아닙니다. 먼저 서비스 제공업체가 명시한 Clash 내보내기 주소를 사용하세요. 변환이 꼭 필요하다면 데이터 처리 방식을 파악할 수 있는 신뢰할 만한 도구를 선택하세요. 변환 서비스가 구독의 민감한 정보에 접근할 수 있으므로 함부로 제출해서는 안 됩니다.
업데이트 간격: 원격 구성과 프록시 제공자 구분하기
원격 구성의 업데이트 빈도는 구성 카드 편집 화면에서 설정합니다. 일반적인 경로는 ‘구성’ → 해당 카드의 메뉴 또는 마우스 오른쪽 버튼 메뉴 → ‘편집’입니다. 업데이트 간격 항목을 찾아보세요. 버전에 따라 항목 이름과 단위가 다를 수 있으므로 입력 전에 라벨을 확인하세요. 단위가 분이면 360은 6시간을 뜻하고, 초라면 6시간에 해당하는 값은 21600입니다. 다른 버전의 스크린샷에 나온 숫자를 그대로 사용하지 마세요.
일반적으로 6시간 간격부터 시작하고 서비스 제공업체의 권장 사항에 따라 조정하면 됩니다. 노드가 단기간에 바뀌지 않는다면 매분 가져올 필요가 없습니다. 너무 자주 요청하면 요청 제한에 걸릴 수 있습니다. 먼저 ‘업데이트’를 한 번 눌러 결과를 확인하고, 자동 업데이트가 예상대로 작동하는지 지켜보세요. 자동 업데이트는 보통 클라이언트가 실행 중이고 네트워크를 사용할 수 있어야 합니다. 컴퓨터가 꺼져 있거나 절전 모드일 때도 일반적인 온라인 작업처럼 실행된다고 생각하면 안 됩니다.
proxy-providers의 interval 단위는 초
mihomo 구성의 HTTP 프록시 제공자는 interval로 업데이트 주기를 설정할 수 있으며 단위는 초입니다. 예를 들어 interval: 3600은 제공자 콘텐츠를 1시간마다 가져온다는 뜻입니다. 이 설정은 해당 제공자에만 적용되며 클라이언트가 원격 구성 전체를 매시간 다시 다운로드하는 것과는 다릅니다. 제공자의 헬스 체크에는 노드를 테스트하기 위한 별도의 간격이 있습니다. 이를 구독 업데이트와 혼동하지 마세요.
가져오기 실패: 요청·내용·불러오기 단계별로 확인
- 먼저 요청이 성공했는지 확인합니다. 연결 시간이 초과되면 네트워크와 구독 도메인의 DNS를 확인하세요. HTTP
401또는403이면 토큰, 인증 상태, 서버 접근 제한을 확인합니다.429는 요청이 너무 잦다는 뜻이므로 잠시 기다린 뒤 업데이트 빈도를 낮추세요. 가져오기 버튼을 연속해서 누르지 마세요. - 다음으로 응답 내용을 확인합니다. HTTP
200이어도 로그인 페이지나 오류 페이지가 반환될 수 있습니다. 내용이<!DOCTYPE html>로 시작한다면 계정 페이지를 복사했는지, 요청이 인증 페이지로 리디렉션되었는지 확인하세요. - 그다음 구성 파싱을 확인합니다. YAML 행 오류가 나타나면 해당 행과 바로 앞 행의 들여쓰기, 따옴표, 콜론을 확인하세요. 지원하지 않는 노드 유형이 표시되면 수신 포트를 반복해서 수정하지 말고 내보내기 대상과 현재 코어의 지원 여부를 확인합니다.
- 마지막으로 구성이 활성화되었는지 확인합니다. 프록시 페이지에 예상한 노드가 없으면 먼저 현재 선택된 구성을 확인한 다음, 아직 다운로드에 실패한 프록시 제공자만 참조하고 있는지 살펴보세요.
가져오기, 업데이트, 프록시 연결은 각각 별도의 단계입니다. 구독 다운로드 실패가 TUN을 켠다고 반드시 해결되는 것은 아닙니다. 노드 연결에 실패했을 때 같은 구성을 다시 가져와도 해결되지 않을 수 있습니다. 먼저 실패 시각, 당시 작업, 로그의 주요 오류를 기록한 다음 설정을 한 번에 하나씩만 바꾸고 결과를 비교하세요.
마지막으로 간단히 확인하세요. 구성 카드가 선택되어 있고, 프록시 페이지에 예상한 정책 그룹이 표시되며, 수동 업데이트가 완료되고, 실제 요청이 연결 페이지에 올바른 경로로 표시되어야 합니다. 처음 사용하는 경우 클라이언트 시작 가이드를 참고해 시스템 프록시와 첫 연결 단계도 확인할 수 있습니다.