공식 매뉴얼 · 첫 연결 단계

Shadowrocket 구독 가져오기 및 연결 사용법

“추가 → 모드 선택 → 연결 → 확인 → 문제 해결” 순서로 첫 설정을 완료합니다.
iPhone / iPad 화면을 기준으로 기존 서버 연결을 확인한 뒤 규칙 분기를 점검합니다.

  • 기존 구독 또는 서버 정보
  • 영문 화면 용어 기준 안내
  • 공식 App Store 스크린샷

시작 전: 설치 및 연결 정보 확인

먼저 가지고 있는 정보의 종류를 확인합니다. 서버 목록을 업데이트하는 링크라면 보통 Subscribe로 가져오고, 단일 서버의 주소·포트·인증 매개변수라면 해당 Type으로 추가합니다. 정보에 맞는 한 가지 방법을 선택하면 되며 같은 내용을 중복해서 가져올 필요는 없습니다. 구독 링크에는 개인 인증 정보가 포함될 수 있으므로 공개 페이지에 올리거나 출처가 불분명한 도구에 입력하지 마세요.

아래 스크린샷은 페이지와 입력 항목을 확인하기 위한 자료이며 연결 정보를 그대로 복사하라는 뜻은 아닙니다. 표시되는 설정 항목은 선택한 Type과 앱 화면에 따라 달라질 수 있으므로, 입력할 때는 본인의 서비스 제공자가 안내한 매개변수를 따르세요. 처음에는 확인 가능한 연결 하나를 먼저 완료하고, 이후 여러 구독이나 복잡한 규칙, 자동 연결을 설정하면 문제 원인을 파악하기 쉽습니다.

STEP 01 · Home / Add Server

서버 추가 또는 Subscribe 가져오기

Shadowrocket을 열고 Home 화면으로 이동합니다. 이미 연결되어 있다면 설정을 변경하는 동안 연결되지 않도록 상단 스위치를 먼저 끕니다. Add Server를 찾거나 페이지의 추가 버튼을 눌러 Add Server로 이동합니다. 정보 유형에 따라 구독을 가져오거나 단일 서버 정보를 입력합니다. 저장한 뒤에는 Home으로 돌아가 결과를 확인합니다.

기존 구독 링크가 있는 경우: Subscribe 선택

Add Server의 Type에서 Subscribe를 선택하고 서비스 제공자에게 받은 전체 구독 링크를 URL에 입력합니다. 붙여넣은 뒤 링크의 앞뒤를 확인하고, 복사한 메시지에 포함된 따옴표·설명 문구·줄바꿈은 제거합니다. 링크의 쿼리 매개변수는 임의로 삭제하거나 수정하지 마세요. 구독을 알아보기 쉬운 이름으로 지정하고 저장한 뒤 목록이 불러와질 때까지 기다립니다. Home으로 돌아가 해당 그룹과 서버 항목이 표시되는지 확인합니다.

구독을 저장했다고 연결된 것은 아닙니다. 그룹은 표시되지만 서버가 없다면 링크가 유효한지, 현재 기본 네트워크에서 구독 내용을 가져올 수 있는지, 서비스 제공자가 새 링크를 요구하는지 확인합니다. 구독 주소와 특정 서버의 Host를 혼동해 입력하지 마세요. 전자는 목록을 불러오는 데 사용하고, 후자는 단일 연결 대상입니다. 구독을 업데이트하면 목록이 바뀔 수 있으므로 매개변수를 수동으로 변경하기 전에 원래 정보를 보관해 다음 업데이트 후 변경 내용을 구분할 수 있도록 합니다.

기존 단일 서버 정보가 있는 경우: Type에 맞게 입력

