공식 매뉴얼 · 기능 안내

Shadowrocket 기능 및 설정

먼저 Global Routing을 확인한 다음 현재 설정과 서버를 점검하세요. On Demand, DNS, 테스트 방식은 각각 해결하는 문제가 다르므로 여러 항목을 동시에 변경한 뒤 결과를 판단하지 마세요.

  • iPhone / iPad 사용 안내
  • 화면에 표시되는 용어는 영어로 유지
  • 규칙과 설정을 따로 확인

아래 안내는 iPhone과 iPad의 사용 방식을 기준으로 합니다. 구체적인 메뉴 위치, 선택 항목 및 시스템 요구 사항은 App Store 페이지와 현재 앱 화면에 표시된 내용을 기준으로 확인하세요. 특정 설정이 보이지 않는다고 이름이 비슷한 다른 항목을 임의로 변경하지 마세요.

Global Routing: 트래픽 처리 방식 선택

평소 규칙에 따라 사용하려면 Config를 선택하고, 문제를 비교 점검할 때만 Proxy 또는 Direct를 임시로 선택하세요.Home에서 Global Routing을 열어 현재 선택 항목을 확인합니다. 여기서는 트래픽을 전반적으로 처리하는 방식을 정합니다. 서버를 가져오거나 연결을 켜는 기능은 아닙니다. 항목을 변경한 뒤에는 Home에서 선택한 서버와 연결 상태도 확인하세요.

화면의 선택 항목 처리 방식 사용 상황 주의 사항
Config (구성) 현재 활성화된 구성의 규칙과 정책에 따라 트래픽을 처리합니다. 도메인이나 IP 등의 조건에 따라 처리 방식을 나누어야 하는 일반적인 사용 상황. Config에서 사용할 파일이 올바르게 활성화되어 있는지 확인한 뒤 매칭 결과를 살펴보세요.
Proxy (프록시) 클라이언트가 처리하는 트래픽을 프록시 방식으로 전달합니다. 규칙 때문에 특정 대상에 접속 문제가 발생하는지 비교 점검할 때. 서버를 사용할 수 있어야 합니다. 시스템의 모든 트래픽이 반드시 같은 경로를 거친다는 뜻은 아닙니다.
Direct (직접 연결) 클라이언트가 처리하는 트래픽을 직접 연결 방식으로 처리합니다. 현재 네트워크에서 직접 접속할 때의 결과와 비교할 때. Direct는 연결을 끄는 기능이 아니며, 서버 연결이 정상이라는 뜻도 아닙니다.

한 번에 한 항목만 변경하세요

Config에서 특정 대상에 문제가 생기면 Proxy로 잠시 전환한 뒤 같은 네트워크와 서버를 사용해 같은 대상에 다시 접속해 보세요. 결과가 달라졌다면 규칙과 정책을 확인하세요. 문제가 계속되면 서버 매개변수, DNS, 네트워크 상태를 점검합니다. 비교 점검이 끝나면 원래 모드로 되돌려 임시 설정을 일상적인 설정으로 남기지 마세요.

Proxy로 한 번 접속에 성공했다고 전체 구성이 올바르다고 판단하지 마세요. Direct 접속에 실패했다고 앱에 문제가 있다고 단정해서도 안 됩니다. 대상에 따라 네트워크 조건이 다를 수 있으므로 점검할 때는 대상, 네트워크, 테스트 시간을 동일하게 유지하세요.

규칙 기반 라우팅: 매칭 조건과 처리 정책 구분

규칙은 ‘무엇을 매칭할지’를 정하고, 정책은 ‘매칭 후 어떻게 처리할지’를 정합니다.Config에서 현재 구성 파일을 확인하고 먼저 해당 파일이 사용 중인지 살펴보세요. 그런 다음 규칙 내용을 점검합니다. Global Routing이 Config로 설정되어 있으면 보통 규칙을 순서대로 확인합니다. 조건이 지나치게 포괄적이면 앞쪽 규칙이 뒤에 있는 구체적인 규칙보다 먼저 적용될 수 있습니다.

규칙 유형 선택 방법

DOMAIN은 정확한 도메인에, DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에, DOMAIN-KEYWORD는 도메인 키워드 매칭에 사용합니다. 특정 서비스의 규칙을 조정할 때는 확인 가능한 도메인부터 살펴보세요. 너무 짧은 키워드로 관련 없는 여러 대상까지 매칭하지 않도록 주의하세요.

IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 나타냅니다. GEOIP는 IP 주소 위치 데이터베이스를 기준으로 매칭하며, 결과는 데이터베이스와 확인된 주소에 따라 달라집니다. USER-AGENT는 식별 가능한 요청 정보가 있어야 동작하므로, 모든 암호화 트래픽에서 앱을 식별할 수 있는 방식으로 간주해서는 안 됩니다.

