Shadowrocket
기능 및 주요 설정

기능: Global Routing에는 Config, Proxy, Direct 세 가지 모드가 있으며 각각 규칙에 따른 분기, 프록시 사용, 직접 연결을 뜻합니다. 프로토콜을 선택하는 기능이 아니며 서버 정보를 자동으로 채우지도 않습니다. Home에서 선택한 서버는 일반 PROXY 정책의 프록시 대상이 됩니다. 구성에 따라 특정 정책이나 정책 그룹에서 별도의 대상을 선택할 수도 있습니다.

위치 및 설정 방법: Home에서 Global Routing을 열고 사용 목적에 맞는 모드를 선택한 다음, 현재 서버와 연결 스위치를 확인하세요. 기존 규칙 파일을 사용하는 경우에는 보통 Config를 선택합니다. 특정 대상에 규칙이 적용되는지 확인하려면 잠시 Proxy로 전환해 비교할 수 있고, 현재 네트워크에서 대상에 직접 연결할 수 있는지 확인하려면 Direct를 사용할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌려 임시 설정이 일상 설정으로 남지 않도록 하세요.

주의사항: Proxy에서는 접속되지만 Config에서 실패한다면 서버를 바로 다시 만들기보다 규칙 일치 여부, 정책 대상, 구성 활성화 상태를 먼저 확인하세요. 두 모드에서 모두 실패하면 서버 매개변수, DNS 및 현재 네트워크를 점검하세요. Direct에서 실패했다고 해서 프록시 설정에 문제가 있다고 단정할 수는 없습니다. 현재 네트워크에서 대상에 직접 접속할 수 없는 경우도 있습니다.

기능: Config 모드의 규칙 분기는 대상 도메인, 주소 또는 기타 사용 가능한 정보를 바탕으로 처리 정책을 선택합니다. DOMAIN은 전체 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사와 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 범위를 지정합니다. GEOIP는 주소가 속한 지역을 기준으로 일치하며, USER-AGENT는 요청에서 해당 정보를 확인할 수 있어야 합니다. 일반적인 앱별 분기 기능을 대신하지 않습니다.

위치 및 설정 방법: Config에서 사용할 구성 파일을 찾아 편집하고 규칙을 [Rule] 섹션에 추가하세요. 저장한 뒤 해당 파일이 현재 구성으로 선택되어 있는지 확인하고 Global Routing을 Config로 설정하세요. 규칙은 위에서 아래 순서로 적용됩니다. 일반적으로 구체적인 대상을 먼저 두고, 범위가 넓은 규칙을 뒤에 배치한 다음 FINAL로 나머지를 처리합니다.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.net,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,fc00::/7,DIRECT
FINAL,DIRECT

이 예시에서는 지정한 도메인을 PROXY로 보내고, 나열된 로컬 주소 범위는 DIRECT로 연결하며, 그 밖의 요청은 FINAL,DIRECT로 처리합니다. 예시에 나온 도메인은 구독 링크나 서버 주소가 아닙니다. PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 이 이름들은 처리 방식을 나타내며 서로 다른 프로토콜을 뜻하지 않습니다.

주의사항: 범위가 넓은 규칙을 앞에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다. IP 규칙에는 도메인 해석 결과도 고려해야 합니다. 연결 재사용, 캐시, 앱 자체 동작도 테스트 결과에 영향을 줄 수 있습니다. 수정 후 요청을 다시 보내 실제로 어떤 규칙이 적용됐는지 확인하세요. 연결 아이콘만으로 판단하지 마세요. 전체 구성과 더 많은 작성 방법은 규칙 참고 자료를 확인하세요.

기능: Subscribe는 서버 목록을 가져오고 업데이트하는 기능이며, Add Server는 서버 정보를 하나씩 입력하거나 가져오는 기능입니다. 구독은 규칙 구성 파일이 아니며 서버 목록을 업데이트해도 Config가 교체되지는 않습니다. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2 등의 프로토콜은 입력 항목이 서로 다릅니다. 보유한 정보에 맞는 유형을 선택하고 주소와 포트만으로 설정이 완전하다고 생각하지 마세요.

