이미 이용 중인 서비스와 구독이 있는데 Shadowrocket에서 추가한 서버가 보이지 않거나 수동 업데이트가 실패하는 경우에 적용됩니다. 링크, 응답 내용, 접속 경로를 구분해 차례로 확인하세요. 처음부터 목록이 비어 있다면 연결 스위치를 켜는 것을 만능 해결책으로 여기지 말고, 정상 작동하는 기존 항목을 먼저 삭제하지 마세요.
1. 먼저 구분하기: 가져오지 못한 경우, 업데이트되지 않은 경우, 항목을 사용할 수 없는 경우
구독 업데이트와 서버 연결은 별개의 기능입니다. 앱은 먼저 구독 주소에 접속해 응답을 받은 뒤, 지원되는 서버 정보를 목록에 파싱합니다. 구독 그룹이 표시된다고 해서 요청이 성공한 것은 아닙니다. 목록에 기존 항목이 있다고 해서 방금 업데이트가 완료된 것도 아닙니다.
먼저 Home에서 문제가 발생한 구독 그룹을 찾아 펼쳐져 있는지 확인하고, 수동 업데이트 후 표시되는 메시지를 기록하세요. 기존 항목이 남아 있다면 그대로 두고 이번 업데이트를 확인하세요. 처음 가져온 목록부터 비어 있었다면 주소와 응답 내용을 중점적으로 살펴보세요. 다음 증상은 각각 확인을 시작할 지점이 다르므로 한데 묶어 처리하지 않는 것이 좋습니다.
| 확인되는 증상 | 우선 확인할 항목 | 아직 하지 말아야 할 작업 |
|---|---|---|
| 처음 추가한 뒤 서버가 하나도 표시되지 않음 | 주소가 완전한지, 응답에 유효한 항목이 포함되어 있는지 | Global Routing을 계속 전환하기 |
| 기존 서버는 남아 있지만 업데이트에 실패함 | 구독 상태, 접속 경로, 오류 메시지 | 기존 구독과 모든 항목 삭제하기 |
| 목록에 서버가 있지만 연결할 수 없음 | 서버 설정, 연결 테스트, 서비스 상태 | 연결 실패만으로 구독 형식이 잘못됐다고 단정하기 |
| 그룹 이름만 보이고 내용은 표시되지 않음 | 그룹을 펼쳐 실제로 항목이 없는지 확인하기 | 같은 주소를 바로 다시 추가하기 |
2. 링크 형식: 계정 페이지가 아닌 구독 주소 복사하기
이미 이용 중인 서비스의 관리 페이지에서 Shadowrocket용 구독 주소를 다시 복사한 다음, 앱에 저장된 주소와 비교하세요. 계정 홈, 로그인 페이지, 구매 내역 페이지와 구독 엔드포인트는 용도가 서로 다릅니다. 브라우저에서 웹페이지가 열린다고 해서 앱이 파싱할 수 있는 구독 주소라는 뜻은 아닙니다.
- 복사한 위치를 확인하세요. 브라우저 주소창의 현재 주소가 아니라, 서비스 페이지에서 구독 가져오기용으로 명시된 복사 기능을 사용하세요. 콘텐츠 형식을 선택할 수 있다면 Shadowrocket에 맞는 형식을 고르세요. 파일 확장자만으로 판단하지 마세요.
- 주소의 시작과 끝을 확인하세요. 앞부분에 불필요한 따옴표, 공백, 설명 문구가 붙었는지, 끝부분이 메신저에서 잘리지 않았는지 살펴보세요. 화면에서 자동 줄바꿈된 것과 주소에 실제 줄바꿈 문자가 삽입된 것은 다릅니다. 실제 줄바꿈은 주소를 사용할 수 없게 만들 수 있습니다.
- 쿼리 매개변수를 유지하세요. 주소에서
?뒤에 붙는 매개변수는 인증에 사용될 수 있으며,&로 연결된 후속 매개변수도 응답 형식에 영향을 줄 수 있습니다. 주소를 "더 간결하게" 만들려고 이 부분을 삭제하지 마세요. - 인증 정보를 직접 디코딩하지 마세요.
%2F,%2B등은 유효한 퍼센트 인코딩일 수 있습니다. 임의로 바꾸지 말고+를 공백으로 바꾸지도 마세요. - 주소를 재설정했는지 확인하세요. 서버에서 구독 인증 정보를 재설정했다면 이전 주소가 바로 만료될 수 있습니다. 기존 구독에 저장된 주소를 새 주소로 바꿔 새 그룹과 이전 그룹이 혼동되지 않도록 하세요.
구독 주소와 개별 서버 공유 정보는 서로 다른 입력 유형입니다. ss://, vmess://, trojan://으로 시작하는 내용은 대개 서버 정보를 나타내므로, 복사할 수 있다는 이유만으로 원격 구독 주소로 간주하면 안 됩니다. Home → Add Server로 추가할 때는 먼저 가지고 있는 정보의 유형을 확인한 뒤 알맞은 입력 방법을 사용하세요.
3. 서비스 상태 확인하기: 요청이 성공해도 콘텐츠를 파싱할 수 있는 것은 아닙니다
주소를 다시 복사해도 목록이 비어 있다면 이용 중인 서비스의 관리 페이지에서 구독이 유효한지, 사용 가능한 항목이 남아 있는지, 주소가 재설정되었는지 확인하세요. 클라이언트는 서버가 실제로 반환한 콘텐츠만 처리할 수 있습니다. 로그인 페이지, 인증 페이지 또는 빈 응답이 반환된다면 같은 주소를 반복해서 가져와도 서버가 나타나지 않습니다.
아래 카드의 HTTP 상태 코드는 표준 응답 상태이며, 이미 확보한 진단 정보를 설명하기 위한 것입니다. Shadowrocket이 언제나 같은 오류 문구를 표시한다는 뜻은 아닙니다. "업데이트 실패"만 표시된다면 실제 메시지를 기록하고 계정이 만료됐다고 바로 단정하지 마세요.
오류: HTTP 401 Unauthorized
원인 및 해결 방법: 엔드포인트가 현재 인증 정보를 거부했습니다. 이용 중인 서비스의 관리 페이지에서 구독 주소가 재설정됐는지 확인한 뒤, 유효한 주소를 다시 복사해 업데이트하세요.
오류: HTTP 403 Forbidden
원인 및 해결 방법: 엔드포인트가 이번 접속을 거부했습니다. 권한이나 접속 제한이 원인일 수 있으므로 서비스 제공업체에 응답 이유를 확인하세요. 이 상태 코드만 보고 프로토콜 설정을 반복해서 바꾸지는 마세요.
오류: HTTP 404 Not Found
원인 및 해결 방법: 요청 경로가 존재하지 않거나 서버가 만료된 리소스를 이 상태 코드로 숨기고 있을 수 있습니다. 전체 경로를 확인하고 이전 구독 엔드포인트를 사용 중인지 살펴보세요.
오류: HTTP 429 Too Many Requests
원인 및 해결 방법: 요청 횟수 제한에 걸렸습니다. 연속으로 새로고침하지 말고 서버에서 안내하는 대기 시간 이후 다시 시도하세요. 여러 기기에서 업데이트를 자주 요청하고 있는지도 확인하세요.
HTTP 200 응답을 받더라도 실제 내용은 구독 데이터가 아니라 "로그인하세요"라는 문구가 포함된 HTML 페이지일 수 있습니다. 읽을 수 있는 텍스트라고 해도 앱이 지원하는 서버 정보가 들어 있다는 보장은 없습니다. 웹페이지가 열린다는 사실만 확인하지 말고, 서비스 제공업체에 해당 주소가 현재 계정에 반환하는 실제 콘텐츠 유형을 확인하세요.
결론: 먼저 응답 내용을 확인한 뒤 파싱 문제를 살펴보세요
서버에서 로그인 페이지나 빈 목록을 반환한다고 확인됐다면 먼저 계정 또는 엔드포인트 상태를 해결하세요. 응답에 사용 가능한 서버 항목이 포함된 것을 확인한 다음에 형식 호환성과 업데이트 설정을 점검하면 됩니다.
4. 업데이트 시점: Settings → Subscribe 및 접속 경로 확인하기
Settings → Subscribe를 열어 구독 업데이트 관련 설정을 확인하세요. 특히 Update via Proxy를 살펴보세요. 이 설정은 구독 요청의 접속 경로를 지정하며, 잘못된 주소를 수정하거나 서버 항목을 만들어 주지는 않습니다. 처음 가져올 때 사용 가능한 서버가 하나도 없다면 이 옵션을 켜는 것만으로 요청이 성공한다고 가정할 수 없습니다.
- 먼저 수동으로 한 번 업데이트하세요. Home으로 돌아가 아래로 당겨 업데이트를 실행하고 대상 구독의 결과를 확인하세요. 한 번에 조건 하나만 변경하고, 변경 전후 메시지를 기록하세요. 주소, 네트워크, 라우팅 모드를 동시에 바꾸지 마세요.
- 기본 네트워크 연결을 확인하세요. 현재 Wi-Fi에서 웹페이지 인증이 필요하다면 먼저 시스템 네트워크 인증을 완료하세요. 일반 웹페이지가 열린다고 해서 구독 도메인에도 접속할 수 있다고 단정할 수는 없습니다.
- 그다음 Update via Proxy 사용 여부를 결정하세요. 사용 가능한 서버가 있고 구독 엔드포인트 접속에 해당 경로가 필요하다면 이 옵션을 켜고 기존 서버에 연결한 다음 Home으로 돌아가 수동 업데이트하세요. 사용 가능한 서버가 없다면 먼저 구독을 처음 가져올 때 필요한 접속 조건부터 확인하세요.
- 자동 업데이트 조건을 확인하세요. Settings → Subscribe에서 현재 제공되는 업데이트 옵션과 상태를 확인하세요. 앱을 여는 시점, 수동 새로고침, 백그라운드 활동은 서로 다릅니다. 시스템의 백그라운드 실행 일정이 정확한 예약 작업이라고 간주해서는 안 됩니다.
- 앱을 열어 둔 상태에서 결과를 다시 확인하세요. 설정을 변경한 뒤 앱을 전면에 둔 채 수동 업데이트를 한 번 실행하세요. 연결 스위치가 켜져 있거나 일정 시간이 지났다는 이유만으로 구독이 갱신됐다고 판단하지 마세요.
Global Routing의 Proxy, Direct, Config, Scene은 라우팅 모드를 선택하는 항목이며 구독 업데이트 스위치와는 다른 설정입니다. Config 모드에서는 현재 Config의 규칙이 적용됩니다. 규칙 순서와 정책이 관련 요청의 경로에 영향을 줄 수 있지만, 주소와 응답 내용을 확인하기 전에 규칙을 광범위하게 바꾸지 마세요.
5. 목록이 계속 비어 있다면: 네 가지 질문으로 원인 좁히기
다음 네 항목은 첫 가져오기, 형식 인식, 네트워크 차이, 기존 항목 보존 여부를 각각 다룹니다. 실제 증상에 맞는 항목만 확인하세요. 모든 설정을 빠짐없이 시험할 필요는 없습니다. 프로토콜 이름은 연결 유형을 나타낼 뿐, Shadowsocks, VMess, VLESS, Trojan, Hysteria2 또는 WireGuard라는 이름만으로 구독 전체가 올바르게 파싱됐다고 판단할 수는 없습니다.
처음 가져온 목록부터 비어 있는데 연결 스위치를 켜야 하나요?
먼저 Home에 사용 가능한 서버가 있는지 확인하세요. 항목이 전혀 없다면 연결 스위치로 구독을 가져올 수 없습니다. 서비스 페이지로 돌아가 주소와 콘텐츠를 확인한 다음 Settings → Subscribe에서 Update via Proxy가 현재 조건에 맞는지 살펴보세요.
같은 주소가 브라우저에서는 열리는데 왜 파싱에 실패하나요?
브라우저가 이미 로그인된 상태일 수도 있고 로그인 페이지나 인증 페이지를 표시할 수도 있습니다. 웹페이지가 잘 표시되는지만 확인하지 말고, 서비스 제공업체에 앱이 해당 주소에 직접 요청했을 때 Shadowrocket에서 사용할 수 있는 구독 콘텐츠가 반환되는지 확인하세요.
Wi-Fi에서는 실패하지만 셀룰러 네트워크로 전환하면 업데이트됩니다. 주소가 잘못된 건가요?
다른 네트워크에서 같은 주소로 업데이트에 성공했다면 실패한 네트워크의 인증, 도메인 확인 또는 접속 제한을 먼저 살펴보세요. 주소와 Subscribe 설정은 그대로 두고 네트워크별 결과를 비교하세요. 구독 인증 정보를 동시에 재설정하면 어떤 변경으로 해결됐는지 알기 어렵습니다.
업데이트는 실패했지만 기존 서버는 사용할 수 있습니다. 삭제하고 다시 추가해야 하나요?
기존 항목은 그대로 두고 이번 업데이트 오류를 기록한 다음 서비스 상태를 확인하세요. 기존 서버 연결이 되는지와 구독 엔드포인트에 접속할 수 있는지는 별개의 문제입니다. 삭제하면 현재 사용할 수 있는 경로를 잃을 수 있으며 엔드포인트의 권한이나 응답 내용도 해결되지 않습니다.
6. 재확인 및 문의: 문제 파악에 도움이 되는 기록 남기기
문제가 해결되면 Home에서 대상 그룹에 예상한 항목이 실제로 표시되는지 확인한 뒤 서버 연결을 별도로 점검하세요. 서버 수가 많다고 해서 반드시 성공한 것은 아닙니다. 계정에서 현재 반환하는 내용과 일치해야 합니다. 기존 항목의 이름이 그대로라는 이유만으로 이번 업데이트가 실패했다고 판단하지 마세요.
- 작업 기록: 처음 추가한 구독인지 기존 구독 업데이트인지, 주소를 다시 복사했는지, Update via Proxy를 변경했는지 기록하세요.
- 환경 기록: Wi-Fi와 셀룰러 네트워크 중 어떤 것을 사용했는지, 네트워크 인증이 필요한지, 업데이트 중 앱이 전면에 있었는지 기록하세요.
- 증상 기록: 그룹이 표시되는지, 펼쳐져 있는지, 기존 항목이 남아 있는지, 오류 메시지 전체가 무엇인지 기록하세요.
- 비교 결과 기록: 주소를 그대로 두고 네트워크만 바꾼 결과 또는 네트워크를 그대로 두고 업데이트 경로만 바꾼 결과를 기록하세요.
- 인증 정보 보호: 이용 중인 서비스 제공업체의 공식 지원 채널로 문의하세요. 스크린샷에서는 구독 주소 전체와 인증 정보를 먼저 가리세요.
주소 유효성, 계정 권한, 반환 콘텐츠는 이용 중인 서비스 제공업체에 확인하세요. 앱 메뉴와 설정의 의미는 튜토리얼 및 프로토콜 매뉴얼에서 확인할 수 있습니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 클라이언트 일회성 구매에는 회선 요금제가 포함되지 않으며, 앱을 구매해도 가져올 서버 목록이 제공되지는 않습니다.