공식 가이드 / Routing & Settings

Shadowrocket 프록시 모드와 설정

목적지에 따라 트래픽을 분기하려면 Config를 선택하세요. 서버를 임시로 확인하거나 현재 네트워크와 비교할 때는 Proxy와 Direct를 각각 사용하세요.

아래 설명은 iPhone / iPad 인터페이스를 기준으로 합니다. Global Routing은 요청 처리 방식을, On Demand는 연결을 시작할 시점을 결정합니다. 두 설정을 각각 확인해야 합니다.

01모드

Global Routing: Config, Proxy, Direct

Home에서 Global Routing을 열고 확인하려는 목적에 맞는 모드를 선택한 다음, Home으로 돌아가 연결 상태를 확인하세요. Config를 선택하기 전에 Config에서 사용 중인 설정 파일을 확인하고, Proxy를 선택하기 전에 Home에서 현재 선택된 서버를 확인하세요. 모드를 전환해도 설정 파일이 바뀌거나 서버 매개변수가 수정되지는 않습니다.

인터페이스 옵션처리 방식사용 상황먼저 확인할 항목
Config(설정)현재 설정 파일의 규칙에 따라 처리 정책을 결정합니다.일상적인 사용에서 요청 일부는 프록시로, 나머지는 직접 연결할 때설정이 적용됐는지, 규칙 순서와 기본 처리 정책은 올바른지 확인합니다.
Proxy(프록시)클라이언트가 처리할 요청을 프록시 경로로 전달합니다.같은 목적지에 프록시로 접속할 수 있는지 임시로 확인할 때현재 선택된 서버와 서버 매개변수가 올바른지 확인합니다.
Direct(직접 연결)요청을 프록시 서버를 거치지 않고 전달합니다.기본 네트워크의 연결 가능 여부를 비교하거나 로컬 서비스를 임시로 확인할 때시스템 네트워크가 정상인지 확인하세요. Direct는 연결 스위치를 끄는 것과 다릅니다.

문제를 확인할 때는 같은 네트워크와 테스트 주소를 유지하고, 모드를 바꿀 때마다 새 요청을 보내세요. Proxy에서는 접속되지만 Config에서는 접속되지 않는다면 예상치 못한 규칙에 매칭됐는지, Config가 다른 정책이나 서버를 사용하는지 먼저 확인하세요. Direct에서도 실패하면 현재 네트워크에 로그인 포털이 필요한지 확인한 다음 대상 서비스에 접속할 수 있는지 살펴보세요. 테스트를 마치면 일상적으로 사용하는 모드로 되돌려 임시 설정이 계속 적용되지 않도록 하세요.

02규칙

규칙 분기: 조건에 매칭한 뒤 정책 적용

규칙에는 요청의 특성과 처리 정책이 함께 지정됩니다. Config에서 현재 사용하는 설정 파일을 열고 규칙 섹션과 순서를 확인한 다음, Home으로 돌아가 Global Routing을 Config로 설정하세요. 더 넓은 조건의 규칙이 앞에 있으면 요청이 먼저 매칭되어 뒤쪽의 구체적인 예외 규칙이 적용되지 않을 수 있습니다. 예외 규칙을 추가할 때는 이를 덮어쓰는 규칙을 찾아 그 앞에 배치하세요.

요청 특성에 따라 규칙 유형 선택

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
전체 도메인, 도메인 접미사, 도메인에 포함된 키워드에 각각 매칭합니다. 특정 호스트 하나만 처리하려면 DOMAIN을 우선 사용하고, 기본 도메인과 하위 도메인을 모두 포함하려면 DOMAIN-SUFFIX를 사용하세요. 키워드는 관련 없는 도메인에도 매칭될 수 있으므로 수정한 뒤 적용 범위를 확인하세요.
IP-CIDR / IP-CIDR6 / GEOIP
앞의 두 항목은 각각 IPv4 및 IPv6 주소 범위에 매칭되고, GEOIP는 대상 IP의 위치 정보를 기준으로 매칭됩니다. 도메인이 여러 주소로 해석되면 실제 주소에 따라 매칭 결과가 달라질 수 있습니다. GEOIP는 IP의 위치 정보를 판단하는 기능이지, 도메인 접미사나 웹사이트 운영자의 소재지를 기준으로 하지 않습니다.
USER-AGENT / FINAL
USER-AGENT는 클라이언트가 해당 요청 필드를 가져올 수 있을 때만 사용할 수 있으며, 일반적인 앱 식별 조건으로 쓸 수 없습니다. FINAL은 앞선 규칙에 매칭되지 않은 요청의 기본 정책을 지정하므로 규칙 목록 마지막에 배치해야 합니다.

PROXY, DIRECT, REJECT를 각각 테스트

