Shadowrocket 공식 설명서

Shadowrocket 프록시 모드와 주요 설정

연결이 켜져 있어도 모든 요청이 프록시를 통과하는 것은 아닙니다. 먼저 Home에서 Global Routing을 확인한 다음, 필요에 따라 규칙, 서버 또는 On Demand 조건을 점검하세요.

아래 내용은 iPhone / iPad 화면에 표시되는 메뉴명을 기준으로 합니다. 다른 플랫폼에서는 클라이언트에 실제로 표시되는 옵션과 메뉴를 확인하세요.

HOME / GLOBAL ROUTING

Global Routing의 주요 모드 3가지

평소 규칙에 따라 트래픽을 분류하려면 Config, 프록시 경로를 임시로 확인하려면 Proxy, 현재 네트워크에서 대상에 직접 연결할 수 있는지 확인하려면 Direct를 선택하세요. Home에서 Global Routing을 열고 원하는 모드를 선택한 뒤 Home으로 돌아와 모드와 연결 스위치를 확인합니다. 이 설정은 연결 경로를 바꾸는 것이며 서버를 변경하거나 연결 스위치를 끄는 것과는 다릅니다.

화면 옵션연결 처리 방식사용 상황
Config(구성)현재 구성의 규칙에 따라 일치하는 요청에 적용할 정책을 결정합니다.평소 트래픽 분류 또는 특정 도메인이 예상한 규칙에 일치하는지 확인할 때 사용합니다.
Proxy(프록시)클라이언트가 처리하는 연결을 프록시로 보내며, 규칙별로 직접 연결 여부를 결정하지 않습니다.서버를 바꾸지 않고 프록시 경로를 일시적으로 확인할 때 사용합니다.
Direct(직접 연결)클라이언트가 처리하는 연결을 프록시 서버를 거치지 않고 보냅니다.같은 대상을 이용해 현재 네트워크의 직접 연결 상태를 확인할 때 사용합니다.

문제를 확인할 때는 네트워크, 주소, 서버를 동일하게 유지하고 한 번에 모드 하나만 바꾼 뒤 새 요청을 보내세요. Proxy에서는 접속되지만 Config에서는 안 된다면 실제로 적용된 규칙부터 확인하세요. 특히 범위가 넓은 규칙과 기본 처리 정책을 살펴보세요. Direct와 Proxy 모두 실패한다면 모드 전환만으로는 원인을 특정할 수 없습니다. 네트워크, 도메인 해석 또는 대상 서비스도 확인해야 합니다. 테스트가 끝나면 평소 사용하던 모드로 되돌려 임시 설정이 남지 않도록 하세요.

CONFIG / RULE

규칙 라우팅: 일치 범위와 정책

규칙은 일치 조건과 처리 정책으로 구성됩니다. Home에서 Config 모드를 선택한 다음 Config에서 현재 활성화된 구성 파일을 확인하세요. 편집하기 전에 복구할 수 있도록 사본을 보관하고, 범위가 더 구체적인 조건을 넓은 조건보다 앞에 배치하세요. 규칙은 일반적으로 위에서부터 순서대로 적용됩니다. 앞선 규칙이 이미 일치하면 뒤에 있는 더 구체적인 규칙은 적용되지 않습니다.

주요 일치 유형

  • DOMAIN은 도메인 전체가 일치하는지 확인합니다. 단일 호스트를 지정할 때 사이트 전체로 범위를 넓힐 필요는 없습니다.
  • DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인을 일치시킵니다. DOMAIN-KEYWORD는 도메인에 포함된 문자열을 기준으로 하므로 예상보다 넓은 범위가 적용될 수 있습니다.
  • IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 일치시킵니다. GEOIP는 도메인 접미사가 아니라 대상 IP의 지리적 위치 데이터를 기준으로 일치 여부를 판단합니다.
  • FINAL은 규칙 맨 끝에 배치해 앞선 규칙에 일치하지 않은 연결을 처리합니다. 이 규칙을 수정하면 별도로 지정하지 않은 모든 대상에 영향을 줍니다.

정책과 규칙 순서 예시

PROXY는 일치하는 연결을 프록시 경로로 보내고, DIRECT는 연결을 직접 전송하며, REJECT는 일치하는 연결을 차단합니다. 아래 예시는 순서만 보여 주며 범용 설정은 아닙니다. 모두 example.com에 속하는 요청 중 개별 호스트로 지정한 요청은 첫째 줄에 먼저 일치하고, 나머지 접미사 조건에 해당하는 요청은 둘째 줄에 일치합니다.

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

