공식 가이드 · 설정 안내

Shadowrocket 설정
라우팅, 규칙 및 연결 점검

먼저 Global Routing과 현재 구성을 확인한 다음 DNS 또는 자동 연결을 조정하세요. 한 번에 한 항목만 변경하고 같은 대상으로 다시 테스트해야 규칙, 서버 또는 로컬 네트워크 중 어디에서 문제가 생겼는지 구분할 수 있습니다.

이 페이지는 iPhone / iPad 화면을 기준으로 안내합니다. 다른 플랫폼은 실제 화면에서 레이아웃과 사용 가능한 옵션을 확인하세요. Shadowrocket은 iPhone / iPad / Mac / Windows / Android / Linux 버전을 제공하며, Mac 버전은 Apple 실리콘과 Intel용으로 나뉩니다.

iPhone / iPad 버전은 App Store에서 $2.99를 한 번 결제하고 이용하며, Mac / Windows / Android / Linux 버전은 무료입니다. 앱 다운로드와 각 운영체제의 설치 및 실행 안내는 앱 다운로드 페이지를 확인하세요. 컴퓨터와 Android 등의 설치 파일은 모두 사이트의 /dl/shadowrocket/ 경로에서 제공합니다.

01 · 라우팅 설정

Global Routing: Config, Proxy, Direct

세 가지 모드는 트래픽의 경로를 결정합니다. 서버 설정을 대신하거나 사용할 수 없는 서비스를 자동으로 복구하지는 않습니다.

Home에서 Global Routing을 열고 Config, Proxy, Direct 중 하나를 선택할 수 있습니다. 일반적으로는 Config를 선택해 현재 구성 파일의 규칙에 따라 요청을 처리합니다. 모드를 선택한 뒤에는 Home에서 선택된 서버와 연결 스위치도 확인하세요. 모드 이름만으로 연결이 설정되었다고 볼 수는 없습니다.

화면 옵션주요 기능사용 상황확인할 항목
Config · 구성현재 구성의 규칙과 정책에 따라 요청을 처리합니다.도메인, 주소 및 기본 경로를 구분해 일상적으로 사용할 때 적합합니다.Config에서 올바른 파일을 선택했는지, 규칙 순서가 의도한 대로인지 확인합니다.
Proxy · 프록시Config의 일반적인 규칙별 라우팅을 따르지 않고 프록시 경로로 트래픽을 처리합니다.서버 경로가 작동하는지 임시로 확인할 때 사용합니다.현재 서버가 유효한지 확인하세요. 로컬 네트워크 리소스 이용에 영향이 있을 수 있습니다.
Direct · 직접 연결트래픽을 직접 연결 경로로 처리합니다.로컬 네트워크에서의 접속 상태를 임시로 비교할 때 사용합니다.Direct를 선택해도 연결 스위치가 꺼지는 것은 아니며, 네트워크 접속이 보장되는 것도 아닙니다.

설정 방법: 조건을 고정한 뒤 모드 전환

먼저 현재 모드와 서버를 기록하고 확인할 대상을 하나 정하세요. 같은 네트워크에서 Config로 테스트한 다음 잠시 Proxy로 전환해 비교합니다. Proxy에서는 접속되지만 Config에서는 안 된다면, 서버 정보를 다시 입력하기보다 규칙 일치 여부와 정책 참조를 먼저 확인하세요. 두 모드 모두 실패하면 서버 정보, DNS와 로컬 연결을 점검합니다.

Direct는 프록시 경로를 거치지 않을 때의 상태를 확인하는 데 유용하지만, 직접 연결이 한 번 성공했다고 모든 서비스가 정상이라는 뜻은 아닙니다. 대상마다 필요한 DNS 해석과 연결 조건이 다를 수 있습니다. 비교를 마친 뒤에는 Config 모드로 되돌리세요. 테스트 설정을 그대로 두면 로컬 네트워크 접속이나 일상적인 규칙 라우팅이 예상과 달라질 수 있습니다.

02 · Config

규칙 라우팅: 조건을 먼저 일치시킨 뒤 정책 적용

