공식 매뉴얼 · 빠른 시작

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

iPhone / iPad 화면을 기준으로 기존 구독 또는 서버 정보에서 시작합니다. 가져오기, Global Routing 선택, 연결 활성화, 실제 접속 확인을 차례로 진행하고, 문제가 발생하면 해당 단계부터 점검합니다.

  • Home → Add Server
  • Config / Proxy / Direct
  • Connectivity Test → 실제 접속

1단계: Add Server에서 서버 추가 및 구독 가져오기

먼저 보유한 자료가 구독 링크 전체인지, 단일 서버의 공유 정보인지, 아니면 주소·포트·인증 매개변수로 구성된 서버 정보인지 확인합니다. 세 가지 자료는 가져오는 방식이 서로 다릅니다. 구독 링크를 서버 주소 입력란에 넣지 말고, 서버 이름만으로 프로토콜을 판단하지 마세요. Shadowrocket을 열고 Home으로 이동해 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 다음 아래 두 가지 방법 중 하나를 선택합니다.

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

Add Server에서 Type을 열고 Subscribe를 선택한 다음 본인의 전체 구독 링크를 URL에 입력합니다. 메모 항목에는 알아보기 쉬운 이름을 적고 저장합니다. 링크를 복사할 때는 쿼리 매개변수가 빠짐없이 포함되어야 합니다. 채팅 기록이나 메모에서 복사했다면 앞뒤 공백, 줄바꿈, 잘못 포함된 문장 부호가 없는지 특히 확인하세요. 구독 링크에는 접근 자격 증명이 포함될 수 있으므로 공개 페이지에 붙여 넣거나 전체 내용을 다른 사람에게 보여주지 마세요.

저장한 뒤 Home으로 돌아와 구독에서 서버 목록을 가져왔는지 확인합니다. 구독 이름만 표시되고 서버가 없다면 먼저 오류 안내를 확인한 뒤 해당 구독의 작업 메뉴에서 업데이트를 실행합니다. 구독 주소는 현재 네트워크를 통해 접근할 수 있어야 합니다. 클라이언트가 아직 연결되지 않은 상태에서 구독 주소에 접근할 수 없다면 첫 업데이트가 실패할 수도 있습니다. 이는 “서버를 가져왔지만 연결에 실패한” 경우와는 다른 단계이므로 각각 확인하고 동일한 구독을 연속해서 다시 추가하지 마세요.

서버 항목이 나타나면 그중 하나를 선택해 첫 확인에 사용합니다. 그룹이 여러 개라면 이후 테스트에서 동일한 구독과 서버 이름을 유지할 수 있도록 선택한 항목을 기억해 두세요. 구독을 업데이트하면 원격 콘텐츠를 다시 읽어 서버 개수나 매개변수가 달라질 수 있습니다. 따라서 첫 확인 중에는 반복해서 업데이트할 필요가 없으며, 여러 서버 항목을 동시에 수동으로 수정하지 마세요.

단일 서버 정보가 있는 경우: 실제 프로토콜에 맞춰 입력

Home에서 더하기 버튼을 눌러 Add Server로 이동한 다음 Type에서 보유한 정보와 일치하는 프로토콜을 선택합니다. 예를 들면 Shadowsocks, VMess, VLESS, Trojan 또는 WireGuard가 있습니다. 이어서 주소, 포트, 해당 프로토콜에 필요한 인증 및 전송 매개변수를 각각 입력합니다. 프로토콜마다 필수 항목이 다르며 비밀번호, UUID, 키, TLS, 전송 설정은 서로 대체할 수 없습니다. 경험에 따라 정보를 추측해 입력하지 말고 보유한 전체 매개변수를 기준으로 입력하세요.

입력을 마치고 저장한 다음 Home으로 돌아가 새 항목이 표시되는지 확인합니다. QR 코드를 사용하는 경우 Scan QR Code로 본인이 보유한 공유 정보를 읽을 수 있지만, 인식 후에도 프로토콜과 필수 항목을 확인해야 합니다. 어떤 가져오기 방식이든 정보가 클라이언트에 입력되었다는 뜻일 뿐, 서버가 현재 사용 가능하다는 뜻은 아닙니다. 이 단계의 완료 기준은 “목록에 올바른 항목이 있고 선택할 수 있음”입니다. 다음 단계에서 해당 항목을 트래픽 처리에 어떻게 사용할지 결정합니다.