정책과 최종 기본 처리

DIRECT는 직접 연결, PROXY는 프록시 처리, REJECT는 매칭된 트래픽 거부를 뜻합니다. 구성에서 이미 정의된 정책 그룹 이름을 참조할 수도 있습니다. 참조할 때는 이름이 정확히 일치하는지 확인하세요. FINAL은 앞선 규칙에 매칭되지 않은 트래픽에 적용되는 최종 정책입니다. 규칙 맨 끝에 두고 매칭되지 않은 트래픽의 처리 방식을 명확히 지정하세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 예시는 규칙 구문만 설명합니다. example.com과 하위 도메인에는 PROXY를 사용하고, 다른 미매칭 트래픽에는 DIRECT를 사용합니다. 완전한 구성 파일이 아니며 서버도 정의하지 않습니다. 편집하기 전에 현재 파일을 백업하세요. 구성이 원격에서 업데이트되는 경우 로컬에서 수정한 내용이 업데이트 후에도 유지되는지 확인하세요.

구독 및 서버 관리: 먼저 가져온 뒤 매개변수 확인

구독은 여러 서버 정보를 업데이트하는 경로이고, 개별 서버는 구체적인 연결 매개변수입니다.둘은 Config의 규칙 기반 라우팅과는 별개입니다. Home에서 서버를 관리하고 추가 메뉴를 통해 Add Server로 이동하세요. QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 구독 링크와 서버 매개변수는 이용 중인 서비스 제공업체에서 확인하세요.

가져온 뒤 확인할 항목

구독을 사용하려면 추가 절차에서 Subscribe를 선택하고 현재 화면의 안내에 따라 주소와 메모를 입력하세요. 가져오기가 끝나면 예상한 서버 목록이 표시되는지 확인한 다음 사용할 항목을 선택합니다. 수동으로 추가할 때는 먼저 올바른 프로토콜 유형을 선택하고 주소, 포트, 인증 정보, 전송 매개변수를 대조해 입력하세요. 서버 메모만 보고 프로토콜을 판단하지 마세요.

Shadowsocks, VMess, VLESS, Trojan, Hysteria2 등의 프로토콜은 필요한 입력 항목이 서로 다릅니다. TLS, SNI, 전송 유형, 경로 등의 매개변수는 기존 안내와 일치해야 합니다. 한 번의 테스트를 통과하려고 검증을 임의로 끄거나 인증 정보를 바꾸지 마세요. 서비스 제공업체가 안내한 항목이 현재 입력 양식과 맞지 않는다면 프로토콜 유형과 매개변수 설명부터 확인하세요.

업데이트와 삭제 시 유의할 점

구독을 업데이트하면 원격에서 제공하는 서버 정보를 다시 가져오므로 목록 이름, 항목 수, 매개변수가 달라질 수 있습니다. 구독에 포함된 항목을 직접 수정했다면 업데이트 후에도 변경 사항이 유지되는지 먼저 확인하세요. 이전 항목을 삭제하기 전에 현재 선택된 서버와 정책 그룹에서 해당 서버를 참조하는지 점검하세요. 서버 하나를 삭제해도 구독 경로까지 삭제되는 것은 아닙니다.

구독 주소에는 접근 인증 정보가 포함될 수 있습니다. 전체 주소가 보이는 화면을 공개하거나 채팅 및 문제 설명에 그대로 붙여 넣지 마세요. Connectivity Test는 현재 네트워크에서의 테스트 결과를 초기에 확인하는 데 유용하지만, 모든 웹사이트와 프로토콜 기능 또는 전체 전송 속도를 검증하지는 않습니다. 처음 설정할 때는 사용법 안내를 참고하세요.

On Demand: 네트워크 조건에 따른 연결

먼저 수동 연결이 안정적인지 확인한 다음 On Demand를 설정하세요.On Demand는 지정한 네트워크 조건에 따라 연결 동작을 실행하는 기능이지, 서버 매개변수를 수정하는 도구가 아닙니다. Settings에서 On Demand 관련 메뉴를 찾아 현재 화면에서 제공하는 조건과 동작을 하나씩 확인하세요. ‘활성화’를 모든 네트워크에 적용할 수 있는 고정 설정으로 이해하지 마세요.

설정 전에 원하는 동작을 구체적으로 정리하세요. 어떤 Wi-Fi 환경에서 연결할지, 셀룰러 네트워크로 전환하면 어떻게 할지, 어떤 조건에서 연결을 유지하지 않을지 결정합니다. 화면에서 지원하는 조건별로 설정한 뒤 실제 네트워크를 전환해 확인하세요. 테스트할 때는 특정 웹페이지가 열리는지만 보지 말고 시스템의 연결 상태와 Home의 상태를 함께 확인하세요.