규칙 라우팅은 Config 모드에서 도메인, IP 주소 등의 조건에 따라 요청에 적용할 정책을 선택합니다. Config를 열어 현재 선택된 파일을 확인한 뒤 해당 파일의 규칙을 살펴보세요. 파일을 가져왔다고 해서 현재 사용 중인 것은 아닙니다. 다른 파일을 수정해도 현재 연결의 라우팅 결과는 바뀌지 않습니다.

규칙은 일반적으로 위에서 아래 순서로 확인하며, 먼저 일치하는 규칙이 요청을 처리합니다. 특정 도메인과 로컬 네트워크 주소는 적절한 위치에 두고, 범위가 넓은 조건은 뒤에 배치합니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 규칙이 존재한다는 이유만으로 적용된다고 판단하지 말고, 앞에 있는 조건이 먼저 일치하는지도 확인하세요.

키워드일치 대상설정 시 참고
DOMAIN지정한 전체 도메인입니다.호스트 이름 하나를 정확하게 제어할 때 적합합니다.
DOMAIN-SUFFIX지정한 도메인과 하위 도메인입니다.전체 웹 주소나 경로를 함께 입력하지 마세요.
DOMAIN-KEYWORD도메인에 포함된 키워드입니다.일치 범위가 넓으므로 의도하지 않은 대상도 포함되는지 확인하세요.
GEOIPIP 주소에 해당하는 지역 분류입니다.결과는 해석된 주소와 사용 데이터에 따라 달라집니다.
IP-CIDR / IP-CIDR6IPv4 / IPv6 주소 범위입니다.주소 유형과 접두사 길이를 확인하세요.
FINAL앞선 규칙에 일치하지 않은 요청입니다.규칙 끝에 두어 기본 경로를 지정합니다.

설정 방법: 명확한 규칙 몇 개로 검증

아래 예시는 문법과 순서만 보여 주며, 완전한 구성이나 연결 가능한 서버 정보를 포함하지 않습니다. PROXY는 프록시 처리를, DIRECT는 직접 연결을, REJECT는 일치한 요청의 거부를 지정합니다. 사용자 지정 정책 이름을 참조한다면 현재 구성에 해당 이름이 있는지 확인하세요. 예시의 이름만 복사해서는 안 됩니다.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

수정 전에 원본 파일을 저장하고, 수정 후에도 해당 파일이 선택되어 있는지 확인하세요. 필요한 경우 연결을 다시 설정한 뒤 대상에 접속하고 기록을 살펴봅니다. 브라우저가 기존 연결을 계속 사용할 수 있으므로 페이지를 새로고침하는 것만으로 새 규칙을 확인하지 못할 수도 있습니다. 규칙 일치 방식은 규칙 키워드의 일치 방식에서 자세히 확인하세요.

03 · Home / Add Server

구독 및 서버 관리

서버 항목에는 연결에 필요한 주소, 포트, 프로토콜 및 인증 정보가 저장됩니다. 구독은 서버 항목을 가져오고 업데이트하는 데 사용합니다. 이 안내는 사용자가 보유한 구독 또는 서버 정보를 전제로 합니다. 사이트에서는 노드나 구독 서비스를 제공, 판매 또는 추천하지 않습니다. 클라이언트의 일회성 구매 비용은 회선 요금제가 아닙니다.

Home에서 추가 항목을 눌러 Add Server로 이동합니다. 서버를 하나씩 추가할 때는 먼저 Type을 올바르게 선택하고 보유한 정보를 입력하세요. 구독을 가져오려면 Subscribe를 선택하고 기존 구독 주소를 입력한 뒤 저장합니다. 프로토콜마다 필요한 항목이 다르므로 VLESS의 필드를 Trojan이나 Shadowsocks에 그대로 적용할 수 없습니다.

구독 업데이트와 서버 전환은 서로 다른 작업입니다

구독을 업데이트하면 서버 목록을 다시 가져오지만 원하는 항목으로 자동 전환된다는 보장은 없습니다. 업데이트 후 Home으로 돌아가 현재 선택된 항목을 확인하세요. 특히 기존 항목이 삭제되거나 이름이 바뀐 경우 주의해야 합니다. 구독 주소를 Config의 파일 주소 입력란에 넣어서도 안 됩니다. 구독은 일반적으로 서버 목록을 제공하고, Config는 규칙과 구성 내용을 다루므로 각 출처의 안내에 따라 구분해 사용하세요.