2단계: Global Routing 모드 선택

Home에서 Global Routing을 누르고 현재 선택 항목을 확인한 뒤 전환 여부를 결정합니다. 세 가지 모드는 Config / Proxy / Direct입니다. 각 모드는 연결 처리 방식을 결정하며, 별도의 서버 목록이나 새 구독을 기기에 만들지는 않습니다. 처음 사용하는 경우 먼저 서버가 작동하는지 확인한 다음 세부 규칙 분배를 설정하세요. 그래야 서버 문제와 설정 문제를 혼동하지 않습니다.

Proxy: 선택한 서버부터 확인

Proxy는 첫 연결을 확인할 때 비교 기준으로 적합합니다. 클라이언트가 처리하는 연결에 현재 프록시 선택이 적용되므로, 방금 가져온 서버로 실제 요청을 처리할 수 있는지 확인하기 편리합니다. Proxy를 선택한 뒤 Home으로 돌아와 테스트할 서버가 선택되어 있는지 확인합니다. 이때 DNS, 전송 매개변수 또는 설정 규칙을 동시에 변경하지 마세요. 조건을 단순하게 유지해야 테스트 결과를 해석하기 쉽습니다.

Config: 현재 설정의 규칙 사용

Config는 현재 활성화된 설정 규칙에 따라 연결을 처리합니다. Config를 열어 사용할 설정이 선택되어 있는지 확인한 뒤 Home으로 돌아와 Config를 선택합니다. 규칙은 대상별로 PROXY, DIRECT 또는 기타 정의된 정책을 적용할 수 있습니다. 따라서 “연결됨”으로 표시되어도 모든 요청이 같은 서버를 거친다는 뜻은 아닙니다. 구독 가져오기는 서버 목록을 설정하고, Config는 규칙과 정책을 설정하므로 두 기능을 혼동하지 마세요.

예를 들어 다음 규칙은 해당 도메인과 일치하면 PROXY 정책을 적용합니다. 문법을 이해하기 위한 예시이며, 처음 설정할 때 이 내용을 반드시 설정에 추가할 필요는 없습니다. 한 줄만 복사해도 전체 설정을 대신할 수 없습니다.

DOMAIN-SUFFIX,example.com,PROXY

Direct: 프록시를 거치지 않는 연결과 비교

Direct는 연결이 프록시 서버를 거치지 않는다는 뜻입니다. 기본 네트워크가 작동하는지 확인하거나 Proxy에서 보낸 동일한 요청과 비교할 때 사용할 수 있습니다. 유효하지 않은 구독을 복구하거나 서버가 정상임을 증명하지는 않습니다. 앱에서 Direct를 선택하는 것과 연결 스위치를 완전히 끄는 것은 다른 동작입니다. 전자는 클라이언트의 처리 모드 중 하나이고, 후자는 현재 연결을 중지합니다. 테스트에 사용할 모드를 정한 뒤 다음 단계에서 연결을 켭니다.

3단계: 스위치를 켜고 연결 권한 확인

Home으로 돌아가 서버 항목이 선택되어 있는지 확인하고, Global Routing이 방금 선택한 모드인지 확인한 다음 상단의 연결 스위치를 켭니다. 순서가 중요합니다. 서버와 모드를 확인하지 않고 바로 연결하면 이후 접속에 성공하더라도 실제로 어떤 항목이나 처리 방식을 사용했는지 판단하기 어려울 수 있습니다.

처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시됩니다. 안내를 읽고 본인이 방금 시작한 Shadowrocket 작업인지 확인한 뒤 시스템 요청에 따라 허용하고, 기기 암호 또는 생체 인식으로 확인합니다. 이 VPN 구성은 시스템에서 제공하는 네트워크 연결 권한이며 별도의 구독이 아닙니다. 이 단계를 취소하면 앱으로 돌아온 뒤에도 연결되지 않을 수 있으므로 스위치를 다시 켜고 시스템 확인을 완료해야 합니다.