Type에서 정보에 맞는 프로토콜을 선택합니다. 예: Shadowsocks, VMess, VLESS 또는 Trojan. 그런 다음 Host, Port 및 해당 유형에 필요한 인증·전송 필드를 확인합니다. 스크린샷의 Password, Method 등의 항목은 해당 유형에서만 사용되며 모든 프로토콜에 공통으로 필요한 목록이 아닙니다. Host에 웹페이지 경로를 포함하지 말고 Port는 서비스 제공자의 정보와 정확히 일치시킵니다. Password, 식별자와 키는 대소문자를 그대로 유지해야 합니다.

QR 코드가 있다면 Scan QR Code를 사용할 수 있으며 시스템에서 요청하면 카메라 접근을 허용합니다. Import from Cloud JSON은 해당 형식의 정보에만 사용하고 일반 구독 링크를 임의로 입력하지 마세요. 가져온 뒤에도 항목을 열어 Type과 주요 필드를 확인합니다. 마지막으로 Home으로 돌아가 SERVER 아래에서 해당 항목을 선택할 수 있는지 확인합니다. 이 단계에서는 연결 상태를 판단하지 말고, 다음 단계에서 트래픽에 적용할 모드를 먼저 정합니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 및 QR 코드 가져오기 항목이 표시됩니다.
Add Server: 먼저 Type을 선택한 뒤 본인의 정보에 맞는 필드를 입력합니다.
STEP 02 · Global Routing / Config

Global Routing의 세 가지 모드 선택

