FUNCTIONS & SETTINGS

Shadowrocket 기능 및 설정

Global Routing부터 시작해 규칙, 서버, 연결 조건, 진단 정보를 차례로 확인하세요. 한 번에 한 항목만 바꾸고 같은 대상으로 결과를 검증합니다.

공식 가이드 iPhone / iPad 사용 안내 기존 설정이 있다는 전제

이 페이지에서는 기능 간의 관계를 설명하며 앱 화면을 재현하지 않습니다. 정확한 메뉴 위치와 사용 가능한 옵션은 현재 앱에 표시되는 내용을 확인하세요. 기기 호환성, 시스템 요구 사항 및 구매 가능 범위는 App Store 페이지를 기준으로 합니다. 아직 설치하지 않았다면 다운로드 및 정품 확인 안내를 먼저 읽어 보세요.

01 / GLOBAL ROUTING

Global Routing의 세 가지 모드

먼저 트래픽 처리 방식을 정한 다음 구체적인 연결 설정을 확인하세요.

무엇인가요: Global Routing은 클라이언트가 처리하는 연결의 경로를 선택합니다. 설정 모드는 Config, 프록시 모드는 Proxy, 직접 연결 모드는 Direct입니다. Home에서 서버를 선택하는 것과는 별개의 설정입니다. 전자는 라우팅 방식을, 후자는 프록시가 필요할 때 사용할 연결 정보를 정합니다.

위치와 설정 방법: Home에서 Global Routing을 엽니다. 도메인이나 주소 등의 조건에 따라 일상적으로 트래픽을 분기하려면 Config를 선택하고, 현재 활성화된 Config 파일을 확인하세요. 특정 요청이 분기의 영향을 받는지 임시로 확인할 때는 Proxy 또는 Direct로 바꿔 비교할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌려 점검용 설정이 계속 사용되지 않도록 하세요.

화면 항목처리 방식사용 상황먼저 확인할 항목
Config (설정)현재 설정의 규칙과 정책에 따라 연결을 처리합니다.대상에 따라 서로 다른 정책을 적용해야 할 때현재 활성화된 파일, Rule 순서, FINAL
Proxy (프록시)기본적으로 프록시 경로를 사용합니다. 실제 동작은 적용되는 설정과 연결 유형에 따라 달라집니다.프록시 경로를 사용할 수 있는지 임시로 비교할 때선택한 서버, 인증 정보, 전송 매개변수
Direct (직접 연결)기본적으로 현재 네트워크의 직접 연결 경로를 사용합니다.현재 네트워크에서 대상에 접속되는지 비교할 때현재 네트워크, 대상의 접속 가능 여부, DNS 응답 결과

주의할 점: Proxy를 선택해도 서버 비밀번호 오류가 해결되지는 않으며, Config를 선택해도 적합한 규칙이 자동으로 만들어지지 않습니다. Direct는 클라이언트 내 라우팅 선택이며 시스템의 VPN 연결을 끄는 것과는 다릅니다. 비교 테스트를 할 때는 모드, 선택한 서버, 대상을 기록하고 가능한 한 연결을 새로 시작하세요. 이미 연결된 세션은 모드 변경 후에도 즉시 새 경로를 사용하지 않을 수 있습니다.

02 / RULE & POLICY

규칙 매칭과 정책 선택

무엇인가요: 규칙은 매칭 조건을, 정책은 규칙에 일치한 요청의 처리 방법을 지정합니다. 두 개념을 혼동하지 마세요. DOMAIN은 전체 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사와 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 범위에 사용되며, GEOIP은 IP 주소 위치 데이터에 의존합니다. USER-AGENT는 요청 정보를 확인할 수 있어야 하며, 이를 모든 앱을 확실하게 식별하는 기능으로 이해해서는 안 됩니다.

위치와 설정 방법: Config에서 현재 활성화된 파일을 찾아 Rule을 확인합니다. 규칙은 일반적으로 위에서 아래 순서로 검사하며, 처음 일치한 규칙의 정책을 적용합니다. 따라서 구체적인 예외를 포괄적인 조건보다 앞에 두고 마지막에 FINAL을 명확히 지정하세요. 비활성 파일에 규칙을 추가해도 현재 연결 동작은 달라지지 않습니다.

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

