공식 매뉴얼 · 기능 및 설정
Shadowrocket 설정 방법
먼저 Home에서 Global Routing을 확인한 다음, 필요에 따라 규칙을 조정하거나 기존 구독을 업데이트하고 On Demand를 켜세요. 화면 경로는 iPhone / iPad를 기준으로 설명합니다. 데스크톱과 Android에서는 앱에 표시되는 메뉴 위치를 확인하세요.
01 / Global Routing
Config, Proxy, Direct 중 선택하기
Home에서 Global Routing을 열고 현재 작업에 맞게 Config, Proxy 또는 Direct를 선택하세요. 이 설정은 연결을 켠 뒤 요청을 처리하는 방식을 정하며, 연결을 설정하거나 구성 파일을 수정하지는 않습니다.
| 모드 | 요청 처리 방식 | 사용 시점 | 전환 전후 확인 사항 |
|---|---|---|---|
| Config (구성) | 현재 구성의 규칙과 정책에 따라 트래픽을 라우팅합니다. | 요청마다 서로 다른 정책을 적용해야 하는 일상적인 사용에 적합합니다. | 적용 중인 구성이 무엇인지 확인하고, 해당 규칙과 FINAL을 점검하세요. |
| Proxy (프록시) | 클라이언트가 처리하는 요청을 선택한 프록시 서버로 전달합니다. Config의 규칙을 하나씩 적용해 경로를 선택하지는 않습니다. | 현재 서버가 대상 요청을 처리할 수 있는지 일시적으로 확인할 때 사용합니다. | Home에서 선택한 서버를 확인하고, 테스트가 끝나면 평소 사용하는 모드로 되돌리세요. |
| Direct (직접 연결) | 클라이언트가 처리하는 요청을 프록시 서버를 거치지 않고 전달합니다. | 프록시 경로와 현재 네트워크의 직접 연결 결과가 다른지 확인할 때 사용합니다. | Direct는 Home의 연결 스위치를 끄는 기능이 아닙니다. 클라이언트가 요청을 처리하지 않는 상태와 비교하려면 연결을 끈 뒤 테스트하세요. |
비교 테스트에서는 같은 네트워크, 같은 대상 주소, 같은 서버를 사용하고, 모드를 바꿀 때마다 요청을 새로 보내세요. Proxy에서는 접속되지만 Config에서는 안 된다면 규칙 일치 여부와 정책 방향을 먼저 확인하세요. Direct에서도 실패하면 연결을 끄고 다시 시도해 네트워크 문제인지 클라이언트 설정 문제인지 구분하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로, 이미 열려 있는 페이지의 상태만으로 전환 결과를 판단하지 마세요.
02 / Rule
규칙 유형, 일치 순서 및 정책
규칙은 일치 조건과 일치 후 적용할 정책으로 구성됩니다. Config를 열어 사용 중인 구성 파일을 확인한 다음 [Rule] 섹션을 살펴보세요. 규칙은 순서대로 평가되며, 먼저 일치한 항목이 해당 요청에 적용할 정책을 결정합니다. Home의 Global Routing이 Config로 설정되어 있어야 이 규칙 목록에 따라 트래픽이 분리됩니다. 수정하기 전에 원본 구성을 보관해 두면 비교하고 복구하기 쉽습니다.
DOMAIN은 호스트 이름 하나와 정확히 일치합니다.DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인에 적용됩니다.DOMAIN-KEYWORD는 도메인에 포함된 키워드로 일치 여부를 판단하며, 키워드가 짧을수록 의도하지 않은 항목과 일치할 가능성이 높습니다. 도메인 규칙에는 도메인만 입력하고 프로토콜, 경로 또는 쿼리 매개변수는 넣지 마세요.IP-CIDR과IP-CIDR6은 각각 IPv4와 IPv6 주소 대역에 일치하며,GEOIP는 IP의 지역 정보를 기준으로 일치 여부를 판단합니다. 이 규칙들은 도메인 접미사가 아니라 IP를 확인합니다. 대상 주소가 바뀌거나 다른 주소 체계를 사용하면 일치 결과가 달라질 수 있습니다.USER-AGENT는 요청에서 User-Agent를 식별할 수 있어야 하므로 모든 앱 트래픽을 매칭하는 데 적합하지 않습니다.FINAL은 앞선 규칙과 일치하지 않은 요청을 처리하므로 규칙 목록의 마지막에 두세요.
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
예시에서는 먼저 status.example.com을 DIRECT로 보내고, 같은 도메인의 나머지 일치 요청은 PROXY로 전달합니다. 앞의 두 줄 순서를 바꾸면 범위가 더 넓은 접미사 규칙이 먼저 일치해 첫 번째 예외가 적용되지 않습니다. PROXY는 프록시 경로를 사용하고, DIRECT는 프록시 서버를 거치지 않으며, REJECT는 일치한 요청을 차단합니다. REJECT를 사용할 때는 대상 범위를 먼저 좁혀 같은 도메인에 의존하는 로그인이나 리소스 요청까지 함께 차단하지 않도록 하세요.
저장한 뒤 별도로 처리할 주소를 먼저 테스트하고, 같은 도메인에서 영향을 받지 않아야 하는 주소를 확인한 다음, FINAL로 처리되어야 하는 대상을 테스트하세요. 필드 형식과 추가 예시는 구성 필드 안내를 참고하세요.
03 / Server
기존 구독 가져오기 및 서버 관리
구독을 사용하면 출처에 따라 서버 항목을 한꺼번에 업데이트할 수 있습니다. 서버 연결 정보가 한 대분만 있다면 서버를 개별적으로 추가할 수 있습니다. 두 방법 모두 이미 보유한 구독 또는 서버 정보를 전제로 합니다. 구독 주소에는 접속 인증 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하고, 공개 스크린샷이나 로그, 공유 문서에 노출하지 마세요.
- Home에서 Add Server를 여세요. 기존 구독 주소가 있다면 Subscribe를 선택하고 서비스 제공자가 안내한 전체 주소를 입력한 뒤 저장하세요. 업데이트하려면 Home에서 해당 구독의 업데이트 메뉴를 찾아 목록이 불러와졌는지 확인하세요. 구독 주소를 개별 서버의 주소 입력란에 넣지 마세요.
- 개별 서버의 연결 정보가 있다면 Add Server에서 안내된 프로토콜(예: Shadowsocks, VMess 또는 Trojan)을 선택하고 해당 항목에 호스트, 포트, 인증 정보를 입력하세요. 정보가 QR 코드로 제공된 경우 Scan QR Code로 가져올 수 있습니다. 저장하기 전에 프로토콜과 대상 주소가 맞는지 확인하세요.
- Home으로 돌아가 SERVER 목록에서 사용할 항목을 선택한 다음 Connectivity Test를 실행하세요. 구독을 업데이트한 뒤에는 현재 선택된 항목을 다시 확인하세요. 이름이 같은 항목도 주소나 매개변수가 바뀌었을 수 있으므로, 이름이 같다는 이유만으로 같은 서버라고 판단할 수 없습니다.
‘구독 업데이트 성공’과 ‘서버 연결 성공’은 별도로 확인해야 합니다. 업데이트 성공은 클라이언트가 목록을 가져왔다는 뜻일 뿐입니다. 항목에 연결할 수 없다면 프로토콜, 주소, 포트, 서비스 제공자가 안내한 인증 정보를 확인하세요. 업데이트 자체가 실패했다면 구독 주소가 온전한지, 현재 네트워크에서 해당 주소에 접속할 수 있는지부터 살펴보세요. 가져온 뒤 처음 연결하는 방법은 빠른 시작을 참고하세요.
04 / On Demand
On Demand 및 네트워크 전환
On Demand는 설정한 조건이 충족되면 시스템이 연결을 시작하도록 합니다. 네트워크가 바뀐 뒤 자동으로 연결해야 하는 경우에 유용합니다. On Demand가 정하는 것은 ‘언제 연결할지’이며, ‘요청을 어떤 경로로 보낼지’는 결정하지 않습니다. 후자는 Global Routing과 현재 구성에 따라 달라집니다.
Settings에서 On Demand를 찾으세요. 먼저 Home에서 현재 서버와 라우팅 모드를 수동으로 확인한 다음 On Demand를 켜고, 화면에 표시되는 Wi-Fi, 셀룰러 네트워크 등의 조건으로 적용 범위를 좁히세요. 저장한 뒤 예상대로 실행되는 네트워크와 실행되지 않아야 하는 네트워크에서 각각 요청을 보내고 Home으로 돌아가 연결 상태를 확인하세요. 네트워크를 전환한 후 시스템이 연결을 다시 설정할 시간을 두세요. 전환 직후 한 번 실패했다고 규칙이 적용되지 않는다고 판단하지 마세요.
수동으로 연결을 끊었는데 다시 자동 연결된다면 트리거 조건이 여전히 충족되는지 먼저 확인하세요. 일시적으로 연결 해제 상태와 비교 테스트를 하려면 On Demand를 끈 뒤 테스트하고, 완료되면 다시 켜세요. 배터리 소모를 점검할 때도 스위치 상태만 보지 말고 시스템의 배터리 사용 기록을 확인해 비슷한 네트워크와 사용 시간대에 재연결이 잦은지 비교하세요.
05 / Data
트래픽 통계 범위 및 수치
Data에서는 Shadowrocket에 기록된 트래픽을 확인할 수 있습니다. 통신사 요금 청구량이나 서비스 제공자의 측정 결과와는 다를 수 있습니다. Data에서 먼저 표시되는 통계 범위와 단위를 확인한 다음 송신량과 수신량을 살펴보세요. 한 번의 테스트를 측정할 때 기존 기록을 지울 필요는 없습니다. 시작 수치를 기록하고 작업을 한 번 완료한 뒤 종료 수치에서 시작 수치를 빼면 됩니다.
수치가 예상보다 빠르게 늘어난다면 같은 네트워크에서 다시 확인하고, 동영상 재생, 클라우드 동기화, 대용량 파일 다운로드 같은 백그라운드 활동과 현재 테스트를 구분하세요. 수치가 바뀌지 않는다면 연결이 설정되었는지 확인한 다음 요청이 클라이언트를 통과하는지 점검하세요. 페이지가 로컬 캐시에서 열렸다면 새 네트워크 전송이 발생하지 않았을 수도 있습니다. Data로 확인할 수 있는 것은 ‘기록된 트래픽 양’입니다. 트래픽 증가량만으로 특정 도메인이 어떤 규칙과 일치했는지 판단하거나 연결의 잔여 사용량을 추정할 수는 없습니다.
06 / Settings
DNS, 테스트, 위젯, 동기화 및 진단
먼저 기존 설정을 기록하고 현재 문제와 관련된 항목 하나만 수정하세요. 수정할 때마다 같은 대상으로 다시 테스트하세요. DNS, 서버, 테스트 방법을 동시에 바꾸면 결과의 원인을 파악하기 어렵습니다.
DNS: DNS 조회 결과와 라우팅 결과 구분하기
DNS는 도메인 이름을 IP 주소로 변환합니다. 문제를 확인할 때 먼저 Home에서 Global Routing을 확인한 다음 Config에서 현재 구성의 [General] 항목과 관련된 dns-server 설정을 살펴보세요. 필요하다면 현재 네트워크 요구 사항에 맞게 조정하고 저장한 뒤 다시 연결하세요. 정상적으로 조회되는 비교용 도메인과 문제가 발생한 도메인을 각각 테스트하세요. 회사나 가정 네트워크의 내부 도메인은 해당 네트워크의 DNS 서버가 필요할 수 있습니다. 공용 DNS 서버로 바꾼 뒤 외부 도메인이 정상적으로 열려도 내부 도메인까지 정상이라는 뜻은 아닙니다. 자세한 필드는 General 설정 안내를 참고하세요.
Test Method: 조건을 고정해 비교하기
Settings에서 Test Method를 열고 화면에 제공되는 옵션으로 테스트 방법을 정한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 연결 설정 여부를 확인하는 것과 요청 전체가 정상적으로 처리되는지 확인하는 것은 다릅니다. 테스트에 성공해도 특정 서비스 도메인을 사용할 수 있다고 단정할 수 없습니다. 서버를 비교할 때는 네트워크와 테스트 방법을 동일하게 유지하고, 화면에서 설정할 수 있는 테스트 대상도 고정하세요. 한 번 시간 초과가 발생하면 먼저 같은 조건으로 다시 테스트한 뒤 서버 변경이나 설정 점검을 결정하세요.
Today Widget: 시스템 위젯에서 상태 확인하기
Today Widget은 시스템 위젯을 여는 기능이지, 별도의 연결 설정이 아닙니다. Settings에 Today Widget이 표시되면 사용 가능한 옵션을 확인한 뒤 현재 시스템에서 지원하는 방법으로 Shadowrocket 위젯을 추가하세요. 기기의 위젯 목록에 해당 항목이 없거나 위젯 상태가 제때 갱신되지 않으면 Home에서 연결 상태와 선택된 서버를 확인하세요. 라우팅 모드, 구독, 구성 파일은 계속 앱에서 관리합니다.
iCloud: 동기화할 항목을 먼저 확인하기
자신의 iPhone과 iPad 사이에서 정보를 동기화하려면 먼저 두 기기에서 같은 Apple 계정으로 로그인했는지 확인하고, 시스템 설정에서 Shadowrocket의 iCloud 사용을 허용하세요. 그런 다음 앱의 Settings에서 iCloud 관련 스위치를 확인합니다. 기능을 켜기 전에 중요한 구성을 보관하고, 먼저 한 기기에서 항목 하나만 수정한 뒤 다른 기기에서 해당 내용이 업데이트되었는지 확인하세요. 동기화를 별도의 백업으로 간주하거나 동기화된 항목이 보인다는 이유만으로 연결이 설정되었다고 판단하지 마세요. 시스템 권한과 연결 상태는 각 기기에서 따로 확인해야 합니다.
Diagnostics: 다시 확인할 수 있도록 문제 기록하기
Diagnostics는 현재 연결 문제를 점검하는 데 필요한 단서를 수집합니다. Settings에서 Diagnostics를 열기 전에 오류 발생 시각, 현재 네트워크, Global Routing 모드, 문제가 특정 대상에만 발생하는지를 기록하세요. 같은 작업을 한 번 재현한 뒤 진단 결과를 DNS, 서버 테스트 또는 규칙 점검 결과와 비교하세요. 내용을 전달하기 전 구독 전체 주소, 비밀번호, 인증 정보를 삭제하고 재현에 필요한 환경과 증상만 남기세요. 다음에 무엇을 확인해야 할지 모르겠다면 연결 문제 해결 문답을 참고하세요.