Clash 구독 링크 가져오는 방법: URL·로컬 파일·주요 구독 형식

가져오기 전에: 구독 주소·설정 파일·노드 목록 구분하기

Clash 구독을 가져올 때 중요한 것은 링크 이름이 아니라 링크가 반환하는 내용입니다. https://로 시작해도 웹 리소스 주소라는 뜻일 뿐, Clash 설정을 반환한다고 보장할 수는 없습니다. .yaml로 끝나더라도 내부 구조가 올바르다는 보장은 없습니다. 먼저 서비스 제공업체의 구독 페이지에서 현재 클라이언트의 코어에 맞는 출력 형식을 선택한 다음 전체 주소를 복사하세요.

클라이언트는 설정 관리와 UI 조작을 담당하고, 코어는 설정을 파싱하고 규칙을 처리하며 연결을 구성합니다. mihomo 코어를 사용하는 클라이언트는 해당 코어의 새 프로토콜과 필드를 인식할 수 있지만, 구버전 오리지널 Clash는 같은 설정을 지원하지 않을 수 있습니다. 따라서 형식이 올바른지와 코어가 호환되는지는 별도로 확인해야 합니다.

데스크톱에서 URL 가져오기: 원격 설정을 만들고 활성화하기

Clash Verge Rev와 같은 데스크톱 클라이언트를 예로 들면, 「설정」→「새로 만들기」→원격 유형 선택→구독 URL 입력→저장 순으로 진행한 뒤 해당 설정을 선택합니다. 버전에 따라 메뉴 이름은 달라질 수 있습니다. 일부 버전은 URL 입력란을 설정 페이지 상단에 표시하고 버튼을 「가져오기」로 표기하지만, 원격 설정 항목을 만드는 과정이라는 점은 같습니다.

1. 구독 주소를 복사합니다. 제공업체 페이지에서 Clash 또는 mihomo 호환 구독 형식을 선택하세요. 주소 끝부분이 빠지지 않도록 페이지의 복사 버튼을 사용하고, 로그인 페이지나 결제 페이지 주소를 복사하지 마세요.
2. 원격 설정을 입력합니다. 설정 페이지를 열고 전체 주소를 URL 입력란에 붙여 넣은 다음 알아보기 쉬운 짧은 이름을 입력하세요. 제공업체가 별도로 안내하지 않았다면 요청 헤더, 사용자 에이전트, 업데이트 간격은 우선 기본값으로 두세요.
3. 처음으로 다운로드합니다. 저장 또는 가져오기를 눌러 설정 항목이 나타날 때까지 기다리세요. 파싱 오류가 표시되면 시스템 프록시를 계속 켜고 끄기보다 반환된 형식부터 확인해야 합니다.
4. 설정을 선택하고 불러옵니다. 해당 항목이 현재 사용 중으로 표시되는지 확인하세요. 목록에 항목을 추가하는 것만으로 코어가 해당 설정으로 전환되는 것은 아닐 수 있습니다.
5. 프록시 그룹을 확인합니다. 프록시 페이지에서 프록시 그룹과 선택 가능한 노드가 있는지 확인한 뒤 필요하면 시스템 프록시를 활성화하세요. 먼저 규칙 모드로 확인하고 TUN은 동시에 켜지 않아도 됩니다.

링크를 붙여 넣을 때 놓치기 쉬운 점

• 링크 앞뒤의 공백, 따옴표, 줄바꿈은 제거하되 ? 뒤의 쿼리 매개변수는 함부로 삭제하지 마세요.
• HTML 소스에서 복사한 &는 이스케이프된 문자열입니다. 원래 페이지로 돌아가 복사 버튼을 눌러 실제 URL을 가져오는 것이 좋습니다.
• HTTPS를 임의로 HTTP로 바꾸지 마세요. 인증서 오류가 발생하면 기기 시간, 네트워크 환경, 서버 인증서를 먼저 확인하세요.
• 일부 서비스는 User-Agent에 따라 다른 내용을 반환합니다. 제공업체가 요구한다고 확인된 경우에만 클라이언트의 구독 요청 User-Agent를 변경하세요.

