Shadowrocket 구독 및 서버 관리

먼저 입력 내용의 용도 확인

가져오기 전에 이미 보유한 전체 구독 주소를 준비하고, 서비스 제공자가 Shadowrocket용으로 안내한 주소인지 확인하세요. 경로, 쿼리 매개변수, 토큰이 함께 목록을 결정할 수 있으므로 도메인만 복사해서는 충분하지 않을 수 있습니다. 페이지 제목이나 링크 길이만으로 용도를 판단하지 말고, 계정 안내·로그인·갱신 페이지 주소를 구독 입력란에 넣지 마세요. 웹페이지에 접속할 수 있다는 사실과 구독 내용을 파싱할 수 있다는 것은 별개입니다.

서버 항목에는 연결에 필요한 프로토콜과 매개변수가 저장되고, 구독은 원격에서 해당 항목을 가져오며, Config는 규칙과 DNS 등의 동작을 제어합니다. 세 항목은 함께 존재할 수 있지만 서로 대체할 수 없습니다. 구독을 가져온 뒤 서버 목록이 표시되어도 가져오기와 파싱이 완료되었다는 뜻일 뿐, 선택한 서버에 연결할 수 있거나 기존 규칙이 트래픽을 예상대로 처리한다는 뜻은 아닙니다.

Home에서 Subscribe 항목 만들기

Home에서 추가 메뉴를 열고 Add Server로 이동한 다음 Type에서 Subscribe를 선택하세요. 실제 메뉴 위치는 앱 화면을 기준으로 확인합니다. URL에 전체 주소를 붙여 넣고 구독을 알아보기 쉬운 이름으로 표시한 뒤 저장하세요. 앱에서 구독 가져오기나 업데이트 여부를 묻는다면 안내에 따라 진행합니다. 작업 중 네트워크가 연결되어 있는지 확인하고, 처리 중 같은 주소를 반복해서 추가하지 마세요. 비슷한 구독 그룹이 여러 개 생길 수 있습니다.

저장하기 전에 주소 앞뒤에 공백, 줄 바꿈, 따옴표 또는 한글 문장 부호가 섞이지 않았는지 확인하세요. 메신저에서 긴 주소가 자동으로 줄 바뀌어도 복사한 주소가 반드시 잘린 것은 아니지만, 이미지에서 문자를 인식하면 잘못 읽힐 수 있습니다. 특히 물음표 뒤의 내용, 대소문자를 구분하는 토큰, 퍼센트 인코딩을 확인하세요. 주소는 접속 정보이므로 앱에 직접 붙여 넣고, 형식을 확인한다며 낯선 웹페이지에 입력하지 마세요.

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

위 내용은 형식 예시일 뿐 실제로 사용할 수 있는 구독 주소가 아닙니다. 실제 주소는 이용 중인 서비스 제공자에게서 받으세요. 예시에서 물음표 뒤의 token은 쿼리 매개변수이며, 모든 구독이 같은 매개변수 이름을 사용한다고 볼 수는 없습니다. 일부 주소는 식별 정보를 경로에 포함합니다. 확인할 때 원문을 그대로 유지하고, 보기 좋게 정리한다며 일부를 삭제하거나 예시의 매개변수를 임의로 추가하지 마세요.

저장 후 네 가지 항목 확인

처음 가져오기가 완료되면 구독 그룹이 표시되는지, 서버 항목이 있는지, 프로토콜이 보유한 정보와 일치하는지, 이름으로 그룹을 구분할 수 있는지 차례로 확인하세요. 목록이 비어 있다면 먼저 기존 주소를 보관하고 앱의 안내 문구를 확인한 뒤 서비스 제공자가 구독 주소를 변경했는지 확인합니다. 서버를 하나씩 바로 수정하거나 기존 목록을 먼저 삭제하지 마세요. 가져오기 실패와 서버 연결 실패는 구분해서 처리해야 합니다.