권한을 확인한 뒤 Shadowrocket으로 돌아가 스위치와 연결 상태가 유지되는지 확인합니다. 일부 기기에서는 상태 표시줄이나 제어 센터에 VPN 표시가 나타나지만, 이 표시는 시스템 연결 상태만 알려줄 뿐 대상 페이지에 예상한 경로로 접속되었는지 단독으로 증명하지 않습니다. 스위치가 바로 꺼지면 먼저 앱에 표시된 오류와 시스템 권한을 확인하고 규칙은 나중에 변경하세요. 기기에서 다른 VPN 연결을 사용 중이면 테스트 대상을 명확히 할 수 있도록 필요하지 않은 연결을 먼저 중지합니다.

이번 수동 확인 중에는 On Demand를 설정하지 않아도 됩니다. On Demand는 조건에 따라 연결을 실행하는 기능으로, 현재 수동 스위치와는 다릅니다. 먼저 “수동으로 켠 연결이 유지되고 대상에 접속할 수 있음”이라는 기본 절차를 완료한 뒤 필요에 따라 조건부 연결을 살펴보세요. 여기까지는 연결 동작만 마친 상태이므로, 다음 단계에서 테스트와 실제 요청으로 결과를 확인해야 합니다.

4단계: Connectivity Test 및 실제 접속 확인

먼저 Connectivity Test로 목록에 있는 서버의 연결을 확인하고 테스트 방식을 살펴봅니다. 테스트에 표시되는 시간은 해당 테스트 대상과 당시 네트워크 조건만 반영합니다. 웹페이지 다운로드 속도와 같지 않으며 모든 앱의 요청이 성공한다고 보장하지도 않습니다. 항목에서 결과를 얻었다면 다음 확인을 진행할 수 있지만, 시간 초과가 발생했다면 추가 점검이 필요하다는 의미일 뿐 한 번의 결과만으로 잘못된 매개변수를 단정할 수는 없습니다.

이어서 브라우저를 열고 평소 사용할 권한이 있으며 정상적으로 표시되는 모습을 알고 있는 페이지에 접속해 새 요청을 보냅니다. 캐시 때문에 네트워크에 문제가 있어도 이미 로드된 페이지가 표시될 수 있으므로 기존 페이지에만 의존하지 마세요. 필요하면 페이지를 새로 고치거나 대상 앱에 다시 진입해 텍스트, 이미지, 이후 콘텐츠가 계속 로드되는지 확인합니다. 동일한 서버, 동일한 모드, 동일한 네트워크를 유지하며 먼저 한 차례 안정적으로 확인합니다.

그런 다음 Shadowrocket으로 돌아와 Data에서 테스트 중 트래픽 변화가 있었는지 확인합니다. 트래픽 변화는 연결 활동이 있었음을 보여주지만 백그라운드 동기화도 데이터를 발생시킬 수 있으므로 보조 근거일 뿐 실제 접속 결과를 대신하지 않습니다. 마찬가지로 Config에서 트래픽이 보여도 특정 도메인이 PROXY 규칙에 일치했다고 단정할 수 없습니다. 현재 규칙과 앱에서 확인할 수 있는 연결 기록을 함께 살펴보세요.

결과가 명확하지 않으면 한 가지 조건만 바꿔 비교합니다. 현재 서버와 모드를 기록하고 먼저 Proxy로 동일한 대상을 테스트한 다음 Direct로 전환해 요청을 다시 보냅니다. 나머지 설정은 그대로 유지합니다. Proxy에서는 성공하지만 Config에서 실패하면 설정 선택과 규칙을 우선 확인합니다. 평소 정상적으로 접속되던 페이지가 Direct에서도 열리지 않으면 먼저 Wi-Fi 또는 셀룰러 네트워크 자체를 확인합니다. 네트워크를 전환하면 조건이 달라지므로 전환 후 테스트를 다시 진행하고 각 결과를 섞어 판단하지 마세요.

확인에 성공한 뒤 일상적으로 사용할 모드를 선택합니다. 유효한 규칙 설정이 있으면 Config를 사용하고, 현재 프록시를 일괄 적용해야 할 때는 Proxy를 선택합니다. 첫 사용 절차의 완료 기준은 아이콘 색상이 바뀌는 것이 아닙니다. 서버 선택이 명확하고 모드가 예상과 일치하며 연결이 유지되고 대상 앱에서 실제 요청을 완료할 수 있어야 합니다.

5단계: 실패한 단계부터 확인하고 여러 항목을 동시에 바꾸지 않기

