구독을 추가했는데 새 항목이 보이지 않으면 먼저 Home에서 수동으로 새로고침한 다음 Settings → Subscribe에서 Update On Open을 확인하세요. iPhone / iPad 영문 인터페이스를 기준으로 설명하며, 서비스 제공업체와 구독 링크를 이미 보유한 사용자를 위한 안내입니다. 다른 플랫폼에서는 같은 이름의 기능을 확인하세요. 링크 만료, 네트워크 연결 실패, 내용 파싱 실패를 구분하고, 업데이트 후에도 연결되지 않는 이유를 살펴봅니다.
먼저 업데이트 대상을 구분하세요
Shadowrocket 구독 업데이트는 저장된 구독 주소에 다시 요청을 보내고, 응답 내용을 연결 항목으로 파싱한 뒤 해당 구독 그룹에 반영하는 작업입니다. 앱 업데이트나 연결 요금제 갱신과는 다릅니다. 구독 링크는 서비스 제공업체에서 받아야 합니다. 앱 구매와 연결 요금제는 별개이며, 앱 구매 비용은 서비스 제공업체 계정의 데이터 사용량, 이용 기간, 연결 권한에 영향을 주지 않습니다.
Home에는 연결 항목과 구독 그룹이 표시되고, Config에서는 구성 파일과 규칙을 관리하며, Settings에서는 앱 설정을 관리합니다. 이 글에서는 Home의 연결 구독을 새로고침하는 방법을 다루며, Config의 구성 파일 원격 업데이트와는 구분합니다. 연결 구독을 새로고침해도 Config의 DOMAIN-SUFFIX, IP-CIDR, FINAL 규칙은 일반적으로 바뀌지 않습니다.
구독 주소, 연결 서버 주소, 구성 파일 주소는 서로 바꿔 쓸 수 없습니다. 구독 주소는 연결 항목을 가져오는 데 사용하고, 연결 서버 주소와 포트는 실제 연결을 설정하는 데 사용합니다. 두 주소 모두 443을 사용하더라도 같은 서버에 접속한다는 뜻은 아닙니다. 구독 새로고침이 성공했다는 것은 이번 요청과 파싱이 완료됐다는 뜻일 뿐, 각 연결 항목의 사용 가능 여부를 보장하지 않습니다.
Home에서 수동 업데이트
처음 문제를 확인할 때는 수동으로 업데이트를 실행하는 것이 좋습니다. 실행 시각, 표시된 안내, 항목 변화를 기록하기 쉽기 때문입니다. 먼저 Home에 구독 출처가 있는 그룹이 표시되는지 확인하세요. 직접 입력한 서버만 있고 구독 주소가 없다면, 아래로 당겨도 새 구독 내용이 생기지 않습니다. 새로고침 후 변화가 없다고 같은 링크를 반복해서 가져오면 그룹 출처를 파악하기 더 어려워질 수 있습니다.
-
그룹 확인
Home으로 이동해 업데이트할 구독 그룹을 찾습니다. 아직 추가하지 않았다면 Home 오른쪽 위의 “+” → Type → Subscribe를 선택하고, 서비스 제공업체에서 받은 구독 주소를 입력한 뒤 저장합니다.
-
주소 확인
해당 구독의 편집 정보에서 URL을 확인하고 프로토콜, 경로, 쿼리 매개변수가 빠짐없이 있는지 살펴봅니다. 서비스 제공업체 계정의 웹 로그인 주소를 구독 주소로 사용하지 마세요. 복사 과정에서 링크에 붙은 공백이나 줄바꿈도 제거해야 합니다.
-
아래로 당겨 새로고침
Home으로 돌아가 목록을 맨 위로 스크롤한 뒤 아래로 당겼다가 놓고 새로고침이 끝날 때까지 기다립니다. 저장된 구독 여러 개가 업데이트될 수 있으므로 목록의 전체 항목 수만 보지 말고 대상 그룹을 확인하세요.
-
결과 확인
오류 안내를 기록하거나, 서비스 제공업체가 변경했다고 알린 항목을 확인합니다. 이름과 개수가 이전과 같다면 실제로 내용이 변경됐는지 먼저 확인하세요. 결과가 같다고 해서 업데이트에 실패한 것은 아닙니다.
예시 주소 https://example.com/sub?token=xxxx는 구조를 알아보기 위한 것으로, 실제 구독에 사용할 수 없습니다. 여기서 token은 접근 자격 정보의 일부이므로 도메인만 남기고 새로고침을 시도해서는 안 됩니다. 문제를 공유할 때는 쿼리 매개변수 전체, 계정 정보, 연결 자격 정보를 가리고 구독 원문을 공개하지 마세요.
앱 실행 시 자동 업데이트
Settings → Subscribe에서 Update On Open을 찾아 켜면, 앱을 열 때 해당 기능의 실행 조건에 따라 구독 새로고침을 시도합니다. 사용 전에 최신 항목을 받아보고 싶은 경우에 유용하지만, 몇 분 간격으로 정기 업데이트하는 기능은 아니며 앱을 닫은 뒤에도 계속 실행되는 것을 보장하지 않습니다. 시스템의 백그라운드 실행 일정, 현재 네트워크, 서버 응답에 따라 결과가 달라질 수 있습니다.
- 켜기 전에: 먼저 Home에서 수동 업데이트를 한 번 성공시키고, 현재 주소와 네트워크에서 유효한 내용을 받을 수 있는지 확인하세요.
- 켜고 나서: 앱을 다시 열고 요청이 완료될 때까지 기다린 뒤 대상 그룹을 확인하세요. 설정이 켜져 있다는 사실만으로 이번 업데이트가 성공했다고 볼 수는 없습니다.
- 실패한 경우: Home으로 돌아가 수동 새로고침을 실행해 오류 안내를 확인하세요. Update On Open을 반복해서 껐다 켜도 만료된 링크는 복구되지 않습니다.
- 네트워크가 느린 경우: 요청이 끝날 때까지 기다린 뒤 재시도 여부를 판단하세요. 앱을 연속으로 열고 닫으면 요청이 중복될 수 있습니다.
Update On Open과 Settings → On Demand는 서로 다른 설정입니다. 전자는 구독을 새로고침하고, 후자는 조건에 따라 VPN 연결을 시작합니다. On Demand를 켜도 구독 다운로드 실패가 해결되지 않으며, 구독 업데이트를 위해 끌 필요도 없습니다. 문제와 관련된 설정만 한 번에 하나씩 바꿔야 변경 원인을 파악할 수 있습니다.
새로고침 처리 과정 이해하기
‘구독 주소 요청’ 단계에서는 도메인 이름 확인, 연결 설정, HTTPS 주소에 필요한 TLS 협상이 이뤄져야 합니다. 도메인 확인 실패, 네트워크 연결 불가, 인증서 검증 실패가 발생하면 이후 파싱 단계까지 진행되지 않습니다. 이때 Home에 있는 특정 연결 항목의 프로토콜 매개변수를 바꾸는 것은 구독 요청 자체를 해결하는 방법이 아닙니다.
‘응답 수신’이 끝난 뒤에는 내용도 확인해야 합니다. HTTP 200은 서버가 성공 응답을 보냈다는 뜻일 뿐, 본문이 인식 가능한 구독 형식이라는 보장은 없습니다. 서비스 제공업체 로그인 페이지, 웹 인증 페이지, 빈 본문도 정상적으로 다운로드될 수 있습니다. 반대로 HTTP 401, 403, 404는 접근 권한이나 경로 문제를 파악할 단서이므로, DNS를 바로 바꾸기보다 링크부터 확인하세요.
핵심: 먼저 실패 단계를 찾으세요
시간 초과라면 네트워크와 연결 가능성을 먼저 확인하고, 401·403·404라면 서비스 제공업체 링크를 확인하세요. 요청은 성공했지만 항목이 없다면 응답 내용과 구독 형식을 살펴보세요. 단계별로 점검하면 네트워크, 구성, 구독을 한꺼번에 변경하는 일을 피할 수 있습니다.
안내에 따라 실패 원인 확인
아래에는 흔히 표시되는 영문 네트워크 오류와 HTTP 상태를 정리했습니다. 구체적인 안내 문구와 표시 방식은 시스템 및 인터페이스에 따라 다를 수 있으므로 실제로 표시된 문구를 그대로 기록하세요. 오류 하나만으로 계정 만료나 서버 장애를 단정할 수는 없습니다.
오류: The request timed out.
원인: 제한 시간 안에 요청이 완료되지 않았습니다. 현재 네트워크, 접속 경로, 구독 서버 응답이 원인일 수 있습니다.
해결: 연속 새로고침을 멈추고, 사용 가능한 Wi-Fi와 셀룰러 네트워크에서 각각 한 번씩 다시 시도하세요. 한 네트워크에서만 실패한다면 해당 네트워크의 도메인 확인 및 접속 제한을 먼저 살펴보세요.
오류: Could not connect to the server.
원인: 클라이언트가 대상 서버와 연결을 설정하지 못했습니다. 주소, 포트, 네트워크 연결 가능성, 서버 상태가 원인일 수 있습니다.
해결: URL의 도메인과 명시된 포트가 빠짐없이 입력됐는지 확인한 뒤, 구독 서버에 접속할 수 있는지 서비스 제공업체에 문의하세요. 임의로 대체 도메인을 추측하지 마세요.
상태: HTTP 401 Unauthorized
원인: 구독 서버가 현재 요청의 인증 정보를 거부했습니다. token이 유효하지 않거나 다시 인증해야 할 수 있습니다.
해결: 서비스 제공업체에서 현재 유효한 전체 링크를 받아 기존 구독 URL을 교체한 뒤 새로고침하세요. 매개변수의 일부 문자만 임의로 바꾸지 마세요.
상태: HTTP 403 Forbidden
원인: 서버가 접근을 거부했습니다. 계정 상태, 접속 제한, 요청 빈도 등이 원인일 수 있으며 이 상태만으로 구독이 만료됐다고 단정할 수는 없습니다.
해결: 잦은 재시도를 멈추고 서비스 제공업체에 권한과 접속 제한을 확인하세요. 오류 상태와 발생 시각은 민감한 정보를 가려서 전달합니다.
상태: HTTP 404 Not Found
원인: 서버에 요청한 경로가 없습니다. 링크가 일부만 복사됐거나 기존 구독 경로가 변경됐을 수 있습니다.
해결: 전체 구독 링크를 다시 받아 경로와 쿼리 매개변수를 확인하세요. 홈페이지 주소에 경로를 덧붙여 구독 주소를 만들지 마세요.
인증서 관련 오류가 발생하면 먼저 기기의 날짜와 시간이 올바른지 확인한 다음, 도메인이 서비스 제공업체가 안내한 주소와 일치하는지 살펴보세요. 인증서 검증을 끄는 방법으로 문제를 감추지 마세요. 다른 HTTPS 서비스에는 접속되는데 이 구독만 실패한다면 도메인과 오류 안내를 서비스 제공업체에 전달해 인증서와 서비스 상태를 확인하세요.
형식 변경 및 빈 목록
네트워크 요청은 완료됐지만 파싱 실패, 빈 그룹, 항목 누락이 발생한다면 구독 내용이 바뀌었는지 확인하세요. 서비스 제공업체가 출력 형식을 조정하거나 구독 경로를 변경했을 수도 있고, 기존 경로에서 계정 안내 페이지를 반환할 수도 있습니다. 웹페이지가 열린다고 해서 본문이 Shadowrocket 구독 형식에 맞는 것은 아닙니다. 브라우저에서 열리는 HTML 페이지를 연결 구독으로 다시 가져오지 마세요.
| 확인할 현상 | 우선 확인할 내용 | 다음 단계 |
|---|---|---|
| 성공 안내가 표시되지만 항목은 그대로임 | 서비스 제공업체가 실제로 변경 사항을 배포했는지 | 이름이 바뀌었거나 새로 추가된 항목을 확인하고, 전체 개수만 기준으로 삼지 마세요. |
| 로그인 페이지나 인증 페이지가 표시됨 | 계정 웹페이지 주소를 복사한 것은 아닌지 | 클라이언트에서 사용할 구독 링크를 서비스 제공업체에서 받으세요. |
| 이전에는 사용할 수 있었지만 이제 파싱 실패 | 서비스 제공업체가 형식이나 경로를 변경했는지 | 현재 적용되는 구독 출력 형식을 확인하고, 기존 그룹 정보를 기록한 뒤 URL을 변경하세요. |
| 일부 항목만 누락됨 | 서비스 제공업체가 항목을 삭제했거나 필드를 변경했는지 | 민감한 정보를 가린 변경 내용을 서비스 제공업체에 전달해 출력을 확인받으세요. 자격 정보를 임의로 추측해 입력하지 마세요. |
‘구독을 삭제한 뒤 다시 추가하기’를 첫 번째 해결 방법으로 삼지 마세요. 삭제하면 기존 그룹을 비교 대상으로 사용할 수 없고 현재 선택된 항목에도 영향을 줄 수 있습니다. 먼저 구독 이름, 오류 원문, 변경 사항을 기록한 다음 주소를 교체할지 결정하세요. 다시 추가해야 한다면 새 그룹이 정상적으로 생성되고 사용할 수 있는지 확인한 뒤 중복 항목을 정리합니다.
업데이트 후 연결 확인
새로고침이 끝난 뒤에도 웹페이지에 접속할 수 없다면 구독 문제와 연결 문제를 나눠서 확인하세요. Home에 새 항목이 표시돼도 아직 선택되지 않았을 수 있고, 기존에 선택한 항목이 서비스 제공업체에 의해 삭제됐을 수도 있습니다. 현재 구독에 남아 있는 항목을 선택해 연결 및 실제 접속을 확인한 다음 DNS나 규칙을 점검하세요. 지연 시간 결과만으로 판단하지 마세요.
- 현재 선택 확인: Home에서 현재 연결 항목이 업데이트한 대상 구독에 속하는지 확인하세요. 이름이 같은 이전 그룹과 혼동하지 않도록 주의합니다.
- 라우팅 설정 확인: Global Routing을 확인하세요. Config는 구성 규칙에 따라 요청을 처리하고, Proxy와 Direct는 전체 라우팅을 다르게 선택하는 방식입니다. 구독을 새로고침해도 이 설정이 자동으로 바뀌지는 않습니다.
- 실제 접속 확인: 평소 접속하려는 서비스를 이용해 확인하세요. 지연 시간 테스트가 성공해도 DNS, TLS, 페이지 요청이 모두 성공했다는 뜻은 아닙니다.
- 문의 정보 준비: 네트워크 유형, 발생 시각, 오류 원문, 실패 단계를 기록하세요. token, 비밀번호, 전체 구독 주소를 가린 뒤 서비스 제공업체에 문의합니다.
평소에는 Update On Open을 켜 두면 변경 내용을 편리하게 확인할 수 있으며, 서비스 제공업체에서 변경 안내를 받으면 수동으로 한 번 새로고침하세요. 업데이트가 자주 실패한다면 앱을 반복해서 재설치하기보다 주소가 유효한지, 네트워크에 연결할 수 있는지, 응답 내용을 파싱할 수 있는지 순서대로 확인하는 편이 효과적입니다. Shadowrocket은 노드나 구독을 제공·판매·추천하지 않습니다. 이 안내는 사용자가 이미 자신의 서비스 제공업체와 구독을 보유한 경우를 전제로 합니다.