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

구독을 업데이트하면 무엇이 바뀌나요?

구독은 서버 목록을 가져오는 주소를 저장합니다. 업데이트할 때마다 Shadowrocket이 해당 주소에 요청을 보내 응답 내용을 읽고, 구독 그룹의 서버 항목을 갱신합니다. 서버에서 서버 이름, 주소, 포트 또는 연결 매개변수를 변경하면 새 목록이 기존 목록과 달라질 수 있습니다. 구독 업데이트는 클라이언트 앱을 업그레이드하는 기능이 아니며, 기존 서비스의 이용 기간을 자동으로 연장하지도 않습니다.

Home의 서버 구독과 Config의 규칙 설정은 서로 다른 항목입니다. 서버 구독을 새로 고쳐도 Config가 업데이트되는 것은 아니며, Global Routing이 자동으로 바뀌지도 않습니다. 문제를 확인하기 전에 어떤 종류의 주소를 다루는지 먼저 확인하세요. 규칙 파일 주소를 서버 구독 입력란에 넣지 않도록 주의해야 합니다.

• 기존 항목: 구독 그룹에서 가져온 항목은 해당 구독을 통해 관리됩니다. 직접 추가한 개별 항목에는 같은 업데이트 출처가 적용되지 않습니다.
• 현재 선택 항목: 업데이트 후 기존에 선택한 서버가 여전히 목록에 있는지 확인하세요. 전체 항목 수만 확인해서는 안 됩니다.
• 연결 결과: 목록 새로고침 성공 여부와 서버 연결 가능 여부는 별도로 확인해야 합니다. 연결 여부는 따로 테스트하세요.
• 기본 설정: 자동 업데이트와 요청 경로 관련 옵션의 상태는 현재 앱 화면을 기준으로 확인하세요. 모든 옵션이 기본적으로 켜져 있거나 꺼져 있다고 단정하지 마세요.

수동으로 당겨서 새로고침: 전체 업데이트를 먼저 확인

수동 새로고침은 처음 구독을 추가한 뒤 내용을 확인하거나, 이용 중인 서비스 제공자의 변경 안내를 받은 후 목록을 동기화하거나, 자동 업데이트 결과가 불분명할 때 다시 확인하기에 적합합니다. 작업 중에는 Shadowrocket을 화면에 띄운 상태로 두고 업데이트가 끝날 때까지 기다리세요. 계속 당겨 새로고침해도 유효하지 않은 주소가 해결되지는 않으며, 서버의 요청 빈도 제한에 걸릴 수 있습니다.

1. 그룹 확인

   Home으로 이동해 추가한 구독 그룹을 찾습니다. 아직 추가하지 않았다면 오른쪽 위의 “+”를 누르고 Type에서 Subscribe를 선택한 뒤, 본인의 전체 구독 주소를 입력하고 저장하세요.

2. 아래로 당겨 새로고침

   Home 목록을 아래로 당겨 구독을 새로고침합니다. 업데이트 상태를 확인하고 요청과 파싱이 완료될 때까지 기다리세요. 바로 앱을 나가지 마세요.

3. 목록 확인

   대상 그룹에 유효한 항목이 남아 있는지 확인하고, 변경이 예상되는 이름과 개수를 대조하세요. 목록에 변화가 없더라도 서버 내용이 그대로일 수 있으므로, 그것만으로 실패라고 판단할 수는 없습니다.

4. 연결 확인

   사용할 서버를 선택하고 Home에서 선택 표시가 나타나는지 확인한 다음 Connectivity Test를 실행하세요. 새로고침은 성공했지만 연결이 실패하면 해당 서버의 매개변수와 연결 경로를 확인하세요.

앱을 열 때 자동 업데이트: Update on Open 설정

Settings → Subscribe에서 Update on Open을 확인하세요. 이 옵션을 켜면 앱이 해당 시점에 구독 업데이트를 시도합니다. 계속 백그라운드에서 확인하는 기능이 아니며, 앱을 닫은 뒤 일정한 분 간격으로 요청한다는 뜻도 아닙니다. 작동 조건과 화면 표시는 현재 앱을 기준으로 확인하세요.

먼저 수동 새로고침을 한 번 성공적으로 마친 뒤 이 옵션을 켜는 것이 좋습니다. 그러면 다음에 앱을 열었을 때 문제가 생겨도 자동 업데이트가 예상대로 실행되지 않은 것인지, 구독 자체를 업데이트할 수 없는 것인지 구분하기 쉽습니다. 앱을 열 때 인터넷 연결이 가능해야 하며, 자동 업데이트로 서버 인증, 만료일 또는 요청 제한을 우회할 수는 없습니다.

• 설정 위치: Settings → Subscribe를 열어 Update on Open의 현재 상태를 확인하세요. 앱을 열 때 목록을 동기화하려면 이 옵션을 켜면 됩니다.
• 확인 방법: 현재 그룹 내용을 기록해 두고, 나중에 앱을 다시 열었을 때 업데이트 알림과 결과를 확인하세요. 서버 내용이 바뀌지 않았다면 목록이 그대로인 것이 정상입니다.
• 임시 문제 해결: 앱을 열 때마다 실패 알림이 표시되면 먼저 이 옵션을 끄고 구독 하나씩 업데이트해 원인을 확인하세요. 문제가 해결된 뒤 다시 켤지 결정하면 됩니다.
• 기능 범위: Settings → On Demand는 조건에 따른 연결을 관리하는 설정이지 구독 새로고침 일정이 아닙니다. 자동 업데이트를 켜기 위해 On Demand를 변경하지 마세요.

