Shadowrocket 기능 및 주요 설정 안내

Global Routing은 전체 라우팅 모드를 선택하는 항목으로, 보통 Home에서 설정합니다. Config는 현재 적용 중인 구성 파일의 규칙을 사용하고, Proxy는 앱이 처리하는 연결을 선택한 서버로 보냅니다. Direct는 앱이 처리하는 연결을 대상에 직접 연결합니다. 시스템 트래픽, 제외 항목 및 기존 연결은 다르게 처리될 수 있으므로 모드 이름만으로 기기의 모든 연결 동작을 판단할 수는 없습니다.

대상별로 연결 방식을 나누려면 Config를 선택하세요. 특정 대상이 규칙에 따라 잘못된 정책을 사용하는지 확인할 때는 잠시 Proxy로 바꿔 비교할 수 있습니다. 로컬 네트워크에서 대상에 직접 접속할 수 있는지 확인하려면 Direct로 비교하세요. 모드를 바꾼 뒤에는 기존 연결 결과와 혼동하지 않도록 대상을 다시 열거나 요청을 새로 보내세요.

규칙 기반 라우팅은 연결을 서버로 보낼지, 직접 연결할지, 거부할지 결정합니다. Config에서 현재 활성화된 구성 파일을 확인한 다음 규칙을 살펴보거나 편집하세요. 파일을 가져오거나 저장하는 것만으로 활성화되지는 않습니다. 적용되지 않은 다른 파일을 편집해도 Home의 연결 동작은 바뀌지 않습니다.

일반적인 규칙은 유형, 매칭 내용, 정책으로 구성됩니다. DOMAIN은 전체 도메인을, DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인을, DOMAIN-KEYWORD는 도메인에 포함된 키워드를 매칭합니다. 정확한 제어가 필요하다면 범위가 명확한 도메인 규칙을 우선 사용하세요. 범위가 넓은 키워드는 관련 없는 대상까지 매칭할 수 있습니다.

IP-CIDR과 IP-CIDR6은 각각 해당 주소 범위를 매칭합니다. GEOIP는 IP 주소 위치 데이터베이스를 기준으로 판단하며, 웹사이트 콘텐츠나 사용자의 실제 위치를 식별하는 것은 아닙니다. 도메인을 먼저 해석하는지, 어떤 해석 결과를 사용하는지에 따라 IP 주소 규칙의 매칭 결과가 달라질 수 있습니다. 문제를 확인할 때는 규칙과 DNS 설정을 함께 점검하세요.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,ads-example,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

규칙을 조정할 때는 범위가 구체적인 예외를 넓은 규칙보다 앞에 두고, FINAL은 마지막에 기본 규칙으로 배치하세요. 앞선 규칙이 이미 일치하면 뒤에 있는 더 구체적인 규칙은 처리되지 않습니다. 한 번에 규칙 한 묶음만 변경하고 대상, 예상 정책, 실제 결과를 기록하세요. 서버, DNS, 규칙을 동시에 바꾸면 어떤 변경이 영향을 줬는지 파악하기 어렵습니다.

USER-AGENT처럼 요청 정보에 의존하는 규칙을 사용할 때는 현재 연결에서 해당 조건을 확인할 수 있는지도 점검하세요. 모든 트래픽에서 관련 필드를 읽을 수 있다고 가정해서는 안 됩니다. 규칙 우선순위와 기본 처리 방식은 사용자 지정 규칙 우선순위와 FINAL에서 자세히 확인할 수 있습니다.

보유한 서버 정보 추가

Home에서 Add Server를 눌러 항목을 추가하세요. 제공받은 정보를 기준으로 Type을 선택한 뒤 주소, 포트, 인증 및 전송 관련 항목을 입력합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등은 필요한 항목이 서로 다릅니다. 주소와 포트가 같다는 이유만으로 다른 Type에 같은 매개변수를 입력하지 마세요.

Scan QR Code로 가져올 때는 출처와 인식된 항목을 확인하세요. QR 코드는 매개변수를 전달하는 수단일 뿐, 내용이 검증되었다는 뜻은 아닙니다. 저장한 뒤 Home에서 원하는 항목을 선택하고 Connectivity Test를 실행한 다음 실제로 접속해 보세요. 테스트에 실패하면 입력 누락, 인증 정보, 서비스 유효성을 먼저 확인하고 규칙 문제로 바로 단정하지 마세요.

기존 구독 가져오기 및 업데이트

구독 링크를 보유한 경우 추가 메뉴에서 Subscribe를 선택하고 전체 주소를 붙여 넣어 저장하세요. 구독에는 민감한 인증 정보가 포함될 수 있으므로 스크린샷, 공개 문서, 채팅 기록에 노출되지 않도록 주의하세요. 복사한 내용 앞뒤에 공백이나 줄바꿈이 있거나 쿼리 매개변수가 누락되면 가져오기에 실패하거나 목록이 비어 있을 수 있습니다. 구독 주소는 일반 웹 주소와 겉모양이 비슷하더라도 서로 바꿔 사용할 수 없습니다.