PROXY는 프록시를 통해 전달하고, DIRECT는 직접 접속하며, REJECT는 매칭된 요청을 거부합니다. 예를 들면 다음과 같습니다.

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

첫 번째 규칙은 특정 호스트 하나에 직접 연결을 적용하고, 두 번째 규칙은 나머지 해당 접미사의 요청을 처리하며, 세 번째 규칙은 매칭되지 않은 요청을 처리합니다. 도메인은 예시일 뿐이며, 그대로 복사해도 실제 서비스에 맞는 규칙이 만들어지는 것은 아닙니다. 테스트할 때 예외 대상 하나와 접미사 규칙에 매칭되어야 하는 대상 하나를 골라 새 요청을 보낸 뒤, 확인 가능한 연결 기록을 살펴보세요. 첫 번째 대상이 예상과 달리 프록시를 거친다면 도메인이 정확히 일치하는지, 규칙 순서와 실제로 활성화된 설정이 올바른지 확인하세요.

03서버

구독 가져오기와 서버 관리

기존 서비스 제공업체의 구독 URL이 있다면 Home에서 Add Server를 열고 Subscribe를 선택한 뒤 해당 URL을 입력하세요. 저장 후 Home에서 가져온 항목을 확인하고 이번에 테스트할 서버를 직접 선택하세요. 목록에 추가됐다고 해서 모든 서버에 연결할 수 있다는 뜻은 아닙니다. 업데이트 후 항목 이름이나 개수가 바뀌었다면 현재 선택을 다시 확인하세요. 특히 기존에 사용하던 항목이 삭제되지 않았는지 살펴보세요.

서버 매개변수만 알고 있다면 Add Server에서 서비스 제공업체가 안내한 프로토콜을 선택한 뒤, 화면에 따라 주소와 포트 및 해당 프로토콜에 필요한 인증 정보를 입력하세요. QR 코드가 있다면 Scan QR Code로 가져올 수 있습니다. 저장하기 전에 가져온 프로토콜과 주소도 확인하세요. 두 자료의 주소와 포트가 같더라도 서로 다른 프로토콜의 입력 항목을 바꿔 쓸 수는 없습니다. 각 항목의 차이는 프로토콜 기술 참고를 확인하세요.

구독을 불러오지 못하면 먼저 전체 URL을 복사했는지 확인하고, 기존 서비스 제공업체에 아직 유효한 주소인지 문의하세요. 목록은 불러왔지만 연결되지 않는다면 현재 선택된 항목과 프로토콜 정보를 확인하세요. 두 문제를 혼동해 항목을 반복해서 삭제하고 다시 가져오지 마세요. 문제를 문의할 때는 구독 URL의 접근 매개변수를 삭제하고 비밀번호와 키를 가리세요. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다.

04연결

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

On Demand를 사용하면 설정 조건에 맞을 때 시스템이 연결을 시도하므로 네트워크를 전환할 때 수동 조작을 줄일 수 있습니다. 먼저 Home에서 수동 연결이 정상인지 확인한 다음 Settings에서 On Demand를 열고, 화면에 표시되는 조건 중 연결을 시작할 네트워크를 선택하세요. 설정 후 Wi-Fi와 셀룰러 네트워크를 한 번씩 전환하면서 연결이 필요한 상황에 연결되는지, 연결이 시작되지 않아야 하는 상황에는 예상한 상태를 유지하는지 확인하세요.

On Demand는 요청이 어떤 경로를 거칠지 결정하지 않습니다. 연결이 시작된 뒤에는 Global Routing과 적용 가능한 설정 규칙이 트래픽을 처리합니다. 수동으로 연결을 끊은 뒤 네트워크를 바꾸자마자 다시 연결된다면 On Demand가 활성화된 상태인지, 조건에 해당 네트워크가 포함되는지 확인하세요. 연결이 자주 끊겼다 다시 시작되는 문제를 살펴볼 때는 On Demand를 잠시 끄고 고정된 네트워크에서 수동 연결을 테스트한 다음 필요한 조건을 복원하세요. 이렇게 하면 서버 연결 문제와 네트워크 전환 조건 문제를 구분할 수 있습니다.

05통계

Data: 트래픽 및 통계 범위 확인

Data에서 클라이언트가 기록한 트래픽을 확인할 수 있습니다. 특정 작업으로 트래픽이 발생했는지 판단하려면 먼저 현재 표시된 통계 기간과 업로드·다운로드 수치를 확인하세요. 시작값을 기록한 뒤 명확한 작업을 한 번 수행하고 다시 확인해 변화를 비교하세요. 추가로 확인할 때는 기기를 같은 네트워크에 연결하고 동기화, 다운로드, 연결 테스트 등 다른 활동을 줄이세요. 그래야 다른 작업의 트래픽이 관찰 결과에 섞이지 않습니다.

