OFFICIAL MANUAL / SETTINGS
먼저 트래픽 처리 방식을 정한 다음 자동 연결과 보조 기능을 설정하세요. 이 안내에서는 iPhone 및 iPad용 Shadowrocket의 주요 기능을 용도, 위치, 설정 방법, 주의 사항 순으로 설명합니다.
시작하기 전에 본인이 보유한 구독 또는 서버 정보를 준비하세요. 화면의 항목 위치와 선택지는 앱 업데이트에 따라 달라질 수 있으므로 기기에 표시되는 영문 명칭을 기준으로 확인하세요. 시스템 요구 사항은 App Store 페이지를 기준으로 합니다.
ROUTING / HOME
Global Routing은 현재 트래픽을 전반적으로 처리하는 방식을 결정합니다. 이는 사용할 서버를 선택하는 것과는 별개입니다. 서버를 선택해도 모든 요청이 해당 서버를 거치는 것은 아닙니다.
Home에서 Global Routing을 찾아 연 다음 Config, Proxy 또는 Direct를 선택하세요. 일상적으로 도메인이나 주소에 따라 처리 방식을 구분하려면 보통 Config를 사용합니다. 규칙이 문제의 원인인지 임시로 확인할 때는 Proxy 또는 Direct로 전환해 비교한 뒤 원래 모드로 되돌리세요.
전환하기 전에 현재 모드, 선택한 서버, 활성화된 Config를 기록해 두세요. Proxy를 사용해도 서버 설정과 네트워크 연결이 정상이어야 하며, Direct라고 해서 모든 대상에 접속할 수 있는 것은 아닙니다. 세 모드는 라우팅 방식을 지정할 뿐, 연결 성공을 보장하지 않습니다.
| 모드 | 주요 기능 | 사용 상황 | 주의 사항 |
|---|---|---|---|
| Config · 구성 | 현재 활성화된 구성의 규칙과 정책에 따라 요청을 처리합니다. | 일상적인 규칙과 라우팅에 사용하며, 프록시·직접 연결·거부할 요청을 구분합니다. | 파일을 편집한 뒤 해당 파일이 활성화되어 있는지 확인하고 규칙 순서도 점검하세요. |
| Proxy · 프록시 | 트래픽을 프록시 방식으로 처리합니다. 시스템 및 구성의 우회 설정도 고려해야 합니다. | 서버가 작동하는지 임시로 확인해 규칙 문제와 연결 문제를 구분할 때 유용합니다. | 기기의 모든 요청이 프록시를 거친다고 단정하지 마세요. 테스트 후에는 평소 사용하는 모드로 되돌리세요. |
| Direct · 직접 연결 | 트래픽을 직접 연결 방식으로 처리합니다. | 로컬 네트워크, 대상 서비스, 프록시 경로에 따른 차이를 확인할 때 사용합니다. | VPN 연결을 끄는 기능은 아닙니다. 클라이언트 연결을 완전히 중지하려면 연결 스위치를 끄세요. |
CONFIG / RULE
규칙은 “이 요청을 어떻게 처리할까?”를 결정합니다. Config에서 현재 구성을 열어 규칙 내용과 순서를 확인하세요. 규칙을 사용하려면 먼저 Global Routing을 Config로 설정해야 합니다. 규칙은 일반적으로 위에서 아래로 확인하며, 일치하는 규칙의 정책을 적용합니다. 따라서 구체적인 조건을 포괄적인 조건보다 위에 두고, 일치하지 않은 요청을 처리하는 FINAL은 목록 맨 아래에 둡니다.
DOMAIN은 지정된 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사 및 하위 도메인과 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드로 일치 항목을 찾습니다. IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 주소 범위를 나타내고, GEOIP는 주소 위치 데이터에 따라 일치 항목을 찾습니다. USER-AGENT는 확인 가능한 요청 정보에 의존하므로 모든 트래픽에 적합하지 않으며, 일반적인 앱 식별 방법으로 사용할 수 없습니다.
정책과 규칙 유형은 따로 이해해야 합니다. PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 거부 규칙은 페이지 리소스, 로그인 또는 알림에 영향을 줄 수 있으므로 규칙을 추가한 뒤에는 홈페이지가 열리는지만 확인하지 말고 관련 기능도 테스트하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT위 내용은 구문 예시이며 완전한 구성 파일이 아닙니다. 첫 번째 규칙이 example.com과 그 하위 도메인에 먼저 적용되므로 해당 요청은 뒤에 있는 DOMAIN-KEYWORD 규칙까지 내려가지 않습니다. FINAL,DIRECT는 나머지 요청을 직접 연결한다는 뜻이며, 모든 상황에 적용할 기본값은 아닙니다. 수정 전에 원본 파일을 보관하고 조건을 한 번에 하나씩 변경한 다음 연결 기록에서 실제로 적용된 규칙을 확인하세요.
HOME / SUBSCRIBE / ADD SERVER
구독은 여러 서버 정보를 관리하는 원본이며, 개별 서버 항목에는 구체적인 연결 매개변수가 저장됩니다. 가져오기에 성공해도 정보가 클라이언트에 전달되었다는 뜻일 뿐, 서버가 작동한다는 보장은 없습니다.
Home에서 추가 메뉴를 열고 Subscribe를 선택한 뒤, 본인이 보유한 구독 주소와 알아보기 쉬운 이름을 입력하세요. 저장 및 업데이트 후 Home으로 돌아가 예상한 서버 그룹과 항목이 표시되는지 확인하고 하나를 선택해 연결하세요. 구독을 해석하지 못하면 링크가 완전한지, 만료되지 않았는지, 반환된 내용이 인식 가능한 구독 데이터인지 먼저 확인하세요.
구독 주소에는 인증 정보가 포함될 수 있으므로 공개된 페이지에 올리거나 도움 요청용 스크린샷에 전체 주소를 노출하지 마세요. 구독을 업데이트하면 해당 구독에서 관리하는 항목이 덮어써질 수 있습니다. 계속 보관할 개인 수정 사항은 먼저 별도로 백업하고 구독 원본과 구분하세요. 구독 그룹을 삭제하기 전에 계속 사용할 정보가 포함되어 있는지 확인하세요.
Home에서 Add Server를 열고 본인이 보유한 서버 정보에 따라 프로토콜을 선택한 뒤 주소, 포트, 인증 및 전송 매개변수를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등은 사용하는 필드가 다르므로 주소만 바꾸고 다른 프로토콜의 매개변수를 그대로 사용하면 안 됩니다.
Scan QR Code로 가져온 경우에도 인식된 프로토콜과 서버 주소를 확인하세요. TLS, SNI, 전송 경로 등의 항목은 보유한 서버 정보를 기준으로 입력하고, 설정 문제를 감추려고 검증 기능을 임의로 끄지 마세요. 저장한 뒤 해당 항목을 선택해 먼저 수동 연결을 확인하고, 그다음 규칙과 라우팅 또는 On Demand를 설정하세요.
AUTOMATION / ON DEMAND
On Demand는 조건에 따라 시스템이 VPN 연결을 요청하거나 처리하도록 설정하는 기능이며, 별도의 서버 구성은 아닙니다. 연결을 시작할 시점을 제어하고, Global Routing과 Config는 연결 후 트래픽 처리 방식을 정합니다. 먼저 수동 모드에서 서버, DNS, 대상 접속이 정상인지 확인한 다음 Settings에서 On Demand 관련 메뉴를 찾으세요.
화면에서 제공하는 조건에 따라 Wi-Fi, 셀룰러 네트워크 또는 도메인 관련 규칙을 설정하세요. Wi-Fi 이름으로 구분해야 한다면 SSID를 정확히 확인하세요. 이름이 비슷해도 완전히 일치하지 않는 네트워크는 같은 조건으로 볼 수 없습니다. 도메인 조건은 시스템의 DNS 확인 및 On Demand 기능에 따라 작동하며, 특정 페이지를 열 때마다 반드시 재연결된다는 뜻도, 모든 앱의 동작을 감시한다는 뜻도 아닙니다.
저장한 다음 해당 네트워크 환경에서 연결 시작, 연결 해제, 재연결 동작을 테스트하세요. 규칙이 여러 개라면 조건, 동작, 표시 순서를 하나씩 확인하세요. 포괄적인 조건이 먼저 적용되면 뒤에 있는 세부 조건이 작동하지 않을 수 있습니다. 연결 스위치를 꺼도 다시 켜진다면 서버 항목을 반복해서 삭제하지 말고 먼저 On Demand 설정을 확인하세요.
테스트할 때는 먼저 시스템이 연결을 설정했는지 확인하고, 다음으로 Global Routing의 현재 모드를 확인한 뒤, 요청에 예상한 규칙이 적용되었는지 살펴보세요. Wi-Fi와 셀룰러 네트워크를 전환하면 기존 연결이 다시 설정될 수 있습니다. 전환 중 잠시 실패한 것만으로 서버 설정에 문제가 있다고 단정할 수는 없습니다. 수동으로 문제를 확인하려면 먼저 On Demand를 일시 중지한 뒤 같은 대상을 반복해서 테스트하세요.
OBSERVATION / DATA
Data는 클라이언트에서 확인할 수 있는 트래픽 통계를 제공해 연결 중 데이터 활동을 파악하도록 돕습니다. Data 화면에서 실제 제공되는 요약 또는 세부 내역을 확인하고, 통계를 집계하는 대상과 기간, 초기화 기능 유무를 먼저 살펴본 뒤 두 작업 간의 변화를 비교하세요. 특정 통계 수치를 서비스 요금이나 남은 데이터로 간주하지 마세요.
특정 작업이 트래픽을 발생시키는지 확인하려면 현재 표시된 값을 기록한 뒤 명확한 작업을 한 번 실행하고 Data로 돌아와 변화를 살펴보세요. 백그라운드 동기화, 알림, 다른 앱에서도 요청이 발생할 수 있습니다. 따라서 수치가 증가했다는 사실만으로 특정 도메인에 PROXY가 적용되었다고 볼 수는 없습니다. 라우팅은 현재 모드와 규칙, 확인 가능한 연결 기록을 함께 살펴봐야 합니다.
통계를 지우려면 먼저 비교에 필요한 정보를 저장하고, 초기화 대상이 구성 파일이 아니라 통계 데이터인지 확인하세요. 클라이언트, 시스템, 서비스 제공자 측 통계는 집계 범위, 연결 캡슐화, 재전송, 초기화 시점에 따라 서로 다를 수 있습니다. 구독 정보에 표시되는 사용량이 구독 원본에서 제공된 값이라면 Data에서 로컬로 확인한 통계와 혼동하지 마세요.
PREFERENCES / SETTINGS
보조 설정은 여러 항목을 한꺼번에 크게 변경하지 마세요. 먼저 현재 값을 기록하고 해당 설정이 앱 전체에 적용되는지 현재 Config에만 적용되는지 확인한 다음, 한 번에 하나씩 바꾸어 테스트하세요.
DNS는 도메인을 주소로 확인하는 기능이며 서버 연결과는 별개의 단계입니다. DNS 동작은 Settings의 옵션과 현재 Config의 구성 내용을 모두 고려할 수 있으므로 변경하기 전에 실제로 적용되는 설정 출처를 확인하세요. 구성 파일의 dns-server = system은 시스템 DNS를 사용한다는 뜻입니다. 설정 항목을 이해하기 위한 예시이며 모든 환경에 권장되는 값은 아닙니다.
도메인 접속에 실패하면 먼저 DNS 확인 실패, 연결 실패, 대상 서비스 응답 오류를 구분하세요. 확인하기 어려워지므로 DNS 리졸버, 라우팅 모드, 서버를 한꺼번에 변경하지 마세요. 사용자 지정 DNS 서버를 입력할 때는 주소와 전송 형식을 확인하고 현재 네트워크에서 접속할 수 있는지도 살펴보세요. DNS 확인이 정상이어도 이후 연결까지 정상이라는 뜻은 아닙니다.
Settings에서 Test Method를 찾아 선택한 테스트 방식과 관련 대상을 확인한 다음 Connectivity Test를 실행하세요. 테스트 방식마다 확인하는 단계가 다르며 테스트 대상, 네트워크 환경, 서버 부하, DNS가 결과에 영향을 줄 수 있습니다. 여러 서버를 비교할 때는 테스트 방식과 대상을 동일하게 유지하고 조건이 다른 결과를 그대로 순위처럼 비교하지 마세요.
테스트가 통과해도 해당 테스트에서 확인한 연결 경로가 응답했다는 뜻일 뿐, 모든 웹사이트와 프로토콜, 앱이 정상 작동한다고 보장하지는 않습니다. 테스트 대상 자체에 접속할 수 없어 실패할 수도 있습니다. 실제로 필요한 대상을 사용해 최종 확인하고 오류 메시지를 함께 살펴보세요. 한 번의 테스트 결과만으로 전체 문제 확인을 대신하지 마세요.
Today Widget은 시스템 구성 요소와 연동되는 보조 기능이며, 사용 가능 여부는 기기의 시스템과 앱이 현재 지원하는 기능에 따라 달라집니다. Settings에서 Today Widget 관련 옵션을 확인한 뒤 시스템의 위젯 추가 화면에서 사용할 수 있는지 살펴보세요. 위젯에 표시되는 정보와 조작 기능은 기기 화면에 실제로 나타나는 내용을 기준으로 하며, 메인 앱과 완전히 같다고 가정해서는 안 됩니다.
위젯 표시가 바로 갱신되지 않으면 Shadowrocket을 열어 실제 연결 상태를 확인한 뒤 시스템 갱신 및 위젯 설정을 살펴보세요. 위젯은 최초 VPN 구성 승인을 대신할 수 없으며 트래픽 정책을 판단하는 유일한 기준으로 삼을 수도 없습니다. 서버나 구성을 변경한 뒤에는 Home과 Config로 돌아가 최종 선택을 확인하세요.
Settings에서 iCloud 관련 동기화 옵션을 확인하고, 시스템에 본인의 Apple 계정으로 로그인되어 있으며 앱에서 관련 iCloud 기능을 사용할 수 있도록 허용했는지도 확인하세요. 동기화를 켜기 전에 화면 설명을 읽고 동기화 대상과 방식을 확인하세요. 앱의 모든 데이터, 시스템 권한, 각 환경설정이 같은 방식으로 동기화된다고 가정하지 마세요.
다른 기기에서 처음 사용할 때는 기존 로컬 구성을 보존한 다음 클라우드에 저장된 내용을 확인하세요. 내용을 확인하지 않은 채 덮어쓰지 않도록 주의하세요. 동기화가 끝나면 서버, Config, 연결 상태를 항목별로 점검하세요. App Store에서 구매한 앱의 재다운로드, iCloud 데이터 동기화, VPN 구성 승인은 서로 다른 절차이므로 대체할 수 없습니다.
TROUBLESHOOTING / DIAGNOSTICS
Diagnostics에서는 문제 확인에 필요한 정보를 수집하거나 살펴볼 수 있습니다. Settings에서 Diagnostics 관련 메뉴를 열고 화면에 표시되는 점검 항목을 확인하세요. 문제 범위를 좁히는 데 도움이 되지만 서버 정보를 자동으로 보완하거나 유효하지 않은 구독 원본을 복구하지는 않습니다.
진단 기록, 구성 파일, 스크린샷에는 접속한 도메인, 서버 주소, 구독 인증 정보 또는 기타 개인정보가 포함될 수 있습니다. 공유하기 전에 인증 정보와 관련 없는 기록을 삭제하고 문제를 재현하는 데 필요한 내용만 남기세요. 구독 주소 전체를 공개하거나 오류 하나를 보여 주려고 개인 설정 전체를 공유하지 마세요.
문제 확인을 마친 뒤에는 평소 사용하는 Global Routing, Config, On Demand 설정으로 복원하고 자주 사용하는 대상에 다시 접속해 확인하세요. 처음 구독 정보를 가져오고 연결하는 방법은 사용법 안내에서 확인할 수 있습니다. 정품 구매, App Store 국가 또는 지역, 구매 항목 복원을 확인하려면 정품 구매 안내를 참조하세요. Shadowrocket은 App Store에서만 구매할 수 있으며, 앱 호환성과 시스템 요구 사항은 App Store 페이지를 기준으로 합니다.