공식 설명서 · 시작하기 기존 설정 가져오기 및 사용

Shadowrocket
가져오기 및 연결 방법

가져오기, 라우팅, 연결, 확인 순서로 처음 설정을 진행하세요. 먼저 서버에 접속할 수 있는지 확인한 다음 규칙이 예상대로 적용되는지 살펴보세요.

01 · Add Server: 서버 추가 또는 구독 가져오기

이 안내는 iPhone과 iPad를 기준으로 합니다. Shadowrocket을 열고 먼저 Home에서 서버 항목이 있는지 확인하세요. 목록이 비어 있다면 연결 스위치를 켜지 말고, 먼저 보유한 서버 정보를 앱에 저장해야 합니다. 구독 링크, 개별 서버 공유 링크, Config 설정 파일은 각각 용도가 다르므로 가져오기 전에 어떤 종류의 정보인지 확인하세요.

구독 링크는 일반적으로 서비스 제공자가 전달하며, 서버 목록을 가져오고 업데이트하는 데 사용합니다. 개별 서버 정보에는 해당 서버의 연결 매개변수가 포함되고, Config는 주로 규칙과 관련 설정을 구성합니다. 구독 링크를 서버 주소 항목에 입력하거나 Config 파일 주소를 Subscribe에 입력하면 가져오기에 실패할 수 있습니다. 링크만 보고 종류를 판단하기 어렵다면 여러 메뉴를 반복해서 시도하지 말고 원본 설정 안내를 확인하세요.

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

  1. Home에서 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 다음 Type을 누르고 Subscribe를 선택하세요.
  2. 보유한 전체 구독 링크를 URL 항목에 붙여 넣으세요. 구분이 필요하면 알아보기 쉬운 이름을 입력하고, 링크는 메모 항목에 넣지 마세요.
  3. 화면의 완료 버튼을 눌러 저장하고 Home으로 돌아오세요. 구독 정보를 불러올 때까지 기다린 뒤 그룹 안에 서버 항목이 표시되는지 확인하세요.
  4. 해당 그룹을 펼치고 서버 하나를 선택해 현재 항목으로 지정하세요. 구독 그룹이 보인다고 해서 연결할 서버 항목까지 선택된 것은 아닙니다.

붙여 넣은 링크의 시작과 끝, 쿼리 매개변수가 온전한지 확인하세요. 채팅 문구, 줄바꿈, 끝에 붙은 문장부호가 포함되지 않도록 주의합니다. 구독 링크에 접속 정보가 들어 있을 수 있으므로 필요한 입력란에서만 사용하고 공개 스크린샷이나 웹페이지, 문의 내용에 노출하지 마세요. 저장 후 불러오기에 실패하면 원본 링크를 보관하고 이 페이지 끝의 구독 문제 해결 순서에 따라 확인하세요. 같은 구독을 반복해서 새로 추가하면 항목을 구별하기만 더 어려워집니다.

구독 내용이 변경되었다면 Home에서 해당 구독 그룹의 메뉴를 열어 업데이트하고 안내 메시지를 확인하세요. 업데이트가 끝나면 현재 선택된 서버도 다시 확인해야 합니다. 기존 항목이 교체되거나 삭제되었을 수 있습니다. 구독 업데이트는 서버 목록을 새로 고치는 기능이며, 새 항목의 연결 가능성을 보장하거나 Config 규칙 설정을 대신하지 않습니다.

기존 서버 정보가 있는 경우: Type에 맞춰 설정 입력

서버 한 대의 매개변수만 있는 경우에도 Home의 더하기 버튼을 눌러 Add Server로 이동한 뒤 Type에서 원본 정보와 일치하는 프로토콜을 선택하고 주소, 포트, 인증 정보를 입력하세요. 예를 들어 VLESS, Trojan, WireGuard는 입력 항목이 서로 다릅니다. 주소와 포트가 같다는 이유로 한 프로토콜의 정보를 다른 Type에 입력하면 안 됩니다. 입력을 마치면 저장하고 Home으로 돌아와 해당 서버를 선택하세요.

