구독 형식을 확인한 뒤 링크 가져오기
서비스 제공업체 페이지에서 ‘Clash’, ‘Clash Meta’ 또는 ‘mihomo’라고 표시된 구독 URL을 우선 복사한 다음, 클라이언트의 ‘프로필’ 페이지에서 가져오세요. 다운로드, 프로필 활성화, 트래픽 전달은 각각 별개의 단계입니다. 목록에 프로필 카드가 표시된다는 것은 클라이언트에 프로필이 저장되었다는 뜻일 뿐, 브라우저가 프록시를 통해 접속 중이라는 의미는 아닙니다.
구독 URL은 일반적으로 설정 내용을 반환하는 HTTPS 링크입니다. 서비스 제공업체의 로그인 페이지나 QR 코드가 있는 웹페이지 주소와는 다릅니다. URL에 액세스 인증 정보가 포함될 수 있으니, 페이지의 ‘구독 링크 복사’ 버튼을 사용하세요. 브라우저 주소창에서 계정 페이지 URL을 복사하지 마세요.
가져오기 전에 확인할 세 가지
- 클라이언트 커널: mihomo를 사용하는 클라이언트는 더 많은 프로토콜과 설정 필드를 지원할 수 있습니다. 구형 Clash 커널은 최신 프로토콜을 인식하지 못할 수 있습니다. 가져오기에 성공했더라도 커널이 구독의 모든 항목을 해석할 수 있다는 뜻은 아닙니다.
- 서비스 상태: 계정이 만료되지 않았는지, 트래픽을 모두 사용하지 않았는지, 구독 URL이 재설정되지 않았는지 확인하세요. 먼저 서비스 제공업체 계정 페이지에서 확인하고, 로컬 포트를 계속 변경하지 마세요.
- URL 전체 여부: 원래의
https://, 경로, 쿼리 매개변수를 그대로 유지하세요. 불필요해 보이는 문자를 임의로 지우거나 줄바꿈과 따옴표를 함께 붙여 넣지 마세요.
구독 링크 가져오기: 프로필 추가부터 활성화까지
버튼 위치는 클라이언트마다 다릅니다. 데스크톱에서는 보통 ‘프로필’ → ‘새로 만들기’ 또는 ‘가져오기’를 선택합니다. Clash for Android에서는 ‘프로필’ → ‘＋’ → ‘URL에서 가져오기’가 흔합니다. 아래에서는 작업의 의미를 기준으로 설명하며, 특정 클라이언트 메뉴 이름이 모든 클라이언트에서 동일하다고 가정하지 않습니다.
- 전용 링크 복사. 서비스 제공업체 페이지에서 커널에 맞는 Clash 또는 mihomo 형식을 선택하세요. ‘범용 구독’과 ‘Clash 구독’이 모두 있다면 후자를 먼저 선택하세요.
- 원격 프로필 추가. 클라이언트의 ‘프로필’ 페이지를 열고 URL 가져오기를 선택하세요. ‘로컬/원격’ 유형을 고르는 옵션이 있다면 ‘원격’을 선택합니다. ‘로컬’은 보통 기기에 저장된 파일을 불러올 때 사용합니다.
- 이름과 URL 입력. 이름은 ‘일반 구독’처럼 알아보기 쉽게 지정하고, URL 입력란에는 전체 구독 URL만 넣으세요. 업데이트 간격은 화면에 표시된 단위에 맞춰 설정하세요. 분 단위 입력란에 시간을 그대로 입력하면 안 됩니다.
- 저장하고 다운로드 대기. ‘저장’, ‘가져오기’ 또는 ‘다운로드’를 누르세요. 오류 메시지, 업데이트 시간, 프로필 항목이 표시되는지 확인합니다. 실패하면 처음 표시된 오류 문구를 기록하세요. 연이어 다시 시도하면 최초 오류를 파악하기 어려울 수 있습니다.
- 프로필 활성화. 프로필 목록에서 방금 가져온 항목을 선택하세요. 선택 표시가 바뀌었는지, 설정 파싱 오류가 없는지 확인합니다. 일부 클라이언트는 자동으로 적용하지만, 별도로 ‘활성화’를 눌러야 하는 경우도 있습니다.
- 프록시 그룹의 출구 노드 선택. ‘프록시’ 페이지를 열고 직접 선택해야 하는 정책 그룹에서 노드를 고르거나, 구독에 포함된 자동 선택 그룹을 선택하세요. 노드 목록만 확인하고 끝내지 마세요.
- 프록시가 필요한 트래픽 전달. 데스크톱에서는 먼저 ‘시스템 프록시’를 켜 브라우저로 확인할 수 있습니다. Android에서는 보통 연결을 시작한 뒤 시스템 VPN 권한을 승인해야 합니다. TUN 모드는 구독을 가져오기 위한 필수 조건이 아닙니다.
QR 코드만 제공된다면 QR 코드에 구독 URL이 들어 있는지, 단일 노드 URI가 들어 있는지 먼저 확인하세요. ss:// QR 코드는 보통 단일 노드 정보를 담고 있으며, 규칙이나 정책 그룹, 원격 업데이트 URL까지 포함하지는 않습니다. QR 코드 스캔에 성공해도 전체 구독을 가져온 것은 아닙니다.
YAML과 Base64: 설정 구조와 인코딩 방식의 차이
YAML은 설정을 표현하는 형식이고 Base64는 인코딩 방식이므로 서로 다른 계층에 속합니다. 흔히 ‘Base64 구독’이라고 부르는 것은 여러 노드 URI를 이어 붙인 뒤 인코딩한 경우가 많지만, 다른 텍스트를 인코딩한 것일 수도 있습니다. 다운로드 파일 이름만으로 판단하지 말고 디코딩한 내용을 확인해야 합니다.
| 응답 내용 | 주요 특징 | 가져오기 참고 사항 |
|---|---|---|
| 전체 Clash YAML 설정 | proxies, proxy-groups, rules를 포함할 수 있습니다 |
프로필 페이지에서 가져오기에 적합하지만, 프로토콜과 커널의 호환성은 확인해야 합니다. |
| Base64 노드 구독 | 원문은 긴 인코딩 문자열이며, 디코딩하면 여러 줄의 노드 URI가 나오는 경우가 많습니다 | 클라이언트가 변환을 명시적으로 지원해야 바로 사용할 수 있습니다. 디코딩만으로 규칙이 생성되지는 않습니다. |
| 일반 텍스트 노드 URI 목록 | 각 줄은 ss://, vmess:// 등으로 시작할 수 있습니다 |
노드 정보일 뿐 전체 Clash 설정은 아니므로, 클라이언트에서 가져오기 또는 변환을 지원해야 합니다. |
| 프록시 목록 YAML | 일반적으로 proxies 노드 목록만 포함합니다 |
proxy-providers에서 사용할 수 있지만, 정책 그룹과 규칙을 포함한 전체 설정으로 간주하면 안 됩니다. |
전체 설정은 대략 이런 형태입니다
아래 예시는 YAML의 계층 구조와 키 이름만 보여 줍니다. 원격 노드가 없어 정책 그룹에서 직접 연결만 선택할 수 있으므로, 프록시 연결 테스트에는 사용할 수 없습니다. 실제 구독은 proxy-providers로 노드를 불러올 수도 있으므로, 설정에 proxies 항목이 없다고 해서 반드시 손상된 것은 아닙니다.
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 프록시 연결을 모두 받는다는 뜻이며, 서비스 제공업체 노드의 포트가 아닙니다. 여기서는 rules의 마지막 항목이 요청을 ‘출구 선택’으로 보내지만, 해당 그룹에는 DIRECT만 있으므로 최종적으로 직접 연결됩니다. YAML 들여쓰기에는 공백을 사용하고 Tab은 쓰지 마세요. 계층이 잘못되면 네트워크에 연결하기도 전에 파일 파싱이 실패할 수 있습니다.
Base64로 디코딩했는데도 사용할 수 없는 이유
디코딩은 텍스트를 원래 형태로 되돌릴 뿐 proxy-groups, DNS 또는 분할 라우팅 규칙을 채워 주지는 않습니다. 디코딩 결과가 유효한 노드 URI여도 클라이언트 커널이 해당 프로토콜을 지원해야 합니다. 가장 간단한 방법은 서비스 제공업체 페이지에서 사용하려는 클라이언트 전용 구독을 받는 것입니다. 변환이 꼭 필요하다면 클라이언트에 내장된 기능이나 신뢰할 수 있는 로컬 도구를 우선 사용하고, 변환 후 정책 그룹과 규칙을 확인하세요.
가져오기 실패: 다운로드·파싱·연결 단계별 점검
먼저 오류가 어느 단계에서 발생했는지 확인하세요. 설정을 아직 다운로드하지 못했다면 rules를 수정해도 소용없습니다. 파싱은 성공했지만 웹사이트가 열리지 않는다면 같은 구독 URL을 반복해서 복사해도 대개 해결되지 않습니다.
1단계: 구독 요청에서 올바른 내용을 받지 못함
401 Unauthorized: 인증이 필요하거나 토큰이 유효하지 않은 경우가 많습니다. 계정 페이지에서 생성한 전체 URL을 다시 복사하고, 구독이 재설정되었는지 확인하세요.403 Forbidden: 액세스 정책, 계정 제한 또는 요청 차단이 원인일 수 있습니다. 서비스 제공업체의 안내를 확인하세요. 로컬 수신 포트만 바꿔서는 해결할 수 없습니다.404 Not Found: 복사 과정에서 URL이 잘리지 않았는지, 경로가 더 이상 유효하지 않은지, 웹페이지 링크를 복사한 것은 아닌지 먼저 확인하세요.no such host: 구독 도메인 이름을 확인할 수 없습니다. 도메인 철자를 확인한 뒤 현재 네트워크의 DNS를 점검하세요. 이는 아직 노드 연결 실패가 아닙니다.i/o timeout: 로그에서 시간이 초과된 대상이 무엇인지 확인하세요. 대상이 구독 서버라면 구독 다운로드 경로부터 해결해야 합니다. 아직 다운로드하지 못한 노드를 바꾸려 해서는 안 됩니다.
브라우저에서는 링크가 열리는데 클라이언트에서는 열리지 않는다고 해서 링크에 문제가 없다는 뜻은 아닙니다. 브라우저가 로그인 쿠키, 다른 프록시 또는 다른 요청 식별 정보를 사용했을 수 있습니다. 일부 서비스는 요청에 따라 다른 형식을 반환하므로, 서비스에서 명시적으로 제공하는 Clash 전용 링크를 우선 사용하세요. 응답 내용을 확인할 때는 로컬에서만 살펴보고 전체 설정을 공개하지 마세요.
2단계: 내용은 다운로드했지만 파싱할 수 없음
응답 첫 부분이 <!DOCTYPE html> 또는 <html>이라면 YAML이 아닌 웹페이지를 받은 것입니다. 로그인 페이지나 인증 페이지일 수 있습니다. yaml: line과 같은 오류가 표시되면 안내된 줄 번호에서 들여쓰기, 콜론, 따옴표를 확인하고 응답에 웹페이지 내용이 섞이지 않았는지도 살펴보세요. 로그에 지원되지 않는 프록시 유형이 표시되면 커널의 지원 범위를 확인하고, 호환되는 형식을 사용하거나 커널을 업데이트하세요. 필드를 임의로 삭제해 억지로 통과시키면 안 됩니다.
3단계: 설정은 활성화됐지만 트래픽이 연결되지 않음
먼저 ‘프록시’ 페이지에서 현재 그룹이 DIRECT 또는 REJECT를 선택하지 않았는지 확인한 다음, ‘연결’이나 ‘로그’에서 실제로 적용된 규칙과 출구를 살펴보세요. 시스템 프록시는 시스템 프록시 설정을 따르는 프로그램에만 영향을 줍니다. 게임, 명령줄 도구, 자체 네트워크 스택을 사용하는 앱은 별도로 프록시를 설정하거나 라우팅에 미치는 영향을 파악한 뒤 TUN을 사용해야 할 수 있습니다. ‘가져오기 성공’과 ‘모든 앱의 트래픽이 프록시를 통과함’을 같은 의미로 보면 안 됩니다.
구독 업데이트 후 새 설정이 적용됐는지 확인하기
원격 프로필은 보통 구독 출처를 유지하므로 수동 또는 예약 업데이트가 가능합니다. 로컬 파일로 가져오면 대개 그 시점의 사본만 저장됩니다. 업데이트가 적용됐는지 확인하려면 현재 프로필 카드에서 ‘업데이트’를 실행하고 업데이트 시간이 바뀌었는지 확인한 뒤 노드 목록을 살펴보세요. 다른 이전 프로필을 계속 사용 중이라면 다운로드에 성공해도 현재 연결 출구는 바뀌지 않습니다.
- 활성 프로필 확인: 목록의 정렬 순서만 보지 말고 선택 표시를 확인하세요.
- 변경 사항 확인: 서비스 제공업체가 실제로 추가하거나 삭제한 노드와 정책 그룹 이름을 살펴보세요. 변경 사항이 없더라도 상위 서버가 이전과 같은 내용을 반환했을 수 있습니다.
- 앱 로그 확인: 업데이트 후 파싱 또는 다시 불러오기에 실패했다는 메시지가 있는지 살펴보세요. 일부 클라이언트는 이전에 정상 작동하던 설정을 계속 사용할 수 있습니다.
- 새 연결 테스트: 페이지를 새로 열거나 새 요청을 보내세요. 이미 연결된 장시간 연결은 이전 출구를 계속 사용할 수 있어 전환 결과를 확인하는 데 적합하지 않습니다.
자주 묻는 질문: 파일 가져오기, 포트, 중복 구독
.yaml 파일로 다운로드하면 구독 링크를 대신할 수 있나요?
로컬 설정으로 가져올 수는 있지만, 일반적으로 원래 구독 URL이나 업데이트 기능은 유지되지 않습니다. 임시 점검이나 오프라인 이전에 적합합니다. 서비스 제공업체의 변경 사항을 계속 받으려면 원격 URL로 가져오세요. 파일 확장자만으로 내용이 올바른지 알 수는 없습니다. config.yaml이라는 파일에도 오류 페이지가 저장되어 있을 수 있습니다.
가져오기에 성공한 뒤 포트를 반드시 7890으로 바꿔야 하나요?
그럴 필요 없습니다. 7890은 흔히 쓰이는 예시 값일 뿐이므로 클라이언트에 현재 표시된 수신 포트를 기준으로 하세요. 앱에 127.0.0.1:7890을 직접 입력했는데 클라이언트가 실제로 7897에서 수신 중이라면 두 값이 일치하지 않습니다. address already in use 오류가 발생하면 프록시 클라이언트 두 개가 동시에 실행 중인지 확인하세요. 안내서와 맞추려고 포트를 무작정 덮어쓰지 마세요. 자세한 설정은 로컬 포트 설정 안내를 참조하세요.
같은 링크를 여러 번 가져오면 네트워크가 더 빨라지나요?
아니요. 같은 링크를 반복해서 가져오면 보통 프로필 항목만 늘어납니다. 실제 사용 중인 프로필은 활성 프로필에 따라 결정됩니다. 업데이트 가능한 원격 프로필 하나와 필요한 백업만 유지하면 충분합니다. 구독에 노드가 여러 개 있다면 같은 구독을 계속 새로 추가하지 말고 정책 그룹에서 노드를 선택하거나 자동 선택 그룹을 사용하세요.
마지막으로 다음 순서대로 확인하세요. 전용 구독 형식이 올바른지, 다운로드 응답이 유효한지, 설정을 파싱해 활성화했는지, 프록시 그룹의 출구가 올바른지, 대상 앱의 트래픽이 프록시를 통과하는지 점검합니다. 이후 시간 초과가 발생하면 시간 초과 문제 진단에서 계속 확인하세요. 처음 설정하는 경우 구독 가져오기 안내를 따라 항목별로 점검할 수 있습니다.