이 예시는 규칙 순서를 설명하기 위한 것입니다. example.com 자체는 먼저 DIRECT에 일치하고, ad.example.com은 먼저 REJECT에 일치합니다. 그 밖에 example.com 접미사와 일치하는 도메인은 PROXY로 처리됩니다. 모든 네트워크에 적용할 수 있는 범용 설정은 아니므로 사용 전에 실제 대상을 확인하세요.

주의할 점: PROXY는 프록시 경로를, DIRECT는 직접 연결을 사용하며, REJECT는 일치하는 요청을 거부합니다. REJECT는 페이지 내용을 분석하지 않으므로 도메인 규칙 하나만으로 같은 도메인의 서로 다른 콘텐츠를 구분할 수 없습니다. 주소 규칙은 DNS 응답 결과의 영향도 받을 수 있습니다. 트래픽이 예상과 다르게 분기되면 비슷한 조건을 계속 추가하기 전에 실제로 일치한 규칙부터 확인하세요. 설정을 저장하고 적용 여부를 확인한 뒤 테스트 요청을 새로 시작합니다.

설정 파일의 섹션 구성과 프로토콜 매개변수를 알아보려면 프로토콜 해설과 .conf 설정 파일 구조 안내를 참고하세요.

03 / SUBSCRIBE & SERVER

기존 구독 및 서버 관리

무엇인가요: 개별 서버 항목에는 주소, 포트, 프로토콜, 인증 정보 등의 연결 매개변수가 저장됩니다. Subscribe는 기존에 보유한 구독 주소에서 서버 항목을 가져오고 업데이트하는 기능입니다. 서버 목록과 Config의 역할은 다릅니다. 서버 목록은 연결 대상을 제공하고 Config는 라우팅 등의 동작을 지정합니다. 구독을 업데이트했다고 해서 규칙 파일까지 업데이트된 것은 아닙니다.

위치와 설정 방법: Home에서 서버를 관리합니다. 개별 서버 정보를 보유한 경우 Add Server로 이동해 서버와 동일한 유형을 선택하고 해당 항목을 입력하세요. 구독을 보유한 경우 Add Server의 유형 선택에서 Subscribe를 선택하고 전체 구독 주소를 붙여 넣은 다음 저장합니다. Scan QR Code로 보유한 정보를 가져올 수도 있지만, 가져온 뒤에는 항목 이름만 보지 말고 상세 정보를 확인하세요.

Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 유형은 입력 항목이 서로 다릅니다. 한 유형의 Password를 다른 유형의 인증 항목에 그대로 입력하지 말고, 포트만 보고 프로토콜을 판단하지도 마세요. TLS, 서버 이름, 전송 관련 항목은 서버 측 요구 사항과 일치해야 합니다. 정보가 부족하다면 임의로 조합을 시도하기 전에 원래 매개변수를 확인하세요.

Subscribe를 업데이트한 뒤 항목이 추가·삭제되거나 이름이 바뀌었는지 확인하고, Home에서 선택한 서버가 여전히 원하는 항목인지 확인하세요. 구독으로 생성된 항목을 직접 수정하면 다음 업데이트 때 변경 사항이 덮어써질 수 있습니다. 수정 사항을 보관해야 한다면 먼저 항목의 관리 방식을 확인하고 복구할 수 있도록 원본 정보를 보존하세요.

주의할 점: 구독 주소에는 접속 정보가 포함될 수 있고 QR 코드에도 전체 인증 정보가 담길 수 있으므로 공개하거나 스크린샷에 넣지 마세요. 구독 업데이트 실패와 서버 연결 실패는 서로 다른 문제입니다. 전자는 구독 주소와 접근 가능 상태를, 후자는 해당 서버의 매개변수를 확인하세요. 지연 시간 테스트에 성공했다는 것은 해당 테스트 조건에서 응답을 받았다는 뜻일 뿐, 대상 사이트나 지속적인 전송 속도 또는 장시간 연결이 정상이라는 보장은 아닙니다.

04 / ON DEMAND

On Demand 주문형 연결

