Shadowrocket에 본인의 구독을 이미 추가한 사용자를 위한 안내입니다. ‘구독 확인 → 수동 업데이트 → Update on Open 활성화 → 응답에 따른 문제 해결’ 순서로 진행하면 됩니다. 구독 목록을 가져오지 못한 경우와 연결 실패를 구분하고, 수동 업데이트로 결과를 확인하는 방법도 다룹니다.
구독 업데이트 대상과 사전 확인 사항
Shadowrocket은 Apple 플랫폼에서 유료로 제공되는 클라이언트이며, App Store에서만 받을 수 있습니다. 개발자는 Shadow Launch Technology Limited이고 앱 ID는 932747118입니다. 앱은 일회성 구매 방식이며, 시스템 요구 사항과 통합 구매 정보는 App Store 페이지를 확인하세요. 앱 구매와 회선 요금제는 별개입니다. 이 글은 이미 본인의 서비스 제공업체와 구독을 보유한 경우를 전제로 합니다.
구독 업데이트는 저장된 구독 URL에 다시 요청을 보내고 응답에서 노드 정보를 가져오는 작업입니다. 앱 자체를 업데이트하는 것이 아니며, Config의 규칙 설정을 업데이트하는 것과도 다릅니다. Home의 구독 그룹, 직접 추가한 개별 노드, Config에서 사용하는 구성 파일은 각각 따로 확인해야 합니다. 목록을 한 번 새로 고쳤다고 모든 항목이 동기화된 것은 아닙니다.
새로 고치기 전에 어떤 그룹을 조작하는지 확인하고 현재 선택된 노드 이름을 기록해 두세요. 업데이트 후 노드 이름이나 매개변수가 바뀌거나 노드가 삭제될 수 있습니다. 목록이 크게 달라졌다면 노드를 다시 선택하세요. 본인의 구독 원본 주소는 안전하게 보관하되 전체 URL을 공개 게시판에 올리지 마세요. 쿼리 매개변수의 토큰은 보통 접근 인증 정보로 사용됩니다.
- 구독 그룹이 있는 경우: Home에서 그룹 이름을 찾고 저장된 URL이 서비스 제공업체가 현재 안내하는 주소인지 확인합니다.
- 개별 노드만 있는 경우: 직접 추가한 노드는 다른 구독을 새로 고쳐도 자동으로 업데이트되지 않습니다. 노드의 출처와 업데이트 방법을 확인하세요.
- 규칙 구성만 있는 경우: Config의 구성 업데이트와 Home의 구독 업데이트는 서로 다른 작업입니다. 먼저 필요한 것이 노드인지 규칙인지 확인하세요.
수동 업데이트: 단일 그룹을 확인한 뒤 목록 새로 고침
수동 업데이트는 처음 구독을 추가한 뒤 내용을 확인하거나, 서비스 제공업체의 노드 변경 안내를 반영하거나, 자동 업데이트 실패 후 다시 확인할 때 유용합니다. 먼저 구독 그룹 하나만 업데이트하면 문제 범위를 해당 URL로 좁힐 수 있습니다. 여러 그룹을 한꺼번에 새로 고친 경우에는 각 결과를 따로 확인하세요. 한 그룹의 성공을 전체 성공으로 간주하면 안 됩니다.
- Home을 열고 업데이트할 구독 그룹을 찾은 다음 그룹 이름과 현재 노드 수를 기록합니다.
- 구독 그룹 제목을 길게 누르고 작업 메뉴에서 Update를 선택한 뒤 요청이 끝날 때까지 기다립니다. 노드 항목이 아니라 그룹을 선택해야 합니다.
- 구독 목록을 새로 고치려면 Home 목록을 아래로 당겨 업데이트를 실행할 수 있습니다. 구독이 여러 개라면 각 그룹에 결과가 반영됐는지 따로 확인하세요.
- 업데이트 후 대상 그룹을 펼쳐 예상한 노드가 표시되는지, 기존 이름이 바뀌었는지 확인하고 현재 선택된 노드도 다시 살펴보세요.
- 오류가 표시되면 오류 문구와 발생 시각을 먼저 기록한 다음 아래 안내에 따라 주소, 네트워크 경로, 응답 형식을 확인하세요. 연속해서 버튼을 누르지는 마세요.
노드 수가 그대로여도 업데이트가 실행되지 않았다는 뜻은 아닙니다. 서버가 이전과 같은 내용을 반환했을 수 있습니다. 반대로 노드 수가 늘었다고 노드가 정상적으로 작동하는 것도 아닙니다. 올바른 확인은 두 단계로 나뉩니다. 먼저 구독 요청이 성공하고 응답을 해석할 수 있는지 확인한 뒤, 노드를 선택해 실제 접속을 테스트하세요. 두 단계는 서로 다른 문제를 확인하므로 따로 기록해야 합니다.
앱 실행 시 자동 업데이트: 설정 위치와 작동 조건
Settings → Subscribe로 이동해 Update on Open을 켭니다. 이 옵션은 앱을 열 때 구독 업데이트를 실행하는 기능입니다. 앱을 닫은 뒤에도 일정한 분 간격으로 계속 확인하는 기능은 아닙니다. 실제 요청 시점은 시스템의 백그라운드 작업 관리, 네트워크 상태, 앱 상태에 따라 달라질 수 있습니다.
- 먼저 Home에서 대상 구독을 수동으로 Update하고, 현재 URL이 인식 가능한 내용을 반환하는지 확인하세요.
- Settings → Subscribe → Update on Open으로 이동해 옵션을 켭니다.
- 앱을 닫았다가 다시 열고 Home으로 돌아가 구독 업데이트 결과를 확인하세요. 확인할 만한 결과가 보이지 않으면 대상 그룹을 수동으로 업데이트해 검증합니다.
- 앱을 열 때 네트워크에 연결되지 않았다면 Wi-Fi 또는 셀룰러 네트워크를 사용할 수 있을 때 다시 시도하세요. 자동 업데이트가 실행되지 않았는데도 목록이 동기화됐다고 가정하지 마세요.
Settings → On Demand는 조건에 따라 연결을 실행하는 설정이지 구독 자동 업데이트 스위치가 아닙니다. 두 기능은 각각 설정할 수 있습니다. On Demand를 켜도 Update on Open이 활성화되는 것은 아니며, 구독 자동 업데이트를 꺼도 On Demand가 비활성화되는 것은 아닙니다.
| 설정 또는 작업 | 대상 | 이 설정만으로 판단할 수 없는 내용 |
|---|---|---|
| Home → Update | 대상 구독의 노드 정보 | 업데이트 성공이 노드 연결 성공을 의미하지는 않음 |
| Settings → Subscribe → Update on Open | 앱을 열 때 업데이트 실행 | 일정한 간격으로 실행되는 백그라운드 작업이 아님 |
| Settings → Subscribe → Update via Proxy | 구독 요청의 프록시 경로 | 만료된 토큰이나 잘못된 형식을 해결하지 못함 |
| Settings → On Demand | 연결을 실행하는 조건 | 구독 업데이트 설정을 대신하지 않음 |
판단 기준: 수동 업데이트를 먼저 성공시킨 뒤 자동 실행 활성화
같은 URL을 수동으로 업데이트해도 실패한다면 오류 원인부터 해결하세요. Update on Open을 반복해서 켜고 꺼도 서버 응답이나 구독 내용은 바뀌지 않습니다.
구독 업데이트 실패: 주소, 네트워크, 형식을 차례로 확인
‘응답을 받지 못한 경우’와 ‘응답은 받았지만 사용할 수 없는 경우’를 먼저 구분하세요. 전자는 네트워크, DNS, 요청 경로를 우선 확인하고 후자는 접근 권한과 응답 형식을 먼저 확인합니다. 아래 카드에는 흔히 나타나는 HTTP 응답이나 시스템 오류 원문을 실었습니다. 실제 메시지에는 더 자세한 내용이 포함될 수 있으므로 전체 문구를 보관해 판단하세요.
응답: 401 Unauthorized
원인 및 해결 방법: 구독 엔드포인트에 필요한 인증 정보가 없거나 만료됐거나 허용되지 않은 상태입니다. 본인의 서비스 제공업체 계정에서 현재 구독 주소를 확인하고 전체 URL을 교체한 뒤 다시 업데이트하세요. 도메인 부분만 복사하면 안 됩니다.
응답: 403 Forbidden
원인 및 해결 방법: 서버가 요청을 거부했습니다. 계정 상태나 접근 정책이 원인일 수 있습니다. 본인의 서비스 제공업체에 거부 사유를 먼저 확인하세요. 네트워크만 바꿔서는 권한 제한이 해결되지 않을 수 있습니다.
응답: 404 Not Found
원인 및 해결 방법: 요청한 경로가 없거나 구독 주소가 변경됐습니다. URL이 잘리지 않았는지, 경로 전체가 포함됐는지 확인하고 계정에서 현재 사용 중인 주소를 다시 확인하세요.
오류: The request timed out.
원인 및 해결 방법: 제한 시간 안에 요청이 완료되지 않았습니다. 시간 초과만으로는 어느 구간에서 문제가 생겼는지 알 수 없습니다. 먼저 Wi-Fi와 셀룰러 네트워크를 바꿔 다시 확인한 뒤, 다음 절의 Update via Proxy 사용 조건을 살펴보세요.
명확한 HTTP 오류 없이 업데이트 후 목록이 비어 있다면 서버가 실제로 어떤 응답을 반환했는지 확인하세요. 로그인 페이지, 계정 안내, 웹 인증 페이지, 빈 응답은 노드 구독으로 바로 해석할 수 없습니다. 상태가 200 OK여도 HTTP 요청에 성공 응답을 받았다는 뜻일 뿐, 내용이 Shadowrocket에서 인식할 수 있는 구독 형식이라는 뜻은 아닙니다.
- 주소 확인: URL의 앞뒤에 공백, 줄바꿈, 불필요한 문장 부호가 들어갔는지 확인하세요. 쿼리 매개변수의 문자를 임의로 바꾸지 마세요.
- 형식 확인: 본인의 서비스 제공업체가 제공하는 구독 옵션에서 Shadowrocket에 맞는 응답 형식을 선택했는지 확인하세요. 계정 관리 페이지 주소를 구독 URL로 입력하지 마세요.
- 응답 확인: 도움을 요청할 때는 상태 코드, 오류 문구, 발생 시각을 전달하세요. 전체 구독 URL, 토큰, 노드 인증 정보는 공개하지 마세요.
Update via Proxy: 업데이트 경로의 순환 의존 방지
직접 연결로 구독 엔드포인트에 접근할 수 없지만 기존 노드는 정상적으로 연결된다면 Settings → Subscribe → Update via Proxy로 이동해 이 옵션을 켠 뒤 수동으로 다시 업데이트할 수 있습니다. 사용하기 전에 현재 연결로 네트워크에 접속할 수 있는지 확인하세요. 사용할 수 있는 프록시 연결 없이 옵션만 켜서는 새로운 접근 경로를 만들 수 없습니다.
구독 링크가 https를 사용하고 포트를 명시하지 않는다면 일반적으로 TCP 443에 연결합니다. 노드가 사용하는 포트는 해당 노드 설정에 따라 정해지므로 둘 사이에 반드시 연관이 있는 것은 아닙니다. 업데이트 엔드포인트의 HTTPS 요청이 시간 초과됐다고 해서 노드 포트를 바꿀 필요는 없습니다. 오류를 우회하려고 인증서 확인을 끄지 마세요.
- Home에서 이미 추가된 사용 가능한 노드를 선택하고 연결을 켠 뒤 일반 웹페이지에 접속할 수 있는지 먼저 확인하세요.
- 현재 Home → Global Routing 옵션을 확인하세요. Proxy, Direct, Config, Scene은 서로 다른 라우팅 방식입니다. 기존 설정을 기록하지 않은 채 여러 옵션을 한꺼번에 바꾸지 마세요.
- Settings → Subscribe → Update via Proxy를 켠 다음, 실패한 구독만 Update를 한 번 더 실행하고 결과가 달라졌는지 기록합니다.
- 여전히 실패하면 다른 네트워크로 바꿔 비교하세요. 응답이 401 또는 403이라면 라우팅 설정을 계속 바꾸기보다 인증 정보와 접근 권한을 확인해야 합니다.
업데이트 확인과 자주 묻는 질문
구독 동기화가 완료되면 Home으로 돌아가 현재 노드를 확인하고 필요한 대상에 접속해 보세요. Config 라우팅 방식을 사용한다면 요청 처리 방식은 현재 활성화된 구성의 규칙에도 영향을 받습니다. 구독을 업데이트해도 Global Routing 방식이 자동으로 바뀌지 않으며 특정 도메인이 반드시 프록시를 통해 나간다고 보장하지 않습니다.
자동 업데이트를 켰는데 앱을 열어도 노드가 그대로인 이유는 무엇인가요?
서버에서 노드 정보가 바뀌지 않았거나 이번 요청이 완료되지 않았을 수 있습니다. Home에서 대상 그룹을 수동으로 Update하고 오류가 있는지 확인한 다음 변경될 것으로 예상한 노드의 이름을 확인하세요. 목록의 노드 수만으로 판단하지 마세요.
구독 업데이트는 성공했는데 연결할 수 없는 이유는 무엇인가요?
업데이트 성공은 구독을 가져와 내용을 해석했음을 확인한 것입니다. 노드를 다시 선택하고 연결 스위치와 Global Routing 설정을 확인한 뒤 네트워크 접속을 따로 테스트하세요. 노드 설정이나 계정 상태에 문제가 있다면 본인의 서비스 제공업체에 문의하세요.
Update via Proxy를 계속 켜 두어야 하나요?
구독 엔드포인트에 실제로 접근할 수 있는 경로에 따라 결정하세요. 직접 연결이 안정적이면 직접 연결을 사용하면 됩니다. 프록시 경로로만 접근할 수 있다면 기존 연결이 작동하는지 확인한 뒤 업데이트하세요. 설정을 바꾸기 전과 후에 각각 수동으로 확인하고 요청이 안정적으로 완료되는 설정을 유지하세요.
구독 주소를 바꾸면 기존 그룹을 모두 삭제해야 하나요?
먼저 기존 그룹의 편집 화면에서 주소를 확인하고 교체한 뒤 저장하고 Update를 실행하세요. 별도로 가져와 중복 그룹이 생겼다면 새 그룹이 정상적으로 작동하는지 확인한 다음 기존 그룹을 정리하세요. 보관해야 할 개별 노드까지 함께 삭제하지 않도록 주의하세요.
추가로 문제를 확인할 때는 대상 그룹, 작업 시각, 사용 중인 네트워크, Update via Proxy 상태, 전체 오류 문구의 다섯 가지를 기록하세요. 한 번에 조건 하나만 바꾸고 수동 업데이트를 다시 실행합니다. 이를 통해 주소 만료, 경로 차단, 응답 형식 문제를 구분하고 노드 연결 오류를 구독 업데이트 오류로 오인하지 않을 수 있습니다.