공식 매뉴얼 · 처음 사용하기

Shadowrocket 사용법

연결 정보가 준비되면 가져오기, 모드 선택, 연결, 확인 순서로 진행합니다. 먼저 연결 하나가 정상 작동하도록 설정한 뒤 규칙과 On Demand를 조정하세요.

시작 전: 앱과 연결 정보를 준비하세요

이 안내는 App Store에서 Shadowrocket을 설치한 iPhone / iPad 사용자를 대상으로 하며, 본인의 구독 링크나 서버 정보가 이미 준비되어 있어야 합니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 연결 정보는 이용 중인 서비스 제공업체에서 확인하세요.

앱은 한 번 구매하면 이용할 수 있지만, 연결 서비스 요금제와는 별개입니다. 앱을 구매해도 사용할 수 있는 서버가 자동으로 생기지는 않습니다. 시스템 요구 사항은 App Store 페이지를 확인하세요. 아직 구매 또는 정품 여부를 확인하지 않았다면 앱 받기 안내를 먼저 확인하세요.

아래 이미지는 App Store 공식 스크린샷으로, 화면 구성을 확인하는 데 사용됩니다. 실제 옵션과 배열은 현재 앱을 기준으로 확인하세요. 스크린샷의 예시를 본인의 연결 정보로 사용하지 마세요.

STEP 01 · Add Server / Subscribe

서버 추가 또는 구독 가져오기

먼저 정보의 종류를 확인한 다음 가져오기 항목을 선택하세요. 구독 주소, 단일 서버 공유 정보, Config 파일은 서로 다른 유형입니다.

Shadowrocket을 연 뒤 먼저 Home으로 돌아갑니다. 아래의 SERVER 영역에서 서버 기록을 확인할 수 있습니다. 처음 사용하는 경우 상단 연결 스위치를 바로 켜지 말고 먼저 Add Server에서 정보를 추가하세요. 가져오기 전에 가진 정보가 서버 목록을 갱신하는 구독 링크인지, 단일 서버 공유 정보인지, 규칙 설정이 포함된 Config 파일인지 확인합니다. 정보가 링크처럼 보여도 가져오기 항목을 잘못 선택하면 해석되지 않을 수 있습니다.

기존 구독 링크가 있다면: Subscribe 사용

이용 중인 서비스 제공업체에서 구독 링크 전체를 복사한 뒤 Add Server를 엽니다. Type에서 Subscribe에 해당하는 구독 유형을 선택하고, 화면 안내에 따라 주소와 알아보기 쉬운 이름을 입력한 다음 저장합니다. 구독 관리 항목의 위치는 화면 구성에 따라 다를 수 있으므로 현재 앱을 기준으로 확인하세요. 복사할 때 원래 매개변수를 유지하고 따옴표, 공백, 줄바꿈을 추가하지 마세요. 계정 관리 웹페이지 주소를 구독 주소로 착각하지 않도록 주의하세요.

저장한 뒤 구독 내용을 읽어올 때까지 기다린 다음 Home으로 돌아가 SERVER에 가져온 서버가 나타나는지 확인합니다. 구독 이름만 보이고 선택할 서버가 없다면 먼저 업데이트가 성공했는지 확인하세요. 같은 주소를 반복해서 추가하지 마세요. 구독 업데이트는 해당 구독의 기록을 갱신할 뿐, 모든 서버에 연결할 수 있다는 뜻은 아닙니다. 다음 단계에서 유효한 기록을 선택해 테스트해야 합니다.

단일 서버 정보가 있다면: Type에 맞춰 입력

Add Server에서 먼저 정보와 일치하는 Type을 선택한 뒤 Host와 Port를 입력합니다. 인증 항목과 전송 옵션은 프로토콜에 따라 달라집니다. 스크린샷에 보이는 Password와 Method는 해당 유형에 쓰이는 항목이며, 모든 프로토콜에서 공통으로 입력하는 양식이 아닙니다. 이름이 비슷하다는 이유로 프로토콜을 바꾸거나 서비스 제공업체가 안내한 암호화, TLS, 전송 설정을 임의로 변경하지 마세요.

