Clash 구독 URL 가져오기 및 주요 구독 형식 안내

구독을 가져오기 전에 링크, 형식, 코어 확인하기

Clash 구독 URL은 원격 설정을 가져오는 주소이며, 프록시 노드 하나를 가리키는 링크가 아닙니다. 클라이언트가 해당 주소에 요청을 보내고 응답을 설정 프로필로 저장한 뒤, 최종 설정을 코어에서 실행합니다. 가져오기에 성공했다는 것은 설정을 받아 파싱했다는 뜻일 뿐입니다. 사용 가능한 노드가 있는지, 규칙이 올바른 정책 그룹을 가리키는지는 별도로 확인해야 합니다.

Clash Nyanpasu는 데스크톱 설정 관리 클라이언트이며, 지원 프로토콜은 선택한 코어와 버전에 따라 달라집니다. Clash Meta의 후속 프로젝트 이름은 mihomo입니다. mihomo용 설정에는 구버전 Clash가 인식하지 못하는 항목이 포함될 수 있습니다. 구독 서비스에서 여러 형식을 제공한다면 일반 노드 목록을 복사하지 말고 현재 사용하는 코어에 맞는 Clash 또는 mihomo 형식을 선택하세요.

• 주소 확인: 구독 서비스 계정 페이지에서 HTTPS 링크 전체를 복사하세요. 브라우저의 계정 관리 페이지 주소를 복사하면 안 됩니다.
• 출력 형식: Clash YAML, Clash Meta 또는 mihomo로 표시된 형식인지 확인하고 서비스 제공업체의 형식 안내도 살펴보세요.
• 접근 정보: 쿼리 매개변수를 그대로 유지하세요. 링크의 토큰은 보통 인증에 사용되므로 매개변수를 일부 삭제하면 요청이 거부될 수 있습니다.
• 현재 설정: 가져오기 전 설정 이름과 사용 중인 정책 그룹을 기록해 두세요. 문제가 생겼을 때 되돌릴 기준이 됩니다.

Clash Nyanpasu에서 구독 URL 가져오기

아래 안내는 ‘원격 설정’ 절차를 기준으로 합니다. 버전에 따라 버튼 이름이 ‘새로 만들기’, ‘가져오기’이거나 더하기 아이콘으로 표시될 수 있지만 기본 절차는 같습니다. 프로필 관리 페이지에서 원격 항목을 만들고 URL을 입력한 다음, 다운로드가 끝나면 해당 프로필을 선택하세요. 구독 링크를 시스템 프록시 주소나 외부 컨트롤러 주소에 입력하면 안 됩니다.

1. 설정 페이지 열기. 클라이언트 사이드바에서 ‘프로필’ 페이지로 이동해 새 항목 또는 가져오기 메뉴를 찾으세요. ‘로컬’과 ‘원격’ 유형이 함께 표시되면 원격 설정을 선택합니다.
2. 구분하기 쉬운 이름 입력. 예: ‘일상 구독-주 회선’. 이름은 로컬에서 항목을 관리할 때만 사용되며, 서버가 반환하는 노드 내용에는 영향을 주지 않습니다.
3. URL 전체 붙여넣기. 주소가 https://로 시작하는지, 끝에 공백이나 줄바꿈, 한글 따옴표가 붙지 않았는지 확인하세요. 링크의 &와 =는 쿼리 매개변수를 구분하는 문자이므로 직접 삭제하지 마세요.
4. 가져오기를 실행하고 결과 확인. 다운로드 실패, 인증 실패 또는 YAML 파싱 오류가 표시되는지 살펴보세요. 오류가 나더라도 기존 설정은 유지하고, 같은 항목을 연달아 여러 개 만들지 마세요.
5. 새 설정 선택. 프로필 목록에서 새 항목을 현재 설정으로 지정하세요. 원격 항목을 저장하는 것만으로는 현재 실행 중인 설정이 바뀌지 않을 수 있습니다.
6. 프록시와 규칙 확인. 프록시 페이지에서 노드나 정책 그룹이 표시되는지 확인한 다음, 로그에서 코어가 누락된 정책 그룹이나 알 수 없는 프록시 유형 등의 오류를 보고하지 않는지 살펴보세요.

가져온 뒤 최소한의 연결 테스트부터 진행

먼저 규칙 모드를 유지한 채 실제 프록시 노드 하나를 선택하고, 확인하려는 사이트에 접속한 다음 연결 기록에서 적용된 규칙과 아웃바운드 경로를 확인하세요. 노드 지연 시간 테스트에 성공해도 테스트 주소에 연결할 수 있다는 뜻일 뿐, 모든 사이트에 접속할 수 있다는 의미는 아닙니다. 설정에 DIRECT만 있다면 선택할 프록시 노드가 없는 상태입니다. ‘설정이 활성화됨’을 프록시 사용 가능의 근거로 삼지 마세요.