구독을 삭제하기 전에 그 안의 항목을 계속 사용할지 확인하세요. 구독으로 생성된 항목의 매개변수를 직접 수정하면 이후 업데이트 때 변경 내용이 덮어써질 수 있습니다. 구독 주소, QR 코드 및 인증 필드에는 접속 정보가 포함될 수 있으므로 스크린샷을 찍거나 문제 해결 정보를 공유하기 전에 가리세요. 전체 가져오기 과정은 처음 사용 가이드를 따라 진행할 수 있습니다.

04 · 자동 연결

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

On Demand는 설정한 조건에 따라 VPN 연결을 시작합니다. 사용 가능한 서버를 대신 선택하거나 규칙의 일치 순서를 바꾸지는 않습니다. 앱의 On Demand 설정에서 사용할 수 있는 조건을 확인하세요. 메뉴 위치와 조건 항목은 시스템 및 앱 화면에 따라 달라질 수 있으므로 기기에 표시된 내용을 기준으로 합니다.

설정 방법: 수동 연결을 확인한 다음 활성화

먼저 자동 실행을 끄고 현재 서버와 Config로 수동 연결이 정상 작동하는지 확인하세요. 그런 다음 On Demand에서 필요한 네트워크 조건을 설정하고 기능을 활성화합니다. Wi-Fi 이름 조건을 제공하는 경우 네트워크 이름을 정확히 확인하세요. 네트워크 이름이 바뀌면 기존 조건도 다시 점검해야 하며, 기억에 의존해 계속 일치할 것이라고 판단해서는 안 됩니다.

검증하려면 조건에 맞는 네트워크와 맞지 않는 네트워크 사이를 전환하는 등 실제 네트워크 변화를 만들어 시스템 VPN 상태와 앱 연결 기록을 확인하세요. 설정 화면에서 스위치를 켜는 것만으로 조건이 제대로 적용되었다고 볼 수는 없습니다. 원인이 On Demand인지 판단할 수 있도록 테스트하는 동안 서버와 구성을 그대로 유지하세요.

다른 VPN 구성과 시스템 네트워크 상태도 자동 연결 결과에 영향을 줄 수 있습니다. 연결이 반복되면 먼저 On Demand를 비활성화하고 수동 연결을 안정적으로 설정한 다음 조건을 하나씩 다시 활성화하세요. 자동 연결이 네트워크의 지속적인 이용을 보장하지는 않습니다. 기기가 잠자기 상태에서 깨어나는 경우, 네트워크 전환 및 서버 상태 변화도 별도로 확인해야 합니다.

05 · 데이터 사용량 확인

Data: 트래픽 확인은 서비스 요금 확인과 다릅니다

Data에서는 앱에 기록된 트래픽 통계를 확인할 수 있습니다. Data를 열고 먼저 화면에 표시된 통계 범위, 시간 또는 연결 대상을 확인한 뒤 업로드와 다운로드 변화를 살펴보세요. 집계 기준이 서로 다른 통계는 직접 빼서 비교하기 어렵고, 앱 기록을 서비스 제공자의 청구 내역으로 볼 수도 없습니다.

사용 방법: 정해진 시간 동안 변화 관찰

특정 작업으로 트래픽이 발생했는지 확인하려면 먼저 현재 수치를 기록하고 다른 앱의 활동을 최대한 일정하게 유지한 채 분명한 요청을 한 번 실행하세요. 그런 다음 Data로 돌아와 변화를 확인합니다. 통계 초기화 기능이 있다면 초기화 전에 보관할 정보를 기록하세요. 클라이언트 통계를 초기화해도 서버 기록이 바뀌거나 서비스 데이터 한도가 복구되지는 않습니다.

트래픽이 있다는 것은 데이터가 전송되었다는 뜻일 뿐, 대상 콘텐츠가 정상적으로 로드되었다는 의미는 아닙니다. 증가량이 눈에 띄지 않아도 캐시, 기존 연결 또는 관찰 대상의 차이 때문일 수 있습니다. Data를 접속 기록, Global Routing 및 실제 결과와 함께 확인하세요. 트래픽이 비정상적으로 증가한다면 누적 수치만으로 특정 서버의 문제라고 판단하지 말고 백그라운드 앱 활동과 현재 네트워크부터 확인하세요.

