공식 안내서 · 사용 시작
Shadowrocket 사용법
구독 가져오기 및 연결 확인
기존 정보를 올바르게 가져온 뒤 라우팅 방식을 선택하고 연결합니다. 아래 다섯 단계를 따라 결과를 차례대로 확인하세요. 문제가 발생하면 해당 단계로 돌아가 점검하고, 여러 설정을 동시에 변경하지 마세요.
단계 01 · 선택 가능한 항목 준비
Add Server: 서버 추가 또는 구독 가져오기
Shadowrocket을 열고 Home 화면을 표시합니다. 이때 상단 연결 스위치를 켜지 말고 페이지 아래쪽에서 Add Server를 찾습니다. 필요한 정보는 보통 두 종류입니다. 하나는 단일 서버의 주소, 포트 및 인증 매개변수이고, 다른 하나는 서버 목록을 반환하는 구독 링크입니다. 두 정보는 입력 방식이 다릅니다. 구독 링크 전체를 Host에 입력하거나 서버 주소 하나만으로 나머지 매개변수를 추측하지 마세요.
단일 서버 정보가 있는 경우
Add Server를 누르고 먼저 Type을 확인한 뒤 해당 유형에 필요한 필드를 입력합니다. 스크린샷의 Host, Port, Password, Method는 해당 유형에 따른 필드 예시입니다. Type을 변경하면 표시되는 항목도 달라질 수 있습니다. Host에는 서버 도메인이나 주소를, Port에는 제공받은 포트를 입력합니다. Password와 Method는 기존 정보와 정확히 일치해야 합니다. 추가 인증, 전송 또는 TLS 관련 옵션이 있으면 원래 매개변수에 맞춰 입력하고, 스크린샷의 기본값을 본인의 연결 매개변수로 사용하지 마세요.
QR 코드가 있다면 화면의 Scan QR Code를 사용해 본인의 서버 정보를 읽을 수 있습니다. 읽기에 성공해도 Type, Host, Port를 확인한 뒤 저장하세요. Import from Cloud JSON은 해당 형식의 데이터 가져오기에 사용하며, 임의의 웹페이지나 구독 주소를 입력하는 범용 창이 아닙니다. 정보가 어떤 형식인지 알 수 없다면 여러 경로를 반복해서 시도해 중복 항목을 만들기 전에 정보 설명을 확인하세요.
구독 링크가 있는 경우
구독을 가져오려면 Add Server의 Type에서 Subscribe를 선택하고 URL 입력란에 본인의 전체 구독 링크를 붙여 넣은 뒤 저장합니다. 복사할 때 링크의 시작과 끝, 매개변수가 모두 포함되었는지 특히 주의하고 줄바꿈, 공백, 설명 문구가 섞이지 않게 하세요. 구독 링크에는 개인 액세스 정보가 포함될 수 있으므로 전체 링크를 공개 페이지에 올리지 말고, 도움을 요청할 때 인증 정보가 포함된 QR 코드를 보여주지 마세요.
저장한 다음 Home으로 돌아가 목록이 로드될 때까지 기다립니다. 새로고침이 필요하면 해당 구독을 업데이트합니다. 선택 가능한 서버 항목이 표시되어야 이 단계에서 목록을 가져온 것입니다. 구독 이름이 화면에 보인다고 해서 링크에서 유효한 데이터가 반환되었다는 뜻은 아닙니다. 업데이트에 실패하면 링크가 여전히 유효한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지, 로그인 페이지나 오류 메시지가 반환되는지 먼저 확인하세요. 가져오기 실패를 곧바로 연결 프로토콜 비호환으로 판단하지 마세요.
이 단계의 완료 기준: Home의 SERVER 영역에 본인의 서버가 표시되고 항목을 열어 예상한 유형과 주소를 확인할 수 있어야 합니다. 나중에 문제를 점검할 때 비교할 수 있도록 원래 구독이나 매개변수를 보관하세요. 이 단계에서 모든 항목을 한꺼번에 수정할 필요는 없습니다.
단계 02 · 요청 처리 방식 선택
Global Routing: 구성, 프록시 또는 직접 연결 선택
목록을 준비한 뒤 Home으로 돌아가 Global Routing을 엽니다. 여기서는 전체 라우팅 방식을 결정하며 서버를 추가하는 기능은 아닙니다. 세 가지 방식은 구성(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 각 방식의 차이를 이해한 뒤 이번 확인에 알맞은 항목을 선택하세요. 서버를 올바르게 추가했더라도 라우팅 방식이 예상과 다르면 결과를 잘못 판단할 수 있습니다.
구성(Config): 현재 파일의 규칙에 따라 처리
구성(Config)을 선택하면 요청은 현재 구성 파일의 규칙에 따라 처리되며, 일부는 PROXY를 사용하고 나머지는 DIRECT를 사용할 수 있습니다. Config로 이동해 실제로 선택된 파일을 확인한 다음 Rule을 살펴봅니다. 구성 파일의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 각각 용도가 다릅니다. 처음 사용할 때는 선택한 파일과 규칙만 확인하면 되며, 연결을 위해 모든 섹션을 일일이 수정할 필요는 없습니다.
구독과 구성 파일은 서로 다른 종류의 콘텐츠입니다. 구독은 보통 서버 목록을 제공하고, 구성 파일은 분할 라우팅 등의 동작을 정의합니다. 구독을 가져왔다고 해서 본인에게 적합한 규칙 파일이 자동으로 선택되는 것은 아닙니다. 마찬가지로 Config에 파일이 표시되어도 그 안에서 참조하는 정책이 현재 환경에서 모두 유효하다는 뜻은 아닙니다. 처음에는 이해하고 있는 구성을 사용하고, 수정하기 전에 원본 파일을 보관해 복구할 수 있도록 하세요.
프록시(Proxy)와 직접 연결(Direct): 현재 경로를 구분해 확인
프록시(Proxy)는 점검 중 선택한 프록시 서버를 통해 요청을 처리할 수 있는지 확인할 때 유용합니다. 직접 연결(Direct)은 직접 접속한 결과를 확인합니다. 두 방식은 단순히 “더 빠른” 또는 “더 안정적인” 설정 단계가 아닙니다. 실제 결과는 현재 네트워크, 서버 및 접속 대상에 따라 달라집니다. Global Routing만으로 모든 시스템 트래픽의 경로를 확정할 수도 없으므로 실제 요청 결과를 함께 확인해야 합니다.
명확한 규칙 파일이 있다면 일상적으로 구성(Config)을 선택할 수 있습니다. 서버 연결 문제와 규칙 문제를 구분하고 싶다면 동일한 대상을 프록시(Proxy)로 잠시 전환해 비교 테스트한 뒤 기존 선택으로 되돌리세요. 한 번의 테스트에서 서버를 바꾸고 방식을 전환하며 DNS까지 수정하지 마세요. 결과가 달라져도 어떤 설정이 영향을 줬는지 판단하기 어렵습니다.
이 단계의 완료 기준: 현재 Global Routing에서 무엇을 선택했는지 설명할 수 있어야 합니다. 구성(Config)을 선택했다면 현재 사용하는 구성 파일도 알고 있어야 합니다. 규칙 문법을 자세히 익히려면 규칙 키워드 일치 안내를 참고하세요. 이 페이지에서는 먼저 연결 과정을 완료합니다.
단계 03 · 연결 설정
Home: 서버를 선택한 다음 상단 스위치 켜기
가져오기와 라우팅 선택을 마쳤으면 Home으로 돌아갑니다. SERVER 영역에서 이번에 사용할 서버를 선택하고 선택 표시가 대상 항목에 있는지 확인하세요. 구독 그룹이 여러 개라면 이름이 비슷하지만 매개변수가 다른 이전 항목을 선택하지 않도록 먼저 그룹을 확인합니다. 그런 다음 Global Routing을 다시 확인해 이전 단계에서 정한 방식이 그대로인지 살펴봅니다.
이제 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 요청이 표시될 수 있습니다. 요청을 시작한 앱이 Shadowrocket인지 확인한 다음 시스템 안내에 따라 승인하세요. 시스템에서 기기 인증을 요청하면 시스템 화면에서 직접 완료합니다. 여기서 필요한 것은 기기 자체의 권한이며, 기기 암호를 서버 필드에 입력할 필요는 없습니다. 이전에 요청을 거부했다면 다시 연결을 시작하고 시스템에 표시되는 구체적인 안내를 확인하세요.
앱으로 돌아와 상단 상태가 Not Connected에서 변경되는지, 오류 메시지가 표시되는지 확인합니다. 스위치가 잠시 켜졌는지만 보지 마세요. 스위치가 바로 꺼지거나 연결 중 상태가 계속되거나 연결된 것으로 표시되는데 접속이 되지 않는 것은 서로 다른 단계의 문제이므로 각각 기록해야 합니다. 시스템에 VPN 상태가 표시되면 관련 연결 구성이 작동한다는 뜻이지만, 모든 요청이 예상한 대로 대상 서버를 통과한다고 단정할 수는 없습니다.
연결 중에는 시스템 VPN 구성을 변경할 수 있는 다른 연결 작업을 일시 중지해 테스트 환경을 단순하게 유지하세요. 서버를 바꿔야 한다면 먼저 연결을 중지하고 새 항목이 선택되었는지 확인한 다음 다시 연결하는 편이 현상을 서버와 연결해 파악하기 쉽습니다. 처음 확인할 때는 On Demand를 설정하지 않아도 됩니다. 수동 스위치 결과가 안정된 뒤 자동 연결 조건을 사용할지 결정하세요.
이 단계의 완료 기준: 대상 서버가 선택되어 있고 상단 연결 상태가 유지되며 권한 또는 연결 오류가 반복해서 표시되지 않아야 합니다. 상태가 정상이어도 다음 단계에서 실제로 확인하세요. 연결이 설정되었다는 사실과 대상 페이지에 접속할 수 있다는 사실은 서로 다른 결론입니다.
단계 04 · 상태와 결과를 따로 확인
Connectivity Test: 테스트 결과 및 실제 접속 확인
Home에서 Connectivity Test를 찾아 테스트를 실행하고 결과가 나올 때까지 기다립니다. 목록에 있는 항목의 응답 상태를 확인하는 데 도움이 되지만, 결과는 선택한 테스트 방법, 테스트 대상 및 현재 네트워크에 따라 달라집니다. 특정 항목이 응답한다고 해서 모든 웹사이트나 앱이 정상 작동한다는 뜻은 아닙니다. 테스트 한 번에 실패했다고 서버의 모든 기능을 사용할 수 없다고 단정할 수도 없습니다. 먼저 현상을 기록한 뒤 실제 접속 결과를 함께 판단하세요.
기본 네트워크를 확인한 뒤 대상 요청 확인
브라우저를 열어 평소 정상적으로 접속할 수 있는 페이지로 기기가 실제로 인터넷에 연결되어 있는지 확인합니다. 로그인이 필요하거나 이용 약관 동의가 필요한 Wi-Fi라면 먼저 해당 네트워크의 인증 절차를 완료하세요. 그런 다음 연결 상태에서 확인하려는 페이지를 열고 캐시된 제목이나 이전 콘텐츠만 표시되는 것이 아니라 주요 콘텐츠가 로드될 때까지 기다립니다. 필요한 경우 페이지를 새로고침하고 이미지, 로그인 또는 특정 하위 페이지에만 문제가 있는지 살펴보세요.
구성(Config)을 사용하는 경우 같은 페이지에서도 여러 도메인 요청이 발생하고 요청마다 서로 다른 규칙이 적용될 수 있습니다. 따라서 한 페이지가 열린다는 이유만으로 모든 트래픽이 PROXY를 사용한다고 판단하거나, 특정 페이지가 실패했다는 이유만으로 클라이언트가 전혀 연결되지 않았다고 판단해서는 안 됩니다. 분할 라우팅을 확인하려면 앱에서 확인할 수 있는 요청 기록을 통해 대상, 일치 규칙 및 사용 정책을 살펴보고 현재 Rule의 예상 동작과 결과가 일치하는지 확인하세요.
한 번에 하나씩 비교
결과가 불분명하다면 같은 대상과 같은 서버를 유지하고 조건 하나만 바꿉니다. 예를 들어 현재 네트워크에서 직접 연결(Direct)과 프록시(Proxy) 결과를 각각 확인하거나 구성(Config)을 그대로 두고 본인이 보유한 서버 하나만 바꿔 볼 수 있습니다. 매번 현재 방식과 실제 현상을 기록하고 테스트 후 일상 설정으로 복원하세요. 여러 페이지를 동시에 열거나 업데이트를 연속으로 누르고 스위치를 빠르게 전환하면 결과를 구분하기 어렵습니다.
이 단계의 완료 기준: “연결 상태 유지”, “실제 대상 접속 가능”, “라우팅 동작이 예상과 일치”하는 세 가지를 모두 확인할 수 있어야 합니다. 이 중 하나만 충족된다면 다음 절에서 해당 실패 단계에 따라 계속 점검하세요. 모든 구성을 삭제하고 처음부터 다시 시작할 필요는 없습니다.
단계 05 · 가장 먼저 실패한 지점으로 돌아가기
Settings 및 일반적인 문제 해결
문제 해결은 “예상과 달라진 지점이 처음 어디였는지” 확인하는 것부터 시작합니다. 가져온 뒤 서버가 표시되지 않는 경우, 테스트가 응답하지 않는 경우, 스위치가 유지되지 않는 경우, 연결 후 일부 페이지만 문제가 생기는 경우에는 확인 대상이 서로 다릅니다. 모든 설정을 바로 초기화하지 말고 이 안내서에서 해당하는 앵커로 돌아가 확인하세요. Settings의 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP는 추가 점검을 위한 항목입니다. 처음 사용할 때 각각을 변경할 필요는 없습니다.
가져오기 실패: 입력값 및 구독 응답 확인
Home에 선택할 수 있는 항목이 표시되지 않으면 먼저 추가 및 가져오기 단계로 돌아갑니다. 올바른 Type을 선택했는지, 구독 URL이 잘리지 않았는지, 서버 Port에 문자가 섞이지 않았는지 확인하세요. 구독 업데이트에 실패하면 현재 네트워크에서 링크에 접속할 수 있는지, 링크가 만료되었거나 다시 생성해야 하는지 확인합니다. 특정 항목만 없다면 구독에서 실제로 반환된 데이터를 확인하고, 항목을 채우려고 프로토콜 유형을 임의로 바꾸지 마세요.
테스트 실패: Test Method 및 서버 매개변수 확인
항목은 있지만 Connectivity Test 결과가 비정상이라면 Settings에서 Test Method를 확인하고 현재 무엇을 테스트하는지 파악합니다. 방법에 따라 결과가 다를 수 있으므로 값 하나만 보고 일상적으로 사용할 서버를 선택하지 마세요. 원래 정보와 대조해 주소, 포트, 인증 필드 및 전송 설정을 계속 확인합니다. 필드에 공백이 하나 더 있거나 이전 매개변수를 사용해도 실패할 수 있습니다. TLS를 사용하는 경우 기기의 날짜와 시간이 올바른지도 확인해 시간 오차로 인증서 검증이 실패하지 않도록 합니다.
스위치가 꺼짐: 권한 및 시스템 연결 상태 확인
상단 스위치가 유지되지 않으면 시스템 VPN 구성 요청을 처리했는지 확인한 뒤 다른 연결 작업이 시스템 구성을 변경하고 있는지 살펴봅니다. On Demand를 잠시 끄고 수동 연결을 시도해 같은 현상이 발생하는지 확인하세요. Diagnostics를 확인해야 한다면 이번 실패가 발생한 시간과 작업을 먼저 기록한 뒤 주변의 오류 메시지를 읽습니다. 현재 작업과 관련 없는 이전 기록을 원인으로 간주하지 마세요.
연결되었지만 일부 접속 실패: 규칙, DNS 및 서버 기능 구분
특정 유형의 대상에서만 문제가 발생한다면 먼저 Global Routing을 확인한 다음 현재 Config의 규칙 순서, 사용 정책 및 DNS 설정을 살펴봅니다. 원본 파일을 보관한 상태에서 같은 서버로 프록시(Proxy) 비교 테스트를 할 수 있습니다. 비교 테스트는 정상인데 구성(Config)에서 문제가 발생하면 규칙과 관련 설정을 우선 확인하고, 두 방식 모두 실패하면 서버와 현재 네트워크를 확인합니다. 이 방법은 문제 범위를 좁히기 위한 것이며 한 방식을 계속 다른 방식 대신 사용해야 한다는 뜻은 아닙니다.
실시간 통신, 특정 앱 또는 일부 콘텐츠에만 문제가 있다면 TCP, UDP 등 관련 설정과 서버 지원 여부도 실제 사용 조건에 맞춰 확인하세요. 웹페이지가 열린다는 이유만으로 모든 전송이 정상이라고 판단하지 마세요. DNS 설정은 한 번에 하나씩만 변경하고 원래 값을 기록한 뒤, 실패하면 복원합니다. 이해하지 못하는 고급 옵션은 그대로 두는 편이 여러 매개변수를 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.
이 단계의 완료 기준: 문제를 입력값, 기본 네트워크, 연결 권한, 서버 또는 규칙 설정 중 한 단계로 좁히고 재현 가능한 작업을 기록할 수 있어야 합니다. App Store 구매, 계정 및 구매 복원 문제는 연결 문제 해결에 해당하지 않습니다. 정품 안내를 참고하세요. 규칙 순서가 원인으로 확인되었다면 규칙 일치 안내를 계속 읽어보세요.