Shadowrocket 구독 파싱 실패·서버 목록이 비어 있을 때 확인할 항목

1. 먼저 구분하기: 콘텐츠를 가져오지 못한 경우와 콘텐츠에 서버가 없는 경우

Shadowrocket의 구독 업데이트는 여러 단계로 진행됩니다. 앱이 구독 주소에 요청을 보내고, 응답 내용을 읽은 다음, 인식 가능한 서버 항목을 Home에 표시합니다. ‘파싱 실패’가 반드시 프로토콜 설정 오류를 뜻하는 것은 아니며, 목록이 비어 있다고 해서 반드시 네트워크 연결이 끊긴 것도 아닙니다. 어떤 단계에서 멈췄는지 먼저 확인해야 관련 없는 설정을 반복해서 바꾸지 않을 수 있습니다.

• 요청이 완료되지 않음: 대기 후 시간 초과가 발생하거나 DNS, TLS, 연결 실패 메시지가 표시됩니다. 먼저 업데이트에 사용한 네트워크와 접속 경로를 확인하세요.
• 요청은 완료됐지만 파싱할 수 없음: 서버가 구독 본문 대신 로그인 페이지, 계정 안내 또는 오류 문구를 반환했을 수 있습니다. 먼저 주소의 용도와 서비스 제공업체가 반환한 형식을 확인하세요.
• 업데이트 후 항목이 없음: 응답이 원래 비어 있거나, 인식 가능한 항목이 없거나, Home에서 구독 그룹이 아직 펼쳐지지 않았을 수 있습니다. 표시 상태를 먼저 확인한 다음 서비스 제공업체에 내용을 문의하세요.

업데이트에 실패해도 기존에 저장된 서버는 목록에 남아 있을 수 있습니다. 따라서 ‘기존 항목이 남아 있다’고 해서 업데이트가 성공한 것은 아니며, ‘기존 항목으로 연결된다’고 해서 현재 구독 주소가 유효하다는 뜻도 아닙니다. 이번 업데이트 결과와 기존 항목의 연결 결과를 따로 기록하세요.

2. 링크 전체 확인하기: 계정 페이지 주소를 구독 주소로 사용하지 마세요

본인의 서비스 제공업체 계정 페이지에서 Shadowrocket용 구독 주소를 다시 복사한 뒤 Home에 저장된 해당 구독 주소와 비교하세요. 브라우저 주소창의 계정 홈 주소를 그대로 복사하거나, 개별 서버 공유 내용을 구독 주소로 사용하지 마세요. 구독 주소에는 보통 접속 인증 정보가 포함되므로 본인 기기에서만 확인하세요.

