이 글은 본인이 이용하는 서비스의 구독을 보유한 Shadowrocket 사용자에게 적합합니다. 먼저 Home에서 구독 하나를 수동으로 업데이트해 링크에서 유효한 설정을 받아오는지 확인한 다음, 앱 실행 시 자동 업데이트를 설정하세요. 오류가 발생하면 네트워크 연결, 링크 권한, 응답 내용을 차례로 확인합니다. 서버 목록 업데이트는 Config 업데이트나 서비스 이용 기간 연장과는 다릅니다.
1. 구독 업데이트와 연결 테스트 구분하기
구독 링크는 서버 설정을 가져오는 주소입니다. 업데이트를 실행하면 Shadowrocket이 해당 주소에 요청을 보내고, 응답에서 서버 매개변수를 읽어 Home의 해당 구독 그룹을 갱신합니다. 요청 성공 여부는 구독 주소, 현재 네트워크, 서비스 제공자의 응답 내용에 따라 달라집니다. 목록에 있는 특정 서버에 연결할 수 있는지는 별도로 확인해야 합니다.
지연 시간 테스트로 구독 업데이트를 대신할 수는 없습니다. 지연 시간 테스트는 이미 등록된 서버 정보를 확인할 뿐, 서비스 제공자가 추가하거나 교체한 서버를 가져오지 않습니다. 반대로 업데이트에 성공했더라도 특정 서버를 사용할 수 없거나 계정 할당량이 소진되었거나 서비스 이용 기간이 끝났을 수 있습니다.
먼저 업데이트할 항목을 확인하세요. 서비스 제공자의 서버 목록이 대상이면 Home의 구독을 업데이트하고, 규칙 파일이 대상이면 Config에서 해당 설정의 출처를 확인합니다. 두 항목은 별도로 관리될 수 있으므로 하나를 업데이트했다고 다른 항목까지 갱신된 것은 아닙니다.
2. Home에서 기존 구독 수동 업데이트하기
우선 현재 목록을 유지하고 구독을 삭제하지 마세요. 삭제 후 다시 가져오면 서버 선택, 그룹 확인, 설정 복구 작업이 늘어나며 문제를 진단할 때 비교할 이전 정보가 사라질 수도 있습니다. 처음 업데이트할 때는 구독 하나만 실행해야 결과가 어느 링크에서 비롯됐는지 확인하기 쉽습니다.
-
구독 찾기
Home을 열고 본인의 구독 그룹을 찾습니다. 그룹 이름과 기존 서버 목록을 확인해 개별적으로 추가한 서버 항목을 구독으로 착각하지 않도록 하세요.
-
작업 메뉴 열기
Home에서 구독 그룹 제목의 작업 메뉴를 열고 Update를 선택합니다. 그룹 제목을 길게 눌러 메뉴를 열 수 있습니다. 현재 화면에서 왼쪽으로 밀어 작업 버튼을 표시하는 방식이라면 구독 그룹 행을 왼쪽으로 민 뒤 업데이트를 선택하세요. 개별 서버 행에서 Delete를 누르지 마세요.
-
완료될 때까지 기다리기
앱을 전면에 둔 상태로 요청이 끝날 때까지 기다립니다. 업데이트를 연속해서 실행하지 마세요. 오류가 표시되면 전체 메시지와 발생 시간을 기록한 뒤 다음 항목을 확인합니다.
-
목록 확인
그룹이 그대로 있는지, 항목을 펼칠 수 있는지, 서비스 제공자가 변경을 안내한 서버가 표시되는지 확인합니다. 내용이 바뀌지 않았다면 먼저 원격에서 실제로 새 내용을 제공했는지 확인하세요.
-
연결 재확인
현재 선택된 서버가 여전히 유효한지 확인한 다음 연결하고 같은 테스트 페이지에 접속합니다. ‘업데이트 성공 여부’와 ‘서버 사용 가능 여부’를 따로 기록해 두 결과를 혼동하지 마세요.
3. 앱 실행 시 자동 업데이트 켜기
자동 업데이트를 설정하기 전에 수동 업데이트를 한 번 완료하세요. 먼저 구독 링크가 유효한지 확인하면 앱을 열 때마다 같은 오류가 반복되는 일을 피할 수 있습니다. 앱 실행 시 자동 업데이트는 구독 관리 기능이며 연결 스위치나 규칙 모드가 아닙니다.
-
설정으로 이동
Settings → Subscribe를 열고 Update On Open을 찾습니다. 설치된 버전에 실제로 표시되는 구독 설정을 기준으로 하세요. Config에서 규칙을 수정해 이 옵션을 대신하려고 하지 마세요.
-
옵션 켜기
Update On Open을 켭니다. 업데이트 간격 등 추가 조건이 표시된다면 안내 내용을 함께 확인하세요. 요청이 실제로 실행되는지는 해당 조건을 고려해야 합니다.
-
돌아가서 확인
네트워크가 연결된 상태에서 앱을 다시 열고 Home으로 돌아가 업데이트 결과를 확인합니다. 특정 구독을 바로 확인하려면 자동 업데이트 시점을 기다리지 말고 Update를 수동으로 실행해도 됩니다.
Update On Open을 정해진 주기의 백그라운드 작업으로 이해하지 마세요. 앱을 벗어나거나 화면을 잠그거나 시스템 VPN 상태만 확인하는 것으로 구독이 계속 백그라운드에서 업데이트된다고 볼 수 없습니다. 백그라운드에서 앱으로 돌아왔다는 이유만으로 요청이 완료됐다고 판단해서도 안 됩니다.
- Update On Open: 앱을 열 때 구독을 업데이트하는 기능으로, 네트워크와 관련 업데이트 조건의 영향을 받습니다.
- Settings → On Demand: 연결을 필요에 따라 설정하는 옵션이며 구독의 서버 목록을 교체하는 기능은 아닙니다.
- Global Routing: Proxy, Direct, Config, Scene 등의 선택 항목을 통해 트래픽 처리 방식을 제어하며 구독 업데이트 주기를 설정하는 기능은 아닙니다.
4. 오류 메시지로 링크 문제와 네트워크 문제 구분하기
업데이트에 실패하면 먼저 오류 문구를 저장하고 어느 단계에서 문제가 생겼는지 확인하세요. 아래는 발생할 수 있는 요청 오류 또는 HTTP 상태의 예이며, 실제 메시지는 시스템 언어, 네트워크 환경, 서비스 제공자의 응답에 따라 다를 수 있습니다. 오류를 없애려고 같은 링크를 반복해서 삭제하고 다시 가져오지 마세요.
오류: The request timed out.
원인 및 해결 방법: 허용된 시간 안에 요청이 완료되지 않았습니다. 네트워크가 끊겼거나 주소에 연결할 수 없거나 원격 서버의 응답이 늦을 수 있습니다. 먼저 일반 웹페이지가 열리는지 확인한 뒤 신뢰할 수 있는 다른 네트워크에서 같은 구독 링크를 다시 시도해 결과를 비교하세요.
오류: Could not connect to the server.
원인 및 해결 방법: 대상 서버에 연결하지 못했습니다. 원격 서비스, 네트워크 제한 또는 연결 경로에 문제가 있을 수 있습니다. 구독 도메인을 빠짐없이 입력했는지 확인한 뒤 본인의 서비스 제공자에게 구독 주소를 현재 사용할 수 있는지 문의하세요.
오류: HTTP 401 Unauthorized
원인 및 해결 방법: 원격 서버가 현재 요청의 인증 정보를 거부했습니다. 본인의 서비스 계정에서 구독 권한과 현재 링크를 확인하고 링크가 재설정됐는지 확인하세요. token을 추측하거나 임의로 조합하지 마세요.
오류: HTTP 403 Forbidden
원인 및 해결 방법: 서버가 요청을 받았지만 접근을 거부했습니다. 권한, 접속 위치 또는 보안 정책이 원인일 수 있습니다. 발생 시간과 사용한 네트워크를 기록해 서비스 제공자에게 제한 조건을 확인하세요. 403만으로 서비스 기간이 끝났다고 단정할 수는 없습니다.
링크가 재설정되면 이전 링크를 더 이상 사용할 수 없을 수 있습니다. 본인의 서비스 계정에서 현재 구독 주소를 다시 복사해 해당 구독의 URL을 교체한 뒤 수동으로 업데이트하세요. 복사할 때 앞뒤 공백, 줄바꿈, 쿼리 매개변수가 모두 포함됐는지 확인하고 도메인만 복사하지 마세요.
5. 요청은 성공했지만 목록에 이상이 있을 때 확인할 순서
네트워크 요청이 성공해도 응답 내용이 유효한 구독이라는 뜻은 아닙니다. 원격 서버가 로그인 페이지, 인증 페이지 또는 계정 상태 안내를 반환할 수 있습니다. HTTP 상태가 200이어도 본문이 Shadowrocket에서 파싱할 수 있는 서버 설정이 아니라 HTML일 수 있습니다. 이 경우 서버를 바꿔도 파싱 문제는 해결되지 않습니다.
| 확인된 현상 | 먼저 확인할 항목 | 다음 단계 |
|---|---|---|
| 업데이트가 끝났지만 항목이 그대로임 | 원격 내용이 실제로 변경됐는지 | 서비스 제공자가 안내한 구체적인 항목을 비교하고 개수 변화만으로 결과를 판단하지 마세요. |
| 파싱 실패 또는 사용 가능한 항목이 없다는 메시지 | 구독 주소가 맞는지, 웹페이지가 반환되는지 | 본인의 계정에서 Shadowrocket용 구독 주소를 다시 복사하세요. |
| 목록은 정상인데 연결이 실패함 | 현재 서버, 서비스 이용 기간, 계정 할당량 | 연결 문제와 구독 요청을 구분하고 서비스 제공자에게 해당 서버 상태를 확인하세요. |
| 한 네트워크에서는 실패하고 다른 네트워크에서는 성공함 | 네트워크 인증, 도메인 확인, 접속 제한 | 같은 구독과 설정을 유지한 채 네트워크별 차이를 비교하고 여러 조건을 한꺼번에 바꾸지 마세요. |
프로토콜 이름만으로 업데이트 성공을 보장할 수는 없습니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 서로 다른 연결 설정을 나타냅니다. 구독 요청은 해당 설정을 가져올 뿐 잘못된 포트, 비밀번호, UUID 또는 TLS 매개변수를 자동으로 수정하지 않습니다. 서비스 제공자가 제공한 내용 자체에 문제가 있다면 먼저 출처를 확인하세요.
- 공용 Wi-Fi에서는 네트워크에서 요구하는 로그인이나 이용 확인을 먼저 완료한 뒤 구독을 업데이트하세요.
- DNS 문제로 의심되면 먼저 구독 도메인이 확인되는지 살펴보세요. 도메인을 IP 주소로 바로 바꾸지 마세요. HTTPS 인증서와 서버 라우팅이 원래 도메인에 의존할 수 있습니다.
- 인증서 확인 오류가 발생하면 기기의 날짜와 시간, 네트워크 환경을 확인하세요. 인증서 검증을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.
- 이미 만료된 링크를 해결하려고
DOMAIN-SUFFIX를 추가하거나FINAL을 수정하지 마세요. 규칙으로는 원격 권한을 복구할 수 없습니다.
6. 업데이트 후 기록해 둘 확인 사항
문제를 진단할 때는 한 번에 하나의 조건만 바꾸세요. 같은 링크로 네트워크를 바꿔 시험한 다음 링크 권한을 확인하고 마지막으로 응답 내용을 살펴봅니다. 구독을 바꾸고 DNS를 조정하고 Global Routing을 전환한 뒤 기존 설정까지 삭제하면, 문제가 해결돼도 어떤 조치가 효과가 있었는지 확인하기 어렵습니다.
- 기록할 항목: 구독 그룹 이름은 기록하되 전체 token은 기록하지 마세요. 서버 비밀번호를 문제 설명과 함께 보내지 마세요.
- 환경 기록: Wi-Fi와 셀룰러 네트워크 중 무엇을 사용했는지, 일반 웹페이지에 접속할 수 있었는지 적어 두세요.
- 결과 기록: 업데이트 오류, 목록 변경, 연결 오류를 구분하고 전체 오류 문구와 발생 시간을 기록하세요.
- 변경 사항 기록: 어떤 설정 하나만 바꿨는지 적으세요. 개선되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 시험하세요.
Shadowrocket은 Apple 플랫폼 전용 유료 앱으로, 주로 iPhone과 iPad에서 사용하며 App Store에서만 받을 수 있습니다. 개발자 Shadow Launch Technology Limited와 앱 ID 932747118을 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 앱의 일회성 구매는 서버 서비스 요금제와 별개이며, 기존 서비스 제공자의 구독 권한을 대신하지 않습니다.
연결 문제를 확인하려면 사이트의 문제 해결을 계속 읽어 보세요. Subscribe, Config, Global Routing의 차이를 확인하려면 용어 설명을 참고하세요. 먼저 수동 업데이트가 완료되는지 확인한 다음 앱 실행 시 자동 업데이트를 켜면 이후 문제를 더 쉽게 파악할 수 있습니다.