수동으로 연결을 끊었는데 다시 연결된다면 먼저 On Demand가 계속 활성화되어 있는지 확인한 다음 시스템의 VPN 설정을 살펴보세요. 자동 재연결을 해결하려고 서버를 삭제하는 것은 보통 올바른 첫 단계가 아닙니다. 자동 연결을 잠시 중단하려면 해당 조건을 먼저 비활성화한 뒤 현재 연결을 끊고 다시 확인하세요.

네트워크 전환, 시스템의 연결 관리, 현재 구성이 모두 연결 동작에 영향을 줄 수 있습니다. 의미가 겹치는 조건을 여러 개 동시에 설정하지 마세요. 변경 후 기대한 동작과 실제 결과를 기록하면 조건이 충족되지 않은 것인지 연결 자체가 실패한 것인지 판단하기 쉽습니다.

Data: 클라이언트에서 기록한 트래픽 확인

Data는 클라이언트의 통계를 확인하는 기능이며, 서비스 제공업체의 사용량 기록을 대신하지 않습니다.앱 하단의 Data를 열고 통계 범위, 기간, 분류를 먼저 확인한 다음 수치를 살펴보세요. 범위가 다른 누적값은 직접 비교할 수 없으며 연결 시간도 실제 데이터 전송 시간과 같지 않습니다.

특정 작업으로 트래픽이 발생했는지 확인하려면 현재 통계를 기록한 뒤 확인하려는 대상에 한 번만 접속하고 Data에서 변화를 살펴보세요. 통계를 초기화할 예정이라면 보관할 기록을 먼저 저장하세요. 초기화는 해당 로컬 통계에만 적용되며 서비스 제공업체 계정의 사용량은 초기화되지 않습니다.

통계 범위, 프로토콜 오버헤드, 시간 구간, 다른 기기의 사용 여부에 따라 로컬 통계와 서비스 제공업체의 사용량은 다를 수 있습니다. 누적 수치 하나만으로 문제가 있다고 판단하지 마세요. 점검할 때는 같은 시간대의 연결 상태, 접속 대상, 통계 변화를 함께 살펴보고 필요하면 Diagnostics로 추가 정보를 확인하세요.

Settings: 자주 사용하는 항목의 역할

Settings에서는 앱 환경설정과 보조 도구를 관리합니다. 다만 일부 네트워크 동작은 Config의 내용에 따라 달라질 수 있습니다. 변경하기 전에 문제가 규칙, 서버, 전역 환경설정 중 어디에 해당하는지 판단하세요. 현재 구성 파일에 관련 설정이 있다면 화면 설정과 적용 범위를 먼저 확인해 두 곳에서 서로 덮어쓰지 않도록 하세요.

DNS: 도메인 이름 확인

DNS는 도메인 이름을 IP 주소로 변환합니다. 주소로는 접속되지만 도메인으로 접속되지 않거나 네트워크마다 DNS 결과가 크게 달라진다면 DNS를 확인해 보세요. 먼저 현재 Config에 DNS 설정이 있는지 살펴본 다음 Settings의 관련 항목을 확인하세요. 기존 값을 기록하고 한 번에 하나씩만 변경한 뒤 같은 도메인으로 다시 테스트하세요.

DNS를 바꿔도 비밀번호, 포트, 규칙 순서가 자동으로 수정되지는 않습니다. DNS 요청 자체에 접근할 수 있는지, IPv4와 IPv6 결과가 어떤지, 규칙이 DNS 요청 경로에 영향을 주는지도 확인해야 합니다. 특정 DNS 서비스의 이름만 보고 현재 네트워크에서 반드시 작동한다고 판단하지 마세요.

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

Test Method는 연결 테스트에 사용할 방식을 정합니다. Settings에서 선택한 방식과 화면에 표시되는 관련 테스트 대상을 확인하세요. 테스트 방식마다 확인하는 연결 구간이 다르므로 같은 서버에서 결과가 달라도 반드시 모순되는 것은 아닙니다. 결과를 비교할 때는 네트워크, 대상, 테스트 방식을 동일하게 유지하세요. 조건 변화에 따른 차이를 서버 성능 변화로 오해하지 않도록 주의하세요.

테스트 결과는 해당 시점의 테스트 상황만 보여줍니다. 실제 앱 사용 경험과 같지 않으며 전체 대역폭이나 장기적인 안정성을 단독으로 판단하는 근거가 될 수 없습니다. 테스트는 정상이지만 접속에 실패한다면 대상 도메인의 규칙, DNS, 서버 전송 매개변수를 추가로 확인하세요.

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

