설정 참고 · 공식 매뉴얼

Shadowrocket 기능 및 설정

먼저 Global Routing을 정한 다음 Config와 서버를 확인하세요. Home, Data, Settings의 용도에 맞춰 항목을 설정하고, 한 번에 하나씩만 변경하세요.

모드 비교 보기 첫 연결 가이드 보기
  • Home · 연결 및 선택
  • Config · 구성 파일
  • Settings · 환경 설정 및 진단

Home / Global Routing

Global Routing: Config, Proxy, Direct

Global Routing은 연결을 켠 뒤 트래픽 경로를 선택합니다. 서버를 가져오거나 연결 스위치를 대신하는 기능은 아닙니다. 도메인이나 주소별로 트래픽을 분기하려면 Config 모드를 사용하고, 현재 서버를 임시로 확인하려면 Proxy 모드를 선택하세요. 로컬 네트워크가 정상인지 비교할 때는 Direct 모드를 사용할 수 있습니다. 각 모드는 이름이 비슷해도 적용 범위가 다르므로, 전환하기 전에 무엇을 확인할지 먼저 정하세요.

화면 위치와 선택 방법

Home에서 Global Routing을 열고 Config, Proxy 또는 Direct를 선택한 다음 Home으로 돌아와 현재 서버와 연결 상태를 확인하세요. 여기서 Config는 라우팅 모드이며, 하단 탭의 Config는 구성 파일을 관리하는 메뉴입니다. Config 모드를 선택한 뒤에는 Config 화면에서 실제로 활성화된 파일도 확인해야 합니다. 모드 이름만 보고 필요한 규칙이 적용됐다고 판단하지 마세요.

Global Routing 세 가지 모드의 용도와 확인 항목
모드 경로 선택 사용 상황 확인 항목
구성 · Config 현재 구성 파일의 규칙과 정책에 따라 요청을 처리합니다. 도메인이나 주소마다 서로 다른 정책을 적용해야 하는 일반적인 연결 활성화된 파일, Rule 순서, 최종 규칙, 정책 대상
프록시 · Proxy 전체 라우팅 방향을 프록시로 설정합니다. 시스템 및 구성의 우회 항목은 별도로 확인해야 합니다. 현재 서버로 대상에 접속할 수 있는지 임시로 비교할 때 선택한 서버, 연결 매개변수, 대상 자체, 네트워크 환경
직접 연결 · Direct 전체 라우팅 방향을 로컬 네트워크를 통한 직접 접속으로 설정합니다. 로컬 네트워크를 비교하거나 문제가 프록시 경로와 관련 있는지 확인할 때 로컬 네트워크 연결 가능 여부와 요청에 영향을 주는 다른 설정

모드 전환 시 주의할 점

Proxy를 선택해도 모든 앱의 모든 시스템 요청이 동일한 경로를 거치는 것은 아닙니다. Direct도 시스템의 VPN 설정을 끄는 기능은 아닙니다. 문제를 확인할 때는 모드와 연결 스위치 상태를 따로 기록해 혼동하지 마세요. Config에서 접속이 안 되지만 Proxy에서는 정상이라면 규칙과 정책을 먼저 확인하세요. 두 모드에서 모두 실패한다면 서버 매개변수와 네트워크 연결부터 점검하세요. 비교를 마친 뒤에는 원래 모드로 되돌리고, 임시 테스트 상태를 계속 사용하지 마세요.

Config / Rule

규칙 분기: 조건을 먼저 확인한 뒤 정책 적용

규칙 분기는 요청의 종류와 요청이 처리되는 방식을 구분합니다. DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD는 서로 다른 범위의 도메인을 매칭하고, IP-CIDR과 IP-CIDR6은 주소 대역을 매칭합니다. GEOIP는 주소의 위치 정보 데이터에 따라 판단하며, USER-AGENT는 확인 가능한 요청 정보를 사용합니다. 정책 PROXY, DIRECT, REJECT는 각각 프록시, 직접 연결, 거부를 뜻합니다. 프로토콜 이름은 정책 이름이 아닙니다. 서버가 Trojan 또는 WireGuard를 사용한다고 해서 특정 도메인에 어떤 규칙이 적용되는지는 자동으로 정해지지 않습니다.

