공식 매뉴얼 · 기능 및 설정

Shadowrocket 프록시 모드
와 주요 설정

먼저 트래픽 경로를 정한 다음 연결 조건을 조정하세요. Global Routing부터 규칙, 서버, On Demand, 진단 기록 순으로 확인합니다.

이 페이지는 iPhone / iPad를 기준으로 합니다. 앱 화면에 따라 옵션 위치가 달라질 수 있으므로 현재 앱에 표시되는 내용을 확인하세요. 시스템 요구 사항은 App Store 페이지를 기준으로 합니다.

01 · 트래픽 경로

Global Routing: 세 가지 모드 비교

Global Routing은 연결이 클라이언트에 들어온 뒤 처리되는 방식을 정합니다. Home에서 Global Routing을 열고 Config, Proxy, Direct 중 하나를 선택하면 각각 구성 파일, 프록시, 직접 연결 방식으로 작동합니다. 이는 속도 설정이 아니며 서버 인증 정보를 보완해 주지도 않습니다. 모드를 바꾸기 전에 사용할 서버가 정상인지, 구성 파일이 선택되어 있는지 확인하세요.

화면 항목 / 모드 트래픽 처리 방식 사용 상황 설정 후 확인할 항목
Config
구성 파일
현재 구성 파일의 규칙과 정책에 따라 연결을 처리합니다. 도메인, IP 또는 기타 조건에 따라 연결 경로를 나눠야 할 때 사용합니다. 현재 구성 파일, 규칙 순서, 최종 정책 및 프록시 대상
Proxy
프록시
클라이언트가 처리하는 트래픽을 프록시 모드로 연결합니다. 기존 프록시 서버로 연결할 수 있는지 간단히 확인할 때 사용합니다. 선택한 서버와 실제 요청 결과를 확인하세요. 테스트 수치만으로 판단하지 마세요.
Direct
직접 연결
클라이언트가 처리하는 트래픽을 직접 연결로 처리합니다. 현재 네트워크에서의 결과와 비교해 문제가 프록시 경로와 관련 있는지 확인할 때 사용합니다. 로컬 네트워크와 DNS를 확인하세요. 직접 연결을 선택해도 시스템 연결 설정이 꺼지는 것은 아닙니다.

Config: 평소에는 규칙에 따라 처리

Config에서 사용할 구성 파일을 선택한 뒤 Global Routing으로 돌아가 Config를 선택하세요. 그런 다음 프록시를 사용할 것으로 예상되는 웹사이트와 직접 연결할 것으로 예상되는 웹사이트에 각각 접속하고, 연결 기록에서 실제 적용된 정책을 확인합니다. 구성 파일에서 정책 그룹을 참조한다면 그룹 안의 선택 항목도 확인하세요. 규칙이 올바르더라도 정책 대상이 작동하지 않으면 연결에 실패할 수 있습니다. 구성 파일 이름이 같아도 내용은 다를 수 있으므로 업데이트 후에는 주요 규칙을 다시 점검하세요.

Proxy / Direct: 경로 비교에 활용

특정 웹사이트의 문제를 확인할 때는 Proxy와 Direct를 번갈아 사용해 요청 결과를 비교할 수 있습니다. Proxy에서는 연결되지만 Config에서는 연결되지 않는다면 우선 규칙이 일치하는지와 정책이 올바른지 확인하세요. 두 모드 모두 실패한다면 서버 설정, 로컬 네트워크와 DNS를 점검합니다. 테스트할 때는 같은 주소와 비슷한 네트워크 조건을 유지하세요. 서버, DNS, 네트워크를 동시에 바꾸면 결과에 영향을 준 항목을 파악하기 어렵습니다.

02 · 매칭 조건과 정책

Rule: 규칙 분류

규칙 분류에서는 ‘어떤 트래픽인지’와 ‘어떻게 처리할지’를 따로 지정합니다. Config에서 현재 구성 파일의 규칙을 확인하거나 편집하고, 실제로 적용하려면 Global Routing을 Config로 설정하세요. 일반적으로 규칙은 위에서부터 순서대로 매칭되므로 구체적인 조건을 포괄적인 조건보다 앞에 두고 FINAL은 마지막에 배치해야 합니다. 수정 전에는 기존 구성 파일을 복사해 두고, 적은 수의 대상으로 먼저 검증한 뒤 규칙 범위를 넓히세요.

DOMAIN은 전체 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 접미사와 하위 도메인에 적용됩니다. DOMAIN-KEYWORD는 도메인에 포함된 키워드로 매칭하므로 일반적으로 범위가 더 넓습니다. IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 네트워크 대역을 지정하며, GEOIP는 IP의 지리 정보를 조건으로 사용합니다. USER-AGENT는 클라이언트가 해당 요청 정보를 가져올 수 있어야 하며, 모든 연결에 적용되는 앱 식별 조건으로 이해해서는 안 됩니다.

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

