이미 이용 중인 서비스와 구독이 있고 Home의 구독 목록을 관리하려는 사용자를 위한 안내입니다. 먼저 수동 업데이트로 링크가 유효한지 확인한 뒤 필요에 따라 앱 실행 시 업데이트를 켜세요. 실패하면 링크, 서버 응답, 반환 형식, 현재 네트워크를 차례로 점검하고, 아직 사용할 수 있는 구독은 먼저 삭제하지 마세요.
구독 업데이트의 범위: 목록 새로고침이며 연결 성공을 뜻하지 않음
Shadowrocket 구독 업데이트는 저장된 구독 주소로 콘텐츠를 다시 요청하고, 파싱한 항목을 Home에 반영하는 기능입니다. 서비스 제공자가 서버 주소, 포트, 인증 정보 또는 항목 이름을 변경하면 클라이언트가 변경 사항을 가져오도록 구독을 다시 받아야 하는 경우가 많습니다. 클라이언트 구매와 회선 요금제는 별개입니다. 이 글은 이미 본인 구독을 보유한 경우를 전제로 합니다.
업데이트 성공은 이번에 구독을 가져와 파싱하는 과정이 완료되었다는 뜻일 뿐, 모든 항목으로 연결할 수 있거나 현재 연결이 새 항목으로 전환되었다는 의미는 아닙니다. 구독 목록, Config의 규칙, 시스템 VPN 연결은 서로 다른 설정 단계이므로 문제를 확인할 때 각각 따로 살펴보세요.
Home에 추가한 Subscribe는 구독 소스입니다. 서버 항목 하나를 개별로 가져온 경우에는 구독 주소가 없을 수 있으므로 구독처럼 이후 변경 사항을 가져올 수 없습니다. Config의 원격 구성 파일 업데이트도 Home의 구독 목록 업데이트와는 별개입니다. 작업 전에 어떤 종류의 항목을 관리하는지 확인하세요.
수동 업데이트: 구독을 찾아 새로고침
처음 가져왔을 때, 서비스 제공자가 설정 변경을 알렸을 때, 자동 업데이트 후에도 목록에 변화가 없을 때는 수동 업데이트를 먼저 사용하세요. 요청을 직접 실행하고 결과를 바로 확인할 수 있습니다. 인터페이스 언어에 따라 표시 문구가 다를 수 있어 아래에서는 영어 인터페이스 용어를 그대로 사용합니다. 구독 그룹의 작업 메뉴 위치도 레이아웃에 따라 달라질 수 있습니다.
-
구독 찾기
Home을 열고 해당 구독 그룹을 찾아 그룹 이름을 확인하세요. 아직 가져오지 않았다면 Home 오른쪽 위의 「+」→ Type → Subscribe로 이동해 본인 구독 링크를 URL에 입력한 뒤 저장합니다.
-
주소 확인
해당 구독의 편집 화면으로 이동해 URL이 온전한지, 특히 물음표 뒤의 매개변수가 있는지 확인하세요. 복사할 때 공백, 줄바꿈, 한글 문장 부호, 안내 문구가 섞이지 않도록 합니다. 확인 후 Home으로 돌아갑니다.
-
업데이트 실행
Home 목록 상단에서 아래로 당겨 새로고침합니다. 특정 구독만 업데이트하려면 해당 구독 그룹을 길게 누르고 Update를 선택할 수 있습니다. 실제 그룹에 표시되는 작업 메뉴를 기준으로 진행하세요.
-
결과 확인
요청이 끝날 때까지 기다린 뒤 오류 메시지가 있는지 확인합니다. 대상 그룹을 펼쳐 항목 이름, 개수 또는 이미 알고 있는 변경 사항이 반영되었는지 살펴보세요. 요청이 끝나기 전에 새로고침을 연달아 반복하지 마세요.
-
연결 재확인
현재 선택된 항목이 업데이트된 목록에도 있는지 확인하세요. 서비스 제공자가 해당 항목을 교체했다면 유효한 항목을 다시 선택한 뒤 연결을 별도로 테스트합니다. 진행 중인 작업이 있다면 연결을 변경하기 전에 먼저 저장하세요.
목록의 항목 수가 바뀌지 않았다고 반드시 업데이트에 실패한 것은 아닙니다. 서버가 이름은 그대로 둔 채 인증 정보만 바꾸었거나, 이번에 받은 내용이 이전과 같을 수 있습니다. 반대로 항목 수가 늘어도 모든 항목을 사용할 수 있다는 뜻은 아닙니다. 숫자만 보지 말고 서비스 제공자가 알린 변경 사항과 업데이트 결과를 비교하세요.
앱 실행 시 자동 업데이트: 설정 위치와 사용 조건
자동 업데이트 설정은 보통 Settings → Subscribe → Update on Open에 있습니다. 이 옵션을 켜면 설정된 조건에 따라 앱이 구독 업데이트를 시도합니다. 현재 인터페이스에 업데이트 간격 등의 추가 제한이 있다면 함께 확인하세요. 앱을 전면으로 가져올 때마다 반드시 새 요청이 실행된다고 단정하지 마세요.
앱을 열 때 구독 변경 사항을 가져오려는 사용자에게 적합한 설정이지만, 그때 네트워크에서 구독 서버에 접속할 수 있어야 합니다. 시스템의 백그라운드 정기 작업을 보장하는 기능이 아니며, 기기가 잠긴 뒤에도 계속 구독을 가져온다는 뜻도 아닙니다. 옵션 이름이나 메뉴 위치가 이 글과 다르면 Settings의 Subscribe 항목에 표시된 설명을 따르세요.
Settings → On Demand는 조건에 따라 VPN 연결을 시작하는 설정으로, 구독을 자동으로 가져오는 기능과는 다릅니다. On Demand만 켜도 구독이 자동으로 업데이트되는 것은 아닙니다. Update on Open만 켜도 시스템 VPN 권한이 자동으로 승인되거나 연결이 항상 작동하는 것은 아닙니다.
정리: 먼저 수동으로 확인한 뒤 자동 업데이트 사용
현재 네트워크에서 같은 주소를 수동으로 업데이트할 수 있는지 확인한 다음 Update on Open을 켜세요. 수동 요청부터 실패한다면 자동 업데이트 스위치를 바꾸는 것만으로 링크 만료, 형식 오류, 네트워크 접속 불가 문제를 해결하기 어렵습니다.
수동 업데이트와 자동 업데이트: 관리 상황에 맞게 선택
두 방식은 같은 구독 소스에서 내용을 가져오며, 주된 차이는 실행 시점과 문제를 확인하기 쉬운 정도입니다. 자동 업데이트로 만료된 링크가 유효해지거나 구독 서버의 반환 형식이 바뀌지는 않습니다. 문제가 생기면 자동 설정은 그대로 두고 결과를 확인할 수 있는 수동 요청을 먼저 실행하는 편이 원인을 찾기 쉽습니다.
| 방식 또는 설정 | 실행 조건 | 사용 상황 | 중점 확인 항목 |
|---|---|---|---|
| Home에서 수동 새로고침 | 사용자가 직접 아래로 당기거나 Update 실행 | 첫 확인, 설정 변경, 오류 재현 | 이번 요청의 메시지와 대상 그룹의 내용 |
| Update on Open | 앱을 열고 옵션의 조건 충족 | 일상적인 구독 변경 사항 확인 | 당시 네트워크 및 추가 간격 제한 |
| On Demand | On Demand 연결 조건 충족 | VPN 연결 동작 관리 | 구독 업데이트 결과를 확인하는 용도가 아님 |
- 구독이 자주 바뀌지 않는다면 필요할 때만 수동 업데이트하고 반복 요청은 피하세요.
- 구독이 자주 변경된다면 먼저 링크를 확인한 뒤 Update on Open 사용을 고려하세요.
- 서비스 제공자가 요청 빈도를 제한한다면 안내된 업데이트 간격을 지키고 연속으로 실행하지 마세요.
- 로컬 변경 사항을 보존해야 한다면 업데이트 전에 필요한 차이를 기록하세요. 구독으로 생성된 항목은 다음 업데이트에서 덮어써질 수 있으므로 수동 변경을 계속 보존할 위치로 사용하면 안 됩니다.
업데이트 실패 문제 해결: 오류를 확인하고 해당 단계 점검
오류가 발생한 시간, 사용한 네트워크, 대상 구독, 표시된 메시지를 먼저 기록하세요. 아래에는 흔히 볼 수 있는 네트워크 계층 오류의 영어 원문을 정리했습니다. 실제 화면에는 현지화된 문구나 추가 설명이 표시될 수 있으므로 의미에 맞게 대응하세요. 오류 메시지는 실패한 단계를 설명할 뿐, 서비스 제공자 계정이나 특정 서버에 문제가 있다고 단정할 근거는 아닙니다.
The request timed out.
원인 및 해결 방법: 허용된 대기 시간 안에 요청이 완료되지 않은 경우입니다. 네트워크, DNS 또는 원격 서버의 응답 지연이 원인일 수 있습니다. 현재 네트워크로 인터넷에 접속할 수 있는지 확인하고, 신뢰할 수 있는 다른 네트워크에서 한 번 더 시도한 뒤 같은 오류가 계속되는지 기록하세요.
A server with the specified hostname could not be found.
원인 및 해결 방법: 구독 도메인을 확인하지 못했습니다. 도메인 오타, DNS 문제 또는 도메인 변경이 원인일 수 있습니다. 원래 주소의 호스트 이름을 대조한 다음 서비스 제공자에게 현재 유효한 주소를 확인하세요.
Could not connect to the server.
원인 및 해결 방법: 대상 서버에 연결하지 못했습니다. 대상 포트에 접속할 수 없거나 서버를 일시적으로 사용할 수 없을 수 있습니다. URL의 주소와 포트를 확인한 뒤 다른 네트워크에서 다시 테스트하고, 결과를 서비스 제공자에게 전달해 문제를 확인하세요.
The network connection was lost.
원인 및 해결 방법: 요청 중 연결이 끊겼습니다. Wi-Fi와 셀룰러 네트워크를 전환하는 중에 발생할 수 있습니다. 안정적인 네트워크 하나를 유지하고 시스템의 인터넷 연결이 복구된 뒤 수동 업데이트를 한 번 더 실행하세요.
HTTP 상태 코드와 응답 내용은 따로 확인
- HTTP 401: 일반적으로 유효한 인증 정보가 요청에 포함되지 않았다는 뜻입니다. 링크의 인증 매개변수가 온전한지 확인하고 서비스 제공자가 주소를 새로 발급했는지 확인하세요.
- HTTP 403: 서버가 요청을 거부했습니다. 접근 제한이나 인증 정보 상태가 원인일 수 있습니다. 만료라고 단정하지 말고 서비스 제공자에게 거부된 이유를 확인하세요.
- HTTP 404: 요청한 경로를 찾을 수 없습니다. 이전 경로를 복사했는지, 관리 페이지 주소를 구독 주소로 입력했는지 확인하세요.
- HTTP 429: 요청이 너무 잦습니다. 새로고침을 멈추고 서버가 응답한 대기 시간이나 서비스 제공자의 안내에 따라 나중에 다시 시도하세요.
- HTTP 5xx: 일반적으로 서버 또는 상위 처리 과정에 문제가 있다는 뜻입니다. 상태 코드와 발생 시간을 기록하고 잠시 후 다시 시도하세요. 로컬 항목을 반복해서 수정해도 원격 서비스가 복구되는 데 도움이 되지 않습니다.
서버가 HTTP 200을 반환해도 클라이언트가 파싱할 수 있는 구독이 아니라 로그인 페이지, 인증 페이지 또는 빈 내용을 반환할 수 있습니다. 형식 오류가 표시되거나 업데이트 후 유효한 항목이 없다면 반환된 콘텐츠 유형을 확인하고 서비스 제공자가 Shadowrocket에 맞는 구독 출력을 제공하는지 문의하세요. 브라우저에서 웹페이지가 열린다는 이유만으로 구독이 정상이라고 판단하지 마세요.
링크 만료 및 형식 오류: URL 전체 확인
구독 URL에는 접근 인증 정보가 포함되는 경우가 많습니다. 예시 https://example.com/sub?token=xxxx는 가짜 값임을 알 수 있도록 만든 예시이며 실제로 사용할 수 있는 서비스 주소가 아닙니다. 실제 주소의 경로와 쿼리 매개변수는 모두 그대로 유지하세요. 물음표 뒤의 내용을 삭제하면 유효한 구독이 인증되지 않은 요청으로 바뀔 수 있습니다.
- 출처 대조: 서비스 제공자가 구독 정보를 제공한 곳으로 돌아가 계정 홈, 로그인 페이지, 사용 안내 페이지가 아니라 구독 주소를 복사했는지 확인하세요.
- 유효성 확인: 구독 자격, 유효 기간, 링크 상태를 확인하세요. 링크를 새로 발급하면 기존 주소가 무효화되는 서비스도 있으므로 계정 상태만 복구해도 이전 링크가 다시 유효해지는 것은 아닙니다.
- 복사 내용 확인: 원래 인코딩과 모든 매개변수를 그대로 유지하세요.
%,&,=등의 문자를 직접 바꾸거나 일부만 표시된 주소를 전체 주소로 사용하지 마세요. - 출력 형식 확인: 서비스 제공자가 Shadowrocket용으로 안내한 형식을 사용하세요. 구독 컨테이너의 인코딩과 그 안에 포함된 항목의 프로토콜은 별개의 문제입니다. 텍스트에 특정 프로토콜 이름이 있다는 이유만으로 전체 내용이 유효하다고 판단할 수 없습니다.
- 수정 후 한 번 테스트: 기존 구독의 URL을 수정한 뒤 수동 새로고침을 한 번 실행하세요. 기존 그룹을 남겨 두면 문제를 비교하기 쉽고, 중복으로 가져와 이전 항목과 새 항목이 뒤섞이는 일을 피할 수 있습니다.
Shadowsocks, VMess, VLESS, Trojan 등의 이름은 항목의 프로토콜 종류를 나타냅니다. 구독 주소는 여러 설정을 한 번에 반환합니다. 서버 하나를 공유하는 링크는 새로고침 가능한 구독 소스와 다릅니다. 단일 링크를 Subscribe의 URL에 입력해도 원격 목록을 업데이트하는 기능이 생기지는 않습니다.
구독 인증 정보는 민감 정보로 취급서비스 제공자에게 문의할 때는 오류 메시지, 발생 시간, 인증 정보가 가려진 주소를 우선 전달하세요. 전체 구독 링크, 인증 매개변수 또는 이러한 정보가 포함된 스크린샷을 공개하지 마세요. 링크가 유출된 것 같다면 서비스 제공자를 통해 인증 정보를 새로 발급받으세요.
업데이트에 성공했지만 사용할 수 없음: 연결 및 트래픽 라우팅 점검
구독 새로고침과 연결 사용은 서로 다른 네트워크 경로를 거칠 수 있습니다. 업데이트 후에도 접속할 수 없다면 같은 구독을 계속 새로고침하기보다 현재 선택한 항목이 업데이트된 목록에 있고 유효한지 확인한 뒤 연결 상태와 Global Routing을 점검하세요. 반복 업데이트는 요청 횟수만 늘릴 뿐 규칙 매칭 결과를 바꾸지는 못합니다.
- 항목 확인: 이름, 서버 주소, 포트가 서비스 제공자의 안내와 일치하는지 확인하세요. 두 항목의 이름이 비슷하다고 인증 정보도 같다고 단정하지 마세요.
- 연결 확인: 앱의 연결 스위치와 시스템 VPN 상태를 확인하세요. 필요한 경우 현재 작업을 저장한 뒤 다시 연결해 업데이트된 구성을 적용하세요.
- 라우팅 방식 확인: Global Routing의 Proxy, Direct, Config, Scene은 트래픽 처리 방식을 결정합니다. Config를 사용한다면 요청 처리는 현재 구성의 규칙에도 영향을 받습니다.
- 규칙 확인: DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL 등의 규칙은 정책 선택에 영향을 주지만 구독 서버가 반환하는 항목을 결정하지는 않습니다. Config에서 실제로 적용되는 구성과 규칙 순서를 확인하세요.
- 문제 구분: 특정 항목만 실패하고 다른 항목은 사용할 수 있다면 해당 항목과 관련 서버를 확인하세요. 모든 항목이 실패하지만 구독은 업데이트된다면 연결 권한, 네트워크, 구성을 계속 점검해야 합니다. 두 상황을 하나의 업데이트 오류로 혼동하지 마세요.
정리: 실패 단계별로 정보 기록
가져오기에 실패하면 네트워크 오류나 HTTP 상태를 기록하고, 파싱에 실패하면 출력 형식을 확인하세요. 목록은 업데이트됐지만 연결에 실패하면 선택한 항목과 트래픽 라우팅을 점검합니다. 한 번에 변수 하나만 바꿔야 어떤 변경이 실제로 효과가 있었는지 알 수 있습니다.
관리를 마친 뒤 수동 업데이트를 한 번 더 실행해 대상 그룹이 정상적으로 새로고침되는지 확인하고, Update on Open이 평소 사용 방식에 맞는지도 점검하세요. 문의가 필요하면 실행 방식, 오류 원문, 네트워크 유형, 이미 확인한 사항을 정리하면 됩니다. 구독 인증 정보는 공개하지 마세요.