Shadowrocket 기능 및 설정

ROUTING MODE

Global Routing 세 가지 모드

Global Routing은 연결이 켜져 있을 때 적용할 전체 라우팅 방식을 결정합니다. Home에서 Global Routing을 열고 용도에 따라 Config, Proxy 또는 Direct를 선택하세요. 각 모드는 구성, 프록시, 직접 연결에 해당하지만 실제 조작 시에는 영어 옵션을 확인해야 합니다. 이 설정은 Home의 연결 스위치와 별개입니다. 모드를 선택한 뒤에도 연결이 켜져 있는지 확인하세요.

규칙에 따라 트래픽을 분기하려면 Config를 사용하세요. Config 화면에서 현재 활성화된 구성을 확인한 다음 Home으로 돌아가 서버 선택을 확인합니다. 파일을 목록에 가져왔다고 해서 현재 구성으로 선택된 것은 아닙니다. 파일에 PROXY가 지정되어 있어도 서버 매개변수가 유효하다는 뜻은 아닙니다.

대상에 접속할 수 없다면 Proxy로 임시 비교 테스트를 진행할 수 있습니다. Proxy에서는 성공하고 Config에서는 실패한다면 모든 서버를 다시 만들기보다 적용된 규칙, 정책, DNS를 확인하세요. Direct로 테스트할 때도 대상과 네트워크 조건을 동일하게 유지해야 합니다. 비교를 마친 뒤에는 원래 모드로 되돌려 문제 확인용 설정이 계속 적용되지 않도록 하세요.

RULE MATCHING

규칙 유형과 정책

규칙 라우팅은 요청 조건과 처리 정책을 연결합니다. 규칙은 Config에서 현재 구성 파일의 [Rule] 섹션에 지정됩니다. 일반적으로 위에서 아래로 확인해 처음 일치하는 규칙의 정책을 적용합니다. 따라서 구체적인 도메인 규칙은 광범위한 조건보다 앞에 두고 FINAL은 마지막에 배치하세요. 특정 규칙이 있는지만 보지 말고 앞선 규칙이 먼저 일치할 가능성도 확인해야 합니다.

이 예시에서는 example.com 자체가 먼저 DOMAIN에 일치해 DIRECT를 사용하고, 하위 도메인은 DOMAIN-SUFFIX에 일치해 PROXY를 사용할 수 있습니다. IP-CIDR은 주소 대역을 지정하며 FINAL은 앞선 규칙에 처리되지 않은 요청을 받습니다. 이 예시는 규칙 순서를 설명하기 위한 것으로, 전체 구성을 확인 없이 그대로 바꾸면 안 됩니다.

PROXY, DIRECT, REJECT는 정책이지 규칙 조건이 아닙니다.PROXY는 요청을 프록시 경로로 보내고, DIRECT는 직접 연결하며, REJECT는 일치하는 요청을 거부합니다. 문제를 확인할 때는 요청이 어떤 조건에 일치했는지, 해당 조건에 어떤 정책이 지정되었는지 각각 확인하세요. 구성에서 사용자 지정 정책 이름을 사용한다면 그 이름이 유효한지, 실제로 어떤 서버를 가리키는지도 확인해야 합니다.

수정 전에 원래 구성을 보관하고, 수정한 뒤에는 해당 파일이 계속 현재 활성 구성인지 확인한 다음 새로운 요청으로 검증하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 콘텐츠가 계속 재생되거나 전송된다는 사실만으로 새 규칙이 적용됐다고 판단해서는 안 됩니다. 전체 문법, 구성 섹션 및 순서 예시는 구성 전체 안내를 확인하세요.

SERVER MANAGEMENT

구독 및 서버 관리

