공식 매뉴얼 · 시작하기

Shadowrocket 사용법:
구독 가져오기 및 연결 확인

“가져오기 → 모드 선택 → 연결 → 확인 → 문제 해결” 순서로 진행합니다. 처음 설정할 때는 먼저 확인 가능한 연결을 만든 다음 규칙과 자동 연결 조건을 조정합니다.

01 / 추가 및 가져오기

Add Server: 기존 구독 가져오기 또는 서버 정보 입력

Shadowrocket을 열고 하단의 Home으로 이동합니다. 먼저 보유한 정보가 무엇인지 확인하세요. 구독 링크는 보통 여러 서버를 한 번에 가져오고 계속 업데이트하는 데 사용합니다. 개별 서버 정보에는 프로토콜 유형, 주소, 포트 및 인증 매개변수가 포함됩니다. 용도가 다르므로 구독 링크 전체를 서버의 Host 필드에 입력하지 마세요.

기존 구독 링크: Subscribe 선택

Home에서 오른쪽 상단의 추가 버튼을 누르거나 SERVER 그룹의 Add Server를 눌러 추가 화면으로 이동합니다. Type을 누르고 Subscribe를 선택한 다음 서비스 제공업체에서 받은 전체 구독 링크를 URL에 입력합니다. 알아보기 쉬운 메모를 입력해도 됩니다. 링크 앞뒤에 공백, 줄바꿈 또는 채팅 앱에서 붙은 문장부호가 없는지 확인하고 저장합니다.

저장 후 Home으로 돌아와 구독 내용을 가져올 때까지 기다립니다. 성공하면 해당 그룹에 가져온 서버 항목이 표시됩니다. 구독 이름만 나타났는지 보는 데 그치지 말고 그룹을 펼쳐 실제 항목을 확인하세요. 그룹 이름만 있고 선택할 항목이 없다면 가져오기가 제대로 완료되지 않은 것입니다. 연결 단계로 넘어가지 말고 먼저 업데이트 결과를 확인하세요.

나중에 업데이트하려면 구독 항목의 작업 메뉴에서 업데이트를 실행한 후 현재 선택된 서버를 다시 확인합니다. 업데이트로 이름이 바뀌거나 항목이 추가 또는 삭제될 수 있으며, 이전에 선택한 항목이 변경될 수도 있습니다. 구독 링크에는 접근 인증 정보가 포함되어 있으므로 본인 기기에만 저장하고, 공개 스크린샷이나 진단 메시지에 전체 링크를 넣지 마세요.

개별 서버 정보가 있는 경우: Type에 맞게 입력

서비스 제공업체가 개별 매개변수를 제공한 경우 Add Server의 Type에서 정보와 일치하는 프로토콜을 선택하고 Host, Port 및 인증 필드를 차례로 확인합니다. Host에는 보통 서버 도메인 또는 IP를 입력하며 웹 경로는 덧붙이지 않습니다. Port에는 안내된 숫자를 입력합니다. 프로토콜을 바꾸면 화면의 필드도 달라질 수 있습니다. 한 프로토콜의 비밀번호, 식별자 또는 전송 설정을 다른 프로토콜에 그대로 적용하지 마세요.

스크린샷에는 Password와 Method가 있는 추가 화면이 표시되어 있습니다. 이 필드는 해당 Type에 적용되며 모든 프로토콜에서 필요한 것은 아닙니다. TLS, Server Name 또는 기타 전송 매개변수가 필요하면 서비스 제공업체가 안내한 값에 맞춰 입력하세요. 제공되지 않은 값은 임의로 추가하지 마세요. QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 형식의 가져오기에 사용하는 기능이며 모든 구독 링크에 공통으로 사용하는 경로는 아닙니다.

저장 후 Home으로 돌아와 추가한 항목을 눌러 선택 표시가 원하는 항목에 있는지 확인합니다. 이 단계는 “정보를 클라이언트에 추가한 것”이며 서버에 연결할 수 있는지는 아직 확인되지 않았습니다. 다음으로 Global Routing 방식을 정한 후 연결을 시작하면 테스트 결과를 더 쉽게 해석할 수 있습니다.

Shadowrocket Add Server 추가 화면. Type, Host, Port, Password, Method 및 하단의 가져오기 메뉴 표시
Add Server: 필드는 Type에 따라 달라지므로 보유한 정보에 맞춰 입력합니다.

02 / 모드 및 규칙

Global Routing: 구성, 프록시 또는 직접 연결 선택

