공식 매뉴얼 · 기능 및 설정

Shadowrocket
프록시 모드 및 주요 설정

먼저 연결 처리 방식을 정한 다음 규칙과 네트워크 설정을 조정하세요. Home에서 연결을 시작하고, Config에서 규칙을 확인한 뒤, Settings에서 보조 설정을 살펴보세요.

이 페이지는 주로 iPhone / iPad에서의 조작을 다룹니다. 화면 구성과 사용 가능한 항목은 앱에 표시되는 내용을 기준으로 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다. 가져오기 기능은 사용자가 이미 보유한 구독 또는 서버 정보를 전제로 합니다.

GLOBAL ROUTING

Config, Proxy, Direct
각각 언제 사용할까요

Global Routing은 전체 연결 처리 방식을 정하고, 선택한 서버는 프록시 연결에 사용할 대상을 지정합니다. 서로 다른 설정입니다.

무엇인가요: Global Routing은 연결 처리 모드를 선택하는 항목입니다. 규칙을 사용하는 모드는 Config, 프록시 모드는 Proxy, 직접 연결 모드는 Direct입니다. 프로토콜을 선택하거나 기존 구독을 앱으로 가져오는 기능은 아닙니다. 서버를 선택했더라도 모드를 변경하면 실제 접속 경로가 달라질 수 있습니다.

어디에 있나요: Home에서 Global Routing을 찾아 모드를 선택하세요. 여기의 Config는 하단 탭에서 구성 파일을 관리하는 Config와 용도가 다릅니다. 전자는 규칙에 따라 연결을 처리할지 결정하고, 후자는 사용할 구성 파일을 선택합니다.

화면 옵션처리 방식주요 용도확인할 항목
Config현재 구성에 설정된 규칙과 정책에 따라 연결을 처리합니다.도메인이나 주소별로 일상적인 트래픽을 분기할 때 사용합니다.구성이 선택되어 있는지, 규칙 순서가 올바른지, 정책 대상이 유효한지 확인하세요.
Proxy일반적으로 연결을 현재 프록시 대상으로 전달합니다. 단, 앱과 시스템의 적용 범위를 확인해야 합니다.규칙 때문에 접속 결과가 달라지는지 일시적으로 확인할 때 사용합니다.현재 서버의 사용 가능 여부와 인증 및 프로토콜 매개변수가 올바른지 확인하세요.
Direct선택한 프록시 서버를 거치지 않고 직접 연결합니다.현재 네트워크에서 접속이 가능한지 확인할 때 사용합니다.로컬 네트워크와 DNS 확인이 정상인지 살펴보세요. Direct는 연결 스위치를 끄는 기능이 아닙니다.

설정 방법: 사용 가능한 구성이 있고 규칙에 따라 트래픽을 분기하려면 Config를 선택하세요. 규칙 때문에 요청이 예상과 다르게 처리되는지 의심된다면 Proxy를 잠시 선택한 뒤 같은 요청을 다시 시도하세요. 로컬 네트워크와 비교하려면 Direct로 바꾸세요. 원래 모드를 기록해 두었다가 비교가 끝나면 복원하여 점검용 설정이 계속 남지 않게 하세요.

주의사항: 모드를 바꾼 뒤 새 연결을 만들어 확인하세요. 기존의 장시간 연결은 이전 상태를 유지할 수 있습니다. Proxy에서는 접속되지만 Config에서는 접속되지 않는다면 규칙, 정책, 관련 DNS 설정을 추가로 확인해야 합니다. 특정 규칙에 반드시 오류가 있다고 단정할 수는 없습니다. 어느 모드도 잘못된 서버 인증 정보를 복구하지는 못합니다.

Global Routing 모드 안내 보기 →
RULE ENGINE

규칙은 연결을 매칭하고
정책은 처리 대상을 결정합니다

무엇인가요: 규칙은 어떤 연결을 어떻게 처리할지 지정합니다. 일반적인 매칭 조건에는 도메인, 도메인 접미사, 도메인 키워드, IP 주소 범위가 있습니다. 정책은 PROXY, DIRECT, REJECT 또는 구성에 정의된 정책 이름을 가리킵니다. 규칙이 올바르게 매칭되어도 정책이 사용할 수 없는 대상을 가리키면 연결이 실패할 수 있습니다.