원본 정보의 항목과 입력값을 하나씩 대조하고 대소문자, 공백, 포트 번호를 확인하세요. TLS, SNI, 전송 방식, 경로가 포함되어 있다면 해당 항목에도 입력해야 합니다. 입력란을 간단히 하려고 이런 매개변수를 생략하지 마세요. TLS 인증에 실패하면 검증 조건을 낮춰 오류를 우회하지 말고 이름과 인증서가 일치하는지 확인하세요. 항목의 의미가 불분명하면 개념 빠른 참조를 먼저 확인한 뒤 입력을 이어가세요.

보유한 서버의 QR 코드가 있다면 Scan QR Code로 스캔하고 시스템 안내에 따라 카메라 접근을 허용할 수 있습니다. 인식 후에도 Type, 주소, 포트가 원본 정보와 일치하는지 확인하세요. QR 코드는 설정 정보를 전달하는 수단일 뿐, 해당 정보의 연결이 검증되었다는 의미는 아닙니다. 어떤 방식으로든 가져오기를 마쳤다면 다음 단계에서 서버를 사용할 트래픽 처리 방식을 정하세요.

02 · Global Routing: 트래픽 처리 방식 선택

Home으로 돌아와 Global Routing을 누르고 현재 선택된 모드를 확인하세요. 이 설정은 트래픽을 처리하는 방식을 정하며 서버를 제공하는 기능은 아닙니다. 모드는 Config(구성)/Proxy(프록시)/Direct(직접 연결) 세 가지입니다. 처음 설정할 때는 서버 자체를 확인하려는지 기존 규칙을 확인하려는지 먼저 정하세요. 목적에 따라 선택할 모드가 달라집니다.

Config: 현재 설정의 규칙에 따라 처리

Config는 규칙에 따라 요청별로 프록시 또는 직접 연결을 선택하는 일반적인 사용 방식입니다. 선택하기 전에 앱의 Config 화면에서 사용할 설정 파일이 선택되어 있는지 확인하세요. 목록에 파일이 저장되어 있다고 해서 현재 사용 중인 설정이라는 뜻은 아닙니다. 선택 표시를 확인하고 파일 내용이 보유한 설정 정보와 일치하는지도 살펴보세요.

규칙은 일반적으로 작성된 순서대로 일치 여부를 확인하며, 일치한 규칙의 정책에 따라 요청을 처리합니다. 아래 예시는 “지정한 도메인은 프록시를 사용하고 나머지는 직접 연결”한다는 의미를 설명하기 위한 것입니다. 이 안내에서 전체 설정을 새로 만들라는 뜻이 아니며 서버 정보도 포함하지 않습니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

DOMAIN-SUFFIX는 도메인 접미사를 일치시키고, PROXY와 DIRECT는 처리 정책을 나타내며, FINAL은 기본 처리 규칙으로 사용됩니다. 예시 도메인 example.com은 문법 설명용입니다. 기존 Config가 정상적으로 작동한다면 처음 연결한다는 이유로 전체 설정을 덮어쓰지 마세요. 규칙과 설정에 대한 자세한 내용은 개념 빠른 참조에서 확인할 수 있습니다.

Proxy: 현재 서버의 접속 가능 여부 확인

Proxy는 규칙 일치 여부를 잠시 제외하고 프록시를 통한 접속이 가능한지 확인할 때 유용합니다. 서버를 선택한 다음 Proxy로 전환하고 같은 웹페이지에 접속해 보세요. Proxy에서는 접속되지만 Config에서는 안 된다면 서버를 모두 다시 가져오기보다 현재 설정과 규칙 정책을 먼저 확인하세요. Proxy 모드로 잘못된 인증 정보를 수정하거나 응답하지 않는 서버를 복구할 수는 없습니다.

Direct: 현재 네트워크의 직접 접속 확인