Home으로 돌아와 Global Routing을 눌러 현재 설정을 확인합니다. 여기서는 요청을 처리할 경로를 결정합니다. “어떤 서버를 선택했는가”와는 별개의 설정입니다. 전자는 라우팅 방식을 제어하고, 후자는 프록시가 필요할 때 사용할 서버를 지정합니다. 가져오기를 마친 직후 접속 결과가 예상과 다르면 서버를 계속 바꾸기보다 먼저 이 설정을 확인하는 편이 원인을 찾기 쉽습니다.

각 모드에서 확인할 항목

구성(Config): 현재 활성화된 구성 파일의 규칙에 따라 요청을 처리하며 요청마다 서로 다른 정책이 적용될 수 있습니다. 일상적으로 규칙을 적용해 사용하려면 이 항목을 선택하되, Config에서 실제로 활성화된 파일을 먼저 확인하세요. 모드 이름만 보고 적합한 규칙이 이미 있다고 판단할 수는 없습니다.

프록시(Proxy): 요청을 프록시 경로로 처리하므로 서버 연결 상태를 비교하고 문제를 확인하는 데 사용할 수 있습니다. 특정 규칙이 일치했다는 뜻은 아니며 모든 시스템 트래픽이 반드시 같은 경로를 거친다는 의미도 아닙니다. 테스트 후 규칙에 따라 분기해야 한다면 Config로 되돌리고 실제 요청을 다시 확인하세요.

직접 연결(Direct): 선택한 프록시 서버를 거치지 않고 요청을 직접 처리합니다. 로컬 네트워크에서 대상에 직접 접속할 수 있는지 비교하는 데 도움이 되지만, 선택한 서버가 정상 작동한다는 증거는 아닙니다. Direct에 계속 머물러 있으면 서버만 바꿔도 접속 경로는 보통 달라지지 않습니다.

Config를 사용하기 전에 현재 파일 확인

하단의 Config로 이동해 현재 활성화된 구성 파일을 확인한 다음 해당 파일을 열어 내용을 살펴봅니다. 편집 화면의 General은 일반 매개변수를 관리하고, Rule은 규칙 일치에 사용되며, Hosts는 주소 매핑과 관련이 있습니다. URL Rewrite와 HTTPS Decryption은 추가 요청 처리 설정입니다. 처음 연결할 때 “설정을 완성”하려고 모든 항목을 켤 필요는 없습니다.

Rule은 보통 위에서 아래 순서로 판단하며 일치하면 해당 정책으로 처리합니다. 규칙을 확인할 때는 일치 조건과 마지막 정책을 모두 살펴보세요. 도메인 규칙이 있다고 해서 반드시 PROXY를 사용한다는 뜻은 아닙니다. Add Rule을 사용하기 전에 원본 파일을 복사해 두면 연결 확인 문제와 규칙 수정 문제를 분리할 수 있습니다.

이 단계에서는 “어떤 Config를 사용 중인지, 대상이 대략 어떤 경로로 처리되어야 하는지”만 명확히 하면 됩니다. 아직 판단하기 어렵다면 한 번에 많은 규칙을 추가하지 마세요. 프로토콜 필드, 일치 순서 및 정책에 관한 자세한 내용은 프로토콜 참고 안내를 확인하세요. 전체 모드에 대한 일반적인 질문은 자주 묻는 질문을 참고하세요.

Shadowrocket Config 구성 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 활성 파일을 먼저 확인하고 Rule과 해당 정책을 살펴봅니다.

03 / 연결 및 권한 승인

Home: 서버를 선택하고 상단 스위치 켜기

Home으로 돌아와 가져온 SERVER 그룹을 펼친 다음 사용할 서버를 선택합니다. Global Routing이 앞 단계에서 선택한 설정과 일치하는지 다시 확인하고 상단 연결 스위치를 켭니다. 이 두 동작을 따로 확인하면 “항목은 바꿨지만 이전 테스트 모드를 그대로 사용한” 상황을 방지할 수 있습니다.

처음 연결할 때 시스템에서 VPN 구성 추가 권한을 요청할 수 있습니다. 방금 Shadowrocket에서 직접 시작한 작업인지 확인한 후 시스템 안내에 따라 허용하고 기기의 인증 절차를 완료합니다. 여기서 생성되는 것은 클라이언트가 네트워크 요청을 처리하는 데 필요한 시스템 구성이지, 새로운 연결 서비스를 구매하는 절차가 아닙니다. 권한을 취소했다면 클라이언트로 돌아가 스위치를 다시 켜고 확인 절차를 완료하세요.

