Shadowrocket 사용법
구독 가져오기 및 연결 확인
기존 서버 하나를 연결한 다음 규칙 분기를 확인합니다. 이 안내에서는 iPhone과 iPad를 대상으로 실제 조작 순서에 따라 메뉴 위치, 예상 결과, 실패 시 다음 단계를 설명합니다.
- 01 정보 가져오기
- 02 모드 선택
- 03 연결 켜기
- 04 결과 확인
- 05 문제 찾기
서버 추가 / 구독 가져오기
완료 기준: Home의 SERVER 그룹에 본인의 서버 항목이 표시됩니다.
먼저 보유한 정보의 종류를 확인합니다. 단일 서버 정보에는 보통 프로토콜, 주소, 포트, 인증 항목이 포함됩니다. 구독 링크는 서버 항목을 가져오고 업데이트하는 데 사용됩니다. 두 종류의 정보는 서로 대신 사용할 수 없습니다. 구독 링크 전체를 단일 서버의 Host에 입력하거나, 도메인과 포트만 있는 문구를 완전한 구독 정보로 취급하지 마세요. 시작하기 전에 원본 정보를 보관해 복사 과정에서 문자가 빠지지 않도록 합니다.
Add Server에 직접 입력
Home을 열고 SERVER 그룹에서 Add Server를 선택합니다. 먼저 Type을 선택한 다음 해당 프로토콜에 표시되는 항목을 입력합니다. 스크린샷의 양식을 예로 들면 Host는 서버 주소, Port는 포트이며 Password와 Method는 보유한 정보와 일치해야 합니다. 다른 Type을 선택하면 표시되는 항목이 달라질 수 있으므로, 스크린샷의 모든 칸을 채우지 말고 해당 프로토콜 정보를 기준으로 입력하세요.
주소와 포트는 각각 입력하고 복사한 내용 앞뒤의 공백, 줄바꿈, 전각 문장 부호를 확인합니다. 비밀번호나 인증 정보는 대소문자를 구분할 수 있으므로 원문 그대로 입력해야 합니다. Method도 이름이 비슷하다는 이유로 임의로 바꾸면 안 됩니다. 정보에 전송 또는 보안 관련 매개변수가 있다면 해당 설정을 펼쳐 하나씩 확인하고, 입력란을 줄이려고 기존 매개변수를 삭제하지 마세요. 입력을 마치면 저장하고 Home으로 돌아가 방금 추가한 서버 항목이 표시되는지 확인합니다.
Subscribe로 기존 구독 가져오기
구독 링크가 있다면 Config 페이지에서 Subscribe를 엽니다. 선택한 항목이 서버 구독을 받는지 구성 파일 주소를 받는지 확인한 뒤 URL 입력란에 보유한 링크를 붙여 넣고 저장 및 업데이트를 진행합니다. 계정 페이지를 여는 일반 웹 주소를 구독 링크로 사용하지 마세요. 현재 화면 상태에 따라 메뉴 위치가 다를 수 있으므로 Subscribe 항목의 설명을 확인해 콘텐츠 유형을 판단합니다. 마지막으로 Home에 서버 항목이 표시되는지 확인합니다.
저장이 완료되었다고 해서 가져오기까지 성공한 것은 아닙니다. Home으로 돌아왔을 때 목록이 비어 있다면 먼저 업데이트 결과를 확인하고 링크가 온전한지, 현재 네트워크에서 구독 정보를 가져올 수 있는지 점검합니다. 링크에 개인 접근 정보가 포함될 수 있으므로 공개 스크린샷이나 댓글에 전체 내용을 표시하지 마세요. QR Code 정보는 Scan QR Code로 읽을 수 있으며, 읽은 뒤에도 생성된 서버 항목을 확인해야 합니다. Import from Cloud JSON은 해당 형식의 콘텐츠를 받는 기능으로, 임의의 구독 링크를 가져오는 범용 메뉴가 아닙니다.
목록에 항목이 있는 것을 확인했다면 연속으로 업데이트하거나 중복 가져오기를 하지 마세요. 알아보기 쉬운 항목 하나를 남겨 두고 Global Routing을 선택합니다. 중복 가져오기로 비슷한 이름이 늘어나면 이후 서버를 선택할 때 확인하기 어렵습니다. 메뉴와 형식의 차이는 구독 가져오기 자주 묻는 질문에서 확인하세요.
Global Routing 및 현재 구성 선택
완료 기준: 현재 모드와 요청에 적용될 연결 경로를 설명할 수 있습니다.
서버가 추가되면 Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인합니다. 여기서는 요청을 어떻게 분기할지 결정하며 서버 정보를 입력하지는 않습니다. 처음 사용할 때는 ‘서버를 가져온 상태’와 ‘구성을 활성화한 상태’를 혼동하기 쉽습니다. 전자는 연결 대상을 제공하고 후자는 어떤 요청이 그 대상을 사용할지 결정하므로 각각 확인해야 합니다.
세 가지 모드의 선택 기준
Config는 현재 구성 파일의 규칙에 따라 요청에 PROXY, DIRECT, REJECT 등의 정책을 적용하며, 명확한 트래픽 분기 규칙이 있는 경우에 적합합니다. 모든 요청이 현재 서버를 거친다는 뜻은 아닙니다. 특정 도메인이 규칙에 따라 DIRECT로 지정되어 있다면 연결 스위치가 켜져 있어도 해당 요청은 직접 연결될 수 있습니다.
Proxy는 일반 요청을 프록시 경로로 보내며, 선택한 서버로 실제 접속이 가능한지 처음 확인할 때 유용합니다. 잘못된 서버 정보를 올바르게 바꾸거나 시스템 권한을 대신할 수는 없습니다. 시스템 및 앱의 특정 트래픽 처리 방식은 관련 설정의 영향을 받습니다. Direct는 직접 연결하는 모드로, 프록시 경로와 기본적으로 비교할 때 사용할 수 있습니다. 이 모드를 선택한 뒤 서버를 거치지 않은 접속을 연결 오류로 판단하지 마세요.
Config 페이지에서 확인할 항목
Config를 사용하려면 Config를 열고 활성화하려는 파일이 선택되어 있는지 확인합니다. 공식 스크린샷에는 구성 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule 메뉴가 표시되어 있습니다. 각 섹션은 역할이 다르므로 첫 연결을 위해 하나씩 수정할 필요는 없습니다. 서버 구독 업데이트에 성공했더라도 현재 규칙 파일이 전환되거나 업데이트된 것은 아닙니다.
예를 들어 아래 규칙은 도메인 접미사를 기준으로 일치하는 요청에 PROXY를 적용합니다. 문법 설명을 위한 예시이며 example.com은 샘플 도메인입니다. 규칙 하나만으로 모든 요청에 적용되는 완전한 구성이 되지는 않습니다. 규칙의 순서, 기본 처리 정책, 현재 파일의 선택 여부가 모두 최종 결과에 영향을 줍니다.
DOMAIN-SUFFIX,example.com,PROXY처음 확인할 때는 Proxy로 기존 서버를 테스트한 뒤 Config로 전환해 트래픽 분기 차이를 살펴볼 수 있습니다. 한 번에 항목 하나만 바꾸고 테스트 대상을 기록하세요. 서버와 모드를 바꾸면서 규칙까지 수정하면 결과를 비교하기 어렵습니다. 구성 파일 구조와 규칙 일치 순서는 규칙 매뉴얼에서 확인하세요. 여기서는 기존 구성을 유지하고 연결 단계로 넘어갑니다.
서버를 선택하고 Home에서 연결 스위치 켜기
완료 기준: 서버 선택 표시가 분명하고 시스템 권한 설정이 끝났으며 연결 상태가 유지됩니다.
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하고 항목 옆에 선택 표시가 나타나는지 확인합니다. 목록에 서버가 있다고 기본 서버로 선택된 것은 아니며, 항목의 편집 화면을 여는 것도 서버 선택을 완료한 것이 아닙니다. 그룹이 여러 개라면 선택한 항목의 그룹과 이름을 기록해 두고 테스트할 때 동일한 항목을 유지해야 결과를 올바르게 비교할 수 있습니다.
Global Routing을 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 연결 전 스크린샷에는 상단에 Not Connected가 표시됩니다. 실제로는 목록의 지연 결과만 보지 말고 조작에 따라 스위치와 연결 상태가 바뀌는지 확인하세요. 처음 연결을 활성화할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 안내에 나온 앱 이름을 확인하고 허용한 뒤 시스템 요구에 따라 기기 인증을 완료하고 Shadowrocket으로 돌아옵니다.
이 권한은 앱이 시스템 네트워크 연결을 설정하는 데 필요한 구성 권한입니다. 서버를 가져오는 과정이 아니며 구독이나 인증 정보를 자동으로 생성하지도 않습니다. 앞서 팝업을 취소했다면 앱으로 돌아가 다시 연결을 시도합니다. 기기가 관리 정책의 제한을 받거나 시스템에서 변경을 명확히 차단한다면 허용 범위를 먼저 확인하세요. 스위치를 반복해서 켰다 끄며 원인을 추측하지 마세요.
권한 설정을 마친 뒤 연결이 완료될 때까지 잠시 기다리고 상태가 안정적으로 유지되는지 확인합니다. 스위치를 켜자마자 다시 꺼진다면 당시 표시된 안내를 기록한 뒤 다른 VPN 연결이 사용 중인지, 시스템 구성이 완료되지 않았는지 점검합니다. 현재 앱과 모든 구성을 바로 삭제하지 마세요. 기존 정보를 유지해야 이후 단계에서 권한 문제와 서버 문제를 구분할 수 있습니다.
스위치가 켜진 상태로 연결됨이 표시되더라도 시스템 연결 통로가 만들어졌다는 뜻일 뿐, 모든 웹사이트에 접속할 수 있다는 의미는 아닙니다. 다음 단계에서 Home의 Connectivity Test와 실제 접속을 함께 확인합니다. 시스템 상태, 서버 응답, 규칙 일치 여부는 서로 다른 세 가지 결과이며 어느 하나로 다른 결과를 대신 판단해서는 안 됩니다.
Connectivity Test와 실제 접속 확인
완료 기준: 테스트 결과와 실제 접속 결과를 연결해 설명하고 모드 전환의 영향을 파악할 수 있습니다.
방금 선택한 서버와 Global Routing을 유지한 채 Home에서 Connectivity Test를 누르고 검사가 끝날 때까지 기다립니다. 이 테스트는 현재 테스트 방식에서 서버가 응답하는지 확인하는 용도이며, 모든 프로토콜과 대상, 네트워크 조건을 완전히 검증하지는 않습니다. 응답 수치가 표시되어도 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 시간 초과가 발생하면 Settings의 Test Method도 확인하세요. 한 번의 결과만으로 서버를 삭제하지 마세요.
이어서 브라우저나 인터넷을 사용하는 앱을 열고 평소 사용하는 주소가 명확한 페이지에 접속합니다. 이전에 저장된 캐시만 표시되는 것이 아니라 페이지가 새로 요청되었는지 확인하세요. 필요하면 한 번 새로 고치거나 페이지를 다시 엽니다. 먼저 대상 하나만 테스트하고 서버, 모드, 네트워크 유형, 결과를 서로 대응해 기록합니다. 여러 페이지를 한꺼번에 여는 것보다 성공 여부를 확인한 뒤 범위를 넓히는 편이 원인을 파악하기 쉽습니다.
Proxy에서는 접속되지만 Config로 전환한 뒤 특정 대상만 실패한다면 서버가 작동하지 않는다고 바로 판단하지 말고 현재 구성 파일과 해당 대상에 적용된 정책을 먼저 확인합니다. Config에서는 DIRECT, PROXY, REJECT의 결과가 서로 다르므로 연결 스위치가 켜져 있어도 그 차이는 그대로입니다. 추가 확인이 필요하면 앱에서 볼 수 있는 연결 기록으로 대상 도메인과 정책을 확인한 뒤 규칙 매뉴얼에서 일치 순서를 살펴봅니다.
Connectivity Test에는 응답이 있지만 실제 접속은 실패한다면 프로토콜 매개변수, 대상 요청 유형, 현재 규칙을 확인합니다. 테스트와 실제 접속이 모두 실패하면 먼저 현재 네트워크가 정상적으로 인터넷에 연결되는지 확인한 다음 서버 정보를 점검합니다. Wi-Fi와 셀룰러 네트워크 결과를 비교할 수 있지만 네트워크를 전환한 뒤에는 같은 테스트를 반복해야 합니다. 서로 다른 대상을 테스트한 결과를 직접 비교하지 마세요.
자주 발생하는 문제와 Settings 점검
문제 발생 단계를 구분해 설정을 하나씩 변경하고, 사용 가능한 구성은 먼저 보존하세요.
가져온 뒤 서버가 표시되지 않음
먼저 가져오기 메뉴로 돌아가 저장과 업데이트가 모두 완료되었는지 확인합니다. 구독 콘텐츠, 구성 파일, 일반 웹페이지는 용도가 서로 다릅니다. 링크가 브라우저에서 열린다고 해서 인식 가능한 서버 정보가 반환되는 것은 아닙니다. 링크 전체가 복사되었는지, 복사 도구가 줄바꿈을 넣지 않았는지, 접근 정보가 아직 유효한지 확인하세요. 원본 정보가 변경되었다면 본인이 보유한 최신 정보를 기준으로 업데이트합니다. 목록이 비어 있는 상태에서 연결 스위치를 반복해서 켜도 누락된 항목이 추가되지는 않습니다.
연결 스위치가 꺼지거나 연결됨인데 응답이 없음
스위치가 다시 꺼지면 먼저 시스템 VPN 권한, 앱 안내, 현재 연결 충돌 여부를 확인합니다. 스위치가 켜져 있는데 요청이 실패하면 서버 선택, Type, Host, Port, 인증 및 전송 매개변수를 점검합니다. 이름이 같더라도 서로 다른 서버의 항목을 섞어 사용하면 안 됩니다. 한 번에 선택된 서버 하나만 테스트하고, 변경 사항을 저장한 뒤 다시 연결해 최신 설정을 기준으로 결과를 확인합니다.
테스트 시간 초과 또는 네트워크 전환 후 이상 발생
Settings에서 Test Method를 확인해 현재 테스트 방식이 무엇인지 파악한 뒤 Connectivity Test 결과를 해석합니다. 테스트 방식이 바뀌면 응답 양상이 달라질 수 있지만 서버 정보 자체가 바뀐 것은 아닙니다. 네트워크를 전환하거나 연결을 끊었다가 다시 연결한 뒤 발생하는 현상은 On Demand가 예상한 대로 활성화되어 있는지 확인합니다. 처음 문제를 점검할 때 상태를 기록해 두면 필요에 따른 연결 동작을 스위치 오류로 잘못 판단하는 일을 줄일 수 있습니다.
Settings에는 Diagnostics, Proxy, TCP, UDP 등의 항목도 있습니다. Diagnostics는 기본 점검 후 추가 정보를 수집할 때 유용합니다. Proxy, TCP, UDP는 구체적인 연결 동작에 영향을 주므로 시험 삼아 여러 항목을 동시에 변경하지 마세요. 네트워크에 따라 전송 방식별 처리 결과가 다를 수 있으며 웹페이지 하나가 열린다고 모든 요청 유형이 정상이라는 뜻은 아닙니다. 문제를 재현한 뒤 실제 프로토콜과 오류 정보를 바탕으로 관련 항목을 확인합니다.
추가 점검을 위해 보관할 정보
문제가 발생한 단계, 현재 모드, 네트워크 유형, 재현 가능한 오류 문구를 기록합니다. 스크린샷을 공유해야 한다면 서버 인증 정보, 개인 구독 주소와 기타 민감한 항목을 가린 뒤 공유하세요. 전체 구성을 그대로 공개하지 마세요. 이전에 정상 작동했던 설정으로 되돌려 같은 테스트를 반복하면 문제가 이번 변경으로 발생했는지 판단하는 데 도움이 됩니다. 모든 정보를 한꺼번에 지우는 것보다 근거가 분명합니다.
첫 연결을 마친 뒤에는 기존 서버와 명확한 트래픽 분기 목표를 기준으로 조금씩 조정하면 됩니다. 구독 업데이트, 권한 안내, 연결 문제는 FAQ에서 확인하고, General, Rule, 정책 키워드는 규칙 매뉴얼에서 살펴보세요. 접속 성공을 안정적으로 재현할 수 있다면 현재 구성을 유지하세요. 안내를 완료하기 위해 나머지 고급 설정까지 변경할 필요는 없습니다.