이 예시는 example.com과 그 하위 도메인을 먼저 매칭하고, 이어서 GEOIP 조건을 적용한 다음 나머지 연결을 FINAL로 처리하는 방식을 보여 줍니다. PROXY는 프록시 정책을 사용하고, DIRECT는 직접 연결하며, REJECT는 연결을 거부합니다. 문법을 설명하기 위한 예시일 뿐 모든 네트워크에 맞는 완성된 구성은 아닙니다. 실제 사용 시에는 기존 구성과 그 안에 정의된 정책을 기준으로 하세요.

규칙을 수정했는데 적용되지 않는다면 현재 활성화된 파일을 편집했는지 먼저 확인한 다음, 앞선 규칙이 이미 매칭되었는지 살펴보세요. 도메인 규칙은 사용할 수 있는 도메인 정보가 있어야 하며, IP 조건은 주소 조회 결과에 따라 달라질 수 있습니다. 같은 웹사이트에서도 페이지, 이미지 및 기타 리소스가 서로 다른 도메인에 연결될 수 있습니다. 페이지가 제대로 표시되는지만 보고 규칙 전체가 올바른지 판단하지 말고 연결 기록에서 개별 요청을 확인하세요.

프로토콜 및 매개변수 기술 참고 자료 보기 →
03 · 연결 정보

Subscribe와 서버 관리

서버 항목에는 연결에 필요한 주소, 포트, 프로토콜 및 인증 정보가 저장됩니다. Subscribe를 사용하면 사용자가 보유한 구독에서 서버 목록을 업데이트할 수 있습니다. 서버 항목과 Config의 역할은 다릅니다. 서버는 연결 대상을 제공하고, 구성 파일은 트래픽이 해당 대상을 사용하는 방식을 정합니다. 구독을 가져와도 규칙, DNS 또는 기타 설정이 자동으로 현재 설정에 반영되는 것은 아니므로 각각 확인해야 합니다.

Add Server: 보유한 정보를 항목별로 입력

Home의 서버 목록에서 추가 기능을 열어 Add Server로 이동하세요. 먼저 보유한 정보와 일치하는 프로토콜 유형을 선택하고 주소, 포트 및 인증 정보를 입력합니다. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard 등은 유형마다 입력 항목이 다르므로 저장을 위해 임의로 다른 유형을 선택하지 마세요. TLS, SNI, 전송 방식 및 경로 같은 추가 매개변수도 서버 측 정보와 일치해야 합니다. 확실하지 않은 항목은 기존 구성의 제공자가 안내한 내용을 확인하세요.

Subscribe: 업데이트 및 관리

Subscribe 메뉴에서 보유한 구독 주소를 추가한 뒤, 가져온 항목의 이름과 유형 및 업데이트 결과를 확인하세요. 구독 주소에는 보통 접속 인증 정보가 포함되어 있습니다. 전체 주소가 공개 스크린샷, 채팅 기록 또는 진단 자료에 노출되지 않도록 주의하세요. 업데이트에 실패하면 먼저 링크가 유효한지와 현재 네트워크에서 접속할 수 있는지 확인한 다음 오류 메시지를 살펴보세요. 같은 구독을 반복해서 새로 추가하면 항목이 중복되어 현재 선택한 항목을 알아보기 어려워질 수 있습니다.

구독으로 추가된 서버를 직접 수정하기 전에는 다음 업데이트 때 변경 사항이 덮어써지는지 확인하세요. 유지해야 하는 매개변수는 별도로 기록하고 직접 추가한 항목과 구독 항목을 구분해 두세요. 이전 구독을 삭제하기 전에는 구성 파일의 정책 참조도 확인해야 합니다. 삭제한 구독의 이름을 가리키는 항목이 남을 수 있습니다.

04 · 연결 트리거 조건

On Demand: 조건부 연결

On Demand는 시스템에서 지원하는 조건에 따라 연결을 시작합니다. 규칙 분류를 대신하거나 사용할 서버를 선택하는 기능은 아닙니다. Settings에서 On Demand를 찾아 현재 화면에 표시되는 네트워크 조건과 관련 동작을 확인하세요. 활성화하기 전에 수동으로 연결해 서버, Global Routing 및 구성 파일이 정상적으로 작동하는지 확인하면 자동 연결로 인해 기본 설정 문제가 가려지는 것을 방지할 수 있습니다.