어디에 있나요: Config로 이동해 현재 선택된 구성을 확인한 다음, 그 안의 규칙을 살펴보거나 편집하세요. 구성 목록에 파일을 추가하는 것만으로 활성화되는 것은 아닙니다. Global Routing에서 Config 모드를 사용할 때는 실제 적용 중인 파일도 확인해야 합니다.

주요 매칭 조건

  • DOMAIN은 지정된 전체 도메인과 매칭되며, 범위가 분명한 단일 대상에 적합합니다.
  • DOMAIN-SUFFIX는 도메인 자체와 하위 도메인을 매칭하며, 도메인 전체 범위에 적용할 때 적합합니다.
  • DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭하므로 예상보다 넓은 범위에 적용될 수 있습니다.
  • IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 주소 범위를 지정합니다. GEOIP는 IP의 지리적 위치를 기준으로 매칭합니다.
  • FINAL은 앞선 규칙과 매칭되지 않은 연결을 처리하며, 일반적으로 규칙의 마지막에 둡니다.

설정 방법: 먼저 현재 구성을 백업한 다음, 더 구체적인 규칙을 범위가 넓은 규칙보다 앞에 배치하고 마지막에 FINAL을 설정하세요. 아래는 규칙 문법의 예시일 뿐입니다. example.com은 설명을 위한 가상 도메인이며 실제 트래픽 분기 설정을 추천하는 것이 아닙니다.

DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 예시에서는 전체 도메인 example.com이 첫 번째 규칙과 먼저 매칭됩니다. 하위 도메인은 두 번째 규칙과 매칭될 수 있으며, 앞선 규칙에 매칭되지 않은 연결은 FINAL로 전달됩니다. PROXY가 사용할 구체적인 대상은 현재 서버와 전체 구성을 함께 확인해야 합니다.

주의사항: 규칙은 대개 순서대로 확인되므로, 범위가 지나치게 넓은 조건을 앞에 두면 뒤에 있는 구체적인 조건이 적용되지 않을 수 있습니다. IP 규칙과 도메인 규칙은 서로 다른 정보를 기준으로 하며 DNS 결과도 판단에 영향을 줍니다. 문제가 생기면 연결 기록에서 대상과 매칭 결과를 먼저 확인한 뒤 관련 규칙을 수정하세요. 예외 규칙을 한꺼번에 많이 추가하는 것은 피하는 편이 좋습니다.

규칙 키워드와 정책 개념 보기 →
SUBSCRIBE / SERVER

기존 구독 가져오기
및 개별 서버 관리

무엇인가요: 구독은 서버 정보를 일괄 관리하는 데 사용하고, 개별 서버 항목에는 특정 연결 대상의 프로토콜, 주소, 포트, 인증 매개변수가 저장됩니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등은 프로토콜마다 필요한 필드가 다르므로 프로토콜 이름만 바꾸고 다른 매개변수를 그대로 사용해서는 안 됩니다.

어디에 있나요: Home에서 Add Server를 사용해 서버 항목을 추가하세요. 기존 구독은 해당 유형에서 Subscribe를 선택할 수 있습니다. 보유한 공유 정보는 Scan QR Code 또는 클립보드 가져오기 기능으로 처리할 수도 있습니다. 구체적인 메뉴 위치는 현재 화면을 기준으로 확인하세요. 이 모든 기능은 사용자가 이미 본인 소유의 구독 또는 서버 정보를 가지고 있음을 전제로 합니다.

설정 방법: 가져오기 전에 입력한 내용이 구독 링크인지, 개별 서버 공유 정보인지, 구성 파일인지 확인하세요. 구독 링크는 Subscribe에 해당하는 필드에 입력하고 저장 및 업데이트한 뒤 그룹에 서버가 표시되는지 확인합니다. 수동 입력 시에는 먼저 프로토콜을 선택한 다음 주소, 포트, 인증 정보와 프로토콜에 필요한 전송 및 TLS 매개변수를 하나씩 확인하세요. 마지막으로 Home에서 사용할 서버를 직접 선택합니다.