Data에는 클라이언트가 기록한 수치가 표시됩니다. 시스템의 모바일 데이터 요금 내역이나 서비스 제공업체의 최종 사용량은 아닙니다. 통계 시작 시점, 포함되는 연결 범위, 전송 오버헤드가 다를 수 있으므로 두 곳의 누적 수치를 단순히 빼서 누락 여부를 판단하지 마세요. 특정 도메인이 프록시를 거치는지 확인하려면 현재 모드와 규칙, 진단 기록을 함께 살펴보세요. 업로드·다운로드 총량만으로는 개별 요청에 적용된 정책을 알 수 없습니다.

06설정

Settings: DNS, 테스트, 동기화와 진단

DNS: 적용 중인 이름 해석 설정 확인

DNS는 도메인을 IP 주소로 변환합니다. Settings에서 DNS 관련 옵션을 확인하고, Config를 사용하는 경우 현재 설정 파일에 DNS 설정이 지정되어 있는지도 살펴보세요. 도메인이 해석되지 않으면 기존 값을 먼저 기록한 뒤 네트워크나 서비스 제공업체의 안내에 따라 한 항목씩 바꾸고 같은 도메인을 다시 테스트하세요. 로컬 네트워크의 내부 이름이 작동하지 않는다면 현재 DNS 서버가 해당 이름을 알고 있는지 확인하세요. 주소가 해석됐다고 대상 포트에 연결할 수 있는 것은 아니므로 연결 가능 여부는 별도로 테스트해야 합니다.

Test Method: 테스트 조건 통일

Settings에서 Test Method를 확인하고 테스트 방식을 선택한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 같은 서버의 전후 결과를 비교할 때는 테스트 방식과 네트워크, 테스트 대상을 동일하게 유지하세요. 화면에서 테스트 주소를 편집할 수 있다면 정상적으로 접속할 수 있고 테스트에 적합한 주소를 사용하세요. 한 번의 테스트 성공은 그 시점의 해당 탐색이 성공했다는 뜻일 뿐, 모든 실제 요청에 접속할 수 있다는 의미는 아닙니다. 테스트 소요 시간을 다운로드 속도로 해석해서도 안 됩니다.

Today Widget: 시스템 위젯에서 확인

Settings에서 Today Widget 관련 옵션을 확인하고 현재 시스템에서 제공하는 위젯 추가 메뉴를 살펴보세요. 위젯을 추가한 뒤에는 제공되는 상태나 빠른 동작을 확인할 수 있습니다. Global Routing, 현재 서버 또는 설정 파일을 확인해야 한다면 Home이나 Config로 돌아가세요. 위젯이 표시되지 않으면 먼저 앱을 열어 연결이 정상인지 확인한 다음 시스템에서 해당 위젯 메뉴를 제공하는지 살펴보세요. 위젯이 없다는 이유만으로 서버를 다시 설정할 필요는 없습니다.

iCloud: 동기화 항목 확인

사용 중인 기기 간에 동기화하려면 Settings에서 iCloud 옵션을 확인하세요. 두 기기가 같은 Apple 계정으로 로그인되어 있고 시스템에서 앱의 iCloud 사용을 허용하는지 확인해야 합니다. 화면 안내에 따라 필요한 항목을 활성화한 뒤 다른 기기에 항목이 나타나는지 확인하세요. 동기화 전에 중요한 설정을 백업하고 양쪽 기기에서 같은 내용을 동시에 수정하지 마세요. 설정이나 서버 정보가 동기화되더라도 기기마다 연결과 On Demand 조건을 각각 테스트해야 합니다.

Diagnostics: 증상에 따라 기록 확인

Settings에서 Diagnostics를 열고 문제 발생 시각, 네트워크 유형, Global Routing 모드를 기록한 다음 구체적인 문제를 한 번 재현하세요. 기록에 DNS 해석 실패가 표시되면 DNS를 먼저 확인하세요. 주소는 해석됐지만 연결 시간이 초과됐다면 현재 서버와 대상 주소를 확인하세요. 연결은 됐지만 접속 결과가 예상과 다르다면 규칙 매칭과 적용 정책을 살펴보세요. 한 번에 설정 하나만 바꾸고 다시 테스트하세요. 기록을 공유하기 전에 계정 정보, 구독 URL 및 기타 민감한 정보를 가리세요.

기기별 Shadowrocket 다운로드

iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하면 됩니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple 칩 및 Intel), Windows, Android, Linux 버전은 무료이며 설치 파일은 이 사이트의 /dl/에서 제공합니다.

앱은 한 번 구매하는 방식이며 회선 요금제와는 별개입니다. 앱을 설치한 사용자는 첫 연결 가이드를 확인하세요.

앱 다운로드