목록이 정상적으로 표시되지만 모르는 이름이 있다면 이름을 연결 품질이나 위치의 보증으로 여기지 말고 기존 구독 안내와 먼저 대조하세요. 표시 이름은 구독 내용에 따라 정해지며 이후 업데이트에서 바뀔 수 있습니다. 특정 항목을 추적해야 한다면 목록에서 보이는 순서만 기억하지 말고 소속 구독과 프로토콜도 함께 기록하세요.

[Check]

구독 가져오기 성공, 서버 테스트 성공, 실제 요청 성공은 서로 다른 확인 단계입니다. 순서대로 각각 확인하고, 하나의 결과로 나머지를 대신 판단하지 마세요.

파싱에 실패하면 전체 주소와 현재 네트워크를 먼저 확인한 뒤 응답 내용이 여전히 구독 데이터인지 살펴보세요. 원격 서버에서 로그인 안내, 오류 페이지 또는 빈 내용을 반환하면 요청에 응답이 있더라도 서버 목록을 만들 수 없습니다. 세부 점검 절차는 구독 목록이 비어 있거나 파싱에 실패할 때 확인하기를 참고하세요. 오류 문구만 보관하고 다른 사람에게 도움을 요청할 때 전체 토큰을 공유하지 마세요.

같은 구독이 이미 있다면 다시 가져오기보다 기존 항목을 업데이트하세요. 새 주소를 시험해야 한다면 다른 이름으로 임시 그룹을 만들고 기존 그룹은 비교용으로 남겨 두세요. 새 목록이 완전하고 실제 요청도 성공하는지 확인한 뒤 기존 항목을 삭제할지 결정합니다. 이렇게 진행하면 원격 내용 변경과 로컬 작업의 영향을 구분할 수 있어 실수로 삭제한 뒤 원인을 파악하기 어려워지는 일을 줄일 수 있습니다.

Scan QR Code가 모든 페이지를 인식하는 것은 아닙니다

Scan QR Code를 사용하기 전에 QR 코드가 본인이 보유한 서버 정보나 구독 안내에서 제공된 것인지 확인하세요. QR 코드에는 단일 공유 링크가 담길 수도 있고 웹페이지 주소만 담길 수도 있습니다. 스캐너가 내용을 읽었다고 해서 앱이 이를 서버로 변환할 수 있는 것은 아닙니다. 스캔 후 일반 페이지가 열리거나 파싱할 수 없다는 안내가 표시되면 원래 안내에서 용도를 확인하세요. QR 코드 옆에 서버 이름이 적혀 있다는 이유만으로 가져오기용 코드라고 판단하지 마세요.

다른 화면의 QR 코드를 스캔할 때는 코드 전체가 카메라 화면에 들어오도록 하고 빛 반사, 모서리 잘림, 여러 코드가 한 화면에 잡히는 상황을 피하세요. 내용이 긴 QR 코드는 더 촘촘할 수 있으므로 너무 작게 표시하면 인식이 어려울 수 있습니다. 여러 번 압축된 메신저 미리보기 이미지보다 원본의 선명한 이미지를 사용하세요. 인식 실패는 이미지나 내용 문제일 수 있으며 서버가 만료되었다는 뜻은 아닙니다.

시스템에서 카메라 권한을 요청하면 실제 작업에 필요한 권한을 허용하세요. 이전에 거부했다면 시스템 설정에서 Shadowrocket의 카메라 접근 권한을 확인한 뒤 다시 스캔합니다. 권한 문제는 서버 인증과 무관하므로 구독 주소를 수정할 필요가 없습니다. 앱에 다른 이미지 인식 메뉴가 있더라도 현재 화면을 기준으로 확인하고, 모든 시스템이나 기기에서 버튼 위치가 같다고 가정하지 마세요.

클립보드 가져오기에서는 원래 문자열을 그대로 유지하세요

공유 링크를 복사할 때 프로토콜 접두사부터 매개변수와 이름까지 전체를 선택하세요. 메시지의 설명, 번호, 글머리 기호, 코드 블록 표시는 링크에 포함되지 않습니다. 앱에 클립보드 가져오기 메뉴가 있다면 복사 후 앱에서 직접 실행하고 시스템 안내에 따라 필요한 접근을 허용하세요. 시스템 안내가 표시되지 않는다고 복사에 실패한 것은 아닙니다. 준비한 링크를 다른 내용으로 덮어쓰지 않도록 연달아 다른 항목을 복사하지 마세요.