권한을 승인한 뒤 Home으로 돌아와 상단의 Not Connected가 연결 상태로 바뀌는지 확인합니다. 계속 연결되지 않으면 현재 화면에서 시스템 안내를 처리했는지, 선택한 항목이 그대로 있는지 먼저 확인하세요. 스위치를 연속해서 누르지 마세요. 스위치의 연결 상태는 연결 절차의 진행 상황만 나타내며 대상 웹사이트의 실제 요청 테스트를 대신할 수 없습니다.

처음 확인할 때는 앱을 전면에 유지하고 복잡한 자동 연결 조건은 아직 사용하지 않는 것이 좋습니다. 같은 테스트 중에 Wi-Fi와 셀룰러 네트워크를 동시에 바꾸지 마세요. 기기에서 다른 VPN 연결이 이미 작동 중이면 시스템 설정에서 현재 활성화된 연결을 확인해 테스트 대상이 예상과 일치하는지 점검합니다.

이 단계의 확인 항목은 명확하게 선택한 서버, 확인된 Global Routing, 완료된 시스템 권한 승인, Home에 표시되는 연결 상태입니다. 네 가지를 모두 확인한 뒤 검증 단계로 진행하세요. 상단 상태가 잠시 바뀌었다가 곧 Not Connected로 돌아오면 5단계로 이동해 연결 매개변수와 네트워크를 점검합니다.

Shadowrocket Home 화면. 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 있고 아래에 SERVER 그룹과 Add Server가 표시됨
Home: 스크린샷은 연결되지 않은 상태입니다. 실제 사용 시 스위치와 선택 항목을 확인하세요.

04 / 결과 확인

Connectivity Test: 테스트 후 실제 요청 확인

연결이 설정되면 Home에서 Connectivity Test를 누르고 결과가 나올 때까지 기다립니다. 현재 테스트 대상에 대한 연결 과정이 완료되는지 확인하는 데 적합하지만, 한 번의 성공은 해당 테스트에 사용된 조건에만 해당합니다. 테스트 대상, 현재 네트워크 및 테스트 방식에 따라 결과가 달라질 수 있으므로 한 가지 수치로 모든 앱의 접속 여부를 판단하지 마세요.

그런 다음 브라우저를 열어 사용할 권한이 있고 예상 결과를 판단할 수 있는 웹사이트에 접속합니다. Config를 선택한 경우 직접 연결이 예상되는 대상과 프록시 연결이 예상되는 대상을 각각 확인하세요. Proxy로 연결 상태를 비교했다면 테스트가 끝난 뒤 Config로 전환하고 동일한 대상에 다시 요청을 보냅니다. 비교할 때는 서버와 로컬 네트워크를 그대로 유지하고 한 번에 한 가지 요소만 바꿔야 결과를 참고할 수 있습니다.

분기 처리를 더 확인해야 한다면 Shadowrocket으로 돌아가 현재 버전에서 제공하는 요청 기록 또는 진단 정보를 확인하고 방금 접속한 대상과 실제로 사용된 정책을 찾습니다. Data의 트래픽 변화는 요청이 발생했다는 단서가 될 수 있지만, 트래픽이 증가했다는 사실만으로 특정 Rule이 일치했다고 단정할 수는 없습니다. 대상, 현재 Config 및 구체적인 정책을 함께 확인하세요.

브라우저에 이전 내용이 계속 표시되면 페이지를 새로고침하거나 대상을 다시 열고 새 요청을 확인합니다. 웹 캐시, 앱의 연결 재사용 및 DNS 캐시로 인해 전환 후의 동작이 바로 명확하지 않을 수 있습니다. 브라우저에 이미 로드된 페이지만 보고 방금 서버를 바꾼 결과를 판단하지 마세요.

Connectivity Test는 성공했지만 특정 웹사이트에 접속할 수 없다면 현재 정상 작동하는 설정은 유지하고 대상 관련 규칙, DNS 및 서버 측 조건을 먼저 확인하세요. 모든 대상에 실패하면 연결 및 서버 정보를 다시 확인하고 Rule을 광범위하게 수정하는 일은 미루세요. 아래에서 실패 위치에 따라 확인 순서를 안내합니다.

05 / 설정 및 문제 해결

Settings: 실패한 단계에 따라 차례로 확인