구독이 여러 개라면 알아보기 쉬운 이름을 사용해 구분하세요. 업데이트 전에 현재 선택된 항목을 기록하고, 업데이트 후에도 해당 항목이 남아 있고 선택되어 있는지 확인하세요. 원격에서 제공하는 내용이 바뀌면 항목이 추가되거나 삭제될 수 있으므로 구독 목록을 항상 고정된 로컬 목록으로 간주해서는 안 됩니다.

주의사항: 구독 업데이트는 목록을 다시 가져온다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다. Connectivity Test 결과도 다운로드 속도와 같지 않습니다. 테스트 조건, 프로토콜 핸드셰이크, 현재 네트워크가 모두 측정값에 영향을 줍니다. 그룹을 삭제하기 전에 복구에 필요한 정보를 확인하세요. 화면을 공유할 때는 전체 구독 주소와 인증 정보를 가리세요.

구독 및 서버 관리 매뉴얼 보기 →
ON DEMAND

네트워크 조건에 따라 연결 시작
트래픽 분기 규칙을 대체하지 않습니다

무엇인가요: On Demand는 설정한 조건에 따라 시스템 VPN 연결을 시작하거나 유지하는 기능입니다. 즉, “언제 연결을 설정할지”를 정합니다. 반면 Config의 규칙은 “연결이 설정된 뒤 요청을 어떻게 처리할지”를 정합니다. 두 설정을 각각 확인해야 합니다. On Demand를 켜도 서버 정보나 규칙 구성이 자동으로 생성되지는 않습니다.

어디에 있나요: Settings에서 On Demand 관련 설정을 찾아 현재 사용할 수 있는 네트워크 조건과 동작을 확인하세요. 연결을 처음 설정할 때 필요한 VPN 구성 권한은 시스템에서 확인합니다. 시스템 안내 팝업을 읽고 실제 필요에 따라 허용하세요.

설정 방법: 먼저 자동 연결 관련 설정을 끄고 수동으로 연결을 한 번 확인하세요. 서버, Global Routing, 구성이 정상적으로 작동하는지 확인한 뒤 On Demand를 켜고 화면에서 제공하는 옵션에 따라 네트워크 조건을 설정합니다. Wi-Fi 이름 조건을 추가했다면 이름이 정확한지 확인하고 해당 규칙이 어떤 동작을 실행하는지도 파악하세요.

주의사항: On Demand를 켜면 조건이 충족될 때 연결이 다시 설정될 수 있으므로, 수동으로 연결을 끊어도 계속 끊어진 상태로 유지되지 않을 수 있습니다. 자동 동작을 확인하려면 먼저 On Demand 조건을 점검한 다음 대상 네트워크를 한 번 바꾸어 결과를 확인하세요. 조건을 점검하는 대신 시스템 구성을 반복해서 삭제하지 마세요. 시스템에 VPN 표시가 있다고 해서 모든 요청이 프록시 서버를 통과하는 것은 아닙니다.

DATA / OBSERVATION

트래픽 통계와 연결 기록
실제 동작 확인에 활용

무엇인가요: Data는 앱에서 트래픽을 확인하는 항목으로, 연결 중 데이터 변화 파악에 도움을 줍니다. 통계는 앱에서 기록할 수 있는 범위를 나타내므로 서비스 제공자의 사용량 청구서나 네트워크 속도 테스트 결과와 동일시해서는 안 됩니다. 통계 기간과 초기화 방식, 원격 청구 기준은 서로 다를 수 있습니다.

어디에 있나요: 하단의 Data를 열어 현재 화면에서 제공하는 통계와 기록 항목을 확인하세요. 단일 요청을 분석하려면 앱의 연결 기록 기능도 함께 살펴보고 대상, 시간, 표시 가능한 정책 정보를 확인하세요. 조회할 수 있는 필드는 실제 화면을 기준으로 합니다.

설정 방법: 확인을 시작하기 전에 현재 수치와 시간을 기록한 다음, 대상이 분명한 곳에 접속하고 Data로 돌아와 변화를 살펴보세요. 비교를 새로 시작하려면 초기화 옵션의 적용 범위를 먼저 확인하고, 보관해야 할 정보를 저장한 뒤 실행하세요. 두 테스트를 비교할 때는 같은 네트워크, 대상, 조작을 사용해 백그라운드 활동의 영향을 줄이세요.