모바일에서 가져오기: URL·클립보드·QR 코드

Android 클라이언트는 대개 「설정」 페이지의 추가 버튼을 누른 뒤 URL, 파일 또는 QR 코드를 선택하는 방식입니다. mihomo를 지원하는 모바일 클라이언트를 예로 들면, 먼저 설정을 추가해 현재 설정으로 지정한 다음 연결을 시작하세요. 처음 연결할 때 표시되는 시스템 VPN 권한 요청은 기기 내 트래픽을 처리하기 위한 통로를 설정하는 과정입니다. 구독 다운로드와는 별개의 단계이므로 권한이 승인됐다고 구독이 정상 작동한다고 판단할 수는 없습니다.

1. 구독 페이지에서 현재 클라이언트에 맞는 URL을 복사한 다음 클라이언트의 설정 목록으로 돌아갑니다.
2. 새 설정 추가 메뉴를 열고 URL 가져오기를 선택해 주소를 붙여 넣으세요. QR 코드를 스캔한다면 QR 코드에 단일 노드 링크가 아니라 구독 URL이 들어 있는지 먼저 확인하세요.
3. 저장한 뒤 다운로드가 완료될 때까지 기다리고 설정 이름, 프록시 그룹, 오류 메시지를 확인합니다.
4. 현재 설정으로 지정한 뒤 연결을 켜고 시스템 권한을 승인합니다. 그런 다음 정상 접속이 확인된 웹사이트를 열어 테스트하세요.

iOS 클라이언트의 형식 지원과 가져오기 방법은 앱마다 다르므로 Android의 메뉴 경로를 그대로 따라 해서는 안 됩니다. 앱이 자체 구독 형식만 지원한다면 제공업체 페이지에서 해당 형식을 선택하세요. Clash YAML을 명시적으로 지원하는 메뉴에서만 이 문서에서 설명하는 전체 설정을 가져올 수 있습니다.

로컬 YAML 가져오기: 파일 구조와 들여쓰기 확인

로컬 파일은 오프라인으로 설정을 보관하거나 기존 설정을 옮길 때, 또는 구독 다운로드 문제를 확인할 때 유용합니다. 클라이언트에서 「설정」→파일 가져오기를 선택하고 실제로 저장된 .yaml 또는 .yml 파일을 찾아 가져온 다음 활성화하세요. 웹페이지를 파일로 저장하면 HTML이 내려받아질 수 있으며, 확장자만 바꿔도 YAML로 변환되지는 않습니다.

아래 예시는 설정을 불러올 수 있는지 확인하기 위한 직결 구성으로, 로컬 수신 포트와 기본 규칙을 명시했으며 프록시 노드는 포함하지 않습니다. 이를 이용하면 ‘클라이언트가 YAML을 불러올 수 있는지’와 ‘원격 구독에서 프록시를 정상적으로 제공하는지’를 구분해 확인할 수 있습니다.

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

proxies: []
proxy-groups: []

rules:
  - MATCH,DIRECT

• mixed-port: 7890은 이 예시에서 같은 포트로 HTTP와 SOCKS 프록시를 제공한다는 뜻입니다. 포트가 이미 사용 중이면 포트 번호를 바꾸거나 해당 포트를 사용하는 프로그램을 종료해야 합니다.
• allow-lan: false는 LAN 접속을 허용하지 않는다는 뜻입니다. 처음 확인할 때는 true로 바꿀 필요가 없습니다.
• MATCH,DIRECT는 기본 규칙에 해당하는 모든 연결을 직접 연결하므로 이 예시에서는 원격 프록시를 사용할 수 없습니다.
• YAML 들여쓰기에는 공백을 사용하고 Tab은 사용하지 마세요. 노드 이름에 콜론과 공백 등 특수 문자가 들어가면 올바르게 따옴표로 감싸야 합니다.

