Shadowrocket 구독 업데이트 방법: 수동 새로고침, 앱 실행 시 자동 업데이트 및 오류 해결

구독 업데이트, 앱 업데이트, 구성 업데이트 구분하기

구독 업데이트는 저장된 구독 주소에 다시 요청을 보내고, 응답 내용을 Home의 서버 항목으로 파싱하는 작업입니다. 서비스 제공업체가 서버 주소, 포트 또는 인증 정보를 변경했다면 새 구독 내용을 가져와야 합니다. VPN 연결을 끊었다가 다시 연결하는 것은 구독을 다시 가져오는 것과 다릅니다.

앱 업데이트는 App Store에서 제공되며 Shadowrocket 앱 자체가 바뀝니다. Config의 구성 파일은 규칙, DNS 등의 설정을 담고 있으며, 원격 업데이트는 Home의 서버 구독 새로고침과 별개의 작업입니다. 문제를 해결하기 전에 무엇을 업데이트하려는지 먼저 구분하세요.

Home에서 구독 수동 업데이트하기

처음 추가할 때는 서비스 제공업체가 구독 주소로 안내한 링크를 사용하세요. 계정 로그인 페이지, 주문 페이지 또는 웹페이지 공유 링크를 사용하면 안 됩니다. 이미 구독을 추가했다면 먼저 기존 항목을 유지하세요. 새로고침을 위해 반복해서 삭제하고 다시 추가하면 이전 상태와 비교하기 어려울 수 있습니다.

1. 구독 확인

   Home을 열고 업데이트할 구독 그룹을 찾아 자신이 이용하는 서비스 제공업체의 항목인지 확인하세요. 아직 추가하지 않았다면 Home 오른쪽 위의 “+”를 눌러 추가 화면으로 이동한 다음 Type에서 Subscribe를 선택하고 자신의 구독 주소를 URL에 입력해 저장합니다.

2. 현재 상태 기록

   대상 그룹의 현재 항목 수와 알고 있는 서버 하나의 이름 또는 포트를 기록합니다. 전체 URL, 비밀번호 또는 인증 매개변수는 스크린샷에 담지 마세요. 공개적으로 비교할 때 이런 정보는 필요하지 않습니다.

3. 아래로 당겨 새로고침

   Home으로 돌아가 목록을 아래로 당겨 구독을 업데이트하고, 요청이 완료될 때까지 기다립니다. 구독이 여러 개라면 그룹별로 결과를 확인하세요. 한 그룹의 성공을 전체 구독의 성공으로 간주하지 마세요.

4. 결과 확인

   오류가 표시되는지, 대상 그룹에 항목이 남아 있는지, 서비스 제공업체가 안내한 변경 사항이 반영됐는지 확인합니다. 항목 수가 그대로여도 업데이트 실패라고 단정할 수는 없습니다. 응답에서 주소, 포트 또는 인증 정보만 바뀌었을 수 있습니다.

5. 별도로 연결 확인

   사용하려는 서버를 선택한 다음 연결 및 접속 테스트를 진행하세요. 새로고침 성공은 구독을 가져와 파싱했다는 뜻일 뿐, 반환된 모든 서버에 연결할 수 있다는 보장은 아닙니다.

아래 값은 구독 URL의 구조를 알아보기 위한 예시일 뿐입니다. 가져오기에 사용하거나 실제 주소 대신 사용하면 안 됩니다. 실제 링크의 쿼리 매개변수에는 인증 정보가 포함되는 경우가 많으므로, 복사할 때 공백·줄바꿈·한글 문장부호가 들어가지 않도록 전체 주소를 그대로 유지하세요.

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

앱 실행 시 자동 업데이트 설정

수동 업데이트가 성공한 뒤 Settings → Subscribe로 이동해 Update On Open을 찾아 켭니다. 화면 언어나 앱 버전에 따라 표시 문구와 대소문자가 다를 수 있으니, 현재 구독 설정 화면에서 ‘앱을 열 때 업데이트’에 해당하는 옵션을 확인하세요.

• 켜기 전: 먼저 Home에서 수동 새로고침을 한 번 실행해 URL이 유효하고 현재 네트워크로 구독 내용을 요청할 수 있는지 확인하세요.
• 켠 뒤: Shadowrocket을 다시 열고 구독 요청 결과를 확인한 다음 Home에서 대상 그룹을 살펴보세요. 앱이 열렸다는 이유만으로 업데이트가 완료됐다고 판단하지 마세요.
• 확인할 범위: 앱 실행 시 업데이트는 앱 시작 시점에 관련된 동작입니다. 앱을 닫은 뒤에도 일정한 간격으로 계속 새로고침되거나, 앱을 전면으로 전환할 때마다 새 요청이 발생한다는 뜻은 아닙니다.
• 실패한 경우: 자동 업데이트가 실패하면 Home으로 돌아가 수동 업데이트를 한 번 실행하고 오류를 기록하세요. 자동 실행만으로 만료된 인증 매개변수나 연결할 수 없는 구독 도메인이 해결되지는 않습니다.