06 · Settings

주요 설정: 한 번에 하나씩 변경

메뉴 위치는 현재 화면을 기준으로 확인하세요. 일부 옵션은 시스템 기능이나 현재 구성에 따라 달라집니다. 문제를 확인할 때는 서로 비슷한 스위치를 동시에 바꾸기보다 실제로 적용되는 위치부터 파악하세요.

DNS: 도메인이 주소로 변환되는 과정 확인

DNS는 도메인을 연결에 필요한 주소로 변환합니다. 먼저 Settings에서 DNS 관련 옵션을 확인한 다음 현재 Config에 dns-server 등의 설정이 있는지 살펴보세요. 한쪽만 바꾸고 다른 쪽을 놓치지 않도록 두 위치를 모두 확인해야 합니다. 기존 값을 기록한 뒤 네트워크와 구성에 맞게 조정하세요. 문제를 해결하려고 출처가 불분명한 주소를 여러 개 입력하지 마세요.

설정 후 같은 도메인으로 다시 테스트하고 기록을 참고해 DNS 해석 실패와 연결 실패를 구분하세요. IP 주소로는 접속되지만 도메인으로는 안 된다면 DNS 해석을 중점적으로 확인하되, TLS와 대상 서비스가 도메인에 의존하는지도 살펴봐야 합니다. 아래는 시스템 DNS를 사용하는 구성 문법 예시이며, 모든 네트워크에 권장되는 설정은 아닙니다.

[General]
dns-server = system

Test Method: Connectivity Test 방식 확인

Test Method는 연결 테스트 방식을 선택하는 항목입니다. Settings에서 설정을 확인한 뒤 Home으로 돌아가 Connectivity Test를 실행하세요. 방식마다 확인하는 네트워크 단계가 다르므로 방식을 바꾼 뒤의 결과를 이전 수치와 직접 비교해서는 안 됩니다. 테스트 대상을 설정할 수 있다면 응답이 정상적으로 확인되는 명확한 대상을 사용하세요.

테스트에 성공해도 모든 웹사이트에 접속할 수 있다는 뜻은 아니며, 실패했다고 인증 정보가 틀렸다고 단정할 수도 없습니다. 테스트 방식, 대상과 네트워크 조건을 기록한 뒤 실제 요청도 함께 확인하세요. 여러 대상을 테스트할 때는 결과가 완료될 때까지 기다려 연속 실행으로 결과가 뒤섞이지 않도록 합니다.

Today Widget: 빠른 확인 및 실행

Today Widget은 시스템에서 지원하는 경우 사용할 수 있는 빠른 실행 항목입니다. 먼저 Settings에서 관련 옵션을 확인한 뒤 시스템의 위젯 추가 절차에 따라 설정하세요. 표시되는 상태와 실행 가능한 작업은 현재 시스템과 앱이 제공하는 기능에 따라 다릅니다. 위젯에 표시된 오래된 상태를 실시간 연결 기록으로 간주하지 마세요.

처음 사용할 때는 먼저 앱을 열어 구성을 완료하고 필요한 권한을 허용한 다음 위젯을 테스트하세요. 위젯과 앱의 표시가 다르면 Home으로 돌아가 현재 연결을 확인한 후 시스템의 위젯 설정을 점검합니다. 서버 매개변수와 규칙 편집 및 진단은 앱에서 진행해야 합니다.

iCloud: 동기화 범위를 확인한 뒤 덮어쓰기 처리

Settings에서 iCloud 관련 메뉴를 확인하고 시스템에서 현재 Apple 계정과 앱의 iCloud 사용 권한도 살펴보세요. 동기화 전에 화면에 표시된 항목을 확인하세요. 서버 목록, 규칙 파일, 통계와 모든 환경설정이 동기화된다고 가정해서는 안 됩니다. 기기마다 사용할 수 있는 항목은 실제 화면에 표시된 내용을 기준으로 합니다.

