이 글은 이미 이용 중인 서비스 제공업체와 구독이 있는 사용자를 위한 안내입니다. 먼저 Home에서 수동으로 업데이트해 결과를 확인한 다음, 앱을 열 때 자동 업데이트하도록 설정합니다. 실패하면 주소, 네트워크, HTTP 응답, 콘텐츠 형식을 차례로 점검하세요. 구독은 이용 중인 서비스 제공업체에서 받습니다. 업데이트 성공은 구독 내용을 읽었다는 뜻일 뿐, 구독에 포함된 모든 연결이 작동한다는 의미는 아닙니다.
구독 업데이트와 연결의 차이
Shadowrocket의 구독은 주소를 통해 서버 구성을 가져오는 방식입니다. 구독을 업데이트하면 해당 주소에 다시 요청을 보내고, 응답 내용에 따라 구독 그룹을 갱신합니다. 앱 자체를 업데이트하거나 Config 파일을 업데이트하는 것과는 다릅니다. 개별적으로 추가한 서버 구성은 구독에 연결되어 있지 않으므로 아래로 당겨 새로고침해도 서비스 제공업체에서 새 주소, 포트 또는 인증 정보를 가져오지 않습니다.
각 단계에서 발생할 수 있는 오류는 다릅니다. 주소가 잘못되면 접속할 수 없고, 네트워크가 연결되지 않으면 요청 시간이 초과될 수 있습니다. 서버가 정상적으로 응답하더라도 로그인 페이지가 반환되면 구독으로 파싱할 수 없습니다. 따라서 Home에 이전 항목이 남아 있다는 이유만으로 이번 업데이트가 성공했다고 판단해서는 안 됩니다. 문제를 확인할 때는 새로고침 알림, 구독 그룹의 내용, 서비스 제공업체가 안내한 변경 사항을 함께 살펴보세요.
Home에서 수동으로 업데이트하기
자동 업데이트를 켜기 전에 수동으로 업데이트해 결과를 확인하세요. 이렇게 하면 업데이트 실행 방식이 작동하지 않은 경우와 구독 요청 자체가 실패한 경우를 구분할 수 있습니다. 이미 구독 그룹이 있다면 아래 두 번째 단계부터 진행하고, 같은 주소를 다시 추가하지 마세요.
-
구독 확인
Home에서 해당 구독 그룹이 있는지 확인합니다. 처음 추가하는 경우 Home으로 이동해 오른쪽 위의 “+” → Type → Subscribe를 선택하고, 서비스 제공업체에서 받은 전체 구독 주소를 입력한 뒤 저장하고 Home으로 돌아옵니다.
-
아래로 당겨 업데이트
Home 목록 상단을 아래로 당겨 새로고침합니다. 앱을 화면에 띄운 상태로 새로고침이 끝날 때까지 기다리세요. 연속해서 아래로 당기거나 요청 중에 네트워크를 반복해서 바꾸지 마세요.
-
결과 확인
새로고침이 끝난 뒤 표시되는 알림을 확인하고 해당 그룹을 살펴보세요. 서비스 제공업체가 항목 추가, 삭제 또는 이름 변경을 안내했다면 관련 항목을 확인합니다. 원격 콘텐츠에 변경 사항이 없다면 업데이트에 성공해도 목록이 그대로일 수 있습니다.
-
연결은 별도로 테스트
업데이트 성공을 확인한 뒤 사용할 서버를 선택해 실제 접속을 테스트하세요. ‘구독 업데이트 성공 여부’와 ‘서버 연결 성공 여부’를 따로 기록하면 연결 실패를 구독 오류로 오해하지 않을 수 있습니다.
구독이 여러 개라면 알림이 어느 그룹에 해당하는지 확인하세요. 한 그룹의 업데이트 성공을 다른 그룹도 업데이트되었다는 근거로 삼으면 안 됩니다. 업데이트 과정에서 서비스 제공업체가 관리하는 항목이 바뀔 수 있으므로, 계속 보관해야 할 개인 수정 사항을 구독으로 생성된 항목에만 저장하지 마세요. 수정하기 전에 필요한 정보를 기록해 두세요.
앱 실행 시 자동 업데이트 설정
설정 경로는 Settings → Subscribe → Update On Open입니다. 이 옵션을 켜면 설정에 따라 앱을 열 때 구독 업데이트를 시도합니다. 이 기능은 구독 콘텐츠를 가져오는 설정이지, 시스템 VPN을 자동으로 연결하는 설정이 아닙니다. Settings → On Demand는 조건에 따른 연결을 설정하며, 두 기능은 서로 다른 옵션입니다.
- 먼저 Home에서 수동으로 새로고침해 현재 주소를 정상적으로 읽을 수 있는지 확인합니다.
- Settings → Subscribe로 이동해 Update On Open을 찾아 켭니다.
- 앱을 닫았다가 다시 열고 Home에서 새로고침 상태와 업데이트 결과를 확인합니다. 항목 수가 바뀌었는지만 보고 업데이트 요청 여부를 판단하지 마세요.
- 수동 업데이트는 성공했는데 자동 업데이트 결과가 예상과 다르면 옵션이 계속 켜져 있는지 확인하고, 당시 사용한 네트워크와 앱을 연 방식을 기록하세요.
‘앱을 열 때’ 업데이트한다는 뜻이지 앱이 백그라운드에서 계속 요청을 보내거나 화면이 잠긴 뒤 일정한 간격으로 업데이트한다는 의미는 아닙니다. 백그라운드 실행은 시스템이 별도로 관리합니다. 구독 상태를 바로 확인하려면 Home에서 수동으로 새로고침하는 편이 확실합니다. 자동 업데이트 중 네트워크 또는 인증 오류가 발생하면 아래 안내에 따라 점검해야 합니다. 이 옵션을 켜도 유효하지 않은 주소가 해결되지는 않습니다.
주소와 인증 상태 먼저 확인
구독 주소에는 인증 정보가 포함되는 경우가 많습니다. 복사할 때 물음표 뒤의 내용을 잘라내지 말고 쿼리 매개변수를 포함한 전체 주소를 유지하세요. 구독 안내 페이지 주소를 구독 API 주소로 착각하지 않도록 주의하세요. 아래 예시는 주소 구조를 설명하기 위한 가상의 값이며 실제로 사용할 수 없으니 가져와서 테스트하지 마세요.
https://example.com/sub?token=xxxx- 전체 주소 확인: 주소 앞뒤에 공백, 줄바꿈 또는 메신저 앱이 덧붙인 문장 부호가 있는지 확인하세요. 복잡해 보이는 매개변수도 임의로 삭제하지 마세요.
- 출처 확인: 계정 홈, 결제 페이지 또는 공지 페이지 주소가 아니라 서비스 제공업체에서 받은 Shadowrocket용 구독 주소를 사용하세요.
- 유효 기간 확인: 서비스 제공업체에 문의해 구독 권한이 유효한지, 주소가 재설정되었는지, 요청 횟수 제한이 있는지 확인하세요.
- 주소 변경 여부 확인: 서비스 제공업체가 token을 재설정했다면 기기에 저장된 구독 주소도 새 주소로 바꿔야 합니다. 앱을 다시 열어도 이전 token이 새 token으로 자동 변경되지는 않습니다.
오류에 HTTP 상태 코드가 표시되면 아래 세 가지 경우를 기준으로 원인을 좁혀 보세요. 상태 코드는 요청 처리 결과만 나타내며 구독 형식이 올바른지는 알려주지 않습니다. 특히 200이 표시되어도 앱에서 콘텐츠를 성공적으로 파싱했는지 확인해야 합니다.
네트워크 오류 및 요청 실패 해결
아래는 네트워크 요청에서 표시될 수 있는 영문 오류 메시지입니다. 실제 표시는 사용 중인 인터페이스와 시스템 응답에 따라 달라질 수 있습니다. 문제를 확인할 때는 실제 오류 메시지를 그대로 기록하고 모든 실패를 ‘업데이트 안 됨’으로 뭉뚱그리지 마세요. 한 번에 조건 하나만 바꾼 뒤 수동으로 새로고침하면 어떤 단계가 영향을 주었는지 파악하기 쉽습니다.
오류: The request timed out.
원인: 제한 시간 안에 요청이 완료되지 않았습니다. 현재 네트워크 또는 구독 서버의 응답 문제일 수 있습니다.
해결 방법: 먼저 일반 웹페이지가 정상적으로 열리는지 확인한 뒤 Wi-Fi와 셀룰러 네트워크를 바꿔 가며 테스트하세요. 두 네트워크에서 모두 시간이 초과되면 서비스 제공업체에 구독 API 상태를 문의하세요.
오류: A server with the specified hostname could not be found.
원인: 구독 도메인을 확인할 수 없습니다. 도메인 철자가 틀렸거나 네트워크 DNS에 문제가 있거나 서버 도메인이 변경되었을 수 있습니다.
해결 방법: 원래 주소의 도메인을 확인한 뒤 다른 네트워크에서 다시 시도하세요. 그래도 실패하면 서비스 제공업체에 현재 주소가 유효한지 문의하세요.
오류: Could not connect to the server.
원인: 대상 서버에 연결하지 못했습니다. 서버가 중단되었거나 포트에 접속할 수 없거나 네트워크 접근이 제한되었을 수 있습니다.
해결 방법: 주소는 바꾸지 말고 네트워크별 결과를 비교하세요. 해당 구독에서만 실패한다면 민감한 정보를 가린 오류 메시지를 서비스 제공업체에 보내 확인을 요청하세요.
기기 시스템 시간이 크게 틀리면 HTTPS 요청에서 인증서 오류가 발생할 수 있습니다. 먼저 기기의 시스템 설정에서 날짜와 시간을 확인하세요. 인증서 검증을 무시하는 방식으로 구독 오류를 해결하지 마세요. 주소에서 HTTPS 포트는 보통 443입니다. 서비스 제공업체가 다른 포트를 명시한 경우가 아니라면 임의로 포트 번호를 추가하거나 변경하지 마세요.
- 현재 연결이 완전히 끊긴 상태라면 먼저 기기 자체의 네트워크를 복구한 뒤 구독 요청을 테스트하세요.
- 연결된 상태에서는 업데이트에 실패하고 연결을 끊으면 성공한다면 그 차이를 기록하고 현재 라우팅과 연결 상태를 확인하세요. 바로 구독을 삭제할 필요는 없습니다.
- Global Routing의 Proxy, Direct, Config, Scene은 라우팅 모드를 선택하는 옵션이지 구독 형식 설정이 아닙니다. 모드를 바꿔도 만료된 token이나 호환되지 않는 콘텐츠는 해결되지 않습니다.
- HTTP 429가 표시되면 연속해서 새로고침하지 말고 서비스 제공업체의 안내에 따라 기다린 뒤 다시 시도하세요. 요청 횟수 제한이 더 강화되는 것을 방지할 수 있습니다.
잘못된 형식, 빈 목록, 이전 항목
네트워크 요청이 완료된 뒤에도 가져오기에 실패할 수 있습니다. API가 앱에서 인식할 수 있는 구독 데이터 대신 HTML 로그인 페이지, 인증 페이지, 오류 안내 또는 빈 콘텐츠를 반환하는 경우가 대표적입니다. 브라우저에서 페이지가 열린다고 해서 유효한 구독이라고 판단하지 마세요. 브라우저에는 로그인 상태가 저장되어 있을 수 있어 앱의 요청과 조건이 다를 수 있습니다.
| 확인된 현상 | 우선 점검할 항목 | 다음 단계 |
|---|---|---|
| 응답은 있지만 파싱할 수 없음 | 응답이 로그인 페이지 또는 오류 페이지인지 확인 | Shadowrocket에 맞는 구독 API 주소인지 확인 |
| 새로고침 후 사용할 수 있는 항목이 없음 | 원격 응답이 빈 목록인지 인증 안내인지 확인 | 서비스 제공업체에 구독 콘텐츠와 계정 상태 문의 |
| 서비스 제공업체가 이름을 바꿨는데도 이전 이름이 표시됨 | 이번 업데이트가 실제로 성공했는지, 올바른 그룹을 확인했는지 점검 | 해당 구독 주소와 새로고침 결과를 확인한 뒤 항목 비교 |
| 목록은 업데이트되었지만 연결 실패 | 서버 주소, 포트, 인증 정보, 현재 네트워크 확인 | 연결 문제 진단으로 넘어가고 구독 새로고침은 반복하지 않기 |
Type → Subscribe는 구독 주소를 통해 구성 목록을 가져오는 항목입니다. 여기에서 Shadowsocks, VMess, VLESS, Trojan, Hysteria2 또는 WireGuard를 선택하는 것이 아닙니다. 사용할 프로토콜과 연결 정보는 구독 콘텐츠에 따라 결정됩니다. 서비스 제공업체가 여러 형식의 주소를 제공한다면 Shadowrocket에 맞는 주소가 무엇인지 문의하세요. 형식을 추측해 주소 끝부분만 바꾸지 마세요.
형식 문제를 확인하려고 모든 항목을 바로 지우지도 마세요. 먼저 오류 정보를 저장하고 전체 구독 주소가 유효한지 확인한 뒤 해당 구독을 교체할지 결정하세요. 기존 그룹을 삭제한 후 새 주소까지 사용할 수 없으면 이전 정보도 사라져 결과를 비교하기 어려워집니다.
결과 확인 및 문의 정보 정리
문제 해결을 마친 뒤 Home으로 돌아가 수동으로 한 번 더 업데이트하고 결과를 세 가지로 구분하세요. 요청 실패, 요청은 완료되었지만 파싱 실패, 파싱은 성공했지만 연결 실패입니다. 문제가 발생한 단계를 파악한 다음 네트워크를 점검할지, 서비스 제공업체에 구독을 문의할지, 연결 진단을 계속할지 결정하세요.
- 작업 경로 기록: 예를 들어 Home에서 아래로 당겨 새로고침했는지, Settings → Subscribe → Update On Open을 켠 뒤 앱을 다시 열었는지 기록하세요.
- 오류 메시지 기록: HTTP 상태 코드나 시스템 네트워크 오류를 그대로 남기세요. 스크린샷을 찍기 전에는 전체 구독 주소, token, 비밀번호, 개인 계정 정보를 가리세요.
- 네트워크 환경 기록: Wi-Fi와 셀룰러 네트워크 중 어떤 환경에서 발생했는지, 연결이 이미 설정된 상태였는지, 네트워크를 바꾼 뒤에도 결과가 같았는지 기록하세요.
- 목록 변경 사항 기록: 모든 구독에서 실패했는지 특정 그룹에서만 실패했는지, 서비스 제공업체가 예고한 변경 사항이 반영되었는지 기록하세요.
token이 포함된 구독 주소를 공개 댓글이나 공개 진단 페이지에 보내지 마세요. 문의할 때는 민감한 정보를 가린 도메인과 오류 내용을 먼저 전달하세요. 전체 인증 정보가 필요하다면 서비스 제공업체가 지정한 비공개 지원 채널을 이용하세요. 수동 업데이트가 안정적으로 성공한 뒤에는 Update On Open을 평소 설정으로 사용하되, 실제 사용 중 문제가 생기면 새로고침 결과를 다시 확인하세요.