먼저 받은 항목이 서버 구독 URL인지, 개별 서버 공유 링크인지, 원격 구성 파일인지 확인한 뒤 알맞은 가져오기 방법을 선택하세요. 이미 이용 중인 서비스와 구독이 있는 사용자를 위해 Subscribe, Add Server, QR 코드, 클립보드의 용도를 설명합니다. Config의 원격 구성과 Home의 서버 목록은 별도로 확인해야 하며, 가져온 뒤에는 서버를 선택하고 연결을 테스트해야 합니다.
1. 서버 구독과 원격 구성 구분하기
Shadowrocket에서 ‘구독’은 원격으로 내용을 갱신하는 관계를 뜻하며, 모든 구독 항목을 같은 화면에 추가해야 한다는 의미는 아닙니다. Home에서는 서버와 연결을 관리하고, Config에서는 구성 파일과 규칙을 관리하며, Settings에서는 앱 설정을 관리합니다. 가져온 뒤 목록이 바뀌지 않았다면 반복해서 붙여넣기보다 먼저 현재 화면을 확인하세요.
서버 구독은 일반적으로 인식 가능한 서버 목록을 반환하는 HTTPS URL입니다. 원격 구성도 HTTPS URL을 사용할 수 있지만, 내용에 [General], [Rule] 등의 구성 섹션이 포함될 수 있습니다. 두 링크의 형태는 비슷하므로 https://로 시작한다는 이유만으로 용도를 판단할 수 없습니다. 기존 구독의 용도 안내와 실제 반환 내용을 기준으로 확인하세요.
| 보유한 항목 | 처리 방법 | 가져온 뒤 확인할 내용 |
|---|---|---|
| 서버 구독 URL | Home → + → Type → Subscribe | Home의 구독 그룹 및 서버 항목 |
| 서버 매개변수 | Home → + → Add Server 편집 화면에서 실제 Type 선택 | 서버 주소, Port, 인증 매개변수 |
| 서버 공유 QR 코드 | Home의 스캔 기능 | 인식된 유형과 대상 주소 |
| 클립보드에 복사한 공유 링크 | 전체 텍스트를 복사한 뒤 앱으로 돌아와 인식 결과 확인 | 가져온 항목이 개별 서버인지 구독인지 |
| 원격 구성 URL | Config의 원격 구성 추가 및 구독 관리 | 구성 파일 다운로드 여부와 선택 적용 여부 |
2. Subscribe: 서버 구독과 Config를 구분해 관리
서버를 여러 개 추가하려면 Home에서 추가 화면을 열고 Type을 Subscribe로 설정하세요. 서버 구독 URL을 규칙 파일로 취급해 Config에 넣으면 안 됩니다. 예시 https://example.com/sub?token=xxxx는 URL 형식을 설명하기 위한 것으로, 실제로 사용할 수 있는 구독 주소가 아닙니다. 실제 작업에서는 자신이 보유한 주소를 물음표 뒤의 쿼리 매개변수까지 빠짐없이 복사하세요.
-
내용 확인
제공처의 안내에서 서버 구독이라고 명시했는지 확인하고 URL 전체를 그대로 사용하세요. 웹페이지 제목이나 설명, 링크를 감싼 따옴표는 복사하지 마세요.
-
유형 선택
Home → 오른쪽 위 +를 눌러 Add Server 편집 화면으로 이동한 다음 Type에서 Subscribe를 선택하세요.
-
주소 입력
자신의 구독 URL을 해당 주소 입력란에 붙여 넣고 알아보기 쉬운 메모를 입력하세요. 저장하기 전에 줄바꿈, 공백, 한글 문장부호가 섞이지 않았는지 확인하세요.
-
저장 및 갱신
저장한 뒤 Home으로 돌아가 구독 그룹과 그 안의 항목을 확인하세요. 콘텐츠를 다시 가져와야 한다면 해당 구독을 갱신하고, 갱신이 끝난 뒤 목록을 확인하세요.
Config 화면의 Subscribe 또는 원격 구성 구독 관리 기능을 사용하려는 경우, 먼저 대상이 구성 파일인지 확인하세요. 구성 파일의 DOMAIN-SUFFIX, IP-CIDR, GEOIP, FINAL은 규칙에 속하며 서버 주소나 비밀번호 같은 매개변수와는 다릅니다. 원격 구성 다운로드에 성공해도 Home에 연결 가능한 서버가 추가되는 것은 아닙니다.
3. Add Server: 모든 매개변수를 알고 있을 때 직접 입력
Add Server는 서버를 추가하는 편집 화면이고 Subscribe는 여기서 선택할 수 있는 Type 중 하나입니다. 서버 한 대를 직접 입력할 때는 Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등 실제 프로토콜 유형을 선택하세요. 주소를 받았다는 이유만으로 무조건 Subscribe를 선택하면 안 됩니다.
직접 입력하려면 필요한 매개변수가 모두 있어야 합니다. 도메인과 Port만으로는 보통 연결할 수 없습니다. 프로토콜에 따라 비밀번호, UUID, 키, TLS 또는 전송 계층 매개변수가 필요할 수 있습니다. 각 필드는 서로 연관되어 있으므로 다른 서버의 설정을 참고해 알 수 없는 값을 임의로 채우지 마세요.
- 주소와 Port: 주소 입력란에는 서버 도메인이나 IP를 입력하고 Port에는 제공된 포트 번호를 입력하세요. TLS를 사용하더라도 포트가 항상
443인 것은 아니므로 원래 매개변수에 맞춰 각각 입력해야 합니다. - 인증 필드: 비밀번호, UUID, 키를 구분하세요. 구독 URL의 token을 서버 비밀번호 입력란에 넣으면 안 됩니다.
- TLS와 이름: 원래 매개변수에 SNI나 서버 이름이 있다면 그대로 입력하세요. 인증서 검증에 실패하면 먼저 이름과 기기 시간을 확인하세요.
- 전송 매개변수: Path, Host 등의 값은 대소문자를 구분할 수 있으며 경로의 슬래시도 매개변수에 포함됩니다. 값이 누락됐다면 기존 구성을 받은 곳에 확인하세요.
- 저장 결과: 저장한 뒤 Home으로 돌아가 예상한 서버가 나타났는지 확인하세요. 콘텐츠를 아직 가져오지 않은 구독 그룹만 저장된 것은 아닌지 살펴보세요.
ss://, vmess://, vless://, trojan:// 형식의 전체 공유 링크를 받았다면 링크 전체를 앱에서 인식시킨 뒤 파싱 결과를 확인하세요. 내용을 직접 분해하면 매개변수를 빠뜨리기 쉽습니다. 항목이 인식됐다는 것은 파싱이 완료됐다는 뜻일 뿐, 연결 가능 여부는 별도로 테스트해야 합니다.
4. QR 코드와 클립보드: 입력 방법은 달라도 콘텐츠 유형은 같습니다
다른 화면에 표시된 QR 코드를 사용할 때 적합한 방법입니다. Home의 스캔 기능을 열고, 처음 사용할 때는 카메라 접근을 허용한 뒤 QR 코드 전체가 화면에 들어오도록 비추세요. 인식한 뒤에는 내용이 서버 공유 링크인지, 구독 URL인지, 일반 웹 주소인지 확인한 다음 가져오세요.
같은 iPhone 또는 iPad에서 텍스트 링크를 받은 경우에는 클립보드로 가져오면 편리합니다. 전체 내용을 복사한 뒤 Shadowrocket으로 돌아오세요. 클립보드 인식 또는 가져오기 안내가 나타나면 항목을 확인하고 진행하세요. 붙여넣기를 허용할지 묻는 시스템 알림이 표시되면 이번 작업에 맞게 권한을 선택하세요. 자동 안내가 나타나지 않아도 링크가 만료됐다고 단정하지 말고 해당 추가 화면에서 직접 붙여 넣으세요.
입력 방법: 다른 화면 또는 현재 기기
다른 화면
- Home의 스캔 기능으로 QR 코드 전체를 읽으세요.
- 반사광이나 가림을 피하고 QR 코드 가장자리가 잘리지 않게 하세요.
- 웹페이지로 인식되면 단순 안내 페이지인지 먼저 확인하세요.
현재 기기
- 공유 텍스트 전체를 복사한 뒤 앱으로 돌아와 인식 결과를 확인하세요.
- URL을 복사할 때
?,&와 그 뒤의 매개변수를 빠뜨리지 마세요. - 자동 인식 안내가 나타나지 않으면 해당 추가 화면에서 직접 붙여 넣으세요.
QR 코드와 클립보드는 입력 방법일 뿐입니다. 최종적으로 서버 목록에 추가할지 구성 관리에 넣을지는 콘텐츠 자체에 따라 달라집니다.
구독 주소와 QR 코드에는 접근 자격 정보가 포함될 수 있습니다. 문제 해결을 위해 화면을 캡처할 때 전체 token, 비밀번호, 공유 QR 코드를 가리세요. 현상을 설명할 때는 오류 문구, 사용한 메뉴, 문제가 발생한 단계만 남기면 됩니다. 내용을 확인한다는 이유로 실제 구독 정보를 알 수 없는 변환 사이트에 제출하지 마세요.
5. Subscribe와 직접 입력 중 선택하기
서버 구독을 이미 보유하고 있고 목록을 계속 갱신해야 한다면 Subscribe 관계를 유지하는 편이 관리하기 쉽습니다. 서버 한 대의 매개변수만 있거나 특정 필드를 확인해야 한다면 직접 입력이 더 간단합니다. 아래 내용은 Shadowrocket의 추가 설정을 비교하며 서비스 품질을 평가하지 않습니다.
Subscribe 설정
추천서버 구독을 보유한 사용자는 구독 URL을 저장해 두면 원격 목록을 다시 가져올 수 있습니다. 갱신 결과는 원격 콘텐츠에 따라 달라지므로, 갱신 전에 직접 수정한 항목을 유지해야 하는지 확인하세요.
적합한 경우: 전체 구독 URL이 있고 서버 목록을 관리하려는 경우
개별 서버 설정
실제 프로토콜을 선택하고 매개변수를 입력하면 주소, Port, 인증 필드를 하나씩 확인하기 쉽습니다. 다른 구독의 내용이 바뀌더라도 새 매개변수가 자동으로 반영되지는 않습니다.
적합한 경우: 개별 서버의 전체 매개변수가 있거나 특정 서버를 분리해 확인하려는 경우
QR 코드로 서버 한 대를 가져와도 구독 갱신 관계가 자동으로 만들어지지 않으며 클립보드 가져오기도 마찬가지입니다. 갱신 가능 여부는 처음 어떤 입력 방법을 썼는지가 아니라 저장된 항목이 구독 URL인지 독립된 서버 항목인지로 판단하세요.
6. 가져오기 실패: 발생 단계별로 확인하기
‘가져올 수 없음’, ‘갱신 실패’, ‘연결할 수 없음’을 구분해 기록하세요. 첫 번째는 보통 콘텐츠 인식 단계에서, 두 번째는 원격 콘텐츠를 가져오거나 파싱하는 단계에서 발생합니다. 마지막 문제는 서버 항목이 이미 추가된 뒤에 생깁니다. 각각 확인할 항목이 다르므로 가져오기 방법을 계속 바꿔도 해결되지 않을 수 있습니다.
| 확인된 현상 | 먼저 확인할 항목 | 다음 단계 |
|---|---|---|
| 텍스트를 인식할 수 없다는 안내 | 전체 링크를 복사했는지, 올바른 프로토콜 접두사가 있는지 | 링크를 둘러싼 설명을 제거하고 링크 안의 문자는 그대로 둔 채 다시 붙여 넣으세요. |
| 구독 갱신 시 401 또는 403 응답 | URL의 자격 정보가 완전한지, 구독 권한이 유효한지 | 기존 구성을 받은 곳에 확인하고 서버 프로토콜 매개변수는 먼저 변경하지 마세요. |
| 구독 갱신 시 404 응답 | 경로가 만료됐거나 잘못 복사됐는지 | 전체 경로를 확인하세요. 도메인이 열리는지만 확인해서는 안 됩니다. |
| 갱신 시간 초과 | 현재 네트워크에서 구독 주소에 접근할 수 있는지 | Wi-Fi와 셀룰러 네트워크에서 각각 확인하고 한쪽에서만 실패하는지 기록하세요. |
| 요청은 성공했지만 서버가 나타나지 않음 | 응답이 로그인 페이지, 오류 페이지 또는 구성 파일인지 | 구독 형식과 가져오기 방법을 확인하세요. HTTP 요청이 성공했다고 해서 형식 확인을 건너뛰면 안 됩니다. |
| 서버는 나타났지만 연결할 수 없음 | 서버를 선택했는지, 매개변수와 라우팅 설정이 맞는지 | 연결 문제 진단으로 넘어가고 같은 항목을 다시 가져오지 마세요. |
가져온 뒤 최소한으로 확인할 사항
- Home으로 돌아가 사용할 서버를 선택하고 왼쪽에 선택 표시가 나타나는지 확인하세요.
- Global Routing을 확인하세요. Config는 현재 구성의 규칙을 따르고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다. Scene은 장면 설정과 관련되므로 테스트할 때 실제로 선택된 항목도 확인해야 합니다.
- Home의 연결 스위치를 켜세요. 처음 연결할 때는 시스템 안내에 따라 VPN 구성을 추가하도록 허용하세요.
- Connectivity Test를 실행하고 결과를 기록하세요. 테스트 성공은 해당 시점에 지정된 테스트 대상에 접근할 수 있었다는 뜻일 뿐, 모든 요청이 정상이라는 의미는 아닙니다.
- 연결이 자동으로 복구된다면 Settings → On Demand에서 온디맨드 연결 설정을 확인하세요. 자동 재연결을 가져오기 문제로 오해하지 않도록 주의하세요.
이제 구독 가져오기, 콘텐츠 파싱, 연결 테스트를 각각 확인했습니다. 계속 문제를 살펴볼 때는 오류 안내와 작업 순서를 기록하고 한 번에 하나의 변수만 바꿔 다시 시도하세요. 예를 들어 현재 네트워크만 바꾸거나 매개변수 하나만 확인하면 됩니다. 구독, 규칙, 연결 설정을 동시에 변경하면 원인을 찾기 어렵습니다. 규칙 문법은 규칙 매뉴얼에서 확인할 수 있습니다.