Clash 구독 링크 가져오기 가이드: URL 가져오기, 로컬 YAML, Base64 형식 확인

먼저 구독 응답 형식 확인하기

Clash 구독을 가져올 수 있는지는 링크가 반환하는 내용과 클라이언트가 지원하는 설정 형식에 따라 달라집니다. 링크가 .yaml로 끝나는지는 기준이 아닙니다. 구독 제공업체가 「Clash」 또는 「Clash Meta / mihomo」로 표시한 항목을 우선 사용한 뒤 클라이언트에서 가져오세요. 일반 HTTPS 주소는 완전한 설정 파일, Base64 노드 목록, 로그인 페이지 또는 오류 메시지를 반환할 수 있습니다.

클라이언트는 설정, 시스템 프록시, 코어를 관리하는 그래픽 인터페이스이고, mihomo는 프록시 프로토콜과 분기 규칙을 실행하는 코어입니다. 인터페이스에 「구독 가져오기」 버튼이 있다고 해서 코어가 모든 구독 형식을 직접 읽을 수 있는 것은 아닙니다. 일부 클라이언트는 먼저 내용을 변환하지만, 다른 클라이언트는 Clash YAML만 지원하므로 각각 확인해야 합니다.

받은 내용	식별 방법	처리 방법
완전한 Clash YAML	일반적인 최상위 필드는 `proxies`, `proxy-groups`, `rules`입니다.	URL 설정 가져오기 또는 로컬 설정 가져오기 사용
노드 제공업체 YAML	대개 `proxies` 노드 목록만 포함	`proxy-providers`에서 참조하거나 클라이언트가 명시적으로 지원하는 병합 기능 사용
Base64 노드 목록	디코딩하면 여러 줄의 `ss://`, `vmess://` 등의 URI가 나타남	제공업체의 Clash 형식 출력 또는 신뢰할 수 있는 로컬 변환 도구 사용
웹페이지 또는 오류 데이터	HTML 태그, 로그인 양식, JSON 오류 메시지가 나타남	링크, 인증 상태, 구독 유효기간을 확인하세요. YAML로 불러올 수 없습니다.

URL로 구독 가져오기

구독 제공업체에서 전체 주소를 복사하고 쿼리 매개변수를 그대로 유지하세요. URL의 토큰은 보통 접근 인증 정보입니다. 물음표 뒤 내용을 빠뜨리면 HTTP 401 또는 403 오류가 발생할 수 있습니다. 웹사이트 로그인 주소, 구매 페이지, QR 코드 이미지 주소를 구독 주소로 사용하지 마세요.

가져오기와 활성화는 따로 확인

설정 관리로 이동합니다. 클라이언트에서 「설정」, 「구독」 또는 Profiles 페이지를 열고 URL 입력란이 있는 원격 가져오기 메뉴를 선택합니다. 메뉴 이름은 클라이언트마다 다르므로 실제 인터페이스를 기준으로 확인하세요.
전체 URL을 붙여 넣습니다. 입력란에는 링크만 넣고, 메신저에서 함께 복사된 따옴표나 설명, 줄바꿈은 제거하세요. 제공업체가 안내한 HTTPS 주소를 우선 사용하세요.
다운로드 또는 가져오기를 실행합니다. 설정 항목이 나타날 때까지 기다린 후 업데이트 시간과 오류 메시지를 확인하세요. 구형 Clash for Windows 영문 인터페이스에서는 Profiles → URL 입력란 → Download 경로를 사용합니다. 해당 클라이언트는 더 이상 유지 관리되지 않으며, 이 경로는 기존 인터페이스를 식별하기 위한 참고용입니다.
설정을 선택합니다. 다운로드가 끝나면 해당 설정 항목을 클릭해 현재 설정으로 지정합니다. 다시 불러오기에 실패했다는 메시지가 표시되면 로그부터 확인하세요. 목록에 항목이 있다는 이유만으로 성공했다고 판단하면 안 됩니다.
실행 상태를 확인합니다. 규칙 모드에서 정책 그룹이 로드되었는지 확인하고 사용할 수 있는 정책을 선택하세요. 데스크톱 클라이언트에서는 사용 환경에 따라 시스템 프록시나 TUN도 켜야 합니다. 설정을 가져온 것만으로 트래픽이 자동으로 전달되지는 않습니다.

「다운로드 성공 → 파싱 성공 → 설정 활성화 → 트래픽 적용」의 네 단계를 차례로 확인하세요. 첫 단계만 완료되면 브라우저는 여전히 기존 연결 방식을 사용할 수 있습니다. 파싱에 실패한 경우 클라이언트가 이전의 유효한 설정을 계속 사용할 수도 있습니다. 설치 파일이 필요하면 클라이언트 다운로드 페이지에서 운영체제를 선택한 다음 설치 및 설정 가이드를 참고하세요.

로컬 YAML 파일 가져오기