서비스 제공자가 목록을 변경하면 해당 구독의 업데이트 기능으로 새 항목을 가져오세요. 목록 업데이트는 현재 Config를 교체하는 것이 아니며, 업데이트 전에 선택한 항목이 계속 남는다는 보장도 없습니다. 업데이트 후 그룹, 선택한 서버, 실제 연결 상태를 다시 확인하세요. 구독에서 생성된 항목을 직접 수정한 내용은 다음 업데이트에서 덮어써질 수 있으므로 중요한 매개변수는 별도의 안전한 방법으로 보관하세요.

삭제하기 전에 항목의 출처를 확인하세요

목록을 정리하기 전에 직접 추가한 항목과 구독 항목을 구분하세요. 구독 그룹을 삭제하면 그룹에 포함된 여러 서버 기록에 영향을 줄 수 있으며, 표시 이름만 바꿔도 연결 매개변수는 바뀌지 않을 수 있습니다. 구독을 교체하려면 새 목록이 정상적으로 작동하는지 먼저 확인한 뒤 기존 기록을 정리하세요. 복구 방법을 확인하지 않은 상태에서 모든 항목을 한꺼번에 삭제하지 마세요. 파싱 문제는 구독 파싱 실패 자가 점검 목록을 참고하세요.

On Demand는 설정한 네트워크 조건에 따라 시스템이 VPN 연결을 시작하도록 하는 기능입니다. Settings에서 On Demand 관련 설정을 찾아 현재 표시되는 항목에 맞게 조건을 구성하세요. Home의 수동 연결 스위치와 용도가 다릅니다. 수동 스위치는 현재 연결을 제어하고, On Demand는 조건이 다시 충족될 때 연결을 재시작할 수 있습니다.

설정하기 전에 수동 연결이 안정적으로 작동하는지 확인하고, 선택한 서버와 Global Routing이 예상대로 설정되어 있는지 점검하세요. 그런 다음 조건을 하나씩 추가해 조건 충족 및 해제, 잠금 화면 이후 복귀, 네트워크 전환 시 동작을 각각 확인하세요. 여러 조건을 한 번에 추가하면 한 조건이 다른 조건에 우선해 ‘연결을 껐는데 다시 연결됐다’고 오해하기 쉽습니다.

기기가 다시 연결되면 먼저 On Demand가 활성화된 상태인지 확인한 다음 시스템 VPN 설정과 다른 자동화 조건을 점검하세요. 자동 연결을 일시 중지하려면 Home 스위치만 반복해서 전환하지 말고 트리거 조건을 조정하세요. 트리거 시점은 시스템 환경에 따라 다를 수 있으므로 저장한 뒤 실제 네트워크를 전환해 확인해야 합니다.

Data에서 앱이 제공하는 트래픽 통계와 관련 기록을 확인할 수 있습니다. 업로드, 다운로드 또는 누적 수치를 해석하기 전에 표시된 통계 범위와 시간 기준을 확인하세요. 기록마다 현재 연결, 특정 항목 또는 일정 기간을 기준으로 할 수 있습니다. 기준이 다른 수치를 그대로 더하거나 한 화면의 수치를 기기 전체 네트워크 사용량과 동일하게 보지 마세요.

특정 작업에서 트래픽이 발생했는지 확인하려면 관찰 시작 시점의 수치를 기록하고, 대상만 따로 열어 전송이 끝날 때까지 기다린 뒤 Data에서 변화를 확인하세요. 백그라운드 동기화, 미디어 사전 로드, 앱 자체 요청도 동시에 트래픽을 발생시킬 수 있습니다. 짧은 시간의 증가는 범위를 좁히는 데 도움을 줄 뿐, 특정 도메인이 지정한 정책에 매칭되었다는 증거는 아닙니다.

서비스 제공자의 과금 기준에는 서로 다른 시간 범위, 프로토콜 오버헤드 또는 통계 방식이 포함될 수 있습니다. Data 수치와 서비스 제공자의 사용량이 다르면 양쪽 기준을 각각 확인하세요. 통계를 지우기 전에 필요한 기록을 보관하고 삭제 범위를 확인하세요. 로컬 기록을 초기화해도 원격 사용량이 바뀌지는 않습니다. 라우팅이 올바른지 확인하려면 총 트래픽만 보지 말고 대상 요청의 연결 정보와 현재 규칙을 함께 점검하세요.

DNS: 도메인 해석 경로 확인

DNS는 도메인을 연결에 사용할 주소로 변환합니다. Settings의 DNS 관련 설정을 확인할 때는 현재 Config에 DNS 매개변수가 포함되어 있는지도 살펴보세요. 한 화면만 변경했다고 실제 해석 경로가 바뀌었다고 단정할 수 없습니다. 기존 설정을 기록한 뒤 조정하고, 입력한 주소와 형식이 해당 옵션의 요구사항에 맞는지 확인하세요. DNS 요청이 어떤 경로로 전송되는지도 점검해야 합니다.