Direct는 현재 네트워크를 통해 직접 접속하는 모드로, 비교 테스트에 사용할 수 있습니다. 서버를 자동으로 선택하는 모드가 아니며 Home에서 항목을 선택했더라도 직접 연결 요청을 해당 서버로 보내지 않습니다. Direct에서 확인할 대상은 현재 네트워크에서 원래 접속할 수 있는 웹페이지여야 합니다. 이를 통해 기본 네트워크 문제와 프록시 연결 문제를 구분할 수 있습니다.

테스트를 마치면 평소 사용 목적에 맞는 모드로 되돌리세요. 트래픽을 규칙에 따라 분기하려면 Config로 돌아가 활성 설정을 확인하세요. 연결 스위치가 켜져 있다는 점만 기억하고 Global Routing이 테스트용 모드로 남아 있는 것을 잊지 않도록 주의하세요. 모드를 확인한 다음 시스템 권한 승인과 연결 단계로 진행합니다.

03 · Home: 연결 스위치 켜기 및 권한 승인

Home으로 돌아와 두 가지를 확인하세요. 현재 서버가 올바른지, Global Routing이 이번 테스트 목적에 맞는지 점검합니다. 처음 설정할 때는 현재 네트워크를 안정적으로 유지하세요. Wi-Fi와 셀룰러 데이터를 전환하면서 서버 매개변수까지 변경하면 실패 원인을 파악하기 어렵습니다.

  1. Home 화면 상단의 연결 스위치를 켜세요.
  2. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 안내를 읽고 요청을 보낸 앱이 Shadowrocket인지 확인한 다음 허용을 선택하세요.
  3. 시스템 안내에 따라 기기 암호를 입력하거나 본인 인증을 완료하고 앱으로 돌아올 때까지 기다리세요.
  4. 연결 스위치가 계속 켜져 있는지, 시스템 VPN 연결이 설정되었는지 확인하세요.

이 권한은 시스템이 해당 네트워크 트래픽을 앱에 전달하도록 허용합니다. 구독 가져오기 확인 창이나 앱을 새로 구매하는 절차가 아닙니다. 서버 항목을 저장하는 것만으로 VPN 구성 권한까지 승인되는 것은 아닙니다. 처음 연결 스위치를 켤 때 시스템 안내에 따라야 합니다. 안내를 취소했다면 연결이 계속되지 않을 수 있으므로 Home으로 돌아와 다시 시도하고 권한을 승인하세요.

스위치를 켜자마자 다시 꺼진다면 권한 승인 절차가 완료되었는지 확인한 다음 시스템 Settings의 VPN 구성 항목에서 상태를 살펴보세요. 메뉴 위치는 시스템 화면에 따라 달라질 수 있으므로 기기에 표시되는 내용을 기준으로 확인하세요. 다른 VPN 연결을 사용 중이라면 먼저 비활성화한 뒤 테스트하세요. 관리 대상 기기의 제한으로 VPN 구성이 영향을 받을 수도 있으니 기기 관리 정책을 확인하고, 네트워크 설정 전체를 반복해서 삭제하지 마세요.

VPN 상태가 연결됨으로 표시되어도 시스템 터널만 설정된 것입니다. 서버 인증, DNS 조회, 대상 웹사이트 접속까지 성공했다는 뜻은 아닙니다. 시스템 연결 표시가 나타난 뒤에도 다음 단계에서 실제 접속을 확인하세요. 이전에 On Demand를 설정했다면 문제를 점검하는 동안 어떤 조건에서 작동하는지 확인하고, 필요한 경우 잠시 끄세요. 수동으로 연결을 끊은 뒤 자동으로 다시 연결되면 비교 결과에 영향을 줄 수 있습니다.

04 · Connectivity Test: 연결 및 규칙 확인

먼저 Home으로 돌아와 Connectivity Test를 실행하고 현재 서버의 테스트 결과를 확인하세요. 응답이 있다면 해당 테스트 방식으로 서버에 연결할 수 있다는 단서가 됩니다. 응답이 없다면 네트워크와 설정을 더 점검해야 합니다. 결과는 테스트 방식과 대상에 따라 달라지므로 숫자 하나만으로 모든 웹페이지에 접속할 수 있는지 판단하지 마세요. 응답 속도를 실제 다운로드 속도로 간주하는 것도 적절하지 않습니다.