로컬 파일을 가져오면 클라이언트가 사본을 저장할 수 있습니다. 따라서 원본 파일을 계속 수정해도 가져온 항목에는 변경 사항이 반영되지 않을 수 있습니다. 일반 로컬 설정은 원격 전체 설정을 자동으로 다시 다운로드하지 않지만, 별도로 선언된 원격 provider는 설정에 따라 업데이트될 수 있습니다. 전체 구독을 계속 동기화하려면 원격 URL 항목을 사용하세요.

Base64 노드 목록과 전체 설정의 차이

Base64는 인코딩 방식이지 프록시 프로토콜이나 암호화가 아닙니다. Base64 문자열을 디코딩하면 여러 줄의 노드 링크만 나오는 경우가 많으며, 일반적으로 Clash에 필요한 프록시 그룹과 분기 규칙은 포함되지 않습니다. 이를 전체 YAML 설정으로 바로 가져오면 파싱에 실패하거나 노드 정보만 있고 선택 및 라우팅에 필요한 구조가 없는 결과가 나올 수 있습니다.

전체 설정과 provider 파일은 서로 바꿔 쓸 수 없습니다

전체 설정에는 proxies로 노드를 직접 선언하거나 proxy-providers로 외부 노드 리소스를 가져올 수 있습니다. 프록시 그룹은 proxies 또는 use를 통해 이를 참조하고, 규칙에 따라 연결 경로가 결정됩니다. 최상위에 proxies:만 선언된 파일은 provider로 파싱될 수 있더라도 프록시 그룹과 규칙까지 설정된 주 설정 파일과 같지 않습니다.

권장하는 형식 변환 순서

1. 먼저 기본 제공 형식을 선택합니다. 변환 단계를 줄이려면 제공업체에서 직접 생성한 Clash 또는 mihomo 설정을 우선 사용하세요.
2. 그다음 클라이언트 기능을 확인합니다. 노드 링크를 가져와 설정을 자동 생성하는 클라이언트도 있고 전체 YAML만 받는 클라이언트도 있습니다. 사용 중인 클라이언트의 안내를 확인하세요.
3. 마지막으로 변환을 고려합니다. 변환이 꼭 필요하다면 신뢰할 수 있는 도구를 사용하거나 직접 구축하고, 노드 프로토콜, 전송 매개변수, 프록시 그룹 템플릿, 규칙 출처를 함께 확인하세요.

변환 도구는 원본 구독과 모든 노드 인증 정보에 접근할 수 있습니다. 출처를 알 수 없는 공개 변환 사이트에 개인 구독 정보를 입력하지 마세요. 변환으로 구형 코어에 없는 프로토콜 지원 기능을 추가할 수도 없습니다. 노드에 mihomo 기능이 필요하다면 출력 파일 이름만 바꾸지 말고 클라이언트에서 실제로 실행 중인 코어부터 확인하세요.

구독 가져오기 실패: 다운로드·파싱·연결 단계별 점검

클라이언트 로그에서 오류가 발생한 단계를 먼저 확인한 뒤 관련 설정을 조정하세요. 다운로드 오류는 내용을 가져오는 중에 발생하고 파싱 오류는 가져온 내용을 읽는 중에 발생합니다. 설정을 불러온 뒤에도 웹페이지가 열리지 않을 때는 프록시 연결, 규칙, DNS를 점검해야 합니다. 이 세 가지 문제를 한꺼번에 다루면 정상 작동하던 설정까지 잘못 바꾸기 쉽습니다.

브라우저에서는 열리는데 클라이언트에서는 왜 실패하나요?

