공식 매뉴얼 · 기능 안내 Home → Config → Settings

Shadowrocket 기능 및 주요 설정

먼저 Global Routing을 정한 다음 Config와 서버를 확인하세요. 기능별 화면 위치와 설정 순서, 적용 조건을 살펴보면 여러 항목을 한꺼번에 바꾼 뒤 원인을 찾기 어려운 상황을 줄일 수 있습니다.

Shadowrocket은 iPhone / iPad / Mac / Windows / Android / Linux에서 사용할 수 있습니다. 아래 경로는 iPhone / iPad를 기준으로 하며, 다른 플랫폼은 메뉴 위치와 시스템 기능이 다를 수 있습니다. 현재 앱에 표시되는 옵션을 기준으로 확인하세요.

iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하면 됩니다. 시스템 요구 사항은 App Store 페이지를 확인하세요. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료입니다.

01 / ROUTING

먼저 트래픽 처리 방식 정하기

Global Routing: Config, Proxy, Direct

Home에서 Global Routing을 여세요. Config, Proxy, Direct는 연결을 규칙에 따라 처리할지 정하는 세 가지 주요 모드입니다.

기능: Global Routing은 트래픽 처리 방식을 정하는 메뉴이지, 서버 목록이나 프로토콜 유형이 아닙니다. Config를 선택하면 현재 구성 파일의 규칙에 따라 정책이 결정됩니다. Proxy를 선택하면 클라이언트에 연결된 트래픽을 프록시 방식으로 처리하고, Direct를 선택하면 직접 연결합니다. 시스템 자체 제한이나 클라이언트에 연결되지 않은 트래픽의 경로를 이 옵션만으로 단정해서는 안 됩니다.

설정 방법: 처음 사용할 때는 Home에서 이미 보유한 사용 가능한 서버를 선택한 뒤 Config에서 현재 구성 파일을 확인하고, Global Routing으로 돌아와 Config를 선택하세요. 규칙이 문제의 원인인지 확인하려면 잠시 Proxy로 바꿔 같은 대상을 다시 테스트한 다음 원래 설정으로 되돌립니다. 현재 로컬 네트워크의 접속 상태를 비교하려면 잠시 Direct로 전환하세요.

모드 및 화면 표시처리 방식사용 상황확인 항목
구성 · Config현재 구성 파일의 규칙을 차례로 적용합니다.일상적인 도메인·주소 범위별 트래픽 라우팅에 사용합니다.사용 중인 구성 파일, 규칙 순서, 최종 정책을 확인하세요.
프록시 · Proxy클라이언트에 연결된 트래픽을 프록시 방식으로 처리합니다.프록시 서버와 대상에 연결할 수 있는지 임시로 확인합니다.현재 선택한 서버와 연결 매개변수를 확인하세요.
직접 연결 · Direct클라이언트에 연결된 트래픽을 직접 연결합니다.로컬 네트워크 접속 상태를 비교하거나 프록시의 영향을 확인할 때 사용합니다.로컬 네트워크, DNS, 대상 서비스 자체를 확인하세요.

주의 사항: Proxy로 전환해도 작동하지 않는 서버가 복구되지는 않으며, Direct가 시스템 VPN 설정을 끄는 것도 아닙니다. 클라이언트의 연결 처리를 완전히 중지하려면 Home의 연결 스위치를 사용하세요. 화면에 Scene이 표시되더라도 이 세 가지 기본 모드의 판단 방법은 달라지지 않습니다. 장면 전환이 필요하지 않다면 명확한 기준이 되는 Config, Proxy 또는 Direct로 문제를 확인하세요.

02 / RULES

조건이 일치 항목을 정하고, 정책이 연결 경로를 정합니다

규칙 기반 라우팅: 유형, 정책, 순서

Config에서 현재 구성 파일을 확인하세요. Global Routing이 Config로 설정된 경우에 이 파일을 기준으로 라우팅 결과를 판단할 수 있습니다.

