이용 중인 서비스 제공업체와 구독 링크가 있는데도 Shadowrocket의 Home에 서버 항목이 표시되지 않는다면, 먼저 추가 유형과 링크 전체를 확인하세요. 다음으로 서비스 제공업체가 실제 서버 목록을 반환하는지 확인한 뒤 직접 새로고침하여 결과를 비교합니다. 아래 설명은 iPhone / iPad 화면을 기준으로 합니다. 항목은 표시되지만 선택 후 연결되지 않는 문제라면 연결 문제 해결 절차를 따르세요. 구독을 반복해서 다시 가져오지 마세요.
다운로드 실패, 파싱 실패, 목록 비어 있음 구분하기
구독 항목이 Home에 표시된다고 해서 앱에 구독이 등록된 것일 뿐, 서버 목록 업데이트까지 성공했다는 뜻은 아닙니다. 업데이트할 때는 먼저 구독 주소로 요청을 보내고, 응답을 읽어 서버 항목을 파악한 다음 Home에 결과를 표시합니다. 다운로드에 실패하면 앱이 읽을 수 있는 응답을 받지 못했을 수 있습니다. 파싱에 실패했다면 받은 내용이 예상한 형식인지 확인해야 합니다. 목록이 비어 있다면 서비스 제공업체가 현재 실제로 항목을 할당했는지도 확인하세요. 일반적인 오류 메시지만으로는 어느 단계에서 실패했는지 알 수 없는 경우도 있습니다.
Failed to load subscription
가능한 원인: 링크가 만료되었거나 읽을 수 있는 구독 내용을 가져오지 못했을 수 있습니다. 해결 방법: 이용 중인 서비스 제공업체의 계정 페이지에서 링크가 유효한지, 서버 목록이 생성되었는지 확인한 다음 Home에서 아래로 당겨 한 번 새로고침하고 결과를 기록하세요.
401 Unauthorized
가능한 원인: 서비스 제공업체에서 구독 요청에 이 HTTP 상태가 반환된다고 확인했다면, 링크의 토큰이 만료되는 등 유효한 인증 정보가 요청에 포함되지 않았을 가능성이 큽니다. 해결 방법: 계정 페이지에서 최신 링크 전체를 다시 복사하세요. 새 링크에서도 같은 상태가 반환되면 서비스 제공업체에 인증 요건을 확인해 달라고 요청하세요. 이는 Shadowrocket에 고정적으로 표시되는 오류 문구가 아닙니다.
링크 형식 확인: Home에서 Subscribe로 추가
서비스 제공업체가 구독용으로 제공한 주소인지 먼저 확인하세요. 계정 페이지, 로그인 페이지, 안내 페이지의 URL이나 개별 서버 공유 주소와는 다릅니다. 브라우저에서 열리는 URL이라고 해서 구독에 사용할 수 있는 것은 아닙니다. 아래는 주소 구조의 예시일 뿐, 서버를 가져오는 데 사용할 수 없습니다.
https://example.com/sub?token=xxxx
현재 링크 복사
이용 중인 서비스 제공업체의 계정 페이지에서 현재 구독 주소를 복사하세요. 채팅에 표시된 말줄임표가 포함된 미리보기 텍스트를 복사하지 말고, 주소 끝의 마침표나 따옴표, 줄바꿈도 함께 복사하지 않도록 주의하세요.
추가 유형 선택
Shadowrocket에서 Home을 열고 오른쪽 위의
+를 누른 다음Type에서Subscribe를 선택하세요. 여기서 추가하는 것은 서버 목록을 가져오는 주소입니다. Config에서 규칙 파일을 가져오는 것이 아닙니다.주소 전체 확인
링크를 붙여넣은 뒤 프로토콜, 호스트 이름, 경로가 맞는지,
?뒤의 쿼리 매개변수가 전부 포함되었는지 확인하세요. 원래 주소에&나 퍼센트 인코딩이 있다면 그대로 유지하세요. 추측으로 매개변수를 삭제하거나 인코딩된 문자를 일반 문자로 직접 바꾸지 마세요.저장 후 새로고침
저장한 뒤 Home으로 돌아가 서버 목록 영역을 아래로 당겨 새로고침하세요. 작업 결과가 표시될 때까지 기다린 다음 해당 구독에 새 항목이 있는지 확인합니다. 같은 구독을 이미 추가했다면 기존 항목부터 확인하고, 테스트를 위해 같은 구독을 여러 번 추가하지 마세요.
구독 매개변수에는 계정 인증 정보가 포함될 수 있습니다. 링크 전체를 확인할 때는 본인 기기와 서비스 제공업체의 계정 페이지에서만 대조하세요. 실제 링크를 공개 파싱 도구, 게시물, 스크린샷에 붙여넣지 마세요. 링크 형식을 설명해야 한다면 토큰과 계정을 식별할 수 있는 정보를 가짜 값으로 바꾸세요.
서비스 제공업체 응답 확인: HTTP 요청 성공이 유효한 목록을 뜻하지는 않습니다
링크가 올바른데도 파싱에 실패하면 서비스 제공업체 계정 페이지에서 구독이 활성화되어 있는지, 현재 계정에 서버가 할당되어 있는지, 구독 주소가 변경된 적이 있는지 확인하세요. 계정 페이지에 로그인할 수 있다는 것은 현재 브라우저에서 계정 페이지에 접근할 수 있다는 뜻일 뿐입니다. 브라우저에는 로그인 상태가 저장되어 있을 수 있지만, Shadowrocket이 구독 주소에 요청을 보낼 때 브라우저의 로그인 상태를 자동으로 가져오지는 않습니다.
- 로그인 페이지나 오류 페이지가 반환됨: 최종 상태가
200 OK여도 응답 본문은 구독 데이터가 아닌 웹페이지일 수 있습니다. 서비스 제공업체에 링크가 로그인 페이지로 리디렉션되는지, 계정 페이지에서 어떤 주소를 복사해야 하는지 확인해 달라고 요청하세요. - 빈 내용이나 빈 목록이 반환됨: 현재 계정에 항목이 할당되어 있는지, 최근 할당 변경 사항이 구독 인터페이스에 반영되었는지 서비스 제공업체에 확인하세요. Shadowrocket은 빈 응답에서 서버 항목을 생성할 수 없습니다.
- 내용은 있지만 파싱에 실패함: Shadowrocket에서 가져올 수 있는 형식인지, 항목의 필드가 모두 포함되어 있는지 서비스 제공업체에 확인하세요. 텍스트가 비어 있지 않다고 해서 호환되는 형식이라는 뜻은 아닙니다. Home에서 서버 주소, 포트, 인증 정보를 추측해 직접 입력할 필요도 없습니다.
정리: 링크가 맞다면 먼저 서비스 제공업체에 어떤 응답이 반환되었는지 문의하세요
링크 전체가 올바른데도 Home에서 아래로 당겨 새로고침한 후 실패한다면, 새로고침한 시간과 시간대를 서비스 제공업체에 알리고 당시의 HTTP 상태, 응답이 목록인지 웹페이지인지, 목록에 항목이 있었는지 확인해 달라고 요청하세요. 링크를 바꾸거나 출력 형식을 조정하기 전에 이 세 가지를 먼저 확인합니다.
업데이트 시점 확인: 한 번에 조건 하나만 변경
구독을 새로 활성화하거나 토큰을 재설정하거나 계정 할당을 변경한 경우, 먼저 변경 사항이 구독 주소에 반영되었는지 확인한 다음 Home에서 새로고침하세요. 갱신이나 할당 업데이트 후에도 기존 주소를 계속 사용할 수 있습니다. 서비스 제공업체에서 링크를 재설정했다고 명확히 안내했다면 저장된 주소를 업데이트해야 하며, 이전 주소로 계속 새로고침하면 안 됩니다. 일률적으로 정해진 대기 시간은 없으므로 서비스 제공업체가 안내하는 적용 상태를 기준으로 삼으세요.
- 새로고침 전 상태를 기록하세요. Home에서 확인 중인 구독 항목을 확인하고, 현재 표시된 항목 수와 오류 메시지 원문을 적어 두세요. 기존 항목이 계속 표시된다고 해서 방금 새로고침이 성공한 것은 아닙니다.
- 변경 사항을 확인한 뒤 한 번 새로고침하세요. Home으로 돌아가 아래로 당긴 뒤 항목이 나타나는지, 기존 항목이 예상대로 바뀌었는지, 오류 메시지가 그대로인지 확인하세요. 서비스 제공업체가
429가 반환되었다고 확인했다면 안내된 대기 시간만큼 기다린 후 다시 시도하고, 연속으로 아래로 당기지 마세요. - 네트워크 문제로 의심될 때만 비교 테스트를 하세요. 현재 네트워크에서 새로고침 시 시간 초과가 표시되면 같은 기기의 다른 사용 가능한 네트워크로 전환해 같은 주소를 다시 시도할 수 있습니다. 테스트 중에는 링크와 계정 설정을 동시에 변경하지 마세요. 한 네트워크에서만 실패한다면 먼저 해당 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 이것만으로 목록 형식이 잘못되었다고 단정하지 마세요.
- 항목이 복구되면 다시 가져오기를 중단하세요. Home에 예상한 항목이 표시되는데 그중 하나를 사용해 연결되지 않는다면
Connectivity Test로 연결을 확인하세요. 이 테스트는 구독 응답 형식을 확인하는 기능이 아니며, 새로고침 후 목록 확인을 대신할 수 없습니다.
목록이 계속 비어 있다면 서비스 제공업체에 전달할 기록 정리
문제를 문의할 때는 ‘구독이 업데이트되는지’와 ‘서버에 연결할 수 있는지’를 나누어 설명하세요. 처음 추가한 뒤 계속 비어 있는지, 기존 목록이 특정 변경 이후 비어졌는지 적어 주세요. 상황에 따라 서비스 제공업체가 확인해야 할 서버 기록이 다릅니다. 먼저 기존 항목과 오류가 표시된 상태를 보존하세요. 같은 구독 응답을 확인하려고 앱을 재설치하거나 Config를 비울 필요는 없습니다.
- 클라이언트 정보: 기기 플랫폼, 조작 경로
Home → + → Type → Subscribe, 저장 후 Home에서 아래로 당겨 새로고침했는지 여부, 새로고침 전후의 표시 항목 수와 오류 메시지 원문. - 계정 정보: 새로고침 시간과 시간대, 최근 갱신이나 링크 변경 여부, 계정 페이지에 서버가 할당된 것으로 표시되는지 확인하세요. 서비스 제공업체에 보내는 스크린샷에서는 전체 주소, 계정 이름, 토큰을 가리세요.
- 서비스 제공업체에 확인할 사항: 해당 요청이 도달했는지, 어떤 상태와 본문 유형이 반환되었는지, 목록에 항목이 있었는지 확인해 달라고 요청하세요. 응답을 수정했다고 확인되면 Home에서 직접 한 번 새로고침하고 예상한 항목이 나타나는지 확인하세요.