Add Server: 서버 추가 및 구독 가져오기
완료 기준: Home의 SERVER에 선택할 수 있는 서버 항목이 표시됩니다.
Shadowrocket을 열고 Home에 머문 상태에서 Add Server 또는 화면의 추가 버튼을 찾습니다. 정보를 준비할 때는 구독 링크와 단일 서버 정보를 구분하세요. 구독 링크로 서버 여러 대를 한 번에 가져올 수 있으며, 단일 서버 정보는 항목별로 입력해야 합니다. 두 정보는 서로 다릅니다. 구독 링크를 Host에 입력하거나 서버 주소를 구독 주소로 제출하지 마세요.
기존 구독이 있다면 Subscribe 선택
Add Server에서 Type을 열고 Subscribe를 선택한 다음, 본인의 서비스 제공업체에서 받은 전체 구독 링크를 URL에 입력합니다. 메모를 추가할 경우 출처를 알아보기 쉬운 이름을 사용하세요. 붙여넣은 뒤 링크 앞뒤에 공백이나 줄 바꿈이 없는지, 문자가 빠지지 않았는지 확인하고 저장한 후 내용을 가져올 때까지 기다립니다. 링크의 인증 정보는 비밀 정보이므로 공개 게시판에 올리거나 공유용 스크린샷에 포함하지 마세요.
저장한 뒤 Home으로 돌아가 해당 그룹에 서버가 표시되는지 확인합니다. 구독 이름만 있고 서버 항목이 없다면 가져오기가 완료된 것이 아닙니다. 화면 안내를 확인하고 구독 내용을 제대로 가져왔는지 점검하세요. 기존 항목을 새로 고치려면 해당 구독 그룹의 업데이트 기능을 사용하고 완료 후 항목이 변경되었는지 확인합니다. 구독 업데이트와 앱 업데이트는 다릅니다. 전자는 본인의 구독 내용을 다시 불러오고, 후자는 App Store에서 진행합니다.
직접 추가: Type에 맞춰 항목 확인
단일 서버 정보를 보유한 경우 Type에서 정보에 표시된 프로토콜을 선택한 다음 Host, Port 및 인증 항목을 입력합니다. 스크린샷에는 Password와 Method가 포함된 양식이 나와 있습니다. 프로토콜에 따라 필요한 항목이 다를 수 있으므로 스크린샷에 없는 값을 임의로 입력하지 마세요. 주소에는 일반적으로 서비스 제공업체가 안내한 도메인이나 IP를 입력하고, 포트에는 해당 숫자를 입력합니다. 암호화 방식과 인증 정보도 하나씩 정확히 확인하세요.
사용할 수 있는 QR 코드가 있다면 Scan QR Code로 읽은 뒤 인식된 프로토콜과 항목을 확인할 수 있습니다. Import from Cloud JSON은 별도의 가져오기 기능이며, 임의의 텍스트를 읽을 수 있다는 뜻은 아닙니다. 저장하기 전에 정보 형식과 가져오기 기능이 맞는지 확인하세요. 항목의 의미를 모르겠다면 먼저 용어집을 확인하세요. 프로토콜 매개변수에 대한 자세한 내용은 프로토콜 참고에서 확인할 수 있습니다. 값을 계속 추측해 입력하며 연결을 시도하지 마세요.
추가가 끝나면 SERVER에서 테스트할 항목을 선택하고 선택 표시가 대상 서버 옆에 있는지 확인합니다. 이때 다른 서버를 한꺼번에 수정하거나 On Demand를 서둘러 켜지 마세요. 다음 단계에서 요청을 어떤 라우팅 방식으로 처리할지 먼저 정합니다.
Global Routing: 라우팅 방식 선택
완료 기준: 현재 라우팅 방식과 구성 파일의 규칙을 사용하는지 파악합니다.
Home으로 돌아가 Global Routing을 엽니다. 여기서는 연결 요청의 전반적인 처리 방식을 정하며 서버 프로토콜을 선택하지 않습니다. 세 가지 방식을 기억하세요: Config/Proxy/Direct. 사이트별로 구성에 설정된 규칙을 적용하려면 Config를 선택합니다. 선택한 서버가 프록시 요청을 처리하는지 확인하려면 Proxy를 임시로 사용할 수 있습니다. Direct는 직접 연결 방식이며 선택한 프록시 서버를 사용한다는 뜻이 아닙니다.
Config는 현재 활성화된 구성 파일을 함께 확인해야 합니다. Config 페이지를 열어 실제로 사용 중인 파일을 확인한 다음 Rule을 살펴보세요. 구독을 가져왔다고 해서 필요한 규칙까지 준비된 것은 아닙니다. 구독의 서버 항목과 구성 파일은 역할이 다릅니다. 전자는 연결 대상과 매개변수를 제공하고, 후자는 요청에 적용할 정책을 정합니다.
기존 Rule을 먼저 확인한 뒤 수정 여부 결정
공식 스크린샷의 구성 편집 화면에는 General, Rule, Hosts 등의 섹션과 Add Rule이 표시됩니다. 처음 사용할 때는 Rule부터 확인하고 모든 섹션을 한꺼번에 변경할 필요는 없습니다. 특히 URL Rewrite와 HTTPS Decryption은 기본 연결에 필요한 단계가 아닙니다. 연결됨으로 표시되게 하려고 임의로 켜거나 내용을 추가하지 마세요.
규칙은 순서대로 적용되므로 결과를 판단할 때 규칙 위치와 최종 정책을 함께 확인해야 합니다. 아래 두 줄은 ‘지정한 도메인은 프록시로, 나머지는 직접 연결’하는 방식을 설명하기 위한 예시입니다. example.com은 설명용 도메인이며 실제로 접속해야 하는 서비스 주소가 아닙니다. 기존 구성이 적절하다면 먼저 그대로 두고 확인하세요. 예시를 기존 규칙에 그대로 덮어쓰지 마세요.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
DOMAIN-SUFFIX는 여기서 도메인 접미사를 기준으로 일치하며, PROXY는 프록시 정책을 지정하고 FINAL은 앞선 규칙이 모두 일치하지 않을 때 적용되는 기본 정책입니다. Config를 선택했더라도 대상에 DIRECT가 적용되면 상단 연결 스위치가 켜져 있다는 이유만으로 프록시를 사용하지 않습니다. 문제를 점검할 때는 Proxy로 임시 전환해 같은 대상의 결과를 비교할 수 있습니다. 비교를 마친 뒤에는 원래 라우팅 방식으로 되돌려 테스트 설정을 계속 사용하지 않도록 하세요.
이 단계에서는 올바른 라우팅 방식을 선택하고 현재 구성이 어디에서 왔는지 파악하면 됩니다. 규칙 키워드는 용어집에서 확인할 수 있습니다. 프로토콜 매개변수, 전송 설정 및 라우팅 규칙을 구분하려면 프로토콜 참고를 읽어보세요. 다음으로 Home으로 돌아가 앞서 선택한 서버에 연결합니다.
Home: 연결 및 시스템 승인
완료 기준: 시스템에서 VPN 구성을 허용했고 앱 연결 상태가 예상과 일치합니다.
Home으로 돌아와 SERVER에서 현재 선택된 서버를 확인한 다음 Global Routing이 방금 선택한 방식인지 점검합니다. 서버를 추가했다고 자동으로 선택되는 것은 아닙니다. 그룹이 여러 개라면 목록 맨 위의 이름만 보지 말고 선택 표시로 대상 서버를 확인하세요. 두 항목을 확인한 뒤 화면 상단의 연결 스위치를 켭니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 방금 연 Shadowrocket에서 요청한 작업인지 확인한 뒤 시스템 안내에 따라 허용하고 기기 암호, Face ID 또는 Touch ID 인증을 완료하세요. 이 절차는 앱이 시스템 네트워크 확장 기능으로 트래픽을 처리하도록 허용합니다. 서버 인증을 대신하거나 구독 및 암호를 자동으로 입력해 주지는 않습니다. 시스템 승인을 완료했다고 원격 서버까지 인증된 것은 아닙니다.
승인을 거부했다면 안내 다시 표시하기
이전에 시스템 안내를 취소했다면 앱으로 돌아와 연결을 다시 시도하고 시스템에서 확인을 요청하는지 살펴보세요. 그래도 연결을 켤 수 없다면 시스템 설정의 VPN 관련 화면에서 구성 상태를 확인합니다. 설정 위치는 시스템 버전에 따라 달라질 수 있으므로 시스템 설정 검색을 이용하세요. 특정 구성의 용도를 모른다면 먼저 어느 앱에 속하는지 확인하여 사용 중인 다른 구성은 삭제하지 않도록 주의하세요.
승인 후 Home으로 돌아와 상단에 Not Connected가 계속 표시되는지, 스위치가 켜진 상태인지 확인합니다. 스위치가 곧바로 꺼진다면 빠르게 여러 번 누르지 말고 앱에 표시된 오류나 시스템 권한 문제를 먼저 해결하세요. 한 번 조작한 뒤 상태가 안정될 때까지 기다리고 오류 안내의 핵심 문구를 기록해 두면 실패한 단계를 파악하기 쉽습니다.
스크린샷의 Home에는 Global Routing, Connectivity Test, SERVER가 함께 표시되어 각 메뉴의 위치를 확인할 수 있습니다. 상태 전환에 성공했다는 것은 로컬 연결 절차가 시작되었다는 뜻일 뿐, 모든 사이트에 접속할 수 있거나 요청에 예상한 규칙이 적용되었다는 의미는 아닙니다. 이 단계를 마친 뒤 테스트를 실행하고 실제 대상에 접속해야 설정이 목적에 맞는지 판단할 수 있습니다.
처음 확인하는 동안 기기 네트워크를 가능한 한 안정적으로 유지하고 Wi-Fi, 셀룰러 네트워크 및 여러 서버를 동시에 바꾸지 마세요. 네트워크 전환 후 문제가 생겼다면 전환 전후 상태를 기록한 뒤 각각 따로 다시 시도합니다. On Demand는 조건에 따라 연결을 시작하는 기능입니다. 수동 연결, 연결 해제 및 재연결을 모두 확인한 뒤 필요에 맞게 설정하세요.
Connectivity Test: 작동 여부 확인
완료 기준: 테스트 결과, 실제 접속 및 규칙 정책을 함께 살펴 결과를 설명할 수 있습니다.
Home에서 Connectivity Test를 실행해 연결 상태를 확인합니다. 테스트 전에 서버와 라우팅 방식을 확인하지 않으면 다른 연결에 대한 결과일 수 있습니다. 테스트 방식마다 확인하는 대상이 다르므로 결과를 해석할 때는 Settings의 Test Method를 함께 확인하세요. 한 번 통과했다고 모든 대상에 접속할 수 있는 것은 아니며, 한 번 실패했다고 구독의 서버가 모두 작동하지 않는다고 단정해서도 안 됩니다.
이어서 브라우저를 열고 원래 접속하려던 페이지를 방문해 새 요청을 보냅니다. 이미 로드된 페이지의 내용만 보거나 캐시된 정보만으로 연결이 유효한지 판단하지 마세요. 페이지에 이전 내용이 표시되면 새로고침하거나 같은 사이트의 다른 페이지를 열어보세요. 확인할 때는 대상 하나를 명확히 정해 접속 시각과 앱의 연결 기록을 비교하기 쉽게 합니다.
연결 상태와 규칙 적용 결과를 나눠 확인
Config를 사용 중이라면 앱의 연결 기록에서 방금 보낸 요청을 찾아 대상 도메인, 일치한 규칙 및 최종 정책을 확인합니다. 프록시를 사용해야 하는데 DIRECT가 적용되었다면 규칙 순서와 현재 활성화된 구성을 먼저 점검하세요. PROXY가 적용됐는데 접속에 실패했다면 선택한 서버와 대상 서비스를 확인합니다. 기록을 확인하는 메뉴 위치는 실제 화면을 기준으로 찾으세요. Data의 트래픽 통계는 활동을 파악하는 데 참고할 수 있지만 트래픽이 늘었다고 특정 도메인에 어떤 정책이 적용됐는지 알 수 있는 것은 아닙니다.
같은 서버, 기기 네트워크 및 대상을 유지하고 Global Routing만 Config에서 Proxy로 임시 변경한 뒤 새 요청을 보내면 원인을 좁히는 데 도움이 됩니다. 두 번째 방식에서 접속할 수 있다면 규칙이나 구성 차이를 더 확인해야 합니다. 두 방식 모두 실패하면 서버 매개변수, 인증 정보 및 대상의 응답을 점검하세요. 비교를 마친 뒤 원래 라우팅 방식으로 되돌립니다.
직접 연결해야 하는 대상도 확인해야 합니다. 규칙을 나누는 목적은 모든 요청을 프록시로 보내는 것이 아니라 각 요청에 예상한 정책을 적용하는 것입니다. 테스트 하나, 실제 접속 대상 하나 및 해당 기록을 확인한 뒤 현재 사용할 수 있는 서버와 구성 이름을 기록하면 됩니다. 한 번의 테스트 결과를 높이려는 목적으로 정상 작동하는 설정을 반복해서 바꾸지 마세요.
Settings: 단계별 문제 해결
완료 기준: 어느 단계에서 문제가 생겼는지 설명하고 해당 단계와 관련된 설정만 변경할 수 있습니다.
문제가 생기면 먼저 증상을 구체적인 단계로 나눕니다. 구독을 읽지 못함, 서버 추가 후 연결할 수 없음, 연결은 켜졌지만 요청 실패, 특정 대상만 이상한 경우가 있습니다. 구독 삭제, 구성 교체, DNS 조정 및 프로토콜 매개변수 변경을 한꺼번에 하지 마세요. 현재 구성을 유지한 채 한 번에 하나만 바꾸고 네 번째 단계의 확인을 반복해야 어떤 변경이 영향을 줬는지 알 수 있습니다.
구독이 비어 있거나 업데이트에 실패함
먼저 기기 자체가 인터넷에 연결되는지 확인한 다음 구독 링크가 완전한지, 특히 복사 과정에서 인증 정보가 빠지지 않았는지 살펴보세요. 기존 구독이 만료되었거나 내용이 비어 있다면 본인의 서비스 제공업체에 유효 상태와 지원 형식을 확인하세요. 같은 구독을 반복해서 추가해도 가져오기 오류가 해결되지는 않으며 구분하기 어려운 그룹만 늘어날 수 있습니다. 업데이트 후에는 구독 이름이 목록에 남아 있는지만 보지 말고 서버 항목이 실제로 바뀌었는지 확인하세요.
스위치가 켜진 상태로 유지되지 않음
먼저 시스템에서 VPN 구성을 허용했는지 확인한 다음 유효한 서버 항목이 선택되어 있는지 살펴보세요. 앱에 매개변수 오류가 표시되면 Add Server로 돌아가 원본 정보를 기준으로 Type, Host, Port 및 인증 정보를 확인합니다. 일부 프로토콜에는 전송 또는 TLS 관련 항목도 있습니다. 제공된 정보에 따라 입력하고 이름이 비슷하다는 이유로 서로 바꾸지 마세요. 항목 간 관계를 이해하려면 프로토콜 참고를 읽은 뒤 조정하세요.
연결은 켜졌지만 예상대로 접속되지 않음
먼저 Global Routing을 확인합니다. Direct는 선택한 프록시 서버를 사용하지 않습니다. Config에서는 규칙에 따라 대상이 직접 연결 또는 차단 정책으로 분류될 수 있습니다. 기록에 REJECT가 표시되면 서버를 바로 바꾸기보다 의도한 차단인지 규칙 범위가 지나치게 넓은지 확인하세요. 일부 도메인만 실패한다면 도메인 확인, 규칙 적용 및 대상 응답을 각각 점검합니다. 페이지 하나에 문제가 있다고 전체 구성을 초기화하지 마세요.
Settings를 열어 Test Method와 Diagnostics를 확인하고 이용 가능한 진단 정보로 실패한 단계를 살펴봅니다. 화면의 Proxy, TCP, UDP 등은 각각 용도가 있으며 모두 같은 ‘수정 스위치’가 아닙니다. 어떤 설정이 무엇을 바꾸는지 모른다면 현재 값을 유지하고 의미를 확인한 뒤 시도하세요. 처음부터 모든 설정을 하나씩 바꿔볼 필요는 없습니다.
문제를 문의하기 전에 재현 조건 정리
기기의 네트워크 유형, 현재 라우팅 방식, 문제가 모든 대상에 발생하는지 여부, 테스트 방식 및 오류 안내의 핵심 문구를 기록합니다. 스크린샷이나 진단 내용을 공유하기 전에 구독 링크, 서버 인증 정보 및 기타 개인 정보를 가리고 문제 파악에 필요한 정보만 남기세요. 같은 대상을 수정 전후로 비교한 결과는 단순히 ‘연결되지 않음’이라고 설명하는 것보다 판단에 도움이 됩니다.
수동 연결과 실제 접속이 안정된 뒤 On Demand나 세부 규칙 설정을 검토하세요. 이후 구독을 업데이트하거나 구성을 교체하거나 라우팅을 변경할 때도 ‘항목 확인 → 라우팅 방식 확인 → 연결 → 요청 확인’ 순서를 따르면 됩니다. 화면 용어는 용어집에서 확인하세요. 구입, 재설치 및 구입 항목 복원 문제는 App Store 구입 항목 복원 안내를 참고하고 연결 매개변수 문제와 구분하세요.