사용 중인 서비스와 구독이 있다면 먼저 Home에서 수동 업데이트를 실행하고 결과를 확인하세요. 그런 다음 필요에 따라 Settings → Subscribe → Update on Open을 켭니다. 업데이트에 실패하면 링크 인증, 네트워크 요청, 콘텐츠 해석 문제를 차례로 확인하고 기존 그룹을 먼저 삭제하지 마세요. 이 글에서는 업데이트 경로와 자동 업데이트의 작동 범위, 기존 설정을 유지하며 문제를 확인하는 방법을 설명합니다.
구독 업데이트와 연결 테스트는 무엇을 확인하나요?
Shadowrocket의 구독 업데이트는 저장된 구독 주소에 다시 요청을 보내고, 응답에 포함된 서버 항목을 앱에 불러오는 작업입니다. Shadowrocket 앱 자체를 업데이트하는 것도, 연결 테스트를 하는 것도 아닙니다. 서버 연결 여부는 항목의 설정값과 네트워크 환경, 사용 중인 서비스 상태에도 영향을 받습니다.
구독 주소는 요청을 보내는 경로이고, Home에 표시되는 서버 항목은 요청 결과입니다. Config에서 선택한 설정에는 규칙 등이 포함됩니다. 서버 구독을 업데이트한다고 모든 Config 내용이 동기화되는 것은 아닙니다. 마찬가지로 Global Routing을 바꿔도 구독이 다시 불러와지지 않습니다. 먼저 각 작업의 대상을 구분해야 문제가 발생한 단계를 찾을 수 있습니다.
요청과 해석이 모두 끝나야 목록의 변경 여부를 확인할 수 있습니다. 업데이트가 성공했는데 이름이나 항목 수가 그대로라면 원격 콘텐츠가 바뀌지 않았을 수 있습니다. 기존 항목이 남아 있다는 사실만으로 방금 요청이 성공했다고 볼 수도 없습니다. 앱에 표시된 업데이트 결과와 서비스에서 제공하는 현재 항목을 함께 확인하세요.
Home에서 기존 구독 수동 업데이트하기
처음 문제를 확인할 때는 수동 업데이트를 권장합니다. Home에서 한 번의 작업을 끝까지 진행해 결과를 확인하면, 네트워크 변경이나 규칙 수정, 구독 업데이트를 번갈아 시도하는 일을 줄일 수 있습니다. 이 글에서는 영어 인터페이스 용어를 사용합니다. 버튼 위치와 구체적인 안내는 현재 앱에 표시되는 내용을 기준으로 확인하세요.
-
그룹 확인
Home을 열고 구독 그룹을 찾습니다. 그룹 이름과 기존 항목을 먼저 확인해 수동으로 추가한 개별 서버를 구독으로 착각하지 않도록 하세요.
-
주소 확인
해당 구독의 편집 화면에서 URL을 확인합니다. 도메인, 경로, 쿼리 매개변수를 임의로 수정하지 마세요. 확인 후 Home으로 돌아가면 됩니다. 테스트를 위해 그룹을 먼저 삭제할 필요는 없습니다.
-
업데이트 실행
Home 목록 맨 위에서 아래로 당겼다가 놓아 구독을 새로 고칩니다. 구독이 여러 개라면 그룹별 결과를 따로 확인하세요. 한 그룹의 성공을 전체 구독의 성공으로 간주하지 마세요.
-
결과 확인
새로 고침이 끝날 때까지 기다린 뒤 안내 메시지를 기록하고, 대상 그룹을 펼쳐 이름과 항목 수를 확인합니다. 오류가 표시되면 기존 항목과 원래 안내 메시지를 보존한 채 뒤의 분류에 따라 문제를 확인하세요.
-
연결 별도 테스트
업데이트가 끝난 뒤 사용 중인 유효한 서버를 선택해 연결을 테스트합니다. 목록은 업데이트됐지만 연결에 실패한다면 서버 설정값, 서비스 상태 또는 네트워크 경로를 확인하세요.
아직 구독을 추가하지 않았다면 Home 오른쪽 위의 “+”를 누르고 Type에서 Subscribe를 선택합니다. URL에 기존 구독 주소를 붙여 넣은 뒤 저장하세요. 구독 추가와 기존 구독 새로 고침은 서로 다른 작업입니다. 기존 문제를 확인할 때 같은 주소를 반복해서 추가할 필요는 없습니다. 같은 이름의 그룹이 여러 개 생길 수 있습니다.
Update on Open의 의미와 사용 범위
Settings → Subscribe에서 Update on Open을 찾습니다. 이 옵션을 켜면 앱을 열 때 구독 업데이트를 시도하므로 매번 수동으로 새로 고칠 필요가 줄어듭니다. 정해진 간격으로 백그라운드에서 계속 확인하는 기능은 아니며, 원격 콘텐츠가 바뀌는 즉시 로컬 목록에 반영된다는 뜻도 아닙니다.
백그라운드에서 돌아온 직후 요청이 실행되는지는 목록 화면만 보고 판단할 수 없습니다. 당시 앱의 실행 상태를 고려하고 실제 업데이트 결과도 확인해야 합니다. 특정 주소에서 현재 정보를 가져올 수 있는지 확인하려면 앱을 앞뒤로 반복 전환하기보다 Home에서 직접 수동으로 새로 고치는 편이 결과를 확인하기 쉽습니다.
Settings → On Demand는 필요 시 연결 동작을 관리하며 구독 목록을 가져오는 작업과는 별개입니다. On Demand를 켜도 Update on Open을 대신하지 않으며, Update on Open을 켜도 연결이 자동으로 시작되는 것은 아닙니다. 자동 업데이트 문제를 확인할 때는 먼저 수동 업데이트가 완료되는지 확인한 다음 옵션 상태를 살펴보세요.
- 수동 업데이트 실패: 자동 업데이트 옵션을 반복해서 켜고 끄기보다 주소, 네트워크 또는 형식 문제를 먼저 해결하세요.
- 수동 업데이트 성공: 결과를 기록하고 다음에 앱을 열 때 업데이트 안내가 표시되는지 확인하세요.
- 앱을 열어도 목록이 그대로인 경우: 항목 수만 보고 자동 업데이트가 작동하지 않는다고 판단하지 말고 원격 콘텐츠가 실제로 바뀌었는지 먼저 확인하세요.
- 문제를 재현해야 하는 경우: 네트워크 환경과 작업 순서를 기록하고 한 번에 조건 하나만 바꾸세요.
링크 만료: URL과 인증 상태부터 확인
구독 주소에는 사용자를 식별하는 매개변수가 포함되는 경우가 많습니다. 주소를 일부만 복사하거나 오래된 주소를 사용하거나 서버에서 인증 정보가 초기화되면 가져오기에 실패할 수 있습니다. 아래는 구조를 보여 주는 예시일 뿐, 실제 서비스 주소가 아니며 연결에도 사용할 수 없습니다.
https://example.com/sub?token=xxxx확인할 때는 도메인만 보지 말고 전체 주소를 비교하세요. 예시의 ?token=xxxx는 쿼리 매개변수의 위치를 나타냅니다. 실제 주소는 경로와 매개변수 이름이 다를 수 있으므로 예시대로 수정하지 마세요. 특히 복사할 때 공백, 줄바꿈, 따옴표 또는 채팅 문장의 문장 부호가 들어갔는지 확인하세요.
| 확인 대상 | 확인할 수 있는 증상 | 조치 방법 |
|---|---|---|
| 전체 URL | 도메인은 맞지만 경로나 매개변수가 빠짐 | 사용 중인 구독 관리 페이지에서 전체 주소를 다시 복사하세요. |
| 접근 인증 정보 | 기존 주소가 작동하지 않고 서버에서 새 주소가 발급됨 | 주소를 확인한 뒤 기존 구독의 URL을 교체하고 수동으로 새로 고치세요. |
| HTTP 401 | 인증이 필요하다는 응답 또는 기존 인증 정보를 거부하는 응답 | 주소의 접근 권한이 여전히 유효한지 확인하세요. 인증 정보를 고치려고 규칙을 수정하지 마세요. |
| HTTP 403 | 서버에서 접근을 거부함 | 서비스 제공업체에 접근 권한과 제한 조건을 확인하세요. |
| HTTP 404 | 요청 경로에 해당하는 리소스를 찾을 수 없음 | 경로가 맞는지, 주소가 변경됐는지 확인하세요. 곧바로 네트워크 연결이 끊겼다고 단정하지 마세요. |
HTTP 상태 코드는 안내 메시지나 진단 정보에 실제로 표시된 경우에만 판단 근거로 사용하세요. 모든 ‘업데이트 실패’를 주소 만료로 볼 수는 없습니다. 브라우저에서 웹사이트 홈이 열린다고 구독 URL이 유효하다는 뜻은 아닙니다. 홈 페이지와 구독 API는 서로 다른 리소스이며 접근 조건도 다를 수 있습니다.
시간 초과 및 연결 실패: 요청 단계별로 확인
네트워크 오류는 가능한 한 원문을 보존하세요. 아래는 시스템 네트워크 오류에 표시될 수 있는 영어 문구입니다. 실제 문구와 표시 방식은 앱 안내를 기준으로 확인하세요. 실패할 때마다 같은 문구가 표시되는 것은 아닙니다. 여러 설정을 한꺼번에 바꾸기보다 오류가 발생한 단계에 따라 확인하는 편이 원인을 찾기 쉽습니다.
오류: The request timed out.
원인 및 해결 방법: 제한 시간 안에 요청이 완료되지 않았습니다. 현재 네트워크나 원격 서버 응답에 문제가 있을 수 있습니다. 먼저 현재 네트워크가 정상인지 확인하고, 다른 사용 가능한 네트워크에서 한 번 수동 업데이트한 뒤 결과를 비교하세요.
오류: A server with the specified hostname could not be found.
원인 및 해결 방법: 구독 도메인을 확인할 수 없습니다. URL의 도메인 철자를 먼저 확인한 뒤 현재 네트워크의 도메인 이름 확인이 정상인지 점검하세요. 대상 도메인을 추측한 IP 주소로 바꾸지 마세요.
오류: Could not connect to the server.
원인 및 해결 방법: 대상 서버와 연결을 설정하지 못했습니다. 주소의 포트와 대상 서비스 상태를 확인하세요. 원래 주소를 보존한 상태로 서비스 제공업체에 해당 인터페이스에 접근할 수 있는지 문의하세요.
예를 들어 HTTPS 주소에 포트가 명시되지 않은 경우 일반적으로 443 포트를 사용합니다. URL에 포트가 표시되어 있으면 요청은 해당 포트를 사용합니다. 여기서 말하는 포트는 구독 인터페이스의 포트이며 서버 항목의 연결 포트와 다를 수 있습니다. 구독 업데이트를 해결하려고 모든 서버 포트를 443으로 바꾸지 마세요.
- 현재 Wi-Fi의 네트워크 인증을 먼저 완료하세요. 인증 페이지에만 접속할 수 있는 상태에서는 구독 요청이 제대로 완료되지 않을 수 있습니다.
- Wi-Fi에서는 실패하지만 셀룰러 네트워크에서는 성공한다면 네트워크 환경이 결과에 영향을 준 것입니다. 구독을 바로 삭제하지 말고 원래 네트워크를 계속 확인하세요.
- 사용 가능한 두 네트워크 모두 같은 주소에서 실패한다면 오류 원문을 바탕으로 주소와 원격 서비스를 확인하세요. 이 결과만으로 앱 문제라고 단정할 수는 없습니다.
- 인증서 관련 오류가 발생하면 기기의 날짜와 시간을 확인하고 대상 도메인의 인증서 상태를 점검하세요. 보안 확인을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.
Global Routing의 Proxy, Direct, Config, Scene은 라우팅 동작과 관련된 항목이지 ‘구독 복구’ 버튼이 아닙니다. 테스트를 위해 라우팅을 바꿔야 한다면 원래 상태를 기록하고 한 번에 하나씩만 변경한 뒤 테스트 후 복원하세요. 구독 오류만으로 Config 전체를 수정하면 확인해야 할 변수가 늘어납니다.
형식 오류와 빈 목록: 요청이 성공했다면 응답 콘텐츠 확인
응답을 받았다고 해서 해석 가능한 구독을 가져온 것은 아닙니다. 인터페이스에서 로그인 페이지, 오류 안내, 빈 콘텐츠 또는 현재 가져오기 방식과 호환되지 않는 데이터가 반환될 수 있습니다. 네트워크에 연결됐는데 목록에 유효한 항목이 없다면 네트워크 설정을 더 바꾸기보다 응답의 콘텐츠 유형을 확인하세요.
| 증상 | 구분할 사항 | 다음 단계 |
|---|---|---|
| 웹 페이지 콘텐츠가 반환됨 | 관리 페이지 주소를 복사했거나 요청이 로그인 페이지로 이동함 | 사용 중인 관리 페이지에서 구독 주소를 가져오세요. 페이지 주소를 대신 사용하지 마세요. |
| 응답이 비어 있음 | 인터페이스에서 항목을 제공하지 않거나 현재 권한으로 사용할 수 있는 콘텐츠가 없음 | 서비스 제공업체에 해당 주소에서 현재 어떤 항목이 반환되어야 하는지 확인하세요. |
| 해석 실패 안내 | 반환 형식, 항목 설정값 또는 프로토콜 콘텐츠가 호환되지 않음 | 해당 구독이 Shadowrocket에서 사용 가능한지 확인하고 민감한 정보를 삭제한 오류 원문을 보관하세요. |
| 업데이트 후 항목 수가 줄어듦 | 원격에서 항목을 조정했을 수 있으며, 로컬 항목이 반드시 사라진 것은 아님 | 서비스 제공업체의 현재 목록과 비교해 예상 항목 수를 먼저 확인하세요. |
| 항목은 업데이트됐지만 연결할 수 없음 | 구독을 가져오는 데 성공했는지와 서버를 사용할 수 있는지는 별개의 문제 | 선택한 항목의 설정값, 서비스 상태 및 연결 로그를 확인하세요. |
반환된 내용이 ‘인코딩된 텍스트처럼 보인다’는 이유만으로 직접 잘라내거나 이어 붙이거나 다시 인코딩하지 마세요. 원본 데이터가 손상될 수 있고 이후 문제를 확인할 근거도 사라집니다. 서비스 제공업체에 문의해야 한다면 발생 시간, 네트워크 유형, 오류 문구, 수동으로 다시 재현할 수 있는지 전달하면 됩니다. 구독 인증 정보 전체는 업체가 지정한 비공개 채널로만 확인하세요.
복구 후 확인: 먼저 업데이트한 다음 연결
문제를 해결한 후 같은 순서로 확인하세요. Home에서 수동 새로 고침을 실행하고 그룹 항목을 확인한 뒤, 사용 중인 서버를 선택해 연결을 테스트하고 마지막으로 필요에 따라 Update on Open을 복원합니다. 이 순서를 지키면 구독 인터페이스 문제와 연결 문제를 분리할 수 있으며, 이전 목록을 새 결과로 착각하는 일도 방지할 수 있습니다.
- 업데이트 결과 확인: 이번 새로 고침이 끝났고 새로운 오류 안내가 없으며 대상 그룹의 내용이 예상과 일치합니다.
- 선택 항목 확인: 원격에서 이름이 바뀌거나 항목이 삭제됐을 수 있으므로 이전 선택 기록만 보지 말고 현재 선택을 다시 확인하세요.
- 규칙 설정 확인: 구독 업데이트가 Config 확인을 대신하지 않습니다. 연결 후의 접근 동작은 현재 설정을 함께 고려해 판단해야 합니다.
- 자동 업데이트 확인: 수동 업데이트가 안정적으로 작동하는지 확인한 뒤 Settings → Subscribe → Update on Open을 켜거나 그대로 유지하세요.
- 개인정보 기록 확인: 문제 해결용 스크린샷을 공유하기 전에 URL의 접근 매개변수와 기타 인증 정보를 가리세요.
Shadowrocket은 Apple 플랫폼용 상용 클로즈드 소스 앱으로, 주로 iPhone과 iPad에서 사용하며 App Store에서만 받을 수 있습니다. 앱 구매와 사용자가 이용하는 구독 서비스는 별도로 관리됩니다. 앱을 다시 구매해도 만료된 구독 주소가 복구되지는 않습니다. 시스템 요구 사항과 구매 가능 범위는 App Store 페이지를 기준으로 확인하세요.