Shadowrocket에서 사용할 가져오기 방법은 보유한 정보의 유형에 따라 다릅니다. 노드 구독, 단일 프로토콜 링크, QR 코드, 원격 구성 파일은 서로 다른 형식입니다. 이 글에서는 이미 이용 중인 서비스와 구독이 있다는 전제하에 Subscribe와 Config의 차이, Add Server 입력 순서, QR 코드 및 클립보드 확인 방법을 설명하고, 가져온 뒤 검증하는 법과 실패 시 점검 절차를 안내합니다.
구독 링크, 프로토콜 링크, 구성 파일 구분하기
가져오기 전에 받은 자료가 ‘여러 연결 정보를 반환하는 주소’인지, ‘하나의 연결을 설명하는 링크’인지 확인하세요. 구독 URL은 보통 https://로 시작하며, 앱이 해당 주소에 요청을 보내야 내용을 가져옵니다. 단일 프로토콜 링크는 ss://, vmess://, trojan:// 같은 프로토콜 식별자로 시작하는 경우가 많습니다. 주소의 확장자만으로 형식을 판단할 수는 없습니다. .conf 확장자가 없어도 구성 파일을 반환하는 주소가 있습니다.
| 자료 유형 | 구분 방법 | 처리 방법 |
|---|---|---|
| 노드 구독 | 보통 인증 정보가 포함된 HTTPS 주소이며, 여러 연결 항목을 반환합니다. | Home에서 구독 추가 기능을 열고 Type에서 Subscribe를 선택합니다. |
| 단일 연결 | 프로토콜 식별자로 시작하며 서버, 포트, 인증 정보가 포함됩니다. | QR 코드 또는 클립보드로 가져오거나 Add Server에서 직접 입력합니다. |
| 원격 구성 | 본문에 [General], [Rule] 등의 섹션이 포함될 수 있습니다. | Config에서 원격 구성을 관리합니다. 파일을 가져온 뒤 활성화 상태를 확인하세요. |
| 웹페이지 주소 | 열면 로그인 페이지, 안내 페이지 또는 HTML 콘텐츠가 표시됩니다. | 구독 주소로 바로 사용할 수 없습니다. 실제 가져오기 주소는 이용 중인 서비스 제공처에 확인하세요. |
이 글에서는 Home, Config, Settings 세 영역을 다룹니다. Home에서는 연결과 선택 상태를 관리하고, Config에서는 구성 파일을 관리하며, Settings에서는 앱 동작을 설정합니다. 플랫폼에 따라 창 배치가 달라 버튼 위치가 다를 수 있습니다. 아래 안내는 모바일에서 흔히 사용하는 영문 UI 명칭을 기준으로 하며, 데스크톱에서는 같은 기능을 찾아 사용하면 됩니다. 화면 좌표를 그대로 따라 할 필요는 없습니다.
Subscribe와 Config: 노드 구독과 구성 파일은 별도로 처리
‘Config의 Subscribe’를 찾을 때는 먼저 어떤 자료를 가져오려는지 확인하세요. Config의 Subscribe 또는 원격 주소 관련 기능은 구성 파일 관리용입니다. 모든 노드 구독을 Config에 입력하면 안 됩니다. 노드 구독은 보통 Home → 오른쪽 상단 “+”(Add Server) → Type → Subscribe 순서로 추가합니다. 두 방식 모두 HTTPS 주소를 사용할 수 있지만, 가져온 결과는 다릅니다. 하나는 구성 파일이고 다른 하나는 선택 가능한 연결 항목 목록입니다.
-
주소 확인
이용 중인 서비스 관리 페이지에서 구독 URL 전체를 복사하세요. 앞뒤 안내 문구나 공백, 줄바꿈이 함께 선택되지 않았는지 확인하고 물음표 뒤의 매개변수도 모두 포함하세요.
-
가져오기 화면 열기
Home으로 이동해 오른쪽 상단의 “+”를 눌러 Add Server를 엽니다. Type에서 Subscribe를 선택하세요. 일반 단일 연결 프로토콜 유형을 그대로 둔 채 구독 URL 전체를 붙여 넣지 마세요.
-
URL 입력
URL 필드에 주소 전체를 입력하고 알아보기 쉬운 이름을 지정한 다음 저장하세요. token을 별도의 비밀번호로 분리하거나 HTTPS 주소를 서버 호스트명 필드에 입력하지 마세요.
-
목록 갱신
Home으로 돌아가 구독 그룹이 표시되는지 확인하세요. 내용이 자동으로 갱신되지 않으면 해당 구독의 업데이트 기능을 사용합니다. 목록에서 아래로 당겨 갱신할 수 있다면 실행한 뒤 오류 메시지와 항목 수를 확인하세요.
-
가져온 결과 확인
그룹을 펼쳐 연결 항목이 하나 이상 있는지, 프로토콜·서버·포트가 보유한 정보와 일치하는지 확인하세요. 구독 이름만 저장되었다고 연결 목록까지 가져온 것은 아닙니다.
원격 .conf 파일을 받았다면 Config로 이동해 원격 URL 추가 기능으로 파일을 가져온 다음, 현재 어떤 구성이 활성화되어 있는지 확인하세요. 파일에 라우팅 규칙과 DNS 동작이 포함될 수 있으므로 다운로드가 성공했다고 해서 모든 설정이 현재 네트워크에 적합하다고 단정할 수 없습니다. 구독 갱신과 구성 파일 갱신도 따로 확인해야 합니다. 전자는 연결 정보를, 후자는 구성 내용을 업데이트합니다.
Add Server: 프로토콜에 맞춰 연결 하나를 직접 입력
서버 주소, 포트, 비밀번호, UUID처럼 항목별로 제공된 정보가 있다면 Home → “+” → Add Server에서 각각 입력하는 편이 확인하기 쉽습니다. 먼저 Type을 선택한 뒤 정보를 입력하세요. 프로토콜마다 인증 및 전송 매개변수가 다릅니다. 값을 먼저 입력한 뒤 프로토콜을 임의로 바꾸면 이전 필드 값이 남거나 필수 항목이 바뀐 것을 놓칠 수 있습니다.
- Shadowsocks: 서버, 포트, 암호화 방식, 비밀번호를 확인하세요. 암호화 방식은 서버 측 설정과 일치해야 합니다. 이름이 비슷하다는 이유만으로 다른 방식으로 바꾸지 마세요.
- VMess / VLESS: UUID와 서버에서 요구하는 전송 방식, 경로, Host, TLS 매개변수를 확인하세요. VLESS와 VMess의 필드는 서로 그대로 옮겨 쓸 수 없습니다.
- Trojan: 비밀번호와 TLS 관련 설정, 특히 서버 이름을 확인하세요. IP 주소로 연결하더라도 인증서에 필요한 이름을 해당 IP로 바꿔서는 안 됩니다.
- Hysteria2: 인증 정보, 포트, TLS, 서버에서 지정한 전송 매개변수를 확인하세요. 이후 문제를 점검할 때 네트워크에서 UDP를 허용하는지도 확인해야 합니다.
- WireGuard: 전체 정보를 기준으로 키, 인터페이스 주소, Peer, Allowed IPs를 확인하세요. 일반적인 비밀번호 방식 연결처럼 설정하면 안 됩니다.
예를 들어 서버 정보에 포트가 8443으로 적혀 있으면 8443을 입력하세요. TLS를 사용한다고 해서 443으로 바꾸면 안 됩니다. 서버 필드에는 보통 호스트명이나 IP를 입력하며, https://로 시작하는 웹 주소를 입력하지 않습니다. 경로는 해당 전송 설정에 입력하세요. 저장하기 전에 항목별로 대조하면 저장 후 스위치를 반복해서 바꾸는 것보다 오류를 쉽게 찾을 수 있습니다.
보유한 정보에 맞는 추가 방법 선택
단일 연결 정보만 있는 경우
- Add Server에서 정확한 Type을 선택합니다.
- 서버, 포트, 인증 정보를 각각 입력합니다.
- 서버 측 매개변수가 바뀌면 로컬 설정도 직접 업데이트합니다.
갱신 가능한 구독이 있는 경우
- Subscribe를 통해 원본 구독 URL을 저장합니다.
- 갱신 후 그룹 안의 연결 항목이 변경되었는지 확인합니다.
- 로컬 변경 사항을 유지하려면 먼저 별도로 백업합니다.
두 방법은 정보를 구성하고 관리하는 방식이 다를 뿐, 연결 속도나 서비스 품질에 정해진 차이가 있다는 뜻은 아닙니다.
QR 코드 추가: QR 코드에 담긴 내용부터 확인
QR 코드는 텍스트를 인코딩하는 수단일 뿐입니다. 프로토콜 링크 하나, 구독 URL, 일반 웹페이지 주소 등이 담길 수 있습니다. Home으로 이동해 상단의 QR 코드 아이콘을 눌러 스캔 화면을 여세요. 카메라를 처음 사용할 때는 시스템 안내에 따라 권한을 허용합니다. 인식된 뒤에는 유형과 필드를 확인하고 저장하세요. QR 코드가 인식된다고 해서 연결 매개변수가 유효한 것은 아닙니다.
- 다른 화면에 사용자가 보유한 QR 코드를 표시하고, 코드가 잘리지 않도록 하세요. 반사, 가림, 과도한 확대도 피합니다.
- Shadowrocket의 QR 코드 스캔 기능을 열고 코드에 맞춥니다. 현재 화면에서 사진 보관함의 이미지를 선택할 수 있다면 원본 이미지를 사용하세요. 여러 번 압축된 채팅 앱 미리보기 이미지는 피하는 것이 좋습니다.
- 인식 결과를 확인하세요. 단일 프로토콜 링크는 연결 하나로, 구독 URL은 구독으로 처리해야 합니다. 일반 로그인 웹페이지는 연결로 변환할 수 없습니다.
- 저장한 뒤 Home으로 돌아가 새 항목이나 그룹이 표시되는지 확인하고 연결 테스트를 진행하세요.
카메라 화면이 표시되지 않으면 먼저 시스템 설정에서 Shadowrocket의 카메라 권한을 확인하세요. QR 코드는 보이지만 인식되지 않는다면 이미지가 온전한지, 텍스트가 앱에서 지원하는 형식인지 확인합니다. QR 코드 이미지에는 비밀번호나 token이 포함될 수 있습니다. 문제를 문의할 때 원본 이미지를 공개 게시판에 올리지 마세요.
클립보드 가져오기: 링크 전체와 원래 인코딩 유지
현재 기기에 텍스트가 있다면 QR 코드를 다시 스캔하는 것보다 클립보드를 이용하는 편이 간편합니다. 먼저 링크만 복사한 뒤 Home으로 돌아가 링크 인식 안내에 따라 가져오세요. 필요하면 추가 메뉴에서 클립보드 가져오기 기능을 찾습니다. 시스템에서 붙여넣기 허용 여부를 묻는 경우 허용해야 앱이 해당 내용을 읽을 수 있습니다. 인식 안내가 표시되지 않으면 HTTPS 구독 URL을 Type이 Subscribe인 URL 필드에 직접 붙여 넣으세요.
구독 URL 구조 예시:
https://example.com/sub?token=xxxx
자주 쓰이는 단일 링크 접두사:
ss://
vmess://
vless://
trojan://
위 접두사는 내용 유형을 식별하기 위한 것이며, 그대로 사용할 수 있는 완전한 연결 정보가 아닙니다. 링크에 퍼센트 인코딩, Base64 텍스트, # 뒤의 메모가 포함될 수 있습니다. 문자를 임의로 ‘정리’하면 의미가 바뀔 수 있습니다. 채팅 앱에서 표시되는 말줄임표를 원문으로 착각하지 말고, ‘가져오려면 누르세요’ 같은 안내 문구가 포함된 메시지 전체를 복사하지 마세요.
- 복사해도 반응이 없음: 웹페이지 제목이 아니라 실제 링크 텍스트를 복사했는지 확인하세요. 시스템에서 붙여넣기 권한을 거부하지 않았는지도 살펴보세요.
- 항목 하나만 가져옴: 원문이 단일 프로토콜 링크인지 확인하세요. 연결 하나를 클립보드로 가져와도 구독으로 자동 변환되지는 않습니다.
- 형식 오류 안내: 링크 바깥의 따옴표와 설명을 제거하고 링크 내부 인코딩은 유지하세요. 계속 실패하면 이용 중인 서비스 제공처에 출력 형식을 확인하세요.
- 여러 링크 중 일부가 누락됨: 먼저 완전한 링크 하나로 인식 여부를 확인한 뒤 여러 줄을 처리하세요. 공백으로 여러 링크를 하나로 이어 붙이지 않도록 주의합니다.
가져온 뒤 확인: 연결 선택과 Global Routing을 따로 점검
가져오기는 정보를 저장하는 단계일 뿐, 연결이 이미 수립되었다는 뜻은 아닙니다. 먼저 Home에서 방금 가져온 연결을 선택하고 지연 시간 또는 연결 테스트를 실행한 뒤 연결 스위치를 켜세요. 시스템 VPN 구성을 처음 만들 때는 시스템 안내에 따라 권한을 확인합니다. 지연 시간 테스트에 결과가 표시되어도 해당 테스트 방식만 성공했다는 뜻입니다. DNS, TLS, UDP 또는 모든 대상 웹사이트가 정상이라는 보장은 없습니다.
그다음 Home → Global Routing을 확인하세요. Proxy, Direct, Config, Scene은 서로 다른 라우팅 모드이며 네 가지 프로토콜이 아닙니다. 문제가 어느 단계에서 발생하는지 확인하려면 라우팅 동작을 잠시 비교해 볼 수 있지만, 테스트가 끝나면 기존 설정으로 되돌리세요.
Config
권장현재 구성의 규칙에 따라 트래픽 경로를 결정합니다. 직접 연결 여부는 일치하는 규칙과 마지막 정책에 따라 달라지며, 규칙에 일치하지 않으면 반드시 직접 연결된다는 뜻은 아닙니다.
적합한 경우: 구성을 확인했고 규칙에 따라 트래픽을 분기하려는 경우
Proxy
라우팅 모드를 프록시로 설정해 규칙 선택 때문에 대상 트래픽이 예상과 다르게 프록시를 거치지 않는지 비교합니다.
적합한 경우: 선택한 연결과 라우팅 규칙의 차이를 짧게 확인할 때
Direct
직접 연결 경로를 사용합니다. 이 모드에서 특정 웹사이트에 접속할 수 있더라도 새로 가져온 프록시 연결이 정상이라는 뜻은 아닙니다.
적합한 경우: 로컬 네트워크 자체의 연결 가능성을 비교할 때
Scene
설정된 Scene 조건에 따라 라우팅 동작을 결정합니다. 실제 적용되는 설정은 Scene의 내용을 함께 확인해야 합니다.
적합한 경우: Scene 조건을 구성하고 확인한 뒤 네트워크 전환에 활용할 때
Proxy에서는 접속되지만 Config에서는 되지 않는다면 현재 구성의 DOMAIN-SUFFIX, IP-CIDR, GEOIP, FINAL을 확인하세요. 규칙은 보통 위에서 아래로 평가되며, 일치하면 해당 정책이 적용됩니다. 마지막의 FINAL은 앞선 규칙에 일치하지 않은 트래픽의 경로를 결정합니다. 규칙 문제를 해결하려고 구독을 반복해서 다시 가져오지 마세요.
- 목록에서 마지막으로 다운로드한 파일이 아니라 Config에서 실제로 활성화된 파일을 확인하세요.
- 연결 기록의 대상, 일치한 규칙, 최종 정책을 확인해 ‘프록시를 거치지 않은 경우’와 ‘프록시 연결 실패’를 구분하세요.
- 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 Settings → On Demand의 실행 조건을 확인하세요. On Demand는 필요에 따른 연결을 제어하며 구독을 가져오는 기능은 아닙니다.
가져오기 실패 해결: 결과를 확인한 뒤 네트워크와 형식 점검
오류 안내 문구를 원문 그대로 기록하고 실패가 ‘주소 저장’, ‘내용 가져오기’, ‘내용 분석’, ‘연결 테스트’ 중 어느 단계에서 발생했는지 확인하세요. 각 단계마다 원인이 다릅니다. 구독 URL이 브라우저에서 열린다고 해도 브라우저가 응답을 받았다는 뜻일 뿐입니다. 응답 내용이 로그인 페이지라면 Shadowrocket은 이를 구독으로 분석할 수 없습니다.
| 표시되는 현상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 요청 시간 초과 | 현재 네트워크에서 구독 호스트에 접속할 수 있는지, DNS가 정상인지 확인합니다. | 연결 매개변수를 동시에 변경하지 말고 Wi-Fi와 모바일 네트워크를 전환해 비교합니다. |
| HTTP 401 / 403 | token, 접근 권한, 서버 측 제한 | 이용 중인 서비스 관리 페이지에서 주소와 권한을 확인하세요. 상태 코드만으로 만료되었다고 판단하지 마세요. |
| HTTP 404 | 경로가 완전한지, 주소가 변경되었는지 확인합니다. | 실제 구독 URL을 다시 복사하고 경로를 추측해 입력하지 마세요. |
| 인증서 관련 오류 | 시스템 날짜와 시간, 서버 이름 | 먼저 시스템 시간을 맞춘 다음 원격 인증서 상태를 확인하세요. 검증을 끄는 방식으로 원인을 감추지 마세요. |
| 업데이트는 성공했지만 항목이 없음 | 빈 목록이 반환되었거나 형식이 맞지 않거나 가져오기 메뉴를 잘못 선택했을 수 있습니다. | 반환된 내용이 구성 파일이나 웹페이지가 아니라 노드 구독인지 확인하세요. |
| 항목은 있지만 연결 실패 | 프로토콜, 포트, 인증, TLS, 서비스 상태 | 연결 하나씩 항목을 확인하세요. 먼저 구독 그룹 전체를 삭제할 필요는 없습니다. |
구독을 업데이트하면 구독에서 관리하는 항목이 교체될 수 있습니다. 로컬에서 변경한 이름이나 매개변수가 유지되는지는 구체적인 관리 방식에 따라 다릅니다. 별도 설정을 보존해야 한다면 업데이트 전에 백업하세요. 문제 확인용 스크린샷에는 서버 민감 정보, 비밀번호, UUID, token을 가리고 화면 위치, 오류 문구, 필요한 프로토콜 유형만 남기세요. 문제를 파악하는 데 도움이 되면서 전체 인증 정보는 노출되지 않습니다.