QR 코드가 있다면 출처를 확인한 뒤 Scan QR Code를 사용할 수 있습니다. 카메라 권한이 필요하면 시스템 안내에 따르세요. Import from Cloud JSON은 특정 형식의 가져오기 항목이므로 일반 구독 주소를 임의로 입력하면 안 됩니다. 어떤 방법을 사용하든 저장한 뒤 기록을 열어 항목을 확인하세요. 특히 포트, 인증 정보, 프로토콜 유형을 점검합니다.

저장 후 확인할 사항

Home으로 돌아가 사용할 서버를 선택하고 현재 선택된 항목으로 표시되는지 확인합니다. 이름은 구분을 위한 것이지 연결 품질을 증명하지 않습니다. 첫 테스트에서는 대상을 하나로 정해 여러 기록을 번갈아 선택하다가 테스트 대상을 혼동하지 않도록 하세요. 구독 링크에는 계정 정보가 포함되는 경우가 많으므로 전체 주소나 가져오기 QR 코드를 공개적으로 공유하지 마세요. 용어의 차이는 용어 매뉴얼에서 확인할 수 있습니다.

완료 기준: 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로 이동해 현재 사용 중인 구성을 확인합니다. 목록에 파일이 보인다고 해서 현재 구성으로 선택된 것은 아닙니다. 앱에 표시된 선택 또는 사용 상태를 확인하세요. 서버 구독은 연결 정보를 제공하고 Config에는 규칙과 관련 설정이 포함될 수 있으므로 각각 따로 점검해야 합니다.

공식 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption을 포함한 Config 파일 편집 화면이 표시됩니다. 첫 연결을 위해 각 항목을 일일이 수정할 필요는 없습니다. 일반적인 연결 확인을 위해 HTTPS Decryption을 켜거나 인증서를 설치할 필요도 없습니다. 먼저 확인된 구성을 유지한 뒤 Rule에서 대상 요청과 관련된 항목을 살펴보세요.

규칙은 대개 순서대로 일치 여부를 확인하고, 규칙과 일치하면 해당 정책을 적용합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 접미사와 일치하는 요청에 PROXY 정책을 사용한다는 뜻입니다. 이는 문법 예시일 뿐, 사용할 수 있는 연결 경로나 기존 파일에 그대로 추가하라는 완성된 구성은 아닙니다. Add Rule을 사용하기 전에 대상, 순서, 정책 참조를 확인하세요. 용어 설명은 규칙 키워드 용어에서 볼 수 있습니다.

Proxy(프록시): 프록시 경로 비교에 사용

서버를 선택했지만 규칙이 결과에 영향을 주는지 확실하지 않다면 Proxy로 잠시 전환해 비교할 수 있습니다. 이 모드에서는 요청을 프록시 처리 경로로 보내지만, 네트워크의 모든 트래픽이 같은 결과를 얻는다는 뜻은 아닙니다. 같은 대상이 Proxy에서는 작동하고 Config에서는 실패한다면 서버를 바로 삭제하기보다 규칙 일치 여부, 정책 선택, 관련 설정을 먼저 확인하세요.

Direct(직접 연결): 직접 접속 경로 확인

Direct는 직접 연결로 처리하는 경우에 사용하며 프록시 서버의 작동 여부를 확인하지 않습니다. Direct로 기본 네트워크 연결을 비교한 뒤에는 실제로 필요한 모드로 되돌리세요. 준비된 규칙 파일이 없다면 먼저 Proxy로 기존 서버를 확인하고 Config는 별도로 정리할 수 있습니다. Config를 선택하면 모든 상황에 적합한 규칙이 자동으로 설정된다고 생각하지 마세요.

완료 기준: 현재 어떤 모드를 선택했는지 설명할 수 있어야 합니다. Config를 사용한다면 실제로 사용 중인 구성 파일도 확인합니다. 이 선택을 유지한 채 연결 단계로 넘어갑니다.

Shadowrocket 공식 Config 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다.
Config: 현재 파일 내용을 확인합니다. Global Routing 모드 선택은 Home에서 합니다.
STEP 03 · Home

연결 시작 및 시스템 권한 승인

처음 VPN 구성을 추가하도록 허용하는 것은 시스템이 관련 네트워크 트래픽을 처리하도록 승인하는 단계이며, 구독을 가져오는 절차가 아닙니다.

