이 글은 이미 본인 서비스 제공업체의 구독을 보유한 Shadowrocket 사용자를 위한 안내입니다. 먼저 요청이 완료되지 않은 경우, 응답을 파싱할 수 없는 경우, 응답 목록이 실제로 비어 있는 경우를 구분하세요. 그런 다음 링크, 계정 상태, 업데이트에 사용한 네트워크를 확인합니다. 한 번에 한 가지 조건만 바꾸고 기존에 사용할 수 있는 항목은 유지하세요. 원인을 파악하기 전에 모든 설정을 삭제하지 않는 것이 좋습니다.
구독 업데이트와 노드 연결은 별개
구독 링크는 서버 목록을 가져오는 데 사용하고, 목록에 있는 노드는 프록시 연결을 설정하는 데 사용합니다. 두 작업은 서로 다른 네트워크 요청입니다. 노드 연결이 일시적으로 되지 않는다고 해서 구독 링크까지 만료된 것은 아닙니다. 구독 업데이트에 실패해도 기존 노드를 계속 사용할 수 있는 경우가 있습니다. 문제 해결을 시작하기 전에 어느 단계에서 오류가 발생하는지 확인하세요.
Home(홈)에서 구독 그룹이 표시되는지, 펼쳐져 있는지 확인하세요. 그룹은 있지만 접혀 있어 항목이 보이지 않는다면 먼저 펼친 후 확인합니다. 업데이트가 끝난 뒤에도 항목이 없다면 표시된 메시지를 기록하세요. 항목은 있지만 연결 시간이 초과된다면 노드 설정과 네트워크를 별도로 확인해야 합니다. 두 문제를 혼동하지 마세요.
HTTPS 기본 포트와 노드 포트는 서로 다릅니다. 구독 링크에 다른 포트가 명시되어 있다면 서비스 제공업체가 안내한 값을 그대로 사용하세요. 노드가 특정 포트를 사용한다고 해서 구독 주소의 포트까지 같은 숫자로 바꾸면 안 됩니다.
1단계: 링크 유형과 복사 상태 확인
구독 입력란에는 서비스 제공업체가 발급한 구독 주소를 입력해야 합니다. 계정 로그인 페이지, 요금제 페이지, 웹페이지의 안내 문구는 해당하지 않습니다. 브라우저에서 열리는 웹페이지라고 해서 구독으로 파싱할 수 있는 것은 아닙니다. 본인 서비스 제공업체 계정에서 Shadowrocket용으로 명확히 표시된 구독 링크를 복사하세요.
-
원본 링크 복사
본인 서비스 제공업체 계정에서 구독 주소를 다시 복사하세요. 채팅 화면을 캡처한 이미지에서 문자를 인식해 복사하거나, ‘가져오기를 누르세요’ 같은 안내 문구까지 포함한 텍스트를 복사하지 마세요.
-
링크 앞뒤 문자 확인
링크의 프로토콜 부분이 온전히 시작되는지, 끝에 마침표·따옴표·줄바꿈이 붙지 않았는지 확인하세요. 링크 중간에 공백이 들어가서도 안 됩니다. 긴 링크가 화면에서 자동으로 줄바꿈되어 보이는 것은 실제 줄바꿈 문자가 들어간 것과 다릅니다.
-
구독 유형으로 추가
Home(홈) → 오른쪽 위 ‘+’ → Type(유형) → Subscribe(구독)로 이동한 다음 URL(링크) 필드에 주소를 붙여 넣고 저장하세요. 구독 주소 전체를 개별 노드 프로토콜의 서버 필드에 입력하지 마세요.
-
업데이트 후 결과 기록
Home(홈)으로 돌아가 아래로 당겨 새로고침하고, 업데이트가 끝날 때까지 기다린 뒤 표시된 메시지와 항목 수를 기록하세요. 같은 구독을 연달아 여러 번 추가하면 어느 그룹을 확인 중인지 판단하기 어려워질 수 있습니다.
아래 값은 구조를 설명하기 위한 예시일 뿐 실제로 사용할 수 있는 구독 링크가 아닙니다. 실제 링크에는 다른 경로나 매개변수 이름이 사용될 수 있으므로 예시에 맞춰 자신의 주소를 바꾸지 마세요.
https://example.com/sub?token=xxxx
?는 쿼리 매개변수의 시작을 나타내고&는 매개변수를 구분합니다. 복사한 링크에 문자 그대로&가 들어 있다면, 웹페이지에서 이스케이프된 텍스트를 계속 사용하지 말고 원본 링크를 다시 복사하세요.%2F,%2B,%3D등은 올바른 URL 인코딩일 수 있습니다. 일괄 디코딩하지 말고+를 임의로 공백으로 바꾸지도 마세요.- HTTP 주소와 개별 노드 공유 문자열은 구분해야 합니다. Shadowsocks, VMess, VLESS, Trojan 등의 개별 노드 정보는 인코딩된 문자열처럼 보인다는 이유만으로 구독 주소로 입력하면 안 됩니다.
- 구독 토큰으로 계정의 노드 정보를 읽을 수 있습니다. 전체 주소를 신뢰할 수 없는 온라인 변환·검사 페이지에 입력하지 마세요.
2단계: 서비스 제공업체 상태와 실제 응답 확인
링크가 온전해도 가져오기에 실패할 수 있습니다. 서비스 제공업체가 기존 토큰을 취소하거나 계정을 일시 중지했을 수 있고, 구독 API를 변경했거나 계정에 할당할 노드가 없어 빈 목록을 반환했을 수도 있습니다. 이런 경우 Shadowrocket의 프로토콜 설정을 반복해서 바꾸어도 서버 응답은 달라지지 않습니다.
먼저 본인 서비스 제공업체 계정에 로그인해 구독이 유효한지, 사용할 수 있는 노드가 있는지, 링크가 최근 재설정되었는지 확인하세요. 여러 내보내기 형식이 제공된다면 Shadowrocket에 적합하다고 명시된 형식을 선택합니다. 파일 확장자만으로 판단할 수 없으며, 실제 응답 내용에 따라 파싱 가능 여부가 결정됩니다.
| 확인된 결과 | 의미 | 다음 단계 |
|---|---|---|
| 로그인 페이지 또는 인증 코드 페이지가 표시됨 | 노드 목록이 아니라 웹페이지를 가져온 상태 | 구독 전용 주소인지 확인하고, 웹 인증이 필요한 API인지 서비스 제공업체에 문의 |
| HTTP 200이지만 본문이 비어 있음 | 요청 성공이 가져올 항목의 존재를 의미하지는 않음 | 계정에 할당할 수 있는 노드가 있는지, 서비스 제공업체 API가 정상인지 확인 |
| HTTP 200이지만 본문에 오류 안내가 있음 | 서버가 성공 상태 코드와 함께 서비스 오류를 반환함 | 본문 내용을 바탕으로 토큰, 계정 상태, 내보내기 형식을 확인 |
| 일부 항목만 표시되고 나머지는 누락됨 | 누락된 항목의 형식과 매개변수 지원 여부를 점검해야 함 | 해당 항목을 서비스 제공업체에 확인하고 구독 전체가 만료되었다고 단정하지 마세요 |
결론: 응답에 목록이 있는지 먼저 확인
응답이 로그인 페이지, 오류 안내 또는 빈 본문이라면 먼저 구독 API 문제를 해결해야 합니다. 이 단계에서는 노드 프로토콜을 바꾸거나 규칙을 수정하고 노드 포트를 변경해도 누락된 목록을 가져올 수 없습니다.
웹페이지와 구독 응답을 구분해야 할 때만 본인이 신뢰하는 기기에서 응답을 확인하세요. 브라우저에는 방문 기록과 다운로드 기록이 저장될 수 있고, 로그인 쿠키도 앱의 요청과 다를 수 있습니다. 따라서 브라우저에서 열린다는 사실만으로 앱에서도 같은 응답을 받을 수 있다고 판단할 수는 없습니다.
상태 코드로 문제 범위 좁히기
아래는 구독 요청에서 접할 수 있는 표준 HTTP 상태 코드입니다. Shadowrocket의 모든 플랫폼에서 해당 문구가 그대로 표시된다고 보장할 수는 없습니다. 앱에 업데이트 실패만 표시된다면 발생 시각을 본인 서비스 제공업체에 전달해 요청 로그를 확인해 달라고 하세요. 상태 코드는 점검 방향을 제시할 뿐 계정 문제의 유일한 증거는 아닙니다.
HTTP 401 Unauthorized
원인 및 해결 방법: 서버가 요청에 포함된 인증 정보를 받아들이지 않았습니다. 본인 계정에서 현재 유효한 구독 링크를 다시 복사하고, 토큰이 취소되었는지 서비스 제공업체에 확인하세요.
HTTP 403 Forbidden
원인 및 해결 방법: 서버가 요청을 거부했습니다. 계정 권한, 접속 위치 제한 또는 보안 정책이 원인일 수 있습니다. 계정 상태를 확인하고 서비스 제공업체에 거부 사유를 문의하세요. 곧바로 앱의 파싱 문제라고 단정하지 마세요.
HTTP 404 Not Found
원인 및 해결 방법: 요청 경로가 존재하지 않거나 서버가 이 상태 코드로 유효하지 않은 리소스를 숨겼을 수 있습니다. 경로가 빠짐없이 복사되었는지 확인하고 구독 주소가 변경되었는지 서비스 제공업체에 문의하세요.
HTTP 429 Too Many Requests
원인 및 해결 방법: 요청 빈도 제한에 걸렸습니다. 연속해서 새로고침하지 마세요. 응답에 Retry-After(재시도 대기 시간)가 있다면 지정된 시간만큼 기다린 뒤 다시 시도하세요.
HTTP 5xx는 대개 서버 또는 상위 서버의 문제를 나타냅니다. DNS 조회 실패, 연결 시간 초과, TLS 인증서 오류는 HTTP 응답을 받기 전에 발생할 수도 있으므로 위 상태 코드와 구분해야 합니다. 인증서 문제가 발생하면 먼저 기기의 날짜와 시간을 확인한 뒤 서비스 제공업체에 인증서를 확인해 달라고 요청하세요. 오류를 숨기기 위해 인증서 검증을 끄지 마세요.
3단계: 업데이트 시점과 네트워크 경로 확인
구독을 업데이트하려면 기기에서 구독 도메인에 접속할 수 있어야 합니다. 현재 프록시 노드가 작동하지 않고 구독 요청도 해당 프록시 경로를 이용한다면, 노드를 업데이트해야 하지만 업데이트 요청도 완료할 수 없는 상황이 생길 수 있습니다. 반대로 현재 직접 연결 네트워크에서 구독 도메인에 접속할 수 없다면 프록시를 끄는 것만으로 해결되지 않을 수도 있습니다. 한 번에 한 가지 조건만 바꿔 원인을 확인하세요.
-
현재 기록 보존
현재 네트워크, 연결 스위치, Global Routing(전역 라우팅) 상태를 먼저 기록하세요. 본인 노드의 이름과 개수만 기록하고 공개 스크린샷에는 전체 링크가 보이지 않도록 하세요.
-
네트워크 연결 확인
Wi-Fi에 웹 인증이 필요한지, 모바일 데이터가 정상 작동하는지 확인하세요. 기기가 Wi-Fi에 연결되어 있다고 해서 인터넷에 접속할 수 있는 것은 아닙니다.
-
자동 연결 설정 확인
Settings(설정) → On Demand(요청 시 연결)로 이동해 관련 설정을 기록한 다음, 테스트하는 동안 임시로 끄세요. 현재 프록시 연결을 해제하고 업데이트를 한 번 테스트해 자동 재연결이 테스트 결과에 영향을 주지 않도록 합니다.
-
다른 네트워크로 테스트
가능하다면 Wi-Fi만 모바일 데이터로 바꾸고 구독 링크는 그대로 둔 채 다시 업데이트하세요. 특정 네트워크에서만 실패한다면 해당 네트워크의 DNS, 인증 또는 접속 제한을 우선 점검하세요.
-
기존 설정 복원
결과를 기록한 뒤 필요한 On Demand(요청 시 연결) 설정과 라우팅 상태를 복원하세요. 본인이 이미 보유한 프록시 경로로만 구독 도메인에 접속할 수 있다면 이 상황을 서비스 제공업체에 설명하세요.
Global Routing(전역 라우팅)의 Config(구성), Proxy(프록시), Direct(직접 연결), Scene(장면)은 트래픽 라우팅 방식을 선택하는 항목이지 구독 형식을 변환하는 기능이 아닙니다. 앱의 업데이트 요청이 실제로 거치는 경로는 관련 설정의 영향을 받을 수 있으므로 표시된 모드 이름만 보고 요청이 어느 경로를 이용한다고 단정하지 마세요.
- 목록이 비어 있는 문제를 해결하려고 Config(구성)의
DOMAIN-SUFFIX(도메인 접미사),GEOIP(지리 IP),IP-CIDR(IP 대역) 또는FINAL(최종 일치) 규칙을 무작정 변경하지 마세요. - 네트워크를 바꿨다면 현재 업데이트가 끝날 때까지 기다린 후 다음 업데이트를 시작하세요. 짧은 시간 동안 연속으로 새로고침하면 요청 제한이 걸릴 수 있고, 오류 기록을 대조하기도 어려워집니다.
- 기기가 절전 모드이거나 백그라운드 제한 또는 일시적인 네트워크 단절이 발생하면 자동 업데이트가 완료되지 않을 수 있습니다. 밤새 시간이 지났다는 사실을 업데이트 성공의 증거로 삼지 말고 Home(홈)으로 돌아가 직접 업데이트한 결과를 확인하세요.
업데이트 후에도 목록이 비어 있다면: 기록을 보존한 뒤 대응
새로 복사한 링크를 두 종류의 네트워크에서 모두 사용해도 항목을 가져오지 못한다면, 앱을 반복해서 삭제하기보다 본인 서비스 제공업체에 API와 계정을 확인해야 합니다. 그룹을 삭제하거나 앱을 재설치하면 기존 기록을 복구하는 수고만 늘어날 뿐, 서버의 빈 응답이나 만료된 토큰, 접속 제한은 해결되지 않습니다.
업데이트가 성공해 노드가 표시된 뒤 연결에 실패했다면 구독 가져오기는 이미 완료된 것입니다. 해당 노드의 주소, 포트, 프로토콜, 전송 매개변수를 확인하세요. 이때는 ‘구독 목록이 비어 있음’ 문제 해결 방법으로 연결 오류를 처리하면 안 됩니다.
- 작업 시각 기록: 날짜, 현지 시각, 시간대를 적어 서비스 제공업체가 해당 요청을 찾을 수 있도록 하세요.
- 문제 발생 단계 기록: 저장 후 그룹이 나타나지 않는지, 새로고침 중 오류가 나는지, 그룹 안의 항목이 0개인지, 항목이 표시된 뒤 연결에 실패하는지 설명하세요.
- 비교 조건 기록: Wi-Fi와 모바일 데이터에서 각각 어떻게 되는지, 당시 프록시에 연결되어 있었는지, 자동 재연결이 실행되었는지 적으세요.
- 민감 정보 보호: 공개적으로 문제를 제보할 때 구독 토큰, 계정 이메일, 노드 인증 정보가 보이지 않도록 가리세요. 서비스 제공업체에서 추가 정보를 요청하면 신뢰할 수 있는 공식 계정 지원 채널로만 제출하세요.
결론: 한 가지 조건만 바꾼 결과에 따라 다음 단계 결정
새 링크로 정상 복구되면 기존 토큰을 확인하세요. 네트워크를 바꿔야 복구된다면 네트워크 경로를 점검하세요. 두 네트워크에서 모두 빈 응답을 받으면 서비스 제공업체에 계정과 API를 확인해 달라고 요청하세요. 목록이 표시된 뒤에는 노드 연결 문제를 진단하면 됩니다.
이 글은 사용자가 본인 서비스 제공업체와 구독을 이미 보유하고 있다는 전제에서 작성되었습니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 이용료와 서비스 제공업체의 회선 이용료는 별도이며, Shadowrocket을 받는 것만으로 회선 요금제가 제공되지는 않습니다.