Shadowrocket 구독 가져오기 방법: Subscribe, Add Server, QR 코드·클립보드

이 글 미리보기

서비스 제공업체에서 받은 정보를 보유하고 있으며 Shadowrocket에서 처음 가져오기를 진행하려는 사용자를 위한 안내입니다. 서버 구독, 단일 공유 링크, 원격 구성을 구분한 뒤 Subscribe, Add Server, QR 코드 또는 클립보드 중 알맞은 경로를 선택하세요. 마지막으로 구독 업데이트, Global Routing, 연결 결과를 확인해 저장 성공을 실제 사용 가능 상태로 오해하지 않도록 합니다. 아래 절차는 iPhone / iPad의 화면 용어를 기준으로 하며, 다른 플랫폼에서는 해당 메뉴를 확인하세요.

1. 가져오기 전에 자료 유형 확인하기

구독 주소와 웹사이트 주소는 모두 https://로 시작할 수 있지만 용도는 다릅니다. 서버 구독은 파싱할 수 있는 서버 항목을 반환하고, 원격 구성은 설정 섹션, 규칙 또는 정책을 포함합니다. 서비스 제공업체의 계정 페이지는 웹페이지를 표시합니다. 계정 페이지 주소를 Subscribe에 붙여 넣어도 일반적으로 사용할 수 있는 서버 목록은 표시되지 않습니다. 링크의 용도에 대한 서비스 제공업체의 설명을 먼저 확인하고, URL 모양만으로 판단하지 마세요.

Home은 주로 서버 목록 확인, 서버 선택 및 연결에 사용하고 Config는 구성 파일, Settings는 앱 설정에 사용합니다. Config 페이지의 Subscribe와 Home → “+” → Type → Subscribe는 자료 유형에 따라 구분해야 합니다. 전자는 구성 구독 경로를, 후자는 서버 구독 추가를 처리합니다. 서버 목록을 가져왔다고 규칙 파일까지 설치된 것은 아니며, Global Routing이 Config로 전환된다는 뜻도 아닙니다.

서버 정보

구독 주소: https://example.com/sub?token=xxxx는 가상의 예시입니다.
단일 공유 링크: ss://, vmess://, vless://, trojan:// 등의 프로토콜 링크
주요 경로: Home → “+” → Type → Subscribe. 단일 항목은 QR 코드나 클립보드로 가져올 수도 있습니다.
가져오기 결과: Home에 구독 그룹 또는 개별 서버 항목이 표시됩니다.

링크 접두사는 형식만 나타냅니다. 파싱 가능 여부는 전체 내용과 현재 앱의 지원 여부에 따라 달라집니다.

구성 자료

원격 구성: 서비스 제공업체가 Shadowrocket용으로 명시해 제공한 구성 파일 주소
주요 경로: Config의 원격 구성 추가 또는 Subscribe 경로에서 페이지의 입력란에 URL을 입력합니다.
구성 내용: [General], [Rule] 등의 섹션이 포함될 수 있으므로 실제 파일 내용을 먼저 확인하세요.
적용 방법: 다운로드한 뒤 Config에서 사용할 구성을 선택하고 Global Routing을 확인합니다.

파일 확장자만으로는 파일 유형을 확실히 판단할 수 없습니다. 원격 주소가 확장자 없는 인터페이스를 통해 구성을 반환할 수도 있습니다.

2. Subscribe: 구독 가져오기 및 업데이트 결과 확인

서버 구독 URL이 있다면 여러 항목으로 나눠 수동 등록하기보다 Subscribe로 추가하는 것이 좋습니다. 서비스 제공업체가 서버 주소, 포트 또는 항목 수를 변경해도 같은 구독을 통해 업데이트할 수 있습니다. 구독 업데이트는 자료를 다시 가져오는 작업이지, 연결 속도 측정이나 서비스 기간 연장이 아닙니다.

자료 확인

서비스 제공업체 계정 페이지에서 Shadowrocket용 서버 구독 URL을 복사하고, 안내 문구나 줄바꿈, 앞뒤 공백이 함께 복사되지 않았는지 확인합니다.
유형 선택

Home → 오른쪽 위 “+”를 눌러 Add Server를 연 다음 Type을 Subscribe로 설정합니다. 일반 프로토콜의 Server 입력란에 구독 URL을 넣지 마세요.
구독 저장

URL 입력란에 전체 주소를 붙여 넣습니다. Remarks에는 알아보기 쉬운 이름을 입력한 뒤 저장합니다. 이 이름은 기기에서 식별할 때만 사용되며 구독에서 반환되는 내용에는 영향을 주지 않습니다.
항목 가져오기

