공식 매뉴얼 · 기능 및 설정
Shadowrocket
주요 설정과 적용 조건
먼저 요청을 어떤 방식으로 처리할지 확인한 뒤 규칙, DNS, 연결 조건을 조정하세요. 한 번에 하나씩 변경하고 같은 요청으로 결과를 확인하세요.
이 페이지는 iPhone / iPad에서 흔히 볼 수 있는 화면을 기준으로 안내합니다. Mac, Windows, Android, Linux 버전도 Shadowrocket이지만 시스템마다 메뉴 위치와 사용 가능한 설정이 다를 수 있으므로 현재 화면에 표시되는 내용을 기준으로 확인하세요. 프록시 연결을 설정하려면 기존 구독이나 서버 정보가 필요합니다. 구성 파일만으로는 사용할 수 있는 연결 경로가 제공되지 않습니다.
iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매합니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료입니다. 다운로드 경로와 기기 안내는 전체 플랫폼 다운로드 페이지를 확인하세요.
01 / GLOBAL ROUTING
Global Routing: Config, Proxy, Direct
기능: Global Routing은 요청 전반에 적용할 처리 방식을 결정합니다. 도메인과 IP를 기준으로 일상적인 트래픽을 분기할 때는 보통 Config를 사용합니다. 규칙과 프록시 서버 중 어디에서 문제가 발생했는지 임시로 확인하려면 Proxy와 Direct를 각각 비교해 볼 수 있습니다. 세 옵션은 라우팅 모드를 바꾸는 것으로, 서버 비밀번호를 변경하거나 만료된 구독을 복구하지는 않습니다.
위치: Home에서 Global Routing을 찾아 열고 현재 선택된 항목을 확인하세요. 여기서는 Config / Proxy / Direct 세 가지 일반적인 모드를 설명합니다. 현재 화면에 Scene이 표시된다면 개별 장면에 맞춰 설정해야 하며, 이를 위 세 가지 중 하나로 간주하면 안 됩니다.
| 화면 옵션 | 처리 방식 | 사용 시점 | 먼저 확인할 항목 |
|---|---|---|---|
| Config(구성) | 현재 활성화된 구성의 규칙에 따라 정책을 결정합니다. | 일상적인 규칙 분기 및 사용자 지정 규칙 확인 | 활성화된 파일, 규칙 순서, 정책 참조 |
| Proxy(프록시) | 일반적으로 처리 가능한 요청을 현재 프록시 경로로 보냅니다. | 규칙 분기의 영향을 임시로 제외할 때 | 현재 선택된 서버와 서버 매개변수 |
| Direct(직접 연결) | 요청을 직접 연결 경로로 처리합니다. | 기본 네트워크 동작과 비교할 때 | 기본 네트워크 연결 여부와 DNS 상태 |
설정 방법: 먼저 현재 선택된 옵션을 기록한 다음 필요한 모드를 선택하고 Home으로 돌아가 연결 상태를 확인하세요. 같은 웹사이트나 앱에서 다시 시도하세요. 기존 연결 세션이 결과에 영향을 주지 않도록 필요하면 연결을 종료한 뒤 테스트하세요. Proxy에서는 연결되지만 Config에서는 안 된다면 서버 매개변수를 전부 다시 입력하기보다 규칙과 정책을 먼저 확인하세요.
주의: Direct를 선택해도 시스템의 VPN 구성이 해제되는 것은 아닙니다. Proxy를 선택했다고 모든 앱과 시스템 서비스가 반드시 같은 경로를 사용하는 것도 아닙니다. 테스트를 마친 뒤에는 원래 필요한 모드로 되돌리세요. 한 번 접속에 성공했다는 이유로 문제 해결용 설정을 계속 사용하지 마세요.
02 / RULE MATCHING
규칙 유형, 정책 및 매칭 순서
기능: 규칙은 매칭 조건과 실행할 정책으로 구성됩니다. DOMAIN은 도메인과 정확히 일치시키고, DOMAIN-SUFFIX는 도메인과 하위 도메인을 매칭하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭합니다. IP-CIDR과 IP-CIDR6은 IP 주소 대역을 매칭하고, GEOIP는 해당 지역의 IP 데이터에 의존합니다. USER-AGENT의 적용 여부는 요청에서 관련 필드를 가져올 수 있는지에 따라 달라집니다. 암호화된 모든 트래픽에서 해당 필드를 읽을 수 있는 것은 아닙니다.
위치: Config에서 현재 활성화된 파일을 확인한 다음 해당 파일의 규칙 편집 화면으로 이동하세요. Global Routing이 Config로 설정되어 있어야 규칙에 따라 트래픽이 분기됩니다. 규칙 텍스트만 보고 실제 결과를 판단할 수는 없습니다. 먼저 활성화된 파일을 확인하고, 그다음 파일 안의 내용을 살펴보세요.
[Rule]
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
설정 방법: 위에서부터 규칙을 확인하며, 처음으로 일치하는 규칙의 정책이 실행됩니다. PROXY는 프록시 경로로 전달, DIRECT는 직접 연결, REJECT는 요청 거부를 의미합니다. 아래 예시에서는 특정 하위 도메인을 먼저 거부한 다음 상위 도메인을 처리합니다. 두 줄의 순서를 바꾸면 범위가 더 넓은 도메인 규칙이 먼저 매칭될 수 있습니다. FINAL은 마지막에 두어 앞선 규칙과 일치하지 않은 요청에 기본 정책을 지정합니다. 예시 도메인은 문법 설명용입니다.
주의: 규칙의 정책은 구성 파일에 정의된 정책 그룹을 참조할 수도 있으므로 이름과 그룹에서 실제로 선택된 항목을 확인하세요. 도메인 매칭, DNS 확인, IP 매칭은 서로 다른 단계입니다. 최종 IP만 보고 도메인 규칙이 작동하지 않는다고 단정하지 마세요. 변경 전에는 원본 파일을 보관하고, 범위가 명확한 규칙 하나로 검증한 뒤 조금씩 적용 범위를 넓히세요. 자세한 예시는 규칙 순서 및 FINAL 설명을 참고하세요.
03 / SERVER MANAGEMENT
구독과 서버는 따로 관리
기능: 서버 항목에는 프로토콜, 주소, 포트, 인증 등 연결 정보가 저장됩니다. 구독은 서버 항목을 한꺼번에 가져오거나 새로 고치는 데 사용하고, Config의 구성 파일은 라우팅과 DNS 등의 동작을 정의합니다. 세 가지는 서로 관련되어 있지만 하나를 업데이트해도 나머지까지 업데이트되는 것은 아닙니다. 구독 업데이트에 성공했다는 것은 인식 가능한 내용을 가져왔다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 보장은 아닙니다.
위치: 기존 서버는 보통 Home 목록에서 확인하고 선택합니다. 직접 입력하려면 Add Server를 사용하고, QR 코드를 스캔하려면 Scan QR Code를 선택하세요. 기존 링크를 가져오기 전에 서버 구독인지 구성 파일인지 확인한 뒤, 현재 화면에서 용도에 맞는 메뉴를 사용하세요. Config의 Subscribe는 해당 구성 콘텐츠를 위한 기능이므로 용도가 다른 URL을 한곳에 섞어 입력하지 마세요.
설정 방법: 이미 이용 중인 서비스 제공자에게 받은 원본 정보를 사용하세요. 가져오기 전에 링크가 완전한지, 앞뒤에 공백이 없는지 확인하세요. 직접 입력할 때는 올바른 프로토콜을 선택한 다음 주소, 포트, 비밀번호나 식별자, 전송 방식, TLS 매개변수를 하나씩 확인하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 각각 필요한 매개변수가 다릅니다. 프로토콜 이름만 바꿔 같은 필드를 그대로 재사용하면 안 됩니다. 편집한 항목을 저장한 뒤 선택하여 테스트하세요.
주의: 구독을 새로 고치면 서버 항목이 다시 만들어질 수 있으며, 구독에서 내려받은 항목을 직접 수정한 내용은 다음 업데이트에서 덮어써질 수 있습니다. 일부 변경 사항을 유지해야 한다면 현재 버전에서 별도로 저장할 수 있는지 확인하고 변경 내용을 기록하세요. 구독 전체를 삭제하기 전에 소속 그룹을 확인해 다른 정보까지 실수로 지우지 않도록 하세요. 링크, QR 코드, 연결 로그에는 인증 정보가 포함될 수 있으므로 화면을 공유하거나 도움을 요청하기 전에 가리세요. 이 사이트는 서버 노드나 구독을 제공, 판매 또는 추천하지 않습니다.
04 / ON DEMAND
On Demand: 조건에 따라 연결 시작
기능: On Demand는 시스템의 주문형 연결 기능을 사용해 설정된 네트워크 조건에 따라 연결을 시작합니다. On Demand는 연결을 언제 시작할지 정하고, Global Routing은 연결 후 요청을 어떻게 처리할지 정합니다. 두 기능은 서로 대체할 수 없습니다. On Demand를 켜도 누락된 서버 매개변수가 자동으로 채워지거나 현재 사용할 수 없는 네트워크가 복구되지는 않습니다.
위치: Settings 또는 현재 버전에 표시되는 On Demand 설정 화면에서 조건을 확인하고 시스템에 저장된 VPN 구성을 살펴보세요. 설정 가능한 조건은 시스템과 현재 화면에 따라 다를 수 있으므로 다른 기기의 스크린샷에 나온 것과 똑같은 스위치가 있다고 가정하지 마세요.
설정 방법: 먼저 On Demand를 끄고 수동으로 연결해 기존 서버를 사용할 수 있는지 확인한 다음 주문형 연결을 켜세요. 설정 화면에 Wi-Fi, 셀룰러 네트워크 또는 네트워크 이름 조건이 있다면 한 가지 네트워크부터 설정하세요. 저장한 뒤 대상 네트워크로 전환해 시스템의 연결 상태와 실제 접속 결과를 확인하세요. 조건은 한 번에 하나씩 추가하고, 어떤 네트워크에서는 연결하고 어떤 네트워크에서는 연결하지 않아야 하는지 기록하세요.
주의: 연결을 수동으로 끈 뒤 자동으로 다시 연결된다면 주문형 조건이 다시 충족된 것일 수 있으며, 반드시 스위치가 고장 난 것은 아닙니다. 일시 중지하려면 먼저 On Demand를 끈 다음 연결을 끊으세요. VPN 구성이 여러 개 충돌하는지 확인할 때는 시스템에 주문형 규칙이 남아 있는지도 살펴보세요. 네트워크 전환, 잠자기, 연결 복구는 시스템 스케줄의 영향을 받으므로 주문형 기능이 연결을 계속 유지해 준다고 볼 수는 없습니다.
05 / DATA
Data: 트래픽 확인과 요금 판단은 별개
기능: Data에서는 클라이언트가 처리한 트래픽을 확인할 수 있습니다. 업로드, 다운로드, 누적 사용량, 현재 속도는 각각 다른 지표이므로 필드 이름과 집계 범위를 먼저 확인하세요. 클라이언트, 시스템 네트워크 통계, 서비스 제공자의 청구 내역은 측정 기준이 다를 수 있습니다. 한쪽의 숫자로 다른 쪽의 사용량을 바로 계산할 수는 없습니다.
위치: Data를 열어 현재 버전에서 제공하는 통계 항목을 확인하세요. 집계가 언제부터 시작되는지, 세션별인지 다른 범위로 누적되는지도 살펴보세요. 실제 셀룰러 데이터 사용량을 확인하려면 시스템 설정도 함께 확인해야 합니다. 이용 중인 서비스의 데이터 한도를 확인할 때는 해당 서비스의 기록을 기준으로 삼으세요.
설정 방법: 예상치 못한 데이터 사용량을 진단하기 전에 현재 수치, 연결 시간, 네트워크 유형을 기록하세요. 그런 다음 시스템 업데이트나 클라우드 동기화처럼 알려진 백그라운드 작업을 잠시 중지하고 같은 작업을 다시 실행해 비교하세요. 화면에 초기화 기능이 있다면 필요한 기록을 먼저 보관하세요. 두 번의 데이터를 비교할 때는 관찰 시간과 작업 내용을 비슷하게 유지하고 서로 다른 시간대의 결과를 한데 놓고 비교하지 마세요.
주의: 요청과 응답, 재전송, 연결 유지 과정 모두 트래픽에 영향을 줄 수 있습니다. Data에 트래픽이 표시된다고 대상 페이지가 완전히 로드된 것은 아니며, 속도가 낮다고 프로토콜 설정이 잘못된 것도 아닙니다. 트래픽 통계는 연결 지연 시간 테스트가 아닙니다. 연결 가능 여부는 Connectivity Test, 대상 요청, 로그를 함께 확인해야 합니다.
06 / SETTINGS
Settings 주요 항목의 조정 순서
Settings에는 DNS 확인, 테스트, 빠른 동작, 데이터 동기화 관련 항목이 있습니다. 변경하기 전에 전체 설정과 현재 Config 파일 내 설정을 구분하세요. 같은 항목이 두 곳에 있다면 실제 활성화된 구성과 로그를 함께 확인해야 합니다. 입력란에 예전 값이 남아 있다는 사실만으로 어떤 설정이 우선 적용되는지 판단할 수는 없습니다.
DNS: 먼저 이름 확인 문제부터 점검
기능 및 위치: DNS는 도메인 이름을 IP 주소로 변환합니다. 관련 옵션은 Settings와 Config의 DNS 설정에 있을 수 있습니다. 도메인으로 접속할 수 없지만 알려진 IP 주소로는 연결된다면 DNS를 확인해야 합니다. 다만 인증서, 대상 서비스, 규칙도 비슷한 문제를 일으킬 수 있습니다.
설정 및 주의: 먼저 현재 DNS 확인 방식을 기록하고, 현재 네트워크에 특정 로컬 DNS 서비스가 필요한지 확인한 뒤 실제 필요에 따라 조정하세요. 기업 내부망이나 로컬 네트워크의 이름은 해당 네트워크에서 제공하는 DNS에 의존할 수 있으므로 이를 바로 교체하면 작동하지 않을 수 있습니다. 암호화 DNS도 요청을 전달할 수 있는 경로가 필요합니다. DNS 요청 자체가 아직 연결되지 않은 프록시 경로에 의존한다면 연결 전에 필요한 조건이 충족되지 않는 문제가 생길 수 있습니다. 변경 후 요청을 다시 보내고 DNS 조회 기록과 대조하세요.
Test Method 및 Connectivity Test
기능 및 위치: Settings의 Test Method에서 현재 버전이 제공하는 테스트 방식을 선택한 다음 Home에서 서버의 Connectivity Test를 실행하세요. 테스트 방식마다 확인하는 단계가 다를 수 있습니다. 포트에 연결된다는 사실은 연결 경로의 일부만 확인한 것입니다. 대상 URL을 이용한 테스트에는 TLS, 대상 서버의 응답, 시간 제한 설정도 영향을 줄 수 있습니다.
설정 및 주의: 서버를 비교할 때는 테스트 방식, 대상, 현재 네트워크를 동일하게 유지하고 한 번의 결과만 보지 말고 여러 번 확인하세요. 테스트가 실패하면 해당 프로토콜에 맞는 방식인지 먼저 확인하세요. 특히 UDP에 의존하는 전송 방식은 테스트 방식의 호환성을 살펴봐야 합니다. 테스트에 성공해도 실제 서비스 사용을 대신할 수는 없습니다. 더 낮은 수치를 얻으려고 테스트 대상을 자주 바꾸면 결과를 서로 비교하기 어려워집니다.
Today Widget: 시스템 조건에 따른 빠른 실행
기능 및 위치: Today Widget은 시스템에서 지원하는 경우 빠른 상태 확인이나 조작에 사용할 수 있습니다. 관련 옵션은 Settings와 시스템의 위젯 추가 화면에 실제로 표시되는 내용을 기준으로 확인하세요. 별도의 프록시 구성은 아니며 Home에서 서버를 선택하는 기능을 대신하지 않습니다.
설정 및 주의: 먼저 앱에서 정상적으로 한 번 연결한 다음 시스템이 지원하는 위젯 위치에 추가해 동작을 확인하세요. 시스템에 위젯이 표시되지 않는다면 모든 기기나 시스템 버전에서 같은 메뉴를 사용할 수 있다고 가정하지 마세요. 위젯 업데이트는 백그라운드 작업 일정의 영향을 받을 수 있습니다. 상태가 일치하지 않으면 앱으로 돌아가 확인한 뒤 시스템의 VPN 상태도 살펴보세요. 여러 연결 메뉴를 연달아 빠르게 누르지 마세요.
iCloud: 동기화 전에 백업
기능 및 위치: Settings의 iCloud 관련 옵션은 현재 버전에서 지원하는 데이터 동기화 또는 가져오기에 사용됩니다. 동기화 범위는 화면의 설명을 기준으로 확인하세요. 서버, 구독, 로그, 모든 스위치 설정이 하나씩 전부 복사된다고 가정하면 안 됩니다.
설정 및 주의: 먼저 기기에서 의도한 iCloud 계정을 사용 중인지 확인하고 시스템에서 필요한 접근을 허용하세요. 처음 동기화를 켜거나 데이터를 병합·복원하기 전에 현재 사용할 수 있는 구성을 보관하세요. 한 기기에서 작업을 완료한 뒤 다른 기기를 확인해 동시에 편집하면서 발생하는 충돌을 방지하세요. 앱 구매에 사용한 계정과 iCloud 동기화 계정은 용도가 다릅니다. 구매 복원은 구성을 복원하는 기능이 아닙니다. 구성에는 인증 정보가 포함될 수 있으므로 민감한 데이터로 취급하세요.
07 / DIAGNOSTICS
Diagnostics 및 설정 복원
기능: Diagnostics에서는 현재 버전에서 제공하는 연결 진단 정보를 수집하고 확인할 수 있습니다. 로그는 DNS 확인, 연결, 인증, 규칙 매칭 중 문제가 발생한 지점을 찾는 데 도움이 됩니다. 하지만 오류 한 줄만으로 전체 문제를 설명하기는 어려우므로 오류가 발생한 시점과 당시 수행한 작업을 함께 확인해야 합니다.
위치: Settings의 Diagnostics 또는 현재 화면에 표시되는 진단 메뉴로 이동하세요. 임시 상세 기록 옵션이 있다면 문제를 재현할 때만 켜세요. 진단 항목은 시스템과 버전에 따라 다를 수 있습니다.
설정 방법: 먼저 Global Routing, 현재 서버, 활성화된 Config, 네트워크 유형을 기록한 뒤 필요한 진단 기록을 켜세요. 문제가 명확하게 재현되는 작업을 한 번만 수행하고 발생 순서를 기록한 다음, 해당 시간대의 정보를 확인하세요. 아래 순서대로 점검하고 앞 단계가 통과된 뒤 다음 항목을 조정하세요.
- 연결을 잠시 끊고 현재 Wi-Fi 또는 셀룰러 네트워크 자체가 작동하는지 확인하세요. 필요한 경우 먼저 네트워크 로그인을 완료하세요.
- On Demand의 자동 연결을 잠시 끄고 기존 서버 하나를 직접 선택한 뒤 프로토콜과 인증 매개변수를 확인하세요.
- Test Method를 동일하게 맞춰 Connectivity Test를 실행한 다음 실제 대상에 요청을 보내 접속 결과를 확인하세요.
- Proxy와 Config를 임시로 비교하세요. Config에서만 문제가 발생한다면 활성화된 파일, 규칙 순서, 정책 그룹을 확인하세요.
- DNS 단계의 문제로 보인다면 DNS를 확인하세요. TLS 판정에 영향을 주지 않도록 기기의 시스템 시간이 자동으로 설정되어 있는지도 확인하세요.
- 이번 변경으로 문제가 해결되지 않았다면 해당 변경을 되돌리고 원래 사용하던 Global Routing과 On Demand 조건을 복원하세요.
주의: 진단 정보에는 서버 주소, 구독 URL, 인증 정보, 접속한 도메인, 로컬 네트워크 정보가 포함될 수 있습니다. 내보내기 전에 항목을 하나씩 확인하고 문제 해결에 필요한 부분만 남긴 뒤 민감한 내용은 가리세요. 문제를 재현한 후에는 평소의 로그 수준으로 되돌려 불필요한 정보가 장시간 수집되지 않게 하세요. 백업 없이 모든 구성을 삭제하거나 앱을 다시 설치하지 마세요. 단서만 잃고 네트워크나 서버 문제는 해결되지 않을 수 있습니다.