위치 및 설정 방법: Home의 추가 메뉴에서 Add Server로 이동하세요. 구독이 있다면 Subscribe를 선택하고 서비스 제공업체에서 받은 링크를 붙여 넣어 저장합니다. 서버를 하나씩 추가할 때는 유형, 주소, 포트와 인증 정보를 확인하세요. TLS, SNI, 전송 방식 등의 추가 항목은 제공된 정보를 기준으로 입력합니다. Scan QR Code를 사용하기 전에 QR 코드가 일반 웹 주소가 아니라 예상한 서버 또는 구독 정보를 담고 있는지 확인하세요.

가져오기가 완료되면 Home으로 돌아가 목록에 예상한 항목이 있는지 확인하고 사용할 서버를 선택한 다음 Connectivity Test를 실행하세요. 목록에 표시된다는 것은 내용이 인식됐다는 의미일 뿐, 인증 정보가 올바르거나 연결이 가능하다는 뜻은 아닙니다. 구독 내용이 바뀌면 해당 구독 메뉴에서 업데이트한 뒤 현재 선택된 항목이 여전히 있는지 다시 확인하세요.

주의사항: 구독 링크에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷, 공유 구성 파일 또는 문의 게시물에 노출하지 마세요. 자동 업데이트 시 구독에서 생성된 항목의 로컬 변경 사항이 덮어써질 수 있습니다. 계속 보관해야 하는 수동 항목은 구독 항목과 구분해 관리하세요. 업데이트에 실패하면 링크가 온전한지, 만료되지 않았는지 확인한 뒤 현재 네트워크에서 구독 주소에 접속할 수 있는지 점검하세요. 모든 구성을 반복해서 삭제하는 방식으로 해결하려 하지 마세요.

기능: On Demand는 시스템의 주문형 연결 기능을 사용해 설정된 네트워크 조건이 충족되면 연결을 시도합니다. Global Routing과는 서로 다른 계층의 기능입니다. On Demand는 연결 시작 조건을 제어하고 Global Routing은 연결이 시작된 뒤의 전체 라우팅 방식을 제어합니다. On Demand를 활성화해도 적절한 서버가 자동으로 선택되지 않으며, 만료된 구독이나 잘못된 인증 정보가 수정되지도 않습니다.

위치 및 설정 방법: Settings에서 On Demand 설정으로 이동해 현재 사용할 수 있는 조건과 옵션을 먼저 확인하세요. 자동 연결을 끈 상태에서 수동으로 연결하고 웹페이지 접속을 테스트해 서버와 Config가 정상 작동하는지 확인한 다음 필요한 조건을 활성화하는 것이 좋습니다. 화면에 네트워크 유형이나 네트워크 이름 조건이 있다면 항목별로 확인해 특정 네트워크에서만 활성화하려던 동작이 광범위하게 적용되지 않도록 하세요.

주의사항: 수동으로 연결을 끊은 뒤 다시 연결된다면 스위치가 고장 났다고 단정하지 말고 On Demand의 조건이 여전히 충족되는지 먼저 확인하세요. 연결을 계속 중지해야 한다면 주문형 연결을 비활성화한 뒤 연결 스위치를 조작하세요. 네트워크 전환, 시스템 스케줄링, 다른 VPN 구성도 결과에 영향을 줄 수 있으므로 Wi-Fi와 모바일 네트워크에서 각각 테스트하세요. 연결 아이콘이 표시된 뒤에도 실제 접속이 되는지 확인해야 합니다.

기능: Data에서는 앱에 기록된 트래픽을 확인해 연결 중 데이터가 전송됐는지 파악할 수 있습니다. 화면에 표시된 기간과 분류를 함께 확인하세요. 이 수치는 기기 전체 네트워크 트래픽이나 서비스 제공업체의 사용량과 반드시 일치하지 않습니다. 백그라운드 통신, 프로토콜 오버헤드, 측정 시작 및 종료 시점의 차이로 수치가 다를 수 있습니다.