Home으로 돌아와 구독 업데이트를 실행합니다. 목록에서 아래로 당겨 업데이트할 수 있다면 새로 고침해도 됩니다. 요청이 끝날 때까지 기다린 뒤 해당 구독 그룹에 서버 항목이 표시되는지 확인합니다.
구성 확인

서비스 제공업체가 별도의 구성 URL도 제공했다면 Config → Subscribe 또는 원격 구성 추가 경로에서 가져옵니다. 구성을 읽을 수 있는지 확인한 뒤 사용하도록 선택하세요. 서버 구독 URL을 구성 URL 대신 사용하지 마세요.

업데이트 후 항목 수가 줄어도 반드시 가져오기 실패는 아닙니다. 서비스 제공업체가 반환 내용을 삭제하거나 변경했을 수 있습니다. 계정의 유효 기간과 구독 안내를 대조한 뒤 오류 메시지가 있는지 확인하세요. 구독으로 생성된 서버 항목을 수동으로 수정하면 다음 업데이트에서 원격 내용으로 덮어쓸 수 있습니다. 계속 유지해야 하는 로컬 변경 사항은 따로 기록하고, 한 번의 수정이 계속 적용될 것이라고 기대하지 마세요.

3. Add Server: 프로토콜별 항목 직접 입력

자료가 구독이나 공유 링크가 아니라 Server, Port, Password처럼 분리된 입력값으로 제공되었다면 Home → “+” → Add Server를 사용하세요. 먼저 Type을 정한 뒤 각 항목을 입력합니다. 서버 도메인과 포트가 같더라도 프로토콜까지 같다는 뜻은 아닙니다. Type을 잘못 선택하면 저장되더라도 올바르게 연결할 수 없습니다.

프로토콜 또는 항목	확인할 자료	자주 하는 실수
Server / Port	호스트 이름 또는 IP와 포트를 각각 입력합니다. 자료에 포트가 443으로 적혀 있다면 프로토콜을 보고 임의로 정하지 말고 443을 입력하세요.	`https://`, 경로 또는 포트까지 Server 입력란에 함께 붙여 넣습니다.
Shadowsocks	Method와 Password를 확인합니다. 자료에서 플러그인을 요구한다면 관련 설정도 안내된 그대로 입력합니다.	Method가 일치하는지 확인하지 않고 Password만 입력합니다.
VMess / VLESS	UUID, 전송 방식, TLS 관련 항목을 확인합니다. 프로토콜별 추가 매개변수를 서로 섞어 쓰지 마세요.	UUID만 복사하고 WebSocket Path 또는 Host를 빠뜨립니다.
Trojan / Hysteria2	인증 정보와 TLS Server Name을 확인합니다. Hysteria2는 UDP 연결 가능 여부와 서버 요구 사항도 확인해야 합니다.	연결 IP를 반드시 올바른 TLS Server Name이라고 간주합니다.
WireGuard	기존 구성에 따라 Private Key, 상대방의 Public Key, Endpoint, 주소 등 필요한 정보를 확인합니다.	일반 구독 URL 한 개를 WireGuard 구성 내용으로 사용합니다.

예를 들어 서비스 제공업체가 Server는 example.com, Port는 443, TLS Server Name은 다른 도메인이라고 명시했다면 각 항목에 해당 값을 그대로 입력해야 합니다. 443은 포트 번호일 뿐이므로 TLS, 인증 또는 전송 설정을 생략해도 된다는 뜻은 아닙니다. 인증서 검증을 끄는 방식으로 도메인과 인증서 확인을 대신하지 마세요.

저장 전에 대소문자, 공백, 문장 부호를 항목별로 확인합니다. 특히 Password, UUID, 경로, 키를 꼼꼼히 확인하세요.
수동으로 추가한 항목은 일반적으로 서비스 제공업체의 구독 업데이트에 포함되지 않습니다. 주소나 인증 정보가 바뀌면 직접 수정해야 합니다.
자료가 불완전하다면 기본값을 추측해 채우지 말고 원래 서비스 제공업체에 누락된 항목을 문의하세요.

4. QR 코드와 클립보드: 인코딩된 내용 가져오기

QR 코드와 클립보드는 입력 방식일 뿐, 별도의 프로토콜이 아닙니다. QR 코드에는 단일 공유 링크가 들어 있을 수도 있고 웹 주소만 들어 있을 수도 있습니다. 클립보드에도 웹페이지 제목, 설명 또는 불완전한 여러 조각이 섞일 수 있습니다. 인식에 성공한 뒤에도 최종적으로 생성된 것이 단일 서버인지, 구독 그룹인지, 구성 자료인지 확인하세요.