화면 위치와 수정 방법

Config로 이동해 현재 활성화된 구성 파일을 확인한 다음, 파일의 편집 메뉴에서 Rule 섹션을 살펴보세요. 수정 전에 정상적으로 작동하는 사본을 보관하고, 한 번에 규칙 하나만 조정하세요. 수정한 파일이 현재 사용 중인 파일인지도 확인해야 합니다. 새 규칙은 일반적으로 범위가 넓은 규칙보다 앞에 둡니다. FINAL은 마지막에 배치해 앞선 규칙에 매칭되지 않은 요청을 처리합니다.

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.net,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
  • DOMAIN,example.com,DIRECT: example.com에 정확히 매칭해 DIRECT를 적용합니다. 이 규칙만으로 모든 하위 도메인이 포함되지는 않습니다.
  • DOMAIN-SUFFIX,example.net,PROXY: example.net과 하위 도메인에 매칭해 PROXY로 처리합니다.
  • IP-CIDR,192.168.0.0/16,DIRECT: 대상 주소가 지정된 사설 주소 대역에 속하면 DIRECT를 적용합니다. 다른 사설 주소 대역까지 포함하는 것은 아닙니다.
  • FINAL,PROXY: 앞선 규칙에 매칭되지 않은 요청에 PROXY를 적용합니다. 프록시 대상이 정상적으로 작동하는지 먼저 확인하세요.

매칭 순서와 확인 가능한 정보의 한계

Rule 섹션은 위에서 아래 순서로 확인하며, 먼저 매칭된 규칙이 후속 정책을 결정합니다. 범위가 넓은 규칙을 앞에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다. 주소 기반 매칭은 도메인 확인 결과의 영향을 받을 수 있으므로 규칙의 텍스트 순서만 보고 DNS 결과를 간과하지 마세요. 암호화된 요청은 USER-AGENT를 항상 확인할 수 있는 것이 아니므로, 이를 일반적인 앱 식별 방식으로 간주해서는 안 됩니다.

위 예시는 규칙 문법을 설명하기 위한 것으로, 완전한 구성 파일이 아닙니다. 실제 파일에서 PROXY를 사용하려면 사용할 수 있는 프록시 대상이 있어야 합니다. 사용자 지정 정책 이름을 사용하는 파일은 이름과 참조가 일치하는지도 확인하세요. General, Host, URL Rewrite 및 규칙 우선순위에 관한 내용은 규칙 및 구성 참고를 확인하세요.

Home / Add Server / Subscribe

구독 및 서버 관리: 매개변수와 규칙을 따로 확인

서버 항목에는 특정 서버에 연결하는 데 필요한 주소, 포트, 프로토콜, 인증 매개변수가 저장됩니다. 구독은 여러 항목을 한곳에서 가져오고 업데이트하는 기능입니다. 어느 쪽도 트래픽 분기용 구성 파일과는 다릅니다. 이 사이트는 사용자가 이미 구독이나 서버 정보를 보유하고 있다는 전제하에 가져오기와 관리 방법만 안내하며, 서버나 구독을 제공·판매·추천하지 않습니다.

화면 위치와 추가 방법

Home에서 추가 메뉴를 열고 Add Server로 이동하세요. 구독이 있다면 앱에 표시되는 Subscribe 유형을 선택하고 본인의 구독 주소와 알아보기 쉬운 이름을 입력합니다. 단일 서버 정보가 있다면 해당 프로토콜을 선택해 항목을 하나씩 입력하세요. Scan QR Code를 사용하기 전에 QR 코드가 본인의 구성 정보에서 제공된 것인지 확인하세요. 가져온 뒤에도 항목 유형, 주소, 포트를 확인해야 하며, 스캔에 성공했다고 연결까지 완료된 것은 아닙니다.

Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등의 프로토콜은 입력 항목이 서로 다릅니다. 정보와 현재 화면에 표시된 항목을 기준으로 입력하고, 한 프로토콜의 비밀번호·식별자·전송 매개변수를 다른 프로토콜에 그대로 복사하지 마세요. TLS 관련 항목은 서버 이름과 인증서 설정을 특히 꼼꼼히 확인해야 합니다. 오류를 우회하려고 인증 설정을 임의로 변경하지 마세요.