위치 및 설정 방법: Data를 열고 현재 어떤 기간이나 통계 항목을 보고 있는지 확인하세요. 특정 작업의 전후를 비교하려면 작업 전 수치를 기록하고, 관련 없는 다운로드를 중지한 다음 명확한 대상에 접속해 변화를 살펴보세요. 통계 초기화 옵션이 있다면 과거 기록이 필요한지 먼저 확인한 뒤 초기화하세요. 로컬 통계를 초기화해도 서비스 제공업체의 사용량이 바뀌는 것은 아닙니다.

주의사항: 트래픽이 증가했다는 사실만으로 데이터가 전송됐음을 알 수 있을 뿐, 요청이 반드시 PROXY를 거쳤거나 페이지가 완전히 로드됐다는 뜻은 아닙니다. 트래픽 분기는 요청과 규칙 정보를 확인하고, 사용량은 서비스 제공업체가 제공하는 기록을 확인하세요. 화면을 조작하지 않아도 Data 수치가 계속 증가한다면 연결을 중지하기 전에 백그라운드 앱, 시스템 동기화 및 진행 중인 전송을 점검하세요.

DNS: 도메인 해석 및 구성 상속

기능 및 위치: DNS는 도메인을 IP 주소로 변환합니다. 관련 옵션은 Settings의 DNS 설정과 현재 Config의 [General] 섹션에서 확인할 수 있습니다. 도메인 해석과 프록시 연결은 별개의 단계입니다. 연결이 성립해도 해석 결과가 예상과 다를 수 있으며, 도메인 해석에 성공해도 서버가 대상에 연결할 수 있다는 뜻은 아닙니다.

설정 방법 및 주의사항: 기존 설정을 기록한 뒤 현재 구성에 DNS가 지정되어 있는지, 시스템 DNS나 다른 재정의 설정이 있는지 확인하세요. 변경해야 한다면 직접 파악하고 있는 해석 매개변수만 사용하고 한 번에 하나의 설정만 바꾸세요. DNS, 서버와 규칙을 동시에 바꾸면 어떤 항목이 영향을 미쳤는지 판단하기 어렵습니다. 테스트할 때는 요청을 새로 보내고 시스템, 앱, 클라이언트의 캐시도 고려하세요. DNS 변경을 모든 연결 문제의 해결책으로 여기지 마세요.

Test Method: 테스트 기준을 일관되게 유지

기능 및 위치: Settings의 Test Method에서는 Connectivity Test의 테스트 방식을 선택합니다. 연결 수립과 테스트 대상의 응답 확인처럼 각 방식이 확인하는 단계는 서로 다를 수 있으며 결과가 반드시 동일한 기준을 나타내지는 않습니다. 선택한 방식, 대상과 시간 제한 모두 표시 결과에 영향을 줍니다.

설정 방법 및 주의사항: 현재 선택된 방식의 설명을 읽고 문제 확인 목적에 맞는 옵션을 선택하세요. 서버를 비교할 때는 테스트 방식, 대상과 네트워크 환경을 동일하게 유지하세요. 한 번의 시간 초과만으로 서버가 영구적으로 사용할 수 없다고 단정하지 마세요. 다시 테스트하고 실제 접속을 시도한 뒤 인증, TLS 및 대상의 접속 가능 여부를 확인하세요. 테스트는 통과했지만 웹페이지가 열리지 않는다면 DNS, 규칙과 해당 앱의 동작을 점검하세요.

Today Widget: 빠른 조작 전 상태 확인

기능 및 위치: Today Widget은 시스템에서 지원하는 경우 제공되는 빠른 실행 메뉴입니다. 설정은 Settings에서 같은 이름의 항목을 확인하세요. 추가할 수 있는지는 현재 시스템의 위젯 지원 여부에 따라 달라집니다. 상태를 확인하거나 전환할 때 편리하지만 Home의 전체 서버 및 라우팅 설정을 대신하지는 않습니다.

설정 방법 및 주의사항: 시스템에서 사용할 수 있는 위젯 추가 화면에서 Shadowrocket을 찾아 앱이 제공하는 옵션에 따라 표시 내용을 설정하세요. 빠른 조작을 하기 전에 현재 서버와 Global Routing을 확인하고, 조작 후 앱으로 돌아가거나 실제 접속을 통해 결과를 확인하세요. 시스템에서 위젯 내용 갱신이 지연될 수 있으므로 위젯에 표시된 오래된 상태만으로 연결 결과를 판단하지 마세요.