문제를 확인할 때는 세 가지를 먼저 기록합니다. 가져오기, 연결, 실제 접속 중 어느 단계에서 실패했는지, 당시 Wi-Fi와 셀룰러 네트워크 중 무엇을 사용했는지, 방금 어떤 설정을 변경했는지입니다. 이러한 조건을 유지하고 아래 순서로 확인하면 구독을 바꾸고 프로토콜을 수정하거나 앱을 다시 설치하는 일을 한꺼번에 하는 것보다 원인을 찾기 쉽습니다.

구독을 가져올 수 없거나 업데이트 후 항목이 없음

구독 설정으로 돌아가 URL이 완전한지, 만료되지 않았는지, 가져온 내용이 서비스 제공업체의 구독인지 확인합니다. 브라우저에서 링크가 열린다고 해서 클라이언트가 지원하는 내용이 반환된다는 뜻은 아닙니다. 실제로 로그인 페이지, 안내 문구 또는 빈 내용이 반환되면 서버 목록을 만들 수 없습니다. 먼저 기기의 기본 네트워크가 정상인지 확인한 다음 서비스 제공업체에 링크 상태와 형식을 문의하세요.

업데이트 후 기존 항목 하나만 보이지 않는다면 먼저 그룹이 접혀 있는지, 이름이 바뀌었는지 확인한 다음 사용 가능한 항목을 다시 선택합니다. 이름을 되찾기 위해 이전 구독 내용을 반복해서 복원하지 마세요. 서버가 계속 제공되는지는 서비스 제공업체의 안내를 기준으로 확인해야 합니다.

연결 스위치가 유지되지 않거나 테스트가 계속 시간 초과됨

먼저 시스템의 VPN 권한을 확인한 다음 Type, Host, Port 및 인증 매개변수를 하나씩 점검합니다. 연결 시간 초과는 주소, 포트, 현재 네트워크 또는 서버 상태와 관련이 있을 수 있습니다. 시간 초과만으로 비밀번호가 잘못되었다고 판단할 수는 없습니다. 인증 관련 안내가 표시되면 해당 필드를 중점적으로 확인하세요. Wi-Fi와 셀룰러 네트워크를 비교하려면 먼저 한 번 테스트를 완료한 뒤 전환하고 결과를 기록합니다.

하단의 Settings로 이동하면 Test Method와 Diagnostics를 확인할 수 있습니다. Test Method마다 확인하는 과정이 다르므로 테스트 방식을 바꾼 결과를 동일한 조건의 결과로 바로 비교하지 마세요. Diagnostics는 문제 해결에 필요한 단서를 모으는 기능이지 자동 복구 버튼이 아닙니다. 과거 오류에 영향을 받지 않도록 방금 테스트한 시간대의 기록을 확인하세요.

연결은 정상이지만 일부 요청 결과가 예상과 다름

먼저 Global Routing을 확인한 뒤 활성화된 Config를 점검합니다. Config에서 관련 Rule이 앞선 규칙에 의해 먼저 일치하지 않는지, 정책이 예상한 값인지, 마지막 규칙이 일치하지 않은 요청을 어떻게 처리하는지 확인하세요. 특정 도메인에만 문제가 있다면 Hosts 및 DNS 관련 설정도 확인합니다. 새로운 변수를 늘리지 않도록 모든 TCP 및 UDP 매개변수를 곧바로 변경하지 마세요.

수동으로 연결을 끊은 뒤 다시 자동 연결되는 경우 Settings의 On Demand 조건을 확인합니다. 수동 테스트를 재현하려면 먼저 현재 조건을 기록한 다음 자동 실행을 일시적으로 꺼 둡니다. 기본 연결을 확인한 뒤 조건을 하나씩 다시 활성화하세요. On Demand의 실행 범위와 규칙 순서는 고급 설정에 해당합니다. On Demand 연결 안내를 참고하세요.

서비스 제공업체에 문의할 때는 실패 단계, 네트워크 유형, 선택한 프로토콜 및 수행한 비교 절차를 알려주면 됩니다. Diagnostics 기록이나 스크린샷을 보내기 전 구독 URL, 비밀번호, 식별 정보, 키와 같은 민감한 내용을 삭제하세요. 구독 업데이트와 연결 문제는 자주 묻는 질문을 참고하고, 프로토콜 매개변수의 의미는 프로토콜 참고 안내를 확인하세요.

Shadowrocket Settings 설정 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제에 따라 Test Method, On Demand 및 Diagnostics를 확인합니다.