QR 코드 가져오기

Home에서 QR 코드 아이콘을 찾아 스캔 화면을 엽니다. 처음 사용할 때는 시스템 안내에 따라 카메라 접근 권한을 허용하세요.
서비스 제공업체가 제공한 QR 코드를 비추고 전체가 화면에 들어오도록 합니다. 다른 기기에 표시된 QR 코드를 스캔할 때는 반사광이 생기거나 네 모서리가 잘리지 않도록 주의하세요.
QR 코드가 기기 사진 보관함에 있다면 스캔 화면의 사진 보관함 경로를 이용합니다. 해당 경로를 사용할 수 없으면 같은 자료의 텍스트 링크를 복사해 가져오세요.
인식 후 Type, Server, Port 등의 결과를 확인한 뒤 저장합니다. 일반 웹 URL만 인식되었다면 서버가 이미 가져와졌다고 간주하지 마세요.

클립보드에서 가져오기

먼저 ss://, vmess://, vless:// 또는 trojan://로 시작하는 단일 공유 링크를 전체 복사합니다.
Home으로 돌아와 “+” 추가 메뉴에서 Import from Clipboard를 엽니다. 앱에서 클립보드 읽기 확인을 요청하면 이번 가져오기에 필요한 경우 허용하세요.
인식된 항목을 확인한 뒤 저장합니다. 현재 화면에 해당 메뉴가 없다면 Add Server의 해당 입력란에 자료를 붙여 넣거나 서비스 제공업체가 제공한 QR 코드를 사용하세요.
https:// 구독 URL은 Type → Subscribe → URL로 돌아가 붙여 넣는 것이 좋습니다. 앱에 구독 링크임을 명확히 지정해 일반 웹 주소를 단일 공유 링크로 잘못 처리하지 않도록 하세요.

5. 가져온 뒤 Global Routing 및 연결 확인

Home에 서버가 표시된다는 것은 자료가 저장되었다는 뜻일 뿐입니다. 다음으로 보유한 서버 중 하나를 선택하고 연결 스위치를 켭니다. VPN 구성을 처음 생성할 때는 시스템 안내에 따라 권한을 허용하세요. 그런 다음 Home → Global Routing을 확인합니다. 모드에 따라 요청 처리 방식이 달라지므로 스위치가 켜져 있는지만 확인해서는 안 됩니다.

Config

권장

현재 선택된 구성의 규칙에 따라 요청을 처리합니다. 규칙에 일치하면 해당 규칙이 지정한 정책을 사용합니다. 일치하는 규칙이 없으면 이후 규칙과 FINAL 등의 기본 처리 설정을 따르며, 항상 직접 연결되는 것은 아닙니다.

적합한 경우: 구성을 확인하고 규칙에 따라 트래픽을 분기하려는 일상적인 사용

Proxy

가로채는 요청을 프록시로 처리합니다. 분기 규칙이 문제의 원인인지 확인할 때 사용할 수 있습니다. 인증 정보가 올바르고 전송 경로에 연결할 수 있어야 하며, 앱과 시스템이 처리할 수 있는 범위에도 제한됩니다.

적합한 경우: 규칙 문제와 서버 연결 문제를 구분하기 위한 임시 비교 테스트

Direct

가로채는 요청을 직접 연결 방식으로 처리합니다. 서버를 선택했더라도 Direct 상태라면 해당 서버가 요청을 전달할 수 있는지 확인할 수 없습니다.

적합한 경우: 현재 네트워크의 직접 연결 상태를 확인하거나 일시적으로 직접 연결을 명시하려는 경우

Global Routing의 Scene은 설정된 조건에 따라 해당 설정을 적용하는 기능이며 프로토콜 유형이 아닙니다. Scene의 조건과 동작을 확인하지 않았다면 고정된 Proxy 또는 Config 모드로 간주하지 마세요. 처음 테스트할 때는 명확한 모드 하나를 사용한 뒤 자동 전환을 설정하는 것이 좋습니다.