한 번에 복사한 여러 링크를 일괄 가져올 수 있는지는 해당 메뉴가 내용을 어떻게 인식하는지에 따라 다릅니다. 확인하기 쉽도록 처음에는 한 개만 가져와 파싱 결과를 확인한 뒤 나머지를 처리하세요. 여러 줄의 텍스트에 설명, 빈 줄, 웹페이지 표시가 섞여 있으면 일부 줄이 무시될 수 있습니다. 가져온 뒤 실제 항목을 하나씩 확인하세요. ‘가져오기 완료’ 안내만으로 모든 정보가 저장되었다고 단정할 수 없습니다.

시스템에서 붙여넣기를 허용할지 묻는 경우 거부했다면 앱이 제공하는 메뉴에서 다시 시도하고 권한 안내를 확인하세요. 복사 기능과 구독 네트워크 요청은 별개의 과정입니다. 클립보드에서 내용을 읽지 못했다면 입력 단계의 문제이고, 구독 항목은 만들어졌지만 가져오기에 실패했다면 요청 단계의 문제입니다. 어느 단계에서 실패했는지 먼저 구분해야 올바른 주소나 서버 매개변수를 반복해서 수정하는 일을 피할 수 있습니다.

가져온 뒤에는 이름만 보지 말고 항목을 대조하세요

단일 공유 링크를 가져온 뒤 Type, 주소, 포트, 필요한 TLS 및 전송 항목을 확인하세요. 이름이 맞아도 다른 매개변수가 모두 읽혔다는 뜻은 아닙니다. 일부 형식은 이름을 퍼센트 인코딩합니다. 인코딩 문자가 보이거나 표시 방식이 달라도 연결에 영향이 없을 수 있지만, 링크 매개변수가 이름에 들어갔거나 이름이 주소 입력란에 남지 않았는지 확인하세요.

구독 QR 코드를 가져온 뒤에는 이번 목록의 서버 한 대만 저장된 것이 아니라 업데이트 가능한 구독 항목이 만들어졌는지도 확인하세요. 확인 기준은 QR 이미지의 제목이 아니라 앱에 저장된 항목 유형과 업데이트 메뉴입니다. 계속 업데이트해야 한다면 그중 서버 하나만 복사하기보다 올바른 구독 항목을 유지하는 편이 좋습니다. 단일 항목을 가져와도 일반적으로 구독 업데이트 관계까지 자동으로 이어지지는 않습니다.

[Privacy]

QR 코드, 공유 링크, 클립보드 내용에는 전체 인증 정보가 포함될 수 있습니다. 공용 인식 페이지에 업로드하지 말고, 화면을 캡처해 도움을 요청하기 전에 QR 코드, 비밀번호, 쿼리 토큰을 제거하세요.

QR 코드를 반복해서 스캔하면 비슷한 항목이 여러 개 생길 수 있습니다. 정리하기 전에 소속 그룹, 프로토콜, 주소를 비교하고 현재 선택된 항목이 무엇인지 확인하세요. 이름이 같아도 매개변수가 다르면 중복으로 보고 바로 삭제하면 안 됩니다. 이름이 달라도 주소는 같고 인증 또는 전송 설정이 다를 수 있습니다. 확실하지 않다면 두 항목을 모두 보관하고 임시 이름으로 구분한 뒤 테스트 장의 절차에 따라 하나씩 비교하세요.

가져오기가 끝나면 클립보드를 일반 텍스트로 바꿔 인증 정보가 실수로 붙여 넣어질 가능성을 줄일 수 있습니다. 다만 이미 공유한 정보가 취소되는 것은 아닙니다. 전체 링크가 공개된 적이 있다면 이용 중인 서비스의 관리 메뉴에서 인증 정보를 변경한 뒤 앱에 저장된 내용도 업데이트하세요. 입력 방식이 편리하더라도 인증 정보 관리를 대신할 수는 없습니다. 원본 공유 정보는 계속 민감 데이터로 취급해야 합니다.