한 페이지가 로그인, 이미지, API 등 서로 다른 도메인에 동시에 연결할 수 있습니다. 페이지 일부가 로드되지 않으면 먼저 실패한 요청을 확인한 뒤 해당 도메인이 앞선 규칙에 일치했는지 살펴보세요. 도메인 접미사 전체의 범위를 성급히 넓히지 마세요. 수정 사항을 저장한 뒤에는 실제로 편집한 구성이 활성화되어 있는지 확인하고 새 요청으로 다시 테스트하세요. 일치 범위에 대한 자세한 내용은 규칙 키워드 설명을 참고하세요.

HOME / SUBSCRIBE / ADD SERVER

구독 및 서버 관리

여러 서버를 하나의 구독으로 관리한다면 Subscribe를 사용하세요. 서버 연결 정보가 하나뿐이라면 Add Server에서 직접 입력할 수 있습니다. 구독 링크는 이용 중인 서비스 제공업체에서 받으세요. Home의 추가 메뉴에서 해당 방식을 선택해 가져온 뒤, 목록에 예상한 항목이 표시되는지 확인하고 사용할 서버를 선택하세요. 항목이 목록에 표시되더라도 가져오기만 완료된 것이며 서버를 사용할 수 있다는 뜻은 아닙니다.

직접 입력할 때는 먼저 보유한 정보에서 프로토콜 유형을 확인하고 주소, 포트, 해당 프로토콜에 필요한 인증 정보를 차례로 입력하세요. 프로토콜에 따라 표시되는 입력 항목이 다릅니다. 정보가 빠져 있다면 원본 연결 정보를 확인하고 다른 프로토콜의 값을 대신 입력하지 마세요. Scan QR Code로 기존 QR 코드를 가져온 경우에도 생성된 항목의 프로토콜과 이름을 확인하세요.

구독을 업데이트한 뒤 현재 선택한 항목이 목록에 남아 있는지 확인하고 Connectivity Test로 연결 가능 여부를 점검하세요. 직접 입력한 항목과 구독 항목은 구분하기 쉬운 이름을 붙여 두면 업데이트하거나 삭제할 때 대상을 확인하기 편합니다. 테스트 결과는 선택한 테스트 방식과 당시 네트워크 상태를 반영할 뿐입니다. 테스트에 성공해도 실제로 사용할 서비스를 열어 확인하세요. 구독 주소에는 접근 정보가 포함될 수 있으므로 문제를 확인할 때는 민감한 값을 제거한 정보만 공유하세요. 자세한 단계는 서버 관리 설명서를 참고하세요.

SETTINGS / ON DEMAND

On Demand 연결 조건

On Demand는 조건에 따라 연결을 자동으로 시작할 시점을 결정하고, Global Routing은 연결이 시작된 뒤 요청을 처리하는 방식을 결정합니다. Settings에서 On Demand 설정을 확인하세요. 활성화하기 전에 수동으로 한 번 연결해 시스템의 연결 권한, 서버, 현재 라우팅 구성이 정상 작동하는지 확인하세요. 그렇지 않으면 자동 연결 실패와 서버 자체의 접속 불가를 구분하기 어려울 수 있습니다.

먼저 Wi-Fi 또는 Cellular에 필요한 조건을 설정한 다음 현재 네트워크에서 다른 네트워크로 전환하고 Home에서 결과를 확인하세요. Wi-Fi 네트워크별 조건을 설정할 수 있다면 네트워크 이름을 입력한 뒤 해당 네트워크에서 직접 테스트하세요. 저장됐다는 이유만으로 조건이 적용됐다고 판단하지 마세요. 전환 전후의 연결 상태를 확인하고 새 요청을 보내세요. 이미 열려 있는 페이지의 캐시나 기존 연결로는 방금 전환이 조건을 실행했는지 확인할 수 없습니다.

수동으로 연결을 끊은 뒤 다시 연결된다면 현재 네트워크가 여전히 On Demand 조건을 충족하는지 먼저 확인하세요. 자동 재연결 없이 비교 테스트를 하려면 On Demand를 끈 다음 수동으로 연결을 끊으세요. 테스트가 끝나면 원래 설정을 복원하고 네트워크 전환도 한 번 확인하세요. 이렇게 하면 자동 실행과 수동 스위치 동작을 구분할 수 있습니다.

DATA / TRAFFIC

Data 트래픽 통계

