이미 서비스 제공업체에서 받은 구독 링크나 연결 정보를 보유한 사용자를 위한 안내입니다. 먼저 Subscribe를 통한 서버 구독과 Config 규칙 설정을 구분한 뒤, 보유한 자료에 맞춰 구독 URL 붙여넣기, Add Server 직접 입력, QR 코드 스캔 또는 클립보드 인식 방법을 선택하세요. 마지막으로 업데이트 결과와 Global Routing을 확인합니다. QR 코드와 클립보드는 입력 방식일 뿐, 가져올 수 있는지는 내용 형식에 따라 달라집니다.
가져오기 전: 서버 구독과 Config 설정 구분하기
Shadowrocket을 열고 먼저 Home에서 기존 서버를 확인한 다음 Config에서 현재 규칙 설정을 살펴보세요. Home에서는 연결할 서버와 구독 그룹을 관리하고, Config에서는 규칙 구성 파일을 관리합니다. 둘 다 URL을 통해 내용을 가져올 수 있지만, 주소가 https://로 시작한다는 이유만으로 용도가 같다고 판단하면 안 됩니다.
‘Config 페이지의 Subscribe’를 찾고 있다면, 먼저 링크가 실제로 어떤 내용을 반환하는지 확인하세요. 서버 목록은 Subscribe로 가져오고, 라우팅 규칙이 포함된 구성 파일은 Config에서 관리합니다. 서버 구독을 추가하려면 보통 Home 오른쪽 상단의 ‘+’를 누르고 Add Server로 이동한 뒤 Type을 Subscribe로 설정합니다. Config의 원격 구성 추가를 서버 구독을 위한 메뉴로 착각하지 마세요.
| 보유한 자료 | 사용할 메뉴 | 확인할 결과 |
|---|---|---|
| 서버 구독 URL | Home → + → Type → Subscribe | Home에 구독 그룹과 서버 항목이 표시됨 |
| 개별 서버 연결 정보 | Home → + → Add Server | Home에 직접 추가한 항목이 표시됨 |
| 프로토콜 공유 QR 코드 | Home → QR 코드 스캔 | 분석 후 해당 유형과 연결 정보가 표시됨 |
| 프로토콜 공유 텍스트 | 복사한 뒤 클립보드에서 인식 | 추가 안내 또는 분석된 항목이 표시됨 |
| 규칙 구성 파일 URL | Config의 원격 구성 메뉴 | Config에 구성 파일이 표시됨. 서버 구독과는 별개 |
먼저 자료가 본인이 이용하는 서비스 제공업체에서 받은 것인지 확인한 뒤 아래 단계를 진행하세요. Shadowrocket은 폐쇄형 유료 앱으로, 주로 iPhone과 iPad에서 사용합니다. 유일한 공식 구매처는 App Store입니다. 앱을 한 번 구매하는 것과 회선 요금제를 구독하는 것은 별개이며, 앱을 구매해도 연결 정보가 자동으로 제공되지는 않습니다. 시스템 요구 사항은 App Store 페이지를 확인하세요.
방법 1: Subscribe로 구독 저장 및 업데이트
Home에서 추가 양식을 연 다음 Type을 Subscribe로 설정하고, 전체 구독 URL을 URL 입력란에 붙여넣은 뒤 알아보기 쉬운 이름을 입력하세요. 저장된 구독에는 원본 주소가 유지되므로 나중에 업데이트할 때 해당 주소에서 서버 목록을 다시 가져옵니다. 서비스 제공업체가 서버 정보를 변경하는 경우에 적합합니다.
-
전체 URL 복사하기
이용 중인 서비스 제공업체 페이지에서 구독 URL을 복사하고
?뒤의 쿼리 매개변수도 빠뜨리지 마세요. URL 앞뒤에 공백, 줄바꿈 또는 한글 문장 부호가 들어가지 않았는지 확인하세요. -
구독 유형 선택하기
Home → +로 이동해 Add Server 양식에서 Type을 열고 Subscribe를 선택하세요. 양식에 이전에 선택했던 다른 프로토콜 유형이 그대로 남아 있지 않은지 확인합니다.
-
붙여넣고 저장하기
URL 입력란에 전체 주소를 붙여넣고 알아보기 쉬운 메모를 입력한 다음 저장하세요. 처음 가져오기가 끝나면 Home으로 돌아가 구독 그룹에 서버가 표시되는지 확인합니다.
-
업데이트 결과 확인하기
Home의 구독 목록을 아래로 당겨 새로 고침하고 해당 구독이 업데이트되는지 확인하세요. 오류가 표시되면 기존 항목을 유지한 채 URL, 네트워크, 서비스 제공업체 상태부터 확인하세요. 삭제와 재추가를 반복하지 마세요.
구독 URL은 https://example.com/sub?token=xxxx와 같은 형태일 수 있습니다. 이는 연결에 사용할 수 없는 예시 값입니다. 실제 URL의 token은 구독 권한을 식별하는 데 쓰이는 경우가 많으므로, 오류 화면을 공유할 때는 메모 이름만 가리지 말고 전체 URL을 가리세요.
방법 2: Add Server에서 연결 정보 직접 입력
Home → +에서 Add Server를 열고 Type을 선택한 다음 서비스 제공업체가 안내한 항목을 입력하세요. Type에 따라 필요한 정보가 달라집니다. Shadowsocks의 비밀번호와 암호화 방식, VMess 또는 VLESS의 인증 정보, Trojan의 비밀번호와 TLS 설정은 서로 대체할 수 없습니다. 정확한 정보가 없다면 프로토콜 이름만 보고 다른 항목을 추측해 입력하지 마세요.
기본 연결 정보
- Type
- 보유한 정보에 표시된 프로토콜과 일치하는 유형
- Address
- 웹페이지 경로를 제외한 서버 도메인 또는 IP 입력
- Port
- 제공된 포트 입력. 예: 443. 모든 서비스가 443을 사용하는 것은 아님
- Password
- 선택한 프로토콜에서 요구하는 경우에만 해당 비밀번호 입력
Address에 구독 URL 전체를 그대로 입력하면 안 되며, URL의 모양만 보고 Port를 추측해서도 안 됩니다.
추가 매개변수 확인
- TLS
- 서버 측 설정에 따라 활성화하세요. 포트 번호만으로 결정되지 않습니다.
- SNI
- 서비스 제공업체가 지정한 TLS 서버 이름을 사용하세요.
- Host
- 해당 전송 설정에서 요구하는 경우에만 입력하세요.
- Path
- 서비스 제공업체가 제공한 경로와 대소문자를 그대로 유지하세요.
Address, SNI, Host는 역할이 다릅니다. 값이 비슷해 보여도 임의로 바꿔 쓰면 안 됩니다.
저장한 뒤 Home에서 해당 항목을 선택해 연결을 시도하세요. 기본 항목이 올바른데 TLS 핸드셰이크 오류가 발생하면 서버 이름, 인증서, 기기 시간을 확인하세요. 인증서 검증을 끄는 방법을 일반적인 해결책으로 사용하면 안 됩니다. WireGuard에는 키와 Peer 설정도 필요하므로 일반 비밀번호 양식에 맞춰 입력할 수 없습니다. Hysteria2 등도 각 유형에 맞는 전체 연결 정보가 필요합니다.
- 직접 입력한 항목은 보통 구독 그룹과 별개입니다. 구독을 새로 고쳐도 독립 항목의 변경 정보가 자동으로 반영되지 않습니다.
- 서비스 제공업체가 비밀번호, 포트 또는 전송 매개변수를 변경한 경우 해당 항목을 다시 편집하거나 새로 제공된 유효한 공유 정보를 다시 가져오세요.
- 전체 프로토콜 공유 링크가 있다면 먼저 링크를 분석한 뒤 각 항목을 확인하세요. 긴 비밀번호와 경로를 직접 입력할 때 생기는 오류를 줄일 수 있습니다.
방법 3·4: QR 코드 스캔 및 클립보드 인식
Home에서 QR 코드 스캔을 열고 보유한 프로토콜 공유 QR 코드를 카메라에 비추세요. 필요한 경우 카메라 접근을 허용합니다. 인식된 뒤 Type, Address, Port를 확인하고 저장하세요. QR 코드에는 서버 하나의 공유 정보가 들어 있을 수도 있고 웹페이지 주소만 들어 있을 수도 있습니다. 웹페이지가 열렸다고 해서 연결 가능한 서버 설정까지 가져온 것은 아닙니다.
원본 페이지에서 공유 텍스트 전체를 복사한 뒤 Shadowrocket으로 돌아와 클립보드 인식 또는 추가 안내가 표시되면 이어서 진행하세요. 시스템에서 붙여넣기 허용 여부를 묻는다면 출처를 확인한 뒤 이번 작업을 허용합니다. 안내가 표시되지 않으면 복사한 내용이 이미지나 제목, 메신저에서 잘린 텍스트가 아니라 일반 텍스트 링크인지 확인하세요.
| 내용의 접두어나 형식 | 의미 | 가져올 때 확인할 점 |
|---|---|---|
ss:// | Shadowsocks 공유 링크 | 인코딩된 내용, 포트, 추가 매개변수를 모두 유지하세요. |
vmess:// | VMess 공유 링크 | 인코딩된 부분을 자르거나 중간에 공백을 넣지 마세요. |
vless:// | VLESS 공유 링크 | 인증 정보와 쿼리 매개변수를 그대로 유지하세요. |
trojan:// | Trojan 공유 링크 | 비밀번호, TLS 서버 이름, 전송 매개변수를 확인하세요. |
https:// 주소 | 구독, 구성 파일 또는 일반 웹페이지일 수 있음 | 먼저 용도를 확인한 뒤 Subscribe 또는 Config를 선택하세요. |
위 접두어는 형식을 구분하기 위한 것이며, 그대로 연결에 사용할 수 있는 예시는 아닙니다. QR 코드와 클립보드는 임의의 텍스트를 유효한 설정으로 변환하지 않습니다. 링크에 포함된 전송 확장 항목을 모두 분석할 수 있는지는 현재 양식에 실제로 인식된 항목을 기준으로 확인하세요. 가져온 뒤 누락된 항목이 있다면 원본을 다시 확인하고 임의로 추측해 채우지 마세요.
- QR 코드를 스캔해도 반응이 없으면 카메라 권한, QR 코드가 온전한지, 화면 반사, 이미지 선명도를 확인하세요.
- 클립보드가 반응하지 않으면 원본 공유 텍스트를 다시 복사하고 링크를 둘러싼 설명 문구를 제거하세요. 링크 자체의 내용은 수정하지 마세요.
- 가져올 항목이 여러 개 표시되면 이름과 서버 주소를 하나씩 확인해 같은 내용을 중복으로 가져오지 않았는지 살펴보세요.
가져온 후: Global Routing 선택 및 연결 확인
Home에서 가져온 서버를 선택한 뒤 Global Routing을 열어 현재 모드를 확인하세요. 가져오기는 ‘어디에 연결할지’를 정하고, Global Routing은 Shadowrocket으로 들어오는 요청을 어떻게 처리할지 결정합니다. 유효한 규칙 구성이 이미 있다면 Config를 선택할 수 있습니다. 규칙이 존재하지 않는 정책 이름을 참조한다면 구독을 반복해서 가져오는 대신 Config에서 구성을 확인하세요.
Config
모드현재 활성화된 구성의 규칙에 따라 요청을 처리합니다. 실제 경로는 일치하는 규칙과 그 규칙에 지정된 정책으로 결정되므로, 특정 도메인은 항상 프록시를 거치고 나머지는 모두 직접 연결되는 방식이 아닙니다.
적합한 경우: 규칙과 정책 이름을 확인한 일상적인 사용
Proxy
터널에 들어와 앱에서 처리하는 트래픽을 프록시 경로로 보냅니다. 분할 라우팅 규칙 때문에 접근 결과가 달라지는지 비교할 때 사용할 수 있습니다.
적합한 경우: 규칙 경로와 프록시 경로의 차이를 잠시 확인할 때
Direct
앱에서 처리하는 요청을 직접 연결 경로로 보냅니다. 이 모드에서 웹페이지가 열린다고 해서 선택한 프록시 서버가 정상이라고 볼 수는 없습니다.
적합한 경우: 현재 네트워크의 직접 연결 상태와 비교할 때
처음 연결할 때 시스템 안내에 따라 VPN 구성을 추가하도록 허용한 다음 Home에서 Connectivity Test를 실행하고 필요한 서비스에 접속해 보세요. 테스트 결과는 테스트 대상과 당시 네트워크 상태를 반영하며, 실제 사용 환경의 모든 요청을 검증하지는 않습니다. 테스트 응답은 있지만 특정 도메인에 접속할 수 없다면 사용 설명서의 연결 문제 해결에서 DNS, 규칙 일치 여부, TLS 오류를 확인하세요.
- Global Routing의 Scene은 미리 구성한 시나리오에 따라 동작을 선택하는 기능이며, 구독을 가져오는 메뉴가 아닙니다.
- Settings → On Demand에서는 조건에 따라 연결을 시작하거나 끊는 동작을 관리합니다. Subscribe를 통한 서버 목록 업데이트를 대신하지는 않습니다.
- Config의
DOMAIN-SUFFIX,GEOIP,IP-CIDR,FINAL은 규칙 키워드입니다. Add Server의 Address에 입력하면 안 됩니다.
구독 업데이트 및 가져오기 오류 해결
Home으로 돌아가 어느 단계에서 오류가 발생했는지 확인한 뒤 해당 설정을 조정하세요. 구독 다운로드 실패, 내용 분석 실패, 서버 연결 실패는 각각 다른 단계의 문제입니다. 앞 단계가 완료되지 않았다면 이후 단계의 SNI나 Global Routing을 바꿔도 원인이 해결되지 않는 경우가 많습니다.
구독 업데이트가 계속 시간 초과되면 무엇부터 확인해야 하나요?
먼저 Home에서 기존 연결이 작동하는지 확인한 다음 구독 URL이 온전한지 살펴보세요. 구독 주소에 기존 프록시를 통한 접속이 필요한 경우 Settings → Subscribe에서 Update via Proxy를 확인할 수 있습니다. 이 옵션은 사용 가능한 프록시 경로가 있어야 작동하며, 첫 연결을 새로 만들어 주지는 않습니다.
401 또는 403 오류가 표시되는데 다시 가져와야 하나요?
먼저 URL의 token이 잘리지 않았는지 확인한 다음, 이용 중인 서비스 제공업체 계정에서 구독 권한과 링크가 재설정되었는지 확인하세요. 401과 403은 서버가 반환한 접근 상태입니다. 유효하지 않은 동일한 주소를 반복해서 가져와도 보통 결과는 달라지지 않습니다.
내용은 가져왔는데 서버 항목이 표시되지 않나요?
복사한 주소가 계정 웹페이지, 로그인 페이지 또는 규칙 구성 주소인지 확인하세요. 서버 목록이 아니라 웹페이지가 반환되었다면 올바른 구독 URL을 다시 확인하세요. 웹페이지 소스 코드를 Add Server에 붙여넣으면 안 됩니다.
직접 입력한 항목은 왜 구독 변경 사항이 반영되지 않나요?
Home에서 해당 항목이 구독 그룹에 속하는지 확인하세요. 독립적으로 직접 입력했거나 단일 공유 링크로 가져온 항목은 보통 구독 업데이트와 연결되지 않으므로, 직접 수정하거나 서비스 제공업체가 새로 제공한 연결 정보를 다시 가져와야 합니다.
업데이트 후 항목이 바뀌었는데 앱을 다시 설치해야 하나요?
먼저 구독 그룹과 현재 선택된 항목을 확인한 다음 유효한 서버를 다시 선택하세요. 구독 내용은 제공처에서 변경할 수 있습니다. 앱을 다시 설치해도 제공처가 반환한 잘못된 연결 정보는 해결되지 않습니다. 문제를 확인할 때 오류 문구, 발생 단계, 네트워크 환경을 기록하고 비밀번호, 키, 구독 token은 가리세요.
문제 해결을 마친 뒤에는 설정 출처를 명확히 하고 자신에게 맞는 업데이트 방식을 유지하세요. 전체 구독은 지속적인 동기화에, 직접 입력은 개별 연결 정보 관리에, QR 코드와 클립보드는 입력을 줄이는 데 적합합니다. 네 가지 방법을 함께 사용할 수 있지만 각 항목이 구독 출처와 연결되어 있는지 확인해야 합니다.