설정하기 전에 목적을 명확히 하세요. 특정 Wi-Fi 환경에서 연결하려는지, 셀룰러 네트워크에서 다른 방식으로 연결하려는지 정합니다. 현재 화면에서 지원하는 조건만 조정하고, 저장 후 대상 네트워크별로 테스트해 네트워크 전환 후 실제 상태를 확인하세요. 네트워크 이름 조건이 정확한지 살펴보고, 이름이 비슷하다는 이유만으로 조건이 적용된다고 판단하지 마세요. 기존 시스템 연결 설정 간의 전환도 관찰 결과에 영향을 줄 수 있습니다.

On Demand를 켜면 조건이 충족될 때 수동으로 연결을 끊어도 다시 연결될 수 있습니다. 잠시 연결을 중지해야 한다면 스위치를 반복해서 끄는 대신 On Demand 설정도 함께 확인하세요. On Demand는 저전력 모드와 다릅니다. 배터리 사용량은 연결 빈도, 네트워크 신호, 프로토콜, 트래픽 양과 서버 상태에 따라 달라집니다. 먼저 시스템의 배터리 사용량을 확인하고 연결 기록에서 잦은 재연결이 있었는지 살펴보세요. 백그라운드에 표시된 시간만으로 판단하지 마세요.

05 · 사용량 확인

Data: 트래픽 통계

Data에서는 클라이언트가 기록한 트래픽 사용량을 확인할 수 있습니다. Data를 열고 통계 대상, 기간 및 초기화 기록이 있는지 먼저 살펴본 다음 업로드와 다운로드 항목을 확인하세요. 통계 화면에 따라 연결별 또는 누적 사용량이 표시될 수 있으므로 항목의 의미를 확인해야 합니다. 특정 연결의 사용량을 기기의 전체 네트워크 사용량으로 간주하지 마세요.

한 번의 작업에서 발생한 트래픽을 비교하려면 먼저 현재 수치와 시간을 기록한 뒤, 한 가지 작업을 수행하고 같은 기준으로 사용량 변화를 확인하세요. 화면에서 통계 초기화를 지원하더라도 이전 기록이 더는 필요하지 않은지 먼저 확인한 다음 초기화하세요. 초기화 전에는 민감한 정보가 포함되지 않도록 주의해 기록을 저장하면 전후 비교에 도움이 됩니다. 백그라운드 동기화, 미디어 로드 및 시스템 작업도 동시에 트래픽을 발생시킬 수 있으므로 사용량 증가를 방금 연 웹페이지 탓으로만 돌릴 수 없습니다.

클라이언트 통계, 시스템 셀룰러 데이터 통계 및 서버 측 사용량 계산은 범위가 서로 다를 수 있으며 연결 오버헤드와 통계 기간도 다를 수 있습니다. 따라서 수치가 완전히 일치하지 않을 수 있습니다. Data는 기존 서비스의 사용량 안내를 대신하지 않으며, 특정 규칙이 매칭되었는지를 직접 증명하지도 않습니다. 트래픽 경로는 개별 연결 기록으로, 배터리 사용량은 시스템의 배터리 화면으로 확인하는 등 문제에 맞는 근거를 따로 살펴보세요.

06 · 자주 사용하는 옵션

Settings: 변경 전 기록 보관

Settings에는 연결, 테스트, 화면 표시 및 진단 관련 옵션이 모여 있습니다. 일부 설정은 현재 Config의 영향을 받을 수도 있으므로 수정 전에 적용 범위와 현재 화면에서 해당 항목을 제공하는지 확인하세요. 한 번에 하나의 옵션만 변경하고 기존 값과 확인할 내용을 기록하는 것이 좋습니다. 이름이 문제와 관련 있어 보인다는 이유만으로 여러 매개변수를 한꺼번에 바꾸지 마세요.

DNS: 도메인 조회와 연결을 구분

DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. 먼저 Settings에서 DNS 관련 항목을 확인한 다음 현재 Config의 DNS 설정을 살펴보고 실제로 적용되는 설정이 어디에서 비롯되는지 파악하세요. 도메인으로는 접속되지 않지만 주소로 접속되는 경우 조회 기록과 연결 기록을 함께 살펴보세요. 곧바로 서버에 문제가 있다고 단정하지 마세요. 변경할 때는 기존 구성의 설계를 따르고 원래 값을 보관한 뒤 자주 쓰는 사이트와 로컬 네트워크 리소스로 검증하세요. 출처를 알 수 없는 주소를 DNS 설정에 임의로 입력하지 마세요.

Test Method: 테스트 항목 확인