서버 정보에는 연결 엔드포인트, 프로토콜 및 인증 매개변수가 포함됩니다. 구독은 기존 서버 항목을 일괄 제공하고 업데이트하는 기능입니다. 서버 구독과 규칙 구성 파일은 용도가 다릅니다. 둘 다 텍스트 링크로 제공된다고 해서 같은 메뉴에 가져오면 안 됩니다. 작업 전에 보유한 내용이 서버 구독인지, 단일 서버 공유 정보인지, 구성 파일인지 확인하세요.

Add Server 및 가져오기 메뉴

서버를 직접 추가하려면 Home에서 Add Server로 이동해 프로토콜을 선택한 다음 주소, 포트 및 인증 정보를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2는 입력 항목이 서로 다를 수 있으므로 보유한 서버 정보를 기준으로 입력해야 합니다. TLS, 전송 방식, 서버 이름 등의 매개변수도 서버 측 설정과 일치해야 하며 프로토콜 이름만 보고 추측해서는 안 됩니다.

기존 QR 코드는 Scan QR Code를 사용할 수 있으며, 보유한 공유 정보는 해당 가져오기 기능으로 처리할 수 있습니다. Subscribe를 사용할 때는 현재 메뉴가 서버 구독을 관리하는지 Config의 구성 구독을 관리하는지 확인하세요. 가져오기 전에 콘텐츠 유형을 확인하고, 가져온 뒤에는 어느 목록에 표시되는지 확인하세요. 규칙 파일 주소를 서버 구독 주소로 사용하지 마세요.

업데이트, 선택 및 로컬 수정 내용 보존

구독을 업데이트한 뒤에는 항목이 변경되었는지 먼저 확인하고 Home으로 돌아가 현재 선택된 서버가 의도한 항목인지 확인하세요. 업데이트 성공은 콘텐츠를 가져와 처리했다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다. 이후 Connectivity Test와 실제 요청으로 검증해야 합니다. 업데이트에 실패하면 링크가 완전한지, 현재 네트워크에서 접속할 수 있는지, 구독 콘텐츠가 여전히 유효한지 확인하세요.

구독으로 생성된 항목을 직접 수정하기 전에 다음 업데이트에서 해당 항목이 다시 생성되거나 덮어써질 수 있는지 고려하세요. 중요한 로컬 수정 사항은 별도로 기록하고, 구독을 삭제하기 전에는 사용 중인 서버가 포함되어 있는지 확인하세요. 구독 링크, QR 코드, 인증 정보에 접근 자격 증명이 들어 있을 수 있으므로 문제를 문의할 때 원본 내용을 공개하지 마세요.

CONNECTION TRIGGER

On Demand 자동 연결

On Demand는 설정된 네트워크 조건에 따라 연결을 시작합니다. 즉, ‘언제 연결을 설정할지’를 정하는 기능이지 ‘특정 도메인에 어떤 정책을 적용할지’를 정하는 기능이 아닙니다. Home에서 On Demand 설정을 열고 현재 화면에 표시되는 네트워크 조건을 지정한 뒤 활성화하세요. 시스템 VPN 구성이 정상적으로 작동해야 하므로 먼저 수동 연결을 한 번 확인해야 합니다.

설정하기 전에 원하는 동작을 정하세요. 지정한 네트워크에서 연결할지, 네트워크 조건이 바뀐 뒤 다시 연결을 트리거할지 선택합니다. 앱에서 제공하는 Wi-Fi, 셀룰러 네트워크 및 네트워크 일치 옵션을 하나씩 확인하고 조건 간 관계를 모른 채 모두 활성화하지 마세요. 테스트할 때는 한 네트워크에서 안정적으로 확인한 뒤 다른 네트워크로 전환해 동작을 살펴보세요. 같은 네트워크에서 페이지를 반복해서 여는 것만으로는 네트워크 변경 조건을 검증할 수 없습니다.