다른 기기에서 처음 활성화하기 전에 현재 기기의 중요한 구성을 보관하세요. 내용이 일치하지 않으면 두 기기에서 동시에 편집하지 말고 어느 쪽을 유지할지 먼저 결정한 뒤 화면에 제공되는 기능으로 처리합니다. 동기화는 별도의 백업이 아니며 실수로 삭제한 내용이 다른 기기로 전파될 수도 있습니다. 인증 정보가 포함된 파일은 민감한 자료로 취급하세요.

07 · Diagnostics

진단 및 복구: 실패한 단계를 찾아 설정 점검

Diagnostics에서는 문제 해결에 필요한 정보를 수집하고 확인할 수 있습니다. Settings에서 관련 메뉴를 찾아 들어간 뒤 현재 화면에 제공되는 도구로 연결, DNS 해석 또는 요청 기록을 확인하세요. 진단 정보는 문제 범위를 좁히는 데 도움이 될 뿐입니다. 근거 없이 모든 실패를 DNS, 규칙 또는 서버 중 한 가지 문제로 단정해서는 안 됩니다.

확인 방법: 재현 가능한 절차를 간단히 유지

  1. 현재 상태 확인. 네트워크 유형, Global Routing, 선택된 서버와 Config 파일을 기록하고 현재 사용 중이 아닌 파일을 수정한 경우가 없는지 먼저 확인합니다.
  2. 대상 하나로 재현. 명확한 요청을 한 번만 실행하고 발생 시각을 기록합니다. 여러 앱에서 동시에 테스트하면 기록이 뒤섞일 수 있습니다.
  3. 실패 단계 파악. 먼저 주소를 얻었는지 확인한 뒤 연결과 인증이 진행되었는지 살펴보고, 마지막으로 규칙에서 선택한 정책이 예상과 일치하는지 확인합니다.
  4. 한 항목을 수정하고 재검사. 변경 전후 결과를 기록합니다. 개선되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 확인하고, 확실하지 않은 설정을 여러 개 겹쳐 바꾸지 마세요.

Proxy는 작동하지만 Config에서 작동하지 않는다면 규칙과 정책을 먼저 확인하세요. 네트워크를 바꾼 뒤 복구된다면 네트워크 조건과 DNS 해석을 중점적으로 비교합니다. 가져온 뒤 계속 연결에 실패한다면 원본 서버 정보를 다시 확인하세요. 이러한 증상은 점검 방향을 제시할 뿐이며, 최종 판단은 현재 요청 기록과 반복 테스트를 바탕으로 해야 합니다.

진단 내용을 공유하기 전에 서버 인증 필드, 구독 주소에 포함된 접속 정보, 개인 도메인 및 기타 민감한 정보를 가리세요. 접속 정보가 포함된 구성 파일 전체를 그대로 보내지 마세요. 복구할 때는 수정 전에 저장한 파일과 설정 기록을 우선 사용하고, Config, Global Routing 및 On Demand를 다시 확인한 뒤 실제 접속을 테스트합니다.

규칙을 수정했는데 결과가 그대로라면 어디부터 확인해야 하나요?

Global Routing이 Config인지 확인한 다음 Config에서 선택한 파일, 규칙 순서와 정책 이름을 점검하세요. 연결을 다시 설정하고 새 요청을 보내 기존 연결이 재사용되는 경우를 배제한 뒤 해당 기록을 확인합니다.

Data에 트래픽이 표시되는데 페이지가 열리지 않는 이유는 무엇인가요?

트래픽은 연결 시도, 다른 앱 또는 이미 설정된 연결에서 발생했을 수 있습니다. 누적 트래픽만으로 대상에 접속했는지 판단하지 말고 해당 요청의 DNS 해석, 정책과 연결 결과를 확인하세요.

연결을 끈 뒤 다시 자동으로 연결됩니다. 어떻게 중지하나요?

먼저 On Demand의 트리거 조건을 확인하고 비활성화한 뒤 연결을 끄세요. 이후 시스템 VPN 상태를 확인합니다. 자동 연결을 다시 사용하려면 조건을 하나씩 활성화하면서 동작을 점검하세요.

더 알아보기: 첫 설정은 가이드를 따라 진행하세요. 구매처, 개발자 및 구매 기록 확인은 정품 확인 안내를 참고하세요.