Shadowrocket 구독 업데이트 오류 해결: 수동 새로고침 및 앱 실행 시 자동 업데이트 설정

Shadowrocket 구독 업데이트가 실패할 때 수동 새로고침 방법과 앱 실행 시 자동 업데이트 설정을 확인하고, 링크 만료·네트워크 오류·형식 변경 등 주요 원인을 살펴보세요.

이 글의 핵심

Shadowrocket 구독 업데이트에 실패하면 기존 기록을 유지한 채 먼저 수동으로 새로고침하고, 표시되는 오류를 기록하세요. 그런 다음 링크, 네트워크 경로, 응답 형식을 차례로 확인합니다. 이 글에서는 사용자가 이미 보유한 서비스와 구독을 전제로 Home에서 새로고침하는 방법, Settings → Subscribe의 자동 업데이트 설정, ‘구독이 업데이트되지 않음’과 ‘노드에 연결할 수 없음’을 구분하는 방법을 설명합니다. 아래 절차는 iPhone / iPad 화면을 기준으로 하며, 다른 플랫폼에서는 메뉴 위치가 다를 수 있습니다.

구독 업데이트와 연결 테스트 구분하기

구독 업데이트는 구독 주소로 요청을 보내고 응답 내용을 서버 기록으로 변환하는 과정입니다. 연결 테스트는 기록에 저장된 주소, 포트, 프로토콜 매개변수를 사용해 연결을 시도합니다. 두 과정은 서로 다른 경로를 확인합니다. 기존 노드에 연결된다고 구독 주소가 여전히 유효한 것은 아니며, 구독 새로고침에 성공해도 목록의 모든 노드가 연결되는 것은 아닙니다.

Home에는 서버 기록과 연결 상태가 표시되고, Config에서는 주로 규칙 구성 파일을 관리합니다. Config의 원격 구성을 업데이트하는 작업을 Home의 서버 구독 업데이트와 혼동하지 마세요. 문제를 확인하기 전에 어떤 항목이 실패했는지 먼저 구분하면 구독을 고치려다 규칙 파일 전체를 교체하는 일을 피할 수 있습니다.

작업 유형 2가지
구독 업데이트는 목록을 가져오고, 연결 테스트는 기존 기록을 확인합니다. 각각 별도로 점검하세요.
443
HTTPS에서 포트를 따로 지정하지 않았을 때 사용하는 기본 포트이며, 노드 포트와는 다릅니다.

Home에서 구독 수동 업데이트하기

처음 문제를 확인할 때는 오류를 바로 볼 수 있도록 수동 업데이트를 사용하세요. 구독을 먼저 삭제하지 마세요. 기존 기록으로 계속 연결할 수 있을 수 있으며, 삭제 후 다시 가져오지 못하면 테스트할 수 있는 조건까지 사라집니다. 구독 그룹 이름, 현재 기록 수, 오류 메시지를 적어 둔 다음 아래 절차를 진행하세요.

  1. 그룹 확인

    Home을 열고 업데이트할 구독 그룹을 찾습니다. 구독이 여러 개라면 이번에 확인할 그룹을 먼저 특정하세요. 다른 그룹의 변경을 업데이트 성공으로 오인하지 않도록 합니다.

  2. 링크 확인

    해당 구독의 편집 화면으로 이동해 URL이 온전한지 확인합니다. 처음 추가할 때는 Home → 오른쪽 위 ‘+’→ Type → Subscribe로 이동합니다. 기존 기록이 있다면 새로 만들지 말고 먼저 편집하세요.

  3. 아래로 당겨 새로고침

    Home으로 돌아가 목록을 아래로 당겼다가 놓으면 구독 새로고침이 시작됩니다. 이번 요청이 끝날 때까지 기다린 후 성공 또는 실패 메시지를 확인하세요. 연속해서 새로고침하면 요청 제한에 걸릴 가능성이 높아질 수 있습니다.

  4. 결과 확인

    대상 그룹에 기록이 남아 있는지, 이름과 개수가 예상과 일치하는지 확인합니다. 성공 메시지가 표시되었지만 개수가 그대로라면 원격 콘텐츠가 바뀌지 않았을 수 있습니다. 개수만으로 실패를 판단하지 마세요.

업데이트 후 목록이 비었다면 새로고침을 반복하지 말고 멈추세요. 당시 표시된 메시지를 기록하고, 서비스 제공자에게 구독이 실제로 빈 목록을 반환했는지 또는 사용 가능한 기록 범위가 변경되었는지 확인하세요. 같은 링크를 다시 추가해도 원격 콘텐츠 문제는 해결되지 않습니다.

앱 실행 시 자동 업데이트 설정

Settings → Subscribe로 이동해 Update on Open을 찾아 켭니다. 이 설정은 앱을 열 때 구독 업데이트를 시도하며, 수동 업데이트가 정상적으로 작동하는 것을 확인한 뒤 사용하는 것이 좋습니다. 설정을 켠 다음 앱을 완전히 나갔다가 다시 열어 결과를 확인하세요. Home과 Config 사이를 전환하는 것만으로 자동 업데이트를 검증했다고 볼 수는 없습니다.

