OFFICIAL MANUAL / SETTINGS
Shadowrocket 설정 참고
설정 적용 범위부터 시작해 DNS, On Demand, Global Routing, 연결 테스트, 로그, 동기화와 로컬 포트를 차례로 살펴봅니다.
이 페이지는 Shadowrocket 가이드의 시스템 설정 참고 자료입니다. 구독이나 서버 정보를 직접 가져온 뒤 특정 옵션을 변경해야 하는지 확인하려는 사용자를 위한 내용입니다. 처음 연결하는 경우 먼저 시작하기를 읽고 가져오기, 모드 선택, 연결, 확인 순서대로 진행하세요. 구체적인 설정이 궁금할 때 해당 항목을 살펴보면 됩니다. 두 페이지의 목적은 서로 다르므로 처음 사용할 때 모든 옵션을 변경할 필요는 없습니다.
Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux에서 사용할 수 있습니다. 이 문서는 iPhone / iPad에서 흔히 볼 수 있는 인터페이스 용어를 기준으로 설명하며, 다른 플랫폼에서는 실제로 표시되는 옵션을 확인하세요. 특정 시스템 전용 기능이 모든 플랫폼에서 동일하다고 가정하지 않습니다. iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하면 사용할 수 있으며, Mac / Windows / Android / Linux 버전은 무료입니다. 앱의 일회성 구매와 연결 서비스 요금제는 별개입니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다.
SETTINGS / SCOPE
설정 범위, 초기 상태 및 권장 기준
설정이 저장되는 위치부터 구분하기
같은 연결 결과에도 Settings, 현재 Config, 선택한 서버, 시스템 네트워크 상태가 함께 영향을 줄 수 있습니다. Settings의 환경설정은 구성 파일의 지시사항과 같지 않으며, 구독 항목의 매개변수도 전역 스위치와 다릅니다. 예를 들어 서버 주소와 인증 정보는 연결 항목에 속하고, 규칙 매칭은 현재 Config에 속하며, VPN 연결 허용 여부는 시스템 권한에 달려 있습니다. 문제를 살펴보기 전에 어느 계층을 수정 중인지 기록하세요. 잘못된 위치를 반복해서 변경하거나 가져오기 작업으로 생긴 변화를 앱이 모든 설정을 자동으로 바꾼 것으로 오해하는 일을 줄일 수 있습니다.
이 문서에서 ‘초기 상태’란 처음 열었거나 직접 변경하지 않았을 때 실제 화면에 표시되는 값을 뜻합니다. 권장값을 고정된 출고 기본값처럼 설명하지 않습니다. 시스템, 가져온 Config, 기존 동기화 데이터에 따라 현재 상태가 다를 수 있고, 업데이트 후에도 기존 선택이 유지될 수 있습니다. 기본값을 확인할 수 없다면 먼저 현재 값을 캡처해 기록하고, 사용 중인 Config에 해당 매개변수가 선언되어 있는지 확인하세요. 옵션 이름이 비슷하다는 이유만으로 화면 설정과 구성 파일에 일률적인 적용 순서가 있다고 단정하지 마세요.
복구할 수 있는 최소 기준 만들기
변경을 시작하기 전에 현재 Config의 사본을 저장하고 Global Routing, 선택한 서버, 연결 스위치, 현재 네트워크를 기록하세요. 구독 링크, 비밀번호, 키는 본인이 관리하는 안전한 위치에 보관하고 공유용 스크린샷에는 넣지 마세요. 정상 연결되는 항목은 그대로 두고 사본에서 새 규칙을 확인하세요. 원래 연결되지 않았다면 기존 상태를 비교 기준으로 보존합니다. 백업의 목적은 어떤 옵션을 켰는지 어렴풋이 기억하는 것이 아니라 입력 내용을 구체적으로 복구하는 데 있습니다.
권장 기준은 확인된 서버 정보를 사용하고, 용도를 모르는 고급 매개변수는 추가하지 않으며, 설명하기 쉬운 Config 하나를 유지하고, 안정적인 네트워크에서 먼저 수동 연결하는 것입니다. DNS는 우선 시스템 이름 확인이 정상인지 살펴보고, On Demand에는 복잡한 조건을 넣지 않으며, 로그는 문제를 살펴볼 때 필요한 수준으로만 켜세요. 이는 문제의 원인을 찾기 위한 권장 절차이지 모든 기기의 기본값이 같다는 뜻도, 정상 작동이 확인된 기능을 계속 꺼 두라는 뜻도 아닙니다.
| 설정 계층 | 대표 항목 | 변경 전 기록 |
|---|---|---|
| 연결 항목 | 주소, 포트, 프로토콜, 인증 매개변수 | 기존 항목 사본 및 서비스 제공업체의 요구사항 |
| Config | General、Rule、Host | 현재 적용 중인 파일 및 규칙 순서 |
| Settings | 테스트, 로그, 동기화 등의 환경설정 | 현재 옵션 및 화면에 표시되는 설명 |
| 시스템 | VPN 권한, 네트워크, 클라우드 계정 | 네트워크 유형 및 권한 상태 |
확인 가능한 요소를 한 번에 하나씩 변경하기
한 번의 테스트에서는 변수 하나만 변경하고 성공 조건을 정하세요. 예를 들어 DNS를 변경했다면 연결 스위치가 계속 켜져 있는지만 보는 것이 아니라, 이전에 실패한 도메인이 확인되는지 살펴봅니다. 매번 같은 대상, 네트워크, 서버로 테스트하고 결과를 기록한 뒤 변경을 유지할지 결정하세요. 서버와 라우팅 모드, 리졸버를 동시에 바꾸면 접속이 복구되어도 어떤 변경이 효과가 있었는지 알 수 없습니다. 그러면 비슷한 문제가 다시 생겼을 때 재현하기도 어려워집니다.
화면 위치와 시스템 기능은 플랫폼마다 다를 수 있습니다. 기기에 설명된 옵션이 없다면 이름이 비슷한 다른 옵션으로 대신하지 말고, 확인되지 않은 키를 Config에 넣지도 마세요. 먼저 사용하는 플랫폼을 확인한 뒤 현재 화면이 서버 편집 페이지가 아니라 Settings인지 살펴보세요. 앱 다운로드와 시스템 권한 허용 절차는 전체 플랫폼 다운로드 페이지에서 확인할 수 있습니다. 설정 문제는 설치를 마치고 앱이 정상적으로 열린 다음 살펴봐야 합니다. 네트워크 매개변수로 설치 권한 문제를 해결할 수는 없습니다.
SETTINGS / DNS
DNS: 이름 확인 경로와 로컬 매핑
이름 확인 문제인지 연결 문제인지 먼저 판단하기
DNS는 도메인을 네트워크 주소로 변환하지만 주소를 얻었다고 해서 이후 연결까지 성공하는 것은 아닙니다. 도메인 요청 실패는 이름 확인 단계에서 발생할 수도 있고, 주소를 얻은 뒤 연결을 설정하지 못해 발생할 수도 있습니다. 먼저 Log에서 이름 확인 결과가 있는지 살펴보고, 이어서 연결에 사용된 주소와 대상 포트, 적용된 정책을 확인하세요. 모든 시간 초과를 DNS 탓으로 돌리면 리졸버를 자주 바꾸면서 변수만 늘어납니다. 서버 인증 실패, 대상 서비스의 응답 중단, 잘못된 규칙 정책은 리졸버를 바꾼다고 해결되지 않습니다.
세 종류의 이름을 구분해야 합니다. 브라우저에서 방문하는 대상 도메인, 프록시 서버 자체의 도메인, 구독 링크의 도메인입니다. 각각 다른 단계에서 다른 네트워크 경로를 사용할 수 있습니다. 특히 서버 주소가 도메인이라면 프록시 연결을 시작하기 전에 이름 확인이 필요할 수 있습니다. ‘연결 후에는 모든 이름 확인이 프록시를 통한다’고 단순하게 생각하면 안 됩니다. 서버 도메인만 확인되지 않는다면 대상 사이트의 DNS 동작을 따지기 전에 현재 네트워크와 서비스 제공업체가 알려 준 정보를 확인하세요.
dns-server와 system 이해하기
구성의 dns-server = system은 시스템이 제공하는 이름 확인 경로를 사용한다는 뜻입니다. 특정 공용 DNS 서비스를 미리 지정하거나 이름 확인이 반드시 특정 서버를 통한다고 의미하지 않습니다. 시스템 결과는 Wi-Fi, 셀룰러 네트워크, 네트워크 관리 정책에 따라 달라질 수 있습니다. 문제를 확인할 때 시스템 이름 확인을 기준으로 삼으면 현재 네트워크의 기존 동작을 유지할 수 있습니다. 로그에서 시스템 이름 확인에 문제가 확인된 경우에만 필요에 따라 신뢰할 수 있고 현재 네트워크에서 연결 가능한 경로를 설정한 뒤 같은 도메인의 결과를 비교하세요.
[General]
dns-server = system
[Host]
localhost = 127.0.0.1
이 예시는 섹션 이름과 매개변수만 보여 주며 완성된 네트워크 설정이 아닙니다. 기존 Config에 추가하기 전에 같은 이름의 섹션이나 중복 키가 이미 있는지 확인하세요. 파일 끝에 내용을 반복해 붙여 넣으면 실제 적용 내용을 잘못 판단할 수 있습니다. 다른 이름 확인 방식을 설정했다면 앱이 현재 지원하는 주소 형식과 전송 방식, 해당 DNS 서비스의 안내를 확인하세요. 일반 도메인, 전체 웹 주소, DNS 서버 주소를 혼동하지 말고 테스트를 위해 여러 경로를 한꺼번에 입력하지도 마세요.
Host, 캐시 및 IPv6의 범위
Host 매핑은 이름에 대응하는 주소를 명시적으로 지정합니다. 대상 서버의 인증서를 수정하거나 애플리케이션 인증 방식을 바꾸지는 않습니다. 예시의 localhost는 로컬 루프백 이름이므로 프록시 서버 주소로 바꾸지 마세요. 특정 도메인에 고정 매핑을 설정한 적이 있다면 대상이 이전된 뒤에도 기존 주소가 접속에 영향을 줄 수 있습니다. 따라서 현재 Config의 Host 섹션도 확인해야 합니다. 매핑을 삭제하기 전에 사본을 저장해 사용자가 의도적으로 설정한 내부 네트워크 이름까지 지우지 않도록 하세요.
캐시 때문에 연속 테스트 결과가 서로 모순되어 보일 수 있습니다. 앱, 시스템, 대상 프로그램이 이전 결과를 저장할 수 있으므로 변경 후에는 현재 플랫폼에서 지원하는 방법으로 관련 캐시를 새로 고치거나 대상 프로그램을 종료한 뒤 요청을 다시 생성하고 새 기록을 확인하세요. 같은 페이지를 반복해서 새로 고치는 것만으로 설정이 적용됐는지 판단하지 마세요. IPv6를 사용하는 경우에는 네트워크에서 IPv6 연결이 실제로 가능한지도 확인해야 합니다. IPv6 주소가 확인되는 것과 해당 주소로 연결에 성공하는 것은 별개의 조건입니다.
| 관찰된 현상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 이름 확인 결과가 없음 | 이름 확인 경로 및 네트워크 연결 가능 여부 | 같은 네트워크에서 비교용 도메인 테스트 |
| 주소는 있지만 연결 시간 초과 | 정책, 대상 포트 및 주소 유형 | 해당 연결 기록 확인 |
| 일부 도메인에서만 문제 발생 | Host, 캐시 및 정확한 규칙 | 해당 변경만 취소 |
권장값은 설명하고 확인할 수 있는지에 따라 정하세요. 시스템 이름 확인이 정상이라면 우선 그대로 유지하고, 실제 필요가 있을 때만 사용자 지정 DNS 설정을 추가합니다. 초기값은 기기의 현재 Config와 Settings를 기준으로 하며 모든 플랫폼에서 동일하다고 보장하지 않습니다. 확인할 때 도메인, 확인된 주소, 시간, 네트워크 환경을 기록하세요. 결과를 공유한다면 내부 도메인과 서버 정보를 가립니다. 이름 확인은 성공했지만 접속할 수 없다면 DNS 매개변수를 더 추가하지 말고 이 페이지의 라우팅 및 로그 항목을 확인하세요.
SETTINGS / ON DEMAND
On Demand: 조건부 연결 및 수동 연결 해제
On Demand와 규칙 기반 라우팅은 서로 다른 계층입니다
On Demand는 시스템이 지원하는 네트워크 조건에 따라 연결 동작을 실행합니다. Rule은 연결 중인 요청에 어떤 정책을 적용할지 정합니다. 전자는 ‘언제 연결을 설정할지’, 후자는 ‘연결 후 요청을 어떻게 처리할지’를 다룹니다. 따라서 On Demand를 켜도 모든 요청이 프록시를 통하는 것은 아니며, 끄더라도 Config의 규칙이 삭제되는 것은 아닙니다. 문제를 살펴볼 때 연결 상태와 트래픽 정책을 나누어 확인하세요. 그래야 조건에 따른 재연결을 규칙 오류로 오해하거나, 직접 연결 규칙을 VPN 미연결로 착각하지 않습니다.
On Demand의 실제 조건과 메뉴 위치, 지원 범위는 플랫폼에 따라 다릅니다. 이 문서는 주로 iPhone / iPad에서의 사용 방식을 설명하며 특정 시스템의 조건 목록을 모든 기기에 공통되는 기능으로 다루지 않습니다. 초기 상태는 기기에 현재 표시되는 값을 기준으로 확인하세요. 이전 시스템 VPN 설정, 동기화 복원, 과거의 수동 변경이 관찰 결과에 영향을 줄 수 있습니다. 처음 설정할 때는 자동 실행을 꺼 두고 수동 연결과 연결 해제, 대상 접속이 예상대로 동작하는지 확인한 뒤 조건을 하나씩 추가하세요.
필요한 네트워크 동작부터 정리하기
설정 전에 목표를 한 문장으로 적으세요. 예를 들어 ‘지정한 Wi-Fi에서는 자동 연결하지 않고, 다른 네트워크로 바뀌면 정해 둔 조건에 따라 연결한다’와 같이 정리합니다. 그런 다음 집과 직장의 Wi-Fi, 셀룰러 네트워크, 웹 인증이 필요한 네트워크 등 실제 네트워크를 나열하세요. 명확히 식별할 수 있고 실제로 구분해야 하는 조건만 설정합니다. 이름이 비슷한 무선 네트워크를 같은 네트워크로 취급하지 말고, Wi-Fi 이름을 신뢰할 수 있는 인증 정보로 간주하지도 마세요.
조건은 하나씩 저장하고 네트워크 전환을 테스트한 뒤 다음 조건을 추가하세요. 신호가 안정되기 전에 연결 스위치를 연속해서 누르지 말고 시스템의 네트워크 전환이 끝날 때까지 기다립니다. 전환 전후의 네트워크, 앱 연결 상태, 시스템 VPN 상태를 기록하세요. 상태 표시줄 아이콘만 보는 것보다 세 가지를 함께 확인하는 편이 정확합니다. 조건이 겹칠 수 있다면 실제 화면 설명을 보고 우선순위를 확인하세요. Rule과 동일한 매칭 순서를 사용한다고 가정해서는 안 됩니다.
‘연결을 끊었는데 다시 연결됨’ 현상 이해하기
수동으로 연결을 끊은 직후 다시 연결된다면 먼저 On Demand 조건이 계속 충족되는지 확인하세요. 조건에 따라 시스템이 연결을 다시 설정하는 현상과 버튼이 작동하지 않는 현상은 서로 다릅니다. 오랫동안 연결을 끊어 두거나 다른 VPN을 확인하거나 네트워크 인증을 처리해야 한다면 On Demand 실행을 잠시 끈 뒤 연결을 끊고 시스템 상태가 바뀌는지 확인하세요. 작업을 마친 뒤 필요한 조건을 다시 설정하면 됩니다. 스위치만 반복해서 누르면 매번 다시 연결되어 문제 발생 시점을 파악하기 어려워집니다.
웹 인증이 필요한 네트워크는 별도로 확인해야 합니다. Wi-Fi에 연결됐다고 정상적인 네트워크 접근까지 가능하다는 뜻은 아니며, 시스템에서 표시하는 페이지로 인증해야 할 수도 있습니다. 인증 전에 자동 연결이 실행되면 실패하거나 인증 페이지를 찾기 어려워질 수 있습니다. 이때는 자동 실행을 잠시 끄고 해당 네트워크의 인증을 완료한 다음 일반 네트워크 접속을 확인하고 수동으로 연결하세요. DNS나 규칙을 바꾸고 연속으로 재시도하는 것으로 네트워크 자체의 인증 절차를 대신하지 마세요.
시스템 권한 및 절전 후 복구 상태도 함께 확인하기
시스템 VPN 권한이 있어도 기기 관리 정책이나 다른 네트워크 도구의 영향을 받을 수 있습니다. 시스템에서 연결을 거부하면 앱에서 존재하지 않는 규칙 예외를 찾지 말고 시스템 안내와 설치된 VPN 설정을 확인해 충돌이 있는지 살펴보세요. 관리 대상 기기의 제한은 기기 관리자에게 문의해야 합니다. 알 수 없는 시스템 설정을 삭제하며 시험하지 마세요. 데스크톱 시스템의 백그라운드 실행 옵션을 iPhone / iPad의 On Demand에 그대로 적용해서도 안 됩니다.
설정을 마친 뒤에는 최소한 한 번 화면 잠금 후 해제, Wi-Fi와 셀룰러 간 전환, 수동 연결 해제 및 재연결을 확인하세요. 네트워크가 복구될 때만 문제가 생긴다면 발생 시간을 기록하고 같은 시점의 로그를 살펴 네트워크 준비 지연, 이름 확인 실패, 연결 거부를 구분합니다. 오래 유지할 설정은 조건이 가장 많은 구성이 아니라 용도가 명확하고 검증된 조건 모음입니다. 기본 사용 절차를 다시 확인하려면 시작하기로 돌아가 수동 연결부터 확인하세요.
CONFIG / GLOBAL ROUTING
Global Routing과 Config의 적용 관계
현재 라우팅 모드를 확인한 뒤 규칙 결과 해석하기
Global Routing에서 자주 사용하는 세 가지 모드는 Config, Proxy, Direct입니다. Config는 현재 Config에 따라 요청을 처리하므로 분할 라우팅이 필요한 일반적인 사용에 적합합니다. Proxy는 프록시 경로를 기준으로 전체 동작을 비교할 때, Direct는 직접 연결 경로를 비교할 때 사용합니다. 이들은 라우팅 동작을 선택하는 모드이지 서버 프로토콜이나 네트워크 속도 등급이 아닙니다. 접속 결과가 예상과 다르면 Config의 특정 규칙만 보지 말고 먼저 현재 모드를 확인하세요.
| 모드 | 확인할 내용 | 일반적인 용도 |
|---|---|---|
| Config 모드 | 현재 파일, 정책 이름 및 규칙 매칭 순서 | 규칙 기반 분할 라우팅 확인 |
| Proxy 모드 | 선택한 서버 및 프록시 경로 연결 상태 | 일부 규칙의 영향 분리 |
| Direct 모드 | 현재 네트워크에서 직접 접속 가능한지 확인 | 직접 연결 결과와 비교 |
초기 모드는 기억에 의존하지 말고, 특히 기기를 바꾸거나 데이터를 복원한 뒤에는 Home에서 현재 선택을 직접 확인하세요. 서버가 정상 작동하는 것을 확인한 뒤에는 Config를 사용하고 구조가 명확한 구성을 유지하는 것이 좋습니다. 비교를 위해 Proxy나 Direct를 잠시 사용했다면 일상적인 모드로 되돌리세요. 화면에 Scene 등의 메뉴가 있다면 실제 기능을 별도로 확인하고 이 문서에서 설명하는 세 가지 모드 테스트와 하나의 스위치처럼 취급하지 마세요.
Rule은 위에서 아래로 매칭됩니다
Config에서는 규칙을 순서대로 확인하고 먼저 일치한 규칙이 해당 요청의 정책을 결정합니다. 따라서 구체적인 DOMAIN, DOMAIN-SUFFIX 규칙은 일반적으로 포괄적인 기본 규칙보다 앞에 두고 FINAL은 마지막에 배치합니다. 규칙에 지정한 정책 이름은 현재 Config에서 실제로 사용할 수 있어야 합니다. 아래의 PROXY는 연결할 프록시 정책의 예시일 뿐입니다. 이 단어를 복사했다고 서버 연결이 설정되는 것은 아닙니다. 예시를 사용하기 전에 자신의 Config 구조와 정책 이름을 확인하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT
이 예시는 도메인 접미사, 도메인 키워드, 주소 대역, 지리적 구분, 최종 규칙의 배치 관계를 보여 주며 모든 사용자에게 적합한 완성된 Config는 아닙니다. DOMAIN-SUFFIX는 해당 도메인과 하위 도메인에 적용되고, DOMAIN-KEYWORD는 범위가 더 넓어 이름에 해당 문자열이 포함된 다른 도메인에도 영향을 줄 수 있습니다. IP-CIDR은 주소 대역을 대상으로 하며 GEOIP는 사용할 수 있는 지리 정보 데이터에 따라 달라집니다. 이런 규칙이 서비스 도메인에 기반한 정확한 규칙을 그대로 대체하지는 않으며, 특정 서비스가 항상 같은 주소를 사용한다고 보장하지도 않습니다.
규칙을 변경한 뒤 새 요청으로 확인하기
Config를 저장하는 것과 해당 Config를 선택하는 것은 별개입니다. 파일을 편집한 뒤에는 실제 사용 중인 Config인지 확인하고 화면 안내에 따라 다시 불러오거나 연결을 재설정하세요. 이미 설정된 연결은 새 규칙에 따라 경로를 즉시 다시 선택하지 않을 수 있습니다. 확인할 때는 대상 앱의 기존 연결을 닫고 새 요청을 만든 뒤 로그에서 대상과 정책을 확인하세요. 웹페이지가 계속 열려 있다는 사실만으로 새 규칙이 적용됐다고 볼 수는 없습니다. 캐시를 사용했거나 기존 연결을 유지했을 수 있습니다.
같은 앱의 일부 콘텐츠만 정상이고 나머지는 실패한다면 앱 이름으로 임의의 공통 규칙을 만드는 대신 각 요청의 도메인을 따로 확인하세요. 로그인, 이미지, API, 미디어가 서로 다른 대상에서 제공될 수 있습니다. 먼저 로그에서 실패한 요청을 찾아 충분히 구체적인 매칭 방식을 선택하세요. 도메인 하나를 해결하려고 범위가 지나치게 넓은 키워드를 추가하지 마세요. USER-AGENT 등의 매칭에도 적용 조건이 있으므로 모든 트래픽에서 동일한 매칭 정보를 얻을 수 있다고 가정하면 안 됩니다.
기준 상태로 되돌릴 때는 파일 끝에 반대 규칙을 계속 추가하지 말고 저장해 둔 Config로 전환하는 것이 좋습니다. General, Rule, Host의 전체 구조를 이해하려면 Config 파일 섹션 설명을 읽어 보세요. Proxy 모드에서는 접속되지만 Config 모드에서는 안 된다면 우선 매칭된 정책을 확인합니다. 두 모드 모두 실패한다면 서버와 네트워크를 살펴보세요. 이 순서로 규칙 문제와 연결 문제를 구분하면 불필요한 반복 변경을 줄일 수 있습니다.
TOOLS / CONNECTIVITY TEST
Ping 및 Connectivity Test 결과 읽기
테스트 결과는 해당 테스트가 확인하는 내용만 보여 줍니다
Ping은 테스트 방식에 따라 측정 대상이 다릅니다. 어떤 방식은 호스트나 포트의 응답만 확인하고, 다른 방식은 프로토콜 핸드셰이크나 테스트 요청까지 포함할 수 있습니다. 응답 시간이나 실패 상태를 해석하기 전에 현재 테스트 방식의 설명을 확인하세요. 모든 값을 웹페이지 접속 전체에 걸리는 시간으로 보아서는 안 됩니다. 호스트가 응답해도 인증 매개변수가 올바르다는 뜻은 아니며, 프록시 핸드셰이크가 성공해도 특정 대상의 서비스 API까지 사용할 수 있다는 뜻은 아닙니다.
Connectivity Test는 특정 테스트 조건에서 연결할 수 있는지 확인하는 기능입니다. 테스트 주소, 시간 초과 설정, 선택한 서버, DNS, 현재 네트워크가 결과에 영향을 줍니다. 초기 테스트 방식과 주소는 기기에 표시되는 값을 기준으로 확인하세요. 이 문서에서는 확인되지 않은 공통 기본 URL을 지정하지 않습니다. 먼저 설명할 수 있는 현재 설정을 유지하고, 직접 안정성을 확인한 단순한 테스트 대상을 사용하세요. 실패하면 오류 유형을 기록하고 빨간색이나 빈 상태만으로 서버가 영구적으로 작동하지 않는다고 판단하지 마세요.
지연 시간, 처리량, 안정성을 따로 살펴보기
지연 시간은 한 번 왕복하거나 작업을 수행하는 데 걸리는 시간이고, 처리량은 지속적인 데이터 전송 능력이며, 안정성은 여러 번 관찰해야 판단할 수 있습니다. 한 번 낮은 값이 나왔다고 다운로드가 더 빠르다는 뜻은 아니며, 한 번 시간 초과가 발생했다고 이후 모든 요청이 실패하는 것도 아닙니다. 작은 요청도 순간적인 네트워크 혼잡, 기기 절전 후 복구, 도메인 캐시의 영향을 받을 수 있습니다. 서버를 비교할 때는 가능한 한 같은 테스트 방식과 대상, 비슷한 시간대를 사용하세요. 조건이 다른 결과를 한 줄로 세워 장기적인 결론을 내리지 마세요.
시간 초과 값을 너무 짧게 설정하면 일시적으로 느린 정상 연결을 실패로 판단할 수 있고, 너무 길게 설정하면 문제를 찾는 시간이 늘어납니다. 우선 현재의 합리적인 설정을 유지하고 로그에서 핸드셰이크가 자주 시간 초과 직전에 끝난다는 점이 확인될 때만 조정하세요. 변경 전후의 성공률을 기록합니다. 시간 초과를 무한정 늘려 지속적인 연결 거부나 인증 오류를 숨기지 마세요. 테스트 간격도 적절히 두어야 합니다. 촘촘하게 연속 테스트하면 기기와 네트워크 부하가 달라지고 서버 제한의 영향이 다음 결과에 나타날 수 있습니다.
| 테스트 현상 | 가능한 의미 | 이것만으로 단정할 수 없는 내용 |
|---|---|---|
| 호스트 응답 있음 | 해당 탐색 경로에 연결 가능 | 프록시 인증 및 대상 접속 정상 |
| 핸드셰이크 실패 | 프로토콜 또는 연결 단계 문제 | 반드시 DNS 문제 |
| 테스트 요청 성공 | 해당 대상에 당시 연결 가능 | 모든 웹사이트와 앱이 정상 |
| 간헐적 시간 초과 | 일시적인 실패가 발생함 | 서버를 장기간 사용할 수 없음 |
문제 위치를 찾을 수 있도록 테스트 단계 나누기
먼저 현재 네트워크가 정상적으로 작동하는지 확인한 다음 구독 항목의 주소, 포트, 프로토콜이 서비스 제공업체가 알려 준 정보와 일치하는지 살펴보세요. 이어서 서버 도메인을 확인할 수 있는지, 연결이 설정되는지, 인증이 통과하는지 확인하고 마지막으로 대상 요청을 테스트합니다. 각 단계는 해당 기록으로 확인하고 인증 단계를 건너뛴 채 분할 라우팅 규칙부터 변경하지 마세요. 추가 전송 또는 보안 매개변수가 필요한 프로토콜은 서비스 서버의 요구사항을 하나씩 확인하고 다른 항목의 값을 그대로 적용하지 마세요.
‘테스트는 성공했지만 앱이 열리지 않는’ 경우에는 실제 앱이 보내는 요청을 살펴보세요. 테스트 대상에는 다른 규칙이 적용될 수 있고, 테스트가 가벼운 주소 하나만 확인하는 동안 앱은 여러 도메인을 요청할 수도 있습니다. Global Routing과 매칭된 정책을 확인하고 Log에서 실패한 대상을 찾으세요. 반대로 테스트 주소에 연결할 수 없어도 실제 서비스는 정상일 수 있습니다. 이때는 이미 확인한 서버 정보를 삭제하지 말고 테스트 대상을 바꾸세요.
모든 항목이 동시에 실패한다면 공통 요소인 현재 네트워크, 시스템 VPN 권한, 테스트 대상, DNS부터 확인하세요. 한 항목만 실패할 때는 해당 항목의 입력값과 서버 상태를 확인합니다. 목록 순서를 바꾼다고 문제가 자동으로 해결되지는 않으며, 결과가 흔들릴 때 구독을 반복 갱신해 현재 상태를 덮어쓰지 마세요. 자주 묻는 오류에 대한 짧은 답변은 자주 묻는 질문에서 확인할 수 있습니다. 이 페이지의 로그 항목에서는 테스트 결과를 구체적인 연결 과정과 연결하는 방법을 설명합니다.
SETTINGS / LOG AND DATA
Log 및 Data: 기록을 쌓기보다 요청의 원인 찾기
문제를 재현하기 전에 로그 범위 준비하기
Log의 목적은 실패 시점을 구체적인 흐름과 연결하는 것이지, 기록을 많이 남기는 데 있지 않습니다. 켜기 전에 ‘도메인이 확인되는가’, ‘어떤 규칙이 매칭되는가’, ‘핸드셰이크가 어느 단계에서 실패하는가’처럼 확인할 질문을 정하세요. 플랫폼과 화면에 따라 사용할 수 있는 기록 수준이 다를 수 있으므로 기본 수준은 현재 설정을 확인하세요. 필요한 질문에 답할 수 있는 가장 낮은 수준을 사용하고, 일반 기록만으로 부족할 때에만 상세 기록을 잠시 높인 다음 문제 해결 후 평소 설정으로 되돌리세요.
문제를 재현하기 전에 현재 시간, 네트워크 유형, Global Routing, Config 이름, 선택한 서버의 로컬 메모를 기록하세요. 로그가 너무 많다면 보존할 필요가 없는지 확인한 뒤 정리하고 실패한 페이지 하나를 여는 등 최소한의 작업만 수행합니다. 여러 앱을 동시에 실행하고 속도 테스트와 구독 갱신까지 하지 마세요. 요청이 뒤섞이면 같은 초에 발생한 실패를 구분하기 어렵습니다. 기기 시간이 정확하지 않다면 기록을 비교하기 전에 시간을 먼저 맞추세요.
이름 확인, 정책, 연결 순서로 읽기
먼저 대상 도메인이나 주소를 찾아 이름 확인 결과가 있는지 살펴보고 실제 적용된 정책을 확인한 뒤 연결 및 인증 결과를 확인하세요. 대상이 기록에 전혀 없다면 요청이 발생하지 않았거나 대상 프로그램이 캐시를 사용했거나 현재 로그 범위가 해당 요청을 포함하지 않을 수 있습니다. 클라이언트가 요청을 버렸다고 바로 단정하지 마세요. 대상 프로그램을 종료하고 연결을 다시 설정해 재현한 뒤 시스템 VPN 상태와 앱 스위치가 일치하는지 확인하세요.
시간 초과가 발생했다면 이름 확인, 연결 설정, 대상 응답 대기 중 어느 단계에서 발생했는지 확인하세요. 연결이 거부되면 대상 포트와 서버의 수신 상태를 살펴봅니다. 인증 또는 보안 핸드셰이크 오류라면 프로토콜 매개변수, 시스템 시간, 서버 요구사항을 확인하세요. 비슷한 오류 문구가 같은 원인을 뜻하지는 않습니다. 안내를 없애려고 보안 검증을 임의로 낮추지 말고, 인증 정보가 포함된 전체 기록을 외부에 보내지 마세요. 실패 단계를 설명하는 데 필요한 최소 부분만 추리세요.
Data 통계의 의미와 한계
Data의 트래픽 통계는 실제 전송이 발생했는지 살펴보는 데 도움이 되지만 특정 서비스 작업이 성공적으로 끝났다는 점을 단독으로 증명하지는 않습니다. 연결 설정, 재시도, 백그라운드 새로 고침, 프로토콜 오버헤드도 데이터를 발생시킬 수 있습니다. 통계 범위는 실제 화면 설명을 확인하세요. 앱 내부 카운터를 통신사 청구 내역으로 보거나 한 세션의 수치를 설치 이후 누적량으로 간주하지 마세요. 통계를 초기화하기 전에 시점을 기록하고 이후에도 같은 범위끼리 비교하세요.
연결은 켜져 있지만 Data가 거의 늘지 않는다면 먼저 대상 프로그램이 새 요청을 실제로 보냈는지 확인한 뒤 라우팅과 기록 범위를 살펴보세요. Data가 계속 늘어도 페이지가 실패한다면 해당 실패 요청을 찾아야 합니다. 이 수치만으로 ‘연결은 정상’이라고 판단할 수 없습니다. 백그라운드 앱, 시스템 서비스, 자동 재시도도 데이터를 발생시킬 수 있습니다. 관련 없는 대상을 닫고 최소한으로 한 번 재현하는 편이 총 트래픽 수치를 오래 지켜보는 것보다 문제를 찾기 쉽습니다.
| 기록 내용 | 문제 확인 목적 | 공유 전 처리 |
|---|---|---|
| 대상 도메인 및 시간 | 실제로 실패한 작업 확인 | 내부 이름 및 쿼리 매개변수 가리기 |
| 정책 및 오류 발생 단계 | 규칙, 이름 확인, 연결 문제 구분 | 필요한 맥락만 남기기 |
| 서버 및 인증 정보 | 입력값을 로컬에서 확인 | 주소, 비밀번호, 키 숨기기 |
| Data 통계 변화 | 같은 시간대의 전송 확인 | 통계 시작 시점과 범위 설명 |
내보내기, 보관 및 문제 해결 마무리
로그에는 접속 대상, 서버 주소, 구독 요청, 기기 환경 정보가 포함될 수 있습니다. 내보내기 전에 로컬에서 내용을 확인하고 비밀번호, 키, 전체 구독 링크와 쿼리 매개변수를 숨기세요. 오류 주변 몇 줄만 필요하다면 전체 기록을 보내지 마세요. 스크린샷도 상단, 사이드바, 공유 패널에 메모로 저장한 이름이 보이지 않는지 확인해야 합니다. 유효한 인증 정보가 이미 노출됐다면 이미 보낸 이미지만 삭제하지 말고 해당 서비스 제공업체에 연락해 인증 정보를 처리하세요.
문제 해결을 마치면 ‘어떤 네트워크에서 어떤 설정 때문에 어느 단계에서 실패했고, 변경을 취소한 뒤 복구됐는지’ 형태로 결론을 기록하세요. 필요한 기록 조각과 검증된 Config를 저장하고, 더 이상 필요 없는 민감한 내보내기 파일을 정리한 뒤 상세 로그를 평소 수준으로 되돌립니다. 그러면 다음에 비슷한 현상이 발생했을 때 모든 옵션을 다시 시험하지 않고 기존 판단 절차를 활용할 수 있습니다. 결론이 재현 가능한 결과와 연결될 때 로그가 진단 역할을 마칩니다.
SETTINGS / WIDGET AND ICLOUD
Widget, iCloud 동기화 및 기기 변경 후 복원
Widget은 바로가기이며 별도 Config가 아닙니다
Widget은 시스템이 허용하는 위치에 상태나 빠른 작업을 제공합니다. 구체적인 크기, 버튼, 새로 고침 방식은 기기에서 제공하는 항목을 기준으로 확인하세요. 별도의 서버 설정이 아니며 백그라운드에서 계속 갱신되는 완전한 모니터링 화면도 아닙니다. 처음 사용할 때는 앱에서 연결 설정을 완료한 뒤 시스템에서 제공하는 Widget을 추가하세요. 시스템에 해당 구성요소를 추가하는 메뉴가 없다면 다른 플랫폼의 데스크톱 위젯 절차를 그대로 따라 하지 마세요.
Widget 표시는 시스템의 새로 고침 시점에 따라 달라질 수 있습니다. 표시 상태가 예상과 다르면 구성요소의 한 줄 문구만 보고 연결이 끊겼다고 판단하지 말고 Shadowrocket을 열어 실제 연결 상태와 시스템 VPN 상태를 확인하세요. Widget에서 연결을 전환한 뒤에는 시스템 처리가 끝날 때까지 기다린 다음 결과를 살펴봅니다. On Demand 조건이 계속 충족되는 상태에서 수동 연결 후 다시 연결되는 문제는 On Demand 항목에서 확인하세요. Widget을 삭제했다가 반복해서 다시 추가할 필요는 없습니다.
동기화 전에 대상 데이터 범위를 명확히 하기
iCloud 동기화는 Apple 기기에서 제공되는 관련 기능이며 앱이 해당 클라우드 서비스를 사용할 수 있도록 기기에서 허용해야 합니다. 모든 플랫폼에 공통으로 적용되는 계정 동기화로 설명하지 않습니다. 초기 스위치 상태, 동기화 가능한 항목, 현재 기기 조건은 실제 화면을 확인하세요. 켜기 전에 시스템의 클라우드 계정이 올바른지, 저장 공간이 있는지, 네트워크가 정상인지 확인합니다. 시스템 로그인이 성공했다고 앱 데이터 전송이 끝난 것은 아니며 모든 로컬 파일이 자동으로 동기화된다는 뜻도 아닙니다.
서버 항목, 구독, Config, 환경설정이 다른 기기에 나타나는지 각각 확인하세요. 그중 하나가 표시됐다는 이유만으로 전체 이전이 완료됐다고 보지 마세요. 특히 내보낸 Config 파일과 서버 목록을 구분해야 합니다. 파일 하나로 규칙을 복원할 수 있어도 인증 정보 전체가 포함된다는 뜻은 아닙니다. 구독 링크를 통해 항목을 다시 가져올 수 있어도 로컬에서 수동으로 변경한 내용까지 복원되는 것은 아닙니다. 먼저 보존해야 하는 항목을 목록으로 만든 뒤 동기화나 내보내기 방법을 선택하세요.
동기화는 과거 데이터 백업이 아닙니다
동기화로 인해 삭제와 변경 내용이 다른 기기에 반영될 수 있으므로 별도로 저장한 복구 사본을 대신할 수 없습니다. 여러 항목을 정리하기 전에 중요한 Config를 내보내고 구독 정보를 본인이 관리하는 안전한 위치에 보관하세요. 두 기기에서 같은 내용을 동시에 편집하면 덮어쓰기나 중복이 생길 수 있습니다. 한 기기를 이번 변경의 기준으로 정하고 다른 기기에서 확인을 마친 뒤 추가로 편집하는 것이 좋습니다. 동기화 상태를 확인하기 전에 같은 항목을 번갈아 이름 변경하거나 삭제하지 마세요.
클라우드에 예상한 데이터가 없다면 먼저 같은 계정으로 로그인했는지, 앱의 클라우드 권한이 허용됐는지, 네트워크가 정상인지 확인한 뒤 동기화가 완료될 때까지 기다리고 항목을 하나씩 살펴보세요. 동기화를 서두르려고 스위치를 반복해서 끄고 켜거나 계정에서 로그아웃하거나 로컬 데이터를 지우지 마세요. 현재 상태가 바뀌고 아직 전송되지 않은 유일한 사본이 사라질 수 있습니다. 충돌이 발생하면 먼저 양쪽 데이터를 각각 저장한 다음 차이를 비교하고, 기기의 연식만으로 판단하지 말고 유효한 내용을 확인해 선택하세요.
기기 변경 후 확인 순서
새 기기에서 먼저 앱이 열리는지 확인한 뒤 데이터를 복원하고 현재 Config, 선택한 서버, Global Routing을 살펴보세요. 서버 메모 이름이 같아도 매개변수까지 같다는 뜻은 아닙니다. 필요하면 주소, 포트, 프로토콜을 서비스 제공업체의 요구사항과 비교하세요. 처음 연결할 때 시스템 권한이 필요할 수 있으므로 안내에 따라 허용해야 합니다. Config 파일을 복원해도 이 권한 절차를 대신할 수는 없습니다. 테스트가 성공하기 전에 이전 기기의 사본을 삭제하거나 이전 기기의 시스템 권한 상태가 일반 환경설정처럼 동기화된다고 가정하지 마세요.
마지막으로 수동 연결, 대상 접속, 연결 해제, 네트워크 전환을 한 번씩 확인한 뒤 On Demand와 Widget을 다시 설정하세요. 항목이 중복되면 수동으로 가져온 항목인지 구독 갱신으로 생긴 항목인지 먼저 확인합니다. 전체 이전 절차는 백업 및 기기 변경 안내에서 확인할 수 있습니다. 검증을 마친 Config 사본을 별도로 보관하고 클라우드 목록이 온전해 보이는지에만 의존하지 말고 복원에 필요한 정보 유형을 기록하세요.
SETTINGS / LOCAL PROXY
Proxy 포트, 로컬 네트워크 접속 및 최종 확인
로컬 수신 포트와 서버 포트는 다릅니다
Proxy 관련 로컬 포트는 같은 기기나 허용된 기기의 요청을 받아 클라이언트에서 처리하는 데 사용합니다. Add Server에 입력하는 포트는 원격 서버가 연결을 받는 포트입니다. 두 포트의 역할은 다르므로 숫자를 맞추려고 변경하지 마세요. 원격 포트는 서비스 제공업체가 알려 준 정보와 일치해야 하고 로컬 수신 포트는 연결할 프로그램의 설정과 맞아야 합니다. 초기 포트 값은 현재 플랫폼의 화면을 확인하세요. 모든 시스템에서 함께 사용하는 고정값을 이 문서에서 지정하지 않으며 이 기능을 사용하지 않는 사용자가 켤 필요도 없습니다.
로컬 포트는 수신하는 프록시 유형도 구분해야 합니다. HTTP와 SOCKS5의 연결 방식은 다르므로 대상 프로그램에서 수신기와 같은 유형을 선택해야 합니다. 한 유형의 포트를 다른 프로토콜의 입력란에 넣으면 연결된 것처럼 보이지만 요청을 완료하지 못할 수 있습니다. 유형, 수신 주소, 포트를 확인한 뒤 테스트하세요. 옵션 이름에 Proxy가 있다고 모든 프로토콜을 받을 수 있다고 가정하지 마세요. 로컬 프로그램에 프록시 설정이 없다면 해당 프로그램이 실제로 지원하는 기능을 확인하고 Shadowrocket에 없는 호환 옵션을 만들어내지 마세요.
루프백 주소와 로컬 네트워크 주소의 차이
루프백 주소는 현재 기기 자신을 가리킵니다. 다른 기기에서 그 기기 자신의 루프백 주소를 사용해도 Shadowrocket이 실행 중인 기기에 연결되지 않습니다. 로컬 네트워크에서 접속해야 한다면 실행 중인 기기의 네트워크에서 접근 가능한 주소를 사용하고 수신 범위, 시스템 방화벽, 기기 간 통신 허용 여부를 확인하세요. 관련 기능을 제공하는 플랫폼은 실제 옵션을 기준으로 판단해야 합니다. 데스크톱의 수신 방식을 모바일 기기에도 그대로 적용할 수는 없습니다.
평소에는 실제로 필요한 범위만 열어 두는 것이 좋습니다. 같은 기기의 프로그램만 사용할 경우 수신 범위를 기기 내부로 제한하세요. 로컬 네트워크 접속이 필요하다면 이해하고 관리하는 네트워크에서만 활성화하고 사용 가능한 옵션으로 접근을 제한합니다. 수신 서비스를 공용 네트워크에 직접 노출하거나 한 번의 연결 실패를 해결하려고 시스템 보호 기능을 모두 끄지 마세요. 무선 네트워크에서 기기 간 격리가 설정되어 있으면 두 기기가 같은 이름의 Wi-Fi에 연결되어도 서로 접속하지 못할 수 있습니다.
| 매개변수 유형 | 일치시켜야 할 대상 | 흔한 오해 |
|---|---|---|
| 원격 서버 포트 | 직접 이용하는 서비스 제공업체의 설정 | 로컬 수신 포트로 잘못 변경 |
| 로컬 수신 포트 | 접속 프로그램의 프록시 설정 | 다른 프로그램이 이미 포트를 사용 중 |
| 수신 주소 | 기기 내부 또는 로컬 네트워크의 접속 범위 | 루프백 주소로 다른 기기에 연결 |
| 프록시 유형 | HTTP 또는 SOCKS5 수신 방식 | 유형을 무시하고 포트 숫자만 확인 |
기기 내부, 로컬 네트워크, 대상 요청 순으로 점검
포트를 사용할 수 없다면 먼저 수신 기능이 켜져 있고 설정이 저장됐으며 다른 프로그램이 포트를 사용하지 않는지 확인하세요. 이어서 프로토콜에 맞는 방식으로 같은 기기에서 테스트해 요청이 Log에 나타나는지 확인합니다. 같은 기기에서 성공한 뒤에만 다른 기기에서 테스트하세요. 다른 기기에서는 실패하지만 같은 기기에서 정상이라면 주소, 수신 범위, 방화벽, 네트워크 격리를 먼저 살펴봅니다. 이 순서로 점검하면 로컬 네트워크 연결 문제를 프록시 서버 문제로 오해하거나 이미 정상인 연결 항목을 변경하는 일을 줄일 수 있습니다.
요청이 클라이언트에 도달했는데도 실패한다면 로컬 포트를 계속 바꾸지 말고 Global Routing, 매칭 규칙, 이름 확인 결과, 원격 연결을 확인하세요. 포트는 요청을 받는 입구일 뿐 이후 모든 단계의 성공을 보장하지 않습니다. 특히 시스템 프록시가 로컬 수신기를 가리키고 상위 설정에서 요청을 다시 같은 입구로 보내면 요청이 반복 전달되거나 실패할 수 있습니다. 시스템 수준 프록시를 추가하기 전에 요청 흐름을 정리하고 원래 설정으로 되돌릴 수 있도록 보존하세요.
설정 변경은 한 번의 점검 절차로 마무리하기
조정을 마친 뒤 정해 둔 순서로 다시 확인하세요. 현재 네트워크를 확인하고 서버 정보를 점검한 다음 수동 연결, DNS와 규칙, 실제 요청, Log와 Data를 차례로 살펴봅니다. 마지막으로 필요한 On Demand, Widget, 동기화 환경설정을 복원하세요. 검증을 통과한 변경만 남기고 결과가 나아지지 않은 옵션은 되돌립니다. 특정 앱에서만 실패한다면 해당 앱의 대상과 오류 단계를 기록하고 일부 문제 때문에 전체 Config를 다시 작성하지 마세요.
장기적으로 설정을 관리할 때는 스위치 목록만 남기지 말고 용도와 확인 방법을 함께 기록하세요. DNS 경로를 지정한 이유, 먼저 적용해야 하는 규칙, 로컬 프로그램이 사용하는 수신 포트, 기기 이전 후 확인할 항목을 적어 두면 됩니다. 새로운 문제가 생기면 해당 설정 계층부터 살펴본 뒤 자주 묻는 질문이나 초보자를 위한 10문 10답을 확인하세요. 이 참고 자료의 목적은 유지하는 각 설정에 분명한 역할과 관찰 가능한 결과, 실행 가능한 복구 방법을 갖추는 것입니다.