1. 시작 부분 확인: 서비스 제공업체가 지정한 프로토콜 부분(예: https://)을 포함해 주소 전체를 복사했는지 확인하세요. 도메인과 경로만 복사하면 안 됩니다.
2. 끝부분 확인: 채팅 앱에서 쿼리 매개변수가 잘리지 않았는지 확인하세요. 특히 ?, &, = 뒤의 내용에 유의하고, 기억에 의존해 임의로 입력하지 마세요.
3. 불필요한 문자 확인: 복사 과정에서 함께 들어간 바깥쪽 따옴표, 한글 문장 부호, 공백, 줄바꿈을 제거하세요. 주소 내부의 대소문자나 인코딩 문자는 임의로 바꾸지 마세요.
4. 주소 용도 확인: 서비스 제공업체가 Shadowrocket용이라고 안내한 구독 경로를 사용하세요. 로그인 주소, 결제 페이지, 설정 안내 페이지는 사용하지 마세요.
5. 저장한 뒤 한 번만 업데이트: Home으로 돌아가 해당 구독의 업데이트를 실행하고, 요청이 끝날 때까지 기다린 다음 결과를 확인하세요.

https://example.com/sub?token=xxxx

위 내용은 주소 구조를 설명하기 위한 예시이며 가져오기에 사용할 수 없습니다. 예시의 token=xxxx는 접속 인증 정보를 뜻합니다. 실제 주소의 인증 정보를 예시 값으로 바꾸면 안 됩니다. 원래 주소 전체를 반복해서 인코딩하거나 ‘형식에 맞아 보이게’ 하려고 쿼리 매개변수를 삭제하지 마세요.

3. 반환 결과에 따라 유효성과 콘텐츠 형식 확인하기

주소가 완전하더라도 오류 콘텐츠가 반환될 수 있습니다. 서비스 만료, 접속 인증 정보 재설정, 서버 유지 관리, 형식 변경으로 인해 이전에 작동하던 주소가 더는 예상한 구독 내용을 반환하지 않을 수 있습니다. 브라우저에서 페이지가 열린다는 것은 응답을 받았다는 뜻일 뿐, 응답 내용을 Shadowrocket이 파싱할 수 있다는 뜻은 아닙니다.

아래는 서버 응답을 확인할 때 참고하는 HTTP 표준 상태 설명입니다. Shadowrocket이 해당 오류 문구를 그대로 표시한다고 보장하는 것은 아닙니다. 앱에 실제로 표시되는 안내와 서비스 제공업체가 확인한 응답을 기준으로 판단하세요. 상태 코드를 확인하려고 인증 정보가 포함된 링크를 제3자 검사 사이트에 제출하지 마세요.

응답이 HTTP 200이어도 본문은 로그인 페이지나 안내 문구일 수 있습니다. 서비스 제공업체가 콘텐츠가 반환됐다고 확인했다면, 브라우저에서 읽는 페이지가 아니라 Shadowrocket이 인식할 수 있는 구독을 제공하는지 추가로 확인하세요. 파일 확장자, 크기, ‘요청 성공’이라는 문구만으로 형식 호환 여부를 판단하지 마세요.

4. 네트워크 조건을 하나만 바꿔 업데이트 테스트하기

구독 업데이트는 구독 서버에 요청을 보내는 작업이므로 특정 웹페이지에 접속한 결과와 같지 않습니다. 웹페이지가 열린다고 구독 도메인에도 접속할 수 있는 것은 아니며, 현재 프록시에 연결된다고 그 프록시를 통한 구독 요청도 성공하는 것은 아닙니다. 주소는 그대로 둔 채 업데이트 경로를 각각 확인해야 어떤 조건이 영향을 주는지 알 수 있습니다.

1. 기준 상태 기록: 현재 Wi-Fi와 셀룰러 네트워크 중 무엇을 사용하는지, 연결 스위치 상태와 이번 업데이트 안내를 기록하세요. 규칙, DNS, 구독 주소를 한꺼번에 바꾸지 마세요.
2. 접속 네트워크 전환: 가능하다면 Wi-Fi에서 셀룰러 네트워크로 전환하거나 그 반대로 바꾼 다음, 같은 구독을 한 번만 업데이트하세요. 공용 네트워크에서 웹 로그인이 필요하면 먼저 네트워크 인증을 완료하세요.
3. 업데이트 경로 확인: Settings → Subscribe로 이동해 Update via Proxy를 확인하세요. 현재 화면에 해당 옵션이 있다면 활성화하기 전에 사용할 프록시 연결이 정상인지 확인하세요. 비교가 필요하면 기존 값을 기록하고 테스트 후 원래대로 되돌리세요.
4. 순환 의존 방지: 사용 가능한 서버가 하나도 없다면 그 서버를 통해 새 서버를 업데이트하려고 하지 마세요. 먼저 구독에 직접 접속할 수 있는지 확인하거나, 본인의 서비스 제공업체에 접속 가능한 구독 경로를 문의하세요.
5. 시간 및 인증서 문제 확인: TLS 또는 인증서 안내가 표시되면 기기의 날짜와 시간이 올바른지 확인하고 서비스 제공업체에 인증서를 점검해 달라고 요청하세요. 인증서 확인을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.

Global Routing의 Config, Proxy, Direct는 트래픽 처리 방식이지 구독 형식 옵션이 아닙니다. Scene은 장면 설정과 관련된 기능이며, 잘못된 구독 본문을 서버 목록으로 변환해 주지 않습니다. 문제를 확인할 때 이러한 항목을 바꾸는 것을 파싱 해결책으로 여기지 마세요. 구독 업데이트에 어떤 경로를 사용할지는 관련 설정에서 따로 확인해야 합니다.

5. 업데이트 후에도 목록이 비어 있다면 Home 표시와 실제 항목 확인하기

Home으로 돌아가 먼저 검색 조건을 지우고 대상 구독 그룹을 펼치세요. 방금 업데이트한 구독을 보고 있는지, 이름이 같은 다른 그룹이나 수동으로 추가한 항목을 보고 있는 것은 아닌지 확인하세요. 그룹 이름이 표시된다는 사실은 구독 기록이 저장돼 있다는 뜻일 뿐, 그룹 안에 유효한 서버가 있다는 뜻은 아닙니다.

• 펼친 뒤 항목이 있음: 파싱 결과가 생성된 상태입니다. 이제 서버에 연결할 수 있는지 확인하세요. 연결에 실패하면 서버 주소, 포트, 인증 정보, 서비스 상태를 별도로 점검해야 합니다.
• 펼친 뒤에도 비어 있음: 서비스 제공업체가 실제로 서버를 반환했는지, 반환된 항목 형식이 Shadowrocket에 적합한지 확인하세요. 계정이 유효하다고 해서 현재 응답에 항목이 포함된다고 단정할 수는 없습니다.
• 일부 항목만 없음: 누락된 항목의 이름이나 프로토콜 종류를 서비스 제공업체에 알려 해당 부분의 형식을 확인해 달라고 요청하세요. 일부 항목이 없다는 이유만으로 네트워크 전체를 사용할 수 없다고 판단하지 마세요.

Shadowsocks, VMess, VLESS, Trojan 등의 프로토콜 이름은 서버 연결 방식을 나타내며, 구독 자체의 형식을 뜻하지는 않습니다. 같은 프로토콜도 매개변수 표현 방식이 다를 수 있으므로 필드 이름을 일괄 변경하지 말고 서비스 제공업체에 호환되는 콘텐츠를 요청하세요. 구독 주소의 HTTPS 포트를 서버의 Port에 입력하지 마세요.

6. 개인정보를 가린 기록을 남기고 결과에 따라 계속 조치하기

위 항목을 확인해도 해결되지 않으면 ‘다 해봤다’고만 말하는 것보다 재현 가능한 기록을 본인의 서비스 제공업체에 전달하는 편이 도움이 됩니다. 어느 단계에서 실패했는지, 네트워크 환경을 바꿨는지, 업데이트 전후에 항목이 있었는지 기록하세요. 전체 token, 비밀번호, 개인 키, 가리지 않은 QR 코드는 보내지 마세요.

1. 실패가 발생한 현지 시각, Wi-Fi 또는 셀룰러 네트워크 사용 여부, 앱에 표시된 원문 안내를 기록하세요.
2. 처음 가져올 때 실패했는지, 이전에는 정상이던 구독이 갑자기 업데이트되지 않는지 설명하고 기존 항목이 남아 있는지도 적으세요.
3. 구독 도메인과 민감 정보를 가린 경로 형태를 제공하고, 현재 유효한 주소를 다시 복사했는지 설명하세요.
4. Update via Proxy를 테스트했는지, 당시 프록시 연결을 사용할 수 있었는지, 네트워크를 전환한 뒤 결과가 달라졌는지 설명하세요.
5. 서비스 제공업체에 계정 유효성, 접속 제한, 구독 본문이 비어 있는지, 반환 형식이 Shadowrocket에 적합한지 확인해 달라고 요청하세요.