주의사항: 수치가 증가했다는 것은 데이터 전송이 있었다는 뜻일 뿐, 대상 서비스가 정상적으로 완료되었다는 증거는 아닙니다. 연결이 실패하더라도 DNS 조회, 핸드셰이크 또는 재시도로 트래픽이 발생할 수 있습니다. 기록을 확인할 때는 요청을 보낸 시간대를 기준으로 찾으세요. 공유 전에 도메인, 주소, 개인 활동과 관련된 정보를 가리고 민감한 기록 전체를 제출하지 마세요.

SETTINGS / DIAGNOSTICS

자주 쓰는 보조 설정
문제에 맞춰 하나씩 조정

아래 항목은 Settings 또는 현재 구성의 관련 메뉴에서 확인하세요. 설정 이름은 영어 원문 그대로 표기합니다. 메뉴 구성과 사용 가능한 기능은 현재 앱에 표시되는 내용을 기준으로 합니다.

DNS: 먼저 어느 설정 계층에서 처리되는지 확인

무엇이며 어디에 있나요: DNS는 도메인을 주소로 변환합니다. 관련 옵션은 Settings의 DNS 설정과 현재 Config의 DNS 필드에 있을 수 있습니다. 두 곳을 모두 확인해야 하며, 스위치 하나만 보고 실제 DNS 처리 경로를 단정해서는 안 됩니다.

설정 방법: 먼저 현재 값을 저장하고 시스템 DNS, 사용자 지정 DNS, DNS over HTTPS 중 어떤 방식을 사용하는지 확인하세요. 그런 다음 문제가 있는 항목 하나만 조정합니다. 같은 도메인으로 다시 테스트할 때는 캐시의 영향을 고려하고, 연결 기록을 참고해 DNS 조회와 접속 성공 여부를 각각 확인하세요.

주의사항: 암호화된 DNS를 사용한다고 해서 프록시 연결이 이루어지는 것은 아니며, DNS 조회가 성공해도 대상 포트에 연결할 수 있다는 뜻은 아닙니다. 서버 주소를 먼저 조회해야 할 수도 있어 부적절한 설정은 연결 의존성을 만들 수 있습니다. 명확한 장애 근거가 없다면 정상 작동 중인 설정을 유지하세요.

Test Method: 테스트 조건을 정할 뿐 실제 속도를 나타내지는 않습니다

무엇이며 어디에 있나요: Settings의 Test Method는 서버 테스트 방식을 선택하는 항목입니다. 이 설정은 Connectivity Test의 측정 방식과 결과가 어느 연결 단계에 가까운지에 영향을 줍니다.

설정 방법: 먼저 현재 방식에 대한 설명을 확인하고 선택한 뒤, 이미 보유한 같은 서버 그룹을 비교하세요. 화면에서 테스트 대상을 설정할 수 있다면 동일한 대상을 유지합니다. 방식을 바꾸면 다시 테스트하고, 서로 다른 방식에서 나온 수치를 섞어 순위를 매기지 마세요.

주의사항: 테스트 수치가 낮다고 실제 데이터 전송 속도가 계속 빠른 것은 아닙니다. 테스트 실패 시에는 대상에 연결할 수 없는 경우, 핸드셰이크 실패, 로컬 네트워크 문제를 구분해야 합니다. 실제 서비스에 연속으로 접속해 최종 동작을 확인하세요.

Today Widget: 시스템에서 빠르게 확인하는 기능

무엇이며 어디에 있나요: Today Widget 설정은 시스템에서 지원하는 빠른 확인 또는 조작 기능과 관련됩니다. Settings에서 해당 항목을 찾은 뒤, 시스템에서 위젯을 추가할 수 있는 위치에서 사용 가능한지 확인하세요.

설정 방법: 화면에서 제공하는 옵션에 따라 표시 내용이나 동작을 설정한 다음, 위젯을 추가하고 표시 상태가 앱 내부와 일치하는지 확인하세요. 시스템 지원 방식은 현재 기기와 앱에서 제공하는 기능을 기준으로 합니다.

