공식 사용 매뉴얼 · 기능 및 설정
Shadowrocket 프록시 모드와 설정
Global Routing은 연결을 어떻게 처리할지 결정하고, Config에는 규칙과 네트워크 매개변수를 저장하며, Home에서는 서버와 연결 상태를 관리합니다. 먼저 이 세 가지를 구분한 다음 On Demand, DNS 또는 테스트 방식을 조정해야 변경 사항이 실제로 무엇에 영향을 주는지 판단할 수 있습니다.
이 페이지에서는 iPhone과 iPad에서 자주 사용하는 기능을 중심으로 설명합니다. 기기와 앱 업데이트에 따라 메뉴 위치가 달라질 수 있으므로 현재 앱에 표시되는 옵션을 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다.
- 라우팅 모드 Config / Proxy / Direct
- 규칙 실행 위에서 아래 순서로 일치
- 설정 원칙 한 번에 하나씩 변경
Home · Global Routing
세 가지 라우팅 모드의 사용 범위
Global Routing은 Home에 있으며 연결의 전반적인 처리 방식을 선택하는 데 사용합니다. 규칙 적용, 프록시, 직접 연결은 각각 화면의 Config, Proxy, Direct에 해당합니다. 한국어 설명은 의미를 안내하기 위한 것이며, 실제 조작 시에는 영어 옵션을 확인하세요. Global Routing에서 원하는 모드를 선택한 뒤 Home으로 돌아와 현재 서버와 연결 스위치를 확인합니다. 모드 선택과 연결 시작은 별개의 작업이므로 옵션만 바꿨다고 연결이 성립하는 것은 아닙니다.
| 화면 옵션 | 처리 방식 | 사용 상황 | 먼저 확인할 항목 |
|---|---|---|---|
| Config | 현재 Config의 규칙에 따라 정책 결정 | 평소 도메인이나 주소별로 트래픽을 분리할 때 | 현재 사용 중인 Config, 규칙 순서, 최종 규칙 |
| Proxy | 해당 연결을 현재 프록시로 처리 | 프록시 연결 경로가 작동하는지 일시적으로 확인할 때 | 현재 선택된 서버와 연결 매개변수 |
| Direct | 해당 연결을 대상에 직접 전송 | 로컬 네트워크를 확인하거나 직접 연결 결과를 비교할 때 | 로컬 네트워크와 대상에 연결할 수 있는지 여부 |
Config: 규칙에 따라 연결 처리
일부 웹사이트에는 PROXY를, 나머지 연결에는 DIRECT를 적용하려면 보통 Config를 선택합니다. 먼저 Config 페이지에서 현재 사용 중인 파일을 확인한 다음 Home으로 돌아와 Config를 선택하세요. 규칙 파일이 목록에 저장되어 있더라도 현재 설정으로 선택되지 않았다면 파일을 수정해도 실제 라우팅에는 반영되지 않습니다. 문제를 확인할 때는 파일에 지정된 정책 이름과 Home에서 선택한 서버도 구분해야 합니다. 정책 이름은 연결 처리 방식을 결정하고, 선택한 서버는 프록시 연결의 실제 목적지에 영향을 줍니다.
Proxy: 프록시 연결 경로 확인
Proxy는 문제 발생 범위를 좁히는 데 유용합니다. 예를 들어 같은 대상에 Proxy로는 접속되지만 Config에서는 실패한다면, 모든 서버 매개변수를 바로 변경하기보다 일치하는 규칙과 DNS를 확인할 수 있습니다. 모든 시스템 연결이 반드시 이 경로를 거친다는 뜻은 아닙니다. 시스템 트래픽, 기존 연결, 설정에 따른 우회 동작은 각각 따로 확인해야 합니다. 비교를 마친 뒤에는 원래 사용하던 모드로 되돌리세요.
Direct: 직접 연결 경로 확인
Direct는 대상에 직접 연결하는 옵션이며 Home의 연결 스위치를 끄는 것과는 다릅니다. 앱 연결 상태를 유지하면서 로컬 네트워크 성능을 비교하려면 일시적으로 Direct를 선택할 수 있습니다. 앱이 설정하는 VPN 연결을 중지하려면 Home의 스위치를 조작하고 On Demand가 다시 연결을 시작하지 않는지도 확인하세요. Direct를 DNS 설정 초기화 버튼처럼 사용하지 마세요. 이름 해석 문제는 별도로 확인해야 합니다.
Config · Rule
규칙 유형과 적용 방식
규칙은 일치 조건과 처리 정책으로 구성되며, 보통 Config 페이지에서 현재 설정의 Rule 내용을 편집합니다. 규칙은 순서대로 확인하고 조건에 맞는 규칙이 있으면 해당 정책을 적용하므로, 더 구체적인 규칙을 포괄적인 규칙보다 앞에 배치해야 합니다. 수정하기 전에 복구할 수 있도록 설정을 저장하고, 변경 후 현재 활성화된 파일을 확인하세요. 규칙을 검증할 때는 새로 접속을 시도해 기존 연결의 결과를 새 규칙의 효과로 착각하지 않도록 합니다.
| 키워드 | 일치 대상 | 사용 시 주의 사항 |
|---|---|---|
DOMAIN | 완전한 도메인 하나 | 특정 호스트 이름만 지정할 때 사용 |
DOMAIN-SUFFIX | 도메인과 하위 도메인 지정 | 프로토콜이나 웹 경로를 입력하지 마세요 |
DOMAIN-KEYWORD | 도메인에 포함된 키워드 | 적용 범위가 넓어 잘못 일치할 수 있으니 주의 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 주소 범위 | 주소와 접두사 길이가 맞는지 확인 |
GEOIP | 주소가 속한 지역 정보 | 주소 데이터베이스와 이름 해석 결과에 따라 달라질 수 있음 |
FINAL | 앞선 규칙에 일치하지 않은 연결 | 보통 규칙 끝에 기본 처리로 사용 |
PROXY, DIRECT 및 REJECT
PROXY는 프록시 정책에 따른 처리를, DIRECT는 직접 연결을, REJECT는 연결 거부를 뜻합니다. 규칙에서 사용하는 정책 키워드이며 서버 프로토콜 이름이 아닙니다. 사용자 지정 정책 그룹을 사용하는 설정이라면 그룹 안에서 선택된 항목과 사용 가능한 구성원도 확인해야 합니다. 규칙 끝에 이름이 있다고 해서 실제 연결이 특정 서버를 반드시 거친다고 단정할 수는 없습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 예시에서는 example.com과 하위 도메인에 PROXY를 적용하고, 나머지 일치하지 않은 연결에는 DIRECT를 적용합니다. example.com은 규칙 예시일 뿐 서버나 구독이 아닙니다. 실제 웹사이트는 이미지, 로그인 또는 API 요청에 다른 도메인을 사용할 수 있으므로 홈페이지가 열린다고 해서 관련 요청이 모두 같은 규칙에 일치하는 것은 아닙니다. 규칙을 확장해야 한다면 키워드 범위를 계속 넓히기보다 실제 요청 기록에서 도메인을 확인하세요.
파일 구조를 더 알아보려면 설정 파일 구성 설명을, 일부 웹사이트에만 규칙을 적용하려면 특정 웹사이트 라우팅 예시를 참고하세요.
Home · SERVER · Subscribe
구독 및 서버 관리
Home의 SERVER 영역에서 서버를 확인하고 선택할 수 있습니다. 구독은 사용자가 보유한 서버 정보를 한꺼번에 가져오거나 업데이트하는 방법이며, 규칙 설정과는 별개입니다. 아래 내용은 본인의 구독이나 서버 정보를 이미 보유한 경우를 전제로 합니다. 이 사이트에서는 관리 및 사용 방법만 안내하며 노드나 구독을 제공·판매·추천하지 않습니다.
Add Server: 보유한 정보 직접 입력
Home에서 Add Server를 열고 보유한 정보에 맞는 Type을 선택한 뒤 주소, 포트, 인증 정보를 입력합니다. Shadowsocks, VMess, VLESS, Trojan 등은 프로토콜마다 필요한 항목이 다르므로 주소가 같다는 이유만으로 다른 Type을 선택하지 마세요. TLS, 전송 방식 또는 관련 이름 항목은 기존 정보와 하나씩 대조하세요. 저장한 뒤 SERVER에서 해당 항목을 선택하고 Connectivity Test를 실행합니다.
Subscribe: 기존 구독 가져오기 및 업데이트
Add Server에서 해당하는 Subscribe 유형을 선택해 보유한 구독 주소를 입력하고, 저장 후 생성된 그룹과 항목을 확인하세요. 구독 주소에는 인증 정보가 포함될 수 있으므로 붙여넣기 전에 전체 내용이 빠짐없이 입력되었는지, 앞뒤 공백이나 줄바꿈이 없는지 확인하고 스크린샷, 게시물 또는 채팅에 공개하지 마세요. 처음 가져오는 전체 과정은 기존 구독 및 서버 가져오기를 참고하세요.
구독 업데이트는 원격에서 제공하는 항목을 다시 불러오는 작업이지 앱 자체를 업데이트하는 것이 아닙니다. 업데이트 후 현재 서버가 그대로 있는지, 이름이나 그룹이 변경되었는지, 직접 수정한 항목이 덮어써졌는지 확인하세요. 중복 항목을 정리할 때는 구독에서 가져온 항목인지 직접 추가한 항목인지 먼저 확인해야 다음 업데이트 때 다시 나타나는 일을 막을 수 있습니다. QR 코드 등으로 가져오는 경우에도 보유한 정보만 사용하고, 가져온 후 프로토콜과 매개변수를 확인하세요.
Settings · On Demand
On Demand 연결 조건
On Demand는 지정된 Wi-Fi로 전환하거나 셀룰러 네트워크를 사용할 때, 또는 관련 도메인 조건이 충족될 때 연결을 시작하는 등의 동작을 설정하는 기능입니다. On Demand는 ‘언제 연결할지’를 처리하고 Global Routing은 ‘연결 후 어떻게 라우팅할지’를 처리하므로 서로 대체할 수 없습니다. 자동 실행을 설정하기 전에 수동 연결이 정상적으로 되는지 확인하세요.
Settings에서 On Demand 관련 설정을 찾아 현재 화면에 제공되는 조건에 따라 규칙을 추가하세요. 먼저 특정 Wi-Fi 이름처럼 재현 가능한 조건 하나만 설정한 뒤 네트워크를 전환해 결과를 확인합니다. 연결과 해제 동작이 예상대로인지 확인한 다음 다른 조건을 추가하세요. 규칙이 여러 개라면 순서, 적용되는 네트워크, 동작을 확인해 범위가 넓은 규칙이 먼저 일치하지 않도록 합니다.
Wi-Fi 이름은 실제 네트워크와 일치해야 하며, 셀룰러 네트워크 조건은 실제 네트워크를 전환해 확인해야 합니다. 도메인 조건은 이미 열려 있는 웹페이지의 상태만으로 판단하지 마세요. 캐시와 기존 연결의 영향을 받을 수 있습니다. 테스트할 때는 기존 페이지를 닫고 새 요청을 시작한 뒤 시스템과 Home의 연결 상태를 확인하세요.
수동으로 연결을 끈 뒤 다시 연결 상태가 표시되면 설정을 반복해서 삭제하기보다 먼저 On Demand를 확인하세요. 문제를 점검하는 동안에는 관련 조건을 잠시 비활성화한 다음 수동 스위치를 테스트할 수 있습니다. 테스트가 끝나면 원래 필요에 따라 다시 설정하세요. 조건 설정 방법은 On Demand 자동 연결 안내를 참고하세요.
Data
트래픽 통계 확인 방법
Data에서는 앱이 기록한 트래픽 정보를 확인해 연결 중 데이터가 전송되는지 판단할 수 있습니다. Data를 열고 현재 화면에 표시되는 통계 범위와 기간, 업로드 및 다운로드의 의미를 확인한 다음 수치 변화를 비교하세요. 앱 내부 통계는 시스템의 셀룰러 데이터 사용량이나 네트워크 서비스의 과금 기준과 다를 수 있으므로, 한쪽 수치를 다른 시스템의 요금 청구 기준으로 간주하지 마세요.
문제를 확인할 때는 현재 수치를 기록한 뒤 명확한 접속 작업을 한 번 수행하고 Data로 돌아와 변화를 살펴보세요. 통계 초기화 기능이 있더라도 기존 기록을 보존할 필요가 없음을 확인한 뒤에만 사용하세요. 통계를 초기화해도 서버, 규칙 또는 원격 서비스의 사용량은 초기화되지 않습니다. 백그라운드 활동도 데이터를 전송할 수 있으므로 테스트 중에는 다른 앱의 요청을 최대한 줄이세요.
업로드는 보이는데 예상한 다운로드가 없다면 전송이 기대대로 완료되지 않았다는 뜻일 뿐, 서버·DNS·대상 서버 응답 중 무엇이 문제인지 단정할 수는 없습니다. Connectivity Test와 요청 기록을 함께 살펴보세요. Data는 연결 속도를 보장하는 기능도 아닙니다. 짧은 요청에서 나타난 트래픽 변화는 지속적인 다운로드 성능을 보여 주지 않으며 실제 서비스 접속 테스트를 대신할 수 없습니다.
Settings · 자주 쓰는 항목
이름 해석, 테스트 및 보조 설정
Settings에는 앱 동작과 보조 기능이 모여 있지만 일부 네트워크 매개변수는 현재 Config에서 설정할 수도 있습니다. 변경 전 해당 항목이 앱 전체에 적용되는지 특정 설정 파일에만 적용되는지 확인하세요. 기기에 따라 메뉴 위치, 사용 가능 여부, 시스템 지원이 다를 수 있으므로, 아래에서는 특정 화면 배치를 모든 기기의 공통 위치로 간주하지 않고 기능별 확인 방법을 설명합니다.
DNS: 적용되는 설정 출처 확인
DNS는 도메인을 IP 주소로 변환합니다. Settings에서 DNS 관련 옵션을 확인할 때는 현재 Config의 General 섹션에 dns-server 등의 항목이 설정되어 있는지도 살펴보세요. 기존 값을 기록하고 한 번에 한 설정 출처만 변경하세요. 이름 해석 설정, 서버, Global Routing을 동시에 바꾸면 접속이 복구되더라도 원인을 파악하기 어렵습니다.
[General]
dns-server = system
이 예시는 시스템에서 제공하는 이름 해석 설정을 사용한다는 의미를 설명하기 위한 것이며 모든 네트워크에 적용되는 고정 답안은 아닙니다. 테스트 응답은 오지만 웹페이지가 열리지 않는다면 도메인 이름 해석, 연결 수립, 대상 서버 응답을 각각 확인하세요. 기존 DNS 캐시 때문에 변경 사항이 바로 적용되지 않은 것처럼 보일 수 있으므로 새 요청을 보내고 현재 사용 중인 설정을 확인해야 합니다. 자세한 내용은 DNS 이름 해석 실패 문제 해결을 참고하세요.
Test Method: 동일한 기준으로 테스트
Test Method는 Connectivity Test에서 사용할 테스트 방식을 결정합니다. Settings의 테스트 관련 설정에서 현재 옵션을 확인하고 화면에서 제공하는 범위 안에서 대상이나 방식을 변경할 수 있습니다. 테스트 방식마다 측정하는 단계가 다르므로 서로 다른 기준으로 얻은 결과를 직접 비교하지 마세요. 서버를 비교할 때는 테스트 방식, 대상, 현재 네트워크를 동일하게 유지해야 합니다.
Connectivity Test가 성공해도 해당 테스트 조건에서 응답을 받았다는 뜻일 뿐 모든 웹사이트와 프로토콜이 작동한다는 의미는 아닙니다. 테스트 방식에 특정 대상이 포함되어 있는데 해당 대상에 연결할 수 없다면 결과가 실패할 수도 있습니다. 먼저 테스트 조건을 확인한 다음 실제로 접속해야 하는 대상을 사용해 다시 확인하세요.
Today Widget: 빠른 접근 기능 확인
Today Widget은 시스템에서 지원하는 위젯이나 빠른 보기 기능을 위한 항목입니다. 먼저 Settings에서 관련 옵션을 확인한 다음 시스템에서 위젯을 관리하는 위치로 이동해 추가할 수 있는지 살펴보세요. 사용 가능한 형태와 조작 기능은 시스템 및 앱 지원에 따라 달라지므로 다른 기기에서 본 화면 구성을 현재 기기에 그대로 적용하지 마세요.
위젯에서 조작한 뒤 상태가 예상과 다르면 Home으로 돌아가 연결 스위치, 현재 서버, Global Routing을 확인하세요. 위젯은 보조 진입점일 뿐 전체 설정 화면을 대신하지 않습니다. 시스템 최초 권한 승인, 매개변수 편집, 상세 문제 해결은 앱이나 해당 시스템 화면에서 진행해야 합니다.
iCloud: 동기화와 복원 구분
iCloud 관련 기능은 지원되는 범위에서 정보를 저장하거나 동기화합니다. 사용 전에 기기가 사용할 iCloud 계정에 로그인되어 있는지, 시스템에서 앱의 iCloud 사용을 허용했는지 확인하고 앱에서 동기화할 수 있는 항목을 살펴보세요. 동기화를 켜면 모든 서버, 설정, 기록, 통계가 포함된다고 가정하지 마세요. 실제 동기화 범위는 현재 화면의 안내를 기준으로 합니다.
기기를 교체하거나 정보를 병합하기 전에 별도 백업을 보관하고 동기화가 완료되는지 확인한 뒤 현재 Config와 SERVER를 살펴보세요. App Store 구매 기록과 설정 동기화는 서로 다른 기능입니다. 앱 구매를 복원해도 연결 정보가 되살아나는 것은 아닙니다. 인증 정보가 포함된 자료는 민감한 정보로 취급하고 동기화 또는 내보내기 내용을 공개된 곳에 표시하지 마세요.
Diagnostics: 필요한 진단 정보 저장
Diagnostics에서는 문제 해결에 필요한 정보를 수집하거나 확인할 수 있습니다. 문제가 발생한 시각, 현재 네트워크, 라우팅 모드, 재현 절차를 기록한 다음 Settings의 Diagnostics 관련 메뉴에서 확인할 수 있는 내용을 살펴보세요. 추가 기록을 켜는 옵션이 있다면 문제를 재현하는 데 필요한 시간에만 활성화하고, 완료 후 평소 설정으로 되돌리세요.
진단 정보를 공유하기 전에 구독 주소, 서버 정보, 인증 정보, 접속 도메인, 개인 네트워크 이름이 포함되어 있는지 확인하고 필요한 부분을 가리세요. 기록이 많다고 원인을 더 쉽게 찾을 수 있는 것은 아닙니다. 설정을 여러 번 무작위로 바꾼 뒤 쌓인 많은 기록보다 특정 작업과 시각을 확인할 수 있는 기록이 문제를 파악하는 데 더 유용합니다.
확인 순서
설정 변경을 순서대로 진행하기
- 기존 상태를 보존하세요.현재 Config, Global Routing, 선택한 서버를 기록하고 복구할 수 있는 설정 파일을 저장합니다. 구독이나 계정 정보가 포함된 경우 공개된 기록에 인증 정보를 그대로 남기지 마세요.
- 먼저 로컬 네트워크를 확인하세요.Wi-Fi 또는 셀룰러 네트워크 자체가 정상적으로 작동하는지 확인합니다. 비교가 필요하면 잠시 Direct를 사용하고 테스트 후 원래 모드로 되돌리세요. 로컬 네트워크 문제와 규칙 오류를 혼동하지 마세요.
- 보유한 서버를 확인하세요.Type, 주소, 포트, 인증 항목을 확인한 다음 동일한 Test Method로 Connectivity Test를 실행합니다. 테스트 후에는 실제 대상에도 접속해 테스트 요청에만 응답이 있었던 것은 아닌지 확인하세요.
- 마지막으로 규칙을 조정하세요.Config에서 규칙 일치 순서와 FINAL을 확인하고 한 번에 한 항목만 수정합니다. 새 요청을 보내 대상과 관련 요청이 예상한 정책을 사용하는지 확인하세요.
- 자동 동작을 복원하세요.수동 연결이 안정적으로 작동한 뒤 On Demand를 켜고 네트워크 전환 상황을 확인하세요. 이어서 Data와 필요한 Diagnostics를 살펴보고 임시 테스트와 추가 기록을 종료합니다.
처음 사용하는 분은 빠른 시작 안내를 따라 처음 설정을 순서대로 진행하세요. 구체적인 문제가 이미 발생했다면 문제 해결 매뉴얼의 연결 문제를 참고해 항목별로 확인하세요. 화면 용어나 규칙 키워드를 확인하려면 용어 안내를 참고하세요.