Clash 구독 URL이란
Clash 구독 URL(Subscription URL)은 프록시 서비스 제공업체가 제공하는 HTTPS 주소입니다. 접속하면 사용 가능한 모든 노드 정보가 담긴 YAML 형식의 설정 파일이 반환됩니다. 이 파일에는 다음이 포함됩니다:
- 모든 프록시 노드의 서버 주소, 포트, 프로토콜 및 인증 정보 (
proxies필드) - 정책 그룹 설정 (
proxy-groups) - 트래픽 분기 규칙 (
rules) - DNS 및 TUN 등의 전역 설정
프록시 서비스 제공업체는 노드를 정기적으로 업데이트합니다(새 노드 추가, 장애 노드 제거, 설정 변경 등). 따라서 최신 노드 목록을 사용하려면 구독을 주기적으로 갱신해야 합니다.
구독 형식 안내
서비스 제공업체에 따라 여러 구독 형식을 지원할 수 있습니다. V2Ray JSON, SS base64, ShadowsocksR 등의 형식이 아닌 Clash 형식(Mihomo 형식 또는 YAML 형식이라고도 함)을 사용하고 있는지 확인하세요.
올바른 Clash 구독 URL이 반환하는 콘텐츠의 첫 번째 줄은 일반적으로 다음과 같습니다:
mixed-port: 7890
# 또는
port: 7890
proxies:
- ...
서비스 제공업체가 "Clash 구독"과 "Mihomo 구독" 두 가지 옵션을 제공하는 경우 Mihomo 구독을 우선 선택하세요. VLESS, Hysteria2 등 최신 프로토콜을 지원합니다.
데스크톱 구독 가져오기 (Clash Verge Rev)
구독 추가
- Clash Verge Rev를 열고 왼쪽 내비게이션의 "프로필"(Profiles)을 클릭
- 오른쪽 상단의 "새로 만들기" 버튼을 클릭하고 "URL에서 가져오기"를 선택
- "구독 URL" 입력창에 서비스 제공업체가 제공한 구독 링크를 붙여넣기
- 식별하기 쉽도록 프로필 이름(예: "나의 서비스")을 입력
- "가져오기"를 클릭하고 다운로드 완료를 기다림
- 가져오기 성공 후 프로필 카드의 "활성화" 버튼을 클릭(또는 카드 더블클릭)하여 구독을 적용
자동 업데이트 설정
- 프로필 카드 오른쪽 상단의 "설정" 아이콘(점 세 개 또는 톱니바퀴)을 클릭
- "업데이트 간격"을 24시간(1440분)으로 설정. 최소 6시간 이상 권장
- "시작 시 업데이트"를 체크하여 Clash 실행 시마다 최신 노드를 자동으로 가져오도록 설정
- "저장"을 클릭
Android 구독 가져오기 (ClashMeta for Android)
구독 추가
- CMFA를 실행하고 오른쪽 하단의 + 버튼을 탭
- "URL"을 선택
- URL 입력란에 구독 링크를 붙여넣고 프로필 이름을 입력
- 오른쪽 상단의 저장 아이콘을 탭하고 다운로드를 기다림
- 메인 화면으로 돌아가 새 프로필을 길게 누름 → "선택으로 설정"을 탭하여 활성화
자동 업데이트 설정
- 프로필 항목을 길게 누르고 "편집"을 선택
- "자동 업데이트 간격" 필드에
1440(분, 즉 24시간)을 입력 - 설정을 저장
앱 메인 화면에서 아래로 당겨 새로 고침하면 모든 구독을 즉시 수동 업데이트할 수도 있습니다.
iOS 구독 가져오기 (Stash / Shadowrocket)
Stash로 가져오기
- Stash를 열고 하단의 "설정" 탭을 탭
- 오른쪽 상단의 "+"를 탭하고 "URL에서 다운로드"를 선택
- 구독 링크를 붙여넣고 "확인"을 탭
- 설정 목록에서 방금 다운로드한 설정을 탭하고 "이 설정 사용"을 선택
- 설정 상세 페이지에서 자동 업데이트 간격(권장: 24시간)을 설정 가능
Shadowrocket으로 가져오기
- Shadowrocket을 열고 오른쪽 상단의 "+"를 탭
- 유형을 "Subscribe"로 선택
- URL에 구독 링크를 입력하고 비고란에 이름을 작성
- 완료를 탭한 후, 서버 목록에서 구독 그룹을 길게 누름 → "업데이트"
proxy-providers: YAML 수준 구독 설정
커스텀 YAML 설정 파일을 사용하는 경우, proxy-providers 필드를 통해 YAML 내에서 직접 구독 링크를 참조하여 더 유연한 다중 구독 관리를 구현할 수 있습니다:
proxy-providers:
서비스A:
type: http
url: "https://your-airport-a.com/clash/subscription?token=xxxx"
path: ./providers/airport-a.yaml
interval: 86400 # 자동 업데이트 간격(초)
health-check:
enable: true
url: "https://www.gstatic.com/generate_204"
interval: 300 # 노드 헬스 체크 간격
서비스B:
type: http
url: "https://your-airport-b.com/api/v1/client/subscribe?token=yyyy"
path: ./providers/airport-b.yaml
interval: 86400
health-check:
enable: true
url: "https://www.gstatic.com/generate_204"
interval: 300
proxy-groups:
- name: "Proxy"
type: select
use: # proxy-providers의 노드 사용
- 서비스A
- 서비스B
proxies:
- DIRECT
- name: "자동 선택"
type: url-test
use:
- 서비스A
url: "https://www.gstatic.com/generate_204"
interval: 300
proxy-providers의 주요 장점:
- 구독 노드와 규칙 설정이 분리되어 커스텀 규칙에 영향 없이 노드만 독립적으로 업데이트 가능
- 여러 서비스 제공업체의 구독을 동시에 참조하여 하나의 정책 그룹으로 합칠 수 있음
- 각 서비스 제공업체 노드별로 헬스 체크 빈도를 독립적으로 설정 가능
filter필드로 정규식을 이용한 노드 이름 필터링 지원
# filter를 사용하여 특정 지역 노드만 선택
- name: "홍콩 노드"
type: url-test
use:
- 서비스A
filter: "홍콩|HK|Hong Kong" # 이름에 "홍콩" 또는 "HK"가 포함된 노드만 사용
url: "https://www.gstatic.com/generate_204"
interval: 300
구독 업데이트 실패 문제 해결
업데이트 타임아웃 / 연결 불가
구독 URL은 일반적으로 해외 서버에 있어 프록시가 활성화되지 않으면 접속할 수 없습니다. 해결 방법:
- Clash에 사용 가능한 이전 설정이 있고 프록시가 활성화된 상태인지 확인한 후 수동 업데이트 클릭
- 일시적으로 전역 프록시 모드로 전환하고, 업데이트 완료 후 규칙 모드로 되돌리기
- 일부 서비스 제공업체는 국내에서 접속 가능한 구독 주소를 제공함 — 서비스 대시보드에서 확인
형식 오류 / 노드 목록이 비어 있음
가져온 후 노드 수가 0이거나 클라이언트가 형식 오류를 보고하는 경우:
- V2Ray 또는 ShadowsocksR 형식이 아닌 Clash/Mihomo 형식의 구독을 선택했는지 확인
- 브라우저에서 구독 URL에 직접 접속하여 YAML 텍스트(
proxies:로 시작)가 반환되는지 확인 - 구독 링크가 만료되었거나 계정의 트래픽 할당량이 소진되었는지 확인 (트래픽 소진 시 빈 설정을 반환하는 경우가 많음)
업데이트 후에도 노드가 변경되지 않음
- 네트워크 연결을 확인하고 구독 URL에 수동으로 접속하여 변경 사항이 있는지 확인
- Clash의 설정 캐시 삭제 (클라이언트마다 위치가 다름. 일반적으로 설정 → 캐시 삭제)
- 설정 파일의
interval설정이 적절한지 확인 — 설정된 시간이 경과하지 않으면 자동 업데이트가 실행되지 않음
구독 형식 변환
서비스 제공업체가 V2Ray 또는 SS 형식의 구독만 제공하는 경우, Subscription Converter를 사용하여 Clash 형식으로 변환할 수 있습니다:
- subconverter 자체 호스팅 (권장 — 개인정보 보호)
- 공개 변환 서비스 사용 (개인정보 위험이 있으므로 운영 환경에서는 비권장)
요약
- 구독 URL에는 모든 노드 정보가 포함되며, 최신 상태를 유지하기 위해 정기적으로 갱신 필요
- 플랫폼별 가져오기 방법: Clash Verge Rev(프로필 → URL에서 가져오기), CMFA(+ → URL), Stash(설정 → URL에서 다운로드)
- 24시간마다 자동 업데이트를 설정하고 "시작 시 업데이트" 옵션 활성화 권장
proxy-providers는 YAML 내 다중 구독 통합 및 지역별 노드 필터링 지원 — 고급 사용자에게 적합- 업데이트 실패 시 네트워크 연결 상태와 구독 형식이 올바른지 먼저 확인
더 읽어보기
- 규칙 기반 라우팅 설정: 커스텀 분기 규칙으로 구독을 최대한 활용
- TUN 모드 사용 가이드: 전역 프록시로 모든 앱을 노드를 통해 연결
- Clash 완전 설치 및 설정 튜토리얼: 처음부터 완전한 가이드