업데이트, 테스트, 삭제 시 주의사항

구독을 업데이트한 다음 그룹의 항목이 바뀌었는지 확인하고, 현재 선택된 서버도 다시 확인하세요. 구독 제공 정보에 따라 항목 이름이나 내용이 달라질 수 있으므로, 구독으로 생성된 항목을 직접 수정했다면 다음 업데이트에서 변경 사항이 덮어써질 수 있습니다. 삭제 전에는 단일 항목을 지우는 것인지 구독 그룹 전체를 제거하는 것인지 구분하세요.

Connectivity Test는 현재 테스트 조건에서 응답을 확인하는 기능입니다. 웹페이지, 동영상 또는 모든 프로토콜의 트래픽이 정상적으로 전송된다는 뜻은 아닙니다. 테스트 결과가 있어도 실제 접속에 실패한다면 대상 도메인, Global Routing, DNS, 규칙 매칭 상태를 추가로 확인하세요. 결과가 없을 때는 Test Method도 함께 살펴봐야 합니다. 한 번의 결과만으로 항목이 작동하지 않는다고 단정하지 마세요.

Settings / On Demand

On Demand: 조건에 따라 연결 시작

On Demand는 설정된 네트워크 조건에 따라 필요할 때 연결을 시작하는 기능입니다. 연결을 시작할 시점을 다루는 On Demand와 연결 후 트래픽 경로를 다루는 Global Routing은 역할이 다릅니다. On Demand를 켜도 서버 매개변수 문제가 해결되거나 유효하지 않은 구성 정보가 자동으로 교체되지는 않습니다.

화면 위치와 설정 방법

Settings에서 On Demand 관련 메뉴를 찾아 현재 화면에 표시되는 네트워크 조건과 동작을 먼저 확인한 뒤, 사용 상황에 맞게 활성화하세요. Wi-Fi와 셀룰러 네트워크에 따라 동작을 나누려면 해당 조건을 하나씩 확인해야 합니다. 특정 Wi-Fi 이름이 조건에 포함된다면 이름이 정확한지도 살펴보세요. 선택 가능한 항목은 앱에 현재 표시되는 내용을 기준으로 하며, 다른 기기의 설정을 그대로 따라 하면서 확인 절차를 생략하지 마세요.

처음 설정하기 전에 수동 연결 상태에서 같은 서버 정보가 정상적으로 작동하는지 확인한 다음 On Demand를 켜세요. 이후 연결이 필요한 네트워크와 연결되지 않아야 하는 네트워크에서 각각 테스트하세요. 이렇게 하면 연결 조건이 작동하지 않는 문제와 연결이 시작된 뒤 서버를 사용할 수 없는 문제를 구분할 수 있습니다.

수동으로 연결을 끊은 뒤 다시 연결되면 확인할 항목

수동으로 연결을 끊었는데 다시 연결되면 먼저 On Demand와 관련 조건을 확인하고, 시스템의 VPN 상태도 살펴보세요. Wi-Fi에서 셀룰러 네트워크로 전환할 때도 상태를 다시 확인해야 합니다. Home에 한 번 표시된 상태만으로 전체 전환 과정이 정상이라고 판단하지 마세요. On Demand 연결을 오랫동안 중지하려면 관련 설정을 명확히 끈 다음 상태를 확인하세요. 연결 스위치를 반복해서 조작하지 마세요.

Data

Data: 클라이언트 통계 확인, 서버 청구 내역과는 별개

Data에서는 앱이 기록한 트래픽 정보를 확인해 업로드와 다운로드, 현재 통계 범위의 사용량을 파악할 수 있습니다. 연결 후 트래픽이 오갔는지 살펴보는 데 유용하지만, 통계 수치만으로 웹페이지가 완전히 로드됐거나 요청에 예상한 정책이 적용됐다고 판단할 수는 없습니다.

화면 위치와 확인 방법

