이 글은 이미 본인 서비스 제공업체의 구독을 보유한 사용자를 대상으로 합니다. 먼저 Home에서 수동으로 새로고침해 링크에 접속하고 내용을 해석할 수 있는지 확인한 뒤, 앱 실행 시 자동 업데이트나 업데이트 간격을 설정하세요. 오류가 발생하면 요청 주소, 네트워크 경로, 응답 내용 순으로 점검합니다. 조작 경로는 iPhone / iPad 화면을 기준으로 설명하며, Mac, Windows, Android, Linux에서는 각 플랫폼에 실제로 제공되는 설정을 확인하세요. 모바일 앱의 백그라운드 동작을 데스크톱에 그대로 적용해서는 안 됩니다.
구독 업데이트로 바뀌는 항목: 서버 목록과 Config를 따로 확인
Shadowrocket의 구독 업데이트는 기존 구독 주소에 다시 요청을 보내고, 응답 내용을 서버 항목으로 해석하는 기능입니다. 서비스 제공업체가 주소, 포트, 인증 정보 또는 목록을 변경한 경우 업데이트해야 변경 사항을 가져올 수 있습니다. 클라이언트를 다시 구매하거나 기존 요금제를 갱신하는 기능은 아닙니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다.
먼저 Home의 서버 구독과 Config의 규칙 설정을 구분하세요. 서버 목록을 업데이트해도 현재 Config 파일의 규칙까지 업데이트되는 것은 아니며, 선택한 서버의 연결이 즉시 복구된다는 보장도 없습니다. 인증 정보가 만료되었거나 주소가 비활성화된 경우 업데이트로 해결될 수 있지만, 로컬 규칙이나 네트워크 차단, 시스템 시간 문제라면 추가로 원인을 찾아야 합니다.
가져오기 전에 주소가 본인 서비스 제공업체 계정 페이지에서 제공된 것인지 확인하고, 기존의 정상 설정도 보관하세요. 예시 https://example.com/sub?token=xxxx는 주소 구조를 설명하기 위한 것으로, 실제로 사용할 수 있는 구독이 아닙니다. 쿼리 매개변수의 token은 보통 접근 인증 정보로 사용되므로, 문제를 확인할 때 전체 주소가 공개 스크린샷이나 로그에 노출되지 않도록 주의하세요.
수동으로 당겨서 업데이트: 반복 가능한 방식으로 먼저 점검
자동 업데이트를 설정하기 전에 수동 업데이트를 한 번 실행하세요. 그러면 ‘링크 자체가 작동하지 않는 문제’와 ‘자동 실행이 되지 않는 문제’를 구분할 수 있습니다. 자동 업데이트도 같은 구독 주소를 사용하므로, 만료된 주소나 인증 실패, 잘못된 형식 문제를 우회할 수는 없습니다.
- Home에서 대상 그룹을 확인합니다. 구독 이름과 기존 서버를 확인하고, 구독 그룹과 직접 추가한 항목을 구분하세요. 대상 그룹의 현재 항목 수를 기록해 두세요. 구독이 여러 개라면 다른 그룹의 변경을 이번 업데이트 결과로 착각하지 않도록 주의합니다.
- 목록을 아래로 당겨 새로고침합니다. Home 목록 상단에서 아래로 당겼다가 놓고, 새로고침이 끝날 때까지 기다립니다. 그룹이 여러 개라면 실제로 새로고침된 범위와 각 그룹의 결과를 확인하세요. 여러 요청이 섞이지 않도록 연속해서 당기지 마세요.
- 업데이트 결과를 확인합니다. 오류 메시지가 표시되는지 살펴본 다음 대상 그룹의 항목, 주소 또는 포트가 서비스 제공업체가 안내한 변경 사항과 일치하는지 확인하세요. 목록이 바뀌지 않았더라도 실패라고 단정할 수는 없습니다. 원격 콘텐츠에 변경 사항이 없었을 수도 있습니다.
- 연결은 별도로 테스트합니다. 기존 서버를 선택해 Connectivity Test를 실행한 뒤, 실제로 접속하려는 대상에도 연결해 보세요. 구독 새로고침 성공은 콘텐츠를 가져와 해석했다는 뜻일 뿐, 현재 네트워크에서 모든 서버에 접속할 수 있다는 의미는 아닙니다.
앱 실행 시 자동 업데이트와 주기 업데이트: 조건에 맞게 설정
해당 옵션이 제공되는 플랫폼에서는 Settings → Subscribe로 이동해 앱 실행 시 업데이트, 자동 업데이트 간격, Update via Proxy 등의 설정을 확인하세요. 플랫폼과 화면 버전에 따라 옵션의 배치가 다를 수 있으므로, 기기에 표시되는 스위치와 간격 설정을 기준으로 삼으세요. 표시되지 않는 옵션을 임의로 설정 필드를 추가해 대체해서는 안 됩니다.
| 업데이트 방식 | 실행 조건 및 용도 | 확인할 항목 |
|---|---|---|
| 아래로 당겨 수동 업데이트 | 사용자가 Home에서 직접 새로고침합니다. 처음 확인하거나 오류를 재점검할 때 적합합니다. | 새로고침이 끝났는지, 오류가 표시됐는지, 대상 그룹이 바뀌었는지 확인합니다. |
| 앱 실행 시 자동 업데이트 | 설정에 따라 앱을 열 때 업데이트를 시도합니다. 앱을 일상적으로 사용할 때 변경 사항을 가져오는 데 적합합니다. | 해당 스위치가 켜져 있는지, 앱을 열 때 네트워크에 연결되어 있었는지, 업데이트 간격의 제한을 받는지 확인합니다. |
| 주기 업데이트 | 앱에서 지원하는 업데이트 간격에 따라 실행을 시도합니다. 수동 새로고침 횟수를 줄이는 데 적합합니다. | 기기에 간격 설정이 제공되는지, 앱이 실제로 실행될 기회가 있는지 확인합니다. |
앱 실행 시 자동 업데이트를 설정한 뒤 현재 설정 화면을 나가고, 이후 평소처럼 앱을 열었을 때 결과를 확인하세요. 앱을 잠깐 백그라운드로 보냈다가 다시 여는 동작이 반드시 업데이트를 실행한다고 볼 수는 없습니다. 목록이 그대로라는 이유만으로 스위치가 작동하지 않는다고 판단하지 마세요. 앱에 표시된 업데이트 결과와 서비스 제공업체가 실제로 항목을 변경했는지를 확인하는 편이 더 정확합니다.
주기 업데이트는 시스템 알람과 다릅니다. 특히 iPhone / iPad에서는 백그라운드 실행이 시스템 스케줄링, 절전 상태, 네트워크 환경의 영향을 받습니다. 화면에 표시된 간격은 화면이 잠긴 뒤에도 정해진 시각에 새로고침된다는 보장이 아닙니다. 앱을 직접 종료한 뒤에도 같은 방식으로 백그라운드 작업이 계속 실행될 것으로 기대해서는 안 됩니다. 변경 사항을 바로 확인해야 한다면 Home을 열어 수동으로 새로고침하는 편이 결과를 확인하기 쉽습니다.
요약: 수동 업데이트가 성공한 뒤 자동 실행을 확인하세요
같은 구독과 같은 네트워크를 유지한 상태에서 수동 업데이트를 성공적으로 한 번 완료한 뒤, 자동 업데이트 설정만 변경하세요. 그러면 다음에 실패하더라도 링크, 네트워크, 형식 해석을 한꺼번에 의심하지 않고 실행 조건부터 확인할 수 있습니다.
Update via Proxy와 Global Routing: 네트워크 조건은 하나씩만 변경
구독 주소에 접속할 수 있는지와 서버에 연결할 수 있는지는 별개의 문제입니다. 현재 네트워크에서 직접 접속할 수 있는 주소도 있고, 정상 작동하는 프록시 경로를 거쳐야 하는 주소도 있습니다. Settings → Subscribe의 Update via Proxy는 구독 업데이트 요청을 프록시를 통해 보낼지 설정하는 옵션입니다. 이 옵션을 켜기 전에 현재 선택된 기존 서버가 실제로 연결되는지 확인하세요.
Home → Global Routing의 Proxy, Direct, Config, Scene은 라우팅 모드이지 구독 업데이트 빈도가 아닙니다. Direct는 직접 연결, Proxy는 프록시 라우팅, Config는 선택한 설정에 따른 처리, Scene은 시나리오 설정에 따른 처리를 뜻합니다. 문제를 점검할 때는 기존 모드와 선택 항목을 먼저 기록하고, 구독을 새로고침하려고 모든 연결의 라우팅 방식을 장시간 바꾸지 마세요.
- 현재 네트워크에서 먼저 수동 업데이트를 한 번 실행하고, 시간 초과인지, 비정상 HTTP 상태인지, 콘텐츠 해석 실패인지 기록합니다.
- 직접 접속은 실패했지만 기존 프록시 연결이 정상이라면 Update via Proxy를 확인한 뒤 같은 구독으로 다시 시도합니다.
- 프록시를 켠 뒤 오히려 실패하면 원래 설정으로 되돌리고, 현재 서버가 정상인지 확인하거나 본인이 보유한 다른 연결 가능한 서버 항목으로 바꿔 다시 테스트합니다.
- 네트워크나 스위치 설정은 한 번에 하나씩만 변경하세요. Wi-Fi와 모바일 데이터에서 각각 테스트할 때 결과를 따로 기록하고, 동시에 구독 주소를 바꾸지 마세요.
구독 업데이트 실패: 오류 원문으로 요청과 해석 문제 구분
다음 조치를 정하기 전에 오류 원문을 보관하세요. 아래는 네트워크 계층과 HTTP 계층에서 자주 볼 수 있는 메시지입니다. Shadowrocket에 표시되는 문구는 시스템과 플랫폼에 따라 다를 수 있습니다. HTTP 상태 코드는 서버의 응답 결과이며, 특정 원인 하나만을 뜻하지 않습니다. 403이 표시됐다고 해서 링크가 만료됐다고 단정할 수는 없습니다.
오류: The request timed out.
원인 및 해결 방법: 제한 시간 안에 요청이 완료되지 않았습니다. 현재 네트워크에서 구독 서버에 접속할 수 없거나 서버 응답이 느린 경우일 수 있습니다. 먼저 Wi-Fi와 모바일 데이터를 전환해 다시 테스트하고, 연결 가능한 기존 프록시가 있다면 Update via Proxy 설정을 확인하세요.
오류: A server with the specified hostname could not be found.
원인 및 해결 방법: 구독 도메인을 확인하지 못했습니다. 주소 오타나 도메인 만료, 현재 DNS 확인 오류가 원인일 수 있습니다. 본인 서비스 제공업체 계정 페이지에서 전체 주소를 다시 복사해 도메인을 확인하고, 다른 네트워크에서도 테스트하세요. HTTPS 인증이 깨질 수 있으므로 도메인을 임의로 IP 주소로 바꾸지 마세요.
오류: HTTP 401 / HTTP 403
원인 및 해결 방법: 인증에 실패했거나 요청이 거부되었으며, 접근 정책의 제한을 받았을 수도 있습니다. token이 재설정되었는지, 주소 전체를 복사했는지, 계정에 필요한 권한이 있는지 확인하세요. 서비스 제공업체가 현재 제공하는 주소를 사용하고, token을 추측하거나 수정해 해결하려 하지 마세요.
오류: HTTP 404
원인 및 해결 방법: 요청한 경로에 해당하는 리소스를 찾지 못했습니다. 이전 인터페이스가 종료되었거나 주소 경로가 잘린 경우가 흔합니다. 전체 경로와 쿼리 매개변수를 확인하고, 계정 웹페이지 주소가 아니라 구독 주소를 복사했는지 확인한 뒤 수동 업데이트를 다시 실행하세요.
콘텐츠는 반환되지만 해석할 수 없음
HTTP 요청이 성공해도 잘못된 콘텐츠가 반환될 수 있습니다. 예를 들어 구독 인터페이스가 로그인 페이지, 보안 확인 페이지 또는 계정 안내 페이지로 이동할 수 있습니다. 이러한 페이지는 정상적으로 표시되지만 Shadowrocket이 필요로 하는 서버 데이터는 아닙니다. 이 경우 업데이트 빈도를 바꿔도 해결되지 않습니다. 해당 링크가 현재 클라이언트에 맞는 구독 형식인지, 서비스 제공업체가 요청에 올바른 콘텐츠를 반환하는지 확인하세요.
- 복사한 주소의 앞뒤를 확인하세요: 주소 앞뒤에 공백, 줄바꿈, 메신저 앱이 덧붙인 문장 부호가 없는지 확인하세요. 특히
?및&뒤의 매개변수가 빠짐없이 포함됐는지 살펴봅니다. - 형식과 프로토콜을 구분하세요: Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 프로토콜 이름입니다. 이 중 특정 프로토콜을 지원한다고 해서 임의의 구독 포맷까지 해석할 수 있는 것은 아닙니다.
- HTTPS 환경을 확인하세요: 시스템 날짜, 시간 또는 시간대가 크게 어긋나면 인증서 확인에 실패할 수 있습니다. 시스템의 자동 시간 설정을 켠 뒤 다시 요청하세요. 인증서 확인을 끄는 방법으로 해결해서는 안 됩니다.
- 필요한 정보만 기록하세요: 오류 문구, 네트워크 유형, Update via Proxy 사용 여부, 대상 그룹의 변경 여부를 기록합니다. 본인 서비스 제공업체에 문의할 때는 비공개 지원 채널을 이용하고, 공개 스크린샷에서는 token, 비밀번호, 전체 구독 주소를 가리세요.
업데이트 후 자주 묻는 질문: 목록·트래픽·연결을 따로 확인
새로고침 성공으로 표시되는데 서버 수가 그대로인 이유는 무엇인가요?
원격 콘텐츠가 변경되지 않았거나 기존 항목의 주소나 매개변수만 바뀌었을 수 있습니다. 먼저 서비스 제공업체가 실제로 변경 사항을 안내했는지 확인한 뒤 해당 항목을 살펴보세요. 개수만으로 성공 여부를 판단하지 말고, 변경 사항을 보기 위해 기존 구독을 삭제하지도 마세요.
앱 실행 시 자동 업데이트를 켰는데 화면을 잠근 뒤 제때 새로고침되지 않는 이유는 무엇인가요?
앱 실행 시 업데이트와 백그라운드에서 주기적으로 실행되는 작업은 서로 다른 조건으로 작동합니다. Settings → Subscribe에서 기기에 제공되는 자동 업데이트 옵션과 간격을 확인한 뒤 Home을 열어 수동으로 테스트하세요. 모바일 백그라운드 스케줄링은 정확한 알람처럼 작동하지 않습니다.
구독을 업데이트하면 트래픽 사용량이 초기화되거나 자동으로 갱신되나요?
아니요. 업데이트는 콘텐츠를 다시 가져오는 기능일 뿐입니다. 서비스 계정의 트래픽 한도와 이용 기간은 본인 서비스 제공업체가 관리합니다. 목록에 사용량 안내가 표시되면 서비스 제공업체 계정에서 실제 상태를 확인하세요. 새로고침을 충전이나 갱신으로 간주해서는 안 됩니다.
업데이트에 성공했는데 웹페이지가 열리지 않는 이유는 무엇인가요?
먼저 Home에서 선택한 서버의 Connectivity Test를 실행한 뒤 Global Routing과 현재 Config를 확인하세요. 테스트에는 성공했지만 특정 대상에 접속할 수 없다면 규칙 매칭과 대상의 접근 가능 여부를 추가로 점검하세요. 연결 문제를 해결하는 대신 구독 업데이트를 반복하지 마세요.
Mac으로 바꾸면 휴대폰의 자동 업데이트 설정을 그대로 따라 해야 하나요?
플랫폼을 바꿔도 설정이 자동으로 동일해진다고 가정해서는 안 됩니다. 먼저 Mac에 가져온 구독을 확인하고 수동 업데이트를 한 번 실행하세요. 자동 업데이트와 백그라운드 실행은 Mac 화면에 실제로 제공되는 옵션에 따라 설정합니다. 다른 데스크톱 및 모바일 플랫폼에서도 같은 순서로 확인하세요.
마지막으로 최소한의 문제 해결 기록을 남기세요. 일부 정보를 가린 구독 주소, 업데이트에 사용한 네트워크, 프록시 사용 여부, 오류 원문, 목록 변경 여부를 기록합니다. 먼저 요청이 성공했는지, 다음으로 데이터를 해석할 수 있는지, 마지막으로 서버 연결을 확인하세요. DNS, Global Routing, 자동 업데이트 간격을 동시에 바꾸는 것보다 이 세 단계로 확인하는 편이 원인을 찾기 쉽습니다.