이미 본인의 구독 주소나 연결 매개변수를 가지고 있으며 Shadowrocket에 가져오려는 사용자를 위한 안내입니다. 먼저 노드 구독과 원격 구성을 구분하고, 입력 내용에 따라 Subscribe, Add Server, QR 코드 또는 클립보드를 선택하세요. 마지막으로 목록, 업데이트 결과, Connectivity Test를 차례로 확인해 주소를 저장한 것과 실제 연결에 사용할 수 있는 상태를 혼동하지 않도록 합니다.
먼저 구분하기: 노드 구독, 단일 노드 링크, 구성 파일
Shadowrocket의 가져오기 방식은 데이터 유형에 따라 다릅니다. 노드 구독 주소는 보통 HTTPS URL이며, 요청하면 여러 연결 매개변수가 반환됩니다. 단일 노드 공유 링크는 ss://, vmess://, vless://, trojan:// 등의 프로토콜 접두사로 시작합니다. 원격 구성 파일은 규칙이나 DNS 등의 동작을 설정하는 데 사용됩니다. 모두 링크 형태로 전달될 수 있지만, 같은 방식으로 가져올 수 있는 것은 아닙니다.
특히 Config 페이지의 Subscribe와 노드 구독은 구분해야 합니다. Config에서 구독하고 관리하는 것은 원격 구성 파일이며, 파일이 표시된다고 해서 Home에 노드가 생긴 것은 아닙니다. 노드 구독은 보통 Home 오른쪽 상단의 “+”를 눌러 Add Server로 이동한 다음 Type을 Subscribe로 설정해 추가합니다. 화면 배치는 앱 업데이트에 따라 달라질 수 있으므로 Subscribe라는 단어만 보지 말고 현재 페이지와 Type을 기준으로 판단하세요.
Subscribe: 노드 구독은 Home에서 추가하고, 구성 구독은 Config에서 관리
노드 구독 URL을 받았다면 먼저 Home → “+” → Add Server로 이동하세요. Type을 선택하면 입력 폼의 의미가 달라집니다. Subscribe를 선택한 뒤 구독 URL을 입력해야 하며, 주소를 서버 주소·포트·비밀번호로 나누어 입력하지 않습니다. 구독 URL의 쿼리 매개변수는 인증에 사용될 수 있으므로 복사할 때 물음표, 등호와 그 뒤의 내용을 모두 유지하세요.
-
주소 확인
받은 주소가 노드 구독 주소인지 확인하세요. 계정 웹페이지, 주문 페이지, 원격 규칙 파일 주소와 혼동하지 마세요.
https://example.com/sub?token=xxxx는 URL 형식만 보여 주는 예시입니다. -
입력 폼 열기
Home → 오른쪽 상단 “+” → Add Server로 이동한 뒤 Type을 Subscribe로 설정하세요. 다른 프로토콜 유형을 선택한 상태에서 구독 주소를 붙여 넣지 마세요.
-
입력 후 저장
URL에 전체 주소를 붙여 넣고, Remarks에는 알아보기 쉬운 이름을 입력한 다음 저장하세요. 주소 앞뒤의 공백, 줄바꿈, 메시지에 붙은 따옴표는 URL에 포함되지 않습니다.
-
업데이트 확인
Home으로 돌아가 구독 그룹과 노드를 확인하세요. 아직 내용이 표시되지 않으면 구독 업데이트를 실행하거나 Home 목록을 아래로 당겨 새로고침하고, 같은 주소를 반복해서 추가하는 대신 오류 메시지를 확인하세요.
-
노드 선택
구독 그룹을 펼쳐 실제 노드가 있는지 확인한 뒤 사용할 노드를 선택하세요. 구독 이름만 보인다면 그룹이 접혀 있는지, 요청이 성공했는지, 반환된 내용을 해석할 수 있는지 확인해야 합니다.
주소가 실제로 원격 구성 파일을 가리킨다면 Config의 원격 구성 구독 영역에서 관리하세요. Config의 Subscribe에서 파일을 업데이트하는 절차와 Home에서 노드 구독을 업데이트하는 절차는 별개입니다. 구성 파일을 선택해도 파일에서 참조하는 모든 정책에 연결 매개변수가 자동으로 추가되는 것은 아닙니다. 노드 정보가 포함되어 있는지는 파일 확장자가 아니라 실제 내용으로 판단하세요.
업데이트할 항목에 맞는 방법 선택
노드 구독
- 경로: Home → “+” → Add Server → Type → Subscribe.
- 내용: 서버 주소, 포트, 프로토콜 매개변수 목록.
- 확인 기준: Home의 해당 그룹에 실제 노드가 표시됩니다.
구성 구독
- 위치: Config 페이지의 Subscribe 영역.
- 내용: 규칙 및 기타 구성 섹션이 포함될 수 있는 원격 구성 파일.
- 확인 기준: 파일을 정상적으로 가져온 뒤 필요에 따라 선택하고 내용을 확인합니다.
먼저 업데이트할 항목을 확인한 뒤 가져오기 방법을 선택하세요. 노드 수와 구성 파일 수는 같은 기준이 아닙니다.
Add Server: 프로토콜에 맞춰 수동 입력하고 구독 URL에서 매개변수를 추측하지 않기
수동 입력은 단일 노드의 매개변수를 빠짐없이 알고 있을 때 적합합니다. 경로는 Home → “+” → Add Server이며, Type은 매개변수에 맞는 프로토콜(예: Shadowsocks, VMess, VLESS, Trojan)로 선택하세요. Type을 선택하면 입력 항목이 달라집니다. 입력 전에 프로토콜을 확인하고 서버 주소, 포트, 인증 정보, 전송 설정을 대조하세요.
아래 두 카드는 입력 항목의 범위를 구분하기 위한 예시일 뿐, 완전한 연결 설정이 아닙니다. 포트 443은 예시이며 모든 프로토콜에 필수인 값이 아닙니다. 이 포트만으로 TLS가 활성화되었는지도 판단할 수 없습니다. 실제 포트와 TLS, SNI, 전송 경로 등의 설정은 보유한 매개변수와 일치해야 합니다.
노드 구독 입력 항목
- 가져오기 방법
- Home → “+” → Add Server
- Type
- Subscribe
- URL
https://example.com/sub?token=xxxx- Remarks
- 테스트 구독(식별용 예시)
URL은 노드 목록을 가져오는 주소이며, 개별 노드의 서버 주소가 아닙니다.
단일 노드 매개변수 예시
- Type
- Trojan
- Address
gateway.example.com- Port
443, 예시 값- Password
- 가상 예시 값
demo-not-a-secret - TLS
- 전체 원본 매개변수와 대조
이 가상 값으로는 연결할 수 없습니다. 실제 인증 및 전송 매개변수도 확인해야 합니다.
- Shadowsocks: 암호화 방식과 비밀번호를 확인하세요. 구독 token을 노드 비밀번호로 사용하면 안 됩니다.
- VMess: UUID, alterId, 암호화 및 전송 설정을 확인하세요. 다른 노드의 값을 임의로 가져와 채우지 마세요.
- VLESS: UUID, flow, 해당 전송 및 보안 설정을 확인하세요. 값이 있는 항목은 누락 없이 그대로 입력해야 합니다.
- Trojan: 비밀번호, TLS, 서버 이름 등의 매개변수를 확인하세요. 서버 주소와 TLS 인증에 사용하는 이름은 서로 다를 수 있습니다.
- Hysteria2와 WireGuard는 각 프로토콜에 맞는 Type과 매개변수 형식을 사용하세요. VMess나 Trojan의 입력 방식에 맞춰 작성하면 안 됩니다.
수동 입력은 저장 당시의 매개변수를 보관합니다. 원격 서버에서 포트나 인증 정보가 바뀌어도 Remarks가 같다는 이유만으로 자동 동기화되지 않습니다. 다시 편집하거나 원본 데이터를 이용해 가져오세요. 구독에서 생성된 노드를 직접 수정하면 다음 업데이트에서 변경 내용이 덮어써질 수 있으므로 문제를 해결하기 전에 기존 값을 기록해 두세요.
QR 코드 스캔: QR 코드의 데이터가 노드라고 단정할 수 없습니다
Home에서 상단의 스캔 아이콘을 눌러 스캔 화면을 열고, 시스템 안내에 따라 카메라 접근을 허용한 뒤 QR 코드를 화면 안에 온전히 맞추세요. QR 코드는 데이터를 담는 수단일 뿐입니다. 단일 노드 공유 링크, 구독 URL, 일반 웹페이지 주소가 들어 있을 수 있습니다. 스캔한 뒤 인식 결과를 확인하고, QR 코드가 인식되었다는 사실만으로 가져오기 형식이 올바르다고 판단하지 마세요.
- QR 코드가 본인이 보유한 연결 정보에서 나온 것인지 먼저 확인하세요. 공개 페이지에서 용도를 알 수 없는 코드를 스캔하지 마세요.
- 인식 후 Type과 입력 항목을 확인하세요. 단일 노드라면 보통 프로토콜 매개변수가 표시되고, 구독이라면 전체 URL이 유지되어야 합니다.
- HTTPS 주소가 표시되면 구독 주소인지, 원격 구성 주소인지, 웹페이지 주소인지 확인한 뒤 알맞은 방법을 선택하세요.
- 저장한 뒤 Home으로 돌아가 새 노드나 그룹을 확인하세요. 구성 파일을 가져온 경우에는 Config에서 확인합니다.
같은 iPhone에 QR 코드가 표시되어 있다면 스캔 화면에 사진 선택 기능이 제공될 때 사진에서 불러올 수 있습니다. 해당 기능이 없다면 원본 텍스트 링크를 사용하거나 다른 화면에 QR 코드를 표시하세요. 인증 정보가 포함된 스크린샷을 공개 이미지 서비스에 올려 스캔하지 마세요. QR 코드 가장자리가 잘렸거나 이미지가 너무 작거나 빛이 반사되면 이미지를 먼저 개선한 뒤 다시 시도하세요.
클립보드: 전체 내용을 복사한 뒤 읽기 권한을 허용하고 확인
클립보드는 메시지나 본인 자료에서 기존 링크를 복사할 때 편리합니다. 링크만 복사한 다음 Shadowrocket으로 돌아오세요. 앱에서 인식 또는 가져오기 안내가 표시되면 확인하고 미리보기를 점검하세요. 시스템에서 붙여넣기 허용을 요청할 경우, 허용해야 앱이 해당 클립보드 내용을 처리할 수 있습니다. 안내가 표시되지 않아도 링크가 무효라는 뜻은 아니며, 앱을 반복해서 종료할 필요도 없습니다.
- 구독 URL: Home → “+” → Add Server → Type → Subscribe로 이동한 뒤 URL 입력란을 길게 눌러 붙여 넣을 수 있습니다.
- 단일 노드 공유 링크: 앱의 클립보드 가져오기 또는 인식 기능을 사용하세요. 인식되지 않으면 프로토콜 접두사, 인코딩, 링크 전체가 온전한지 먼저 확인합니다.
- 수동 매개변수 텍스트: 주소, 포트, 비밀번호가 적힌 메시지는 공유 링크와 다릅니다. Add Server에서 항목별로 입력하세요.
- 여러 링크: 글머리 기호, 웹페이지 제목, 설명 문구가 섞이지 않도록 하세요. 가져온 뒤 항목 수와 프로토콜을 하나씩 확인하고, 복사한 줄 수를 결과 확인 대신 사용하지 마세요.
예를 들어 https://example.com/sub?token=xxxx에서 ?token=xxxx는 주소의 일부입니다. 메시지 앱에서 자동 줄바꿈이 되어도 실제 텍스트는 바뀌지 않을 수 있지만, 직접 삽입한 줄바꿈이나 한국어 문장 부호, 생략 표시로 잘린 텍스트는 해석 오류를 일으킬 수 있습니다. 인코딩된 공유 링크를 임의로 디코딩하거나 다시 조합하지 말고, 원본 전체를 다시 복사하는 것이 좋습니다.
구독 주소, 비밀번호, UUID에는 접근 인증 정보가 포함될 수 있습니다. 문제 해결을 위해 스크린샷을 찍을 때는 해당 내용을 가리고, 오류를 공유할 때는 오류 유형과 필요한 항목 이름만 남기세요. 가져오기를 마친 뒤 일반 텍스트를 복사해 클립보드 내용을 덮어쓰면 이후 인증 정보가 실수로 붙여 넣어질 가능성을 줄일 수 있습니다.
가져온 뒤 노드가 보이지 않을 때: 요청, 해석, 표시 순서로 확인
먼저 현재 상태를 기록하세요. 사용한 가져오기 방식, 저장 유형, 업데이트 오류를 메모한 뒤 네트워크와 입력 내용을 확인합니다. 같은 이름의 구독을 반복해서 만들면 결과를 구분하기 어려워집니다. 빈 그룹이 보이면 먼저 그룹을 펼치세요. Config에만 파일이 보인다면 노드 구독이 아니라 구성을 가져온 것인지 확인합니다. 두 현상 모두 연결 매개변수가 잘못되었다는 뜻은 아닙니다.
Subscribe로 저장했는데 노드가 보이지 않는다면?
Home으로 돌아가 해당 그룹을 펼친 다음 업데이트를 한 번 실행하고 결과를 확인하세요. URL을 저장했다는 것은 주소가 로컬에 기록되었다는 뜻일 뿐입니다. 네트워크 요청 실패, 빈 응답, 해석 불가 등의 이유로 그룹에 노드가 표시되지 않을 수 있습니다. 먼저 URL이 완전한지 확인하고, 웹 로그인 페이지 주소를 다시 붙여 넣지 마세요.
Config에 파일이 있는데 Home은 왜 비어 있나요?
Config에서 파일 내용과 용도를 확인하세요. 규칙이나 DNS만 포함된 구성은 Home의 노드를 자동으로 채우지 않습니다. 본인이 보유한 노드 구독은 Home → “+” → Type → Subscribe에서 추가한 뒤 구성 파일과 노드를 각각 확인하세요.
업데이트 시간 초과가 표시되면 먼저 연결을 켜야 하나요?
먼저 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 이미 사용할 수 있는 노드가 있다면 Settings → Subscribe에서 Update via Proxy를 확인하고 필요에 따라 활성화한 뒤 다시 시도할 수 있습니다. 이 기능은 정상 작동하는 프록시 연결이 있어야 사용할 수 있습니다. 처음 가져오는 중이고 사용 가능한 노드가 없다면 이 설정만으로 연결이 생기지는 않습니다.
401 또는 403이 반환되면 가져오기 방식을 바꾸면 해결되나요?
대개 QR 코드, 클립보드, 수동 입력 방식의 차이가 아니라 요청 인증이나 접근 제한과 관련된 문제입니다. 구독 URL에서 token이 빠지지 않았는지, 주소가 바뀌지 않았는지 확인한 다음 본인 계정 자료에서 인증 상태를 확인하세요. 전체 주소를 공개하지 말고, 관련 없는 프로토콜 항목을 반복해서 수정하지 마세요.
노드는 표시되는데 웹페이지가 열리지 않는다면?
먼저 노드를 선택하고 Home에서 Connectivity Test를 실행한 다음 Global Routing을 확인하세요. Direct는 직접 연결, Proxy는 프록시 연결을 사용하며, Config는 구성 규칙에 따라 트래픽을 분기하고 Scene은 선택한 시나리오 설정에 따라 동작합니다. 가져오기에 성공했다고 해서 현재 트래픽이 새로 추가한 노드를 반드시 사용하는 것은 아닙니다.
업데이트 요청이 성공해도 내용이 올바르다는 뜻은 아닙니다. 서버가 로그인 페이지, 오류 텍스트 또는 지원되지 않는 데이터를 반환할 수 있습니다. 해석 오류가 표시되면 노드 포트를 임의로 바꾸지 말고 원본 주소의 용도와 필요한 형식을 확인하세요. 자동 업데이트 관련 옵션은 Settings → Subscribe에서 확인할 수 있습니다. 백그라운드 새로고침이 언제나 실행된다고 가정하지 말고, 중요한 변경 후에는 직접 업데이트해 결과를 확인하세요.
가져온 뒤 확인 및 관리
가져오기, 연결, 라우팅은 서로 다른 단계입니다. Home에 노드가 표시되면 매개변수가 목록에 들어온 것입니다. 연결을 켜고 시스템의 VPN 구성 승인을 완료해야 연결 단계로 넘어갑니다. 최종적으로 어떤 요청이 프록시를 사용하는지는 Global Routing과 실제로 적용 중인 구성에 따라 달라집니다. Config의 DOMAIN-SUFFIX, GEOIP, IP-CIDR, FINAL은 규칙 항목이며 구독 주소의 일부가 아닙니다.
- 목록 확인: 구독 그룹을 펼칠 수 있고 노드 이름과 프로토콜을 알아볼 수 있으며, 반복 시도로 같은 항목이 여러 그룹에 중복 생성되지 않았는지 확인합니다.
- 업데이트 확인: 직접 업데이트한 뒤 요청 또는 해석 오류가 없는지 확인합니다. 원격 내용이 바뀌지 않았다면 로컬 항목 수가 그대로인 것은 정상입니다.
- 연결 확인: 사용할 노드를 선택하고 필요하면 시스템의 VPN 구성 추가를 허용한 다음 Home 상태와 Connectivity Test 결과를 확인합니다.
- 라우팅 확인: Global Routing을 확인합니다. Config를 사용하는 경우 현재 선택된 파일과 규칙에 지정된 정책이 실제로 있는지도 점검합니다.
- 관리 확인: 구독 노드는 구독 업데이트로 관리하고, 수동 입력 및 단일 노드 공유 링크는 원본 매개변수에 따라 관리합니다. 두 업데이트 방식을 혼동하지 마세요.
Settings → On Demand는 조건에 따라 연결을 시작하는 기능입니다. 구독을 가져오거나 잘못된 token 또는 누락된 UUID를 복구하지는 않습니다. 가져오기 문제를 해결할 때는 먼저 입력 내용, 목록, 연결을 확인한 다음 자동 연결 동작을 조정하세요. 여러 설정을 동시에 바꾸어 원인을 혼동하는 일을 줄일 수 있습니다.
Shadowrocket은 Apple 플랫폼용 클로즈드소스 상용 앱으로, 주로 iPhone과 iPad에서 사용하며 App Store에서 일회성 구매로 이용할 수 있습니다. 개발자는 Shadow Launch Technology Limited이며 앱 ID는 932747118입니다. 시스템 요구 사항, 기기 호환성, 유니버설 구입 지원 여부는 App Store 페이지의 안내를 기준으로 확인하세요. 앱 구매 여부와 기존 구독의 유효성은 별도로 확인해야 합니다.