요청 흐름을 따라 업데이트 실패 지점 찾기

한 번의 업데이트는 다음 단계를 거칩니다. 여러 설정을 한꺼번에 바꾸기보다 먼저 어느 단계에서 실패했는지 확인한 뒤 해당 설정을 조정하는 편이 원인을 찾기 쉽습니다.

자주 표시되는 오류와 해결 순서

아래는 네트워크 요청에서 표시될 수 있는 원문 오류 또는 HTTP 상태 표현입니다. 표시 방식은 시스템 언어, 서버, 앱 화면에 따라 달라질 수 있습니다. ‘작동하지 않음’이라고만 기록하지 말고 실제로 표시된 오류 전체를 남기세요.

링크는 열리지만 사용할 서버 항목이 없는 경우

브라우저에서 웹페이지가 표시된다는 것은 어떤 형태로든 응답을 받았다는 뜻일 뿐, 반환된 내용이 구독이라는 뜻은 아닙니다. 로그인 페이지, 계정 잔액 페이지 또는 접속 인증 페이지도 HTTP 200을 반환할 수 있지만 서버 목록으로 사용할 수는 없습니다.

• 주소 출처 확인: 계정에서 구독 링크로 명확히 표시된 주소를 복사하세요. 브라우저 주소창에 표시된 관리 페이지 URL을 사용하면 안 됩니다.
• 응답 콘텐츠 유형 확인: HTML 페이지, 로그인 안내 또는 오류 JSON이 반환된다면 서버 측 접근 문제를 먼저 해결하세요. 서버 포트를 바꿔 해결하려고 하지 마세요.
• 형식 호환성 확인: 해당 링크가 Shadowrocket에서 인식할 수 있는 구독 형식을 제공하는지 이용 중인 서비스 제공업체에 확인하세요. 인코딩이 올바른 것과 프로토콜 필드가 완전한 것은 별개의 조건입니다.
• 변경 결과 확인: 주소를 바꾼 뒤에도 항목이 없다면 기존 그룹과 오류 기록을 보존하세요. 문제가 명확해지기 전에 기존 정보를 모두 삭제하지 마세요.

Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 프로토콜 이름이지 일반 웹페이지를 구독으로 변환하는 스위치가 아닙니다. 포트도 응답 내용이나 서비스 제공업체가 제공한 매개변수를 기준으로 확인하세요. 구독 URL이 HTTPS에서 흔히 쓰이는 포트 443을 사용하더라도, 그 안의 모든 서버가 443을 사용하는 것은 아닙니다.

업데이트 후 연결 확인 및 문제 기록

업데이트가 완료되면 먼저 Home에서 예상한 서버가 선택돼 있는지 확인한 뒤 Global Routing을 점검하세요. Proxy, Direct, Config, Scene은 트래픽 처리 방식이 서로 다르므로 현재 설정에 따라 접속 확인 결과가 달라질 수 있습니다. 이 항목들은 구독 업데이트 버튼이 아닙니다.

1. 선택 항목 확인: 서비스 제공업체가 항목을 삭제하거나 이름을 바꿨다면 아직 존재하는 항목을 다시 선택하세요. 이전 선택을 그대로 둔 채 결과를 판단하지 마세요.
2. 트래픽 분기 설정 확인: 원래 사용 목적에 맞게 Global Routing을 점검하세요. Config를 사용한다면 Config에서 현재 활성화된 구성 파일을 확인하세요. 규칙에 따라 테스트 요청이 선택한 프록시가 아닌 DIRECT로 처리될 수 있습니다.
3. 실제 접속 확인: 연결한 뒤 평소 이용하며 접근이 허용된 대상에 접속하고, 연결 로그에서 결과를 확인하세요. 지연 시간 테스트가 성공해도 모든 서비스 요청이 정상이라는 뜻은 아닙니다.
4. 필요한 기록만 보관: 새로고침 시각, 오류 원문, 네트워크 종류, 대상 그룹의 변경 여부, 연결 확인을 완료했는지 기록하세요. 한 번에 조건 하나만 바꾸면 문제를 재현하기 쉽습니다.