Data를 열고 현재 표시되는 통계의 대상과 범위를 먼저 확인한 다음 업로드와 다운로드를 구분하세요. 짧게 테스트할 때는 현재 수치를 기록하고, 분명한 동작을 한 번만 실행한 뒤 돌아와 변화를 비교하면 됩니다. 화면에 초기화 메뉴가 있다면 사용 전에 기존 기록을 보존할 필요가 있는지 확인하세요. 초기화 후에는 해당 수치로 이전 사용 내역을 확인할 수 없습니다.

통계 차이를 이해하는 방법

클라이언트와 서버는 측정 범위, 기간 기준, 프로토콜 오버헤드 산정 방식이 다를 수 있습니다. 따라서 Data 수치를 구독 정보에 표시된 사용량과 동일하게 볼 수 없습니다. 구독 한도 역시 현재 기기의 누적 사용량과는 다릅니다. 서버 측 측정 내역은 사용자가 보유한 서비스 정보를 확인하세요. 클라이언트 요청 경로를 확인하려면 누적 트래픽만 볼 것이 아니라 모드, 규칙, 진단 기록을 함께 살펴봐야 합니다.

Settings / Config

Settings 주요 항목: 용도에 맞게 조정

Settings에서는 앱 환경 설정, 테스트 방법, 관련 도구를 관리할 수 있지만 모든 동작이 이 화면에서만 결정되는 것은 아닙니다. 구성 파일의 General 섹션도 연결과 이름 확인에 영향을 줍니다. 설정을 확인할 때는 현재 구성 파일도 기록해 두세요. 메뉴 위치나 선택 항목이 다르면 앱에 실제로 표시되는 내용을 기준으로 판단하세요.

DNS: 구성 파일을 먼저 확인한 뒤 이름 확인 방식 변경

DNS는 도메인을 주소로 변환하며 도메인 접속과 일부 주소 기반 규칙의 판단에 영향을 줍니다. 먼저 Config에서 현재 파일의 General 섹션과 DNS 관련 설정을 확인하세요. Settings에 관련 항목이 있다면 함께 살펴봐야 합니다. 한 곳만 변경하고 전체에 적용됐다고 단정하지 마세요.

[General]
dns-server = system

dns-server = system은 시스템 DNS를 사용한다는 뜻으로, DNS 확인 경로를 이해하기 위한 예시입니다. 모든 네트워크에 적용할 수 있는 정답은 아닙니다. 사용자 지정 DNS나 DNS over HTTPS를 사용하려면 먼저 현재 네트워크에서 해당 DNS 서비스에 접속할 수 있는지 확인하세요. 설정을 변경한 뒤에는 같은 도메인으로 다시 테스트하세요. DNS, 서버, Global Routing을 한꺼번에 변경하면 어떤 변경이 영향을 줬는지 판단하기 어렵습니다.

Test Method: 테스트 조건과 함께 결과 확인

Settings에서 Test Method를 찾아 현재 제공되는 방식 중 하나를 선택한 다음 Home으로 돌아와 Connectivity Test를 실행하세요. 방식에 따라 서로 다른 응답 항목을 확인할 수 있으므로 방식을 바꾼 뒤 얻은 수치를 직접 비교하기는 어렵습니다. 여러 항목을 비교할 때는 테스트 방법, 네트워크, 시간대를 가능한 한 동일하게 유지하세요. 테스트 후에는 실제 접속도 확인해야 합니다. 응답 시간이 짧다고 처리량까지 높다는 뜻은 아닙니다.

Today Widget: 간편한 상태 확인 및 조작

Today Widget 관련 설정은 시스템 위젯 메뉴와 연동해 상태를 확인하거나 제공되는 빠른 동작을 실행할 때 사용합니다. Settings에서 Today Widget의 선택 항목을 확인한 뒤 시스템에서 허용하는 위치에 해당 위젯을 추가하세요. 표시 여부와 제공되는 동작은 기기의 시스템 및 앱 지원 여부에 따라 다르므로 실제 화면을 기준으로 확인해야 합니다.