Home으로 돌아가 SERVER에서 예정한 서버를 선택했는지 확인하고, 앞 절에서 선택한 Global Routing 모드도 확인합니다. 스크린샷의 Not Connected는 연결되지 않은 상태이며, 상단 스위치로 연결을 시작하거나 중지합니다. 기록이 존재하는 상태, 기록을 선택한 상태, 연결이 켜진 상태는 서로 다릅니다. 목록에 서버가 보인다는 이유만으로 설정이 적용됐다고 판단하지 마세요.

상단 스위치를 켭니다. 처음 사용하는 경우 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. App Store에서 이 기기에 설치한 앱인지 확인한 뒤 안내에 따라 허용하고 기기 인증을 완료합니다. 여기서 허용하는 것은 시스템 네트워크 구성 권한입니다. 서버 정보가 검증됐다는 뜻도 아니고 연결 정보가 자동으로 제공되는 것도 아닙니다.

권한 승인을 마치면 Home으로 돌아가 스위치가 켜진 상태를 유지하는지, 연결 상태가 바뀌었는지 확인합니다. 방금 권한 요청을 취소했다면 연결 스위치를 다시 켜고 시스템 안내에 따르면 됩니다. 시스템 기록을 확인해야 한다면 시스템 설정에서 VPN 관련 항목을 찾으세요. OS 버전에 따라 메뉴 이름과 위치가 다를 수 있으므로 스크린샷과 경로가 정확히 일치하지 않는다고 구성이 사라졌다고 판단하지 마세요.

스위치가 켜져 있어도 대상에 접속할 수 있는 것은 아닙니다

시스템 VPN 상태나 Home의 연결 상태는 우선 기기의 네트워크 구성이 활성화됐음을 나타냅니다. 원격 서버의 인증 성공 여부, 대상 서비스의 접속 가능 여부, 규칙의 적합성은 다음 단계에서 확인해야 합니다. 스위치가 바로 꺼지면 권한 요청이나 오류 메시지가 표시됐는지 기록하세요. 스위치를 빠르게 반복해서 누르거나 원인을 모른 채 시스템 구성을 여러 개 만들지 마세요.

테스트하는 동안에는 Wi-Fi 또는 셀룰러 네트워크를 바꾸지 말고 서버, 네트워크, 모드를 동시에 전환하지 마세요. 기기에서 네트워크를 처리하는 다른 VPN 구성이 있다면 용도를 확인한 뒤 활성화 여부를 점검해 서로 영향을 주는 문제를 서버 장애로 오인하지 않도록 합니다. 관리형 기기나 조직 네트워크에서는 기기 관리 정책을 따르고 기존 구성을 임의로 삭제하지 마세요.

완료 기준: 시스템 안내에 따라 권한을 처리했고 Home의 연결 스위치가 켜진 상태를 유지합니다. 이제 항목을 더 바꾸지 말고 실제 요청을 확인하세요. 테스트가 끝나면 Home으로 돌아가 연결을 끌 수 있습니다.

Shadowrocket 공식 Home 화면. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER, Add Server가 표시됩니다.
Home: 서버와 Global Routing을 확인한 뒤 상단 연결 스위치를 조작합니다.
STEP 04 · Connectivity Test

연결 및 실제 요청 확인

기기 상태, 테스트 결과, 대상 작업을 각각 확인하고 하나의 결과만으로 전체를 판단하지 마세요.

연결을 켠 뒤 Home에서 Connectivity Test를 실행하고 현재 테스트가 완료되는지 확인합니다. 테스트 결과는 테스트 방식, 대상, 현재 네트워크와 서버 상태에 영향을 받으므로 먼저 결과를 기록한 다음 원인을 판단하세요. 테스트 성공은 해당 조건에서 응답을 받았다는 뜻이지 모든 웹사이트, 앱, 프로토콜이 검증됐다는 뜻은 아닙니다. 테스트 실패만으로 모든 실제 접속이 실패한다고 단정할 수도 없습니다.

이어서 브라우저를 열고 익숙하며 현재 실제로 사용해야 하는 페이지를 방문해 새로고침합니다. 특정 앱을 확인하려면 이전에 캐시된 화면만 보지 말고 앱에서 새 요청을 수행하세요. 결과를 비교할 수 있도록 서버, 네트워크, Global Routing은 그대로 유지합니다. 이미 열린 페이지, 오프라인 콘텐츠, 백그라운드에 남아 있는 화면만으로는 연결이 작동한다고 증명할 수 없습니다.

