공식 가이드 · 첫 연결 단계
Shadowrocket 구독 가져오기 및 연결 안내
‘정보 가져오기 → Global Routing 선택 → 연결 켜기 → 결과 확인 → 문제 단계 파악’ 순서로 진행하세요. 먼저 기존 서버 기록 하나의 연결을 확인한 뒤 다른 구독과 규칙을 정리합니다. 처음 설정할 때 여러 옵션을 동시에 변경하지 마세요.
- 조작 화면 Home / Config
- 지원 기기 iPhone / iPad
- 준비 사항 기존 연결 정보
이 페이지에서는 처음 설정할 때 필요한 절차를 안내합니다. 구독 업데이트, 여러 구독 관리, 항목 설명과 백업 방법은 구독 및 서버 관리 가이드에서 확인하세요.
[Before You Start]시작하기 전에 App Store에서 Shadowrocket을 설치하고 본인의 구독 링크나 서버 정보를 준비해야 합니다. 이 사이트는 서버 정보나 구독을 제공·판매·추천하지 않습니다. 앱은 일회성 구매이며 회선 요금제와는 별개입니다. 앱을 구매해도 사용할 서버가 자동으로 생성되지는 않습니다.
아직 설치하지 않았다면 먼저 App Store 정식 구매 및 설치 안내를 확인하세요. iPhone과 iPad의 시스템 요구 사항, 호환성 및 구매 적용 범위는 App Store 페이지를 기준으로 합니다. 아래 단계에서는 앱의 영문 화면 이름을 사용하므로 버튼의 고정된 위치를 외울 필요가 없습니다.
[Subscribe] 01단계 · 연결 정보 준비
서버 추가 또는 기존 구독 가져오기
먼저 보유한 정보가 구독 주소인지, 단일 공유 링크인지, 아니면 서버 설정값인지 확인하세요. 유형에 따라 입력 경로가 다르므로 링크가 URL처럼 보인다는 이유만으로 Subscribe를 선택하지 마세요.
구독 주소가 있는 경우: Subscribe 선택
Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 더하기 버튼을 눌러 Add Server로 들어갑니다. Type에서 Subscribe를 선택하고 본인의 전체 구독 주소를 URL에 입력한 뒤 알아보기 쉬운 메모를 추가해 저장합니다. 구독을 저장하거나 업데이트하면 보통 여러 서버 기록이 생성됩니다. 편집 화면에 머물러 가져오기가 끝났다고 판단하지 말고 Home으로 돌아와 해당 그룹과 항목이 표시되는지 확인하세요.
주소를 복사할 때는 첫 글자부터 마지막 글자까지 확인하세요. 쿼리 매개변수에 인증 정보가 포함될 수 있으므로 물음표 뒤의 내용을 함부로 지우지 마세요. 채팅 문구, 한국어·중국어 따옴표, 줄바꿈이나 문장 끝의 문장 부호가 함께 복사되지 않도록 주의하세요. 아래 내용은 구독 주소의 형식을 알아보기 위한 예시일 뿐 실제 연결에는 사용할 수 없습니다. 작업할 때는 본인이 보유한 전체 주소를 사용하세요.
https://example.com/sub?token=xxxx저장 후 서버가 표시되지 않으면 먼저 URL이 온전한지 확인하고 앱에 표시된 안내를 살펴보세요. 목록을 만들기 위해 같은 구독을 반복해서 추가하거나 Subscribe를 단일 서버 프로토콜로 바꿔 파싱을 시도하지 마세요. 빈 목록 문제와 단일 서버 연결 실패는 서로 다른 단계의 문제이므로 따로 해결해야 합니다.
서버 설정값이 있는 경우: Add Server에서 항목별로 입력
주소, 포트, 비밀번호와 프로토콜 정보가 있다면 Add Server의 Type에서 자료와 일치하는 프로토콜을 선택하고 화면에 표시되는 항목을 입력하세요. Address에는 서버 호스트 이름이나 주소를 입력하며 웹 경로를 임의로 덧붙이지 마세요. Port는 제공된 정보와 일치해야 합니다. 비밀번호, 암호화 방식, UUID, TLS, SNI 등의 입력 여부는 선택한 프로토콜과 서버 요구 사항에 따라 다릅니다. 다른 항목의 값을 추측해 복사하지 마세요.
입력이 끝나면 저장하고 Home으로 돌아와 새 항목이 있는지 확인하세요. 프로토콜이 같아도 설정값까지 같은 것은 아닙니다. 특히 Trojan의 비밀번호와 SNI, Shadowsocks의 암호화 방식과 비밀번호는 서로 바꿔 쓸 수 없습니다. 필수 항목에 관한 정보가 없다면 기존 서버 자료를 확인하세요. 안내를 피하려고 검증 옵션을 끄지 마세요.
공유 링크나 QR 코드가 있는 경우: 가져온 뒤 확인
ss://, vmess://, vless:// 또는 trojan://로 시작하는 내용은 보통 단일 공유 링크이며 계속 업데이트되는 구독과는 다릅니다. 클립보드로 가져올 때는 앱에 표시되는 안내를 따르세요. QR 코드가 있다면 Scan QR Code로 스캔하고 시스템 안내에 따라 필요한 카메라 접근을 허용합니다. QR 코드를 공개 페이지에 올려 다른 사람에게 판독을 요청하지 마세요.
어떤 방법을 사용하든 마지막에는 Home으로 돌아와 사용할 서버 행을 누르고 선택 표시를 확인하세요. 다음 단계로 넘어가기 전에 서버 하나를 선택합니다. 구독 그룹에 여러 항목이 있어도 이번 연결에 모두 사용되는 것은 아닙니다. 자세한 가져오기 및 관리 방법은 Subscribe 관리 안내를 참고하세요.
[Global Routing] 02단계 · 트래픽 처리 방식 선택
구성, 프록시 또는 직접 연결 선택
서버 기록을 추가한 뒤에는 이를 어떤 방식으로 사용할지도 지정해야 합니다. Global Routing과 서버 선택은 별개입니다. Global Routing은 트래픽 처리 방식을 정하고, 서버 선택은 프록시가 필요할 때 사용할 서버 기록을 정합니다.
Home에서 Global Routing을 열고 현재 목적에 맞는 세 가지 모드 중 하나를 선택합니다: 구성(Config), 프록시(Proxy), 직접 연결(Direct). 선택한 뒤 Home으로 돌아와 표시된 모드를 확인하고 연결 스위치를 켜세요. 이전에 선택한 항목을 기억하는 것만으로는 충분하지 않습니다. 문제를 해결할 때도 현재 모드를 다시 확인하세요.
구성(Config): 현재 구성 파일의 규칙에 따라 처리
규칙 구성이 있고 대상별로 다른 정책을 적용하려면 구성(Config)을 선택하세요. 그런 다음 Config로 이동해 사용할 구성 파일이 실제로 활성화되어 있는지 확인합니다. Config에 파일 이름이 보이거나 파일을 목록으로 가져온 것만으로는 현재 활성화된 항목을 확인한 것이 아닙니다. 구독은 서버 기록을 제공하고 구성 파일은 규칙을 관리합니다. 구독을 가져왔다고 규칙까지 준비된 것은 아닙니다.
Config 모드에서는 규칙에 따라 대상에 PROXY, DIRECT 또는 다른 지정 정책이 적용될 수 있습니다. 규칙 순서와 마지막 대체 규칙도 결과에 영향을 줍니다. 따라서 특정 웹사이트가 직접 연결된다는 이유만으로 서버에 문제가 있다고 판단하지 마세요. 먼저 해당 대상에 원래 어떤 정책이 적용되어야 하는지 확인하세요. 처음 설정할 때는 현재 구성이 맞는지 확인하면 충분하며 전체 규칙을 바로 편집할 필요는 없습니다.
프록시(Proxy): 선택한 프록시 경로 확인
선택한 서버가 일반적인 접속 트래픽을 처리할 수 있는지 먼저 확인하려면 임시로 프록시(Proxy)를 선택할 수 있습니다. 규칙 매칭에 따른 변수는 줄일 수 있지만 시스템의 네트워크 동작과 관련 설정의 영향은 여전히 받습니다. 기기의 모든 통신이 반드시 프록시를 거친다고 보장하는 모드는 아닙니다. 확인을 마친 뒤 평소 규칙 기반 분할이 목적이라면 구성(Config)으로 돌아가 대상 서비스가 예상대로 작동하는지 다시 확인하세요.
직접 연결(Direct): 선택한 프록시 서버를 거치지 않음
직접 연결(Direct)은 프록시 서버를 통하지 않는 접속에 사용합니다. 프록시 서버가 작동하는지 확인하는 용도로 사용하지 마세요. Home에서 서버를 선택했더라도 Global Routing이 Direct이면 대상에 접속할 때 해당 서버를 거치지 않을 수 있습니다. 기본 네트워크와 프록시 경로를 비교하려면 모드를 바꾸기 전후의 결과를 기록하세요. 비교가 어려워지지 않도록 한 번에 모드만 변경하고 서버는 바꾸지 마세요.
이 단계의 완료 기준은 현재 어떤 모드를 선택했으며 그 이유가 무엇인지 설명할 수 있는 것입니다. DOMAIN-SUFFIX, IP-CIDR, FINAL의 규칙 매칭 방법은 서버 관리 및 구성 안내에서 확인하세요. 첫 연결 단계에서는 확인된 설정을 그대로 유지합니다.
[Connect] 03단계 · 시스템 연결
스위치를 켜고 VPN 구성 허용
Home으로 돌아와 선택한 서버와 Global Routing을 다시 확인한 뒤 상단의 연결 스위치를 켭니다. 최초 승인은 앱이 기기에 VPN 구성을 추가하도록 허용하는 절차입니다. 연결에는 본인이 이미 보유한 구독 또는 서버 정보를 사용합니다.
처음 활성화할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 진행 중인 작업에 대한 요청인지 확인한 뒤 시스템 안내에 따라 허용하고 기기에서 요구하는 확인 절차를 완료하세요. 이 승인은 앱이 기기에 해당 네트워크 구성을 설정하도록 허용하는 것입니다. 시스템이 서버 비밀번호를 확인했다는 뜻도, 원격 서비스에 반드시 연결된다는 뜻도 아닙니다.
이전에 안내를 취소했다면 Home으로 돌아가 스위치를 다시 켜고 승인 화면이 다시 표시되는지 확인하세요. 계속 진행하기 위해 용도를 모르는 기기 구성을 삭제하지 마세요. 기기가 조직의 관리 대상이라면 해당 작업이 관리 정책상 허용되는지 먼저 확인하세요. 시스템에서 제한 메시지가 명확하게 표시될 때 서버 설정을 반복해서 바꿔도 승인 문제는 해결되지 않습니다.
시스템 확인을 마치면 Shadowrocket으로 돌아와 연결 스위치가 켜진 상태로 유지되는지 확인하세요. 연결이 설정되는 동안에는 현재 작업이 끝날 때까지 기다리고 스위치를 빠르게 반복해서 켰다 끄지 마세요. 스위치가 바로 꺼지면 표시된 오류 문구를 기록한 다음 5단계에서 시스템 승인, 현재 네트워크, 구성 문제를 구분해 확인하세요. ‘열리지 않음’ 같은 포괄적인 표현보다 정확한 안내가 문제 파악에 도움이 됩니다.
iPhone과 iPad 모두 이 순서에 따라 확인하면 됩니다. 화면 크기에 따라 목록과 세부 정보의 위치가 달라질 수 있으므로 고정된 좌표를 따라 하지 말고 Home, Global Routing, Config 등의 화면 이름을 기준으로 찾으세요. 상태 막대에 VPN 문구가 정해진 위치에 보이지 않는다는 이유만으로 실패라고 판단하지 마세요.
이 단계에서는 추가 자동 연결 동작을 켜거나 On Demand를 함께 조정하지 마세요. 먼저 수동 연결과 연결 해제가 예상대로 작동하는지 확인한 다음 자동화 설정을 검토하세요. Home에서 연결 스위치를 껐다면 앱 상태가 바뀌었는지도 확인합니다. 특히 On Demand를 설정했던 기기에서는 자동 재연결을 수동 스위치의 오작동으로 착각하지 않도록 주의하세요.
[Checkpoint]스위치가 켜진 상태로 유지된다는 것은 로컬 연결 상태가 다음 단계로 넘어갔다는 뜻일 뿐입니다. 서버의 사용 가능 여부와 대상에 예상한 정책이 적용되는지는 다음 단계의 테스트와 실제 접속으로 확인해야 합니다.
[Connectivity Test] 04단계 · 실제 결과 확인
먼저 테스트한 뒤 실제 접속 확인
로컬 스위치, 서버 테스트, 실제 접속을 각각 확인하세요. 어느 한 가지 결과만으로 전체 설정이 올바르다고 볼 수는 없습니다.
Home에서 Connectivity Test를 실행해 기존 서버 기록을 테스트하고 사용할 서버의 결과를 확인하세요. 테스트 결과는 현재 네트워크에서의 연결 가능성과 응답 상태를 살펴보는 용도입니다. 서비스 품질을 보장하거나 로그인, 웹 페이지 로딩 등 실제 사용을 대신하지는 않습니다. 한 번의 테스트 수치만으로 서버를 고르고 자주 바꾸지 마세요.
이어서 브라우저나 사용할 앱을 열고 본인이 이용할 권한이 있는 서비스에 접속하세요. 결과를 구분하기 쉬운 페이지를 선택해 이전에 캐시된 제목만 표시되는 것이 아니라 실제 콘텐츠가 로드되는지 확인합니다. 대상 서비스에 로그인이 필요하다면 계정 권한 문제와 네트워크 연결 문제를 구분하세요. 로그인이 거부되었다고 해서 프록시 연결에 반드시 실패한 것은 아닙니다.
구성(Config)을 사용한다면 현재 구성에서 대상에 예상한 정책이 적용되는지 확인하세요. 더 자세히 확인하려면 앱에서 확인할 수 있는 연결 기록을 참고해 대상과 처리 정책이 일치하는지 살펴봅니다. 로그 표시는 현재 화면을 기준으로 확인하며 특정 색상이나 아이콘을 찾을 필요는 없습니다. 대상에 DIRECT가 적용되었다면 페이지가 정상적으로 열려도 해당 접속이 선택한 프록시 서버를 거쳤다는 뜻은 아닙니다.
Proxy에서는 접속되지만 Config에서는 안 된다면 구독을 다시 가져오기 전에 Config에서 활성화된 파일과 규칙을 확인하세요. Connectivity Test에 결과가 나오지만 실제 접속에 실패한다면 대상 서비스의 상태, 프로토콜에 필요한 항목, DNS 등을 확인합니다. 테스트 요청과 실제 접속 대상 및 과정이 다를 수 있으므로 두 결과가 서로 모순되는 것은 아닙니다.
확인이 끝나면 간단히 기록하세요. 사용한 기본 네트워크, 선택한 서버, Global Routing 모드, Connectivity Test 결과, 실제 접속 증상을 적으면 됩니다. 본인이 알아볼 수 있는 이름만 적고 비밀번호나 전체 구독 링크는 기록하지 마세요. 그런 다음 직접 연결을 끊고 기본 네트워크가 예상대로 복구되었는지 확인하면 전후 결과를 명확하게 비교할 수 있습니다.
선택한 서버, 라우팅 모드와 실제 접속 결과가 서로 일치할 때 첫 연결 확인이 완료됩니다. 이후 구독, 서버 또는 구성 파일을 바꿀 때도 모든 설정을 다시 변경하지 않고 같은 절차로 확인할 수 있습니다.
[Diagnostics] 05단계 · 단계별로 원인 좁히기
흔한 문제와 확인 순서
먼저 어느 단계에서 문제가 생겼는지 확인한 다음 해당 설정을 변경하세요. 한 번에 한 가지 요소만 바꾸고 매번 같은 대상에 다시 접속해 결과를 비교합니다. 비교할 수 있도록 결과를 기록해 두세요.
구독 저장 후 목록이 비어 있거나 파싱에 실패하는 경우
구독 편집 화면으로 돌아가 URL이 서비스 제공업체 웹사이트의 로그인 페이지나 안내 페이지, 또는 단일 공유 링크가 아닌지 확인하세요. 복사 과정에서 쿼리 매개변수가 빠지지 않았는지, 주소가 교체되거나 만료되지 않았는지도 살펴봅니다. 앱에 응답 내용과 관련된 안내가 표시되면 해당 문구를 보관하고 본인이 보유한 구독 상태를 확인하세요. 주소에 접근 권한을 나타내는 token이 포함될 수 있으므로 공개된 곳에 붙여 넣어 다른 사람에게 테스트를 요청하지 마세요.
업데이트에 실패해도 기존 그룹을 바로 삭제할 필요는 없습니다. 먼저 기존 기록이 남아 있는지 확인한 뒤 업데이트 요청이 실패했는지, 업데이트 후 내용이 실제로 달라졌는지 살펴보세요. 백업 없이 반복해서 삭제하고 다시 추가하면 원래 정보와 변경 기록을 모두 잃을 수 있습니다.
서버는 표시되지만 테스트에 실패하는 경우
먼저 연결을 끄고 Wi-Fi 또는 셀룰러 네트워크 자체에서 일반적인 접속이 가능한지 확인하세요. 웹 로그인이 필요한 네트워크라면 먼저 네트워크 접속을 완료해야 합니다. 그런 다음 Add Server로 돌아가 원본 자료와 프로토콜, 주소, 포트 및 인증 항목을 대조하세요. 직접 입력할 때는 뒤에 붙은 공백, 대소문자, 헷갈리기 쉬운 문자를 특히 주의하고 메모 이름만 비교하지 마세요.
프로토콜에 TLS 또는 SNI가 필요하다면 기존 자료를 기준으로 관련 설정을 확인하세요. 서버 주소와 인증에 사용하는 이름은 역할이 다를 수 있으므로 문자열이 다르다는 이유만으로 같게 바꾸지 마세요. 인증서 검증을 꺼서 문제를 감추지 말고 설정값, 기기의 시간, 서버 상태를 먼저 확인하세요.
연결 스위치가 켜진 상태로 유지되지 않는 경우
먼저 시스템에서 VPN 구성을 허용했는지, 앱에 명확한 오류가 표시되는지 확인하세요. 서버가 실제로 선택되어 있는지 확인하고 현재 다른 네트워크 구성이 작업에 영향을 주는지도 살펴봅니다. 충돌하는 연결이 확인되면 종료한 뒤 다시 시도하세요. 용도를 모르는 기기 설정을 삭제하거나 문제 해결을 위해 앱을 다시 구매하지 마세요.
연결 후 일부 대상에만 접속할 수 없는 경우
먼저 Global Routing을 확인하세요. Direct라면 예상한 프록시 경로를 사용하지 않는 상태입니다. Config라면 대상에 다른 정책이 적용되는지 확인한 뒤 Proxy로 통제된 비교를 한 번 진행하세요. 특정 앱에서만 문제가 생기고 브라우저에서는 정상이라면 앱 계정 상태, 캐시, 대상 서비스의 사용 가능 여부를 확인하세요. 이 결과만으로 구독 전체가 작동하지 않는다고 판단하지 마세요.
DNS, 규칙 순서, 프로토콜 항목을 더 자세히 확인하려면 구독 및 서버 관리 가이드를 참고하세요. 이 안내의 진행 단계에서는 DNS, 규칙, 서버, 자동 연결 옵션을 동시에 변경하지 않는 것이 좋습니다. 그래야 접속이 복구되더라도 어떤 변경이 효과가 있었는지 파악할 수 있습니다.
결과를 정리한 뒤 다음 설정으로 진행
확인을 마친 뒤 문제를 가져오기, 라우팅, 시스템 승인, 대상 접속 중 어느 단계에 해당하는지 정리하세요. 서비스 제공업체에 확인할 때는 문제 발생 시각, 네트워크 유형, 프로토콜 유형, 민감 정보를 제거한 오류 문구만 전달합니다. 전체 구독 URL, 비밀번호, UUID, 공유 링크와 QR 코드는 삭제하고 스크린샷에 개인 정보가 포함되지 않았는지도 확인하세요.
다시 진행하려면 1단계 정보 가져오기 확인부터 시작하세요. 서버 기록이 올바르게 저장되어 있다면 Global Routing 선택 단계부터 이어서 진행하면 됩니다. 모든 설정을 반복해서 새로 만드는 것보다 각 단계의 결과를 확인하는 편이 실제 문제 지점을 찾기 쉽습니다.