무엇인가요: On Demand는 시스템이 지원하는 조건에 따라 연결 동작을 실행해 매번 연결 스위치를 수동으로 조작할 필요를 줄입니다. VPN 연결을 언제 시작하거나 처리할지 제어하며, Rule은 연결이 시작된 뒤 요청이 어떤 경로를 사용할지 제어합니다. 두 기능은 함께 사용할 수 있지만 같은 설정은 아닙니다.

위치와 설정 방법: Settings에서 On Demand 관련 메뉴를 찾아 현재 조건을 확인한 뒤 화면에서 제공하는 네트워크 유형이나 네트워크 식별 정보 등의 조건을 설정하세요. 처음 사용할 때는 먼저 수동 연결, Global Routing, 선택한 서버가 정상인지 확인합니다. 그런 다음 명확한 조건 하나만 추가하고 저장한 뒤 해당 네트워크로 전환해 결과를 확인하세요.

특정 Wi-Fi와 다른 네트워크를 구분해야 한다면 실제 네트워크 식별 정보를 확인하고 조건의 우선순위도 살펴보세요. 테스트 중에는 현재 네트워크, 예상 동작, 시스템의 실제 상태를 기록합니다. 트리거 조건을 바꾸지 않고 연결만 반복해서 수동으로 끄면 여전히 조건이 충족되어 시스템이 다시 연결을 시작할 수 있습니다. 이것만으로 연결 해제 기능이 작동하지 않는다고 볼 수는 없습니다.

주의할 점: On Demand가 앱을 항상 포그라운드에서 실행하거나 서버 장애를 복구해 주는 것은 아닙니다. 네트워크 전환, 시스템 정책, 서버 상태가 모두 결과에 영향을 줄 수 있습니다. 자동 실행을 일시적으로 중지하려면 클라이언트의 On Demand와 시스템 VPN 설정을 모두 확인해 서로 모순되는 설정이 남지 않도록 하세요. 문제를 점검할 때 트리거 조건을 여러 개 동시에 바꾸지 마세요.

05 / DATA

Data 트래픽 통계 확인 방법

무엇인가요: Data에서는 클라이언트가 제공하는 트래픽 통계를 확인할 수 있습니다. 테스트 작업으로 데이터 전송이 발생했는지, 업로드와 다운로드 수치가 예상대로 바뀌는지 판단하는 데 도움이 됩니다. 이 통계는 서비스 제공자의 청구 내역이 아니며, 누적 수치 하나만으로 모든 요청이 프록시를 거쳤는지 판단할 수도 없습니다.

위치와 확인 방법: Data를 열고 표시되는 통계 대상, 시간 범위, 집계 기준을 확인한 다음 테스트 전 수치를 기록하세요. 이어서 명확한 대상 하나에만 접속한 뒤 같은 통계 화면으로 돌아와 변화를 확인합니다. 화면에 초기화 옵션이 있다면 필요한 기록을 먼저 저장한 뒤 초기화 여부를 결정하세요. 로컬 통계를 초기화해도 서비스 제공자의 기록은 초기화되지 않습니다.

주의할 점: 백그라운드 작업, 미디어 사전 로드, 재시도, 프로토콜 오버헤드가 측정 결과에 영향을 줄 수 있습니다. 화면마다 통계 범위가 다르면 수치를 단순히 더하거나 서로 바꿔 볼 수 없습니다. 특정 요청의 라우팅 경로를 확인하려면 연결 기록과 적용된 정책을 함께 살펴보세요. Data의 트래픽 증가만으로 판단하지 마세요. 서비스 사용량은 이미 이용 중인 서비스의 집계 기준을 확인하세요.

06 / SETTINGS

Settings 주요 항목

Config 파일과 전역 설정이 함께 동작에 영향을 줄 수 있습니다. 수정하기 전에 해당 설정을 어느 단계에서 관리하는지 확인하세요.

DNS: 이름 해석과 라우팅의 연동

무엇이며 어디에 있나요: DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. 관련 옵션은 Settings와 현재 Config의 General 매개변수에 있을 수 있습니다. DNS는 Global Routing과 다르며, 올바른 규칙이나 서버 정보를 대신하지도 않습니다.