앱을 다시 열 때만 실패하고 몇 초 기다린 뒤 수동 새로고침하면 성공한다면, Wi-Fi나 모바일 네트워크로 전환한 직후 아직 인터넷 연결이 완료되지 않았는지 먼저 확인하세요. Update on Open을 잠시 끄고 네트워크가 안정된 뒤 수동으로 다시 테스트하면 앱 실행 시점 문제와 링크 자체의 문제를 구분할 수 있습니다.

오류 메시지에 따라 링크와 접근 권한 확인

오류 문구는 시스템 언어, 네트워크 계층, 서버 응답에 따라 달라질 수 있습니다. 아래는 흔히 볼 수 있는 오류 문구나 상태 코드의 의미이며, 실패할 때마다 정확히 같은 문장이 표시되는 것은 아닙니다. 단순히 ‘업데이트 안 됨’이라고 적기보다 원문 오류를 기록하면 원인을 찾는 데 도움이 됩니다.

오류: The request timed out.

원인: 제한 시간 안에 요청이 완료되지 않았습니다. 연결 경로가 끊겼거나 원격 서버 응답이 느리거나 프록시 경로를 사용할 수 없는 경우일 수 있습니다.

해결: 먼저 Wi-Fi와 모바일 네트워크를 바꿔 가며 다시 테스트하세요. 그런 다음 직접 연결과 Update via Proxy 경로를 각각 확인하고, 한 번에 하나씩만 변경하세요.

오류: A server with the specified hostname could not be found.

원인: 구독 도메인을 확인하지 못했습니다. 도메인 오타, DNS 문제 또는 기존 도메인 비활성화가 원인일 수 있습니다.

해결: 도메인 전체를 확인한 뒤 네트워크를 바꿔 다시 시도하세요. 계속 실패하면 서비스 제공자에게 현재 구독 도메인을 확인하세요.

상태 코드: HTTP 403

원인: 서버가 접근을 거부했습니다. 링크 토큰, 계정 권한 또는 요청 출처 제한과 관련된 문제일 수 있습니다.

해결: 본인의 서비스 계정에서 구독 상태와 최신 링크를 확인하세요. 클라이언트를 반복해서 재설치하는 것은 해결 방법이 아닙니다.

상태 코드: HTTP 429

원인: 서버가 짧은 시간에 보낼 수 있는 요청 수를 제한했습니다. 여러 기기에서 동시에 자동 새로고침을 실행해도 제한에 걸릴 수 있습니다.

해결: 연속 새로고침을 멈추고 서버에서 안내한 시간만큼 기다린 뒤 다시 시도하세요. 다른 기기에서 반복 요청하는 것도 줄이세요.

구독 링크에는 계정 인증 정보가 포함되는 경우가 많습니다. 확인할 때 물음표 뒤의 매개변수가 온전한지, 공백이나 줄바꿈이 섞이지 않았는지, 메신저에서 링크가 잘리지 않았는지 살펴보세요. 아래 내용은 형식을 알아보기 위한 예시일 뿐 실제 구독 주소가 아닙니다. 문제 해결 정보를 공유할 때는 실제 token도 반드시 가리세요.

https://example.com/sub?token=xxxx

네트워크 오류라면 업데이트 요청 경로 확인

일반 웹페이지가 열린다고 해서 구독 도메인에도 접근할 수 있는 것은 아닙니다. 도메인마다 DNS 응답, 접근 제한, 네트워크 경로가 다를 수 있습니다. 기존 설정은 그대로 둔 채 다른 네트워크로 같은 구독을 새로고침해 보세요. 특정 네트워크에서만 실패한다면 모든 노드 매개변수를 바로 바꾸기보다 해당 네트워크부터 확인하세요.

  1. Settings → Subscribe → Update via Proxy의 현재 상태를 기록한 다음, 설정을 바꾸지 않은 상태에서 한 번 새로고침하고 결과를 남겨 두세요.
  2. 직접 연결은 실패하지만 기존 노드는 연결된다면, 먼저 Home에서 사용 가능한 것으로 확인된 기록을 선택해 연결한 뒤 Update via Proxy를 켜고 다시 테스트하세요.
  3. 프록시를 통한 업데이트가 실패하면 Update via Proxy를 끄고 직접 연결로 다시 테스트하세요. 프록시를 통하면 언제나 더 쉽게 성공한다고 단정하지 마세요.
  4. 현재 Global Routing이 Proxy, Direct, Config, Scene 중 무엇으로 설정되어 있는지 확인하고 테스트 당시의 상태를 기록하세요. 연결 스위치가 켜져 있다는 이유만으로 모든 요청이 프록시를 거친다고 판단하지 마세요.
  5. 인증서 또는 보안 연결 오류가 발생하면 기기의 날짜, 시간, 시간대가 올바른지 확인하세요. 인증서 오류를 무시해 검증을 우회하지 마세요.

