[Quickstart]공식 매뉴얼
Shadowrocket 빠른 시작
기존 구독 또는 서버 정보에서 시작해 가져오기, Global Routing 선택, 연결 및 확인을 순서대로 진행합니다. 먼저 연결 하나가 작동하는지 확인한 다음 규칙과 기타 설정을 조정하세요.
[Subscribe]
01 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 먼저 Home으로 돌아갑니다. 여기에서 서버 항목을 확인하고 선택할 수 있습니다. Config는 구성 파일을 관리하는 곳으로, 두 메뉴의 용도는 다릅니다. 처음 사용한다면 기존 연결 정보를 먼저 Home에 추가하세요. 서버 목록을 표시하기 위해 규칙 파일을 찾을 필요는 없습니다. 구독 링크는 일반 웹사이트 주소가 아닙니다. 보통 서비스 구성에 필요한 인증 정보가 포함되므로 공개된 토론 공간에 공유해서는 안 됩니다.
기존 구독 링크가 있는 경우: Subscribe 선택
Home에서 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동합니다. Type을 누르고 Subscribe를 선택한 다음, URL 칸에 본인의 서비스 제공자로부터 받은 전체 구독 링크를 붙여 넣습니다. 붙여 넣기 전후로 링크의 시작과 끝이 온전한지, 공백이나 줄 바꿈 또는 채팅 메시지의 설명 문구가 섞이지 않았는지 확인합니다. 메모에 알아보기 쉬운 이름을 입력한 뒤 오른쪽 위의 완료 버튼을 눌러 저장할 수 있습니다.
Home으로 돌아와 구독 내용이 다운로드될 때까지 기다립니다. 정상적으로 가져오면 해당 그룹에 서버 항목이 표시됩니다. 그룹 이름은 관리용 표시일 뿐, 연결되었다는 뜻은 아닙니다. 그룹 안에서 항목 하나를 선택해야 합니다. 그룹 이름만 보이고 서버가 없다면 구독 업데이트 오류를 먼저 확인하세요. 같은 링크를 반복해서 추가해도 해결되지 않습니다. 구독을 사용하려면 유효한 계정이나 접속 조건을 충족하는 네트워크가 필요할 수 있습니다. 구체적인 상태는 본인이 보유한 서비스 계정 정보를 기준으로 확인하세요.
서버 공유 정보 하나만 받은 경우에는 구독 링크와 다를 수 있습니다. 주소 길이만으로 두 가지를 구분할 수 없으므로 제공자가 안내한 용도를 먼저 확인하세요. 단일 서버 정보를 Subscribe에 입력하거나 구독 주소를 서버 호스트 이름으로 입력하면 가져오기 오류가 발생합니다. 구분하기 어렵다면 먼저용어집의 구독 및 구성 설명을 확인하고, 알 수 없는 링크를 모든 입력 칸에 차례로 넣어 보지 마세요.
기존 서버 매개변수가 있는 경우: Add Server에서 직접 입력
서버 매개변수를 받았다면 Add Server의 Type에서 원본 정보에 표시된 프로토콜을 선택한 다음 서버 주소, 포트 및 인증 정보를 입력합니다. Shadowsocks, VMess, VLESS, Trojan 등 프로토콜마다 필요한 필드가 다르므로 한 프로토콜의 비밀번호나 ID 필드를 다른 프로토콜에 그대로 적용할 수 없습니다. TLS, SNI, 전송 방식 및 경로도 추측하지 말고 원본 정보와 항목별로 대조하세요.
저장한 뒤 Home으로 돌아와 목록에 항목이 표시되는지 확인하고 사용할 서버를 선택합니다. 아직 연결을 켜지 마세요. 다음 단계에서 Global Routing을 명확히 설정해야 이후 테스트 결과를 특정 트래픽 처리 모드와 연결해 판단할 수 있습니다. 구독에 여러 항목이 있다면 처음에는 하나만 선택해 확인하세요. 서버와 라우팅 방식을 동시에 바꾸면 문제의 원인을 구분하기 어렵습니다.
[Rule]
02 Global Routing 선택
Home에서 Global Routing을 누르고 현재 선택된 모드를 확인합니다. 여기에는 Config, Proxy, Direct 세 가지 모드가 있습니다. 각 모드는 요청을 정책에 따라 처리하는 방식을 결정합니다. 서버 매개변수를 보완하거나 만료된 인증 정보를 복구하는 기능은 아닙니다. 전환하기 전에 기존 선택 항목을 기억해 두면 테스트 후 되돌리기 쉽습니다.
Config는 현재 활성화된 구성 파일의 규칙에 따라 요청을 처리합니다. Config를 열어 실제 선택된 파일을 확인하세요. 파일이 존재하는지만 확인해서는 충분하지 않습니다. 파일 내 규칙은 일반적으로 순서대로 일치 여부를 확인하며, 요청이 규칙에 일치하면 지정된 정책에 따라 처리됩니다. 특정 도메인에 직접 접속할 수 있다고 해서 프록시 서버가 작동한다고 판단할 수는 없습니다. 해당 요청이 프록시를 거치지 않았을 수도 있습니다.
Proxy는 규칙의 영향을 일단 배제하고 해당 트래픽을 프록시 모드로 처리해 확인하는 데 사용할 수 있습니다. 처음 테스트할 때는 Proxy를 선택한 다음 Home으로 돌아와 서버가 선택되어 있는지 확인하세요. 관찰하기 쉬운 테스트 조건을 만드는 것이 목적이며, 이 모드를 계속 사용해야 한다는 뜻은 아닙니다. 시스템 트래픽 범위, 앱 자체 동작 및 네트워크 상태도 결과에 영향을 줍니다.
Direct는 직접 접속에 사용하며 프록시 서버가 정상인지 확인하는 데는 적합하지 않습니다. 연결을 켠 뒤 접속 결과가 연결 전과 같다면 비밀번호를 다시 입력하기 전에 Direct가 선택되어 있는지 확인하세요. Direct는 비교 조건으로 활용할 수도 있습니다. 원래 직접 접속할 수 있었던 웹사이트에 다른 모드에서 추가 문제가 발생하는지 확인할 수 있습니다.
Proxy에서 실제 접속이 정상임을 확인한 뒤 Config로 이동해 본인이 보유하고 출처를 아는 구성 파일을 선택하고, Global Routing을 Config로 전환합니다. 출처를 모르는 규칙을 통째로 현재 구성에 덮어쓰거나 모든 테스트를 통과시키기 위해 DNS를 임의로 조정하지 마세요. 규칙 순서, DNS 및 On Demand의 자세한 관계는Settings 설정 항목 참고에서 확인할 수 있습니다. 이 페이지에서는 기본적인 연결 확인 절차를 완료합니다.
[Connect]
03 연결을 켜고 권한 승인
Home으로 돌아와 선택 표시가 테스트할 서버에 있는지 다시 확인하고 Global Routing이 이전 단계와 동일한지 확인합니다. 그런 다음 상단 연결 스위치를 켭니다. 처음 연결을 설정할 때 iPhone / iPad에 VPN 구성을 추가하라는 시스템 메시지가 표시될 수 있습니다. Shadowrocket에서 방금 시작한 작업인지 확인한 뒤 시스템 안내에 따라 허용하고 기기에서 요구하는 인증을 완료합니다.
시스템 권한 승인은 클라이언트가 해당 네트워크 연결을 설정하도록 허용하는 절차입니다. 서비스를 구매하거나 서버 계정을 자동으로 만드는 절차가 아닙니다. 취소를 선택했다면 Home으로 돌아와 스위치 상태를 확인하세요. 연결이 필요한 경우 다시 요청하면 됩니다. 조직에서 관리하는 기기는 관련 설정이 관리 정책의 제한을 받을 수 있습니다. 이 경우 시스템 설정을 반복해서 삭제하지 말고 기기 관리자에게 권한을 확인하도록 요청하세요.
승인 후 Home으로 돌아와 스위치가 켜진 상태를 유지하는지, 클라이언트에 연결됨 상태가 표시되는지 확인합니다. 시스템 상태 막대나 제어 센터에도 VPN 상태가 표시될 수 있지만 기기에 따라 표시 위치는 다릅니다. 작은 아이콘 하나만으로 판단하지 마세요. 연결 유지 상태, 실제 접속 및 요청 기록을 함께 확인해야 합니다. VPN 채널이 설정되었다는 것은 시스템 연결 단계가 완료되었다는 뜻일 뿐, 원격 서비스가 반드시 작동한다는 의미는 아닙니다.
스위치를 켜자마자 꺼지거나 시스템에서 즉시 오류가 표시되면 오류 문구를 먼저 기록합니다. 다른 VPN 연결이 사용 중인지, 시스템 권한 승인이 완료되었는지, 현재 구성에 명백한 오류가 있는지 확인하세요. 처음 문제를 확인하는 동안에는 On Demand와 같은 자동 연결 조건을 잠시 사용하지 마세요. 수동으로 꺼도 자동으로 다시 연결되어 현재 상태를 판단하기 어려울 수 있습니다. 항목 하나를 수정한 뒤 다시 연결하고, 스위치를 빠르게 반복해서 켜고 끄지 마세요.
나중에 서버, 네트워크 또는 주요 매개변수를 변경할 때는 먼저 연결을 끄고 수정한 다음 다시 켜서 다음 단계의 확인을 진행할 수 있습니다. 홈 화면으로 나간다고 연결이 끊어지는 것은 아닙니다. 더 이상 필요하지 않을 때는 Home으로 돌아와 직접 연결을 끄고 상태가 변경되었는지 확인하세요. 이전 연결 결과를 현재 매개변수의 테스트 결과로 잘못 판단하는 일도 방지할 수 있습니다.
[Test]
04 연결이 작동하는지 확인
Home에서 Connectivity Test를 사용해 기본 상태를 확인합니다. 현재 서버에 명백한 연결 문제가 있는지 확인하는 데 도움이 되지만, 테스트 대상과 방식이 평소 사용하는 앱과 같지는 않을 수 있습니다. 테스트 결과가 표시되어도 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 테스트가 실패하면 구체적인 오류와 실제 접속 결과를 함께 살펴보세요. 한 번의 결과만으로 전체 구성을 삭제해서는 안 됩니다.
이어서 브라우저를 열고 본인이 접속 권한을 가진, 로딩 완료 여부를 명확히 확인할 수 있는 웹사이트에 접속합니다. 이전에 표시된 콘텐츠를 새로 받은 것으로 착각하지 않도록 테스트 중 페이지를 새로고침하세요. 로그인이 필요하거나 양식 제출 또는 실시간 기능을 사용하는 경우에는 해당 작업도 각각 확인해야 합니다. 페이지 본문이 로드되었다고 해서 참조된 모든 도메인이 올바른 정책으로 처리된다는 뜻은 아닙니다.
Config를 사용하는 경우 예상한 라우팅 결과도 확인해야 합니다. PROXY로 처리되어야 하는 테스트 도메인의 예를 들면, 먼저 구성에서 해당 규칙을 찾은 다음 연결 상태나 로그를 확인해 실제 처리 방식을 살펴봅니다. DIRECT 규칙에 일치했다면 서버 문제로 단정하지 말고 더 앞에 있는 규칙이 먼저 일치하는지 확인하세요. 규칙 키워드의 의미는용어집에서, 구체적인 설정은설정 참고에서 확인할 수 있습니다.
Proxy에서는 접속할 수 있지만 Config에서는 실패한다면 현재 구성의 규칙, 정책 참조 및 DNS 설정을 먼저 확인해야 합니다. 두 모드 모두 실패한다면 서버 매개변수, 서비스 상태 및 현재 네트워크를 확인하세요. 특정 앱에서만 실패하는 경우 해당 앱의 로그인 상태, 캐시 또는 서비스 장애도 구분해야 합니다. 한 번에 조건 하나씩만 변경해야 전후 테스트를 의미 있게 비교할 수 있습니다.
마지막으로 실제 사용할 Wi-Fi와 셀룰러 네트워크에서 각각 다시 테스트합니다. 네트워크를 전환한 뒤 시스템이 안정될 때까지 기다리고 연결 상태와 선택된 서버를 확인하세요. 네트워크 전환 순간의 일시적인 실패를 지속적인 문제로 판단하지 마세요. 이 단계까지 완료하면 사용할 서버와 모드를 확인한 것이므로 기본 설정 절차가 끝납니다. 이후 자동 연결을 추가하거나 규칙을 변경하고 구성을 교체할 때는 이때 확인한 조건을 되돌아갈 기준으로 삼으세요.
[Troubleshoot]
05 문제가 발생한 단계별로 확인
처음부터 재설치하지 말고 “마지막으로 성공한 단계”부터 확인합니다. 현재 네트워크, 가져오기 방식, 프로토콜, 선택된 서버, Global Routing 및 오류 문구를 기록한 뒤 구독 다운로드, 연결 설정 또는 실제 접속 중 어느 단계에서 실패했는지 확인하세요. 반복 작업을 줄일 수 있고, 본인의 서비스 제공자에게 문의할 때도 구체적인 현상을 전달할 수 있습니다.
구독에 서버가 표시되지 않거나 업데이트 실패
URL이 온전한지, 구독이 아직 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 먼저 확인합니다. 서버 항목이 이미 있어도 다음 구독 업데이트가 반드시 성공하는 것은 아닙니다. 구독 다운로드와 서버 연결은 별개의 단계입니다. 기존 그룹은 그대로 두고 링크와 서비스 상태를 확인한 뒤 다시 업데이트하세요. 반복해서 삭제하고 다시 만들지 마세요. 인식 가능한 구성 내용이 아닌 웹페이지 설명만 받은 경우 원래 제공자에게 링크의 용도를 확인하세요.
Connectivity Test 실패
그룹을 펼치기만 한 것이 아니라 테스트할 서버가 실제로 선택되어 있는지 확인합니다. 직접 입력한 경우 프로토콜, 주소, 포트 및 인증 매개변수를 중점적으로 확인하세요. TLS 연결을 사용하는 경우 SNI 등 원본 요구사항도 확인합니다. 매개변수 문제를 숨기기 위해 Allow Insecure를 임의로 켜지 말고, 테스트를 통과시키려고 출처를 모르는 테스트 대상으로 바꾸지도 마세요. 기존 구독에 사용할 수 있는 다른 항목이 있다면 같은 네트워크와 모드에서 다른 항목을 선택해 다시 테스트할 수 있습니다.
스위치가 켜진 상태를 유지하지 못하거나 연결 후 접속 실패
스위치가 유지되지 않으면 시스템 승인, 다른 VPN 상태 및 명확한 오류부터 확인합니다. 스위치는 켜져 있지만 접속에 실패하면 먼저 Direct가 선택되어 있지 않은지 확인한 뒤 Proxy로 비교 테스트를 진행합니다. Proxy에서도 실패하면 서버 상태와 매개변수를 확인합니다. Proxy는 성공하고 Config만 실패한다면 현재 활성화된 Config 파일을 확인하세요. DNS, 프로토콜, 규칙 및 테스트 사이트를 동시에 변경하면 어떤 항목이 변화를 일으켰는지 알 수 없습니다.
일부 웹사이트만 실패하거나 네트워크 전환 후 실패
일부 웹사이트에 문제가 생기면 해당 도메인의 규칙 일치 여부, DNS 결과 및 대상 서비스 상태를 확인해야 합니다. 다른 웹사이트는 정상인지 먼저 확인한 뒤 범위를 좁히세요. Wi-Fi와 셀룰러 네트워크를 전환한 뒤 문제가 생기면 네트워크가 안정될 때까지 기다린 다음 다시 연결하고 동일한 대상으로 테스트합니다. 문제를 더 자세히 분류하려면자주 묻는 질문을 참고하세요. 기본 설정 단계에서 고급 설정을 한꺼번에 바꾸지 마세요.
문제를 확인한 뒤 “서버 선택 → Global Routing 확인 → 연결 켜기 → 실제 접속” 순서로 다시 테스트합니다. 복구된 것을 확인한 후 기존 설정을 하나씩 추가하세요. 구성을 백업하거나 장기적으로 관리하려면 설정 참고를 이어서 확인하세요. 처음 연결할 때 모든 기능을 한꺼번에 설정할 필요는 없습니다.