On Demand가 연결을 설정한 뒤에도 요청은 Global Routing과 현재 구성에 따라 처리됩니다. 이 기능으로 작동하지 않는 서버를 복구하거나 규칙을 대신 선택할 수는 없습니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 On Demand가 활성화되어 있는지, 현재 네트워크가 트리거 조건을 충족하는지 먼저 확인하세요. 문제를 확인하는 동안 On Demand를 잠시 끄고 수동 연결을 비교한 뒤, 확인이 끝나면 필요한 조건을 다시 설정하세요.

TRAFFIC OBSERVATION

Data 트래픽 통계

Data에서 클라이언트가 기록한 트래픽을 확인할 수 있습니다. Data를 열고 현재 통계 항목, 기간 및 화면에 표시되는 분류를 확인한 다음 업로드와 다운로드량의 변화를 살펴보세요. 테스트 전에 기존 값을 기록하고 명확한 요청을 한 번 보낸 뒤 증가량을 비교하면 누적 합계만 보는 것보다 이번 작업에서 트래픽이 발생했는지 파악하기 쉽습니다.

클라이언트 통계는 서비스 제공업체의 과금 기록과 같지 않습니다. 통계 기간, 집계 범위 및 계산 기준이 서로 다를 수 있습니다. Data의 총량을 계정의 남은 사용량으로 간주하거나 다운로드 수치가 늘었다는 이유만으로 웹페이지가 완전히 로드됐다고 판단하지 마세요. 백그라운드 요청, 앱 재시도 및 연결 오버헤드로도 통계가 달라질 수 있습니다.

관찰 기준을 새로 설정해야 한다면 필요한 정보를 먼저 기록한 뒤 화면에서 제공하는 초기화 기능을 사용하세요. 통계를 초기화해도 연결 문제가 해결되지는 않으며 규칙 변경과 동시에 진행해서는 안 됩니다. 페이지 로드에 실패했는데 Data 값이 변했다면 요청 결과, 적용된 정책 및 대상 상태를 계속 확인하세요. 값이 그대로라면 연결 스위치, 현재 모드와 테스트 요청이 실제로 다시 전송됐는지 먼저 점검하세요.

COMMON SETTINGS

Settings 및 자주 쓰는 구성 항목

Settings에는 테스트, 보조 기능, 동기화 및 진단 등의 설정이 있습니다. DNS와 같은 동작은 현재 구성 파일에서 정의될 수도 있습니다. 아래에서는 기능별 확인 위치를 설명하며 구체적인 메뉴 단계와 사용 가능한 옵션은 현재 앱 화면을 기준으로 확인하세요. 이름이 비슷하다고 해서 Settings의 전역 설정과 Config의 파일 설정이 반드시 같은 범위에 적용되는 것은 아닙니다.

DNS: 적용 위치 먼저 확인

DNS는 도메인을 주소로 변환하며, 변환 결과는 연결과 일부 IP 규칙의 판정에 영향을 줍니다. DNS를 확인하려면 Config에서 현재 파일을 열고 [General]의 dns-server 및 현재 화면에 표시되는 DNS 관련 설정을 확인하세요. 아래 system 예시는 시스템 DNS를 사용한다는 뜻이며 모든 네트워크에 적용되는 고정 권장값은 아닙니다.

이름 해석에 문제가 있다고 의심되면 서버를 바꾸지 말고 같은 도메인에 새 요청을 보내 변경 전후를 비교하세요. 설정한 DNS 방식에 현재 네트워크에서 접근할 수 있는지 확인하고 규칙이 변환된 주소에 의존하는지도 점검하세요. DNS를 변경해도 서버 인증, 대상 인증서 또는 기존 연결은 자동으로 바뀌지 않습니다. 오류가 발생하면 이름 해석 실패와 연결 실패를 구분하세요.

Test Method: 테스트 기준 맞추기

Test Method는 Settings에서 서버 테스트에 사용할 방법을 선택하는 항목입니다. 현재 방법과 설정 가능한 매개변수를 확인한 다음 Connectivity Test를 실행하세요. 테스트 방법마다 측정하는 단계가 다릅니다. 포트 연결에 성공해도 대상 페이지 요청이 완료된 것은 아니며 프록시를 통해 테스트 요청이 성공해도 모든 대상에 접속할 수 있다는 뜻은 아닙니다.