세 단계의 근거로 확인

  1. 기기 상태: Home 스위치가 켜져 있고 시스템에서 처리 대기 중인 권한 요청이 없습니다. 연결 기능이 활성화된 상태입니다.
  2. 테스트: Connectivity Test가 해당 테스트를 완료합니다. 사용한 방식을 기록하고 서로 다른 테스트 방식의 결과를 직접 비교하지 마세요.
  3. 요청: 대상 페이지나 앱에서 새 작업이 완료됩니다. Config를 사용한다면 해당 요청에 적용되는 규칙과 정책도 예상한 대로인지 확인합니다.

요청 하나가 프록시를 통과했는지 확인하려는 경우 페이지가 열린 것만으로는 충분하지 않습니다. DIRECT로 연결됐을 수도 있기 때문입니다. Config의 일치 규칙과 앱에서 확인할 수 있는 관련 기록을 함께 살펴보세요. 일부 요청이 직접 연결에 성공하는 것은 분할 라우팅 설정의 정상적인 결과일 수 있으므로 모든 요청이 프록시로 표시되도록 규칙을 바꿀 필요는 없습니다. 로그나 기록은 실제로 포함된 요청만 설명하며 모든 상황의 테스트를 대신하지 않습니다.

모드를 비교하려면 같은 서버와 대상을 유지하고 Global Routing만 Config에서 Proxy로 잠시 바꾼 뒤 새 요청을 보냅니다. 결과가 달라지면 구성을 우선 확인하세요. 두 모드 모두 실패한다면 서버 항목, 네트워크 연결 가능 여부, 인증을 점검합니다. 한 번에 바뀐 항목 하나만 기록하세요. 구독을 새로 고치고 DNS와 다시 쓰기 규칙을 동시에 바꾸면 원인을 찾기 어렵습니다.

완료 기준: 대상 작업이 완료되고 처리 경로가 용도에 맞습니다. 확인이 끝나면 평소 사용할 Global Routing 모드로 되돌리세요. 문제가 계속되면 어느 단계에서 실패했는지 파악한 뒤 마지막 단계로 넘어갑니다.

STEP 05 · Settings / Diagnostics

설정 확인 및 자주 발생하는 문제

증상에 따라 점검하고 한 번에 조건 하나만 바꾸세요. 원인을 알 수 없는 문제를 재설치하거나 설정을 한꺼번에 삭제해 해결하려 하지 마세요.

Settings를 열고 현재 문제와 직접 관련된 항목부터 확인합니다. 공식 스크린샷에는 Test Method, On Demand, Diagnostics와 Proxy, TCP, UDP 등의 설정이 포함되어 있습니다. 이 항목들이 보인다고 해서 처음 사용할 때 모두 바꿔야 하는 것은 아닙니다. 테스트 방식, 자동 연결 동작, 프로토콜 매개변수는 각각 다른 문제를 다루므로 만능 해결 옵션처럼 사용하지 마세요.

구독을 저장했는데 서버가 보이지 않는 경우

먼저 구독 기록으로 돌아가 읽기 또는 업데이트가 성공했는지 확인한 뒤 주소가 완전하고 유효한지, Shadowrocket에서 해석할 수 있는 형식인지 점검합니다. 일부 웹 주소는 구독 데이터 대신 로그인 페이지를 표시하므로 구독 링크로 사용할 수 없습니다. 현재 기본 네트워크에서 해당 주소에 접속할 수 있는지도 업데이트에 영향을 줍니다. 링크가 만료됐다면 이용 중인 서비스 제공업체에 기존 정보를 확인하세요. 같은 잘못된 내용을 반복해서 가져오지 마세요.

서버는 있지만 연결 또는 접속에 실패하는 경우

현재 서버 기록을 열고 Type, Host, Port, 인증 정보와 프로토콜 매개변수를 차례로 확인합니다. 특히 복사 과정에서 공백이 추가되거나 항목이 빠지지 않았는지 살펴보세요. 그런 다음 Home에서 해당 기록이 선택됐는지 확인합니다. 스위치가 켜진 상태를 유지하지 못하면 시스템 권한을 먼저 확인하세요. 스위치는 정상인데 실제 요청이 실패하면 Global Routing, Config, 서버 연결 가능 여부를 점검합니다. “기록이 있음”, “권한 승인됨”, “원격 서버 사용 가능”을 하나의 확인 항목으로 혼동하지 마세요.

