이 글은 본인이 이용 중인 서비스의 구독 URL이나 연결 정보를 이미 보유한 사용자를 대상으로 합니다. 먼저 Home의 서버 구독과 Config의 구성 구독을 구분한 뒤, 링크·매개변수·QR 코드·클립보드에 맞는 가져오기 방법을 선택하세요. 완료 후에는 목록, 업데이트 결과, Global Routing을 확인합니다. QR 코드와 클립보드는 정보를 전달하는 방법일 뿐, 단일 연결을 자동 업데이트되는 구독으로 바꿔 주지는 않습니다.
가져오기 전: 앱과 보유 정보 확인
Shadowrocket은 iPhone과 iPad를 중심으로 사용하는 Apple 플랫폼 전용 클로즈드 소스 상용 앱이며, App Store에서만 받을 수 있습니다. 구매 전에 제품명 Shadowrocket, 개발자 Shadow Launch Technology Limited, 제품 페이지 주소의 앱 ID 932747118를 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다.
앱은 일회성 구매 방식입니다. 앱 구매와 연결 서비스 요금제는 별개입니다. 이 글은 사용자가 본인의 서비스 제공업체와 구독을 이미 보유한 경우를 전제로 하며, 이 사이트는 노드나 구독을 제공하거나 판매 또는 추천하지 않습니다. 앱을 구매한 뒤에도 사용 권한이 있는 연결 정보를 직접 가져와야 합니다.
- 구독 URL: 일반적으로 HTTPS 주소이며, 접속하면 계정 관리 웹페이지가 아니라 앱이 인식할 수 있는 서버 목록을 반환합니다.
- 단일 공유 링크: 흔히
ss://,vmess://,vless://,trojan://로 시작하며, 보통 하나의 연결 정보를 담습니다. - 수동 입력 매개변수: Type, Address, Port와 해당 인증 정보를 확인해야 합니다. TLS, SNI, 전송 방식 등도 서버 설정과 일치해야 합니다.
- 구성 파일 URL: 규칙, DNS, 정책 등의 설정을 불러오는 주소입니다. HTTPS로 시작한다는 이유만으로 서버 구독이라고 판단하면 안 됩니다.
Subscribe: Home과 Config의 용도 구분하기
혼동하기 쉬운 점은 Subscribe가 서로 다른 항목을 가리킨다는 것입니다. 서버 목록을 일괄 가져오려면 Home → + → Add Server → Type → Subscribe를 사용합니다. Config의 Subscribe는 원격 구성을 구독할 때 사용합니다. 두 메뉴 모두 URL을 입력할 수 있지만, 반환되는 내용과 저장 위치가 다릅니다.
서버 구독을 받았다면 Config에도 Subscribe가 보인다는 이유만으로 그곳에 입력하지 마세요. 반대로 [General], [Rule] 등의 섹션이 포함된 전체 구성 파일도 일반 서버 목록으로 가져오면 안 됩니다. 먼저 받은 정보의 설명을 확인하세요. 반환되는 형식을 알 수 없다면 메뉴를 바꿔 가며 시도하기보다 기존 서비스 제공업체에 문의하세요.
-
추가 화면 열기
Home을 열고 오른쪽 위의 「+」를 탭해 Add Server로 이동합니다. 이 메뉴에서는 연결 항목을 관리하며, Config에서 규칙 파일을 선택하는 것이 아닙니다.
-
유형 선택
Type을 탭하고 Subscribe를 선택합니다. 본인이 보유한 전체 구독 주소를 URL에 붙여넣고, 쿼리 매개변수·대소문자·퍼센트 인코딩을 그대로 유지하세요.
-
이름을 지정하고 저장
구분하기 쉬운 이름을 입력하고 오른쪽 위의 Done을 탭합니다. Home으로 돌아와 구독 그룹과 펼친 뒤 표시되는 서버 목록을 확인하세요.
-
업데이트 실행
Home 화면을 아래로 당겨 새로고침하고 요청이 완료될 때까지 기다립니다. 그룹은 있지만 내용이 비어 있다면 같은 URL을 바로 다시 추가하지 말고 요청 결과와 파싱 상태부터 확인하세요.
Config의 Subscribe는 언제 사용하나요?
받은 정보가 Shadowrocket 원격 구성이라고 명시된 경우에만 Config로 이동해 원격 구성을 추가하는 메뉴를 열고 Subscribe를 선택한 다음 구성 URL을 입력하세요. 저장한 뒤 Config 목록에서 해당 구성을 확인하고 선택합니다. 화면 배치에 따라 추가 메뉴의 위치는 다를 수 있으므로 Home의 Type 입력란을 찾기보다 Subscribe 항목을 기준으로 확인하세요.
- Config 목록에 새 파일이 생기고 Home에는 새 서버가 추가되지 않아도 실패가 아닐 수 있습니다. 가져온 항목이 규칙만 포함된 구성일 수 있습니다.
- 원격 구성에는 DNS, 규칙, 정책 참조가 포함될 수 있습니다. 기존에 조정한 설정이 덮어써지지 않도록 적용 전에 출처와 내용을 확인하세요.
- 서버 구독 업데이트와 원격 구성 업데이트는 별개의 작업입니다. 하나를 완료했다고 해서 다른 하나도 업데이트된 것은 아닙니다.
Add Server에 수동 입력: 매개변수만 있을 때 연결 만들기
구독 URL 없이 Address, Port, Password 등의 매개변수만 있다면 Home → + → Add Server에서 실제 프로토콜을 선택하고 항목별로 입력하세요. 수동으로 추가한 서버는 개별 항목이므로 서버 매개변수가 바뀌면 직접 수정해야 하는 경우가 많습니다. 구독 목록처럼 자동으로 동기화되지는 않습니다.
주소 및 인증
- Type
- 보유한 정보에 맞는 실제 프로토콜을 선택하세요. 예를 들어 Trojan을 사용할 수 있습니다.
- Address
- 서버 도메인 또는 IP를 입력합니다. https://나 웹페이지 경로는 붙이지 마세요.
- Port
- 서버 포트를 입력합니다. 예를 들어 받은 정보에 443이 명시된 경우에만 443을 입력하세요.
- Password
- 받은 내용을 그대로 입력하고 앞뒤 공백이나 줄바꿈이 들어가지 않도록 하세요.
443은 흔히 사용하는 포트의 예시일 뿐, 실제 서버 매개변수를 대신할 수 없습니다.
프로토콜별 추가 항목
- SNI
- 서버에서 요구하는 TLS 핸드셰이크용 도메인을 입력하세요.
- UUID
- VMess, VLESS 등의 프로토콜에서 사용하는 ID 필드는 일반적인 Password와 다릅니다.
- Method
- Shadowsocks의 암호화 방식은 서버 설정과 일치해야 합니다.
- Transport
- WebSocket 등의 전송 방식이 지정되어 있다면 Path와 Host도 확인하세요.
Type에 따라 입력 항목이 달라집니다. 프로토콜이 다른 설정을 통째로 복사하지 마세요.
Trojan을 예로 들면 Address가 해석되고 Port로 연결할 수 있어도 인증과 TLS 검증까지 성공했다고 볼 수는 없습니다. 정보에 SNI가 지정되어 있다면 해당 값을 입력하세요. 구독 URL의 도메인을 서버 Address로 착각하지 말고, SNI나 인증서 불일치를 가리기 위해 인증서 검증을 완화하지도 마세요.
- 완전한 연결 정보를 저장한 뒤 Home에서 이름과 Type을 확인하세요.
- 해당 항목을 선택하고 연결 스위치를 켭니다. 처음 사용할 때는 시스템 안내에 따라 VPN 구성 추가를 허용하세요.
- 연결에 실패하면 Address, Port, 인증 정보, TLS 및 전송 매개변수를 차례로 확인하세요. 원인을 찾기 쉽도록 한 번에 한 항목씩만 변경합니다.
QR 코드로 추가: 코드 안의 내용에 따라 가져오기 결과가 달라집니다
QR 코드는 텍스트를 담는 수단이지 별도의 프로토콜이 아닙니다. Home에서 QR 코드 스캔 메뉴를 탭하고 본인이 보유한 연결 QR 코드를 비춘 뒤, 시스템 안내에 따라 카메라 접근을 허용하세요. 인식 후에는 파싱된 Type과 이름을 확인하고 저장을 확정합니다. 스캔 화면에서 사진 불러오기를 지원한다면 기기에 저장된 QR 코드 이미지도 사용할 수 있습니다.
- QR 코드에
trojan://등의 단일 공유 링크가 포함된 경우 보통 서버 항목 하나만 추가되며, 자동 업데이트되는 그룹은 만들어지지 않습니다. - QR 코드에 구독 URL이 포함된 경우 구독 추가 절차로 이동했는지 확인하세요. 일반 텍스트 주소만 인식되면 복사한 뒤 Home → + → Type → Subscribe에 입력할 수 있습니다.
- QR 코드에 계정 웹페이지, 결제 페이지 또는 일반 웹페이지가 포함되어 있다면 서버 매개변수를 가져올 수 없습니다. 기존에 받은 정보에서 실제 연결 정보를 찾으세요.
- 스캔 결과에 필드가 빠졌거나 인식되지 않는다면 QR 코드가 온전한지, 반사되거나 잘리지 않았는지 확인한 뒤 원본 텍스트를 시도하세요. Password, UUID, SNI를 임의로 추측해 입력하지 마세요.
본인의 공유 링크를 스캔하더라도 내용을 확인해야 합니다. 특히 사진으로 저장했거나 메신저에서 압축된 QR 코드는 주의하세요. 기존 항목은 남겨 두고 새 항목이 정상적으로 작동하는지 확인한 후 중복 기록을 정리하는 것이 좋습니다.
클립보드로 가져오기: 전체 내용을 복사하고 URL 입력란을 혼동하지 않기
클립보드는 이미 받은 공유 텍스트를 가져올 때 편리합니다. 복사할 때 프로토콜 접두사부터 링크 끝까지 포함하고, 설명·따옴표·글머리 기호·코드 블록은 제외하세요. Home으로 돌아왔을 때 가져오기 안내가 표시되면 읽기를 허용하고 확인합니다. 안내가 나타나지 않으면 Home의 추가 메뉴를 열어 현재 화면에 클립보드 가져오기 기능이 있는지 확인하세요.
-
원문 복사
단일 공유 링크 전체를 복사하세요. 여러 링크가 일괄 인식되지 않는다면 먼저 하나만 복사해 확인하여 설명까지 함께 가져오지 않도록 합니다.
-
읽기 허용
Shadowrocket으로 돌아와 시스템에서 붙여넣기를 허용할지 물으면 허용을 선택하세요. 읽기를 거부해 가져오기 안내가 표시되지 않는 것은 링크 형식이 잘못됐다는 뜻이 아닙니다.
-
결과 확인
새로 추가된 항목의 프로토콜, Address, Port를 확인하세요. 복사한 것이 HTTPS 구독 URL인데 자동으로 인식되지 않았다면 Home → + → Type → Subscribe → URL 경로를 사용하세요.
링크의 %2F, %3D 같은 문자를 직접 디코딩하거나 수정하지 말고, & 뒤의 매개변수도 잘라내지 마세요. 공유 링크에서 조각 식별자 # 뒤의 내용은 이름으로 쓰이는 경우가 많지만 형식마다 파싱 규칙이 다릅니다. 원문을 그대로 유지하는 것이 가장 안전합니다.
가져온 뒤 확인: 목록, 선택 항목, Global Routing을 각각 점검
가져오기에 성공했다는 것은 데이터가 저장되었다는 뜻일 뿐, 서버에 연결할 수 있거나 트래픽 분배가 예상대로 작동한다는 의미는 아닙니다. 먼저 Home에서 구독 그룹을 펼쳐 서버 항목이 하나 이상 있는지 확인한 다음 대상 서버를 선택하고 Connectivity Test를 실행하세요. 테스트 결과는 해당 시점의 연결 상태만 보여 주며, 모든 웹사이트와 앱이 정상적으로 열리는지를 보장하지 않습니다.
Global Routing → Config
권장현재 선택한 구성의 규칙에 따라 정책이 결정됩니다. DIRECT에 일치하는 요청은 직접 연결되고, 프록시 정책에 일치하는 요청은 해당 출구를 사용합니다. 프록시를 거치는지는 Home에서 선택한 서버만이 아니라 규칙에 따라 달라집니다.
적합한 경우: 구성을 확인한 뒤 규칙에 따라 트래픽을 분배하는 일상적인 사용
Global Routing → Proxy
앱이 처리하는 트래픽을 Proxy 방식으로 처리하여 규칙 매칭에 따른 변수를 일시적으로 줄일 수 있습니다. 기기의 모든 트래픽이 반드시 같은 경로를 거친다고 단정해서는 안 됩니다.
적합한 경우: 서버 연결과 규칙 분배 문제를 잠시 비교 테스트할 때
Global Routing → Direct
앱이 처리하는 트래픽을 Direct 방식으로 처리합니다. 서버를 가져와 선택했더라도 현재 접속이 해당 서버를 이용하고 있다고 판단할 수는 없습니다.
적합한 경우: 직접 연결 상태와 비교해 대상 웹사이트 자체의 접속 문제를 제외할 때
문제를 확인할 때 Settings → On Demand도 점검하세요. On Demand는 조건에 따라 연결을 자동으로 실행하는 기능이며 구독을 가져오거나 매개변수를 채우지는 않습니다. 네트워크를 바꾼 뒤 연결이 자동으로 달라진다면 관련 조건을 먼저 확인한 후 다시 가져와야 하는지 판단하세요.
- Home에 서버가 있고 Config에 새 파일이 없음: 일반 서버 구독이라면 정상일 수 있습니다.
- Config에 파일이 있지만 규칙이 적용되지 않음: 해당 구성을 선택했는지, Global Routing이 Config로 설정되어 있는지 확인하세요.
- Scene을 사용하는 경우: 해당 장면의 설정부터 확인하세요. 한 항목만 점검할 때는 기존 설정을 기록하고 명확한 방식으로 잠시 전환해 테스트한 뒤 원래대로 복구합니다.
자주 묻는 질문: 목록이 표시되지 않거나 구독 업데이트에 실패할 때
구독을 저장했는데 Home이 여전히 비어 있나요?
먼저 Config에 잘못 추가한 것은 아닌지 확인하세요. 그런 다음 Home에 펼칠 수 있는 구독 그룹이 있는지 확인하고 아래로 당겨 새로고침합니다. 그룹만 있고 서버가 없다면 URL이 완전한지, token이 유효한지, 반환된 내용이 인식 가능한 구독 형식인지 확인하세요. 계정 로그인 웹페이지는 구독 응답을 대신할 수 없습니다.
구독 업데이트가 계속 시간 초과되는데 앱을 다시 설치해야 하나요?
먼저 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하세요. 사용할 수 있는 프록시 연결이 이미 있다면 연결한 뒤 Settings → Subscribe에서 Update via Proxy를 확인하고 다시 업데이트해 보세요. 사용할 수 있는 프록시가 없다면 이 옵션만 켜서는 문제가 해결되지 않습니다. 마지막으로 사용 가능한 목록부터 삭제하지 마세요.
업데이트 후 서버 이름이 바뀌었는데 잘못 가져온 건가요?
구독을 업데이트하면 원격에서 반환된 내용에 따라 목록이 갱신되므로 이름이 바뀌었다고 해서 반드시 잘못 가져온 것은 아닙니다. 해당 그룹의 구독 URL을 확인하고 선택한 항목도 다시 살펴보세요. 선택했던 항목이 삭제되었다면 현재 목록에 있는 항목을 선택해 테스트합니다. 수동으로 추가한 항목은 구독 업데이트에 따라 바뀌지 않을 수 있습니다.
QR 코드로는 가져올 수 있는데 왜 업데이트는 안 되나요?
항목을 열어 단일 서버인지 Subscribe인지 확인하세요. QR 코드에 단일 공유 링크만 들어 있다면 가져온 뒤 새로고침할 구독 원본이 없습니다. 목록을 업데이트하려면 같은 단일 QR 코드를 반복해서 스캔하지 말고, 본인이 보유한 구독 URL로 Subscribe를 새로 추가하세요.
목록에 항목이 있는데 연결을 켠 뒤에도 웹페이지가 열리지 않나요?
먼저 Home에서 Connectivity Test를 실행한 다음 Global Routing과 현재 선택한 구성을 확인하세요. 서버 테스트는 통과하지만 일부 도메인만 문제가 있다면 규칙과 DNS를 살펴봅니다. 서버 테스트도 실패한다면 연결 매개변수, 서비스 유효 상태, 현재 네트워크를 먼저 점검하세요. 모든 문제를 구독 가져오기 실패로 단정하지 마세요.
점검을 마친 뒤에는 출처가 분명한 구독 그룹 하나만 남겨 같은 URL의 중복 항목을 여러 이름으로 만들지 않도록 하세요. 규칙, DNS, 연결 상태를 더 확인하려면 문제 해결 매뉴얼을 참고하고, 용어의 뜻은 용어 매뉴얼에서 확인할 수 있습니다.