그다음 브라우저를 열어 현재 네트워크에서 접속 가능한 것으로 확인된 웹페이지를 먼저 방문해 기기 자체의 인터넷 연결을 확인하세요. 이후 확인하려는 웹사이트에 접속합니다. 브라우저에 캐시된 페이지를 새 연결 성공으로 오인하지 않도록 새 페이지 요청을 사용하고 다시 불러오세요. 특정 웹사이트 하나에서만 문제가 발생하면 클라이언트 전체의 문제라고 단정하지 말고 해당 사이트 자체가 정상인지 먼저 확인하세요.

  1. 기본 네트워크 확인: 앱 연결을 끈 상태에서 접속 가능한 것으로 확인된 웹페이지가 정상적으로 열리는지 확인하세요.
  2. 서버 확인: 연결을 다시 켜고 Proxy 모드에서 같은 대상에 요청을 보내 현재 서버로 접속할 수 있는지 확인하세요.
  3. 규칙 확인: Config로 돌아와 같은 대상에 다시 접속하고 결과가 달라지는지 비교하세요.
  4. 처리 기록 확인: Data에서 현재 화면에 제공되는 연결 기록을 살펴보세요. 대상과 정책이 표시된다면 예상한 대로 처리되었는지 확인하세요.

기록을 살펴볼 때는 테스트한 시점과 기록 시간을 맞춰 확인하세요. 웹페이지는 여러 도메인에 동시에 요청을 보낼 수 있습니다. 기본 도메인이 규칙과 일치해도 이미지, API, 로그인 요청에 같은 정책이 적용된다는 뜻은 아닙니다. 페이지는 열리지만 일부 콘텐츠가 누락되었다면 기본 도메인 규칙만 확장하기보다 실패한 요청의 도메인과 적용된 정책을 먼저 확인하세요. Data의 트래픽 변화는 데이터가 오갔다는 점만 보여 줄 뿐, 특정 웹사이트에 필요한 규칙이 적용되었다는 것을 단독으로 증명하지는 않습니다.

한 번에 하나의 변수만 바꾸세요. 먼저 네트워크, 서버, 대상 웹사이트를 그대로 유지하고 Global Routing만 변경해야 “서버에 연결할 수 없는 문제”와 “규칙이 일치하지 않는 문제”를 구분할 수 있습니다. 확인을 마친 뒤 평소 사용할 모드로 되돌리고, 사용 가능한 서버와 활성 Config, 테스트 결과를 기록해 두세요. 이후 변화가 생겼을 때 비교 기준으로 활용할 수 있습니다.

05 · 자주 발생하는 문제: 작업 순서에 따라 점검

실패했다면 먼저 어느 단계에서 멈췄는지 확인하세요. 구독 목록을 불러오지 못했는지, 연결 스위치가 켜진 상태를 유지하지 못하는지, Connectivity Test에 응답이 없는지, 특정 웹페이지에만 접속할 수 없는지 구분합니다. 증상마다 확인할 부분이 다릅니다. 원인을 찾기 전에 목록을 모두 지우거나 Config를 교체하고 DNS까지 바꾸지 말고, 기존 설정과 원본 정보를 보관한 뒤 다음 순서로 점검하세요.

Subscribe를 저장했지만 서버가 표시되지 않음

URL이 서버 구독용 전체 링크인지 확인하세요. 서비스 안내 페이지나 계정 페이지 주소가 아닌지 살펴봅니다. 불필요한 공백이나 문장부호가 추가되었거나 쿼리 매개변수가 빠지지 않았는지 확인한 다음 업데이트 오류 메시지를 살펴보세요. 현재 네트워크에서 구독 주소에 접속할 수 없거나 서버가 오류를 반환하는 경우, 접속 정보가 만료된 경우, 예상한 형식의 내용이 반환되지 않은 경우에도 목록이 비어 있을 수 있습니다.