설정 방법과 주의할 점: 먼저 현재 DNS 설정을 기록하고 입력한 주소 또는 DNS 서비스의 형식과 접근 가능 여부를 확인하세요. 그런 다음 한 항목만 수정하고 같은 도메인으로 다시 테스트합니다. 출처를 알 수 없는 설정을 여러 개 한꺼번에 추가하지 마세요. DNS 캐시, IPv4와 IPv6 응답의 차이, 주소 규칙이 최종 경로에 영향을 줄 수 있습니다. 브라우저에서 대상 사이트가 열리더라도 클라이언트가 예상한 DNS를 사용했다는 증거는 아닙니다. 도메인으로는 접속되지 않지만 주소로는 연결된다면 DNS를 점검 항목 중 하나로 살펴보세요. 곧바로 서버를 사용할 수 없다고 단정하지 마세요.

Test Method: 테스트 결과 이해하기

무엇이며 어디에 있나요: Settings에서 Test Method와 관련 테스트 매개변수를 확인하세요. 이 설정은 해당 연결 테스트의 방식을 결정합니다. Home의 Connectivity Test는 선택한 테스트 방식에 따른 서버 응답을 확인합니다.

설정 방법과 주의할 점: 화면 안내에 따라 한 가지 방식을 선택한 뒤 같은 테스트 대상과 비슷한 네트워크 조건에서 결과를 비교하세요. 테스트 방식마다 확인하는 단계가 다르므로 수치를 단순 비교할 수 없습니다. 포트 연결에 성공해도 인증, TLS, 대상 요청까지 성공한 것은 아닙니다. 테스트 지연 시간이 짧다고 다운로드 속도가 더 빠른 것도 아닙니다. 테스트 대상에 접근할 수 없다면 서버 항목을 한꺼번에 삭제하기 전에 먼저 대상 상태를 확인하세요.

Today Widget: 위젯 메뉴와 시스템 제한

무엇이며 어디에 있나요: Today Widget은 앱에서 지원하는 정보나 동작에 빠르게 접근하기 위한 위젯 기능입니다. 먼저 Settings에서 사용 가능한 옵션을 확인한 다음 시스템의 위젯 관리 화면에서 추가할 수 있는지 살펴보세요.

설정 방법과 주의할 점: 현재 시스템과 앱에서 실제로 제공하는 항목 중 표시할 내용을 선택하고, 추가한 뒤 클라이언트 상태와 일치하는지 확인하세요. 위젯 유형, 새로고침 주기, 상호작용 기능은 시스템 지원 범위에 따라 달라지므로 모든 기기에서 같은 화면이 표시된다고 가정하지 마세요. 위젯 표시가 늦게 갱신될 수 있으므로 연결 문제를 확인할 때는 클라이언트와 시스템에 표시되는 실제 연결 상태를 기준으로 판단하세요.

iCloud: 동기화 범위와 복원 시 유의 사항

무엇이며 어디에 있나요: Settings에서 iCloud 동기화 또는 백업 관련 옵션을 확인하고, 시스템 설정에서 앱의 iCloud 사용 권한도 확인하세요. iCloud는 앱에서 명시적으로 지원하는 데이터를 처리하며, App Store 구매 자격을 복원하는 기능은 아닙니다.

설정 방법과 주의할 점: 먼저 현재 옵션 설명을 읽고 동기화되는 항목을 확인한 다음 기능을 켜고 완료될 때까지 기다리세요. 기기를 바꾸기 전에 필요한 별도 백업을 보관하고, 복원한 뒤 서버, 현재 Config, 스위치 상태를 하나씩 확인하세요. 모든 항목이 완전히 이전되었다고 가정하지 마세요. 삭제 또는 덮어쓰기 작업은 동기화 데이터에 영향을 줄 수 있으므로 먼저 방향과 범위를 확인해야 합니다. 서버 비밀번호, 구독 주소, 설정 파일에는 민감한 정보가 포함될 수 있으므로 내보내거나 동기화할 때도 접근 범위를 제한하세요.

07 / DIAGNOSTICS

Diagnostics를 활용한 문제 진단

무엇인가요: Diagnostics는 진단 정보와 도구를 제공해 ‘연결할 수 없음’이라는 문제를 현재 네트워크 사용 가능 여부, 도메인 해석 여부, 서버 연결 여부, 요청에 적용된 정책 등 구체적인 단계로 나누어 확인하도록 돕습니다. 진단 기록은 문제 해결을 위한 단서이며 모든 설정을 자동으로 복구하는 버튼은 아닙니다.