시스템 프록시와 TUN은 트래픽을 연결하는 방식이지 구독을 노드로 변환하는 기능이 아닙니다. 처음 문제를 확인할 때는 DNS, TUN, 라우팅을 동시에 변경하지 않도록 시스템 프록시부터 사용해 보세요. 브라우저에서 프록시를 사용할 수 있는지는 브라우저의 프록시 설정에도 달려 있습니다. 시스템 프록시를 따르지 않는 프로그램은 별도 설정이나 적절한 연결 방식이 필요합니다.

Clash YAML, Base64, 단일 노드 링크의 차이

파일 확장자나 링크 모양만으로 구독 형식을 판단할 수는 없습니다. URL에 .yaml 확장자가 없어도 Clash 설정을 반환할 수 있고, 주소가 .yaml로 끝나더라도 로그인 페이지가 반환될 수 있습니다. 서버가 실제로 반환한 본문과 해당 내용이 대상 코어의 설정 구조에 맞는지를 확인해야 합니다.

YAML 파싱에 성공해도 설정이 실행된다는 뜻은 아닙니다

YAML은 데이터를 표현하는 형식입니다. 콜론과 들여쓰기가 있다는 이유만으로 내용을 사용할 수 있다고 판단하면 안 됩니다. 아래는 계층 구조를 보여 주기 위한 최소 설정 예시입니다. 수신 대기 포트는 7890이며, 정책 그룹에는 직접 연결만 포함되어 있어 프록시 기능은 제공하지 않습니다. 실제 구독을 사용하려면 노드 정의가 있거나 프록시 제공자가 노드를 불러와야 합니다.

mixed-port: 7890
mode: rule
log-level: info

proxies: []

proxy-groups:
  - name: 수동 선택
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,수동 선택

proxy-groups의 구성원은 정의된 노드, 유효한 다른 정책 그룹 또는 내장 아웃바운드로 해석될 수 있어야 합니다. 위 예시의 MATCH,수동 선택은 정책 그룹 이름을 참조하므로 이름이 정확히 일치해야 합니다. 프록시 제공자를 사용하는 경우 그룹의 use가 실제로 존재하는 제공자 이름을 참조하는지도 확인하세요. 전체 항목 설명은 YAML 설정 가이드를 참고하세요.

Base64 디코딩은 설정 변환이 아닙니다

Base64는 인코딩 방식일 뿐 규칙, 정책 그룹 또는 DNS 설정을 제공하지 않으며 암호화도 아닙니다. 디코딩한 결과가 여러 노드 URI일 수도 있습니다. 실제 변환에는 프로토콜 매개변수 파싱, 대상 코어 필드에 맞춘 매핑, 정책 그룹 생성, 규칙 추가가 필요합니다. 원본 파일 이름을 config.yaml로 바꾸는 것만으로는 이 작업을 대신할 수 없습니다.

구독 변환: 먼저 기본 제공 형식을 선택하고, 변환 도구는 그다음에 검토

서버에서 Clash 또는 mihomo 형식을 제공한다면 해당 형식을 우선 사용하세요. 필드 매핑이나 템플릿 차이로 인한 문제를 줄일 수 있습니다. 범용 노드 구독만 있고 현재 클라이언트에서 설정으로 바로 사용할 수 없는 경우에만 변환을 고려하세요.

1. 원본 형식 확인. 완전한 설정, 노드 목록, 제공자 파일을 구분하세요. 노드 목록에는 라우팅 규칙이 없으므로 변환 후에도 기존 분기 정책이 유지된다고 가정하면 안 됩니다.
2. 대상 코어 선택. 대상 형식으로 mihomo를 지정했다면 실제 실행 중인 코어도 호환되는지 확인하세요. 변환기로 구형 코어에 새 프로토콜 지원을 추가할 수는 없습니다.
3. 관리 가능한 변환 방식 선택. 로컬에서 실행하거나 직접 관리하는 변환 서비스를 우선 고려하세요. 원격 변환 서비스는 원본 구독 주소와 반환되는 노드 인증 정보를 확인할 수 있습니다.
4. 변환 결과 확인. 노드 수, 프로토콜 유형, TLS 매개변수, 정책 그룹 이름과 마지막 MATCH 규칙을 확인한 다음 별도의 테스트 설정으로 가져오세요.

업데이트 주기와 직접 수정: 두 가지 구독 방식 구분하기

원격 설정 업데이트와 프록시 제공자 업데이트는 서로 다른 기능입니다. 전자는 클라이언트가 설정 전체를 다시 다운로드하고, 후자는 코어가 proxy-providers 설정에 따라 노드 파일을 새로고침합니다. 두 기능은 서로 다른 URL을 사용할 수 있으며 업데이트 주기도 같을 필요가 없습니다.

클라이언트 원격 설정 업데이트