로컬 YAML은 오프라인 보관, 설정 이전, 형식 문제 진단에 적합합니다. 보통 「설정」 페이지의 「파일 가져오기」 메뉴나 파일 끌어놓기 영역에서 가져올 수 있습니다. 가져온 뒤에는 설정을 직접 선택하고 클라이언트 로그에 구문 오류가 없는지 확인하세요.

파일 가져오기 전 확인할 세 가지

인코딩과 확장자: UTF-8 텍스트 파일인지 확인하고 파일명이 config.yaml.txt가 아닌지 확인하세요. 아이콘만 보는 것보다 파일 관리자에서 확장자 표시를 켜는 편이 확실합니다.
들여쓰기와 계층: YAML 들여쓰기에는 공백을 사용하고 Tab은 사용하지 마세요. 같은 계층의 필드는 맞춰 정렬하고, 목록 항목의 하이픈도 해당 필드 계층에 맞춰야 합니다.
설정의 완성도: 노드 목록만 있는 YAML은 완전한 트래픽 분기 설정이 아닙니다. 실제로 사용할 정책 그룹, 규칙, DNS 설정은 기본 설정에서 제공해야 합니다.

아래는 계층 구조를 설명하기 위한 최소한의 직결 설정입니다. 원격 프록시 노드가 없으므로 구독 노드의 연결 가능 여부를 확인하는 용도로는 사용할 수 없습니다. 가져오기와 파싱 절차만 확인하려면 먼저 현재 설정을 백업하고, 테스트 후 원래 설정으로 되돌리세요.

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은 규칙에 따라 연결을 분류한다는 뜻입니다. 마지막의 MATCH는 나머지 연결을 「수동 선택」 그룹으로 보내며, 이 그룹에는 DIRECT만 있으므로 예시의 연결은 직결됩니다. 포트가 이미 사용 중이면 구문이 올바르더라도 정상적으로 수신을 시작하지 못할 수 있습니다.

Base64 노드 목록 식별하기

Base64는 인코딩 방식이지 Clash 설정 문법이나 암호화 보호 기능이 아닙니다. 일반 구독은 여러 노드 URI를 합친 뒤 인코딩하는 경우가 많으며, 디코딩하면 ss://, trojan://, vmess://, vless:// 등이 나타날 수 있습니다. 이런 텍스트에는 일반적으로 완전한 정책 그룹과 규칙이 포함되어 있지 않습니다.

형식을 확인한 뒤 호환되는 방법 선택하기

먼저 제공업체 페이지에서 Clash 또는 mihomo 형식으로 명시된 구독을 찾으세요. 같은 계정에 여러 출력 주소가 있을 수 있으므로 현재 코어에 맞는 주소를 복사해야 합니다.
일반 구독만 제공된다면 클라이언트가 URI 목록 또는 Base64 가져오기를 명시적으로 지원하는지 확인하세요. 단일 노드 URI를 지원한다고 해서 전체 Base64 구독도 지원하는 것은 아닙니다.
변환이 꼭 필요하다면 제공업체의 변환 기능이나 신뢰할 수 있는 로컬 도구를 우선 사용하세요. 변환 과정에서는 노드 프로토콜, 전송 계층, TLS 등의 필드를 해석해야 하므로 파일 확장자만 바꾸는 것으로는 해결되지 않습니다.
변환 후에는 노드 수, 정책 그룹 참조, 코어 오류를 확인한 다음 활성화 여부를 결정하세요. 파싱에 성공해도 각 노드의 연결 매개변수가 모두 올바르다는 뜻은 아닙니다.

원본 Clash와 Clash Meta(현재 명칭은 mihomo)는 지원하는 프로토콜과 필드가 완전히 같지 않습니다. 변환 도구가 특정 프로토콜 필드를 생성하더라도 구형 코어에서 실행할 수 있다는 뜻은 아닙니다. unsupported proxy type와 같은 오류가 발생하면 같은 파일을 계속 다시 가져오지 말고 현재 실행 중인 코어와 구독 대상 형식이 맞는지 확인하세요.

구독 업데이트 간격 설정

원격 설정 파일 전체 업데이트와 노드 제공업체 업데이트는 별개의 기능입니다. 그래픽 클라이언트는 원격 설정을 다운로드하고, mihomo의 proxy-providers는 노드 목록을 주기적으로 가져올 수 있습니다. 두 곳의 interval이나 인터페이스의 숫자를 같은 의미로 보면 안 됩니다. 상태 확인 주기도 구독 갱신 주기와 다릅니다.

업데이트 위치	업데이트 대상	단위와 예시
클라이언트의 원격 설정	전체 설정 파일	인터페이스에 표시된 단위에 맞춰 설정합니다. 분 단위라면 `360`은 6시간입니다.
`proxy-providers` 아래의 `interval`	지정된 제공업체의 노드 목록	초 단위입니다. `21600`은 6시간입니다.
`health-check.interval`	노드 연결 상태 확인	초 단위입니다. `300`은 5분마다 확인한다는 뜻이며, 새 구독을 다운로드하지는 않습니다.