앱을 연 뒤 네트워크가 아직 준비되지 않은 경우, 예를 들어 Wi-Fi를 전환했거나 네트워크 로그인을 진행 중인 경우에는 네트워크가 복구되기 전에 업데이트 요청이 실패할 수 있습니다. 먼저 네트워크 연결을 완료한 다음 Home으로 돌아가 수동 새로고침을 한 번 실행해 확인하세요. 모든 구독을 다시 추가할 필요는 없습니다.

구독별로 하나씩 업데이트: 문제 범위 좁히기

구독이 여러 개일 때 한 그룹의 업데이트가 성공했다고 해서 다른 그룹도 성공한 것은 아닙니다. 구독별 업데이트를 실행하면 문제를 특정 주소로 좁힐 수 있어, 특정 서버의 문제를 앱 전체의 네트워크 오류로 오해하지 않게 됩니다. 이 절차는 사용자가 이미 보유한 구독을 전제로 합니다. 이 사이트는 서버나 구독을 제공하거나 판매하거나 추천하지 않습니다.

1. Home에서 확인할 구독 그룹을 찾아 이름과 현재 항목 수를 먼저 기록하세요. 이름이 같은 다른 그룹과 혼동하지 않도록 확인합니다.
2. 해당 구독 그룹의 작업 메뉴를 열고 Update를 선택해 그 구독만 업데이트하세요. 메뉴 위치는 현재 앱 화면을 기준으로 확인하고, 삭제를 선택하지 않도록 주의하세요.
3. 결과가 나올 때까지 기다리고 오류 메시지를 전체 기록하세요. 성공하면 해당 그룹의 내용을 확인하고, 실패하면 기존 그룹을 유지한 채 계속 확인합니다.
4. 같은 네트워크에서 이미 보유한 다른 구독도 업데이트해 비교하세요. 하나만 실패했다면 해당 주소와 서버 상태를 먼저 확인하세요. 여러 구독이 모두 실패했다면 공통으로 사용하는 네트워크 경로를 확인합니다.

업데이트 실패: 오류 메시지와 응답 내용에 따라 확인

도메인 확인, 연결 설정, 서버 응답 또는 응답 내용 파싱 단계에서 실패할 수 있습니다. 먼저 발생 시각, 사용 중인 네트워크, 대상 그룹, 표시된 메시지 원문을 기록한 뒤 다음 조치를 판단하세요. 아래 영어 문구는 네트워크 요청에서 표시될 수 있는 오류 메시지나 HTTP 상태입니다. 실제 표시 방식은 앱과 서버에 따라 다르며, 항상 같은 메시지가 나타나는 것은 아닙니다.

요청은 성공했지만 목록이 비어 있음

HTTP 요청 성공은 응답을 받았다는 뜻일 뿐, 응답에 유효한 서버 항목이 포함되어 있다는 보장은 아닙니다. 주소가 계정 로그인 페이지, 오류 안내 페이지 또는 빈 내용을 반환할 수 있습니다. 복사할 때 매개변수를 빠뜨려도 서버가 예상과 다른 페이지를 반환할 수 있습니다. 웹페이지가 열린다는 이유만으로 구독이 유효하다고 판단하지 마세요.

• 주소가 실제 서버 구독 주소인지 확인하세요. 계정 관리 페이지나 Config 파일 주소가 아닌지 확인합니다.
• 주소 앞뒤에 공백, 줄바꿈 또는 따옴표가 들어갔는지 확인하세요. 특히 ? 뒤의 매개변수가 빠짐없이 포함되어 있는지 살펴봅니다.
• 본인이 이용하는 서비스 제공자에게 현재 응답 형식이 Shadowrocket에서 사용할 수 있는지, 실제로 유효한 항목이 포함되어 있는지 확인하세요.
• 문제 확인을 위해 응답 내용을 제출해야 한다면 구독 주소, token, 비밀번호 등 민감한 정보를 먼저 삭제하세요. 전체 구독 내용을 공개적으로 붙여넣지 마세요.

Update via Proxy: 필요한 경우에만 요청 경로 변경

Settings → Subscribe의 Update via Proxy는 구독 업데이트 요청을 프록시 경로로 보낼지 설정합니다. Update on Open과 해결하는 문제가 다릅니다. 전자는 업데이트 요청을 보내는 경로에, 후자는 업데이트를 시도하는 시점에 관한 설정입니다. 프록시를 통한 업데이트를 켜도 잘못된 token이 수정되거나 로그인 페이지가 서버 목록으로 바뀌지는 않습니다.

• 직접 연결로 업데이트 가능: 현재 작동하는 설정을 유지하세요. 구독을 업데이트하려고 Global Routing, DNS, Config를 함께 변경할 필요는 없습니다.
• 현재 네트워크에서 구독 주소에 접근할 수 없음: 먼저 사용 가능한 기존 서버에 연결한 뒤 Update via Proxy를 켜고 대상 구독만 업데이트해 보세요.
• 사용 가능한 연결이 없음: Update via Proxy만 켜서는 사용할 수 있는 프록시 경로가 생기지 않습니다. 기존 연결 조건을 먼저 복구하거나 구독 주소에 접근할 수 있는 네트워크에서 업데이트해야 합니다.
• 설정을 바꾼 뒤에도 실패: 변경 전후의 오류 메시지가 달라졌는지 기록하세요. 계속 401 또는 403이 표시되면 요청 경로를 계속 바꾸기보다 권한을 먼저 확인해야 합니다.

한 번에 한 가지 설정만 변경하세요. 예를 들어 구독 주소는 그대로 두고 네트워크만 바꿔 다시 시도한 다음, 프록시 업데이트 설정을 확인합니다. 이렇게 하면 어떤 단계가 결과에 영향을 주었는지 파악하기 쉽고, 기존에 작동하던 상태로 되돌리기도 편합니다.

자주 묻는 질문: 업데이트 빈도와 연결 확인