구독 링크를 직접 제공받은 사용자를 위한 안내입니다. 먼저 Home에서 아래로 당겨 수동 업데이트한 뒤 Settings → Subscribe → Update on Open을 확인하세요. 실패하면 링크 유효성, 네트워크 요청, 응답 형식 순서로 원인을 좁혀 보세요. 업데이트 후에는 서버 목록과 기본 선택 항목, 실제 연결 상태를 각각 확인해야 합니다. 새로고침 애니메이션만으로 성공 여부를 판단하지 마세요.
구독 업데이트로 바뀌는 항목
Shadowrocket의 Subscribe 항목에는 구독 주소가 저장됩니다. 업데이트하면 앱이 해당 주소에 요청을 보내고, 서비스 제공자가 반환한 서버 정보를 읽어 연결된 그룹을 갱신합니다. 앱 자체를 업데이트하거나 서비스 요금제를 갱신하는 기능은 아닙니다. 아래 절차는 iPhone / iPad 화면을 기준으로 하며, 다른 플랫폼에서는 실제 화면에서 해당 항목을 확인하세요.
Home의 서버 목록, Config의 규칙 설정, Settings의 앱 설정은 서로 다른 영역입니다. 구독 업데이트가 성공했다는 것은 일반적으로 서버 정보를 가져와 파싱했다는 뜻일 뿐, Config의 규칙 파일까지 업데이트되었다는 의미는 아닙니다. 직접 추가한 서버도 다른 구독을 새로고침한다고 해당 구독에 자동으로 포함되지 않습니다.
Home에서 아래로 당겨 수동 업데이트
문제 해결을 시작할 때는 먼저 수동 업데이트를 한 번 실행하세요. 실행 시점을 명확히 알 수 있어 화면에 표시된 오류를 해당 요청과 연결하기 쉽습니다. 첫 실패 직후 그룹 전체를 삭제하지 마세요. 기존 항목과 오류 정보를 남겨 두어야 현재 사용 중인 서버 선택까지 함께 사라지는 일을 막을 수 있습니다.
-
구독 항목 확인
Home에서 업데이트할 Subscribe 항목을 찾으세요. 편집 화면을 열어 Type이 Subscribe인지 확인하고, URL이 서비스 제공자가 현재 안내하는 주소와 일치하는지 살펴보세요.
-
항목 추가
직접 추가한 서버만 있고 구독 항목이 없다면 Home 오른쪽 위의 «+»를 누르고 Type을 Subscribe로 설정하세요. URL에 본인의 구독 링크를 붙여 넣고 저장하면 됩니다. 기존 항목이 있다면 이 단계는 건너뛰세요.
-
아래로 당겨 업데이트
Home으로 돌아가 목록 맨 위를 아래로 당겼다가 놓고 업데이트가 끝날 때까지 기다리세요. 구독이 여러 개라면 각각 결과를 확인하세요. 하나가 성공했다고 모두 성공한 것은 아닙니다.
-
내용 확인
해당 구독 아래에 표시된 서버 이름과 항목 변화를 확인하세요. 목록이 그대로라면 원격 콘텐츠가 변경되지 않았을 수 있습니다. 오류가 표시되면 단순히 «업데이트가 안 됨»이라고 적기보다 오류 원문을 기록하세요.
-
연결 확인
기본 서버의 점 표시를 다시 확인한 뒤 필요하면 연결하고 Connectivity Test를 실행하세요. 목록을 가져오는 데 성공하는 것과 서버에 연결할 수 있는지는 별개의 결과입니다.
앱 실행 시 자동 업데이트 설정
Settings → Subscribe → Update on Open에서 앱을 열 때 업데이트하는 옵션을 켜세요. 이후 앱을 평소처럼 열고 구독 새로고침이 실행되는지 확인합니다. 플랫폼에 따라 설정 메뉴 순서가 다를 수 있으므로 같은 이름의 옵션을 찾아보세요. Config에서 이 옵션을 찾지 마세요.
- 먼저 수동 업데이트로 기준 확인: 같은 구독을 수동으로 한 번 업데이트하세요. 수동 요청부터 실패한다면 자동 업데이트를 켜도 주소, 권한 또는 형식 문제는 해결되지 않습니다.
- 실행 조건 구분: Update on Open은 앱을 열 때 실행되는 기능입니다. 앱이 백그라운드에서 일정한 시간 간격으로 계속 새로고침한다는 뜻은 아닙니다.
- 네트워크 연결 확인: Wi-Fi를 전환했거나 네트워크 로그인을 마쳤거나 비행기 모드에서 돌아온 직후라면, 먼저 인터넷 연결을 확인한 다음 앱을 열어 살펴보세요.
- 실제 결과 확인: 앱을 연 뒤에도 기존 이름이 표시된다는 사실만으로 옵션이 작동하지 않는다고 단정할 수 없습니다. 원격 정보가 바뀌지 않았을 수도 있으므로 오류 메시지와 수동 업데이트 결과를 함께 확인하세요.
Settings → On Demand는 조건에 따른 연결 동작을 관리하며 구독 업데이트 일정을 설정하는 기능이 아닙니다. 구독을 자동 새로고침하려고 On Demand 설정을 반복해서 바꾸지 마세요. 수동 업데이트는 정상인데 앱을 열 때 업데이트가 되지 않는다면 Update on Open이 켜져 있는지 다시 확인하고, 앱을 열었을 때의 네트워크 상태를 기록하세요.
오류 원문을 확인한 뒤 대응 순서 정하기
같은 «업데이트 실패»라도 원인은 서로 다른 단계에 있을 수 있습니다. 아래 항목에는 자주 표시되는 오류 문구와 HTTP 상태가 정리되어 있습니다. 구체적인 문구는 시스템과 서버에 따라 다를 수 있으니 화면에 표시된 전체 내용을 기준으로 판단하세요. 모든 실패를 링크 만료로 단정하지 마세요.
오류: Failed to load subscription
원인 및 해결: 구독을 불러오지 못했다는 포괄적인 안내로, 링크 만료나 형식 문제 중 어느 쪽인지 이 문구만으로는 알 수 없습니다. 먼저 URL 전체를 확인한 뒤 같은 요청에 더 구체적인 네트워크 또는 HTTP 오류가 표시되었는지 살펴보세요.
오류: The request timed out.
원인 및 해결: 허용된 시간 안에 요청이 완료되지 않았습니다. 로컬 네트워크, 원격 서버 응답 또는 현재 요청 경로가 원인일 수 있습니다. 먼저 일반적인 인터넷 접속이 되는지 확인한 뒤 같은 주소로 Wi-Fi와 모바일 데이터를 각각 사용해 테스트하세요.
응답 상태: HTTP 401
원인 및 해결: 서버에 유효한 인증 정보가 필요합니다. 주소에 포함된 토큰이 없거나 만료되었거나 재설정되었을 수 있습니다. 서비스 제공자에게 현재 사용할 수 있는 구독 링크를 다시 받아 URL 전체를 교체한 뒤 재시도하세요.
응답 상태: HTTP 403
원인 및 해결: 서버가 요청을 거부했습니다. 계정 권한이나 접근 정책과 관련된 문제일 수 있습니다. 상태 코드와 발생 시각을 서비스 제공자에게 전달하세요. 이 상태 코드만으로 요금제 만료라고 단정하지 마세요.
응답 상태: HTTP 429
원인 및 해결: 요청을 너무 자주 보내 서버의 제한에 걸렸습니다. 연속으로 아래로 당기지 말고 서비스 제공자의 안내에 따라 기다린 뒤 다시 시도하세요. 응답에 Retry-After가 포함되어 있다면 해당 안내에 따르세요.
문제를 점검할 때는 한 번에 조건 하나만 바꾸세요. 먼저 구독 주소는 그대로 두고 로컬 네트워크만 전환해 보세요. 다음에는 네트워크를 유지하고 서비스 제공자가 새로 발급한 주소로 바꿔 보세요. 여러 항목을 동시에 바꾸면 문제가 해결되어도 어떤 변경이 효과가 있었는지 알기 어렵습니다.
링크 만료, 네트워크 연결 실패, 형식 인식 오류
링크 유효성: URL 전체와 계정 상태 확인
구독 URL의 토큰은 대개 인증에 사용됩니다. 복사할 때 물음표 뒤의 매개변수가 빠지거나 공백 또는 줄바꿈이 추가되면 요청이 실패할 수 있습니다. 서비스 제공자가 링크를 재설정하면 기존 주소가 즉시 만료될 수도 있습니다. 링크가 여전히 유효한지 서비스 제공자에게 확인하고, 계정에 해당 구독 정보를 가져올 권한이 있는지도 살펴보세요.
- 도메인만 비교하지 말고 프로토콜, 도메인, 경로, 쿼리 매개변수를 모두 확인하세요.
- 링크가 로그인 페이지로 리디렉션된다면 현재 안내받은 주소가 구독 링크인지 계정 관리 페이지인지 서비스 제공자에게 먼저 확인하세요.
- URL을 바꾼 뒤에는 기존 항목을 저장한 상태로 테스트하세요. 같은 이름의 그룹을 계속 추가하면 결과를 잘못 판단할 수 있습니다.
네트워크 연결: DNS 조회, 연결, 인증서 문제 구분
HTTPS 구독 주소에 포트가 명시되지 않았다면 일반적으로 TCP 443으로 연결합니다. 도메인 조회 실패, 연결 시간 초과, TLS 인증서 검증 실패는 서로 다른 문제입니다. 기기에서 다른 웹페이지가 열린다고 해서 구독 도메인에도 연결할 수 있다는 뜻은 아닙니다.
- DNS 조회 실패: 도메인 철자를 확인하고 다른 로컬 네트워크에서 다시 테스트하세요. 구독 하나가 실패했다고 DNS 설정 전체를 바꾸지 마세요.
- 연결 시간 초과: 주소를 그대로 둔 채 Wi-Fi와 모바일 데이터에서 각각 테스트하고, VPN 연결 중에만 발생하는지도 기록하세요.
- 인증서 오류: 기기의 날짜와 시간을 확인하고 서비스 제공자에게 인증서 유효성을 점검해 달라고 요청하세요. 인증서 검증을 꺼서 문제를 숨기지 마세요.
Home → Global Routing의 Proxy, Direct, Config, Scene 설정은 연결 및 트래픽 분기 방식에 영향을 줍니다. 하지만 모든 구독 요청이 반드시 같은 경로를 따른다고 단정할 수는 없습니다. Proxy와 Direct를 전환하면 다른 앱의 트래픽 경로도 달라집니다. 문제를 확인할 때는 현재 설정과 VPN 상태를 기록하고, 새로고침을 위해 다른 설정으로 장시간 유지하지 마세요.
형식 인식 오류: 요청 성공이 가져오기 성공을 뜻하지는 않음
서버가 HTTP 200을 반환하면 HTTP 요청은 성공한 것이지만, 응답 본문이 올바른 구독 형식이라는 보장은 없습니다. 로그인 페이지, 점검 안내 또는 빈 내용이 반환될 수 있습니다. 구독 형식으로 인식되는 콘텐츠라도 필수 필드가 없거나 프로토콜 매개변수가 불완전하면 사용할 수 있는 항목이 생성되지 않을 수 있습니다.
| 확인된 현상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 응답이 HTML 페이지임 | 로그인 또는 인증 페이지가 반환되었는지 | Shadowrocket에서 사용할 구독 주소가 맞는지 서비스 제공자에게 확인 |
| 응답 또는 목록이 비어 있음 | 계정에 서버 정보가 할당되어 있는지 | 원래 그룹을 삭제하지 말고 서비스 제공자에게 응답 내용을 확인 요청 |
| 일부 항목을 가져올 수 없음 | 해당 프로토콜과 필수 필드가 모두 있는지 | 민감 정보를 가린 오류 내용과 프로토콜 종류를 전달하고 매개변수를 임의로 추측하지 않기 |
| 이름과 항목 수가 바뀌지 않음 | 원격에서 실제로 변경된 내용을 게시했는지 | 요청이 성공했는지 먼저 확인한 뒤 예상한 내용이 맞는지 서비스 제공자에게 문의 |
업데이트 성공 후에도 연결되지 않을 때 확인할 사항
업데이트에 성공해도 모든 서버에 연결할 수 있는 것은 아닙니다. 원격에서 기존 항목을 삭제하거나 교체했다면 기본 서버 선택을 다시 확인하세요. VMess, VLESS, Trojan 등의 항목은 주소, 포트, UUID 또는 비밀번호, 전송 방식, TLS 매개변수 모두 서비스 제공자가 전달한 정보에 따라야 합니다. 오류를 없애려고 임의로 값을 추가하지 마세요.
- Home에서 이름이 같은 수동 항목이 아니라 업데이트된 대상 서버가 선택되어 있는지 확인하세요.
- 연결한 뒤 Connectivity Test를 실행해 «구독 정보 가져오기»와 «서버 연결»을 각각 확인하세요.
- 테스트는 통과하지만 특정 도메인에 문제가 있다면 Global Routing의 현재 설정과 Config의 규칙 일치 여부를 확인하세요.
- DOMAIN-SUFFIX, IP-CIDR, GEOIP, FINAL 등의 규칙을 확인할 때는 문제가 된 항목만 조정하세요. 규칙을 바꾸는 것은 구독 형식 문제의 해결 방법이 아닙니다.
서비스 제공자에게 문의할 때는 발생 시각, 사용한 로컬 네트워크, 오류 원문, 수동 업데이트 결과, 앱 실행 시 업데이트 결과를 전달하세요. 구독 URL의 토큰, UUID, 비밀번호는 가려야 합니다. 전체 링크를 공개 스크린샷이나 댓글에 올리지 마세요. 이미 노출했다면 서비스 제공자에게 링크를 재설정받고 클라이언트의 URL도 갱신하세요.