이 글은 직접 이용 중인 서비스 제공업체의 구독 URL을 보유한 사용자를 위한 안내입니다. 먼저 ‘요청 실패’, ‘응답을 파싱할 수 없음’, ‘요청은 성공했지만 사용 가능한 항목이 없음’을 구분하세요. 그런 다음 Subscribe의 URL, 서비스 제공업체가 반환한 내용, 업데이트 시점을 확인하고 네트워크는 한 번에 한 가지 조건만 바꿔 점검합니다. 문제를 확인하는 동안 기존 설정을 유지하고, 아직 사용할 수 있는 항목은 삭제하지 마세요.
1. 먼저 어느 단계에서 실패하는지 확인하기
Shadowrocket의 구독 업데이트는 지정된 URL에서 데이터를 요청한 다음, 지원되는 노드 정보를 Home의 항목으로 변환하는 과정입니다. 구독 URL을 저장할 수 있다고 해서 서버가 유효한 데이터를 반환한 것은 아닙니다. 서버가 성공 응답을 보내더라도 파싱할 수 있는 노드가 포함되어 있다는 뜻은 아닙니다.
현재 상황을 기록하세요. 추가 직후 오류가 표시되는지, 업데이트 중 대기하다 시간 초과되는지, 기존 항목은 남아 있지만 업데이트에 실패하는지, 새 구독 그룹이 계속 비어 있는지 확인합니다. 기존 항목이 있다는 사실은 데이터가 로컬에 저장된 적이 있음을 보여줄 뿐, 이번 업데이트가 성공했다는 뜻은 아닙니다. 노드에 연결할 수 있어도 구독 주소가 현재 유효하다고 단정할 수 없습니다.
판단 기준: 현재 상태를 기록한 뒤 설정 변경
오류 메시지 원문과 작업 시간을 먼저 기록한 뒤 수동 업데이트를 한 번 진행하세요. 구독을 바로 삭제하거나 설정을 바꾸고 앱을 재설치하면 어떤 변경이 결과에 영향을 주었는지 파악하기 어렵습니다.
2. Subscribe에 저장된 URL 확인하기
구독 URL은 본인이 이용하는 서비스 제공업체에서 받아야 합니다. 계정 로그인 페이지, 주문 페이지, 웹페이지 공유 링크로 대체할 수 없습니다. 아래 주소는 형식을 보여주는 예시일 뿐, 가져오기에 사용할 수 없습니다. URL의 경로와 쿼리 매개변수가 함께 계정을 식별할 수 있으므로 도메인만 복사하지 마세요.
https://example.com/sub?token=xxxx
-
원본 URL 복사
본인 서비스 제공업체의 계정 페이지에서 구독 복사 기능을 사용하고, Shadowrocket용이라고 안내된 형식을 선택하세요. 스크린샷의 URL을 옮기거나 페이지 제목까지 함께 복사하지 마세요.
-
추가 위치 확인
Home 오른쪽 위의 ‘+’를 선택하고 Type을 Subscribe로 설정한 다음 전체 주소를 URL에 입력하세요. 기존 구독이 있다면 먼저 저장된 항목을 확인하고, 같은 그룹을 반복해서 새로 만들 필요는 없습니다.
-
URL 앞뒤 문자 확인
URL이
https://로 시작하는지, 끝부분의 매개변수가 복사 전과 같은지 확인하고 주소 앞뒤에 붙은 공백, 줄바꿈, 따옴표를 제거하세요. 매개변수 안의 문자는 그대로 두고?,&,=또는 퍼센트 인코딩을 임의로 삭제하거나 바꾸지 마세요. -
저장 후 업데이트
저장한 뒤 Home으로 돌아가 구독 목록을 아래로 당겨 새로고침하고, 작업이 끝날 때까지 기다린 다음 해당 그룹에 항목이 표시되는지 확인하세요. 요청을 연달아 여러 번 보내지 말고 이번 결과를 기록해 두세요.
단일 노드 URI와 구독 URL은 서로 다른 입력 형식입니다. ss://, vmess://, trojan:// 등으로 제공된 개별 노드 정보는 해당 형식에 맞게 가져와야 합니다. 이를 HTTP 구독 주소처럼 Subscribe의 URL에 입력하면 안 됩니다. 반대로 구독 페이지 주소를 프로토콜 서버 주소로 직접 사용할 수도 없습니다.
구독 URL에는 계정 토큰이 포함될 수 있습니다. 전체 주소를 공개 댓글이나 스크린샷에 노출하거나 온라인 디코딩 도구에 입력하지 마세요. 도움을 요청할 때는 도메인과 오류 정보를 남기고 경로의 키와 모든 계정 식별 매개변수를 가리세요.
3. HTTP 상태 코드와 응답 내용 구분하기
오류 메시지나 서비스 제공업체 로그에 HTTP 상태 코드가 포함되어 있다면 코드로 원인을 좁혀 보세요. 아래는 표준 HTTP 응답 코드이며, Shadowrocket이 모든 시스템에서 이 문구를 그대로 표시한다는 뜻은 아닙니다. 상태 코드가 없다면 실제 메시지를 기록하고 임의로 ‘링크 만료’라고 판단하지 마세요.
오류: 401 Unauthorized
원인: 서버 인증에 실패했습니다. 토큰이 만료되었거나 누락되었거나 인증 방식이 맞지 않을 수 있습니다.
해결 방법: 본인 서비스 제공업체의 계정 페이지에서 현재 구독 URL을 다시 복사하세요. 같은 상태 코드가 계속 반환되면 해당 토큰의 권한을 서비스 제공업체에 확인하세요.
오류: 403 Forbidden
원인: 서버가 현재 요청을 거부했습니다. 접근 정책, 계정 권한 또는 보안 차단이 원인일 수 있으며, 이 상태 코드만으로 요금제가 만료되었다고 단정할 수는 없습니다.
해결 방법: 발생 시간, 네트워크 유형, 전체 오류 메시지를 기록해 서비스 제공업체에 해당 요청을 확인해 달라고 문의하세요. 제한을 우회하려고 연속으로 새로고침하지 마세요.
오류: 404 Not Found
원인: 요청한 경로를 찾을 수 없습니다. URL이 잘렸거나 이전 주소가 비활성화되었을 수 있으며, 서버가 리소스를 의도적으로 숨겼을 수도 있습니다.
해결 방법: 현재 계정 페이지에 표시된 경로와 매개변수를 하나씩 대조하세요. API 경로를 추측해 입력하지 말고, 새 URL도 실패하면 서비스 제공업체에 확인을 요청하세요.
200 OK는 HTTP 요청이 성공했다는 뜻일 뿐입니다. 응답 본문에는 로그인 페이지, 보안 확인 페이지, 점검 안내 또는 빈 내용이 들어 있을 수 있습니다. 이런 내용이 브라우저에서 열린다고 해서 클라이언트가 노드를 생성해야 하는 데이터라고 판단할 수는 없습니다. 브라우저에는 계정 Cookie가 포함될 수 있지만, 구독 요청은 로그인된 웹페이지 세션과 동일하지 않습니다.
- 응답 본문이
<!DOCTYPE html>또는<html>로 시작한다면 구독 데이터가 아니라 웹페이지를 받은 것은 아닌지 먼저 확인하세요. - 서비스 제공업체가 여러 출력 형식을 제공한다고 명시한 경우 Shadowrocket용 형식을 선택하세요. 파일 확장자만 바꿔 콘텐츠를 변환하려고 하지 마세요.
- 일부 구독은 텍스트를 Base64로 인코딩해 전달합니다. 인코딩은 암호화가 아니며, 내부 기록 형식이 올바르다는 보장도 없습니다. 원본 내용을 제3자 웹사이트에 입력하지 마세요.
- 응답이 비어 있거나 안내 문구만 있고 노드 정보가 없다면 Global Routing을 바꾸기 전에 계정에서 사용할 수 있는 항목과 서버 출력 내용을 확인하세요.
4. 서비스 제공업체 상태와 업데이트 시점 확인하기
구독 그룹이 비어 있는 것은 서버가 현재 계정에 사용 가능한 항목을 할당하지 않았거나 구독 출력과 계정 페이지의 상태가 아직 동기화되지 않았기 때문일 수 있습니다. 계정 잔액, 요금제 상태, 기기 제한, 구독 권한은 각각 다른 항목이므로 본인 서비스 제공업체의 안내를 확인하세요. Shadowrocket에 빈 목록이 표시된다는 사실만으로 어느 항목에 문제가 있는지 판단할 수는 없습니다.
- 계정 확인: 본인 서비스 제공업체의 페이지에 로그인해 서비스 상태, 유효 기간, 사용 가능한 항목이 표시되는지 확인하세요. 계정 페이지에도 항목이 없다면 먼저 서비스 제공업체에 문의하세요.
- URL 변경 확인: 구독 토큰을 최근 재설정했다면 기존 URL이 더 이상 유효하지 않을 수 있습니다. Home에 저장된 주소와 새 URL을 비교할 때 도메인만 확인하지 말고 전체 주소를 대조하세요.
- 서버 처리 완료 대기: 요금제를 변경하거나 서비스를 복구한 직후라면 서비스 제공업체가 안내한 처리 시간을 기다린 뒤 업데이트하세요. 요청을 제출하자마자 모든 인터페이스가 동기화된다고 가정하지 마세요.
- 요청 제한 확인:
429 Too Many Requests가 표시되면 연속 업데이트를 중단하세요. 응답에Retry-After가 포함되어 있으면 안내된 시간만큼 기다리고, 그렇지 않다면 서비스 제공업체에 업데이트 허용 간격을 문의하세요.
몇 초마다 새로고침하는 것을 문제 해결 방법으로 삼지 마세요. 잦은 요청은 요청 제한을 유발해 기존 형식 문제에 접근 문제가 더해질 수 있습니다. 기존 항목을 계속 사용할 수 있다면 새 구독 데이터가 유효한지 확인할 때까지 그대로 두고, 이후 중복 항목을 정리하세요.
판단 기준: 계정 페이지도 비어 있다면 먼저 서버 상태 확인
계정 페이지에 사용 가능한 항목이 없거나 서비스 제공업체가 구독 API에 아직 데이터가 생성되지 않았다고 확인했다면, 프로토콜·규칙·DNS를 바꿔도 노드가 생기지 않습니다. 먼저 서비스 제공업체에 API가 유효한 기록을 반환하는지 확인한 뒤 Home에서 다시 업데이트하세요.
5. 네트워크와 연결 상태를 한 번에 하나씩 테스트하기
요청 시간 초과, 도메인 이름 확인 실패, TLS 오류는 서로 다른 단계에서 발생합니다. 시간 초과는 연결이 설정되지 않았거나 응답이 끝나지 않아 발생할 수 있습니다. 인증서 오류가 나타나면 시스템 시간, 대상 도메인, 서버 인증서를 확인하세요. 인증서 검사를 무시하는 방식으로 문제를 해결하려 해서는 안 됩니다. 전후 결과를 비교하려면 조건을 한 번에 하나만 바꾸세요.
-
현재 상태 기록
Wi-Fi와 셀룰러 중 어떤 네트워크를 사용하는지, Home의 연결 스위치 상태, 현재 Global Routing 설정, 실제 오류 메시지를 기록하세요. DNS와 규칙을 동시에 변경하지 마세요.
-
네트워크 전환
같은 구독 URL과 동일한 연결 상태를 유지한 채 Wi-Fi와 셀룰러 네트워크에서 각각 한 번씩 업데이트하세요. 한 네트워크에서만 실패한다면 해당 네트워크의 로그인 인증, DNS 또는 접근 제한을 먼저 확인하세요.
-
자동 연결 확인
수동으로 연결을 끈 뒤에도 자동으로 다시 연결된다면 Settings → On Demand에서 자동 연결 조건이 설정되어 있는지 확인하세요. 기존 설정을 기록하고 자동 연결을 잠시 중지해 테스트한 뒤 원래대로 복원하세요.
-
연결 전후 결과 비교
사용 가능한 노드가 이미 있는 경우에만 연결 해제 상태와 연결 상태에서 업데이트 결과를 비교하세요. 아직 가져오지 못한 구독으로 연결을 설정할 수는 없으며, 구독 요청이 선택한 노드를 통해 반드시 전송된다고 가정해서도 안 됩니다.
Global Routing의 Config, Proxy, Direct, Scene은 트래픽 처리 방식을 제어하지만 웹페이지를 노드로 변환하지는 않습니다. Config의 DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL은 규칙 키워드이지 구독 파싱을 복구하는 스위치가 아닙니다. 목록이 비어 있다면 먼저 응답 내용을 확인하고, 필요한 경우에만 규칙과 아웃바운드 경로를 점검하세요.
서비스 제공업체의 홈페이지가 열린다는 것은 현재 환경에서 해당 웹페이지에 접근할 수 있다는 뜻일 뿐입니다. 구독 API, 리디렉션 대상, 인증 매개변수까지 모두 사용할 수 있다는 보장은 없습니다. 비교 테스트에서는 동일한 구독 요청의 결과를 기록하세요.
6. 서비스 제공업체에 문의해야 하는 경우와 전달할 정보
최신 URL에서도 인증 오류가 계속되거나, 계정 페이지에는 항목이 있지만 API 응답이 비어 있거나, 서비스 제공업체가 지정한 형식으로도 파싱되지 않는다면 본인 서비스 제공업체에 문의하세요. 로컬 기록을 반복해서 삭제하기보다 API 권한, 응답 내용, 형식 호환성, 요청 로그를 확인해 달라고 요청하는 편이 효과적입니다.
- 시간: 서버 로그와 대조할 수 있도록 발생 날짜, 정확한 시간, 시간대를 알려주세요.
- 작업: Home에서 Subscribe를 추가한 뒤 처음 업데이트할 때 실패했는지, 기존 구독을 수동으로 새로고침할 때 실패했는지 설명하세요.
- 증상: 오류 메시지를 원문 그대로 전달하고, 기존 항목이 남아 있는지, 해당 그룹을 펼쳐 확인했는지, 목록이 계속 비어 있는지 알려주세요.
- 환경: 운영체제 종류, 네트워크 유형, 연결 상태, 한 번에 한 가지 조건만 바꿔 테스트한 결과를 알려주세요. 다른 앱의 계정 정보는 제공할 필요가 없습니다.
- 보안 유의사항: 공개된 문의에는 식별 정보를 가린 도메인과 오류 스크린샷만 첨부하세요. 토큰을 제출해야 한다면 서비스 제공업체가 확인한 비공개 지원 채널을 이용하세요.
문제가 해결되면 Home으로 돌아가 수동 업데이트를 한 번 실행하고, 해당 그룹에 항목이 표시되는지 확인한 다음 기존 항목을 선택해 연결을 테스트하세요. 목록에 항목이 표시되는 것과 연결에 성공하는 것은 별도의 확인 단계입니다. 전자는 구독을 가져와 파싱했는지 확인하며, 후자는 노드 주소, 포트, 프로토콜 설정, 현재 네트워크에도 영향을 받습니다. 항목은 표시되지만 연결되지 않는다면 연결 문제를 확인하면 되며 구독을 다시 만들 필요는 없습니다.
이 글은 사용자가 직접 이용하는 서비스 제공업체와 구독을 보유하고 있다는 전제로 작성했습니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 구매와 회선 서비스는 별개이며, 클라이언트 일회성 구매 ≠ 회선 요금제입니다.