업데이트 전에 비교할 상태를 기록하세요

구독을 업데이트하면 서버가 추가·삭제·이름 변경될 수 있고 주소, 포트, 인증 정보가 바뀔 수도 있습니다. 실행하기 전에 올바른 그룹을 선택했는지 확인하고 현재 선택된 항목과 소속 구독을 기록하세요. 연결 문제를 확인 중이라면 먼저 오류 상황을 적어 둔 다음 새로고침하는 것이 좋습니다. 그렇지 않으면 목록이 바뀐 뒤 기존 문제와 새 매개변수가 섞여 어느 작업이 결과를 바꿨는지 판단하기 어려워집니다.

업데이트 후 로컬에서 직접 수정한 내용이 유지된다고 가정하지 마세요. 구독 항목은 원격 내용으로 관리되므로 로컬 이름, 정렬 순서, 항목이 유지되는지는 실제 업데이트 결과에 따라 다릅니다. 별도로 관리해야 하는 매개변수는 직접 입력 항목으로 만들고 용도를 표시하세요. 업데이트 전에 기존 그룹을 비울 필요도 없습니다. 이전 상태를 남겨 두면 가져오기에 실패했을 때 앱이 기존 데이터를 유지하는지 확인하는 데 도움이 됩니다.

수동 업데이트와 자동 업데이트의 역할

서비스 제공자가 매개변수 변경을 안내했거나 목록이 오래된 것처럼 보일 때, 또는 최초 가져오기 후 다시 확인할 때 수동 업데이트를 사용하세요. 해당 구독에서 업데이트를 실행하고 완료될 때까지 기다린 뒤 안내 문구와 그룹 내용을 확인합니다. 짧은 시간 안에 연속으로 탭해도 원격 오류가 해결되지는 않으며 결과를 구분하기 어려워질 수 있습니다. 한 번 실패했다면 다음 단계로 넘어가기 전에 오류가 네트워크, 인증, 파싱 중 어디에 해당하는지 확인하세요.

현재 앱에 자동 업데이트 관련 설정이 있다면 사용 빈도에 맞게 활성화하고 옵션을 확인할 수 있습니다. 시스템의 백그라운드 작업은 네트워크, 기기 상태, 시스템 제한의 영향을 받으므로 업데이트 주기를 설정했다고 해서 매번 정해진 시각에 요청이 완료되는 것은 아닙니다. 중요한 변경 사항을 확인해야 한다면 앱에서 실제 목록을 확인하고 필요하면 직접 새로고침하세요. 백그라운드 작업이 실행될 것으로 예상되는 시간에만 의존하지 마세요.

구독 업데이트가 사용하는 네트워크 경로는 현재 연결 상태, 라우팅 모드, 앱 설정에 따라 달라질 수 있습니다. 연결을 켠 상태에서 업데이트에 실패하고 끈 뒤 성공했다면 경로 차이를 확인할 이유는 있지만, 특정 서버가 고장 났다고 바로 단정할 수는 없습니다. 같은 기본 네트워크에서 비교하고 한 번에 한 조건만 바꾸세요. 네트워크를 바꾸고 주소를 교체한 뒤 구독 전체를 다시 가져오는 작업을 동시에 하지 마세요.

실패한 단계에 맞게 처리하고, 재설정으로 진단을 대신하지 마세요

요청 단계 실패는 연결할 수 없음, 시간 초과, 이름 확인 오류 등으로 나타날 수 있습니다. 이때는 기기에서 현재 네트워크를 정상적으로 사용할 수 있는지 확인하세요. 인증 또는 접근 단계에서 실패하면 주소에 인증 정보가 빠짐없이 포함되어 있는지, 원격에서 기존 주소를 폐기했는지 확인합니다. 파싱 단계에서 실패하면 반환 내용이 여전히 구독 형식인지 확인하세요. 단계마다 확인 대상이 다르므로 모두 ‘서버를 사용할 수 없음’으로 뭉뚱그리지 마세요.

