공식 매뉴얼 / 첫 연결
Shadowrocket 사용법
가져오기, 라우팅, 연결, 확인 순서로 첫 설정을 진행합니다. 이 문서는 iPhone과 iPad를 기준으로 안내하며, 먼저 연결을 확인한 다음 규칙 설정과 일상적인 사용을 다룹니다.
먼저 앱의 기본 설정을 그대로 두고 On Demand나 복잡한 규칙은 추가하지 않는 것이 좋습니다. 이 문서와 메뉴 배치가 다르면 버튼 위치만 보고 조작하지 말고, 앱에 표시된 영문 설정 이름을 기준으로 찾으세요.
단계 01 / SERVER 목록 준비
서버 추가 또는 Subscribe 가져오기
Shadowrocket를 열고 Home으로 이동합니다. 처음 사용하는 경우 SERVER 영역에 서버가 없을 수 있습니다. 이는 연결 정보가 아직 추가되지 않았다는 뜻이며, 설치 실패가 아닙니다. 먼저 보유한 정보가 어떤 종류인지 확인하세요. 서버 정보를 가져오는 구독 링크인지, 프로토콜·주소·포트·인증 정보가 포함된 단일 서버 정보인지 구분하면 됩니다. 두 방식 중 하나만 선택하면 되며, 같은 정보를 여러 번 추가할 필요는 없습니다.
구독 링크가 있는 경우: Subscribe 사용
Home에서 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 다음 Type을 열고 Subscribe를 선택합니다. 서비스 제공자에게 받은 전체 구독 링크를 URL 필드에 붙여 넣습니다. 화면에 Remark 항목이 있으면 알아보기 쉬운 이름을 입력할 수 있습니다. 저장하기 전에 링크의 시작과 끝, 쿼리 매개변수를 확인하세요. 복사할 때 공백, 줄바꿈, 채팅 문구가 섞이지 않았는지도 살펴봅니다. 로그인용 관리 페이지 주소를 구독 주소로 사용하지 마세요.
확인한 뒤 Done을 눌러 저장하고 구독 내용을 가져올 때까지 기다린 다음 Home으로 돌아가 결과를 확인합니다. 정상적으로 가져오면 이름만 남는 것이 아니라 구독 그룹과 서버 항목이 표시됩니다. 그룹은 있지만 서버가 없다면 기기에서 구독 주소에 접속할 수 있는지, 링크가 유효한지, 응답 내용이 앱에서 지원하는 구독 형식인지 먼저 확인하세요. 이 단계에서는 상단 연결 스위치를 반복해서 눌러도 구독 내용이 채워지지 않습니다. 먼저 가져오기 문제를 해결해야 합니다.
구독 링크에는 접속 정보가 포함될 수 있으므로 계정 정보처럼 안전하게 보관하세요. 전체 링크를 공개하거나 알 수 없는 웹페이지에 붙여 넣어 변환하지 마세요. 나중에 업데이트할 때는 기존 구독을 업데이트하면 됩니다. 같은 링크를 다시 추가하면 그룹이 중복되어 선택한 서버와 관리 중인 그룹을 구분하기 어려워질 수 있습니다.
단일 서버 정보가 있는 경우: Type에 맞춰 입력
단일 서버 정보를 보유한 경우에도 더하기 버튼을 눌러 Add Server로 이동하고, 올바른 Type을 선택한 뒤 해당 필드를 입력합니다. Shadowsocks, VMess, VLESS, Trojan 등은 인증 및 전송 매개변수가 서로 다르므로 Address와 Port만 입력했다고 설정이 끝난 것은 아닙니다. 주소, 포트, 비밀번호 또는 UUID, TLS, Server Name, 전송 방식 등을 보유한 서버 정보와 하나씩 대조해 입력하세요. 서비스 제공자가 안내하지 않은 옵션은 추측으로 변경하지 마세요.
저장한 다음 Home으로 돌아가 SERVER 목록에 대상 항목이 표시되는지 확인합니다. 알아볼 수 있는 QR 코드가 있다면 Scan QR Code로 가져올 수 있습니다. 스캔한 뒤에도 Type, 주소와 주요 매개변수가 보유한 정보와 일치하는지 확인하세요. 이름만 보고 판단하면 안 됩니다. 여기까지는 정보 입력만 완료된 상태이며 아직 연결을 시작하지 않았습니다. 다음 단계에서 Global Routing을 선택해 라우팅 문제를 서버 장애로 오해하지 않도록 합니다.
단계 02 / 요청 경로 선택
Global Routing의 세 가지 모드
Home으로 돌아가 Global Routing을 누르고 현재 선택된 모드를 확인합니다. 여기서는 요청을 어떻게 처리할지 결정하며, 서버를 제공하거나 서버 인증을 대신하지 않습니다. 이 문서에서는 구성(Config), 프록시(Proxy), 직접 연결(Direct)로 표기합니다. 조작할 때는 화면에 표시된 Config, Proxy, Direct를 기준으로 하세요. 모드를 선택한 뒤 Home으로 돌아와 Global Routing의 현재 값이 변경되었는지 다시 확인합니다.
| 모드 | 요청 처리 방식 | 처음 사용할 때 확인할 점 |
|---|---|---|
| 구성(Config) | 현재 적용 중인 구성의 규칙에 따라 정책을 선택합니다. | 적용 중인 구성이 있고 규칙이 참조하는 정책에 해당 서버가 연결되어 있는지 확인합니다. |
| 프록시(Proxy) | 일반적으로 연결을 현재 프록시 정책으로 보냅니다. | 선택한 서버가 올바른지 확인하고 서버 연결을 먼저 테스트합니다. |
| 직접 연결(Direct) | 현재 프록시 서버를 거치지 않고 대상에 직접 연결합니다. | 기본 네트워크를 비교할 때 적합하며 프록시 서버가 작동한다는 증거로 사용할 수는 없습니다. |
첫 확인에는 Proxy 사용
규칙 구성을 아직 준비하지 않았다면 프록시(Proxy)를 임시로 선택해 현재 서버가 연결되는지부터 확인할 수 있습니다. 이는 문제 해결 순서일 뿐이며 일상적인 사용에서도 이 모드를 유지해야 한다는 뜻은 아닙니다. Proxy 상태에서도 실제 요청 결과를 확인해야 하며, 모든 조건에서 시스템 트래픽 전체가 같은 경로를 사용한다고 해석하지 마세요.
사용 가능한 구성이 있고 도메인이나 주소에 따라 트래픽을 분리하려면 구성(Config)을 선택합니다. 이름이 비슷하지만 역할이 다른 두 메뉴를 구분해야 합니다. Global Routing의 Config는 라우팅 모드이고, 앱의 Config 페이지는 구성 파일을 관리하는 곳입니다. Subscribe를 가져와 서버 목록을 받았다고 해서 사용 목적에 맞는 규칙 구성까지 준비된 것은 아닙니다. 두 항목을 각각 확인하세요.
Config 사용 시 적용 중인 구성 확인
Config 페이지에서 사용할 구성이 현재 구성으로 지정되어 있는지 확인한 뒤 Home으로 돌아가 Config를 선택합니다. 규칙은 순서대로 적용되므로 요청이 어떤 규칙에 일치하는지, 해당 규칙이 어떤 정책을 참조하는지에 따라 최종 경로가 달라집니다. 첫 연결을 위해 익숙하지 않은 규칙을 한꺼번에 붙여 넣지 마세요. 규칙 순서, 정책 참조와 DNS에 대한 자세한 내용은 전체 매뉴얼을 참고하세요. 이 페이지에서는 먼저 같은 조건으로 반복할 수 있는 연결 테스트를 진행합니다.
직접 연결(Direct)은 기본 네트워크를 확인하는 비교 기준으로 사용할 수 있습니다. Direct로 바꿔도 원래 직접 접속할 수 있는 웹페이지가 열리지 않으면 서버 매개변수를 계속 수정하기보다 기기의 네트워크를 먼저 확인하세요. 모드를 정했으면 다음 단계에서 서버를 선택하고 연결을 켭니다.
단계 03 / 서버 선택 및 권한 허용
SERVER에서 서버를 선택한 뒤 연결 켜기
Home의 SERVER 목록에서 이번에 테스트할 서버를 찾고 항목 앞의 원형 버튼을 눌러 선택합니다. 선택 표시가 대상 항목에 있는지 확인하세요. 서버 이름은 구분을 위한 메모일 뿐, 매개변수나 사용 가능 여부 또는 실제 연결 경로를 보장하지 않습니다. 처음 테스트할 때는 정보가 온전히 확인된 항목 하나를 선택해 고정하세요. 기록 없이 서버를 여러 개 바꾸면 설정과 결과를 연결해 판단하기 어렵습니다.
항목을 먼저 선택한 다음 연결 켜기
Global Routing과 선택한 서버를 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 연결 전에는 Not Connected와 같은 상태가 표시될 수 있습니다. 스위치를 켠 뒤 상태가 갱신될 때까지 기다리고 연결이 유지되는지 확인하세요. 서버 상세 화면을 열어 매개변수를 수정하는 것과 항목 앞의 원형 버튼을 눌러 현재 서버를 선택하는 것은 서로 다른 작업입니다. 상세 화면만 열어 보고 항목을 선택하지 않았다면 실제 연결은 이전 서버를 사용할 수 있습니다.
구성(Config)을 사용하는 경우 규칙이 특정 정책이나 정책 그룹을 참조할 수 있으므로 모든 요청이 Home에서 방금 선택한 항목을 사용하는 것은 아닙니다. 특정 서버만 확인하려면 먼저 프록시(Proxy)로 임시 전환해 비교한 다음 Config로 돌아가 라우팅을 확인하세요. 연결 중에는 서버 매개변수, 구성 파일, DNS를 동시에 수정하지 마세요. 한 번의 변경으로 여러 변수가 달라질 수 있습니다.
VPN 구성 추가 시스템 안내 이해하기
처음 연결을 켤 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 이는 앱이 시스템 네트워크 기능을 통해 트래픽을 처리하는 데 필요한 연결 권한이며, 사용자가 이미 보유한 구독 정보와는 별개입니다. 사용자가 직접 시작한 작업에 대한 안내이고 앱 이름이 Shadowrocket인지 확인한 뒤 허용을 선택하고 시스템 지침에 따라 기기 인증을 완료하세요. 인증이 끝나면 앱으로 돌아와 상단 스위치와 연결 상태가 안정적으로 유지되는지 확인합니다.
이전에 시스템 안내를 취소했더라도 구독을 반복해서 가져올 필요는 없습니다. 서버 정보와 시스템 권한은 별개의 단계입니다. 연결을 다시 켜서 시스템 안내에 따라 VPN 구성과 권한을 확인하세요. 기기에 관리 정책이 적용되어 있다면 먼저 관련 제한 사항을 확인해야 합니다. 다른 VPN 연결이 시스템 네트워크를 동시에 사용하지 않도록 하세요. 테스트 중에는 필요한 연결 하나만 유지합니다.
시스템에 VPN 상태 표시가 나타나거나 앱 스위치가 켜져 있더라도 연결 통로가 시작되었다는 뜻일 뿐입니다. 대상 웹사이트 접속, 인증 또는 규칙 적용이 올바르다는 것을 단독으로 증명하지는 않습니다. 권한을 허용한 뒤 규칙을 더 추가하지 말고 바로 확인 단계로 넘어가 실제 요청 결과를 확인하세요.
단계 04 / 실제 결과 확인
Connectivity Test 실행 및 라우팅 확인
연결 상태가 안정되면 Home에서 Connectivity Test를 눌러 테스트가 끝날 때까지 기다린 다음 화면의 결과를 확인합니다. 이 테스트는 특정 대상과 당시 네트워크 조건에 대한 결과를 제공합니다. 명백한 연결 실패를 파악하는 데 도움이 되지만 모든 웹사이트, 프로토콜 또는 앱이 정상이라는 뜻은 아닙니다. 테스트가 성공해도 실제 접속을 확인해야 하며, 실패했다면 실패 범위에 따라 원인을 살펴봐야 합니다.
같은 대상으로 연결 전후 비교
브라우저를 열고 실제로 사용하려는 주소가 정확한지 확인한 뒤 접속해 페이지 본문과 필요한 리소스가 로드되는지 살펴봅니다. 이전 페이지가 그대로 보이는 경우 캐시를 표시하고 있을 수 있으므로 새로운 연결의 증거로 볼 수 없습니다. 페이지를 새로고침하거나 같은 서비스의 다른 페이지를 열어 실제 요청이 발생하도록 하세요. 로그인이 필요한 서비스라면 네트워크 요청 실패와 계정 권한 안내를 구분해야 합니다.
먼저 네트워크, 서버, 테스트 대상을 고정하고 한 번에 하나의 설정만 바꾸세요. 예를 들어 같은 서버에서 Proxy와 Config를 비교하거나 Proxy를 유지한 채 이미 보유한 다른 서버를 선택할 수 있습니다. 이렇게 비교해야 결과를 바탕으로 문제를 좁힐 수 있습니다. Wi-Fi를 바꾸고 서버를 교체하고 TLS를 수정하고 구성을 업데이트한 뒤 한 번의 결과만으로 원인을 판단하지 마세요.
Config 확인 시 규칙과 정책 살펴보기
일상적인 사용에 구성(Config)을 적용하려면 기본 연결이 확인된 뒤 해당 모드로 돌아가 같은 접속을 반복합니다. 앱의 요청 기록이나 진단 메뉴에서 대상 도메인, 적용된 규칙, 최종 정책이 예상과 일치하는지 확인하세요. 웹페이지가 열린다고 해서 반드시 프록시를 거친 것은 아닙니다. 규칙에 따라 DIRECT로 연결되었을 수도 있습니다. 반대로 규칙에 PROXY가 지정되어 있다면 해당 정책이 실제로 사용 가능한 서버를 참조하는지 확인해야 합니다.
Data 페이지의 업로드·다운로드 트래픽은 참고용으로 볼 수 있지만 수치가 증가했다고 특정 요청이 의도한 대로 라우팅된 것은 아닙니다. 백그라운드 작업도 트래픽을 발생시킵니다. 작업 시간, 테스트 대상, 해당 기록을 대조한 다음 요청이 처리된 경로를 확인하는 것이 더 정확합니다. 규칙 세부 정보를 확인하려면 전체 매뉴얼을 참고하세요. 처음 설정할 때 통계와 진단 설정을 모두 조정할 필요는 없습니다.
Connectivity Test, 실제 접속, 예상한 라우팅을 모두 확인했다면 현재 설정을 유지해도 됩니다. 다음에 변경하기 전에 사용한 네트워크, 서버 메모, Global Routing 모드, 현재 구성을 기록해 두세요. 여전히 실패한다면 아래 순서대로 확인하고, 모든 구성을 먼저 삭제한 뒤 다시 시작하지 마세요.
단계 05 / 한 번에 변수 하나씩 확인
실패한 단계별로 흔한 문제 확인
먼저 문제가 발생한 단계를 구분합니다. 구독을 가져오지 못했는지, 연결 스위치가 유지되지 않는지, 테스트가 실패하는지, 일부 웹페이지에서만 문제가 생기는지 확인하세요. 증상마다 확인할 항목이 다릅니다. 문제를 해결하는 동안 기존에 작동하는 정보는 보존하고 한 번에 하나만 변경한 뒤 같은 테스트를 반복하세요. 문제가 해결되지 않더라도 방금 변경한 내용이 영향을 주었는지 판단할 수 있습니다.
가져온 뒤 서버가 없음: 구독 내용 확인
SERVER 목록이 비어 있다면 구독 설정으로 돌아가 URL 전체가 올바른지, 계정 관리 페이지 주소를 잘못 사용하지 않았는지 확인합니다. 기기의 기본 네트워크가 정상인지 확인한 다음 기존 구독을 업데이트하세요. 구독 주소가 유효하더라도 오류 안내 페이지가 반환될 수 있으며, 접근 상태나 형식에 대해 서비스 제공자의 확인이 필요할 수도 있습니다. 앱 구매 내역, VPN 권한, 구독 응답 내용은 서로 대체할 수 없습니다. 이 단계에서 Global Routing을 바꿔도 빈 목록은 해결되지 않습니다.
스위치가 유지되지 않음: 권한과 매개변수 확인
연결을 켠 직후 중단된다면 앱 안내를 먼저 확인한 다음 시스템 VPN 구성 권한이 승인되었는지, 기기 관리 제한이 있는지, 다른 VPN 연결이 사용 중인지 살펴봅니다. 이어 현재 서버의 Type, Address, Port와 인증 정보를 확인하세요. TLS, Server Name, 전송 경로 등은 서버 정보에 명시된 경우에만 해당 값으로 설정합니다. 비워 두는 것과 잘못된 값을 입력하는 것은 다릅니다. 기기의 날짜와 시간이 크게 틀리면 인증서 확인에도 영향을 줄 수 있으므로 올바른 시간으로 맞추세요.
연결은 되지만 테스트 실패: 네트워크와 서버를 따로 확인
먼저 연결을 끄고 기기의 기본 네트워크에서 접속 가능한 것으로 확인된 웹페이지가 열리는지 확인합니다. Wi-Fi에 웹 인증이 필요하다면 먼저 인증을 완료하세요. 기본 네트워크가 정상이라면 다시 연결하고 Proxy와 같은 테스트 대상을 유지한 채 결과를 확인합니다. 다른 서버 정보가 있다면 나머지 조건은 그대로 둔 채 다른 항목을 선택해 비교할 수 있습니다. 한 번 실패했다고 모든 서버 정보를 다시 만들어야 한다고 판단하지 마세요.
기록에 인증, 연결 시간 초과, 인증서 관련 내용이 표시되면 해당 증상을 현재 서버 매개변수와 대조해 확인하세요. 안내를 없애려고 인증서 확인을 임의로 끄거나 보안 설정을 완화하지 마세요. 서버 측 요구 사항을 알 수 없다면 서비스 제공자에게 정확한 안내를 받은 뒤 해당 필드를 수정하세요.
Proxy는 되지만 Config에서 문제 발생: 라우팅 확인
같은 네트워크, 서버, 대상을 사용했을 때 Proxy는 되지만 Config에서 작동하지 않는다면 앱을 다시 구매하기보다 현재 구성, 규칙 순서, 정책 참조와 DNS를 먼저 확인하세요. Config 페이지에서 예상한 파일이 선택되어 있는지 확인한 뒤 문제가 발생한 요청이 어떤 규칙에 일치했는지, DIRECT, REJECT 또는 사용할 수 없는 정책으로 전달되었는지 살펴봅니다. 실제로 적용된 규칙부터 확인하고 이해하지 못하는 규칙을 한꺼번에 삭제하지 마세요.
특정 서비스에서만 문제가 있다면 여러 도메인을 사용하는지, 별도의 로그인 인터페이스가 있는지, 계정 상태의 영향을 받는지 구분해야 합니다. DNS 설정이 일치하지 않으면 도메인 확인 결과와 연결 결과가 달라질 수도 있지만, 처음 문제를 확인할 때 여러 DNS 방식을 동시에 추가하지 마세요. 증상별 자세한 설명은 FAQ를 참고하세요. 구성 파일과 일상적인 관리 방법을 자세히 알아보려면 전체 매뉴얼을 이어서 읽어 보세요.
첫 설정을 마치려면 SERVER에 유효한 항목이 있고, Global Routing이 대상에 맞게 선택되어 있으며, 시스템 권한이 승인되고, 연결이 안정적으로 유지되며, 실제 요청 결과까지 확인되어야 합니다. 나중에 문제가 생기면 같은 순서로 되짚어 보세요. 모두 삭제한 뒤 다시 가져오는 것보다 변화가 발생한 지점을 찾기 쉽습니다.