공식 매뉴얼 · 첫 연결
Shadowrocket 사용 가이드구독 가져오기, 연결 및 규칙 라우팅
먼저 기존 서버에 정상적으로 연결한 다음 규칙이 예상대로 작동하는지 확인합니다. 아래 단계는 iPhone / iPad 화면을 기준으로 하며, 다섯 단계에 따라 진행하면 됩니다. 첫 연결 전에 모든 설정을 변경할 필요는 없습니다.
먼저 정보 유형 확인
Add Server: 서버 추가 및 구독 가져오기
Shadowrocket을 열고 Home 화면에 머뭅니다. 아래쪽의 SERVER에서 서버를 확인하고 선택할 수 있습니다. 처음 사용할 때는 상단 스위치를 켜기 전에 본인의 정보를 목록에 추가해야 합니다. 구독 주소, 단일 서버 공유 링크, 구성 파일은 용도가 다릅니다. 모두 텍스트로 복사할 수 있다고 해서 같은 가져오기 메뉴를 사용하면 안 됩니다. 보유한 정보가 여러 서버를 업데이트하는 주소인지, 특정 서버의 연결 매개변수인지 먼저 확인한 다음 아래 방법 중 하나를 선택합니다.
기존 구독 링크: Subscribe 선택
Home에서 Add Server를 열고 Type에서 Subscribe를 선택한 뒤 입력 화면으로 돌아옵니다. URL 필드에 기존 구독 주소 전체를 붙여 넣습니다. 메모는 서버 그룹을 구분하기 위한 이름으로 지정할 수 있습니다. 저장하기 전에 주소 앞뒤에 공백, 줄바꿈 또는 메시지의 설명 문구가 포함되어 있지 않은지 확인합니다. 주소의 매개변수는 전체 링크의 일부이므로 물음표 앞의 경로만 남기거나 인증 매개변수를 예시 문구로 바꾸지 마세요.
저장한 뒤 Home으로 돌아가 구독 정보가 로드될 때까지 기다립니다. SERVER에 해당 그룹과 서버 항목이 표시되는지 확인합니다. 구독 이름만 저장되고 서버가 표시되지 않는다면 가져오기가 완료된 것이 아닙니다. 먼저 구독 업데이트 결과를 확인한 뒤 연결을 진행합니다. 나중에 서버 목록의 변경 사항을 가져오려면 같은 주소를 매번 다시 추가하지 말고 기존 Subscribe 항목을 업데이트합니다. 구독 링크에는 보통 접속 자격 증명이 포함되므로 스크린샷을 찍거나 도움을 요청하거나 백업할 때 주의해서 보호하세요.
기존 단일 서버 정보: Type에 맞춰 입력
서버 주소, 포트 및 인증 정보가 있다면 Add Server에서 해당 정보에 맞는 Type을 선택합니다. 예를 들어 Shadowsocks를 선택한 다음 Host, Port, Password, Method를 하나씩 확인합니다. 다른 프로토콜은 Type에 따라 항목이 달라지므로 원래 제공된 정보를 기준으로 입력합니다. Host에는 서버 호스트 이름 또는 IP를 입력하며 웹 경로를 임의로 추가하지 않습니다. Port는 제공된 정보와 일치해야 하며 Password와 Method도 기억에 의존해 바꾸면 안 됩니다. 프로토콜을 잘못 선택하면 주소와 비밀번호가 올바르더라도 연결되지 않을 수 있습니다.
QR 코드가 있다면 Scan QR Code를 사용해 가져오고, 시스템 안내에 따라 카메라 접근을 허용합니다. 단일 공유 링크가 있다면 복사한 다음 앱으로 돌아가 가져오기 안내에 따라 내용을 확인합니다. 가져온 뒤에도 Type, Host, Port가 원래 정보와 일치하는지 확인해야 합니다. Import from Cloud JSON은 별도의 구조화된 가져오기 메뉴입니다. 일반 구독 주소를 JSON으로 사용하면 안 됩니다. 첫 연결에는 알맞은 가져오기 방법 하나만 완료하면 되며 모든 메뉴를 하나씩 사용할 필요는 없습니다.
이 단계의 완료 기준: Home의 SERVER에 구분 가능한 서버가 표시되고, 사용하려는 항목을 탭했을 때 선택된 상태여야 합니다. 선택한 항목의 이름을 기억해 두세요. 다음 단계에서 Global Routing을 선택할 때도 같은 서버를 유지해야 합니다. 여러 구독을 정리하고 업데이트 방식을 설정하거나 백업을 삭제하는 자세한 방법은 구독 및 서버 관리 매뉴얼을 참고하세요.
트래픽 처리 방식 결정
Global Routing: 라우팅 모드 선택
서버를 목록에 추가했다면 Home으로 돌아가 Global Routing을 탭해 현재 모드를 확인합니다. 이 메뉴는 트래픽 처리 방식을 정하며 서버 정보를 대신 입력해 주지는 않습니다. 일상적으로 구성 파일의 규칙에 따라 Proxy와 Direct를 구분하려면 설정(Config)을 사용합니다. 선택한 서버가 특정 대상에 접속할 수 있는지 임시로 비교하려면 Proxy를 사용할 수 있습니다. 트래픽을 대상에 직접 연결하려면 Direct를 사용합니다. 세 가지 모드는 서로 다른 서버나 속도 등급이 아닙니다.
| 모드 | 의미 및 용도 |
|---|---|
| 설정(Config) | 현재 구성 파일의 규칙과 정책에 따라 트래픽을 처리하며, 규칙 기반 라우팅을 일상적으로 사용할 때 적합합니다. |
| Proxy | 트래픽을 프록시 경로로 보내며, 프록시가 필요한 경우나 임시 비교 점검에 사용합니다. |
| Direct | 트래픽을 대상에 직접 연결하며, 현재 네트워크의 직접 접속 상태를 확인할 때 사용할 수 있습니다. |
설정(Config)을 선택한 뒤 Config로 이동해 사용할 구성 파일이 활성화되어 있는지 확인합니다. Subscribe는 서버 목록을 관리하고 Config는 구성을 관리합니다. 구독을 가져왔다고 해서 모든 대상에 적합한 규칙이 자동으로 준비되는 것은 아닙니다. 구성 파일을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 첫 연결에서는 현재 구성과 Rule의 규칙 의도만 확인하면 됩니다. 가이드를 따라 하기 위해 Rewrite나 Decryption 기능까지 동시에 활성화하지 마세요.
아래 세 줄은 규칙 순서를 이해하기 위한 예시일 뿐, 기존 구성을 덮어쓰라는 뜻이 아닙니다. DOMAIN-SUFFIX는 대상 도메인 접미사와 일치하고, GEOIP는 대상 IP의 지역을 기준으로 일치 여부를 판단하며, FINAL은 앞선 규칙에 일치하지 않은 트래픽을 처리합니다. 규칙은 일반적으로 위에서 아래 순서로 확인하므로 범위가 넓은 규칙이 앞에 있으면 먼저 일치할 수 있습니다. PROXY와 DIRECT는 정책 이름입니다. 본인의 구성에서 사용자 지정 정책 그룹을 사용한다면 규칙이 참조하는 이름이 실제로 존재하는지도 확인하세요.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY스크린샷의 Add Rule은 규칙을 추가하는 메뉴지만 첫 연결 전에 규칙을 추가할 필요는 없습니다. 먼저 기존 구성으로 연결과 확인을 완료하고, 특정 대상의 처리 경로가 예상과 다를 때 관련 규칙을 수정합니다. 수정 전에는 기존 구성을 보관하고, 테스트할 때 한 번에 한 곳만 변경하면 되돌리기 쉽습니다. 설정 항목에 대한 자세한 설명은 설정 매뉴얼을 참고하세요. 이 페이지의 작동 확인에서는 모드와 규칙이 실제로 예상대로 작동하는지 판단하는 방법을 설명합니다.
이 단계의 완료 기준: Home에 예상한 Global Routing 모드가 표시되어야 합니다. 설정(Config)을 선택했다면 Config에서 구성 파일이 명확하게 활성화되어 있어야 합니다. 다음 단계에서는 Home으로 돌아가 연결을 설정합니다. 서버를 확인하기 전에 규칙 변경을 계속 추가하지 마세요.
시스템 연결 승인 완료
Home: 연결 스위치 켜기
Home으로 돌아가 SERVER에서 선택한 항목을 다시 확인합니다. 목록에 서버가 여러 개 있으면 이름이 보인다고 해서 그 서버가 선택된 것은 아닙니다. 사용할 항목을 먼저 탭한 뒤 Global Routing을 확인합니다. 상단에 Not Connected가 표시되면 현재 연결되지 않은 상태입니다. 준비가 되면 상단 스위치를 켜고 시스템이나 앱의 다음 안내를 기다립니다. 현재 상태를 파악하기 어려워지지 않도록 스위치를 빠르게 연속으로 전환하지 마세요.
처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 묻습니다. Shadowrocket을 조작하는 중에 표시된 안내인지 확인한 뒤 시스템 절차에 따라 허용하고, 기기에서 요구하는 암호 또는 생체 인증을 완료합니다. 이는 클라이언트가 해당 네트워크 트래픽을 처리하도록 허용하는 시스템 권한이며, 구독 가져오기의 일부가 아닙니다. 이전에 승인을 취소했어도 서버 목록은 남아 있을 수 있지만 상단 스위치로 연결을 설정할 수 없습니다. 같은 구독을 다시 추가하지 말고 연결을 다시 시작해 승인을 완료하세요.
승인이 끝나면 Home으로 돌아가 상단 상태가 Not Connected에서 바뀌었는지 확인하고 연결을 유지합니다. 시스템 화면에 VPN 상태 표시가 나타날 수 있지만, 이는 네트워크 터널이 활성화되었음을 확인하는 데 도움을 줄 뿐 원격 서버를 사용할 수 있는지 또는 모든 대상에 올바른 정책이 적용되는지를 단독으로 증명하지는 않습니다. 현재 서버와 모드를 유지한 채 다음 단계에서 실제 접속을 확인합니다.
스위치를 켜자마자 다시 꺼진다면 안내 내용을 먼저 기록합니다. 승인이 완료되었는지, 다른 VPN 연결이 활성화되어 있는지, 정보가 불완전한 항목을 잘못 선택하지 않았는지 확인합니다. 연결 충돌을 해결할 때는 이번에 테스트할 연결만 남긴 뒤 다시 시도합니다. 이 단계에서 네트워크, 서버, 모드, 구성을 동시에 바꾸지 마세요. 연결이 우연히 성공하더라도 어떤 조건이 영향을 주었는지 알 수 없습니다.
이 단계의 완료 기준: 앱의 연결 상태가 바뀌고 즉시 끊기지 않아야 합니다. 이 단계에서는 On Demand를 활성화하지 마세요. 자동 연결은 수동 연결이 안정된 다음 설정합니다. 문제를 확인하는 중에 연결을 껐는데 조건에 따라 다시 연결되는 상황을 피할 수 있습니다.
연결 상태와 접속 결과를 따로 확인
Connectivity Test: 작동 확인
연결을 켠 뒤 Home에서 Connectivity Test를 사용해 먼저 서버에 연결할 수 있는지 확인합니다. 테스트 결과는 사용한 테스트 방식에 맞춰 해석해야 합니다. 한 번 응답이 있었다고 해서 모든 웹사이트, 프로토콜, 시간대에 동일하게 연결된다는 뜻은 아닙니다. 특정 항목이 시간 초과되면 실제 접속 결과와 테스트 방식을 함께 살펴봐야 합니다. 목록의 테스트 값 하나만 보고 서버를 반복해서 바꾸지 마세요.
그런 다음 브라우저를 열고 원래 사용하려던 대상에 접속합니다. 페이지 로딩이 완료될 때까지 기다린 뒤 같은 사이트의 다른 페이지를 여는 등 일반적인 동작을 한 번 더 수행합니다. 캐시의 영향을 줄이려면 페이지를 새로 고치거나 새 브라우징 세션에서 다시 확인합니다. 첫 확인에서는 같은 대상, 같은 네트워크, 같은 서버를 사용합니다. 페이지 제목이 표시되는 것만 확인하거나 시스템 VPN 표시만 보는 것으로는 전체 접속 과정이 정상이라고 판단할 수 없습니다.
설정(Config)을 사용한다면 “접속 가능 여부”와 “라우팅이 올바른지”를 구분해야 합니다. Data에서 관련 연결 기록을 확인하고 대상 도메인, 일치한 규칙, 정책을 함께 살펴 실제 경로를 판단합니다. 프록시를 사용해야 하는 접속은 PROXY 또는 본인의 프록시 정책 그룹에 해당해야 합니다. 직접 연결해야 하는 접속은 DIRECT에 해당해야 합니다. 기록에 Direct가 표시되어도 반드시 오류인 것은 아니며 규칙이 의도한 결과일 수 있습니다. 반대로 접속에 성공했더라도 Direct 연결일 수 있으므로, 이를 근거로 프록시 서버가 검증되었다고 판단하면 안 됩니다.
Proxy에서는 특정 대상에 접속되지만 설정(Config)에서는 실패한다면 Config의 규칙 일치 여부, 정책 이름, 대상 확인 결과를 우선 점검합니다. 두 모드에서 모두 실패하면 서버 항목과 현재 네트워크를 다시 확인합니다. Direct는 현재 네트워크에서 대상에 직접 접속하는 상태를 비교하는 데 사용할 수 있습니다. 경로별 결과 차이는 문제를 찾기 위한 단서일 뿐 특정 구성 요소가 손상되었다는 결론은 아닙니다. 비교가 끝나면 일상적으로 사용하려던 원래 모드로 되돌립니다.
이제 현재 설정을 유지한 채 사용할 수 있습니다. 자동 연결이 필요하면 나중에 On Demand에서 조건을 설정하고, 조건이 충족될 때와 해제된 뒤의 동작을 각각 확인합니다. 규칙 추가, 여러 구독 정리, 업데이트 방식 조정은 이후 관리 작업입니다. 자세한 내용은 구독 및 서버 관리 매뉴얼을 참고하세요. 첫 연결을 위해 이 작업들을 한 번에 모두 완료할 필요는 없습니다.
한 번에 조건 하나만 변경
Settings: 자주 발생하는 문제 점검
문제를 확인할 때는 어느 단계에서 실패하는지 먼저 구분합니다. 구독을 가져오지 못하는지, 서버가 선택되지 않는지, 연결 스위치가 켜진 상태를 유지하지 못하는지, 아니면 연결 후 특정 대상에 접속할 수 없는지 확인합니다. 현상에 따라 점검할 위치가 다릅니다. 현재 네트워크, 서버, Global Routing, 구체적인 안내 내용을 기록한 다음 아래 순서대로 확인합니다. 항목을 하나씩 변경한 뒤 같은 대상을 다시 테스트하고, 개선되지 않으면 원래 값으로 되돌립니다. 이렇게 하면 원래 작동하던 설정까지 함께 잘못 변경하는 일을 줄일 수 있습니다.
Subscribe 업데이트 실패 또는 서버가 표시되지 않음
먼저 복사한 주소가 관리 페이지를 여는 일반 웹 링크가 아니라 전체 구독 주소인지 확인합니다. 공백, 줄바꿈, 잘린 매개변수가 없는지 확인하고 현재 네트워크 자체에서 정상적으로 접속할 수 있는지도 살펴봅니다. 구독 주소가 유효한지와 클라이언트 설치가 성공했는지는 별개의 문제입니다. 주소가 만료되었거나 인증 조건이 바뀌었거나 응답 형식이 올바르지 않으면 목록이 업데이트되지 않을 수 있습니다. 주소 확인이 필요하면 본인이 이미 이용 중인 서비스의 제공자에게 문의합니다. 인증 정보가 포함된 전체 링크를 공개된 곳에 게시하지 마세요.
연결 설정 실패 또는 Connectivity Test 시간 초과
직접 추가한 항목은 Type, Host, Port, 인증 항목을 먼저 확인합니다. TLS 또는 다른 전송 옵션이 있다면 원래 정보를 기준으로 확인하고, 연결을 위해 검증을 임의로 끄지 마세요. 이어서 시스템 승인이 완료되었는지 확인하고, 본인이 사용할 수 있는 다른 네트워크에서 같은 항목을 비교 테스트합니다. 테스트 결과만 이상하다면 Settings에서 Test Method를 확인하고 현재 연결과 대상에 적합한 방식인지 살펴봅니다. 테스트 방식을 바꾼 뒤에는 표시된 결과만 비교하지 말고 실제 접속도 확인해야 합니다.
연결되었지만 페이지가 열리지 않거나 일부 대상만 실패
앞 절의 방법에 따라 Proxy와 설정(Config)을 잠시 비교합니다. 설정(Config)에서만 실패한다면 현재 활성화된 파일과 Rule의 일치 순서를 확인합니다. 여러 대상에서 실패한다면 서버와 네트워크를 다시 확인합니다. DNS 확인 문제도 페이지가 열리지 않는 현상으로 나타날 수 있으므로 연결 기록에서 대상 주소를 가져왔는지 살펴봅니다. 원인을 찾지 못한 채 도메인 규칙을 한꺼번에 추가하지 말고, 모든 실패를 구독 업데이트 문제로 단정하지 마세요.
스위치가 자동으로 바뀌거나 진단 정보가 필요한 경우
Settings에서 On Demand가 활성화되어 있는지, 조건이 현재 네트워크와 일치하는지 확인합니다. 문제를 확인하는 동안 자동 연결을 잠시 중지하고 수동 스위치로 현상을 재현할 수 있습니다. 기본 상태가 정상임을 확인한 뒤 조건을 하나씩 복원합니다. 추가로 문제를 파악해야 한다면 Diagnostics를 사용해 단서를 수집하고, 문제가 발생한 시각, 오류 안내, 재현 절차를 기록합니다. 진단 기록을 공유하기 전에 구독 주소, 인증 매개변수, 개인 접속 내용을 가리고 문제 해결에 필요한 정보만 제공합니다.
Settings에는 Proxy, TCP, UDP 등의 옵션도 있을 수 있습니다. 이 항목들은 첫 연결 전에 반드시 조정해야 하는 목록이 아니며, 대상 접속에 실패했다고 하나씩 임의로 전환해서는 안 됩니다. 원래 구성을 복원한 뒤에도 문제가 재현된다면 구체적인 실패 현상을 바탕으로 설정 안내를 확인하세요. 구독 그룹, 서버 항목 또는 업데이트 관리에 관한 문제라면 서버 관리 매뉴얼에서 계속 점검할 수 있습니다.
이 단계의 완료 기준: 문제가 발생한 단계, 이미 확인한 조건, 다음으로 점검할 항목을 설명할 수 있어야 합니다. 복구 가능한 구성을 보관하고 한 번에 한 항목만 변경한 기록을 남기면, 반복해서 삭제하고 다시 설치하는 것보다 문제 범위를 좁히는 데 도움이 됩니다.
