이용 중인 서비스 제공업체에서 구독 링크를 받았지만 가져온 뒤 노드가 없거나, 기존 목록을 새로고침하지 못한다면 우선 기존 항목을 그대로 둔 채 링크, 응답 내용, 업데이트 시점을 확인하세요. 마지막으로 다른 네트워크에서도 같은 문제가 생기는지 비교합니다. 화면 경로는 iPhone / iPad의 Home을 기준으로 설명합니다. 목록에 노드가 있지만 선택 후 연결되지 않는 경우는 노드 연결 문제이며, 구독 파싱 오류와는 다릅니다.
링크 유형을 확인한 다음 Home에서 업데이트
구독 URL은 목록을 가져오는 주소입니다. 서비스 제공업체 계정 페이지와 구독 URL 모두 https://로 시작할 수 있지만, 계정 페이지는 보통 웹페이지를 반환하므로 구독으로 가져올 수 없습니다. ss:// 또는 trojan://으로 시작하는 공유 링크도 구독 URL이 아닙니다. 이런 링크는 개별 노드 정보를 담고 있으므로 해당 프로토콜에 맞게 가져와야 하며, Subscribe에 입력하면 안 됩니다.
https://example.com/sub?token=xxxx
위 예시는 URL 구조만 보여 주며, 가져오기에 사용할 수 없습니다. ? 뒤의 쿼리 매개변수에 접근 자격 정보가 포함될 수 있습니다. 서비스 제공업체 계정에서 Shadowrocket용으로 표시된 구독 링크를 찾아 주소 전체를 복사하세요. 쿼리 매개변수를 빠뜨리거나 인코딩된 문자를 바꾸지 말고, 채팅 메시지의 따옴표나 마침표까지 함께 복사하지 않도록 주의하세요. 경로와 매개변수 이름은 서비스 제공업체가 정하므로 예시에 맞춰 수정할 필요가 없습니다.
원래 링크 확인
이용 중인 서비스 제공업체 계정에서 구독 URL을 다시 복사하세요. 처음 가져오기 전, 로그인 페이지나 관리 화면 주소, 짧은 시간 동안만 유효한 다운로드 주소가 아니라 구독 주소인지 확인합니다.
구독 유형 선택
처음 가져올 때는 Home을 열고 오른쪽 위의 «+»를 누른 다음
Type에서Subscribe를 선택하세요. 전체 주소를URL에 붙여 넣고 저장하면 됩니다. 이미 구독이 있다면 새로 추가하지 말고, 현재 항목의 주소가 서비스 제공업체에 의해 변경되었는지 먼저 확인하세요.한 번 새로고침
Home으로 돌아가 화면을 아래로 당겨 새로고침한 뒤 요청이 끝나면 해당 구독 그룹을 확인하세요. 오류가 표시되면 문구를 그대로 기록합니다. 오류는 없지만 노드가 보이지 않는다면 구독 그룹이 펼쳐져 있는지 확인하고, 새로고침 전후의 항목 수를 기록하세요.
기존 항목 유지
기존 목록을 계속 사용할 수 있다면 그대로 두세요. 업데이트를 유도하려고 구독 그룹 전체를 삭제하지 마세요. 링크를 바꿔야 할 때는 서비스 제공업체가 새 주소를 생성하고 활성화했는지 먼저 확인한 뒤 기존 구독을 수정하세요.
요청 실패·파싱 실패·빈 목록 구분하기
구독 업데이트는 다운로드와 파싱, 두 단계로 진행됩니다. 요청 시간이 초과되면 앱이 응답을 아예 받지 못했을 수 있습니다. 응답을 받았더라도 본문이 로그인 페이지, 오류 페이지 또는 호환되지 않는 형식이라면 콘텐츠를 목록으로 읽지 못한 경우입니다. 응답 형식은 읽을 수 있지만 서비스 제공업체가 실제로 빈 목록을 생성한 상황도 있습니다. 예를 들어 계정에 내보낼 항목이 없을 수 있습니다.
요점: 응답 코드가 200이어도 본문 형식을 확인하세요
서비스 제공업체가 200 OK 응답을 확인했는데도 Home에 항목이 없다면, 응답이 Shadowrocket에서 읽을 수 있는 구독 콘텐츠인지, 웹페이지인지, 항목 수가 0인 목록인지 확인하세요. 이때 노드 포트를 바꾸거나 규칙을 조정하는 일을 먼저 할 필요는 없습니다.
브라우저에서 주소가 열린다고 해서 앱도 같은 콘텐츠를 가져올 수 있는 것은 아닙니다. 브라우저에 로그인 상태가 저장되어 있거나 리디렉션된 웹페이지가 표시될 수 있습니다. 서비스 제공업체 계정에서 구독 미리보기를 제공한다면 항목이 있는지 먼저 확인하세요. 응답을 확인해야 한다면 이용 중인 서비스 제공업체에 상태 코드, 반환 형식, 항목 수를 문의하세요. 자격 정보가 포함된 주소를 공개 검사 페이지에 붙여 넣지 마세요.
표시된 문구에 따라 구독 업데이트 오류 처리
화면에 실제 표시된 안내 문구를 먼저 기록하세요. 아래의 HTTP 상태 문구는 서비스 제공업체가 반환한 내용일 수 있으며, Shadowrocket에 그대로 표시되지 않을 수도 있습니다. 일반적인 로딩 메시지만 보인다면 링크 만료나 네트워크 장애라고 추측하지 마세요.
Failed to load subscription
원인: 구독을 불러오지 못했다는 뜻이지만, 이 문구만으로 다운로드 실패와 응답 오류를 구분할 수는 없습니다. 해결 방법: 전체 URL을 확인한 뒤 같은 주소를 사용해 네트워크를 바꾸고 한 번 새로고침하세요. 계속 실패하면 요청 시각을 알려 주고 서비스 제공업체에 응답을 확인해 달라고 문의하세요.
401 Unauthorized
원인: 서버가 유효한 인증 정보를 받지 못했습니다. 구독 매개변수가 빠졌거나 인증 정보가 만료되었을 수 있습니다. 해결 방법: 계정에서 현재 주소를 다시 복사하고, 이전 링크가 아직 유효한지 서비스 제공업체에 확인하세요.
403 Forbidden
원인: 요청이 거부되었습니다. 계정 권한, 링크 상태 또는 서버 접근 정책이 원인일 수 있습니다. 해결 방법: 구독 접근 조건을 서비스 제공업체에 확인하고, 같은 요청을 반복해서 보내지 마세요.
429 Too Many Requests
원인: 요청 횟수가 제한 기준을 초과했습니다. 해결 방법: 연속으로 화면을 당겨 새로고침하지 마세요. 응답에 Retry-After가 있으면 안내된 시간만큼 기다리고, 없으면 서비스 제공업체의 안내에 따라 한 번 다시 시도하세요.
갱신 또는 링크 변경 후 목록이 비어 있음
결제 기록, 계정 이용 권한 상태, 구독 콘텐츠 생성은 각각 별도의 단계입니다. 갱신 후에는 계정에 표시된 적용 상태를 확인하고, 서비스 제공업체가 새 목록을 생성했는지 확인하세요. 일반적으로 적용까지 걸리는 시간은 정해져 있지 않습니다. 서비스 제공업체가 적용 시각을 안내했다면 그 안내를 따르세요. 목록 생성이 완료되었다는 확인을 받기 전까지 새로고침을 반복해도 아직 공개되지 않은 항목이 나타나지는 않습니다.
- 갱신 후 목록이 비어 있음: 갱신이 적용되었는지, 계정에 내보낼 항목이 남아 있는지 확인하세요. 계정 페이지에 정상으로 표시되는데도 비어 있다면 현재 URL이 실제로 반환하는 항목 수를 서비스 제공업체에 문의하세요.
- 링크를 재설정한 뒤 업데이트할 수 없음: 이전 주소가 더는 유효하지 않을 수 있습니다. 새 주소를 복사해 해당 구독을 업데이트하고 경로와 쿼리 매개변수를 모두 유지하세요. 도메인만 바꾸거나 익숙한 매개변수 일부만 교체하면 잘못된 주소가 될 수 있습니다.
- 새로고침 후에도 이전 목록이 표시됨: 기존 항목이 보인다고 해서 이번 요청이 성공한 것은 아닙니다. 새로고침 시 표시된 안내 문구를 기록하고 서비스 제공업체에 현재 내보내는 콘텐츠를 확인하세요. 이전 목록이 계속 반환된다면 항목을 여러 번 삭제하고 다시 가져와도 새 항목을 받을 수 없습니다.
Wi-Fi와 셀룰러 데이터로 비교
네트워크를 비교할 때는 한 번에 조건 하나만 바꾸세요. 같은 구독 링크와 같은 설정을 사용해 현재 네트워크에서 먼저 새로고침하고 결과를 기록한 뒤, 인터넷 접속이 확인된 다른 네트워크로 바꾸어 한 번 더 새로고침합니다. 구독 업데이트는 목록을 제공하는 서버에 연결하고, 노드 연결은 목록에 있는 서버에 연결합니다. 기존 노드에 연결된다고 해서 구독 서버에도 접속할 수 있는 것은 아닙니다.
- Wi-Fi에서만 실패: 먼저 Wi-Fi에서 웹페이지 인증을 완료해야 하는지 확인하세요. 일반 웹페이지는 열리지만 구독 요청이 계속 시간 초과된다면 실패 시각을 기록하고 네트워크 관리자나 서비스 제공업체에 해당 구독 도메인에 접속할 수 있는지 문의하세요.
- 셀룰러 데이터에서만 실패: 시스템에서 Shadowrocket의 셀룰러 데이터 사용을 허용했는지 확인한 뒤 같은 구독을 다시 테스트하세요. 링크도 동시에 바꾸면 어떤 변경이 영향을 주었는지 알 수 없습니다.
- 두 네트워크에서 같은 안내가 표시됨: 두 곳 모두
401또는403이면 인증 정보와 계정 접근 권한을 먼저 확인하세요. 두 네트워크 모두 요청은 성공하지만 목록이 비어 있다면Global Routing을 바꾸거나Config를 초기화하기보다 서비스 제공업체에 내보내는 콘텐츠를 확인해 달라고 요청하세요.
Shadowrocket 다운로드 및 사용 안내
iPhone / iPad 버전은 App Store에서 제공되며 $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 칩 / Intel) / Windows / Android / Linux 버전은 무료이며, 설치 파일은 사이트의 전체 플랫폼 다운로드 페이지에서 받을 수 있습니다.