일상적인 사용이라면 먼저 업데이트 간격을 6시간으로 설정하고 제공업체의 제한에 따라 조정하세요. 이는 설정 예시일 뿐 프로토콜 요구사항은 아닙니다. 클라이언트가 응답에 포함된 업데이트 권장값을 읽을 수 있다면 실제 동작은 해당 클라이언트의 구현에 따라 달라집니다. 계정 서비스 측에 변경 사항이 생긴 뒤에는 수동 업데이트를 한 번 실행하고 업데이트 시간과 노드 목록을 확인하세요.

업데이트 후 로컬 설정 유지하기

원격 설정이 업데이트되면 직접 수정한 포트, 규칙, DNS 설정이 덮어써질 수 있습니다. 로컬 변경 사항을 계속 유지해야 한다면 클라이언트가 지원하는 재정의, 병합 또는 확장 설정 기능을 사용하고 병합 결과를 확인하세요. 원격 파일을 수정해도 다음 구독 업데이트 후 내용이 유지된다고 가정하지 마세요.

또한 전체 설정 구독에는 노드뿐 아니라 규칙과 외부 리소스 참조가 포함될 수 있습니다. 가져오기 전에 출처를 신뢰할 수 있는지 확인하고 allow-lan, 제어 인터페이스, 수신 주소 등의 설정이 현재 기기에 적합한지 점검하세요. 일반적인 개인용 데스크톱 환경에서는 가져오기를 위해 근거리 통신망 접근을 무작정 허용하지 마세요.

가져오기 오류를 해결하는 순서

먼저 다운로드 실패, 형식 오류, 실행 실패를 구분한 뒤 해당 단계의 문제를 해결하세요. 가져오기 버튼을 계속 누르는 것으로는 형식 문제가 해결되지 않으며, 제공업체의 요청 빈도 제한에 걸릴 수도 있습니다.

증상	우선 확인할 항목	다음 단계
HTTP 401 또는 403	토큰, 계정 상태, 접근 제한	제공업체 관리 페이지에서 링크를 다시 복사하세요. 상태 코드만으로 원인을 단정하지 마세요.
HTTP 429	요청 빈도가 지나치게 높지 않은지	연속 새로고침을 중단하고 서버의 재시도 안내를 따르면서 업데이트 간격을 늘리세요.
HTML이 반환되거나 첫 줄 파싱 오류가 발생함	로그인 페이지, 인증 페이지 또는 리디렉션 오류 페이지로 이동하지 않았는지	최종 응답 본문을 확인해 구독 데이터가 반환되었는지 확인하세요.
YAML 들여쓰기 또는 필드 오류	파일 내용, 들여쓰기, 중복 키, 프로토콜 지원 여부	로그에서 오류가 발생한 줄을 찾아 올바른 형식으로 다운로드했는지 확인하세요.
가져오기는 성공했지만 예상한 노드가 없음	노드 제공업체 파일인지, 계정에서 빈 목록을 반환했는지	설정 유형과 제공업체 상태를 확인한 뒤 정책 그룹 참조를 점검하세요.
설정을 활성화해도 접속할 수 없음	현재 설정, 그룹 내 선택 항목, 시스템 프록시 또는 TUN, DNS	트래픽 흐름을 따라 항목별로 확인하세요. 구독만 계속 다시 다운로드하지 마세요.

브라우저에서는 열리지만 클라이언트 다운로드는 실패함

브라우저와 클라이언트는 서로 다른 프록시 경로, DNS 또는 요청 헤더를 사용할 수 있습니다. 브라우저에 다운로드 결과가 표시되더라도 클라이언트 요청이 같은 주소에 도달한다는 뜻은 아닙니다. 먼저 로그에서 시간 초과, 인증서 또는 도메인 이름 확인 오류를 살펴보세요. 클라이언트에 구독 다운로드 프록시 옵션이 있다면 안내에 따라 선택하세요. 연결 문제를 감추기 위해 인증서 검증을 끄지 마세요.

구독을 가져오기 전부터 다운로드에 프록시가 필요함

최초 설정 때 발생할 수 있는 순환 의존성 문제입니다. 제공업체에 접속할 수 있는 신뢰할 만한 기기나 네트워크에서 YAML을 다운로드한 뒤 로컬 파일로 처음 가져올 수 있습니다. 그런 다음 원래 기기로 돌아가 원격 업데이트를 확인하세요. 설정 파일은 민감 정보로 취급하고 공개 클라우드 드라이브나 단체 대화방에 올리지 마세요.

문제 해결 후에는 다음 세 가지를 모두 확인하세요. 대상 설정이 현재 활성화되어 있고, 로그에 파싱 또는 리소스 다운로드 오류가 계속 발생하지 않으며, 연결 테스트가 예상한 정책을 사용하는지 확인합니다. 필드의 의미와 규칙 작성법은 설정 파일 참고 문서에서, 일반적인 트래픽 적용 문제는 FAQ에서 확인할 수 있습니다. 구독 업데이트 성공은 가져오기와 로드 과정이 정상이라는 뜻일 뿐, 노드 연결 상태는 별도로 확인해야 합니다.