위치와 사용 방법: Settings에서 Diagnostics 관련 메뉴를 찾아 화면에 제공되는 도구와 기록 옵션을 사용하세요. 먼저 문제 발생 시각, 네트워크 유형, Global Routing 모드, 현재 Config, 선택한 서버를 기록한 뒤 문제를 한 번 재현합니다. 추가 기록이 필요하다면 문제 해결에 필요한 범위만 유지하고, 완료 후 원래 기록 설정으로 되돌리세요.

단계별로 확인하는 것이 좋습니다. 먼저 현재 네트워크에서 사용 가능한 것으로 확인된 대상에 접속할 수 있는지 확인하고, 서버 연결 테스트를 진행한 다음 도메인 해석을 살펴보고 마지막으로 규칙과 정책을 확인하세요. Proxy 모드에서는 대상에 접속되지만 Config 모드에서 실패한다면 매칭 규칙과 정책을 우선 확인하세요. 다만 두 테스트에서 서버나 네트워크가 바뀌지 않았는지 확인해야 하며, 모드 차이만으로 원인을 단정해서는 안 됩니다.

주의할 점: 진단 자료에 접속 도메인, 주소, 구독 정보, 인증 항목이 포함될 수 있습니다. 공유하기 전에 민감한 내용을 삭제하고 현상을 설명하는 데 필요한 부분만 남기세요. 전체 설정 파일, 전체 구독 주소, QR 코드를 공개하지 마세요. 간헐적인 오류는 같은 조건에서 반복해 확인해야 합니다. 한 번의 시간 초과만으로 장기적인 안정성을 판단할 수는 없습니다.

08 / VERIFY CHANGES

설정 후 확인 순서

  1. 입력 정보 확인. 서버 유형, 주소, 포트, 인증 항목을 확인하고 Subscribe 업데이트 결과가 예상한 항목인지 살펴봅니다.
  2. 라우팅 확인. Home에서 Global Routing을 확인합니다. Config를 사용하는 경우 현재 활성화된 파일, 규칙 순서, FINAL도 점검하세요.
  3. 연결 상태 확인. 클라이언트와 시스템의 연결 상태를 살펴보고 같은 대상으로 요청을 새로 시작해 기존 연결로 인한 오판을 피하세요.
  4. 결과 확인. 연결 기록, Diagnostics, Data의 변화를 함께 살펴보세요. 한 번에 변수 하나만 바꾸고 원래 상태로 되돌릴 방법을 마련해 두세요.

수동 연결부터 확인하면 자동 트리거를 켜고 DNS를 조정하고 규칙을 다시 작성하는 것보다 문제를 찾기 쉽습니다. 처음부터 끝까지의 사용 절차는 Shadowrocket 시작하기를, 지연 시간 테스트 결과를 이해하려면 지연 시간 테스트와 실제 사용 경험을 읽어 보세요.

규칙을 수정했는데 왜 달라진 점이 없나요?

먼저 Global Routing이 Config로 설정되어 있는지, 현재 활성화된 파일을 수정했는지 확인하고 더 위쪽의 규칙이 먼저 일치했는지 살펴보세요. 설정을 저장하고 적용 여부를 확인한 뒤 연결을 새로 시작하세요. 이미 연결된 세션은 이전 경로를 계속 사용할 수 있습니다.

On Demand를 켰는데도 대상에 접속할 수 없습니다. 무엇을 먼저 확인해야 하나요?

먼저 연결 트리거가 실행되었는지 확인하세요. 연결이 시작되지 않았다면 트리거 조건을 살펴보고, 연결은 되었지만 접속할 수 없다면 서버, DNS, 규칙을 확인하세요. On Demand는 연결 시작 조건을 처리할 뿐 서버의 사용 가능 여부를 확인해 주지는 않습니다.

iCloud 동기화와 구매 복원은 같은 기능인가요?

아닙니다. iCloud는 앱에서 지원하는 데이터의 동기화 또는 백업을 처리하고, 앱 구매 및 다시 받기는 App Store에서 처리합니다. 구체적인 동기화 범위는 앱 안내를, 구매 가능 범위는 App Store 페이지를 확인하세요.