기능: 규칙은 일치 조건과 처리 정책으로 구성됩니다. DOMAIN은 정확한 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사와 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치합니다. IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 주소 범위를 지정하고, GEOIP는 주소의 지리적 위치 정보를 기준으로 일치 항목을 찾습니다. USER-AGENT는 요청 특성과 관련되며, 필요한 정보를 가져올 수 있는지는 연결 방식에 따라 달라집니다. 따라서 모든 트래픽에 적용되는 앱 식별 조건으로 간주하면 안 됩니다.

위치 및 설정 방법: Config에서 현재 구성 파일을 열고 [Rule] 섹션을 확인하세요. 구체적인 규칙부터 넓은 범위의 규칙 순으로 배치하고, 정확한 도메인이나 로컬 네트워크 범위는 알맞은 위치에 둡니다. 앞선 조건에 일치하지 않는 연결에는 FINAL로 정책을 지정하세요. 수정하기 전에 기존 구성 파일을 따로 보관하고, 한 번에 조건 하나만 변경하세요. 저장 후에도 해당 파일이 실제로 사용 중인지 확인합니다.

[Rule] 구조 예시

예시 · 현재 구성과 무관함
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT

example.com은 설명을 위한 도메인입니다. 실제 규칙은 사용자의 접속 목적과 기존 구성에 맞게 작성하세요.

정책 이해하기: PROXY는 프록시 정책, DIRECT는 직접 연결, REJECT는 연결 거부를 뜻합니다. 파일에서 사용자 지정 정책 이름을 참조한다면 해당 정책이 존재하는 서버나 그룹을 가리키는지도 확인하세요. 규칙은 보통 순서대로 적용되므로 앞쪽의 넓은 조건이 뒤에 있는 구체적인 조건보다 먼저 일치할 수 있습니다.

주의 사항: 구성 파일에 도메인이 있다는 이유만으로 규칙이 적용된다고 단정하지 마세요. Global Routing, 현재 활성화된 파일, 연결 기록에 표시된 실제 대상도 확인해야 합니다. 일부 요청은 IP 주소를 직접 사용하거나 이후 다른 도메인으로 이동할 수 있습니다. 이때는 기록을 바탕으로 판단하고 키워드 범위를 무작정 넓히지 마세요. 파일 내 각 섹션의 역할은 .conf 구조 설명에서 확인할 수 있습니다.

03 / SERVERS

가져오기, 업데이트, 선택은 각각 따로 확인하세요

구독 및 서버 관리

Home에서 서버를 확인하고 선택할 수 있으며, Add Server에서 정보를 추가하고 Subscribe에서 구독을 관리할 수 있습니다.

기능: 서버 하나에는 연결 매개변수가 저장되고, 구독을 사용하면 서버 항목을 가져오고 업데이트할 수 있습니다. 구독 업데이트와 Config 파일 업데이트는 서로 다릅니다. 전자는 서버 목록을 변경할 수 있고, 후자는 규칙과 기타 구성 내용을 변경합니다. 서버를 가져온 뒤에도 올바른 Global Routing 모드와 구성 파일을 선택해야 합니다.

설정 방법: 구독 URL이 있다면 Home의 Add Server에서 Subscribe를 선택하고, 주소와 알아보기 쉬운 이름을 입력해 저장하세요. 그런 다음 업데이트를 실행하고 목록이 생성되었는지 확인합니다. 서버 정보를 개별적으로 보유하고 있다면 해당 프로토콜에 맞춰 주소, 포트, 인증 정보를 입력하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 입력 항목이 서로 다릅니다. 프로토콜 이름만 바꾸고 맞지 않는 매개변수를 그대로 두면 안 됩니다.

Scan QR Code와 클립보드 가져오기는 이미 공유된 정보를 보유한 경우에 사용할 수 있습니다. 가져온 뒤 프로토콜, 주소, 필수 매개변수를 확인하고 Connectivity Test를 실행하세요. 테스트 결과는 문제를 좁히는 데 도움이 되지만 실제 접속 확인을 대신하지는 않습니다. 목록의 순서를 바꿔도 현재 선택한 항목이 사용 가능해지는 것은 아닙니다. 구독이 여러 개라면 각각 알아보기 쉽게 이름을 지정하고, 업데이트 후 기존에 선택한 서버가 목록에 남아 있는지 확인하세요.