Settings에서 Test Method를 찾아 현재 테스트 방식을 확인한 뒤 Home으로 돌아가 Connectivity Test를 실행하세요. 테스트 방식이 다르면 응답 결과를 직접 비교할 수 없습니다. 특정 테스트에서 응답이 없더라도 실제 서비스 요청까지 반드시 실패한다는 뜻은 아닙니다. 서버를 비교할 때는 테스트 방식과 네트워크 조건을 동일하게 유지하고, 테스트가 끝나면 대상 서비스에 실제로 접속해 보세요. 테스트 결과는 문제 범위를 좁히는 데 참고할 수 있지만 안정적인 속도나 지속적인 접속 가능성을 보장하지는 않습니다.

Today Widget: 빠른 조작 전 대상 확인

Today Widget은 시스템 위젯에서 빠른 정보 표시나 조작을 제공하며, 사용 가능한 기능은 시스템과 현재 앱 화면에 따라 다릅니다. Settings에서 관련 옵션을 확인한 다음 시스템의 위젯 관리 화면에서 추가할 수 있는지 살펴보세요. 빠른 실행을 사용하기 전에 앱에서 서버와 모드를 선택해 두세요. 위젯에서 전환하더라도 구성이 올바른지 자동으로 확인하지는 않습니다. 위젯의 상태가 앱 안에서 확인한 내용과 다르면 Home으로 돌아가 실제 연결 상태를 살펴보고 위젯 표시만으로 판단하지 마세요.

iCloud: 동기화는 별도 백업이 아닙니다

Settings에서 iCloud 관련 동기화 옵션을 확인하고 시스템 설정에서 해당 앱의 iCloud 사용 권한도 살펴보세요. 먼저 동기화할 데이터 종류를 확인한 뒤 다른 기기에서 결과를 확인합니다. 모든 설정, 구독 및 기록이 동기화된다고 가정하지 마세요. 여러 기기에서 동시에 편집하기 전에 중요한 구성을 보관하고 동기화가 완료된 다음 작업을 계속하세요. 변경이나 삭제 내용도 동기화될 수 있으므로 iCloud 동기화를 유일한 백업으로 삼지 마세요. 인증 정보가 포함된 구성은 민감한 자료로 취급해 보관해야 합니다.

Diagnostics: 상황을 기록한 뒤 문제 해결

Settings에서 Diagnostics 관련 메뉴를 열고 현재 화면에서 제공하는 도구로 진단 정보를 확인하세요. 문제가 발생한 시간, 네트워크 유형, Global Routing, 사용한 서버 유형과 재현 절차를 기록한 뒤 오류 메시지와 함께 발생 지점을 좁혀 보세요. 진단 정보를 공유하기 전에 구독 주소, 인증 항목, 개인 도메인 및 불필요한 접속 기록을 가리세요. 로그를 보충하려고 전체 구성을 공개하지 말고, 근거 없이 인증서 확인 등의 보안 검사를 끄지 마세요.

07 · 확인 순서

설정 변경 후 결과 확인하기

  1. 로컬 네트워크를 확인합니다. 현재 Wi-Fi 또는 셀룰러 네트워크를 정상적으로 사용할 수 있는지 살펴보고 필요한 경우 네트워크 로그인을 완료하세요. 테스트 대상을 하나 정해 한 번의 확인에 여러 문제를 섞지 마세요.
  2. 연결 정보를 확인합니다. 선택한 서버, 프로토콜 유형 및 인증 매개변수를 점검하세요. 구독 업데이트가 성공했다는 것은 목록을 가져왔다는 뜻일 뿐, 모든 서버에 정상적으로 연결된다는 의미는 아닙니다.
  3. Global Routing을 확인합니다. 규칙에 따라 트래픽을 분류하려면 Config를 선택하고 현재 파일과 정책 대상을 확인하세요. Proxy / Direct로 비교한 뒤에는 원래 사용하려던 모드로 되돌리세요.
  4. 기록과 연결 조건을 확인합니다. 문제가 발생한 시간과 연결 기록을 대조하세요. 필요하다면 On Demand의 자동 연결을 잠시 중지한 뒤 다시 테스트해 자동 재연결과 수동 조작의 영향을 구분하세요.
  5. 효과가 확인된 변경만 유지합니다. 설정을 바꿀 때마다 같은 작업을 반복해 확인하세요. 결과가 나아지지 않으면 원래 설정으로 되돌린 다음 다음 항목을 살펴보세요. 원인을 알 수 없는 설정 변경이 쌓이지 않도록 합니다.

처음 설정하는 경우 전체 가이드에 따라 가져오기, 모드 선택, 연결 및 확인을 순서대로 진행하세요. 익숙하지 않은 화면 항목은 먼저 용어집에서 확인한 다음 조정 여부를 결정할 수 있습니다. 각 변경의 이유와 결과를 확인하고 필요하면 되돌릴 수 있도록 설정하세요.