Shadowrocket 구독 업데이트 실패·노드 목록 비어 있음: 5단계 점검

1단계: Subscribe URL이 온전한지 확인

요점: 목록을 살펴보기 전에 입력한 URL부터 확인하세요. Home에서 직접 추가한 Subscribe 항목을 찾아 편집 내용을 열고, 서비스 제공자가 안내한 원본과 한 글자씩 대조합니다. 아직 추가하지 않았다면 Home 오른쪽 위의 «+»를 누르고 Type에서 Subscribe를 선택한 뒤, 보유한 URL을 입력해 저장하세요. 화면 상태에 따라 메뉴 위치가 다를 수 있으므로 앱에 표시되는 실제 항목을 기준으로 확인하세요.

구독 URL에는 보통 경로와 쿼리 매개변수가 포함됩니다. 예시 주소 https://example.com/sub?token=xxxx에서 ?token=xxxx도 URL의 일부입니다. 물음표나 등호, 마지막 문자가 빠지면 서버가 다른 내용을 반환할 수 있습니다. 이 주소는 URL 구조를 설명하기 위한 예시이며 실제로 사용할 수 있는 구독 URL이 아닙니다. URL의 매개변수에 접근 권한을 식별하는 정보가 포함될 수 있으므로 전체 URL을 공개 게시판에 올리지 마세요.

1. 원본 URL 다시 확인

   보유한 서비스 제공자 자료에서 전체 URL을 다시 복사하세요. 맨 앞의 https://와 경로, 물음표 뒤의 매개변수를 모두 유지해야 합니다. 기억에 의존해 문자를 덧붙이지 마세요.

2. 앞뒤 문자 확인

   Subscribe 입력란의 URL 앞뒤에 공백, 줄바꿈 또는 설명 문구가 붙지 않았는지 확인하세요. 웹페이지에서 안내 문구를 통째로 복사하면 제목이나 문장 부호까지 클립보드에 들어갈 수 있습니다.

3. 한 번에 하나만 변경

   주소를 수정해 저장한 뒤 업데이트를 한 번 실행하고 목록을 확인하세요. URL과 네트워크, 설정을 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 알기 어렵습니다.

2단계: 가져오기 실패와 콘텐츠 파싱 실패 구분

요점: URL이 열린다고 해서 Shadowrocket이 읽을 수 있는 구독 콘텐츠가 반환되는 것은 아닙니다. 업데이트는 주소 요청, 응답 수신, 항목 파싱의 과정을 거칩니다. 목록이 비어 있다는 것은 표시할 항목을 최종적으로 찾지 못했다는 뜻일 뿐, 어느 단계에서 문제가 생겼는지는 이 현상만으로 단정할 수 없습니다.

웹페이지 주소나 계정 페이지 주소, 안내 문구를 Subscribe에 잘못 입력하지 않았는지 먼저 확인하세요. 링크를 복사할 때 따옴표, 한글 문장 부호, 줄바꿈, 잘린 매개변수가 포함되지 않았는지도 살펴보세요. Safari에서 같은 주소를 열어 접속 여부를 확인할 수 있지만, 브라우저에 로그인 화면이나 오류 페이지, 일반 웹페이지가 표시된다고 해서 구독 형식이 올바르다는 뜻은 아닙니다. 페이지에 표시된 민감한 정보도 다른 사람에게 전달하지 마세요.

URL이 https://로 시작하면 HTTPS는 일반적으로 443 포트를 사용하지만, 서비스 제공자가 다른 포트를 지정할 수도 있습니다. 원본 주소를 기준으로 확인하고 포트를 임의로 바꾸지 마세요. 401 또는 403 응답은 대개 접근 권한 문제를 나타내며, 404는 해당 경로를 찾을 수 없다는 뜻입니다. 200 응답을 받더라도 로그인 페이지가 아니라 실제 구독 콘텐츠가 반환됐는지 확인해야 합니다.

3단계: 서비스 제공자의 URL과 콘텐츠 상태 확인

요점: 기기에 입력한 내용이 맞다면 다음으로 해당 URL을 제공한 곳을 확인하세요. Shadowrocket은 사용자가 입력한 정보를 읽으며, 구독 URL의 유효 기간과 접근 권한, 반환되는 콘텐츠는 해당 주소를 제공하는 서비스에 따라 달라집니다. 앱 구매와 기존 서비스 자료는 별개입니다. 이 글에서는 사용자가 보유한 URL을 확인하는 방법만 다룹니다.