주의 사항: 구독 URL에는 접속 인증 정보가 포함될 수 있으므로 문제를 확인할 때 전체 주소나 QR 코드를 공개하지 마세요. 구독에서 생성된 항목을 편집하기 전에 다음 업데이트에서 수동 변경 사항이 덮어써지는지 확인하세요. 구독을 삭제하기 전에 필요한 정보를 보관하세요. 목록에서 삭제하는 것과 연결을 중지하는 것은 별개의 작업입니다. 가져오기, 업데이트, 정렬, 삭제, 백업 방법은 구독 및 서버 관리 매뉴얼에서 확인할 수 있습니다.

04 / ON DEMAND

먼저 수동 연결을 확인하고 트리거 조건을 설정하세요

On Demand: 조건에 따른 연결

Settings에서 On Demand를 찾아보세요. Wi-Fi, Cellular 등의 조건은 현재 화면에 표시되는 항목을 기준으로 설정합니다.

기능: On Demand는 시스템에서 허용하는 조건에 따라 연결을 시작합니다. 특정 네트워크 환경에서 자동으로 연결할 때 유용합니다. 연결을 시작할 시점을 정하는 기능이며, 도메인을 직접 연결할지 프록시로 처리할지를 정하지는 않습니다. 후자는 Global Routing과 규칙에 따라 결정됩니다.

설정 방법: 먼저 조건 기반 연결을 끄고 수동으로 연결해 실제 접속까지 확인합니다. 서버, Config, DNS가 정상 작동하는지 확인한 다음 On Demand에서 필요에 따라 Wi-Fi 또는 Cellular 조건을 설정하세요. 화면에 Wi-Fi 이름 조건이 있다면 네트워크 이름을 하나씩 확인해 비슷한 이름 때문에 잘못 판단하지 않도록 합니다. 저장한 뒤 대상 네트워크와 다른 네트워크에서 연결 상태를 각각 확인하고, 화면 잠금·해제 및 네트워크 전환 후에도 동작을 점검하세요.

주의 사항: 시스템이 연결을 시작하려면 특정 조건이 필요합니다. On Demand를 모든 앱이 같은 세션을 계속 유지하는 기능으로 이해하면 안 됩니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 VPN 구성을 반복해서 삭제하지 말고 On Demand가 활성화되어 있는지 먼저 확인하세요. 문제를 진단할 때는 자동 재연결이 테스트에 영향을 주지 않도록 조건 기반 연결을 잠시 끄고 수동 스위치를 사용하세요. 플랫폼마다 백그라운드 동작 방식이 다르므로 모바일 조건을 다른 플랫폼에 그대로 적용하지 마세요.

05 / DATA

통계는 확인 자료이지 청구 내역이 아닙니다

Data: 트래픽 및 연결 기록

Data에서 현재 화면이 제공하는 트래픽 통계와 연결 정보를 확인하세요. 수치를 해석하기 전에 집계 범위를 확인합니다.

기능: Data에서는 클라이언트가 처리한 트래픽과 관련 기록을 확인할 수 있습니다. 요청이 발생했는지, 대상이 무엇인지, 규칙 처리가 예상대로 이루어졌는지 판단하는 데 도움이 됩니다. 화면에 표시되는 통계는 기록 범위, 삭제 작업, 연결 방식의 영향을 받습니다. 기기의 전체 네트워크 트래픽을 나타내는 것은 아니며 서버 측 사용량 기록을 대신하지도 않습니다.

사용 방법: 특정 웹페이지 문제를 확인할 때는 먼저 현재 상태를 기록하고, 대상 하나만 방문한 다음 Data에서 해당 기록을 찾으세요. 규칙이나 정책 정보가 표시된다면 대상 도메인, 일치 조건, 처리 정책을 함께 확인합니다. 새 기록이 없다면 연결 스위치가 켜져 있는지, 페이지에서 새 요청이 실제로 발생했는지, 캐시된 요청은 아닌지 먼저 점검하세요.