‘프로필’ 페이지에서 대상 항목의 편집 메뉴를 열고 업데이트 주기 또는 자동 업데이트 옵션을 찾으세요. 버전에 따라 입력 단위가 분으로 표시되거나 다른 방식으로 표시될 수 있으니 항목 옆의 단위를 확인해야 합니다. 예를 들어 단위가 분이면 360은 6시간을 뜻하고, 초 단위라면 6시간은 21600입니다. 단위를 확인하지 않고 숫자만 그대로 입력하지 마세요.

변경이 잦지 않은 구독은 우선 6시간 간격으로 업데이트하면 됩니다. 노드가 일시적으로 작동하지 않거나 서비스 제공업체의 변경 안내가 있을 때는 수동으로 새로고침하세요. 서비스 제공업체가 요청 빈도를 제한한다면 해당 기준을 따라야 합니다. 클라이언트가 종료되거나 기기가 절전 상태이거나 네트워크에 연결되지 않은 동안에도 자동 업데이트가 정해진 시간에 반드시 실행되는 것은 아닙니다.

코어의 프록시 제공자 업데이트

mihomo 설정에서 HTTP 유형 프록시 제공자의 interval 단위는 초입니다. 아래 예시는 제공자 파일을 3600초마다 새로고침하도록 지정하며, URL은 형식 설명용 주소이므로 실제 구독에 사용할 수 없습니다. 이 항목은 전체 설정에 포함해야 하며 정책 그룹에서 use로 참조해야 합니다.

proxy-providers:
  remote-nodes:
    type: http
    url: "https://example.net/clash-provider.yaml"
    path: ./providers/remote-nodes.yaml
    interval: 3600

다운로드한 원격 설정 파일의 규칙을 직접 수정하면 다음 업데이트 때 변경 내용이 덮어써질 수 있습니다. 개인 규칙, 포트 또는 DNS 설정을 유지하려면 현재 버전에서 지원하는 오버라이드나 병합 기능을 사용하고 최종 생성 설정을 확인하세요. 로컬에서 수정한 내용이 구독 서비스에 반영된다고 가정하지 말고, 원본 구독과 개인 설정을 복구하기 어려운 파일 하나로 합치지 마세요.

구독 가져오기 실패 시 점검 순서

‘요청 성공 여부 → 응답 형식의 정확성 → 코어 호환성 → 트래픽 연결’ 순서로 단계별 확인하세요. 한 번에 하나씩만 변경하고 오류가 다운로드 단계에서 발생했는지 코어 시작 단계에서 발생했는지 기록하세요. 두 오류의 해결 방법은 서로 다릅니다.

브라우저에서는 링크가 열리는데 클라이언트에서는 왜 실패할까요?

브라우저와 클라이언트가 같은 경로를 사용하는 것은 아닙니다. 브라우저는 로그인 쿠키를 포함하거나 기존 프록시를 통해 접속할 수 있지만, 클라이언트의 구독 다운로드 요청은 직접 연결되거나 다른 요청 헤더를 사용할 수 있습니다. 일부 서비스는 User-Agent에 따라 서로 다른 형식을 반환하기도 합니다. 따라서 브라우저에 내용이 표시되어도 클라이언트가 같은 YAML을 받았다고 볼 수는 없습니다.

구독 도메인 접속에 프록시가 필요하다면 먼저 사용 가능한 설정을 하나 보관한 다음 현재 버전에 구독 업데이트용 프록시 옵션이 있는지 확인하세요. 새 구독을 다운로드하려고 유일하게 사용할 수 있는 기존 설정을 먼저 삭제하지 마세요. 로그를 공유하기 전에는 전체 URL을 가리세요. 특히 요청 경로와 쿼리 매개변수의 접근 정보를 주의해야 합니다.

가져오기 완료 후 확인 목록

• 현재 사용하는 설정 이름이 올바르고 마지막 업데이트 결과를 확인할 수 있습니다.
• 노드와 정책 그룹이 로드되었으며 규칙에서 참조하는 이름이 누락되지 않았습니다.
• 업데이트 주기의 값과 단위가 일치하며 분을 초로 착각하지 않았습니다.
• 연결 기록에 예상한 규칙과 아웃바운드가 표시되고 앱 트래픽이 실제로 코어에 전달됩니다.
• 개인 설정은 유지 가능한 오버라이드 방식으로 저장하고 기존 설정은 복구용으로 보존했습니다.

구독을 가져올 때 핵심은 ‘링크 응답, 설정 구조, 실행 코어’가 서로 맞는지 확인하는 것입니다. 먼저 형식과 인증 문제를 해결한 다음 규칙과 트래픽 연결을 점검하면 네트워크 문제를 YAML 문제로 오해하지 않을 수 있습니다. 처음 사용하는 경우 빠른 시작 가이드를 따라 시스템 프록시와 기본 연결을 확인하세요. Profile, 정책 그룹 등의 용어는 용어집에서 확인할 수 있습니다.