서버가 목록에 표시되면 Home으로 돌아가 Global Routing을 누릅니다. 여기서는 요청의 경로를 선택하며 서버 정보를 입력하는 기능은 없습니다. 세 가지 모드는 구성(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 테스트 목적을 먼저 정한 뒤 모드를 선택하면 서버 연결 여부와 규칙 일치 여부를 같은 문제로 혼동하지 않을 수 있습니다.

구성(Config): 현재 구성의 규칙에 따라 처리

일상적으로 프록시와 직접 연결을 구분하려면 구성(Config)을 사용합니다. 그런 다음 Config로 이동해 사용할 구성 파일이 선택되어 있는지 확인합니다. 파일이 다운로드된 것만 보고 활성화되었다고 판단하지 마세요. 구성을 열면 General, Rule 등의 구역을 확인할 수 있습니다. 규칙은 요청이 PROXY, DIRECT 또는 REJECT 중 어디에 일치하는지 결정합니다. 처음 설정할 때 모든 항목을 수정할 필요는 없습니다. 먼저 구성의 출처와 용도를 확인하고 복구할 수 있도록 원본 파일을 보관합니다.

예를 들어 아래 두 줄은 example.com과 하위 도메인에 일치하는 요청을 PROXY로 보내고, 다른 규칙에 일치하지 않은 요청은 DIRECT로 보냅니다. 이는 구문 설명을 위한 일부이며 완전한 구성도, 이 안내에서 바로 가져와야 하는 템플릿도 아닙니다. 규칙은 위에서 아래로 검사되며 먼저 일치한 규칙이 결과를 결정하므로 FINAL은 규칙의 마지막에 두어야 합니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

프록시(Proxy)와 직접 연결(Direct): 원인을 나누어 확인

선택한 서버가 프록시 요청을 처리할 수 있는지 잠시 확인하려면 Proxy를 사용합니다. 규칙 분기의 영향을 줄여 테스트할 수 있습니다. Direct는 기본 네트워크에서 대상에 직접 접근할 때의 상태를 확인하는 모드이며, 프록시 서버가 검증되었다는 뜻은 아닙니다. 세 모드는 연결 품질 등급이 아니며 기기의 모든 시스템 트래픽이 같은 방식으로 처리된다는 보장도 없습니다. 시스템 라우팅과 관련 설정이 실제 경로에 영향을 줄 수 있습니다.

모드를 바꾼 뒤 Home으로 돌아와 Global Routing 항목에 예상한 옵션이 표시되는지 확인합니다. Proxy에서 접속할 수 있지만 Config로 돌아온 뒤 특정 대상에 연결되지 않는다면, 점검의 초점을 현재 구성의 규칙과 DNS 확인으로 옮깁니다. 서버를 반복해서 바꾸는 것은 적절한 첫 단계가 아닙니다. 일치 순서, 정책 또는 전체 구성 구조를 알아보려면 규칙 참고 자료를 읽고, 용어를 빠르게 확인하려면 개념 빠른 참조를 살펴보세요.

Shadowrocket의 Config 구성 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 구역과 Add Rule 항목이 표시됩니다.
Config: 현재 사용 중인 구성과 Rule 구역을 확인합니다. 모드 전환은 Home의 Global Routing에서 할 수 있습니다.
STEP 03 · Home / SERVER

서버를 선택한 뒤 연결 스위치 켜기

모드를 선택한 뒤 Home으로 돌아옵니다. SERVER 그룹에서 사용할 서버를 눌러 선택 표시가 원하는 항목에 있는지 확인합니다. 구독 그룹 이름과 개별 서버 이름은 서로 다릅니다. 그룹을 펼치는 것만으로 현재 서버가 바뀌지는 않습니다. 이름이 비슷한 항목이 여러 개라면 항목을 열어 주소와 Type을 확인한 뒤 돌아와 선택합니다.

Global Routing을 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 안내를 읽고 직접 시작한 작업인지 확인한 다음 허용하고 시스템의 요구에 따라 기기 인증을 완료합니다. 이 단계는 앱이 해당 네트워크 연결을 설정하도록 승인하는 과정이며 서버를 만들거나 연결 서비스를 구매하거나 잘못된 매개변수를 수정하지는 않습니다.

시스템 안내를 완료하고 Shadowrocket으로 돌아와 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 이전에 승인을 취소했다면 스위치를 다시 켤 때 시스템 안내를 다시 확인합니다. 기기가 조직에서 관리되거나 시스템 제한을 받는 경우에는 기기 관리 요구 사항에 따라 처리해야 하며 스위치를 반복해서 눌러 해결할 수 없습니다. 안내 내용을 확인하지 않은 채 연속해서 전환하면 현재 승인 단계인지 실제 연결 단계인지 판단하기 어려워집니다.

상단에 연결 상태가 표시된다는 것은 연결 기능이 활성화되었다는 뜻일 뿐, 구독에 포함된 모든 서버를 사용할 수 있거나 모든 대상에 프록시가 적용되었다는 증거는 아닙니다. 현재 서버와 모드를 유지한 채 다음 단계에서 테스트합니다. 스위치를 켠 직후 다시 꺼진다면 시스템 안내나 오류 메시지가 나타났는지 기록하고, 마지막 절차에 따라 승인·구성·네트워크를 차례로 확인합니다.

처음 수동으로 연결을 확인할 때는 On Demand를 동시에 조정하지 않는 것이 좋습니다. 네트워크 조건이 충족되면 On Demand가 연결을 다시 시작할 수 있어 수동 연결 해제와 재연결의 변화를 파악하기 어려워집니다. 먼저 수동 연결이 반복해서 성공하는지 확인한 뒤 필요에 따라 자동 연결 조건을 설정합니다. On Demand의 의미는 개념 빠른 참조에서 확인할 수 있습니다.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 그룹 및 Add Server가 표시됩니다.
Home: SERVER 항목을 선택하고 Global Routing을 확인한 뒤 상단 스위치를 켭니다.
STEP 04 · Connectivity Test

테스트, 실제 접속 및 규칙 기록으로 작동 확인

연결 스위치를 켠 상태에서 먼저 Home의 Connectivity Test를 실행합니다. 이 테스트는 현재 테스트 방법에 따른 연결 가능성을 확인하기 위한 것으로, 모든 웹사이트와 프로토콜을 사용할 수 있다고 보장하지는 않습니다. 결과가 반환되지 않아도 모든 연결이 실패했다고 바로 판단할 수 없습니다. 테스트 대상과 방법, 현재 네트워크 환경이 결과에 영향을 줄 수 있으므로 실제 접속으로도 확인해야 합니다.

브라우저를 열어 실제로 접속하려는 페이지를 새로고침합니다. 이미 열려 있는 탭만 보지 마세요. 캐시된 콘텐츠 때문에 연결이 끊긴 상태에서도 페이지가 열리는 것처럼 보일 수 있습니다. 페이지의 새 콘텐츠가 로드되는지 확인하고 필요하면 접근 권한이 있는 다른 대상에서도 확인합니다. 이때 서버와 모드를 동시에 바꾸면 접속이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다.

Config 모드에서는 두 가지 경로를 확인

구성(Config)을 사용한다면 본인의 규칙에 따라 PROXY를 사용해야 하는 대상 하나와 DIRECT로 연결해야 하는 대상 하나를 각각 선택해 테스트합니다. 두 대상 모두 열리더라도 규칙이 올바르다는 뜻은 아닙니다. 앱에서 확인할 수 있는 연결 기록과 함께 요청 대상, 일치한 규칙 및 적용된 정책을 점검합니다. DIRECT는 원래 직접 연결해야 하므로 해당 페이지가 열린다는 이유만으로 프록시 서버가 정상이라고 판단할 수 없습니다.

관찰 결과에 따라 다음 점검 항목 확인
관찰 결과의미 및 다음 단계
연결 상태지만 대상이 열리지 않음상단 상태만 보지 말고 선택한 서버, 도메인 확인 및 규칙을 점검합니다.
Proxy에서는 접속되지만 Config에서는 실패현재 적용 중인 구성, 규칙 순서, REJECT 또는 예상하지 않은 DIRECT에 일치하는지 확인합니다.
테스트 결과는 없지만 실제 접속은 정상Settings에서 Test Method를 확인하고 한 번의 테스트 결과만으로 결론 내리지 않습니다.
특정 대상 하나만 실패해당 대상의 규칙, DNS 확인 및 서비스 상태를 중점적으로 살피고 성공한 다른 설정은 유지합니다.

Data에 업로드 또는 다운로드 수치가 표시되면 트래픽이 발생했다는 단서로 활용할 수 있지만, 통계만으로 특정 규칙이 일치했다고 볼 수는 없습니다. “스위치 활성화”, “서버 사용 가능”, “규칙 경로 정상”을 각각 확인하면 더 정확하게 판단할 수 있습니다. 한 번 확인을 마치면 다음 문제 해결을 위해 현재 서버, Global Routing 및 구성 이름을 기록합니다.

STEP 05 · Settings / Diagnostics

실패 상황에 따라 확인하고 한 번에 하나씩 변경

문제가 발생하면 먼저 방금 확인한 결과를 정리합니다. 구독을 불러오지 못했는지, 스위치가 켜진 상태를 유지하지 못하는지, 테스트 결과가 없는지, 특정 대상만 열리지 않는지 구분합니다. Settings로 이동하기 전에 연결을 끄고 기본 Wi-Fi 또는 셀룰러 네트워크에서 정상적으로 접속할 수 있는지 확인합니다. 현재 네트워크에 웹 인증이 필요하다면 먼저 인증을 완료한 뒤 Shadowrocket에서 다시 시도합니다.

구독이 비어 있거나 매개변수가 잘못된 경우

선택할 서버가 없다면 구독 항목으로 돌아가 링크가 완전한지, 만료되었는지, 서비스 제공자가 구독 내용을 변경했는지 확인합니다. 다시 업데이트하기 전에 어떤 그룹을 처리하는지 확인하고 같은 링크로 구독을 여러 개 만들지 않습니다. 단일 서버 연결이 실패하면 Type, Host, Port, Password 및 프로토콜별 필드를 하나씩 대조합니다. 다른 유형의 필드를 조합해 겉보기에 완성된 구성을 만들지 마세요.

특정 서버만 문제가 있고 본인이 보유한 다른 서버는 정상적으로 연결된다면 우선 문제가 있는 항목의 정보와 사용 가능 여부를 확인합니다. 정보가 다시 필요한 경우 서비스 제공자에게 요청하세요. 현재 모드, 항목 유형, 기본 네트워크 상태를 생략하고 단순히 “앱 연결 실패”라고만 설명하지 마세요. 이 정보에 따라 이후 점검해야 할 부분이 달라집니다.

스위치, 테스트 및 실제 접속을 각각 확인

스위치가 켜진 상태를 유지하지 못하면 먼저 시스템의 VPN 구성 추가 승인이 완료되었는지 확인한 다음 다른 VPN 연결이 사용 중인지 또는 기기 관리 제한이 있는지 살펴봅니다. 테스트 결과와 실제 접속이 다르면 Settings에서 Test Method를 확인하고 기존 선택을 기록한 뒤 현재 목적에 맞는 테스트 방법을 시도합니다. 한 항목만 변경하고 Home으로 돌아가 다시 테스트한 다음 유지 여부를 결정합니다. 테스트 결과를 얻기 위해 DNS, 규칙, 서버를 동시에 바꾸지 마세요.

Proxy에서는 정상인데 Config에서 문제가 생기면 Config로 돌아가 적용 중인 파일과 Rule 순서를 확인합니다. 대상이 먼저 REJECT에 일치하는지, DIRECT 규칙이 대상을 가져가는지, 마지막 FINAL이 예상한 대로 설정되어 있는지 우선 확인합니다. 모든 규칙을 바로 지우지 마세요. 먼저 원본 구성을 저장하고 단일 대상에 맞춰 변경한 뒤 검증합니다. 자세한 문제 해결 방법은 규칙 및 구성 참고 자료에서 확인할 수 있습니다.

추가 문의를 위해 필요한 정보 정리

Settings의 Diagnostics에서 진단 항목을 확인하고 해당 작업에서 얻은 단서를 정리할 수 있습니다. Wi-Fi 또는 셀룰러 네트워크 중 어디에서 문제가 발생했는지, 사용한 Type과 Global Routing, 구체적인 오류 문구, 본인이 보유한 다른 항목으로 바꾼 뒤에도 실패하는지 기록합니다. 외부에 공유하기 전에 구독 전체 링크, 비밀번호, 키, 개인 주소 및 계정 정보를 가립니다. 스크린샷에는 문제와 관련된 필드와 안내만 남깁니다.

변경해도 나아지지 않는다면 변경 전 상태로 되돌린 뒤 다음 항목을 확인합니다. 불확실한 설정을 여러 개 더하는 것보다 마지막으로 성공한 조합으로 복구하는 편이 재현과 점검에 유리합니다. 승인, 구독 업데이트 및 일반적인 화면 관련 질문은 자주 묻는 질문에서 확인할 수 있습니다. 이 페이지에서는 첫 사용 과정을 마무리하고 복잡한 구성은 다루지 않습니다.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정 항목이 표시됩니다.
Settings: 테스트에 문제가 있으면 Test Method를 확인하고, 추가 점검에는 Diagnostics를 사용합니다.

연결 확인 후 설정을 보관하고 다른 기기 준비

연결을 반복해서 설정할 수 있고 실제 접속이 예상대로 동작하며 Config에서 규칙 경로까지 확인했다면 현재 설정을 보관합니다. 이후 구독을 업데이트하거나 규칙을 수정할 때는 한 번에 한 종류만 변경하고 문제가 생기면 확인된 상태로 되돌립니다. 더 많은 규칙을 관리하려면 규칙 참고 자료를 확인하세요. 처음 연결할 때 모든 고급 설정을 한꺼번에 완료할 필요는 없습니다.