Shadowrocket을 처음 설치하고 아직 첫 연결을 완료하지 않은 사용자를 위한 안내입니다. 시스템 VPN 권한과 서버 설정을 구분하고 Home, Config, Settings의 역할을 살펴봅니다. 권한 허용, 기존 구독 가져오기, 서버 선택, 연결 확인 순서로 진행하면 문제 발생 지점을 파악하기 쉽습니다.
VPN 구성 권한: 무엇을 허용하나요?
Shadowrocket은 Apple 플랫폼의 네트워크 확장 기능을 사용해 트래픽을 처리합니다. 처음 설정할 때 시스템에서 VPN 구성을 추가하도록 허용해 달라는 메시지가 표시됩니다. 이 요청은 Home에 들어가자마자 나타나는 대신, 처음 연결 스위치를 켤 때 표시될 수도 있습니다. 허용을 누른 다음 시스템 안내에 따라 기기 인증을 완료하세요. 요청 시점과 표시 방식은 기기에 따라 다를 수 있습니다.
이 권한은 앱이 기기에서 VPN 연결을 설정하도록 허용합니다. 구독을 가져오는 절차가 아니며 서버 주소, 포트 또는 인증 정보가 자동으로 생성되지도 않습니다. 시스템 VPN 구성, Shadowrocket의 규칙 설정 파일, 서비스 제공업체가 제공하는 서버 정보는 서로 다른 항목입니다. 시스템 권한만 허용해도 프록시가 필요한 대상에 접속할 수 있는 것은 아닙니다.
-
앱 확인
앱 이름이 Shadowrocket인지 확인하세요. App Store의 개발자는 Shadow Launch Technology Limited이며 앱 ID는 932747118입니다. 다시 확인하려면 사이트의 구매와 설치 안내를 참고하세요.
-
Home 열기
앱을 열고 SERVER에 항목이 있는지 확인하세요. 목록이 비어 있다면 서버 정보가 아직 준비되지 않은 것입니다. 이를 시스템 권한 설정 실패로 오해하지 마세요.
-
구성 허용
시스템에서 VPN 구성 추가 요청이 표시되면 허용을 선택하고 기기에서 요구하는 인증을 완료하세요. 요청이 아직 표시되지 않았다면 서버 정보를 준비한 뒤 Home의 연결 스위치를 다시 눌러 보세요.
-
상태 확인
Home으로 돌아가 연결 상태를 확인하세요. 권한 허용이 연결 성공을 의미하지는 않습니다. 서버를 선택한 다음 Connectivity Test와 실제 요청으로 연결을 확인해야 합니다.
Home, Config, Settings: 각 메뉴의 역할
Home에서는 현재 연결, 라우팅 모드, 테스트, 서버 선택을 관리합니다. Config에서는 구성 파일과 그 안의 규칙을 다룹니다. Settings에는 On Demand를 포함한 앱 설정이 있습니다. 처음 사용할 때는 먼저 Home에서 수동 연결을 한 번 정상적으로 완료한 다음 다른 메뉴의 동작을 조정하세요. 그러면 연결 문제와 자동 연결 문제를 구분하기 쉽습니다.
Home의 연결 스위치는 기기에서 연결을 시작하거나 중지합니다. Global Routing은 요청을 어떤 방식으로 라우팅할지 정합니다. Connectivity Test는 연결 진단 기능을 제공합니다. SERVER에는 가져오거나 직접 추가한 서버가 표시됩니다. 네 영역은 함께 작동하지만 서로를 대신하지 않습니다. 라우팅 모드를 바꿔도 잘못된 비밀번호가 수정되지는 않으며, 서버를 선택해도 구성 파일의 규칙이 자동으로 채워지지는 않습니다.
- 현재 연결 확인: Home으로 돌아가 연결 스위치와 상태 표시를 확인하세요. 앱이 화면에 열려 있다는 이유만으로 연결된 것으로 판단하지 마세요.
- 라우팅 규칙 확인: Config에서 실제로 사용 중인 구성 파일을 확인한 뒤 규칙 순서와 정책을 살펴보세요.
- 자동 연결 확인: Settings → On Demand에서 조건부 연결이 활성화되어 있는지와 관련 조건을 확인하세요.
SERVER 목록: 먼저 가져온 다음 기본 서버 선택
이 안내는 사용자에게 이미 서비스 제공업체와 구독이 있다고 가정합니다. 구독은 이용 중인 서비스 제공업체에서 받으세요. Shadowrocket은 App Store에서 한 번 구매하는 상용 폐쇄형 앱입니다. 앱 구매와 서버 이용 요금제는 별개입니다. 앱 구매와 사용할 수 있는 서버 준비는 서로 다른 절차이므로 SERVER가 비어 있다면 먼저 본인의 연결 정보를 준비하세요.
구독을 가져오려면 Home 오른쪽 위의 “+”를 누르고 Type에서 Subscribe를 선택한 다음 본인의 구독 링크를 붙여넣고 저장하세요. Home으로 돌아가 서버 항목이 표시되는지 확인하고 필요하면 구독을 업데이트합니다. 구독 주소에는 인증 정보가 포함되는 경우가 많으므로 전체 링크를 공개 스크린샷이나 문의 내용에 올리지 마세요. 서버를 직접 추가할 때는 서비스 제공업체가 안내한 프로토콜에 맞는 Type을 선택하세요.
보유한 정보에 맞춰 가져오기 방식 선택
구독 링크가 있는 경우
- Home → “+” → Type → Subscribe。
- 서비스 제공업체에서 받은 링크를 붙여넣고 저장하세요.
- 구독 업데이트 결과와 SERVER에 실제로 표시되는 항목을 확인하세요.
- 업데이트 후 현재 선택된 서버를 다시 확인하세요.
단일 서버 설정 정보가 있는 경우
- Home → “+” → Type에서 해당 프로토콜을 선택하세요.
- 서버 주소, 포트, 인증 정보를 항목별로 입력하세요.
- 제공받은 정보를 기준으로 TLS와 전송 설정을 확인하세요.
- 저장한 뒤 SERVER로 돌아가 해당 항목을 선택하세요.
두 방법 모두 이미 보유한 정보를 가져오는 절차입니다. 가져온 후에는 기본 서버를 선택하고 연결을 확인해야 합니다.
Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 입력 항목과 인증 방식이 서로 다릅니다. 이름이 비슷하다는 이유로 한 프로토콜의 설정값을 다른 Type에 복사하지 마세요. 포트는 서비스 제공업체가 안내한 값을 사용하세요. 예를 들어 443은 제공업체가 명시한 경우에만 입력해야 하며 모든 프로토콜에 공통으로 사용할 수 있는 포트가 아닙니다. TLS 서버 이름도 IP 주소 하나로 간단히 대체할 수 없습니다.
- SERVER에서 사용할 항목을 누르고 기본 선택을 나타내는 점 표시가 해당 항목으로 이동했는지 확인하세요.
- ‘항목 선택’과 ‘편집 화면 열기’를 구분하세요. 설정을 편집하고 저장해도 해당 항목이 현재 기본 서버로 선택된 것은 아닐 수 있습니다.
- 기본 서버는 현재 서버를 참조하는 프록시 경로에 사용됩니다. Config의 정책 그룹은 별도로 서버나 선택 방식을 지정할 수 있습니다.
- 구독 업데이트 후 항목이 사라지거나 이름이 바뀌었다면 기본 서버 선택, 정책 참조, 연결 결과를 다시 확인하세요.
Global Routing: 모드와 규칙의 관계
Global Routing은 트래픽 처리 방식을 바꾸지만 서비스 제공업체 계정이나 서버 설정은 바꾸지 않습니다. 처음 문제를 확인할 때는 현재 모드를 기록하세요. Proxy에서는 연결되지만 Config에서 문제가 생긴다면 비밀번호를 바로 바꾸거나 앱을 다시 설치하기보다 규칙 적용 결과와 정책 참조를 먼저 확인하세요.
Config
권장현재 구성 파일에 있는 규칙과 정책에 따라 요청을 처리합니다. 결과는 프록시일 수도 있고 DIRECT일 수도 있습니다. 앞선 조건에 일치하지 않으면 FINAL 등의 기본 규칙이 처리 방식을 결정합니다. 먼저 구성 파일이 정상적으로 작동하는지 확인한 다음 일상적인 모드로 사용하세요.
적합한 경우: 분명한 라우팅 규칙이 있는 구성을 일상적으로 사용할 때
Proxy
앱이 처리하는 요청을 프록시 모드로 전달합니다. 일반 라우팅 규칙의 영향을 일시적으로 제외해 확인할 때 사용할 수 있습니다. 서버를 사용할 수 없는 상태라면 Proxy로 바꿔도 연결 설정 문제는 해결되지 않습니다.
적합한 경우: 프록시 경로를 확인하고 Config 결과와 비교할 때
Direct
앱이 처리하는 요청을 직접 연결 방식으로 처리합니다. VPN 연결을 중지하는 것과는 다릅니다. 앱 연결은 계속 켜져 있어도 요청은 직접 연결 경로를 사용할 수 있습니다.
적합한 경우: 로컬 네트워크에서 대상에 직접 접속할 수 있는지 비교할 때
Scene
구성된 Scene 조건에 따라 라우팅 동작을 결정합니다. 선택하기 전에 Scene의 설정 내용과 현재 네트워크를 확인하세요. Scene은 사용할 수 있는 서버를 자동으로 찾는 기능이 아닙니다.
적합한 경우: Scene을 설정해 두었고 환경에 따라 동작을 전환해야 할 때
Config를 이해하려면 자주 쓰이는 규칙 키워드 네 가지부터 살펴보세요. DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치시키고, GEOIP는 IP의 지리적 위치를 기준으로 일치시킵니다. IP-CIDR은 주소 대역을 기준으로 일치시키며, FINAL은 앞선 규칙에 일치하지 않은 요청에 최종 정책을 적용합니다. 규칙은 보통 순서대로 확인하므로 구체적인 조건을 포괄적인 조건보다 앞에 두세요.
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
연결 스위치와 Connectivity Test: 연결 확인 방법
서버를 선택한 다음 Home에서 연결 스위치를 켜세요. 시스템에서 권한을 요청하면 먼저 허용하세요. 스위치가 바로 꺼진다면 시스템 안내와 서버 설정을 확인하세요. 스위치가 켜져 있다는 것은 해당 연결 상태를 유지하고 있다는 뜻일 뿐, 모든 대상에 접속할 수 있다는 의미는 아닙니다. 대상의 응답을 테스트하고 실제 요청도 보내야 합니다.
연결 전 확인
- 확인 위치
- Home → SERVER
- 현재 선택 항목
- 기본 선택을 나타내는 점 표시가 사용할 서버에 있는지 확인
- 라우팅 모드
- Home → Global Routing
- 설정값의 기준
- 주소, 포트, 인증 정보는 서비스 제공업체가 안내한 값 사용
연결할 대상을 먼저 확인한 뒤 스위치를 켜세요. 한 번에 변수 하나만 변경하세요.
연결 후 확인
- 확인 위치
- Home → Connectivity Test
- 결과 확인
- 응답이 오거나 시간 초과되는지 테스트
- 실제 요청
- 접속하려는 대상 페이지 열기
- 조건 비교
- 같은 서버와 네트워크를 사용하고 Global Routing 모드를 기록
테스트 결과는 해당 테스트 조건에만 해당하며 실제 서비스 요청을 대신할 수 없습니다.
SERVER의 지연 시간 테스트와 Connectivity Test는 서로 다른 기능입니다. 지연 시간 결과는 선택한 테스트 방식에서의 응답 상태를 보여줄 뿐, 대역폭을 보장하지 않습니다. Connectivity Test 역시 테스트 대상, DNS, 라우팅 정책, 네트워크 상태의 영향을 받을 수 있습니다. 테스트는 성공했지만 특정 페이지가 열리지 않는다면 해당 페이지의 도메인, 적용된 규칙, 접속 경로를 계속 확인하세요.
- 스위치는 켜져 있지만 테스트가 시간 초과됨: 서버를 그대로 둔 채 로컬 네트워크를 확인한 다음 주소, 포트, 인증, TLS 설정을 점검하세요.
- Proxy에서는 정상이나 Config에서는 문제가 발생함: Config의 규칙 순서와 FINAL, 정책 참조가 사용할 수 있는 경로를 가리키는지 확인하세요.
- 테스트는 정상이지만 대상에 문제가 있음: 대상과 구체적인 증상을 기록하고 요청이 직접 연결되는지, 예상한 정책이 적용되는지 확인하세요. 한 번의 테스트 결과로 모든 요청을 판단하지 마세요.
- Wi-Fi에서는 정상이나 셀룰러에서는 문제가 발생함: 같은 서버와 라우팅 모드로 다시 테스트하세요. 네트워크와 서버를 동시에 바꾸면 원인을 찾기 어렵습니다.
Settings → On Demand: 수동 연결을 확인한 뒤 설정
On Demand는 설정한 조건에 따라 연결 동작을 실행합니다. ‘언제 연결할지’를 다루는 기능이지 서버 사용 가능 여부를 해결하는 기능은 아닙니다. 처음 사용할 때는 수동 연결, Connectivity Test, 실제 요청의 결과를 먼저 확인한 뒤 Settings → On Demand에서 조건을 살펴보세요.
연결을 끈 뒤 잠시 후 다시 연결되어 있다면 On Demand가 활성화되어 있는지, 현재 네트워크가 설정 조건에 해당하는지 확인하세요. 이런 현상을 바로 스위치 고장으로 판단하면 정상적인 조건부 연결 동작을 오류로 오해할 수 있습니다. 조건을 변경한 뒤에는 같은 네트워크에서 다시 확인하고 앱 상태를 기록하세요.
- Home에서 현재 서버와 Global Routing을 확인한 다음 수동 연결을 먼저 테스트하세요.
- Settings → On Demand를 열어 활성화 상태와 설정된 네트워크 조건을 확인하세요.
- 필요에 따라 조건을 조정하세요. 처음 문제를 확인할 때 규칙 파일이나 서버 설정을 동시에 바꾸지 마세요.
- Home으로 돌아가 예상한 네트워크 환경에서 연결 동작을 확인하고 설정한 내용과 일치하는지 살펴보세요.