주의 사항: 기록을 지우기 전에 비교에 필요한 증거를 보관하세요. 업로드·다운로드 통계와 앱에 표시되는 파일 크기는 프로토콜 오버헤드, 캐시, 집계 기간에 따라 달라질 수 있으므로 서버 요금의 정확성을 판단하는 근거로 삼기 어렵습니다. 연결 기록에는 방문한 도메인 등 개인정보가 포함될 수 있습니다. 스크린샷이나 로그를 공유하기 전에 내용을 확인하세요.

06 / SETTINGS

기존 값을 기록하고 한 번에 하나씩 변경하세요

Settings: DNS, 테스트, 동기화

아래 항목은 Settings에서 찾을 수 있습니다. 표시 여부와 메뉴 위치는 플랫폼 및 현재 앱 화면에 따라 다릅니다.

DNS: 먼저 이름 확인 문제인지 살펴보기

기능 및 위치: DNS는 도메인 이름을 주소로 변환합니다. 관련 설정은 Settings의 DNS 항목과 구성 파일의 [General] 매개변수에서 확인할 수 있습니다. DNS 설정 출처, 요청 경로, 캐시가 모두 확인 결과에 영향을 주므로 주소 하나를 바꿨다고 해석 방식이 완전히 전환됐다고 단정할 수는 없습니다.

설정 방법 및 주의 사항: 먼저 기존 설정을 기록하고 현재 구성에 별도의 DNS 매개변수가 있는지 확인하세요. 도메인 이름 확인 실패나 예상과 다른 결과 등 명확한 단서가 있을 때만 네트워크 환경에 맞게 조정합니다. 변경 후 연결을 다시 설정하고 같은 대상을 방문해 비교하세요. 화면에 DNS 캐시 삭제 옵션이 있다면 필요한 경우 사용합니다. DNS, 서버, 규칙을 동시에 변경하면 원인을 파악하기 어려우므로 한 번에 하나씩 바꾸세요. 연결은 되지만 웹페이지가 열리지 않는다면 서버나 대상 서비스의 문제일 수도 있습니다.

Test Method: 테스트 결과를 같은 기준으로 비교하기

기능 및 위치: Settings의 Test Method는 Connectivity Test에 사용할 테스트 방식을 정합니다. 방식마다 확인하는 단계가 다르므로 결과 수치를 서로 다른 방식 간에 직접 비교할 수 없습니다. 테스트 성공은 해당 테스트가 확인한 경로에서 응답이 있었다는 뜻일 뿐입니다.

설정 방법 및 주의 사항: 화면에 제공되는 방식 중 하나를 선택하고, 같은 그룹의 서버를 비교할 때는 테스트 방식과 대상을 동일하게 유지하세요. Wi-Fi와 Cellular를 전환한 뒤에는 다시 테스트하고 이전 네트워크의 결과를 그대로 사용하지 마세요. 모든 항목이 동시에 실패한다면 로컬 네트워크와 테스트 대상을 먼저 확인하고, 특정 항목만 이상하다면 해당 서버의 매개변수를 점검하세요. 마지막으로 실제 요청을 보내 확인해야 합니다. 목록의 결과만으로 모든 웹사이트에 접속할 수 있다고 판단하지 마세요.

Today Widget: 빠른 확인 및 조작

기능 및 위치: Today Widget은 시스템 지원 여부에 따라 사용할 수 있는 빠른 실행 기능입니다. Settings에서 관련 옵션을 확인하고 시스템의 위젯 추가 화면에서 설정할 수 있습니다. Home이나 Config의 전체 설정을 대신하지는 않습니다.

설정 방법 및 주의 사항: 먼저 앱에서 서버와 Global Routing을 설정한 다음 시스템에서 사용할 수 있는 위젯을 추가하세요. 위젯에 표시된 내용이 앱의 현재 상태와 일치하는지 확인합니다. 표시가 바로 갱신되지 않는다면 앱으로 돌아가 실제 연결 상태를 확인하세요. 위젯 유형, 추가 위치, 조작 범위는 시스템에 따라 다릅니다. 현재 기기에 해당 메뉴가 없다면 다른 시스템의 화면 경로를 그대로 따라 하지 마세요.