위젯 표시에는 새로고침 간격이 있을 수 있습니다. 연결 상태를 확인하려면 Home과 시스템의 VPN 상태를 확인하세요. 빠른 실행 기능도 첫 연결에 필요한 시스템 승인을 건너뛸 수는 없습니다. 위젯에 항목이 표시되지 않으면 위젯 설정과 앱 상태를 먼저 확인하고, 같은 정보를 반복해서 가져오지 마세요.

iCloud: 동기화 전 로컬 정보와 클라우드 정보 구분

iCloud 동기화 기능을 사용하기 전에 기기가 필요한 계정에 로그인되어 있는지, 시스템에서 앱의 iCloud 사용을 허용했는지 확인하세요. Settings의 관련 메뉴에서 실제로 동기화할 수 있는 항목도 살펴보세요. 현재 정상적으로 사용할 수 있는 구성을 보관한 뒤 동기화를 켜거나 복원하고, 다른 기기에 필요한 정보가 도착했는지 확인하세요. 모든 환경 설정과 실행 상태가 함께 옮겨진다고 가정하지 마세요.

구독 주소, 인증 항목, 구성 파일에는 민감한 정보가 포함될 수 있으므로 동기화 전에 저장되는 내용을 확인하세요. iCloud 동기화는 앱 구매 내역 복원과 다르며, 기존 기기의 시스템 VPN 승인까지 새 기기로 자동 이전하지 않습니다. 기기를 바꾼 뒤에도 서버, 구성 파일, 첫 연결에 필요한 승인을 하나씩 확인해야 합니다.

Diagnostics: 한 번의 실패를 기준으로 정보 수집

문제가 발생하면 Settings의 Diagnostics 관련 메뉴에서 현재 제공되는 진단 도구를 확인하세요. 문제가 발생했을 때의 네트워크, Global Routing 모드, 서버, 구성 파일을 먼저 기록한 다음 실패를 한 번 재현하세요. 진단 내용은 같은 작업에서 수집한 결과끼리 비교해야 합니다. 서로 다른 네트워크의 결과를 섞어 판단하지 마세요.

진단 자료를 공유하기 전에 구독 주소, 인증 정보, 접속 도메인 또는 기타 개인 정보가 포함되어 있는지 확인하고 필요한 내용을 먼저 가리세요. 진단 결과와 실제 접속 상태가 다르면 Home으로 돌아가 현재 선택 항목과 연결 상태를 확인한 뒤 DNS와 Rule을 살펴보세요. 정보를 반복해서 가져오는 것으로 문제 확인을 대신하지 마세요.

Settings checklist

설정 확인 순서: 연결, 트래픽 분기, 자동화

  1. 정보 확인.Home에서 사용자가 보유한 서버 또는 구독 항목을 확인하고, 프로토콜과 필수 매개변수가 모두 입력됐는지 살펴본 뒤 테스트할 서버를 선택하세요.
  2. 모드 확인.Global Routing에서 Config, Proxy, Direct 중 현재 모드를 확인하고, 이번에는 프록시 경로와 규칙 동작 중 무엇을 테스트할지 기록하세요.
  3. 파일 확인.Config 모드에서는 Config로 이동해 활성화된 파일, Rule 순서, FINAL을 확인하세요. 특히 사용자 지정 정책 참조를 살펴보세요.
  4. 실제 요청 확인.먼저 Connectivity Test를 실행한 뒤 명확한 대상에 접속하세요. 필요한 경우 Data와 Diagnostics를 함께 확인해 해당 요청이 있었는지 판단하세요.
  5. 자동화는 마지막에 설정.수동 연결과 규칙 테스트가 정상적으로 끝난 뒤 On Demand, Today Widget, iCloud를 설정하고 각각 결과를 확인하세요.

변경한 뒤 원인을 판단하기 어렵다면 이전에 보관한 정상 구성으로 돌아가 항목을 하나씩 복원하세요. 선택 항목을 한꺼번에 더 켜지 마세요. 처음 가져오기와 연결 절차는 시작 가이드를, 용어는 개념 빠른 참고를 확인하세요. 구체적인 문제는 문제 해결에서 항목별로 점검할 수 있습니다.