Connectivity Test와 실제 접속 결과가 다른 경우

Settings에서 Test Method를 확인해 현재 테스트 방식을 파악한 다음 브라우저나 대상 앱에서 실제로 수행한 작업과 함께 판단합니다. 서버마다 테스트 방식에 따라 응답이 다를 수 있습니다. 테스트 값은 해당 조건에서 비교하는 데 사용하며 실제 속도를 보장하지 않습니다. 특정 대상만 실패한다면 다른 조건은 유지하고 해당 대상에 적용되는 규칙, 이름 확인, 서비스 상태를 살펴보세요. 자세한 절차는 문제 해결 매뉴얼을 참조하세요.

연결을 껐는데 다시 연결되는 경우: On Demand 확인

On Demand는 조건에 따라 연결을 시작하는 동작에 영향을 줍니다. 기본 연결을 확인하기 전에는 수동 스위치로 분명한 테스트 기준을 마련하는 것이 좋습니다. 연결이 안정되면 본인의 사용 조건에 맞게 On Demand를 설정하세요. 연결을 껐는데 다시 켜진다면 해당 조건이 설정되어 있는지 먼저 확인하고 스위치 고장으로 단정하지 마세요. On Demand는 서버 인증 문제를 해결하지 않으며 만료된 구독을 복구하지도 않습니다.

진단이 필요하다면 최소한의 정보부터 정리

Diagnostics를 사용하거나 관련 기록을 확인하기 전에 문제가 발생한 단계, 현재 모드, 네트워크 유형, 조건 하나를 바꾼 뒤의 결과를 기록합니다. 기록을 공유하기 전에 구독 전체 주소, 인증 항목, QR 코드, 계정을 식별할 수 있는 정보를 삭제하세요. 스크린샷 가장자리와 펼친 영역에도 인증 정보가 포함되지 않았는지 확인합니다. 자세한 진단에는 DNS, 규칙 순서, TCP / UDP 또는 iPad 환경이 관련될 수 있습니다. 이 페이지에서는 여러 항목을 한꺼번에 바꾸는 방법을 다루지 않으므로 문제 해결 매뉴얼의 증상별 안내를 참고하세요.

이번 점검 완료: 정보를 가져오고 서버를 선택해 연결을 켠 다음 실제 요청을 수행할 수 있다면 기본 사용 흐름이 마련된 것입니다. 이후에는 용어 매뉴얼에서 Config, PROXY, DIRECT, FINAL을 확인한 뒤 규칙을 하나씩 조정하세요. 확인된 구성을 보관해 두면 비교하거나 복원하기 쉽습니다.

Shadowrocket 공식 Settings 화면. Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 설정 항목이 표시됩니다.
Settings: 문제와 관련된 항목만 확인하세요. 첫 연결을 위해 모든 설정을 변경할 필요는 없습니다.

첫 설정 완료 확인

다섯 항목을 모두 확인한 뒤 자동 연결 조건이나 복잡한 규칙을 추가하세요.

  1. 기존 정보를 올바르게 가져왔고 Home에서 실제로 사용할 서버를 선택했습니다.
  2. Global Routing에서 현재 Config, Proxy, Direct 중 어떤 모드를 사용하는지 알고 있습니다. Config를 사용한다면 현재 구성 파일도 확인했습니다.
  3. 첫 VPN 구성 권한 승인을 마쳤고 연결 스위치가 예상한 상태를 유지합니다.
  4. Connectivity Test를 실행하고 대상 페이지나 앱에서 새 실제 요청을 완료했습니다.
  5. 테스트 후 평소 사용할 모드로 되돌렸습니다. On Demand를 켰다면 작동 조건과 수동 스위치의 관계를 이해했습니다.

다음에 사용할 때는 보통 현재 서버, 모드, 연결 상태만 확인하면 되며 다시 가져올 필요는 없습니다. 구독을 업데이트하거나 네트워크를 바꾼 뒤 문제가 생기면 영향을 받은 단계부터 다시 확인하세요. 더 긴 문제 해결 과정은 Shadowrocket 문제 해결 매뉴얼에서 이어서 확인할 수 있습니다.