서버를 비교할 때는 Test Method, 테스트 대상 및 네트워크 조건을 동일하게 유지하세요. 서로 다른 방법으로 얻은 수치를 그대로 비교하거나 한 번 짧게 나온 테스트 시간을 지속적인 속도 보장으로 해석하지 마세요. 테스트에 실패하면 엔드포인트 접근성, 인증 정보, 전송 매개변수 및 테스트 대상을 각각 확인한 뒤 실제 사용 대상도 점검하세요.

Today Widget: 보조 정보와 조작

Today Widget은 시스템 위젯 관련 보조 기능입니다. Settings에서 앱이 제공하는 관련 옵션을 확인한 다음 시스템에서 지원하는 방식으로 추가하거나 관리하세요. 표시 위치와 조작 방식은 기기 및 시스템에 따라 달라지므로 현재 시스템 화면을 기준으로 확인해야 합니다. 위젯을 설정하기 전에 앱에서 서버 선택과 연결을 확인해 초기 설정 문제를 위젯 문제로 오해하지 않도록 하세요.

위젯은 보조 정보를 표시하므로 시스템 갱신이 즉시 반영되지 않을 수 있습니다. 상태가 확실하지 않다면 Home을 열어 실제 연결 스위치, Global Routing 및 서버 선택을 확인하세요. 위젯에 한 번 표시된 내용만으로 현재 라우팅 상태를 판단하지 마세요. 위젯을 제거해도 앱의 On Demand가 꺼지는 것은 아닙니다.

iCloud: 동기화와 복구를 따로 확인

iCloud 관련 기능을 사용하기 전에 시스템에서 iCloud를 사용할 수 있는지, Shadowrocket에 접근 권한이 있는지 확인한 다음 앱 Settings의 동기화 옵션을 점검하세요. 현재 기능에서 지원하는 범위만 동기화되므로 모든 서버, 구성, 통계 및 시스템 권한이 함께 복사된다고 가정하지 마세요. 처음 동기화하기 전에 중요한 구성을 복구할 수 있도록 사본을 보관하세요.

여러 기기에서 같은 내용을 수정할 때는 동기화가 완료됐는지 확인한 후 계속 편집해 어떤 내용이 최신 상태인지 혼동하지 않도록 하세요. 기기를 바꾼 뒤에도 현재 구성, 선택된 서버 및 시스템 VPN 권한을 확인해야 합니다. App Store 구매 항목 복원과 iCloud 콘텐츠 동기화는 서로 다른 절차입니다. 앱을 다시 받을 수 있어도 모든 사용 데이터가 복구되는 것은 아닙니다.

Diagnostics: 재현 가능한 정보 수집

Diagnostics는 실행 상태와 연결 문제를 확인하는 데 도움을 줍니다. Settings의 진단 관련 메뉴에서 현재 사용할 수 있는 도구를 확인하세요. 문제를 점검하기 전에 네트워크 유형, Global Routing, 현재 구성 및 문제가 발생한 작업을 기록한 뒤 다시 재현하세요. 진단 정보는 실제 실패 시점과 맞아야 합니다. 너무 일찍 저장한 기록에는 분석에 필요한 요청이 포함되지 않을 수 있습니다.

진단 결과를 공유하기 전에 구독 링크, 암호, 인증 정보 및 불필요한 개인 정보를 삭제하세요. 이름 해석 완료 여부, 연결이 실패한 단계, 적용된 정책처럼 문제의 원인을 판단하는 데 필요한 정보만 남기세요. 문제를 파악할 만큼 수집한 뒤에는 불필요한 상세 요청 기록을 장기간 보관하지 않도록 평소 기록 설정으로 되돌리세요.