OFFICIAL MANUAL / FIRST CONNECTION
Shadowrocket
구독 가져오기와 첫 연결
가져오기, 라우팅, 연결, 확인, 문제 해결 순서로 진행합니다. 이 공식 매뉴얼은 iPhone과 iPad 사용자를 대상으로 하며, 먼저 확인 가능한 연결을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정합니다.
처음 설정할 때는 On Demand를 켜지 않는 것이 좋습니다. 먼저 서버 항목 하나가 작동하는지 수동으로 확인한 다음 필요 시 자동 연결을 설정하세요. 문제가 생겨도 가져오기, 라우팅, 자동 실행 조건 중 어디에서 비롯됐는지 쉽게 구분할 수 있습니다.
01 서버 추가 또는 기존 구독 가져오기
먼저 보유한 정보가 구독 링크, 단일 서버 공유 정보, 직접 입력해야 하는 서버 매개변수 중 무엇인지 확인하세요. 각각 가져오는 방법이 다르므로 같은 정보를 여러 메뉴에 차례로 입력할 필요는 없습니다. 구독은 보통 서버 항목을 가져오고 업데이트하는 데 사용하며, 단일 서버 정보는 연결 항목 하나를 만드는 데 사용합니다. 구독은 규칙 설정 파일과 다릅니다. 가져온 뒤에도 다음 단계에서 Global Routing을 확인해야 합니다.
기존 구독 링크가 있는 경우: Add Server → Subscribe
Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 추가 버튼을 눌러 Add Server를 엽니다. Type에서 Subscribe를 선택하고 보유한 전체 구독 링크를 URL 필드에 붙여 넣으세요. 구분하기 쉬운 메모를 추가할 수도 있습니다. 링크는 원본 그대로 입력하세요. 특히 물음표 뒤의 매개변수를 삭제하지 말고, 앞뒤에 공백이나 줄바꿈 또는 채팅 메시지 안내 문구가 붙지 않았는지 확인합니다. 입력을 마치면 화면 오른쪽 위의 저장 버튼을 누르고 Home으로 돌아가 결과가 표시될 때까지 기다립니다.
가져오기가 완료되면 Home에 해당 그룹이나 서버 항목이 표시되어야 합니다. 구독 이름이 저장됐는지만 보지 말고 실제 항목이 나타났는지 확인하세요. 주소가 저장됐다고 해서 원격 콘텐츠까지 정상적으로 불러온 것은 아닙니다. 그룹만 보이고 선택할 항목이 없다면 현재 네트워크에서 링크를 불러올 수 있는지, 링크가 유효한지, 제공업체가 인식 가능한 구독 형식으로 응답하는지 확인하세요. 목록을 표시하려고 링크 매개변수를 임의로 변경하지 마세요.
단일 서버 정보가 있는 경우: Type에 맞춰 매개변수 입력
서버 주소, 포트, 비밀번호, 프로토콜 매개변수를 받았다면 Home에서 Add Server를 열고 올바른 Type을 선택하세요. 예를 들어 받은 정보가 Shadowsocks라면 해당 유형을 선택한 다음 입력합니다. 주소와 포트가 같다는 이유로 다른 프로토콜을 선택하지 마세요. Type에 따라 표시되는 필드가 다르므로 제공된 정보를 대조해 인증 정보, 암호화 방식, 해당하는 전송 설정을 입력합니다. 선택 사항으로 제공되지 않은 매개변수는 임의로 추가하지 마세요.
QR 코드가 있다면 Scan QR Code로 본인의 서버 공유 정보를 읽을 수 있습니다. 화면 안내에 따라 카메라 권한을 허용하세요. 가져온 뒤에도 항목을 열어 Type, 주소, 포트를 확인해야 합니다. QR 코드 스캔에 성공했다고 서버를 사용할 수 있는 것은 아닙니다. 직접 입력했다면 저장한 뒤 Home으로 돌아가 새 항목이 있는지 확인하고 그중 하나를 눌러 현재 서버로 선택하세요. 첫 테스트에서는 하나만 선택해 결과를 기록하기 전에 항목을 반복해서 바꾸지 않도록 합니다.
구독 링크와 서버 인증 정보에는 계정 접근 정보가 포함될 수 있습니다. 문제를 점검할 때 전체 링크, 비밀번호, QR 코드를 공개된 곳에 올리지 마세요. 오류 메시지와 필드 이름은 기록하되 실제 값은 가릴 수 있습니다. 가져오기를 마쳤다면 이제 모든 Settings를 바로 변경하기보다 요청을 어떻게 처리할지 정해야 합니다. 구독, 서버 항목, 설정 파일의 차이는 용어 안내서에서 확인하세요.
02 Global Routing 모드 선택
Home으로 돌아가 Global Routing을 엽니다. 처음 사용하는 경우 Config, Proxy, Direct 세 가지 모드부터 확인하세요. 이 선택은 전체 라우팅 방식을 결정하고, Home에서 선택한 서버는 서버를 사용해야 할 때 적용할 연결 정보를 결정합니다. 서로 다른 문제를 다루므로 서버를 선택했다는 이유만으로 요청이 반드시 해당 서버를 거친다고 판단할 수는 없습니다.
Config: 현재 사용 중인 규칙 파일 확인
Config는 현재 설정 파일의 규칙에 따라 요청을 처리합니다. 신뢰할 수 있는 출처의 규칙 설정이 있다면 Config로 이동해 파일이 목록에 있는지만 확인하지 말고 현재 실제로 활성화된 파일인지 확인하세요. 그런 다음 Global Routing으로 돌아와 Config를 선택합니다. 규칙에 따라 요청마다 PROXY, DIRECT, REJECT로 처리될 수 있으므로 대상별 결과가 다르더라도 반드시 연결 실패를 의미하지는 않습니다.
구독 링크만 있고 사용할 규칙 파일을 정하지 않았다면 구독을 가져온 것만으로 필요한 라우팅 설정까지 완료됐다고 생각하지 마세요. 먼저 Config의 현재 내용과 출처를 확인한 뒤 해당 규칙을 사용할지 결정합니다. 규칙은 위에서 아래로 적용되므로 앞선 규칙과 일치하면 이후 처리가 달라질 수 있습니다. 첫 연결 단계에서는 규칙을 하나씩 편집할 필요 없이 출처를 확인할 수 있는 원본 설정을 유지하세요. 규칙 키워드와 정책의 뜻은 용어 안내서에서 확인할 수 있습니다.
Proxy와 Direct: 요청 처리 경로 구분
Proxy는 일반 요청을 현재 선택한 서버로 처리합니다. 첫 문제 해결 단계에서 규칙 라우팅에 따른 변수를 잠시 줄이는 데 유용합니다. Config가 대상 접속에 영향을 주는지 확실하지 않다면 기존 모드를 기록하고 Proxy를 잠시 선택한 뒤 같은 대상으로 한 번 더 테스트하세요. 이는 선택한 서버를 점검하는 방법일 뿐, 일상적으로 항상 Proxy를 사용해야 한다는 뜻도 아니고 모든 대상에 접속할 수 있다는 보장도 아닙니다.
Direct는 일반 요청을 선택한 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 현재 네트워크의 직접 접속 상태를 살펴볼 수 있지만 서버가 정상적으로 작동하는지 확인하는 방법은 아닙니다. 테스트 중 Direct를 선택했다면 Home에서 서버를 선택했더라도 웹페이지가 열린 것을 해당 서버가 적용됐다는 뜻으로 해석하지 마세요. 사용할 모드를 선택한 뒤 Home으로 돌아가 서버와 Global Routing 선택을 기록합니다. 다음 단계에서 연결 스위치를 켭니다.
03 연결 스위치를 켜고 시스템 승인 완료
Home에서 현재 서버와 Global Routing을 다시 확인한 다음 화면 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 승인하라는 안내가 표시될 수 있습니다. 이 단계는 Shadowrocket이 시스템에 필요한 네트워크 구성을 생성하도록 허용하는 것으로, 구독을 새로 추가하거나 서버 매개변수를 자동으로 입력하는 과정이 아닙니다. 방금 시작한 작업에 대한 안내인지 확인한 뒤 추가를 허용하고 시스템의 안내에 따라 기기 인증을 완료합니다.
허용하지 않음을 선택했다면 연결이 진행되지 않을 수 있습니다. Shadowrocket으로 돌아와 다시 켜고 시스템 승인 안내가 다시 표시되는지 확인하세요. 시스템 Settings에서 VPN 구성 상태를 확인할 수도 있습니다. 복구를 시도하는 과정에서 용도를 알 수 없는 구성을 여러 개 한꺼번에 삭제하지 마세요. 특히 관리형 기기라면 조직의 정책 제한이 있는지 먼저 확인해야 합니다. 앱에 필요한 권한이 없는 경우 서버를 계속 바꿔도 권한 문제는 해결되지 않습니다.
승인한 뒤 Home으로 돌아와 스위치가 계속 켜져 있는지 확인하고 연결 상태가 안정될 때까지 기다립니다. 스위치를 켜자마자 꺼지면 당시 표시된 안내를 보존하고 선택한 항목이 올바른지, 시스템 구성이 정상적으로 생성됐는지, 다른 VPN 연결이 작동 중인지 확인하세요. 스위치가 켜진 상태를 유지하더라도 계속해서 결과를 확인해야 합니다. 시스템에 VPN 상태가 표시되는 것은 연결 구성이 해당 상태라는 뜻일 뿐 서버 인증, 대상 접속, 규칙 일치가 모두 올바르다는 증거는 아닙니다.
이번 테스트에서는 수동 조작을 유지하고 On Demand를 켜거나 여러 Settings 항목을 동시에 바꾸지 마세요. 서버를 바꿔야 한다면 먼저 연결을 끄고 다른 항목을 선택한 다음 다시 켜세요. 각 테스트의 조건을 명확하게 유지할 수 있습니다. iPad에서도 Home, 서버 선택, Global Routing, 연결 스위치 순서로 확인하세요. 기기와 앱에 따라 화면 배치는 달라질 수 있지만 점검할 항목은 같습니다.
스위치가 켜진 상태를 유지하면 실제 요청을 확인할 차례입니다. 테스트 수치가 높은지 낮은지보다 선택한 항목, 라우팅 모드, 실제 접속 결과가 서로 일치하는지 먼저 살펴보세요.
04 연결이 예상대로 작동하는지 확인
먼저 Home에서 Connectivity Test로 기존 서버를 테스트하고 현재 테스트 방식에 유의하세요. 응답이 있다는 것은 해당 테스트 조건에서 결과를 얻었다는 뜻일 뿐 모든 웹사이트, 프로토콜, 규칙이 작동한다는 뜻은 아닙니다. 테스트 시간 초과도 테스트 대상과 현재 네트워크를 함께 고려해야 합니다. 첫 확인에서는 특정 수치 하나만 보고 결론 내리지 말고 테스트 결과와 웹페이지 접속 결과를 함께 기록하세요.
같은 순서로 세 가지 항목 확인
- Home에서 현재 선택된 서버가 방금 테스트한 서버인지 확인합니다. 구독을 업데이트하거나 서버를 직접 바꾼 뒤에는 선택 상태를 다시 확인해 다른 서버로 연결하는 일을 방지하세요.
- 평소 접속할 수 있는 페이지를 열어 기기의 기본 네트워크 요청이 정상적으로 처리되는지 확인합니다. 이어서 이번에 처리 경로를 확인하려는 대상에 접속하세요. 이전에 불러온 캐시 콘텐츠만 표시되지 않도록 페이지를 새로고침하거나 새 페이지를 여는 것이 좋습니다.
- Shadowrocket으로 돌아와 Data에서 확인할 수 있는 연결 기록과 현재 Global Routing, Config 규칙을 함께 살펴 처리 결과를 판단합니다. 기록에 표시되는 세부 정보는 다를 수 있으므로 실제 화면 내용을 기준으로 하세요. 특정 필드가 없다는 이유만으로 이상이라고 단정하지 마세요.
Config를 사용하는 경우 두 대상이 각각 DIRECT와 PROXY 규칙에 일치할 수 있으므로 규칙에 따라 결과를 해석하세요. 비교가 필요하면 Proxy로 잠시 전환하고 서버와 대상을 그대로 둔 채 다시 테스트합니다. Proxy에서는 접속되지만 Config에서는 안 된다면 서버 비밀번호를 바로 다시 입력하기보다 규칙과 해당 정책을 먼저 확인하세요. 비교가 끝나면 원래 사용할 모드로 되돌려 테스트 설정이 일상 설정으로 남지 않도록 합니다.
Connectivity Test에 응답이 있지만 웹페이지가 계속 로드되지 않는 경우에도 단순히 속도가 느리다고 결론 내릴 수 없습니다. 인증, 전송 매개변수, DNS 확인, 대상 자체의 상태, 규칙이 실제 요청에 영향을 줄 수 있습니다. 먼저 모든 대상에서 같은 문제가 발생하는지 아니면 특정 대상에서만 발생하는지 확인한 뒤 점검 범위를 정하세요. 한 페이지의 실패만으로 전체 연결 상태를 판단해서는 안 되며, 한 페이지의 성공만으로 모든 라우팅이 예상대로 작동한다고 볼 수도 없습니다.
확인에 성공했다면 반복 테스트에 사용할 조건을 기억해 두세요. 사용할 서버, Global Routing 모드, 대상, 연결 당시의 네트워크를 기록합니다. 나중에 Config를 수정하거나 On Demand를 켰을 때 같은 조건으로 다시 테스트할 수 있습니다. 비밀번호와 전체 구독 링크를 기록할 필요는 없으며 항목과 작업 순서를 알아볼 수 있는 정보만 남기면 됩니다.
05 문제가 발생한 단계별로 점검
문제가 발생하면 먼저 어느 단계에서 멈췄는지 확인하세요. 정보 가져오기, 서버 테스트, 스위치 켜기, 연결 후 접속 중 어느 부분에 문제가 있는지 구분합니다. 한 번에 한 항목만 바꾸고 방금 진행한 테스트를 반복하세요. 구독, 서버 매개변수, Global Routing, DNS를 동시에 변경하면 기존 단서를 잃고 어떤 변경이 효과가 있었는지 확인하기 어려워집니다.
구독은 저장됐지만 서버 항목이 없는 경우
먼저 URL이 본인의 전체 구독 링크인지 확인한 다음 현재 네트워크에서 링크를 불러올 수 있는지 점검합니다. 로그인 페이지, 오류 페이지, 형식이 맞지 않는 콘텐츠는 응답을 받더라도 가져올 수 있는 구독이 아닙니다. 이전에 사용할 수 있던 항목이 있다면 업데이트 실패 직후 모두 삭제하지 마세요. 기존 기록을 보존하고 링크의 유효성과 서비스 상태를 확인합니다. 기존 제공업체에 문의할 때는 오류 메시지와 발생 단계를 설명하되 전체 링크를 공개하지 마세요. 자세한 내용은 자주 묻는 질문의 구독 가져오기 항목을 참고하세요.
항목은 있지만 Connectivity Test가 시간 초과되는 경우
해당 항목을 열고 원본 정보와 대조해 Type, 서버 주소, 포트, 인증 정보, 전송 매개변수를 하나씩 확인하세요. 숫자와 대소문자, 복사 과정에서 붙은 공백도 살펴봅니다. 구독으로 관리되는 항목을 직접 수정했다면 다음 업데이트에서 내용이 바뀔 수도 있으므로 현재 값의 출처를 먼저 확인하세요. 보유한 다른 서버 항목으로 비교 테스트도 진행합니다. 하나만 실패한다면 해당 항목의 정보와 서비스 상태를 우선 점검하고, 모두 실패한다면 기기의 현재 네트워크가 정상인지도 확인하세요.
스위치가 바로 꺼지거나 승인이 완료되지 않는 경우
먼저 시스템의 VPN 구성 추가 안내에서 허용을 선택했는지 확인한 뒤 서버 항목에 필수 필드가 빠지지 않았는지 살펴봅니다. 다른 VPN 연결을 사용 중이라면 용도를 확인하고 필요하지 않은 연결을 종료한 다음 Shadowrocket을 다시 시도하세요. 관리형 기기의 제한은 해당 관리 정책에 따라 처리해야 하며 서버 정보를 바꿔도 해결되지 않습니다. 스위치가 켜진 상태를 유지하지 못하는 문제와 스위치는 켜졌지만 웹페이지가 열리지 않는 문제를 같은 오류로 보지 마세요. 우선 확인할 항목이 서로 다릅니다.
연결은 켜졌지만 모든 페이지가 열리지 않는 경우
먼저 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 기본 접속이 가능한지 확인한 다음 다시 연결해 같은 대상으로 테스트합니다. Direct에서는 접속되지만 Proxy에서는 실패한다면 선택한 서버와 인증 매개변수를 먼저 점검하세요. Proxy에서는 접속되지만 Config에서는 실패한다면 설정 파일, 규칙 일치, 관련 정책을 확인합니다. DNS도 결과에 영향을 줄 수 있지만 처음부터 익숙하지 않은 주소로 바꾸지 마세요. 현재 설정을 유지한 채 문제가 도메인 확인 단계에만 나타나는지 먼저 살펴봅니다.
일부 대상에서만 문제가 있거나 연결 후 설정이 자동으로 바뀌는 경우
일부 대상에서만 문제가 생기면 대상과 현재 모드를 기록하고 예상한 PROXY, DIRECT, REJECT 규칙에 일치하는지 확인하세요. 구독 업데이트 후에는 항목 이름이나 사용할 수 있는 항목이 달라질 수 있으므로 현재 선택한 항목도 다시 확인합니다. Wi-Fi 전환, 화면 잠금, 앱 실행에 따라 상태가 바뀐다면 On Demand의 실행 조건을 점검하세요. 먼저 자동 실행을 끄고 수동으로 비교 테스트한 뒤 전체 설정을 바로 초기화하지 마세요. 규칙 순서, DNS, 배터리 소모, 업데이트 후 오류를 체계적으로 점검하려면 문제 해결 안내서를 참고하세요.
이 페이지에서 첫 사용 절차를 마쳤습니다. 일상적으로 사용할 때마다 서버를 다시 추가할 필요는 없습니다. 현재 항목과 Global Routing을 먼저 확인하고 변경 사항이 생기면 해당 단계부터 다시 점검하세요. 익숙하지 않은 화면 용어는 용어 안내서에서 확인하고, 구매, 구입 항목 복원, 설치 관련 문제는 정식 구매 및 설치 안내를 참고하세요.