원격에서 구독 주소를 변경했다면 기존 구독의 해당 항목을 수정한 뒤 업데이트 결과를 확인하세요. 그룹 이름만 바꿔도 요청 주소는 바뀌지 않으며, 서버 한 대만 수정해도 구독 전체의 진입점이 고쳐지지는 않습니다. 주소를 변경하기 전후로 비교할 그룹 두 개를 잠시 유지할 수 있지만, 어느 쪽이 이전 기록인지 명확히 표시하세요. 그래야 새 주소가 여전히 적용되지 않았다고 오해하며 이전 그룹을 계속 사용하는 일을 막을 수 있습니다.

[Update boundary]

업데이트 성공 안내가 표시되어도 목록에 항목이 반드시 추가되는 것은 아니며 서버마다 연결이 보장되는 것도 아닙니다. 원격 내용이 바뀌지 않았다면 업데이트 후 목록이 그대로일 수 있습니다.

업데이트 후 그룹이 존재하는지, 항목 내용이 바뀌었는지, 현재 어떤 항목이 선택되었는지 순서대로 확인하세요. 원격 목록에서 서버가 빠지면 로컬에서 선택한 항목을 다시 확인해야 할 수 있습니다. 연결 스위치가 켜져 있다는 이유만으로 업데이트 전과 같은 항목을 사용 중이라고 판단하지 마세요. 규칙이 특정 이름의 객체를 참조한다면 해당 참조가 여전히 예상한 항목과 연결되는지도 확인하세요.

목록의 항목 수가 바뀌었다고 서비스 품질이 바뀌었다고 단정할 수 없습니다. 원격에서 항목을 분리하거나 합치거나 이름을 바꿨을 수 있으므로 실제 매개변수와 안내를 대조하세요. 여러 번 새로고침해도 예상한 내용을 받지 못한다면 오류 문구, 작업 순서, 완료한 확인 사항을 정리해 이용 중인 서비스의 관리 담당자에게 문의하세요. 문제 설명만 전달하고 공개된 곳에 전체 구독 주소를 올리지 마세요.

Shadowrocket 앱 자체는 App Store에서 확인하고 업데이트해야 하며 구독을 새로고침해도 앱이 업데이트되지는 않습니다. 앱 업데이트 여부, 호환성, 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 정식 다운로드 경로와 앱 ID 확인 방법은 정품 확인 안내를 참고하세요. 목록이 비어 있는 문제는 구독 요청 및 파싱 과정을 확인해야 합니다.

측정 대상과 테스트 방식부터 확인

Connectivity Test나 목록의 테스트 기능을 사용하기 전에 앱에서 사용하는 테스트 방식과 대상을 확인하세요. 방식에 따라 서버 포트 연결 시간을 측정할 수도 있고 프록시를 통한 테스트 대상 접근 과정을 포함할 수도 있어 결과의 의미가 다릅니다. 테스트 방식, 대상, 기본 네트워크, 시간 조건이 비슷해야 수치를 비교할 수 있습니다. 서로 다른 모드의 결과를 그대로 순위로 매기지 마세요.

테스트 수치는 한 번 또는 여러 번 측정한 결과이지 이후 모든 요청이 같은 결과를 낸다는 뜻은 아닙니다. 현재 네트워크 부하, 무선 신호, 서버 상태, 이름 확인, 대상의 응답이 모두 결과에 영향을 줄 수 있습니다. 한 번 높은 값이 나왔다고 항목을 바로 삭제하거나, 한 번 낮게 나왔다고 모든 용도에 적합하다고 판단하지 마세요. 네트워크를 유지한 채 몇 차례 반복해 결과가 일관적인지 확인한 뒤 전환 여부를 결정하세요.