iCloud 동기화: 동기화와 백업 구분하기

기능 및 위치: iCloud 관련 옵션은 Settings에 있으며, 사용 가능 여부는 플랫폼, 시스템 계정, 클라우드 접근 권한에 따라 달라집니다. 먼저 현재 화면에 표시된 동기화 범위를 확인하세요. 모든 서버, 규칙, 실행 상태가 함께 동기화된다고 가정하면 안 됩니다.

설정 방법 및 주의 사항: 시스템에서 본인의 iCloud 계정에 로그인했는지, 관련 접근을 허용했는지 확인하고, 기능을 켜기 전에 중요한 로컬 구성을 저장하세요. 다른 기기에서 처음 사용할 때는 로컬 데이터와 클라우드 데이터를 먼저 비교한 뒤 작업을 결정합니다. 동기화 방향을 확인하지 않은 상태에서 여러 항목을 한꺼번에 삭제하지 마세요. 동기화는 별도의 이전 기록 백업을 의미하지 않습니다. 구독 URL과 서버 인증 정보는 민감한 정보이므로 내보낸 파일도 안전하게 보관하세요. 다른 플랫폼의 데이터 이전은 해당 플랫폼에서 제공하는 기능을 따르세요.

07 / DIAGNOSTICS

같은 조건에서 문제를 다시 확인하세요

Diagnostics: 증상에서 원인 찾기

Settings에서 Diagnostics를 찾아보세요. Home의 서버 테스트 및 Data 기록을 함께 살펴보되, 한 가지 검사 결과만으로 전체 원인을 단정하지 마세요.

기능: Diagnostics는 현재 플랫폼에서 제공하는 진단 기능을 모아 네트워크, 이름 확인, 연결 단계를 점검하는 데 도움을 줍니다. 실행 전에 확인할 문제를 정하세요. 로컬 네트워크가 작동하는지, 서버가 응답하는지, 도메인 이름을 확인할 수 있는지, 특정 규칙이 적용되는지에 따라 필요한 증거가 다릅니다.

사용 방법: 현재 네트워크 유형, Global Routing 모드, 구성 파일 이름을 기록한 뒤 같은 대상에서 문제를 한 번 재현하세요. 아래 순서대로 항목을 하나씩 확인하고, 설정을 바꿀 때마다 다시 테스트합니다. 결과를 보관한 후 다음 단계로 진행하세요.

  1. 로컬 네트워크 확인. 클라이언트 연결을 잠시 중지하고 네트워크 자체에서 정상적으로 접속할 수 있는지 확인하세요. 로그인 인증이 필요한 Wi-Fi라면 먼저 인증 절차를 완료합니다.
  2. 서버 확인. Home으로 돌아가 선택한 항목과 매개변수를 확인하고 Connectivity Test를 실행한 다음 실제 요청으로 접속을 검증하세요.
  3. Global Routing 비교. Proxy를 임시로 사용해 원래 Config 결과와 비교하세요. 결과가 다르면 구성 파일과 일치한 정책을 중점적으로 확인합니다.
  4. DNS 및 기록 확인. Diagnostics와 Data를 함께 살펴보며 대상 도메인, 이름 확인 결과, 요청 기록 여부를 확인한 뒤 DNS를 조정할지 판단하세요.
  5. 일상 설정 복원. 테스트를 위해 변경한 항목을 되돌리고 Config, On Demand, 연결 스위치의 최종 상태를 다시 확인하세요.

주의 사항: 로그를 더 많이 기록하기 전에 저장 범위를 확인하고, 진단이 끝나면 불필요한 기록을 중지하세요. 다른 사람에게 문제를 설명할 때는 재현 절차, 오류 메시지, 이미 확인한 항목을 제공하고 전체 구독 URL, 비밀번호, 인증 정보는 공개하지 마세요. 항목별 점검이 필요하다면 연결되었지만 웹페이지가 열리지 않을 때 확인할 항목을 참고하세요.

화면에 표시된 용어나 규칙 키워드를 찾으려면 용어집을, 구독 추가부터 시작하려면 첫 사용 안내를 확인하세요.