브라우저는 로그인 쿠키를 보낼 수 있지만 클라이언트는 보통 별도로 구독을 요청합니다. 브라우저가 시스템 프록시를 사용하는 반면 클라이언트의 구독 업데이트는 직접 연결이나 별도의 다운로드 설정을 사용할 수도 있습니다. 따라서 브라우저에 계정 페이지가 표시된다고 해서 클라이언트가 YAML을 가져온 것은 아닙니다. 업데이트에 프록시가 필요하다면 현재 불러온 설정이 작동하는지 먼저 확인한 뒤 클라이언트의 구독 업데이트 프록시 옵션을 살펴보세요. 아직 설정이 없는 상태에서 필요한 연결을 전제로 구독을 처음 가져오려 하지 마세요.

설정은 불러왔지만 웹페이지가 열리지 않음

• 현재 선택한 설정이 방금 가져온 항목인지, 프록시 그룹에서 사용할 수 있는 노드를 선택했는지 확인합니다.
• 프록시 모드를 확인합니다. 규칙 모드는 규칙에 따라 연결하고, 직접 연결 모드는 노드를 거치지 않습니다. 전역 모드로 바꿔도 노드 자체에 접속할 수 없는 문제는 해결되지 않습니다.
• 시스템 프록시 포트와 실제 수신 포트가 일치하는지 확인합니다. 예를 들어 실제 수신 포트는 7890인데 시스템 프록시는 이전 포트인 7897을 가리키면 앱의 연결이 실패할 수 있습니다.
• 시스템 프록시를 따르지 않는 앱은 트래픽을 처리할 방법을 별도로 확인한 뒤 TUN 사용을 검토하세요. TUN을 구독 형식 복구 도구처럼 사용하지 마세요.

자동 업데이트와 로컬 오버라이드: 반복 가능한 설정 관리

원격 구독을 업데이트하면 보통 해당 항목의 원격 내용이 교체되므로 다운로드한 YAML을 직접 편집하면 다음 새로고침 때 변경 사항이 사라질 수 있습니다. 고정 DNS, 사용자 지정 규칙, 프록시 그룹 조정이 필요하다면 클라이언트가 지원하는 오버라이드, 설정 병합 또는 스크립트 기능을 우선 사용하고 적용 순서를 확인하세요. 오버라이드 문법은 클라이언트마다 다르므로 특정 클라이언트의 스크립트를 코어 설정 필드처럼 사용할 수는 없습니다.

1. 먼저 수동으로 한 번 업데이트합니다. 다운로드와 파싱이 정상인지 확인한 다음 주기 업데이트를 설정하세요. 제공업체 안내에 따라 간격을 조정하되, 우선 24시간으로 설정해 짧은 시간 동안 요청이 반복되지 않도록 할 수 있습니다.
2. 업데이트 대상을 구분합니다. 전체 설정, 프록시 provider, 규칙 provider는 각각 업데이트 주기가 다를 수 있습니다. 한 항목을 업데이트해도 다른 리소스까지 새로고침되는 것은 아닙니다.
3. 오버라이드 결과를 확인합니다. 편집 창만 보지 말고 최종 적용된 설정과 로그를 확인하세요. 사용자 지정 규칙의 위치에 따라 결과가 달라질 수 있으며, 기본 규칙인 MATCH 뒤의 규칙은 대개 일치하지 않습니다.
4. 복구 방법을 마련해 둡니다. 정상 작동을 확인한 설정 사본을 저장하고 원래 구독 출처를 기록하세요. 업데이트에 실패하면 원인을 찾기 전에 먼저 작동하는 설정으로 복구합니다.

가져오기가 끝나면 원격 다운로드 성공, 코어 로드 성공, 프록시 그룹에서 노드 선택 가능 여부, 대상 앱이 예상한 규칙을 실제로 따르는지 확인하세요. 시스템 프록시나 TUN 설정은 구독 가져오기 및 연결 가이드에서 확인할 수 있습니다. 필드와 DNS 설정은 전체 설정 안내서를, 업데이트 실패 후 조치는 구독 업데이트 문제 해결을 참고하세요.