Config를 사용하면 규칙에 따라 요청이 다른 경로로 전달될 수 있습니다. 구독 테스트를 위해 넓은 범위의 DIRECT 또는 PROXY 규칙을 임의로 추가하지 마세요. 먼저 되돌릴 수 있는 소수의 설정만 바꿔 원인을 확인한 뒤 구성을 조정할지 결정하세요.

요청은 성공했지만 파싱 실패: 응답 형식 확인

HTTP 요청 성공은 응답을 받았다는 뜻일 뿐, 응답이 유효한 구독이라는 보장은 없습니다. 서버가 로그인 페이지, 권한 안내, 인증 페이지 또는 빈 텍스트를 반환할 수 있으며, 이런 응답도 HTTP 200을 사용할 수 있습니다. 이때 업데이트 버튼을 계속 눌러도 웹페이지가 서버 목록으로 바뀌지는 않습니다.

증상우선 확인할 항목해결 순서
요청이 끝난 뒤 파싱 실패 메시지가 표시됨링크가 계정 관리 웹페이지가 아니라 클라이언트용 구독 링크인지 확인본인의 서비스 계정에서 해당 구독 링크를 다시 복사한 다음 기존 기록을 편집하세요.
이전에는 정상이었지만 형식 변경 후 실패함서버 출력 형식이 바뀌었거나 지원되지 않는 필드가 추가되었는지 확인서비스 제공자에게 Shadowrocket을 사용한다고 알리고, 민감 정보를 가린 오류 문구를 보내 호환되는 형식을 확인하세요.
업데이트 성공 후 기록 수가 줄어듦원격에서 기록이 삭제되었거나 계정 권한이 변경되었거나 빈 목록이 반환되었는지 확인먼저 계정 상태와 원격 콘텐츠를 확인하세요. 곧바로 로컬 파싱 오류라고 단정하지 마세요.
목록은 정상이지만 노드 연결에 실패함노드 주소, 포트, 프로토콜 매개변수, 사용 가능 여부연결 문제 해결 단계로 넘어가고 같은 목록을 반복해서 업데이트하지 마세요.

오류 페이지 전체를 Add Server에 복사하지 마세요. Shadowsocks, VMess, VLESS, Trojan 등은 각각 입력해야 하는 필드가 다릅니다. 구독 파싱과 서버 수동 입력은 별개의 작업입니다. 직접 입력해야 한다면 웹페이지의 문구를 보고 프로토콜이나 포트를 추측하지 말고 서비스 제공자가 안내한 정확한 매개변수를 확인하세요.

자주 묻는 질문과 문제 해결

업데이트는 실패했는데 기존 노드는 왜 연결되나요?

구독 주소와 노드 주소는 서로 다른 요청 대상입니다. 기존 기록은 유지한 채 Home에서 연결을 테스트하고, 구독 URL의 권한과 네트워크 경로는 별도로 확인하세요. 그룹 전체를 먼저 삭제하지 마세요.

자동 업데이트를 켰는데 목록이 그대로인 이유는 무엇인가요?

먼저 Home에서 아래로 당겨 수동 새로고침하고 메시지를 확인한 다음 Settings → Subscribe → Update on Open 설정을 확인하세요. 요청에 성공했는데 목록이 그대로라면 서버에서 실제로 다른 내용을 게시했는지 확인해야 합니다. 이름과 개수가 같다는 사실만으로 자동 업데이트가 작동하지 않았다고 볼 수는 없습니다.

휴대폰을 바꾼 뒤 기존 링크를 복사하면 반드시 업데이트되나요?

그렇지 않을 수 있습니다. 링크가 초기화되었거나 계정 권한 또는 요청 횟수 제한이 적용되었을 수 있습니다. 본인의 서비스 계정에서 링크가 여전히 유효한지 확인한 뒤 Home → “+”→ Type → Subscribe에서 추가하세요. token이 포함된 전체 주소를 공개 게시판에 올리지 마세요.

업데이트 실패 후 Shadowrocket을 다시 설치해야 하나요?

우선 재설치하지 마세요. 구성과 구독 기록을 보관하고 네트워크 변경, 링크 확인, 업데이트 경로 전환을 차례로 테스트하세요. 로컬 앱 상태에 문제가 있다고 명확히 확인된 경우에만 추가 조치를 고려하세요. 재설치해도 서버가 접근을 거부하는 문제는 해결되지 않습니다.

서비스 제공자에게 문의할 때는 실패 시각과 시간대, 네트워크 연결 방식, 오류 원문, Update via Proxy 사용 여부, 네트워크를 바꾼 뒤의 결과를 함께 전달하세요. 계정 및 링크 정보는 해당 업체의 비공개 지원 채널로 보내야 합니다. 이 사이트는 노드, 구독, VPN 서비스를 제공·판매·추천하지 않으며, 클라이언트 설정과 문제 해결 방법만 안내합니다.

Shadowrocket 다운로드