문제가 발생하면 먼저 “어느 단계에서 막혔는지” 확인한 뒤 점검 대상을 정합니다. 기존에 작동하던 정보는 그대로 두고 조건을 한 번에 하나씩 변경해 다시 테스트합니다. 구독 삭제, 서버 재생성, 모드 전환, DNS 변경을 연이어 수행하면 전후 결과를 비교하기 어렵습니다. 같은 내용을 반복해서 가져오면 이름이 비슷한 항목이 남아 잘못된 서버를 선택할 가능성도 커집니다.

가져오기에 실패했거나 서버 목록이 비어 있음

먼저 링크가 완전한지, 아직 유효한지, 기본 네트워크에서 구독 주소에 접근할 수 있는지 확인합니다. 웹 주소, 구독 주소, 단일 서버 공유 정보는 서로 다른 유형의 데이터이므로 Add Server에서 Type이 Subscribe로 설정되어 있는지 확인하세요. 인증, 만료 또는 콘텐츠 형식 안내가 표시되면 기존 서비스 제공자에게 원본 정보를 확인합니다. 링크 매개변수를 계속 바꾸며 시도하지 마세요. 자세한 내용은 FAQ의 구독 및 서버 가져오기 항목을 참고하세요.

항목은 표시되지만 연결 테스트 또는 실제 요청이 실패함

수동으로 추가한 서버는 프로토콜, 주소, 포트, 인증 매개변수를 각각 확인합니다. TLS 또는 기타 전송 옵션이 있다면 원본 정보와 하나씩 대조합니다. 구독에서 생성된 항목은 임시 수동 변경을 장기적인 해결책으로 간주하지 말고 구독 업데이트 결과부터 확인합니다. 목록의 다른 기존 항목으로 같은 테스트를 진행할 수 있지만 서버만 한 번에 하나씩 바꾸고 모드와 대상은 그대로 유지하세요.

연결 스위치가 유지되지 않음

시스템 설정으로 돌아가 VPN 구성이 허용되었는지, 아직 처리하지 않은 권한 안내가 있는지 확인합니다. 관리되는 기기에서는 VPN 구성이 제한될 수 있습니다. 관리 관련 안내가 명확하게 표시되면 기기 관리자에게 문의하세요. 권한 문제를 규칙 문제로 혼동하지 마세요. 스위치가 유지되지 않는 단계에서는 DOMAIN-SUFFIX 또는 기타 규칙을 변경해도 연결 권한 자체가 해결되지 않습니다.

Proxy에서는 되지만 Config에서 일부 대상에 접속할 수 없음

먼저 Config에서 현재 활성화된 설정을 확인한 다음 해당 대상이 예상한 정책으로 분류되는지 살펴봅니다. 규칙 순서, DIRECT와 PROXY 선택, 최종 기본 규칙이 모두 결과에 영향을 줍니다. 일부 도메인만 문제가 있다면 DNS 및 연결 기록도 함께 확인하되, 처음 사용할 때 설정 전체와 DNS 설정을 동시에 교체하지 않는 것이 좋습니다. 규칙, DNS 및 Settings에 대한 체계적인 설명은 전체 매뉴얼을 참고하세요.

테스트가 간혹 성공하지만 네트워크를 바꾸면 다시 실패함

먼저 같은 네트워크에서 실제 요청을 반복해 재현 가능한 조건이 있는지 확인하고 Wi-Fi와 셀룰러 네트워크의 결과를 각각 기록합니다. 테스트 수치가 낮다고 지속적인 전송이 반드시 불안정한 것은 아니며, 페이지 하나가 실패했다고 모든 연결이 중단된 것도 아닙니다. 추가 지원을 요청할 때는 진행 단계, 모드, 프로토콜 유형, 민감한 정보를 가린 오류 안내를 제공하면 됩니다. 전체 구독 링크, 비밀번호 또는 키는 보내지 마세요.

일상적인 사용에서는 가장 짧은 점검 순서를 기억하세요. 기본 네트워크, 서버 선택, Global Routing, 설정과 대상 요청 순으로 확인합니다. 구독을 업데이트하거나 설정을 조정한 뒤에는 4단계에 따라 다시 확인합니다. 여러 구독을 관리하거나 복잡한 진단을 수행하는 작업은 기본 절차가 안정된 뒤 진행해 첫 연결에 변수를 너무 많이 추가하지 않도록 합니다.