보유한 서비스 제공자 계정 자료에서 세 가지를 확인하세요. 클라이언트가 읽을 수 있는 구독 URL인지, 해당 URL의 접근 권한이 유효한지, 예상한 항목이 반환되는지 살펴봅니다. 서비스 제공자가 URL을 갱신했다면 현재 제공된 주소로 기존 주소를 바꾸세요. 날짜나 무작위 코드처럼 보이는 URL 일부만 수정하지 마세요.

서비스 제공자에게 문의할 때는 문제가 발생한 시점, 주소 접속 여부, 확인한 상태 코드, 그리고 «콘텐츠는 가져오지만 항목이 비어 있음» 또는 «요청이 바로 실패함»처럼 구체적인 증상을 전달하세요. 전체 token이나 비밀번호, 설정 내용을 그대로 보내지 마세요. 반환 결과가 비어 있다고 서비스 제공자가 확인했다면 먼저 해당 자료를 확인해 달라고 요청하세요. Home에서 새로고침을 반복해도 항목이 생기지는 않습니다.

4단계: 업데이트 시점을 정하고 결과를 확인

요점: URL을 수정한 뒤 업데이트를 한 번 실행하고 작업이 끝날 때까지 기다린 다음 항목에 변화가 있는지 비교하세요. 업데이트를 연달아 실행하면 어느 요청이 어느 수정 사항에 대응하는지 불분명해지며, 반환 콘텐츠 확인을 대신할 수도 없습니다. 수정 전 증상을 기록하고 링크를 저장한 뒤 업데이트를 실행해 수정 후 증상을 기록하세요.

• Subscribe를 방금 저장했다면 편집 내용이 저장됐는지 확인한 다음 업데이트를 실행하세요. Home으로 돌아가는 것만으로 콘텐츠 가져오기가 완료되는 것은 아닙니다.
• 서비스 제공자가 URL을 새로 발급했다면 현재 제공된 전체 URL을 사용하세요. 이전 주소가 과거에 작동했더라도 지금도 유효하다는 뜻은 아닙니다.
• 업데이트 후 항목이 나타나면 먼저 자신의 자료에 해당하는 항목인지 확인한 다음 연결 테스트를 진행하세요. 목록에 항목이 표시되는 것과 연결이 가능한지는 서로 다른 점검 단계입니다.
• 업데이트 후에도 목록이 비어 있다면 당시 네트워크 환경과 앱에 표시된 메시지를 기록해 다음 단계에서 비교하세요.

Global Routing의 Proxy, Direct, Config 또는 Scene을 구독 파싱 성공 여부와 혼동하지 마세요. 이는 연결 이후의 라우팅 설정입니다. 구독 목록이 비어 있다면 먼저 URL 요청과 반환 콘텐츠를 확인하세요. 항목은 있지만 접속 결과가 예상과 다를 때는 DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL 등의 규칙이 어떻게 적용되는지 비롯해 라우팅과 규칙을 추가로 확인하면 됩니다.

5단계: 네트워크를 바꿔 확인하고 다음 점검 지점 결정

요점: 확인을 마친 같은 URL이 네트워크에 따라 다르게 작동할 때 기기에서 구독 주소까지의 연결을 추가로 살펴볼 수 있습니다. Subscribe 내용을 그대로 둔 채 사용할 수 있는 Wi‑Fi와 셀룰러 네트워크에서 각각 한 번씩 업데이트하고, 콘텐츠를 가져올 수 있는지와 표시 메시지가 달라지는지 기록하세요. 네트워크를 바꾸면서 URL까지 수정하면 비교 결과를 판단하기 어렵습니다.

문제를 확인할 때는 «구독 업데이트 실패»와 «기존 항목에 연결할 수 없음»을 구분하세요. 전자는 자료를 읽어 오는 단계에서 발생하며, 후자는 기존 설정의 Type, Address, Port와 해당 프로토콜에 필요한 필드를 추가로 확인해야 합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 필요한 필드가 서로 다르므로 목록이 비어 있는 문제를 해결하려고 기존 항목의 프로토콜이나 포트를 함부로 바꾸지 마세요.

URL과 응답 콘텐츠, 네트워크를 모두 확인했는데도 Home에 예상한 항목이 보이지 않는다면 앞서 기록한 내용을 정리한 뒤 올바른 Subscribe 항목을 확인하고 있는지, 자료가 원하는 위치에 저장됐는지 살펴보세요. Config와 Home의 용도를 구분하려면 서버 관리 안내를 참고하세요. 화면에 표시된 용어의 의미가 궁금하다면 용어집을 확인하세요.