Data에서는 업로드 및 다운로드의 누적량을 확인할 수 있습니다. 실시간 속도나 서비스 제공업체의 요금 청구 내역은 아닙니다. Data를 열고 먼저 현재 통계의 집계 기준을 확인하세요. 서버별 보기에서는 각 서버에 기록된 트래픽을 비교하고, 앱별 보기에서는 클라이언트가 각 앱에 귀속할 수 있는 트래픽을 비교합니다. 두 보기는 서로 다른 질문에 답하므로 각 항목이 모두 일대일로 대응할 필요는 없습니다.

특정 작업을 확인하려면 먼저 수치와 단위를 기록한 다음 대상 페이지 하나만 열어 작업을 수행하고 같은 화면으로 돌아와 증가량을 확인하세요. 통계를 지우기 전에 필요한 수치를 적어 두고, 초기화한 뒤에는 새로운 확인 시작점을 기록하세요. 캐시, 백그라운드 요청, 기존 연결 재사용은 증가량에 영향을 줄 수 있습니다. 서버별 수치가 눈에 띄게 늘지 않았다는 사실만으로 요청이 DIRECT로 전송됐다고 단정할 수는 없습니다. 특정 요청의 경로를 확인하려면 Global Routing과 이용 가능한 진단 기록을 함께 확인하세요. 항목별 집계 기준은 Data 트래픽 통계 설명을 참고하세요.

SETTINGS / CHECKLIST

Settings 주요 항목

DNS: 적용 위치 확인

DNS는 도메인을 연결에 필요한 주소로 변환합니다. Settings에서 DNS 관련 옵션을 확인하고 Config에서 현재 구성에 별도의 해석 방식이 지정되어 있는지 살펴보세요. 값을 바꿔야 한다면 기존 값을 기록하고 한 번에 한 항목만 변경한 뒤 같은 도메인으로 새 요청을 보내세요. 주소를 정상적으로 얻었다고 해서 대상에 연결된 것은 아닙니다. 문제가 계속되면 라우팅 정책과 서버도 확인하세요.

Test Method: 테스트 조건 통일

Test Method는 Connectivity Test에서 연결을 확인할 방식을 정합니다. Settings에서 Test Method를 찾아 테스트 방식을 선택한 다음 Home으로 돌아가 같은 서버를 다시 테스트하세요. 결과를 비교할 때는 네트워크와 테스트 방식을 가능한 한 동일하게 유지하세요. 테스트 방식이나 대상을 바꿨다면 두 수치만으로 서버 속도가 빨라졌는지 느려졌는지 판단하지 마세요.

Today Widget: 바로가기 확인

Today Widget은 시스템에서 지원하는 위젯 영역에 바로가기를 제공합니다. Settings에서 Today Widget 항목을 확인한 다음 시스템 안내에 따라 위젯을 추가하거나 관리하세요. 위젯을 조작한 뒤 Home으로 돌아와 Shadowrocket의 연결 스위치와 Global Routing을 확인하세요. 바로가기가 표시되는지만으로 특정 요청이 어떤 규칙에 일치했는지 알 수는 없습니다.

iCloud: 동기화 항목 확인

iCloud로 기기 간 동기화를 사용한다면 먼저 Settings에서 동기화 옵션과 현재 허용된 항목을 확인하고 두 기기에서 의도한 iCloud 계정을 사용 중인지 확인하세요. 동기화를 켜기 전에 필요한 로컬 사본을 보관하세요. 동기화한 뒤에는 구성 파일, 선택된 구성, 서버를 각각 확인하세요. 동기화 상태를 완전한 백업으로 간주하지 말고 연결 상태까지 구성이 함께 옮겨진다고 가정하지 마세요.

Diagnostics: 재현 가능한 문제 기록

Diagnostics는 문제 원인이 도메인 해석, 라우팅 또는 연결 중 어디에 있는지 확인하는 데 도움이 됩니다. Settings에서 Diagnostics로 확인할 수 있는 정보를 살펴보고 현재 네트워크, Global Routing, 사용 중인 서버, 오류가 발생한 시간을 기록한 뒤 문제를 다시 재현하세요. 해당 요청이 발생한 시간대의 기록을 우선 확인해 네트워크 전환 전의 오류를 현재 원인으로 오해하지 않도록 하세요. 다른 사람에게 전달하기 전 구독 링크, 인증 정보, 불필요한 접근 기록을 삭제하세요.

여러 설정을 동시에 켠 경우 문제를 확인할 때 먼저 수동 연결이 가능한 상태로 되돌린 다음 항목을 하나씩 복원하세요. 항목을 하나 복원할 때마다 같은 대상으로 확인해야 연결에 실제 영향을 준 변화를 구분할 수 있습니다. 처음 설정한다면 사용 안내의 순서대로 진행하세요.