iCloud 동기화: 백업 후 병합

기능 및 위치: iCloud 관련 기능은 지원되는 Apple 기기 사이에서 앱이 지원하는 데이터를 저장하거나 동기화합니다. 위치는 Settings의 관련 항목에서 확인하세요. 실제 동기화 범위는 화면의 안내를 따르며 서버, 구성, 기록 데이터와 모든 설정이 동기화된다고 가정해서는 안 됩니다.

설정 방법 및 주의사항: 기기에서 예상한 iCloud 계정을 사용 중인지, 시스템에서 앱의 iCloud 사용이 허용되어 있는지 확인하세요. 중요한 구성은 별도로 백업한 다음 동기화를 활성화하거나 복원을 진행하세요. 기기를 바꾼 뒤에는 항목 수, 현재 구성과 선택한 서버를 하나씩 확인하세요. 파일이 나타났다는 이유만으로 상태가 완전히 동일하다고 판단하지 마세요. 동기화는 서비스 제공업체의 이용 권한을 공유하는 기능도 아닙니다. 사용할 수 있는 기기 수는 이용 중인 서비스의 약관을 따릅니다.

Diagnostics: 재현 가능한 문제 정보 수집

기능 및 위치: Diagnostics는 연결 및 네트워크 문제를 찾는 데 도움을 주며, Settings의 관련 메뉴에서 현재 제공되는 진단 항목을 확인할 수 있습니다. 진단의 목적은 막연히 ‘연결할 수 없음’이라고 알리는 데 그치지 않고 실패가 발생한 단계를 기록하는 것입니다.

설정 방법 및 주의사항: 현재 네트워크 유형, Global Routing, 선택한 서버와 접속에 실패한 대상을 기록한 뒤 문제와 관련된 진단을 실행하세요. 변경 전후를 비교할 때는 다른 조건을 동일하게 유지하세요. 결과를 공유하기 전에 구독 링크, 인증 정보, 개인 주소와 기타 민감한 정보를 확인해 삭제하세요. 필요한 오류 설명과 비식별 처리된 정보만 남기세요.

1. 기존 상태를 기록하세요. 현재 Config, Global Routing, 서버와 변경할 옵션을 기록하세요. 구성 파일은 편집 전에 백업하고, 백업에 인증 정보가 포함된 경우 안전하게 보관하세요.
2. 기본 연결을 확인하세요. 서버를 선택해 수동으로 연결하고 Connectivity Test를 실행한 뒤 알려진 대상에 접속하세요. 기본 연결에 실패하면 규칙을 바꾸기 전에 서버 매개변수와 현재 네트워크를 확인하세요.
3. 실제 트래픽 분기를 확인하세요. Config 모드에서 PROXY로 처리되어야 하는 대상과 DIRECT로 처리되어야 하는 대상을 각각 테스트하고 요청에 적용된 정책을 확인하세요. 대상 하나만 테스트해서는 전체 구성이 올바르다고 판단할 수 없습니다.
4. 마지막으로 자동 기능을 활성화하세요. 수동 조작이 안정적으로 작동하는지 확인한 뒤 On Demand를 활성화하거나 동기화 동작을 조정하세요. 네트워크를 전환한 뒤에도 다시 확인해 자동 연결이 조건에 맞게 작동하는지 살펴보세요.
5. 실패하면 한 항목씩 되돌리세요. 가장 최근에 변경한 설정을 복원한 뒤 다시 테스트하세요. 여러 스위치를 동시에 바꾸기보다 재현 가능한 순서를 유지해야 원인을 쉽게 찾을 수 있습니다.

구독을 처음 가져오고 연결을 설정하는 전체 절차는 사용 가이드를 확인하세요. 규칙 작성 방법을 더 알아보려면 규칙 참고 자료를, 특정 오류가 발생했다면 자주 묻는 질문의 항목별 안내를 확인하세요. 아직 클라이언트를 받지 않았다면 먼저 다운로드 안내에서 해당 플랫폼을 선택하세요.