“구독 업데이트 성공”과 “서버 연결 가능”은 별도로 확인해야 합니다. 링크를 불러오지 못했다면 기존 서비스 제공자에게 링크 상태와 응답 형식을 문의하세요. 서버 항목이 표시되면 서버 연결 테스트를 진행합니다. 문제를 문의할 때는 오류 유형만 전달하고 구독 링크에 포함된 접속 정보는 공개하지 마세요. 구독 오류 유형을 자세히 알아보려면 FAQ를 확인하세요.

서버는 표시되지만 Connectivity Test에 실패함

먼저 연결을 끄고 현재 네트워크가 정상인지 확인한 뒤 서버 주소, 포트, Type, 인증 정보를 점검하세요. 직접 입력한 항목이라면 TLS, SNI, 전송 매개변수도 대조합니다. 구독에서 가져온 항목이라면 한 번 업데이트하고 현재 선택한 항목이 목록에 남아 있는지 확인하세요. 보유하고 있고 연결 가능 여부를 알고 있는 다른 서버가 있다면 같은 네트워크와 테스트 방식으로 비교할 수 있습니다.

서버 접속 가능 여부는 네트워크마다 다를 수 있습니다. Wi-Fi에서는 실패하고 셀룰러 데이터에서는 성공한다면 결과를 각각 기록하세요. 네트워크를 전환한 뒤에는 다시 연결하고 테스트합니다. 한 번의 시간 초과만으로 전체 설정이 잘못되었다고 판단하지 말고, 근거 없이 암호화나 인증 항목을 변경하지 마세요.

연결 스위치는 켜져 있지만 웹페이지에 접속할 수 없음

먼저 Global Routing을 확인하세요. Direct 모드에서는 서버를 선택했더라도 요청이 자동으로 프록시를 거치지 않습니다. Config 모드에서는 활성 설정과 대상에 적용되는 정책을 확인해야 합니다. 같은 대상에 Proxy 모드로 접속해 보세요. Proxy에서는 접속되지만 Config에서는 안 된다면 규칙 순서, 정책 대상, 기본 처리 규칙을 먼저 살펴보세요. 두 모드 모두 실패하면 서버와 DNS를 점검합니다.

도메인 조회 문제도 웹페이지가 열리지 않는 원인이 될 수 있습니다. 먼저 현재 DNS 설정을 유지하고 오류를 기록한 뒤 서버 정보가 올바른지 확인하고 한 번에 하나씩 조정하세요. 도메인 하나를 점검하려고 여러 DNS 옵션을 동시에 변경하지 마세요. 설정 파일이나 App Store에서 앱을 받고 사용하는 범위에 대해 궁금한 점이 있다면 개념 빠른 참조와 App Store 안내를 각각 확인하세요. 이 페이지에서는 첫 연결에 필요한 절차만 다룹니다.

일부 웹페이지나 앱에서만 문제가 발생함

이 경우에는 문제가 발생하는 요청을 구체적으로 좁혀 확인하세요. 브라우저에서 같은 대상에 접속한 뒤 Proxy와 Config의 결과를 비교합니다. Data에서 확인할 수 있는 대상과 정책 정보를 살펴보고 문제가 발생한 콘텐츠가 다른 도메인과 관련되어 있는지 확인하세요. 웹페이지의 로그인, 이미지, 동영상은 서로 다른 주소를 사용할 수 있으므로 “홈페이지가 열린다”는 것만으로 모든 기능이 정상이라고 볼 수 없습니다.

마지막으로 테스트 중 변경한 Global Routing, On Demand, Config 선택을 원래대로 되돌리세요. 추가 지원이 필요하다면 기기의 네트워크 환경, 실패 단계, 선택한 모드, 오류 안내, 비교 테스트 결과를 정리하되 구독 접속 정보, 비밀번호, 개인정보는 가리세요. 연결 스위치 스크린샷 한 장보다 재현 가능한 작업 순서가 문제를 파악하는 데 더 도움이 됩니다.