공식 매뉴얼 기본 사용법 / iPhone 및 iPad 화면
Shadowrocket 사용 가이드구독 가져오기, 규칙 및 연결 확인
“추가 → 모드 선택 → 연결 → 확인 → 문제 해결” 순서로 진행합니다. 먼저 기존 서버가 연결되는지 확인한 뒤 규칙을 조정하세요. 결과를 파악하기 쉽도록 한 번에 설정 하나만 변경합니다.
STEP 01 / ADD SERVER
서버 추가 또는 기존 구독 가져오기
먼저 Shadowrocket의 Home을 열고 SERVER 목록과 Add Server를 찾습니다. 기존 구독 링크와 개별 서버 매개변수는 입력 자료가 서로 다릅니다. 구독 링크는 여러 서버를 가져와 업데이트하는 데 사용하고, 수동 추가는 서버 한 대의 정보를 직접 입력해야 합니다. 준비한 자료가 어느 유형인지 확인한 뒤 해당 경로만 선택하면 됩니다. 두 가지 방법을 모두 진행할 필요는 없습니다.
기존 구독: Subscribe 사용
Add Server로 이동해 Type을 열고 Subscribe를 선택한 다음 URL에 기존 구독 주소를 붙여 넣습니다. 붙여 넣은 뒤 주소의 시작과 끝, 줄바꿈을 확인해 채팅 메시지의 설명, 따옴표 또는 마지막 문장 부호가 함께 들어가지 않았는지 살펴보세요. 구독 주소에는 접근 자격 정보가 포함될 수 있으므로 전체 주소를 공개 스크린샷에 넣거나 관계없는 사람에게 보내지 마세요.
저장한 다음 Home으로 돌아와 구독을 가져올 때까지 기다린 후, SERVER에 해당 그룹과 서버 항목이 표시되는지 확인합니다. 구독 이름이 보인다고 해서 내용을 성공적으로 가져온 것은 아닙니다. 그룹을 펼쳐 선택할 수 있는 서버가 실제로 있는지 확인하세요. 항목이 없다면 연결 스위치를 켜기 전에 업데이트 안내를 확인합니다. 구독 가져오기 실패와 서버 연결 실패는 서로 다른 단계이므로 별도로 해결해야 합니다.
이후 구독을 업데이트할 때는 기존 구독 항목의 업데이트 기능을 사용하세요. 같은 주소를 반복해서 새로 추가하면 이름이 같은 그룹이 남아 실제 선택한 서버와 확인 중인 구독이 일치하지 않을 수 있습니다. 업데이트 전에 현재 선택한 서버를 기록하고, 업데이트 후에도 해당 항목이 있는지 확인하세요. 구독 내용에 따라 항목 이름과 매개변수가 바뀔 수 있습니다.
개별 서버 정보가 있는 경우: Type에 맞게 입력
Host, Port 및 인증 정보를 받았다면 Add Server에서 해당하는 Type을 선택합니다. Shadowsocks, VMess, VLESS, Trojan 등 프로토콜마다 입력 필드가 다르므로 주소와 포트만 입력했다고 완료된 것은 아닙니다. 제공받은 서버 정보를 기준으로 입력하세요. 예시 스크린샷의 Password와 Method는 표시된 유형의 필드이며 모든 프로토콜에서 같은 양식을 사용하는 것은 아닙니다.
Host에 공백이 추가되지 않았는지, Port가 빠짐없이 입력됐는지, Password와 암호화 방식 또는 기타 인증 필드가 원래 정보와 일치하는지 확인합니다. 제공된 정보에 TLS, 전송 방식 또는 서버 이름이 포함되어 있다면 해당 옵션에도 입력해야 합니다. 매개변수가 불확실한 경우 원래 정보를 제공한 곳에 확인하고, 프로토콜 유형을 바꾸며 추측하지 마세요.
QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 자료가 해당 형식임이 분명한 경우에만 Import from Cloud JSON을 사용하세요. 스캔 후에도 특히 Type, Host, Port가 제대로 인식됐는지 확인합니다. 저장하고 Home으로 돌아온 뒤 SERVER에 항목이 표시되는지 확인한 다음 Global Routing 선택 단계로 진행합니다. 가져오기 형식에 관한 자세한 내용은 질문과 답변, 구독 업데이트 오류는 구독 실패 진단을 참고하세요.
STEP 02 / GLOBAL ROUTING
Global Routing 및 현재 구성 선택
서버를 추가한 뒤 Home으로 돌아가 Global Routing을 누릅니다. 여기서는 연결을 처리하는 방식을 선택하며, 구독 주소를 바꾸는 곳은 아닙니다. 세 가지 모드인 구성(Config), 프록시(Proxy), 직접 연결(Direct)의 차이를 먼저 확인하세요. 기존 규칙에 따라 요청을 분배하려면 Config를 사용합니다. 문제를 찾기 위해 모드를 임시로 변경했다면 테스트 후 원래 선택으로 되돌리세요.
구성(Config): 현재 규칙에 따라 처리
Config는 현재 구성의 규칙을 사용해 요청에 DIRECT, PROXY 또는 다른 정의된 정책을 적용합니다. 하단의 Config 페이지로 이동해 사용 중인 구성을 확인한 다음 Rule을 살펴보세요. 구독은 보통 서버 목록을 담당하고 구성 파일은 규칙 등의 설정을 담당합니다. 구독을 가져왔다고 해서 해당 규칙 구성도 자동으로 선택됐다고 단정해서는 안 됩니다.
공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집 화면의 섹션입니다. 처음에는 현재 구성과 Rule만 확인하면 됩니다. 모든 섹션을 수정하거나 연결을 위해 HTTPS Decryption을 켤 필요는 없습니다. 사용 가능한 구성이 이미 있다면 문제 해결 중 원래 작동하던 설정을 잃지 않도록 수정 전에 복사본을 보관하세요.
프록시(Proxy) 및 직접 연결(Direct): 처리 경로 비교
Proxy는 연결을 현재 프록시 정책으로 처리하지만 사용할 수 없는 서버를 복구해 주지는 않습니다. Direct는 선택한 프록시 서버를 거치지 않고 직접 연결합니다. Direct로 전환한 뒤 페이지가 열린다면 해당 페이지의 직접 연결 경로가 사용 가능하다는 뜻일 뿐, 프록시 설정이 올바르다는 의미는 아닙니다. 두 모드는 경로를 비교할 때 사용할 수 있지만 모든 문제의 해결책으로 고정해 사용해서는 안 됩니다.
규칙은 보통 순서대로 매칭됩니다. 아래 예시는 문법을 이해하기 위한 것입니다. 첫 번째 줄은 도메인 접미사, 두 번째 줄은 IP의 지리적 위치를 기준으로 매칭하며 마지막 줄은 기본 처리를 담당합니다. 이 예시는 그대로 가져와 사용할 수 있는 완전한 구성 파일이 아니며, 실제 정책 이름은 현재 구성에서 유효해야 합니다. 기존 Rule을 예시로 덮어쓰거나 서버 주소에 예시 도메인을 사용하지 마세요.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
구성과 정책을 확인한 뒤 Home으로 돌아가 Global Routing의 선택을 다시 확인합니다. 이 단계에서는 규칙을 그대로 두고 연결을 테스트하세요. 이후 “Proxy에서는 되지만 Config에서는 안 되는” 문제가 발생하면 실제 요청에 적용된 규칙을 바탕으로 확인합니다. 규칙 문법과 정책에 관한 자세한 내용은 질문과 답변 및 문제 진단을 참고하세요.
STEP 03 / HOME
서버를 선택하고 연결 스위치 켜기
Home으로 돌아와 SERVER에서 방금 가져오거나 수동으로 추가한 서버를 찾아 사용할 항목을 선택합니다. 그룹 제목과 그룹 안의 서버는 서로 다른 단계입니다. 그룹을 펼쳐 실제로 선택한 서버를 확인하세요. 구성이 정책 그룹을 사용하는 경우 해당 요청을 처리하는 정책이 다른 서버를 가리키지는 않는지도 확인해야 합니다. 목록에서 항목을 선택했다는 이유만으로 모든 요청이 그 서버를 사용한다고 판단하지 마세요.
상단의 Not Connected 옆 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시됩니다. 안내를 확인하고 허용한 다음 시스템 요구 사항에 따라 기기 인증을 완료하고 Shadowrocket으로 돌아옵니다. VPN 구성 권한은 시스템 네트워크 연결을 설정하기 위한 것입니다. 권한을 허용해도 서버가 가져와지는 것은 아니며 서버 주소나 비밀번호가 검증되는 것도 아닙니다.
앱으로 돌아온 뒤 상단 연결 상태가 바뀌었는지, 스위치가 켜진 상태로 유지되는지 확인합니다. 시스템 안내가 아직 완료되지 않았다면 먼저 안내를 따르고, 팝업이 표시된 상태에서 스위치를 반복해서 누르지 마세요. 권한을 거부한 적이 있다면 다시 연결을 시작해 안내에 따라 진행합니다. 여전히 구성을 추가할 수 없다면 기기 관리 제한 또는 다른 VPN 연결이 실행 중인지 확인하세요.
스위치가 켜진 상태로 유지되는 것은 로컬 연결이 해당 단계까지 설정됐다는 뜻일 뿐 모든 대상에 접속할 수 있다는 의미는 아닙니다. DNS, 규칙, 서버를 한꺼번에 바꾸지 말고 현재 설정을 유지한 채 다음 단계에서 확인하세요. 연결을 끊으려면 Home 상단 스위치를 끕니다. 연결을 끊은 뒤 자동으로 다시 연결된다면 현상을 기록해 두고 나중에 Settings의 On Demand를 확인하세요.
STEP 04 / CONNECTIVITY TEST
스위치 상태만 보지 말고 연결 결과 확인
먼저 Home에서 Connectivity Test를 사용해 후보 서버를 확인합니다. 테스트 결과는 Test Method, 테스트 대상 및 현재 네트워크에 영향을 받으므로 같은 조건에서 비교해야 합니다. 응답이 있으면 다음 확인을 진행할 근거가 되지만 모든 웹사이트, 프로토콜, 앱이 정상 작동한다는 뜻은 아닙니다. 한 번의 시간 초과 결과도 실제 접속을 함께 확인해 판단해야 합니다.
그다음 브라우저를 열고 실제로 사용하려는 대상에 접속한 뒤 페이지를 새로고침합니다. 오래 열어 둔 탭 하나만 확인하면 캐시된 내용 때문에 새 요청이 성공했는지 가려질 수 있습니다. 직접 연결할 수 있다고 확인된 페이지에도 접속해 기본 네트워크가 정상인지 구분하세요. 기본 네트워크를 사용할 수 없다면 먼저 Wi-Fi 또는 셀룰러 데이터를 복구한 뒤 앱을 확인합니다.
Config를 사용 중이라면 대상 요청에 어떤 규칙이 적용됐고 최종적으로 어떤 정책이 사용됐는지 확인해야 합니다. 현재 버전에서 제공하는 요청 기록을 이용해 대상 도메인과 처리 결과를 살펴볼 수 있습니다. Config에서 일부 연결이 DIRECT를 사용하는 것은 규칙 분배에 따라 정상적으로 발생할 수 있으므로 프록시를 거치지 않았다는 이유만으로 연결 실패라고 판단하지 마세요. 반대로 연결 스위치가 켜져 있어도 필요한 대상에 DIRECT가 잘못 적용되면 접속할 수 없을 수 있습니다.
“테스트는 응답하지만 실제 대상은 열리지 않는” 경우 대상, 사용한 네트워크, 현재 모드 및 서버를 기록한 뒤 한 번에 한 항목만 바꿔 비교합니다. 예를 들어 Config에서 Proxy로 임시 전환한 뒤 같은 대상에 다시 접속합니다. 결과가 달라지면 규칙이나 정책을 우선 확인하고, 그대로라면 서버 매개변수, DNS 또는 대상 자체의 상태를 살펴봅니다. 비교가 끝나면 테스트 모드가 남지 않도록 원래 설정으로 되돌리세요.
실제 접속이 예상대로라면 첫 연결 절차가 완료된 것입니다. 이후 규칙과 On Demand를 하나씩 조정하고, 변경할 때마다 같은 대상으로 다시 확인하세요. 계속 실패한다면 전체 구성을 기록 없이 초기화하지 말고 아래의 증상별 분기에 따라 확인합니다.
STEP 05 / SETTINGS
설정 확인 및 일반적인 실패 원인
문제 해결은 “어느 단계에서 실패했는가”를 파악하는 것부터 시작합니다. 구독을 가져오지 못했는지, 서버 테스트가 시간 초과됐는지, 연결 스위치가 켜진 상태로 유지되지 않는지, 연결 후 일부 요청만 실패하는지 구분하세요. 증상마다 확인할 항목이 다릅니다. 현재 구성과 오류 안내를 보관하고 아래 순서에 따라 범위를 좁히세요. 서버, 규칙, DNS를 동시에 변경하면 어떤 항목이 결과를 바꿨는지 확인하기 어렵습니다.
구독 업데이트 실패: 가져오기 단계 확인
구독 주소가 완전한지, 붙여 넣을 때 공백이나 줄바꿈, 문장 부호가 추가되지 않았는지 확인하고 원래 정보를 제공한 곳에 주소가 여전히 유효한지 문의하세요. 구독 결과가 비어 있는 경우, 인증 실패, 네트워크 시간 초과는 서로 다르게 처리해야 합니다. 기존 항목을 사용할 수 있다면 비교를 위해 보관하세요. 업데이트에 실패했다고 모든 서버를 바로 삭제하지 마세요. 자세한 절차는 Shadowrocket 구독 실패 문제 해결을 참고하세요.
서버 시간 초과: 매개변수를 확인하고 네트워크 비교
Type, Host, Port 및 인증 필드를 다시 확인하고 TLS 및 전송 매개변수가 빠지지 않았는지 살펴봅니다. 서버 매개변수는 그대로 둔 채 사용 가능한 Wi-Fi와 셀룰러 데이터에서 각각 테스트하세요. 결과가 네트워크에 따라 달라지면 네트워크 환경을 먼저 확인합니다. 같은 네트워크에서 특정 서버 하나만 실패한다면 모든 시스템 네트워크 설정을 바로 초기화하지 말고 해당 항목의 상태를 확인하세요.
연결 후 접속 불가: 규칙과 DNS 구분
먼저 기본 네트워크에서 정상적으로 접속할 수 있는 대상을 직접 연결로 사용할 수 있는지 확인한 다음 Config와 Proxy에서 같은 대상의 결과를 비교합니다. Config에서만 실패한다면 적용된 규칙과 정책을 확인하세요. 도메인 이름을 해석하지 못하는 것처럼 보인다면 현재 구성의 DNS 설정을 살펴봅니다. 잘 모르는 DNS 주소를 한꺼번에 여러 개 입력하거나 DNS 변경을 서버 인증 실패의 해결 방법으로 사용하지 마세요.
잦은 재연결 또는 배터리 소모: On Demand 확인
Settings로 이동해 On Demand를 찾아 자동 연결 조건이 설정되어 있는지 확인합니다. 자동 재연결 문제를 확인 중이라면 관련 조건을 잠시 비활성화한 뒤 수동으로 연결해 현상이 바뀌는지 살펴보고, 테스트가 끝나면 실제 필요에 따라 설정을 복구합니다. 배터리 소모는 시스템 배터리 사용량과 사용 시간대를 함께 확인해야 하며, 상태 표시줄에 VPN이 표시된다는 이유만으로 이상이라고 단정할 수 없습니다.
Settings의 Test Method는 Connectivity Test 결과를 해석하는 데 영향을 주며 Diagnostics를 사용해 추가 진단 정보를 수집할 수 있습니다. 스위치를 반복해서 전환하는 것보다 구체적인 조작과 오류 내용을 기록하는 편이 도움이 됩니다. 한 번의 연결 테스트를 위해 Proxy, TCP, UDP의 고급 옵션을 모두 임의로 변경하지 마세요. 특정 옵션이 현재 증상과 관련이 있음을 알고 있을 때만 조정하고, 변경 전 값을 기록해 두세요.
iPad에서도 Home, Config, Settings의 같은 화면 용어를 기준으로 찾으면 됩니다. 가로 화면에서는 공간과 분할 화면 표시가 달라질 수 있으므로 스크린샷의 좌표를 그대로 따라 버튼을 찾을 필요는 없습니다. 기본 절차를 마친 뒤에도 문제가 남아 있다면 문제 진단에서 증상별로 확인하세요. 프로토콜과 설정 항목의 개념은 프로토콜 관련 질문과 답변을 참고하세요.