이 글은 서비스 제공업체에서 구독 링크나 연결 정보를 이미 받은 사용자를 위한 안내입니다. 먼저 서버 구독, 원격 구성, 단일 공유 링크를 구분한 뒤 Subscribe, Add Server, QR 코드 또는 클립보드 경로를 선택하세요. 마지막으로 업데이트 결과, 연결 테스트, Global Routing을 확인해 실제로 가져오기가 완료됐는지 점검합니다. 아래 설명은 iPhone / iPad의 Home, Config, Settings 화면을 기준으로 하며, 다른 플랫폼에서는 해당 메뉴를 확인하세요.
먼저 가져올 항목 구분하기: 구독 주소와 설정 파일은 다릅니다
Shadowrocket의 가져오기 경로는 각각 처리하는 항목이 다릅니다. 서버 구독은 여러 서버 정보를 가져오고 업데이트하는 데 사용합니다. 원격 구성에는 일반적으로 라우팅 규칙과 전역 설정이 포함됩니다. 단일 공유 링크는 서버 하나의 정보를 담습니다. 모두 텍스트처럼 보여도 같은 경로로 가져올 수 있는 것은 아닙니다.
구독 링크는 서비스 제공업체에서 받으세요. 계정 로그인 페이지, 구매 내역 페이지, 웹페이지의 설명 문구를 구독 주소로 사용하면 안 됩니다. HTTP 또는 HTTPS는 주소의 전송 방식을 나타낼 뿐, 응답 내용을 앱이 인식할 수 있다는 뜻은 아닙니다. 제공업체가 어떤 형식의 콘텐츠를 제공하는지도 확인해야 합니다.
| 가져올 항목 | 선택할 경로 | 가져온 뒤 생성되는 항목 |
|---|---|---|
| 서비스 제공업체가 제공한 서버 구독 URL | Home → + → Type → Subscribe | 구독 그룹과 해당 그룹의 서버 정보 |
| 원격 구성 URL | Config의 추가 경로; Subscribe에서 원격 구성 구독 관리 | Config에서 선택해 사용할 수 있는 구성 |
| 서버 주소, 포트, 인증 정보 | Home → + → Add Server 편집 화면 | 직접 추가한 서버 정보 한 건 |
| 단일 프로토콜 공유 링크 또는 QR 코드 | QR 코드 스캔 또는 클립보드 가져오기 | 링크에서 해석된 서버 정보 |
예를 들어 링크가 https://example.com/sub?token=xxxx라면 물음표 뒤의 매개변수까지 포함한 전체 문자열이 주소입니다. 이 주소는 형식 설명을 위한 예시이며 연결에 사용할 수 없습니다. 실제 구독 URL의 token은 접근 자격 정보이므로 공개 스크린샷, 채팅 기록, 오류 문의에 포함하지 마세요.
Subscribe: Home과 Config의 구독 항목 구분하기
서버를 여러 개 가져오려면 Home의 추가 경로를 사용하세요. Type에서 Subscribe를 선택한 다음 서비스 제공업체가 준 구독 URL을 입력합니다. 저장 후 구독 그룹이 생성됐는지, 그룹 안에 서버 정보가 표시되는지 확인하세요. 그룹 이름만 보이고 서버 정보가 없다면 구독 가져오기가 완료되지 않았거나 응답을 해석하지 못한 경우가 많습니다. 그룹이 보인다는 이유만으로 가져오기가 끝났다고 판단하지 마세요.
Config의 Subscribe는 원격 구성 구독을 위한 기능이며, Home에서 서버를 가져올 때 사용하는 Subscribe와는 대상이 다릅니다. 원격 구성을 다룰 때는 Config의 추가 경로에서 구성 URL을 입력하고 다운로드한 뒤 해당 구성을 선택하세요. Subscribe에서는 이런 구성 구독을 확인하거나 관리할 수 있습니다. 임의의 서버 구독 URL을 Config에 입력하면 완전한 규칙 구성이 자동 생성될 것이라고 기대하지 마세요.
-
주소 확인
서비스 제공업체에서 서버 구독 URL을 받아 로그인 페이지가 아닌지 확인하세요. 복사할 때
?,&,=와 뒤에 이어지는 매개변수까지 포함해야 합니다. -
유형 선택
Home → +로 이동해 Add Server 편집 화면의 Type에서 Subscribe를 선택하세요. 이전에 서버를 직접 추가할 때 선택한 프로토콜 유형을 그대로 사용하지 마세요.
-
주소 입력
전체 주소를 URL에 붙여넣고 구분하기 쉬운 메모를 입력한 뒤 저장하세요. 이름은 화면에 표시되는 방식에만 영향을 주며 주소나 인증 정보를 바꾸지 않습니다.
-
서버 정보 확인
Home으로 돌아가 첫 가져오기가 끝날 때까지 기다리세요. 필요하면 아래로 당겨 새로고침한 다음 해당 구독에 서버가 나타나는지, 서버 수가 제공업체 안내와 일치하는지 확인합니다.
-
구독 유지
이후에는 기존 구독 그룹을 업데이트하고 같은 URL을 매번 다시 추가하지 마세요. 업데이트 과정에서 서버 정보가 바뀔 수 있으므로 개별 서버에 임시로 적용한 수정 사항은 유지되지 않을 수 있습니다.
구성과 서버는 따로 확인하세요.서버 구독을 성공적으로 가져와도 Config에 필요한 규칙이 준비된 것은 아닙니다. 원격 구성을 다운로드해도 Home에 사용할 수 있는 서버가 생기는 것은 아닙니다. 구성에는 [General], [Rule] 등의 섹션이 포함될 수 있습니다. 연결 정보가 있는지는 실제 내용을 확인해야 하며, .conf 확장자만으로 판단할 수 없습니다.
Add Server: 프로토콜에 맞춰 연결 정보 직접 입력하기
서버 정보만 있고 구독 URL이 없다면 Home → +에서 Add Server를 열고 Type을 선택한 뒤 주소, 포트, 인증 정보를 하나씩 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 각각 필요한 항목이 다릅니다. 모두 프록시 연결에 사용할 수 있다는 이유만으로 같은 값을 다른 Type에 그대로 입력하면 안 됩니다.
예를 들어 VLESS는 사용자 식별 정보로 UUID를 사용하는 경우가 많고, Trojan은 Password를 사용합니다. TLS를 활성화할 때는 서비스 제공업체가 안내한 서버 이름, 인증서, 전송 설정도 확인해야 합니다. 주소에는 도메인을 입력할 수 있으며, 포트는 제공업체가 지정한 정수를 사용합니다. 예시의 443은 포트 값의 예일 뿐 모든 프로토콜의 기본값이 아닙니다.
연결 정보 확인
- Type
- 서비스 제공업체가 안내한 프로토콜과 일치
- Address
- server.example.com (예시)
- Port
- 443 (포트 예시)
- 인증
- 프로토콜에 따라 UUID 또는 Password 등의 항목 입력
Address에는 일반적으로 웹페이지 경로를 입력하지 않습니다. 전체 HTTPS 구독 URL을 서버 도메인으로 사용하지 마세요.
전송 설정 확인
- TLS
- 서비스 제공업체 안내에 따라 활성화하거나 비활성화
- 서버 이름
- 서비스 제공업체가 안내한 TLS 이름과 일치
- 전송 방식
- 서버 설정과 일치
- 추가 매개변수
- 필요에 따라 Path, Host 등의 항목 확인
현재 프로토콜에 필요한 항목만 입력하세요. 매개변수를 확인하는 대신 인증서 검증을 끄지 마세요.
서버 정보를 직접 저장하면 현재 입력한 값만 보관되며, 서비스 제공업체의 이후 변경 사항을 자동으로 반영하지 않습니다. 서버 도메인, 포트, 인증 정보가 바뀌면 직접 편집해야 합니다. 기존 구독에서 같은 서버 정보를 제공한다면 구독을 업데이트하는 편이 낫습니다. 서로 다른 내용의 기록을 두 개씩 관리하는 일을 피할 수 있습니다.
QR 코드 스캔: 코드에 담긴 내용에 따라 가져오기
스캔 경로는 Home 상단의 스캔 아이콘에 있습니다. 처음 사용할 때는 카메라 접근을 허용해야 합니다. 카메라가 열리지 않으면 시스템 설정에서 Shadowrocket의 카메라 권한을 확인하세요. 스캔할 때 QR 코드 전체가 화면에 들어오도록 하고 가장자리를 가리거나 가운데만 잘라내지 마세요.
QR 코드는 텍스트를 담는 수단일 뿐, 구독을 뜻하지는 않습니다. ss://, vmess://, vless://, trojan:// 같은 단일 공유 링크나 HTTPS 주소가 들어 있을 수 있습니다. 인식 후에는 가져오기 안내를 확인해 서버 정보 한 건이 생성되는지, 구독으로 처리해야 하는 URL인지 판단하세요.
- 인식 결과가 없는 경우:선명도, 빛 반사, 잘린 부분이 있는지 먼저 확인하세요. 화면 밝기를 높여 다시 스캔하거나 서비스 제공업체에 원본 텍스트 링크를 요청하세요.
- 일반 웹페이지가 인식된 경우:QR 코드에 안내 페이지나 계정 페이지가 담겼을 수 있습니다. 이를 서버 구독으로 저장하면 안 됩니다.
- 서버 정보는 생겼지만 항목이 누락된 경우:QR 코드가 온전히 보이는지, 링크가 중간에 잘리지 않았는지, 현재 프로토콜의 매개변수가 올바르게 해석됐는지 확인하세요.
- 같은 기기 화면에 QR 코드가 표시된 경우:스캔 화면에 사진 보관함 경로가 있으면 사용하세요. 그렇지 않으면 원본 링크를 복사해 클립보드로 가져오면 됩니다. 화면을 다시 촬영할 필요는 없습니다.
서비스 제공업체가 QR 코드를 바꿔도 이미 직접 가져온 서버 정보는 자동으로 업데이트되지 않습니다. 서버 목록을 계속 동기화하려면 한 번 스캔한 QR 코드에 의존하지 말고 서비스 제공업체가 제공한 구독 URL을 사용하세요.
클립보드: 설명 전체가 아니라 링크를 빠짐없이 복사하기
프로토콜 공유 링크를 복사한 뒤 Home으로 돌아가 클립보드 가져오기 안내가 표시되는지 확인하세요. 추가 메뉴에 클립보드 가져오기 항목이 있다면 그 경로를 사용할 수도 있습니다. 붙여넣기 허용 여부를 묻는 메시지가 나타나면 이번 읽기를 허용하세요. 안내가 뜨지 않으면 클립보드에 링크 텍스트가 남아 있는지 확인한 뒤 해당 가져오기 경로를 다시 여세요.
공유 링크는 보통 프로토콜 접두사로 시작합니다. 예: ss://, vmess://, vless://, trojan://. 인코딩된 내용, 퍼센트 인코딩, 쿼리 매개변수도 모두 링크의 일부입니다. 직접 디코딩하거나 삭제하지 말고, 한국어 문장 부호로 바꾸지도 마세요. 서버 도메인만 복사해서는 완전한 공유 링크가 되지 않습니다.
복사한 내용이 HTTPS 구독 주소라면 Home → + → Type → Subscribe 경로를 사용하면 항목 유형을 더 쉽게 확인할 수 있습니다. 공유 링크를 여러 개 복사할 때는 한 줄에 하나씩 넣고 글머리 기호, 따옴표, 설명 문구는 제거하세요. 가져온 뒤 링크별 이름과 매개변수를 확인합니다. 클립보드 읽기 실패는 가져오기 단계의 문제이며 프록시 연결 성공 여부와는 관계가 없습니다.
가져온 뒤 확인하기: 업데이트, 연결 테스트, 라우팅 순서로 점검
가져오기에 성공했다는 것은 콘텐츠를 저장했거나 해석했다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 보장은 아닙니다. Home으로 돌아가 서버 하나를 선택하고 Connectivity Test를 실행한 뒤 연결을 켜세요. 처음 연결할 때 시스템 안내에 따라 VPN 구성을 추가하도록 허용해야 합니다. 테스트에 응답이 있어도 해당 테스트 경로가 작동한다는 뜻일 뿐이므로 실제 사용 대상에 연결해 확인하세요.
- 선택 항목 확인:선택한 서버가 방금 가져온 그룹의 서버인지, 예전에 저장한 항목은 아닌지 확인하세요.
- Global Routing 확인:Proxy는 트래픽을 프록시로 처리하고, Direct는 직접 연결합니다. Config는 선택한 구성에 따라 라우팅하며, Scene은 설정된 시나리오에 따라 작동합니다. Direct에서 웹페이지가 열린다고 해서 프록시 연결이 확인된 것은 아닙니다.
- Config 확인:Config를 사용하는 경우 의도한 구성이 선택되어 있는지 확인하세요. 규칙은 위에서부터 순서대로 적용됩니다. 예를 들어
DOMAIN-SUFFIX,example.com,DIRECT는 해당 도메인을 DIRECT로 연결하고,FINAL은 다른 규칙에 일치하지 않을 때 적용됩니다. - 자동 연결 확인:Settings → On Demand에서는 조건에 따라 연결을 시작하도록 설정할 수 있습니다. 구독을 다운로드하거나 서버 매개변수 오류를 수정하는 기능은 아닙니다. 수동으로 문제를 확인할 때는 현재 연결 상태부터 점검하세요.
구독 업데이트와 서버 연결은 서로 다른 네트워크 요청입니다. 구독 주소가 만료되어 업데이트가 실패할 수도 있고, 특정 서버에 연결할 수 없어 연결 테스트가 실패할 수도 있습니다. 문제를 확인할 때는 오류 문구, 발생 단계, 현재 네트워크 유형을 기록하세요. “가져오기 실패”나 “작동하지 않음”처럼 원인을 파악하기 어려운 설명만 남기지 마세요.
자주 발생하는 오류: 실패한 단계별 해결 방법
구독 업데이트 시간 초과: 먼저 확인할 항목
먼저 현재 Wi-Fi 또는 셀룰러 네트워크에서 인터넷에 접속할 수 있는지 확인한 뒤 Home에서 구독을 새로고침하세요. 구독 주소에 접근하려면 사용 가능한 프록시가 필요한 경우, 먼저 연결 가능한 서버를 선택해 연결한 다음 Settings → Subscribe에서 Update via Proxy를 확인하세요. 사용 가능한 프록시가 없으면 이 설정을 켜도 연결이 만들어지지 않습니다. 주소에 필요한 접근 조건은 서비스 제공업체에 문의하세요.
링크가 열리는데도 해석할 수 없다는 메시지가 표시되는 경우
응답이 로그인 페이지, 오류 페이지, 서비스 만료 안내가 아닌지 확인하세요. HTTP 200 응답이어도 구독 데이터가 아니라 HTML이 반환될 수 있습니다. URL 전체에서 token이 빠지지 않았는지 확인하고, Shadowrocket에서 사용할 수 있는 구독 형식인지 서비스 제공업체에 문의하세요. 웹페이지를 파일로 저장해 구성으로 가져오지 마세요.
401 또는 403 오류: 다시 추가해야 하나요?
이 상태 코드는 대개 인증이나 접근 제한과 관련이 있습니다. 먼저 URL 매개변수가 온전한지 확인한 뒤 구독 유효 기간과 접근 조건이 변경됐는지 살펴보세요. 같은 URL을 반복해서 추가해도 인증 문제는 해결되지 않습니다. 구독 인증 정보가 바뀌었다면 기존 구독 주소를 수정하고 업데이트해 새 그룹과 이전 그룹이 뒤섞이지 않도록 하세요.
서버 목록은 보이는데 웹페이지가 열리지 않는 이유
먼저 Home에서 올바른 서버를 선택하고 연결을 켠 뒤 Connectivity Test를 실행하세요. Global Routing이 Direct로 설정되어 있는지 확인하고, Config를 사용하는 경우 DIRECT 또는 REJECT 규칙에 일치하는지 살펴보세요. 모든 서버가 실패하면 네트워크와 인증 정보를 다시 확인하세요. 하나만 실패한다면 해당 서버의 포트, TLS, 전송 매개변수를 점검합니다.
문의하기 전에 자격 정보를 숨기세요.구독 URL, QR 코드, UUID, Password에는 민감한 정보가 포함될 수 있습니다. 오류 문구, 사용한 경로, 이미 확인한 항목만 전달하세요. 전체 매개변수를 확인해야 한다면 서비스 제공업체의 비공개 지원 채널을 이용하고 원본 구독 정보를 공개 게시하지 마세요.
Shadowrocket 다운로드 및 빠른 시작
iPhone / iPad 버전은 App Store에서 $2.99에 한 번 결제하면 됩니다. 시스템 요구 사항은 App Store 페이지를 확인하세요. Mac(Apple 실리콘 / Intel), Windows, Android, Linux 버전은 무료입니다. 다운로드 페이지에서 플랫폼을 선택한 뒤 빠른 시작 안내에 따라 연결을 확인하세요.
앱 구매와 서버 이용 요금제는 별개입니다. 이 안내는 사용자가 서비스 제공업체와 구독을 이미 보유하고 있다는 전제로 작성되었습니다. 구독 링크는 서비스 제공업체에서 받으세요.