Home에서 Connectivity Test를 실행하고 모든 항목이 실패했는지 특정 항목만 실패했는지 기록합니다. 테스트 결과와 대상 웹사이트에 실제로 접속되는지는 서로 다른 증거이므로 각각 확인하세요.
Config를 선택했다면 Config에서 대상 구성이 실제로 선택되어 있는지 확인하고 규칙 순서를 살펴봅니다. DOMAIN-SUFFIX는 도메인 접미사를, IP-CIDR는 주소 범위를, GEOIP는 IP 주소 위치 데이터베이스를 기준으로 일치 항목을 찾습니다. FINAL은 기본 처리 규칙입니다.
처음 문제를 확인할 때는 수동으로 연결하세요. Settings → On Demand는 조건에 따라 연결을 시작하는 기능이며 구독을 가져오거나 인증 정보 오류를 해결하지 않습니다.

6. 구독 실패 및 가져오기 오류 해결 순서

먼저 어느 단계에서 실패했는지 구분합니다. 구독 내용을 다운로드하지 못했는지, 다운로드한 내용을 파싱하지 못했는지, 항목은 있지만 연결에 실패했는지 확인하세요. 반복해서 삭제하고 다시 추가하면 문제를 추적할 단서가 사라집니다. 오류 메시지를 보관하고 token과 인증 정보를 노출하지 않도록 주의하면서 URL, 네트워크, 반환 내용을 확인하세요.

구독 업데이트가 계속 시간 초과되면 무엇부터 바꿔야 하나요?

먼저 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하세요. 이미 사용할 수 있는 연결이 있다면 연결한 뒤 업데이트할 수 있습니다. 구독 주소에 프록시가 필요한 경우 Settings → Subscribe에서 Update via Proxy를 확인하세요. 앱을 새로 설치했고 사용할 서버도 없다면 이 옵션만으로 프록시 연결이 만들어지지는 않습니다.

주소는 브라우저에서 열리지만 파싱 실패 메시지가 표시되나요?

열리는 내용이 구독 데이터인지, 계정 로그인 페이지인지, 오류 페이지인지 확인하세요. HTTP 200은 요청에 응답이 있었다는 뜻일 뿐 내용 형식이 올바르다는 보장은 아닙니다. 복사한 주소가 서비스 제공업체가 Shadowrocket용으로 안내한 구독 링크인지 확인하고 관리 페이지 주소와 혼동하지 마세요. 반환된 전체 내용을 공개 채널에 올리지 마세요.

QR 코드를 스캔했는데 Home에 새 항목이 표시되지 않나요?

인식 결과가 웹페이지, 구성 URL 또는 불완전한 링크뿐인지 확인한 뒤 해당 자료에 맞는 경로로 다시 가져오세요. 사진 보관함의 작은 이미지에서는 압축으로 정보가 손실될 수 있습니다. 원본 자료에서 더 선명한 QR 코드를 다시 받거나 전체 텍스트 링크를 사용하세요.

구독 항목은 있지만 웹페이지가 열리지 않나요?

먼저 Home에서 항목을 선택하고 Connectivity Test를 실행한 뒤 Global Routing이 의도한 모드인지 확인하세요. 한 항목만 실패하면 해당 항목의 인증 및 전송 설정을 확인합니다. 모든 항목이 실패하면 현재 네트워크, 서비스 유효 기간, 서버 주소 변경 여부를 확인하세요.

업데이트 후 변경한 이름이나 매개변수가 원래대로 돌아왔나요?

구독을 업데이트하면 원격 내용에 따라 구독에서 생성된 항목이 새로 고쳐지므로 로컬 변경 사항이 덮어써질 수 있습니다. 별도로 보관해야 하는 자료는 용도를 표시해 수동 항목으로 추가하세요. 다음 업데이트 때도 원래 구독이 변경되었는지 확인하고, 새 서비스 제공업체 자료 대신 오래된 매개변수를 사용하지 마세요.

처음 가져오기를 마친 뒤 민감한 인증 정보가 없는 작업 기록을 남겨 두세요. 자료 유형, 사용한 경로, Global Routing 모드, 오류 메시지만 기록하면 됩니다. 나중에 문제가 생기면 자료를 업데이트하고 같은 테스트를 다시 수행한 다음 구성을 변경하세요. 한 번에 설정 하나만 바꿔야 결과에 영향을 준 단계를 확인할 수 있습니다.

Shadowrocket 다운로드 및 설정 계속하기

iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 제공됩니다. Mac(Apple 칩 / Intel), Windows, Android, Linux 버전은 무료입니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. 개발자는 Shadow Launch Technology Limited입니다. 앱 구매와 네트워크 서비스 구독은 별개이므로 가져오기에는 보유 중인 서비스 제공업체 자료가 필요합니다.

다운로드 페이지 사용법 보기