OFFICIAL MANUAL / FIRST CONNECTION
추가, 모드 선택, 연결, 확인, 문제 해결 순서로 진행합니다. 먼저 확인 가능한 연결을 한 번 완료한 뒤 DNS, On Demand 등의 고급 설정을 조정합니다.
먼저 정보 준비:구독 사용자는 전체 주소를 준비합니다. 수동으로 추가하는 경우 프로토콜, 서버 주소, 포트와 인증 매개변수를 준비합니다. 구독 링크, QR 코드 또는 비밀번호를 공개 페이지에 올리지 마세요. 도움을 요청할 때 스크린샷을 공유하려면 이러한 정보가 보이지 않도록 가려야 합니다.
아래 스크린샷은 App Store 공식 스크린샷입니다. 항목은 Type과 앱 버전에 따라 달라질 수 있습니다. 화면의 영문 용어와 본인의 정보를 기준으로 판단하고 스크린샷의 예시 내용은 사용하지 마세요.
STEP 01 / ADD SERVER
두 방법 중 하나를 선택하면 됩니다. 구독은 서버를 일괄 관리하는 데 사용하고, 수동 추가는 서버 정보를 한 건 입력할 때 사용합니다.
Shadowrocket의 Home을 열고 Add Server를 찾거나 화면의 추가 메뉴를 사용해 새 항목 화면으로 이동합니다. Type 목록을 열어 Subscribe를 선택하고, 구독의 URL 입력란에 본인이 보유한 전체 주소를 붙여 넣습니다. 알아보기 쉬운 이름을 입력한 다음 저장하고 Home으로 돌아옵니다. 저장 후 서버가 표시되지 않으면 해당 구독 항목을 업데이트하고 결과를 기다리세요. 같은 주소를 연속으로 중복 추가하지 마세요.
주소를 복사할 때는 시작부터 끝까지 모두 선택하고, 특히 물음표 뒤의 매개변수도 빠뜨리지 마세요. 웹페이지 제목, 설명, 따옴표 또는 끝부분의 공백을 함께 붙여 넣지 않도록 합니다. 구독 주소에는 접속 자격 정보가 포함되는 경우가 많으므로 비밀번호처럼 관리해야 합니다. 받은 정보가 구독 주소가 아니라 계정 관리 페이지라면 앱에서 서버 목록으로 해석할 수 없습니다. 먼저 본인의 서비스 제공자에게 주소의 용도를 확인한 뒤 가져오기를 시도하세요.
가져오기가 완료되면 Home의 SERVER 그룹으로 돌아가 구독 그룹과 서버 항목이 표시되는지 확인합니다. 이름이 표시된다는 것은 정보가 앱에 추가되었다는 의미일 뿐, 원격 서버에 반드시 연결할 수 있다는 뜻은 아닙니다. 항목 하나를 선택한 뒤 아래의 모드 선택을 진행합니다. 구독의 트래픽이나 유효 기간 정보가 표시되는 경우 해당 서비스 계정의 정보를 기준으로 확인해야 하며, 앱 구매 상태를 나타내는 것으로 해석하면 안 됩니다.
서버 정보가 한 건인 경우 Add Server에서 먼저 Type을 선택한 다음 항목을 입력합니다. 스크린샷에 표시된 항목을 예로 들면 Host는 서버 주소, Port는 포트, Password는 인증 정보이며 Method는 서버 측에서 제공한 암호화 방식과 일치해야 합니다. 다른 프로토콜에는 서로 다른 인증, 전송 또는 TLS 항목이 표시될 수 있습니다. 보유한 정보를 기준으로 입력하고 한 프로토콜의 항목을 다른 프로토콜에 그대로 적용하지 마세요.
Host에는 보통 도메인 또는 IP 주소를 입력하며 웹페이지 경로를 덧붙이지 않습니다. Port는 서버의 실제 설정에 따라 입력하고, 익숙한 포트라는 이유로 다른 값으로 바꾸지 마세요. 저장하기 전에 각 항목을 다시 확인하고 특히 비밀번호의 대소문자, 숫자와 기호를 살펴봅니다. 어떤 항목이 필수인지 정보에 안내가 없다면 임의로 옵션을 켜기보다 프로토콜 요구 사항을 먼저 확인하세요. 프로토콜과 항목의 관계는 용어집에서 확인할 수 있습니다.
기존 서버 QR 코드가 있다면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용할 수 있습니다. 스캔 후에도 Type, 주소와 포트를 확인한 다음 저장해야 합니다. Import from Cloud JSON은 해당 JSON 가져오기 콘텐츠를 위한 기능이며 임의의 구독 주소를 붙여 넣는 범용 메뉴가 아닙니다. 어떤 방법을 사용하든 마지막에 SERVER 그룹으로 돌아가 항목을 확인하세요. 편집 화면에 머물러 있으면서 추가가 완료되었다고 착각하지 않도록 합니다.
이 단계의 완료 기준:Home에 선택 가능한 서버 항목이 있고 현재 선택한 항목이 무엇인지 알고 있어야 합니다. 다음 단계에서는 어떤 요청에 해당 서버를 사용할지 정합니다.
STEP 02 / GLOBAL ROUTING
서버는 사용할 프록시 출구를 정하고, 모드는 요청 처리 방식을 정합니다. 두 항목은 서로 다른 선택입니다.
Home으로 돌아가 Global Routing을 눌러 현재 선택 항목을 확인합니다. 처음 진행할 때는 세 가지 모드를 구분하세요: 구성(Config), 프록시(Proxy), 직접 연결(Direct). 여기서 Config는 모드 이름이며, 하단 탐색 메뉴의 Config는 구성 파일 관리에 사용됩니다. 서로 관련은 있지만 파일을 열어 보는 것만으로 해당 파일이 현재 구성으로 선택되는 것은 아닙니다.
출처와 용도를 명확히 알고 있는 구성 파일이 있다면 구성(Config)을 선택할 수 있습니다. 그런 다음 Config 페이지에서 사용 중인 파일을 확인하고 Rule의 정책과 순서를 살펴봅니다. 일반적으로 요청은 규칙 일치 결과에 따라 PROXY, DIRECT 또는 REJECT로 처리됩니다. 구성에서 참조하는 정책 이름은 해당 정의가 있어야 합니다. 서버 구독을 가져온 것만으로 완전한 규칙 구성을 가져온 것으로 볼 수는 없습니다.
공식 스크린샷은 구성 편집 페이지의 General, Rule, Hosts, URL Rewrite 및 HTTPS Decryption 섹션을 보여줍니다. 첫 연결에서는 현재 파일과 Rule만 확인하면 됩니다. 가이드를 완료하기 위해 모든 섹션을 수정하거나 HTTPS Decryption을 켤 필요는 없습니다. Add Rule은 규칙 추가 기능입니다. 기존 규칙 순서를 이해하지 못한 상태에서 임의로 추가하면 연결 실패 문제가 규칙의 조기 일치 문제로 바뀔 수 있으므로 주의하세요.
확인된 규칙 구성이 아직 없다면 Proxy를 잠시 사용해 현재 서버의 기본적인 사용 가능 여부를 확인할 수 있습니다. 이 모드에서는 일반적으로 선택한 서버가 프록시 가능한 요청을 처리하지만, 모든 시스템 트래픽이 같은 경로를 사용한다고 볼 수는 없습니다. Direct는 프록시 서버를 거치지 않는 접속에 사용합니다. 이 모드에서 웹사이트가 열려도 방금 추가한 서버를 사용할 수 있다는 뜻은 아닙니다.
Proxy에서는 접속되지만 Config에서는 같은 대상에 접속할 수 없다면 비밀번호를 바로 바꾸기보다 규칙, 정책 참조와 DNS 경로를 먼저 확인합니다. 두 모드 모두 실패하면 서버와 현재 네트워크부터 점검하세요. 모드를 바꾼 뒤에는 요청을 새로 시작해야 합니다. 기존 연결은 이전 경로를 계속 사용할 수 있습니다. DOMAIN-SUFFIX, IP-CIDR, FINAL 등의 일치 방식을 알아보려면 프록시 모드 안내와 Settings 설정 참고를 확인하세요. 이 가이드에서는 변경 범위를 최소화합니다.
이 단계의 완료 기준:현재 선택한 모드를 설명할 수 있어야 합니다. Config를 사용하는 경우 현재 구성 파일도 확인해야 합니다. 이 상태를 기억한 뒤 연결 권한을 부여합니다.
STEP 03 / HOME
연결 전에 서버가 선택되어 있는지, Global Routing이 이번 점검 대상에 적합한지 다시 확인합니다.
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시를 확인합니다. 그런 다음 상단 연결 스위치를 켭니다. 처음 실행할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 안내를 읽고 본인이 요청한 작업인지 확인한 뒤 시스템 요구 사항에 따라 권한을 부여하거나 기기 인증을 완료합니다. 이 권한은 앱이 해당 네트워크 요청을 처리하도록 허용하는 것이며, 누락된 서버 매개변수를 자동으로 채워 주지는 않습니다.
권한을 거부했다면 앱으로 돌아가 연결을 다시 시작하고 시스템 안내가 다시 표시되는지 확인합니다. 그래도 진행할 수 없다면 시스템의 VPN 구성 관리에서 관련 상태를 확인하세요. 연결을 “수리”하기 위해 알 수 없는 페이지에서 추가 프로파일을 설치하지 마세요. 조직에서 관리하는 기기는 시스템 정책에 따라 VPN 구성이 제한될 수 있으므로 먼저 기기에서 허용된 작업 범위를 확인해야 합니다.
권한 부여를 마치고 Home으로 돌아와 상단 상태가 Not Connected에서 바뀌는지 확인한 다음 상태가 안정될 때까지 기다립니다. 스위치를 빠르게 반복해서 켜고 끄지 마세요. 연결 설정, 해제와 테스트 요청이 뒤섞여 어떤 작업에서 결과가 발생했는지 판단하기 어려워집니다. 스위치가 즉시 꺼지면 당시 표시된 오류를 기록하세요. 연결 설정 상태가 계속되면 현재 구성을 유지한 채 마지막 문제 해결 단계에서 점검합니다.
시스템에 VPN 상태가 표시되는 것은 터널 또는 네트워크 확장이 해당 상태에 있다는 뜻일 뿐, 모든 원격 요청의 성공을 의미하지는 않습니다. 서버 인증, 대상 접속, DNS 해석과 규칙 일치는 각각 확인해야 합니다. 테스트를 마칠 때까지 On Demand도 켜지 마세요. 자동 연결 동작이 수동 스위치 판단에 영향을 줄 수 있습니다.
이 단계의 완료 기준:시스템 권한 부여가 완료되고 Home의 연결 상태가 안정적이며, 작업 중 선택한 서버가 바뀌지 않아야 합니다. 다음 단계에서 실제 요청으로 사용 가능 여부를 확인합니다.
STEP 04 / CONNECTIVITY TEST
연결 상태가 안정되면 Home에서 Connectivity Test를 실행하고 이번 결과를 기다립니다. 테스트 결과는 테스트 대상, 방법과 현재 네트워크에 영향을 받습니다. 응답이 있으면 이번 테스트 경로에 접속할 수 있다는 뜻이지만 모든 웹사이트, 앱 또는 프로토콜의 사용 가능성을 보장하지는 않습니다. 테스트 시간이 초과되면 실제 접속 상태도 함께 확인해야 합니다. 숫자 하나만으로 서버가 완전히 작동하지 않는다고 판단할 수는 없습니다.
이어서 평소 이용하려는 대상 서비스를 열고 페이지를 새로 고치거나 새 요청을 보냅니다. 이미 캐시된 페이지가 아니라 네트워크에서 새 콘텐츠를 가져오는 대상을 우선 확인합니다. 일반적인 웹 탐색은 되지만 특정 앱이 계속 실패하면 앱에서 수행한 작업, 오류 발생 시간과 오류 안내를 기록하세요. 일부 문제를 클라이언트 전체의 문제로 바로 단정하지 마세요.
Shadowrocket으로 돌아가 Data의 관련 트래픽 수치와 현재 확인할 수 있는 연결 또는 로그 기록을 살펴봅니다. 트래픽이 증가하면 통계 경로를 통해 데이터가 처리된 것이지만 백그라운드 요청도 트래픽을 만들 수 있으므로 총량만으로 특정 대상이 PROXY를 거쳤다고 증명할 수는 없습니다. 분기 처리를 확인하려면 대상 주소, 일치 규칙과 최종 정책을 함께 살펴봐야 합니다. 현재 기록만으로 판단하기 어렵다면 적절한 진단을 먼저 켠 뒤 요청을 새로 보내세요.
“연결 상태 안정 → 테스트 결과 확인 → 실제 대상 접속 가능 → 정책 적용 확인” 순서로 결과를 기록할 수 있습니다. 처음 두 항목만 완료했다면 결론을 기본 연결 확인으로 제한하고 “모든 규칙이 올바르다”고 판단하지 마세요. 테스트 중 Proxy로 임시 변경했다면 테스트 후 원래 사용하려던 모드로 되돌리고 같은 대상을 다시 확인해 일상적인 사용 상태도 예상대로인지 살펴봅니다.
STEP 05 / SETTINGS & DIAGNOSTICS
먼저 어느 단계에서 중단되는지 확인한 다음 관련 설정을 살펴봅니다. 앱 재설치를 첫 조치로 삼지 마세요.
먼저 구독 업데이트의 구체적인 오류를 확인합니다. 가져오기 실패와 콘텐츠 해석 실패는 서로 다른 문제입니다. 전자는 기기의 기본 네트워크, 주소 전체 여부와 구독 접근 권한을 확인합니다. 후자는 응답 내용이 앱에서 인식할 수 있는 서버 정보인지 확인해야 합니다. 로그인 페이지, 만료 안내 페이지 또는 일반 웹페이지는 가져올 수 없습니다. 업데이트가 성공했지만 사용할 항목이 없다면 필터 조건과 구독에 유효한 서버가 포함되어 있는지 확인합니다.
자격 정보가 포함된 전체 구독 링크를 공개 테스트 서비스에 붙여 넣어 확인하지 마세요. 구독 상태를 확인해야 한다면 본인 서비스의 계정 페이지를 확인하거나 원래 서비스 제공자에게 오류 상황을 설명하세요. 기존 항목은 보존하고 먼저 업데이트와 정보를 확인합니다. 모든 기록을 연달아 삭제한 뒤 다시 추가하지 마세요.
서버 편집 페이지를 다시 열어 Type, Host, Port와 인증 매개변수를 대조합니다. TLS 또는 특정 전송 방식을 사용한다면 서버 이름, 경로 등 관련 항목도 확인합니다. 이러한 값은 기존 정보에서 확인해야 하며 경험에 따라 임의로 입력하지 마세요. 기기 시간이 올바른지 확인한 다음 현재 네트워크에서 해당 주소와 포트에 접근할 수 있는지 점검합니다. 매개변수가 맞아도 서버가 작동 중이라는 뜻은 아니므로 필요하면 원래 서비스 제공자에게 상태를 확인하세요.
시스템 권한 부여가 완료되지 않았다면 서버 비밀번호를 수정하기보다 권한 문제를 먼저 해결합니다. 연결을 시작하자마자 다른 자동 연결 동작으로 상태가 바뀐다면 Settings에서 On Demand를 확인하고 시스템의 다른 VPN 구성 상태도 함께 살펴봅니다. 먼저 수동 연결로 한 차례 확인한 다음 조건에 따른 연결을 설정하세요.
Settings에서 Test Method를 열어 확인하려는 문제에 맞는 테스트 방법인지 확인합니다. 한 가지 테스트에 응답이 없다고 웹 요청도 반드시 실패하는 것은 아닙니다. 반대로 어떤 테스트가 통과하더라도 인증, DNS와 대상 서비스가 모두 정상이라는 뜻은 아닙니다. 서버와 모드를 그대로 유지하고 실제로 필요한 대상을 바꿔 교차 확인한 다음 테스트 설정을 조정할지 결정하세요.
먼저 도메인 해석 실패, 연결 시간 초과, 인증 오류와 대상 서비스의 오류 응답을 구분합니다. DNS가 의심되면 현재 값을 기록한 다음 Settings 설정 참고에 따라 시스템 DNS, 사용자 지정 DNS와 규칙의 조합을 확인합니다. 출처를 알 수 없는 DNS 주소를 한 번에 여러 개 추가하지 마세요. Proxy에서는 정상이고 Config에서는 문제가 있다면 Rule에 REJECT가 먼저 일치하는지, 예상하지 않은 DIRECT 경로를 사용하는지, 정책 참조가 존재하는지 중점적으로 살펴봅니다.
규칙을 변경하기 전에 기존 구성을 보존하고, 수정한 뒤 관련 요청을 새로 만들어 일치 결과를 확인합니다. DOMAIN-SUFFIX와 DOMAIN-KEYWORD는 일치 범위가 다르며 IP-CIDR은 주소 일치와 관련됩니다. 규칙 이름만 보고 의미를 추측하면 안 됩니다. 기본 개념이 더 필요하다면 먼저 규칙 키워드 용어를 확인한 다음 구성으로 돌아가 수정하세요.
Settings의 Diagnostics에서 진단 메뉴를 확인할 수 있으며, 실제로 사용할 수 있는 항목은 현재 화면에 따라 다릅니다. 모드, 서버 프로토콜, 사용 중인 네트워크, 실패 단계와 오류 원문을 기록합니다. 로그를 공유하기 전에 주소, 인증 정보와 구독 매개변수를 확인하고 민감한 내용은 삭제하세요. “Config에서 특정 도메인에 연결 시간이 초과되고 Proxy로 바꾸면 정상”처럼 설명하면 “작동하지 않음”만 전달하는 것보다 문제를 파악하기 쉽습니다.
이 단계의 완료 기준:문제를 가져오기, 권한 부여, 서버, DNS 또는 규칙 단계 중 하나로 분류하고 관련 관찰 결과를 보존할 수 있어야 합니다. 연결이 복구되면 일상 설정을 하나씩 되돌리고, 문제 해결을 위해 사용한 임시 모드를 최종 구성으로 간주하지 마세요.
CONTINUE / PLATFORM & REFERENCE
이 페이지에서는 처음 가져오기와 연결 확인을 진행합니다. DNS, On Demand, Log, Proxy 포트와 동기화 등의 설정은 목적에 따라 하나씩 조정하고 복원 가능한 구성을 보존해야 합니다.
이 가이드는 보유한 정보를 사용하는 방법만 설명하며 서버를 제공하지 않습니다. 구독 권한과 서비스 상태는 본인이 이용하는 서비스 계정 정보를 기준으로 확인해야 합니다.