주의사항: 빠른 실행 항목은 전체 설정 점검을 대신하지 않습니다. 표시 상태를 새로고침해야 할 수 있습니다. 연결 문제가 발생하면 위젯 표시만 보고 결론 내리지 말고 Home을 열어 서버와 Global Routing을 확인하세요.

iCloud: 동기화, 복원, 백업 구분하기

무엇이며 어디에 있나요: iCloud 관련 기능은 지원되는 범위에서 데이터를 저장하거나 동기화하는 데 사용됩니다. Settings에서 앱의 iCloud 항목을 확인하고 시스템에서 앱의 iCloud 사용을 허용했는지도 살펴보세요.

설정 방법: 기능을 켜기 전에 복원 가능한 자료를 별도로 저장하고 실제 동기화 대상 및 덮어쓰기 안내를 읽으세요. 기기를 바꾼 뒤에는 데이터 동기화가 완료되었는지 확인한 후 연결을 시작하세요. 서버 선택, 통계 기록, 모든 설정이 함께 이전된다고 가정하지 마세요.

주의사항: App Store의 구입 항목 복원은 앱 구매 내역을 되찾는 기능이며 앱 내부 구성을 복원하는 기능은 아닙니다. 동기화는 데이터 변경 사항을 전파하므로 별도 백업을 완전히 대체할 수 없습니다. 구독 주소와 인증 정보는 민감한 데이터이므로 개인 계정의 보안 기준에 따라 관리하세요.

Diagnostics: 먼저 문제 발생 단계를 찾고 필요한 기록을 보관

무엇이며 어디에 있나요: Diagnostics는 문제 해결을 돕는 기능이며 Settings의 관련 도구 영역에서 찾을 수 있습니다. 앱에서 제공하는 진단 정보를 수집하고 확인하는 데 사용되며, 서버 매개변수나 트래픽 분기 규칙을 자동으로 수정하지는 않습니다.

설정 방법: 진단을 실행하기 전에 문제가 발생한 시간, 현재 네트워크, Global Routing, 선택한 서버를 기록하세요. 그런 다음 문제와 관련된 진단을 실행합니다. 한 번 재현한 뒤 필요한 결과를 저장하고 정상 상황과 비교하세요. 설정을 계속 바꾼 다음 기록을 한꺼번에 많이 수집하지 마세요.

주의사항: 진단 정보에는 도메인, 주소, 구성 일부 또는 인증 정보가 포함될 수 있습니다. 다른 사람과 공유하기 전에 항목을 하나씩 확인하고 민감한 내용을 가리세요. 진단 결과가 나왔다고 해서 문제의 원인이 반드시 로컬 또는 원격에 있다고 단정할 수는 없습니다.

CHECK IN ORDER

설정 후 확인 순서

  1. 정보 확인. Home에서 선택한 서버와 프로토콜 필드를 확인하세요. 구독을 가져온 뒤에도 실제로 사용할 항목이 선택되어 있는지 확인해야 합니다.
  2. 모드 확인. Global Routing을 확인하세요. Config를 사용한다면 현재 구성과 관련 정책의 대상을 추가로 확인합니다.
  3. 수동 확인. 먼저 동작이 분명한 접속 테스트를 한 번 수행하고 Data 또는 연결 기록에서 해당 시간의 변화를 살펴보세요.
  4. 항목별 비교. 문제를 점검할 때는 모드, 서버, DNS 중 한 번에 하나만 변경하고 매번 새 연결을 시작하세요.
  5. 일상 설정 복원. 점검이 끝나면 원래 사용하려던 모드로 되돌린 다음 On Demand, 동기화, 빠른 실행 항목을 확인해 임시 설정이 남지 않도록 하세요.

처음 사용하는 경우 사용 안내에 따라 전체 과정을 진행하세요. 기존 구독을 여러 개 관리하려면 구독 매뉴얼의 각 항목을 확인하세요. 앱 구매, 기기 호환성 및 시스템 요구 사항은 App Store 페이지의 안내를 기준으로 합니다. 구매 전에 정품 확인 안내를 살펴볼 수 있습니다.

Shadowrocket 정품 다운로드