도메인 접속 실패, 주소 규칙의 예상 밖 매칭, 특정 리소스의 간헐적 로딩 실패가 발생하면 먼저 해석 결과를 확인해 실제 연결 주소와 비교하세요. 하나의 도메인이 여러 주소를 반환할 수 있고 캐시에 이전 결과가 남아 있을 수도 있습니다. 설정을 변경한 뒤 요청을 다시 보내고, 필요한 경우 앱에서 제공하는 관련 정리 기능을 사용하세요. 해석 주소를 바꾼 뒤 한 번 접속에 성공했다는 이유만으로 모든 연결 문제가 해결되었다고 판단하지 마세요.

Test Method: Connectivity Test의 의미 이해하기

Test Method는 연결 테스트 방식을 지정합니다. Settings의 테스트 관련 옵션에서 확인하세요. 테스트 방식에 따라 확인하는 단계가 다릅니다. 테스트 하나가 성공해도 인증, 대상 웹 페이지, 전체 데이터 전송이 모두 정상이라는 뜻은 아닙니다. 테스트 방식과 대상을 확인한 뒤 Home에서 선택한 서버의 Connectivity Test를 실행하세요.

서버 항목을 비교할 때는 테스트 방식, 대상, 로컬 네트워크를 동일하게 유지하고 가능한 한 비슷한 시간에 테스트하세요. 특정 항목의 테스트 결과가 나오지 않는 이유는 테스트 대상이나 방식에 있을 수도 있습니다. 필요한 실제 대상에 접속해 추가로 확인하세요. 한 번의 테스트 수치를 장기적인 안정성의 근거로 삼거나, 수치를 낮추기 위해 테스트와 무관한 설정을 반복해서 변경하지 마세요.

Today Widget: 빠른 확인 및 조작

Today Widget 설정은 해당 위젯에서 표시하거나 실행할 항목을 구성합니다. Settings에서 앱이 제공하는 옵션을 확인한 다음 시스템에서 지원하는 위젯 화면에 추가하세요. 표시 여부, 추가 방법, 실행할 수 있는 동작은 현재 시스템과 앱의 지원 여부에 따라 달라집니다. 특정 배치를 모든 기기의 고정 화면으로 간주하지 마세요.

위젯은 상태를 빠르게 확인하는 데 유용하지만 표시 내용이 갱신되기까지 시간이 걸릴 수 있습니다. 위젯에서 조작한 뒤 Home으로 돌아가 실제 연결 상태와 선택한 서버를 확인하세요. 위젯의 문구만으로 연결이 성공했다고 판단하지 마세요. 위젯 표시가 앱 내부와 다르면 앱에서 상태를 먼저 확인한 뒤 시스템의 위젯 갱신 여부와 지원 상태를 점검하세요.

iCloud: 동기화 후 실제 적용 내용 확인

iCloud 관련 기능은 조건을 충족하는 기기 간에 앱이 지원하는 데이터를 저장하거나 동기화합니다. Settings에서 관련 옵션을 확인하고 시스템에 로그인한 Apple 계정과 iCloud 권한을 점검하세요. 기능을 켜기 전에 앱의 동기화 범위 안내를 확인하세요. 모든 서버, 구성 파일, 통계, 시스템 VPN 상태가 함께 동기화된다고 가정해서는 안 됩니다.

여러 기기에서 사용할 때는 중요한 자료를 먼저 보관하고 동기화가 완료될 때까지 기다린 뒤 목록을 항목별로 확인하세요. 구성 파일이 동기화되어도 현재 파일로 선택되었는지, 관련 서버가 유효한지는 별도로 확인해야 합니다. 동기화를 별도의 백업으로 간주하지 마세요. 삭제나 수정 사항이 다른 기기에도 동기화될 수 있으며 연결 인증 정보도 주의해서 보관해야 합니다.

Diagnostics: 한 가지 실패 현상을 기준으로 단서 수집

Diagnostics에서는 앱이 제공하는 진단 정보를 보거나 관련 검사를 실행할 수 있습니다. Settings에서 해당 메뉴를 찾아 문제가 발생했을 당시의 네트워크, Global Routing, 선택한 서버, 조작 순서를 기록한 뒤 문제를 다시 재현하세요. 진단 항목마다 확인하는 내용이 다르므로 DNS 해석, 연결 수립, 이후 데이터 전송 중 무엇을 확인하는지 먼저 파악하세요.

결과를 읽을 때는 대상 주소와 실패 단계, 관련 설정을 함께 살펴보세요. 오류 문구 하나만 보고 여러 설정을 연달아 변경하지 마세요. 진단 내용을 저장하거나 다른 사람에게 전달할 때는 구독 주소, 인증 정보, 개인 접속 기록 등 민감한 내용을 먼저 삭제하세요. 진단은 문제 위치를 파악하는 도구이며 서비스 제공자 측 상태를 자동으로 수정하지 않습니다. 보유한 서비스 정보를 확인하는 절차를 대신할 수도 없습니다.