시간 초과나 실패도 테스트 방식과 함께 해석해야 합니다. 테스트 대상에 연결할 수 없어 여러 서버가 동시에 실패할 수 있고, 프로토콜 항목이 잘못되어 특정 서버만 이상할 수도 있습니다. 테스트 실패가 서버 주소에 전혀 접근할 수 없다는 뜻은 아니며 테스트 성공이 특정 서비스 요청의 성공을 보장하지도 않습니다. 테스트 기능은 문제 위치를 찾는 단서로 사용하고 실제 요청으로 확인하세요.

재현 가능한 확인 순서 만들기

첫째, 네트워크 로그인 미완료나 불안정한 신호가 없는지 기본 네트워크를 확인합니다. 둘째, 이름이 비슷한 이전 항목을 테스트 중인 것은 아닌지 선택한 항목과 프로토콜 매개변수를 확인합니다. 셋째, 고정된 방식으로 테스트하고 결과가 나올 때까지 기다립니다. 넷째, Global Routing과 현재 Config를 확인한 뒤 필요한 대상을 직접 요청합니다. 각 단계에서 무엇을 확인했는지 설명할 수 있어야 합니다.

모든 항목이 동시에 실패하면 기본 네트워크, 공통 테스트 대상, 공통 설정을 먼저 확인하세요. 특정 구독만 실패하면 최근 업데이트 여부와 인증 정보 변경 여부를 살펴봅니다. 서버 한 대만 실패한다면 주소, 포트, TLS, 전송 매개변수를 확인하세요. 문제 범위를 좁히는 편이 앱을 다시 설치하거나 모든 구독을 지우는 것보다 확인 근거를 잘 보존하고 이미 올바른 설정을 다시 만들 필요도 줄입니다.

실제 요청을 비교하려고 모드를 임시로 바꿀 때는 기존 상태를 기록하고 확인이 끝나면 복원하세요. 한 번 성공한 결과를 얻기 위해 이해하지 못한 모드를 계속 사용하지 마세요. 특히 Config에서는 요청 대상이 DIRECT나 다른 정책에 매칭될 수 있습니다. 서버 목록에 낮은 지연 시간이 표시되어도 해당 요청이 그 서버를 사용한다는 증거는 아닙니다.

정렬은 표시 방식일 뿐, 선택 상태는 따로 확인하세요

지연 시간순 정렬은 이번 테스트에서 응답이 빠른 항목을 찾는 데 도움이 됩니다. 하지만 정렬은 자동 선택이나 지속적인 상태 확인과 같지 않습니다. 정렬한 뒤 현재 선택 표시를 확인하고 목록 첫 항목이 사용 중이라고 착각하지 마세요. 이번 테스트에서 일부 항목만 완료되었다면 미측정, 시간 초과, 측정 완료 결과를 같은 종류로 취급하지 말고 먼저 테스트 범위를 확인하세요.

여러 항목을 테스트하는 동안 구독을 새로고침하거나 항목을 이동하지 마세요. 목록이 바뀌면 테스트 대상, 이름, 위치를 바로 대조하기 어려울 수 있습니다. 테스트를 마치고 비교할 항목을 기록한 뒤 업데이트나 정리를 진행하세요. 다시 테스트할 때 같은 네트워크와 방식을 사용해야 새 매개변수 때문인지 기기가 다른 네트워크로 바뀌었기 때문인지 판단할 수 있습니다.

[Evidence]

테스트 방식, 기본 네트워크, 선택 항목, 실제 오류를 기록하면 지연 시간 숫자 하나만 남기는 것보다 문제 해결에 도움이 됩니다. 기록을 공유할 때는 모든 인증 정보를 삭제하세요.

실제 사용에서는 지연 시간과 속도도 구분해야 합니다. 응답 시간이 짧다고 대용량 파일 전송이 빠르거나 장시간 연결이 안정적이라는 뜻은 아닙니다. 테스트 대상, 네트워크, 사용 목적이 다르므로 이 페이지에서는 일률적인 합격 수치를 정하지 않습니다. 결과가 계속 달라진다면 먼저 같은 조건에서 재현하고, 잦은 일괄 테스트로 추가 요청을 만들지 마세요. 그런 다음 오류가 발생한 단계에 따라 매개변수, 구독, 규칙 관련 장을 확인하세요.