Today Widget 관련 옵션은 시스템 위젯에 정보를 표시하거나 빠른 조작을 제공하는 기능입니다. Settings에서 사용할 수 있는 항목을 확인한 뒤 시스템에서 제공하는 위젯 추가 방법에 따라 활성화하세요. 표시 여부와 가능한 동작은 현재 시스템 및 앱 화면을 기준으로 확인해야 합니다. 위젯은 조작을 위한 진입점이지 별도의 구성이 아닙니다.

위젯에서 조작한 뒤에는 Home으로 돌아가 연결 상태와 현재 선택된 서버를 확인하세요. 위젯 표시 내용이 앱과 일치하지 않으면 먼저 상태가 새로 고쳐졌는지 확인하고, 바로 구성을 삭제하거나 구독을 다시 가져오지 마세요.

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

iCloud 설정은 지원되는 범위에서 앱 데이터를 동기화합니다. 사용하기 전에 기기의 iCloud 상태, 앱 접근 권한, Shadowrocket의 동기화 옵션을 확인한 다음 다른 기기에 실제로 어떤 항목이 나타나는지 점검하세요. 모든 항목과 시스템 권한이 함께 이전된다고 가정하지 마세요.

동기화는 별도의 백업과 다릅니다. 한 기기에서 변경하거나 삭제한 내용이 다른 기기에도 반영될 수 있습니다. 중요한 구성은 복원할 수 있는 사본을 별도로 보관하세요. 새 기기로 옮길 때는 구독, 서버, 구성이 모두 제대로 표시되는지 확인한 다음 자동 연결을 다시 설정하세요. 앱을 복원했더라도 시스템에서 VPN 구성 권한을 다시 확인하라고 요청할 수 있습니다.

Diagnostics: 문제에 필요한 정보 수집

Diagnostics는 연결 및 네트워크 문제를 점검하는 기능입니다. Settings에서 관련 메뉴를 열고 문제 상황에 맞는 도구를 선택한 뒤 도메인, 주소 또는 연결 증상을 기준으로 테스트하세요. 서로 관련 없는 테스트 결과를 많이 모으기보다 네트워크 유형, Global Routing 선택 항목, 현재 구성, 문제 재현 절차를 기록하는 편이 더 유용합니다.

로그와 진단 결과에는 접속 대상, 서버 주소, 인증 정보가 포함될 수 있습니다. 공유하기 전에 민감한 내용을 확인하고 가리세요. 문제를 설명할 때는 필요한 항목만 남기세요. 한 번의 진단 성공 또는 실패를 모든 연결에 대한 결론으로 확대해서는 안 되며, 당시의 네트워크와 구성을 함께 고려해야 합니다.

설정 점검 순서: 상태부터 구체적인 대상까지

연결 문제가 발생하면 현재 상태를 먼저 기록한 뒤 항목별로 확인하세요. 구독 업데이트, 구성 교체, DNS 변경, On Demand 조정을 동시에 하면 접속이 복구되더라도 원인을 파악하기 어렵습니다.

  1. 기본 네트워크를 확인하세요.기기의 현재 네트워크가 작동하는지 확인하고 Wi-Fi와 셀룰러 중 어느 쪽을 사용하는지 기록하세요.
  2. Home을 확인하세요.연결 상태와 현재 선택한 서버를 확인하고 시스템에서 VPN 구성을 추가하도록 허용했는지 살펴보세요.
  3. Global Routing을 확인하세요.이번 테스트 목적에 맞게 Config, Proxy, Direct 중 올바른 항목이 선택되어 있는지 확인하세요.
  4. Config를 확인하세요.활성화된 파일, 대상 매칭 규칙, 정책 이름, FINAL 기본 처리를 확인하세요.
  5. 서버를 확인하세요.기존 안내와 주소, 포트, 인증 정보, 전송 매개변수를 하나씩 대조하고 구독 업데이트로 항목이 바뀌었는지 살펴보세요.
  6. 보조 설정을 확인하세요.DNS, Test Method, On Demand를 차례로 확인한 뒤 Diagnostics에서 같은 대상을 다시 테스트하세요.

문제가 해결되면 임시 점검용 변경 사항을 하나씩 되돌리고 필요한 변경만 남기세요. 익숙하지 않은 구성을 편집하기 전에는 백업하고, 인증 정보가 포함된 데이터를 공유하기 전에는 민감한 내용을 가리세요. 처음 연결하는 순서대로 진행하려면 사용법 안내를 확인하세요. 증상에 따라 원인을 찾으려면 문제 해결을 참고하세요.