01 / SETTINGS
Settings의 설정 범위와 기본값 확인
서버, 구성 파일, 앱 설정을 먼저 구분하세요
Shadowrocket의 동작은 하나의 스위치만으로 결정되지 않습니다. Home에는 서버 정보나 Subscribe로 가져온 자료가 저장되고, Config에서는 규칙과 관련 설정을 관리하며, Settings에는 앱 전반의 동작과 도구 옵션이 있습니다. 시스템의 VPN 및 네트워크 권한과 현재 연결된 Wi-Fi 또는 모바일 네트워크도 영향을 줍니다. 문제를 해결할 때는 변경이 어느 범위에 해당하는지 먼저 확인하세요. 서버 주소 오류는 서버 정보에서, 도메인 연결 경로 문제는 규칙에서, 자동 재연결 문제는 On Demand에서 살펴봐야 합니다. 모든 문제를 Settings 탓으로 돌려서는 안 됩니다.
같은 이름의 항목이 앱 설정과 구성 파일 양쪽에 있을 수도 있습니다. 예를 들어 DNS는 현재 Config 설정과 시스템 네트워크 환경의 영향을 모두 받을 수 있습니다. Settings에 표시된 값만으로 실제 연결에 그 값만 적용된다고 단정할 수 없습니다. 먼저 현재 Global Routing, 선택된 서버, 사용 중인 Config를 기록하세요. 다음으로 구성 파일에 관련 매개변수가 설정되어 있는지 확인하고 마지막으로 앱 설정을 살펴보세요. 실제 적용되는 설정의 출처를 확인해야 이후 비교가 의미 있습니다.
‘기본값’이 현재 화면에 표시된 값을 뜻하지는 않습니다
특정 기기의 초기 상태를 모든 기기의 고정된 출고 기본값으로 간주하지 않습니다. 앱 업데이트, 이전 설정 마이그레이션, 구독에 포함된 구성, 백업 복원에 따라 현재 값이 달라질 수 있으며, 일부 항목의 이름이나 선택 범위는 플랫폼별로 다릅니다. 모든 기기에 공통으로 적용되는 값을 확인할 수 없는 설정은 임의의 숫자를 제시하지 않고 ‘현재 정상 작동하는 상태 유지’를 권장 기준으로 삼습니다. 화면에 명확한 초기화 옵션이 있다면 먼저 백업하고, 초기화 전후의 차이를 기록하세요.
기준 상태를 기록할 때는 로컬 메모에 네트워크 유형, Global Routing, 현재 Config 이름, 서버 별칭, 이번에 변경할 항목을 적어 두세요. 비밀번호, 전체 구독 주소, PrivateKey 등은 공유용 메모에 기록하지 마세요. 테스트 전에는 기존에 접속할 수 있었던 대상을 하나 정하고, 변경 후에도 같은 대상을 테스트하세요. 웹사이트와 네트워크, 서버를 동시에 바꾸지 마세요. 결과가 좋아져도 어떤 변경이 영향을 주었는지 알 수 없게 됩니다.
| 범위 | 주요 항목 | 권장 기준 |
|---|---|---|
| Home | 서버, Subscribe, 현재 선택 항목 | 정상 작동을 확인한 기록 하나를 유지 |
| Config | 규칙, DNS 및 구성 참조 | 사용 가능한 파일을 직접 덮어쓰지 말고 복사본에서 수정 |
| Settings | 테스트, 로그, 동기화 및 로컬 동작 | 현재 문제와 관련된 항목만 조정 |
| 시스템 설정 | VPN, 네트워크 권한, 백그라운드 조건 | 실제 안내에 따라 필요한 권한 부여 |
모든 변경을 되돌릴 수 있도록 준비
편집하기 전에 현재 Config를 내보내거나 복사하세요. 서버 정보를 다루는 경우에는 원래 자료로 복원할 수 있는지도 확인해야 합니다. Home 목록의 스크린샷만 저장하지 마세요. 대개 전체 매개변수가 담기지 않습니다. 다음으로 한 번에 하나의 변수만 변경하고, 필요에 따라 연결을 끊었다가 다시 연결한 뒤 새 설정이 적용되었는지 확인하세요. 파일을 수정했지만 선택하지 않은 경우는 변경 사항이 적용되지 않는 흔한 원인입니다. 파일 이름만 확인하지 말고 실제 내용도 살펴보세요.
변경 후 문제가 생기면 다른 설정을 계속 추가하기보다 방금 변경한 값부터 복원하세요. 복원 후 다시 테스트하여 설정을 되돌렸을 때 문제가 사라지는지 확인해야 관련성을 판단할 수 있습니다. 해당 항목을 찾을 수 없다면 이름이 비슷한 옵션을 보고 기능을 추측하지 말고, 용어 가이드에서 의미를 확인하세요. 여러 사람이 사용하는 기기를 관리할 때는 이번 변경이 어떤 연결에 영향을 주는지 알려 다른 사용자가 테스트 중 서버나 설정을 바꾸지 않도록 하세요.
02 / ROUTING
Global Routing과 Config 규칙 우선순위
구성, 프록시, 직접 연결은 각각 무엇을 바꾸나요?
Global Routing은 요청을 전반적으로 처리하는 방식을 정합니다. 구성은 Config를 사용해 현재 구성의 규칙에 따라 요청 경로를 정합니다. 프록시는 Proxy를 사용하며, 선택한 프록시 경로를 통해 요청을 처리할 수 있는지 짧게 확인할 때 유용합니다. 직접 연결은 Direct를 사용해 현재 네트워크에서 직접 접속한 결과를 비교합니다. 세 가지는 속도 등급이 아니며, ‘전역’일수록 더 완전한 설정이라는 뜻도 아닙니다. 일반적으로 규칙에 따라 트래픽을 분리하려면 Config를 사용하고, 문제를 진단할 때만 나머지 두 방식을 임시로 비교에 활용하세요. 테스트가 끝나면 원래 선택으로 되돌리세요.
여기서 말하는 Config 방식과 하단의 Config 페이지는 구분해야 합니다. 전자는 규칙에 따라 처리할지 결정하고, 후자는 실제 구성 파일을 관리합니다. 구성 파일을 편집하고 선택했더라도 Global Routing이 Proxy라면 도메인 규칙이 제대로 적용되는지 판단할 수 없습니다. 반대로 Config 상태에서 접속에 문제가 생겨도 서버가 작동하지 않는다고 바로 단정할 수 없습니다. 요청이 앞선 DIRECT 또는 REJECT 규칙에 따라 처리되어 예상한 프록시 경로를 거치지 않았을 수 있습니다.
| 한국어 설명 / 인터페이스 용어 | 확인 목적 | 이 결과만으로 확인할 수 없는 사항 |
|---|---|---|
| 구성 / Config | 현재 구성의 규칙 매칭 결과 확인 | 모든 요청이 선택한 서버를 거친다는 점 |
| 프록시 / Proxy | 선택한 프록시 경로의 사용 가능 여부 비교 | Config의 모든 규칙이 올바르다는 점 |
| 직접 연결 / Direct | 현재 네트워크에서 직접 접속한 결과 비교 | 모든 대상이 직접 연결에 적합하다는 점 |
이름으로 용도를 추측하지 말고 순서대로 규칙 확인
규칙은 일반적으로 구성에 적힌 순서대로 매칭되며, 먼저 일치한 규칙이 해당 요청을 처리합니다. DOMAIN은 정확한 도메인, DOMAIN-SUFFIX는 도메인 접미사, IP-CIDR 및 IP-CIDR6은 IP 주소 대역, GEOIP는 IP 지리 데이터베이스에 따른 분류에 사용됩니다. FINAL은 앞선 규칙과 일치하지 않은 요청을 처리합니다. DOMAIN-SUFFIX에는 프로토콜이 포함된 전체 URL을 입력하거나 경로와 쿼리 매개변수를 함께 넣지 마세요. 기본 도메인과 하위 도메인을 구분해야 한다면 먼저 매칭 범위를 정한 뒤 키워드를 선택하세요.
아래 예시는 문법과 순서를 보여 줍니다. 첫 번째 도메인 접미사는 PROXY로 보내고, 이어서 GEOIP 조건에 맞는 요청은 DIRECT로 처리하며, 나머지는 FINAL에 지정된 PROXY를 사용합니다. 이 예시는 모든 사용자에게 적합한 완성형 구성도 아니고 서버 인증 정보도 포함하지 않습니다. GEOIP 규칙은 확인된 IP 주소와 데이터베이스 결과에 영향을 받을 수 있으므로, 명확한 서비스 도메인 판단을 대신할 수 없습니다. 어떤 대상이 앞선 도메인 규칙과 뒤의 주소 규칙에 모두 해당하더라도 뒤쪽 정책만 보고 순서를 무시해서는 안 됩니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
실제 요청으로 규칙 매칭 확인
도메인을 확인할 때는 현재 구성에서 정확한 도메인과 상위 접미사, 관련 규칙 참조를 검색하여 먼저 일치하는 항목이 있는지 확인하세요. 그런 다음 테스트에 영향을 주는 요소를 줄이세요. 대상 페이지를 닫았다가 요청을 다시 보내고, 필요하면 연결을 끊었다가 다시 연결하여 기존 연결이 계속 사용되지 않도록 합니다. 브라우저 페이지 하나가 여러 도메인을 호출할 수 있으므로 본문은 열리지만 이미지가 실패해도 사이트 전체에 규칙 하나만 적용된다는 뜻은 아닙니다. 로그에서 실제로 실패한 호스트 이름을 찾아 각각 확인하세요.
먼저 구성 복사본에 범위가 명확한 테스트 규칙을 추가하고 매칭을 확인한 다음 정식 파일에 반영할지 결정하세요. 도메인 하나를 해결하려고 FINAL의 정책을 임의로 바꾸지 마세요. 일치하지 않는 모든 요청에 영향을 줍니다. 기본 정책은 기존 구성의 용도를 확인해 정해야 하며, 언제나 옳은 범용 값은 없습니다. Proxy 방식에서는 접속되고 Config 방식에서는 실패한다면 규칙 매칭, DNS, 정책 대상을 먼저 비교하세요. 두 방식 모두 실패하면 서버, 인증 정보, 네트워크를 점검하세요.
규칙을 업데이트한 뒤에는 원격 리소스를 정상적으로 가져왔는지, 구성을 다시 불러왔는지도 확인하세요. Subscribe에서 서버 목록을 업데이트하는 것과 Config에서 규칙을 업데이트하는 것은 별개의 작업입니다. 목록 새로고침이 성공했다고 규칙도 적용된 것은 아닙니다. 먼저 기본 연결을 완료한 다음 규칙 매칭을 살펴보려면 가이드의 Global Routing 단계에 따라 기준 상태를 설정하세요. 전용 키워드는 용어 가이드에서 확인하고, 중국어 메모만 보고 규칙의 의미를 추측하지 마세요.
03 / DNS
DNS 해석, 캐시 및 요청 경로
DNS는 도메인 이름을 해석할 뿐, 모든 트래픽을 결정하지 않습니다
DNS는 도메인 이름을 사용할 수 있는 주소로 변환하며, 연결 과정의 일부입니다. DNS 해석에 성공해도 대상 포트에 연결할 수 있거나 TLS 핸드셰이크가 성공하거나 웹페이지 리소스가 모두 로드된다는 뜻은 아닙니다. 반대로 웹페이지가 열리지 않아도 반드시 DNS 문제인 것은 아닙니다. 서버 인증 실패, 잘못된 규칙 경로 또는 대상 서비스 장애가 원인일 수 있습니다. 설정을 바꾸기 전에 문제가 어느 단계에서 발생하는지 확인하세요. 모든 실패를 해결하려고 DNS 서버를 계속 바꾸지 마세요.
현재 Config에 DNS가 명시되어 있는지 먼저 확인한 다음 Settings의 관련 항목을 살펴보세요. 특별한 필요가 없다면 현재 정상 작동하는 설정을 유지하고, 특정 공용 DNS 주소를 모든 네트워크에 통용되는 정답으로 간주하지 마세요. 시스템 DNS, 수동 지정 DNS, 암호화된 DNS는 각각 연결 가능 조건이 다릅니다. DNS 서버 자체도 현재 네트워크 경로에서 접근할 수 있어야 합니다. 접근할 수 없는 주소를 추가하면 원래 웹사이트 하나에서만 발생하던 문제가 여러 도메인으로 번질 수 있습니다.
기본 상태와 권장 기준 기록 방법
DNS의 기본 상태는 현재 설치된 앱과 Config, 실제 시스템 네트워크에 표시되는 값을 기준으로 확인하세요. 기록할 때는 주소뿐 아니라 시스템, 앱 설정, 구성 파일 중 어디에서 가져온 값인지도 적어 두세요. 주소를 여러 개 입력했다면 순서와 관련 옵션도 빠짐없이 기록해야 합니다. 아래에서는 system을 시스템 DNS를 사용하는 구성 표기 예로 제시합니다. 모든 기기의 기본 구성 파일에 해당 줄이 있다는 뜻은 아닙니다. 예시를 기존 전체 구성 파일에 그대로 덮어쓰지 마세요. 특히 기존 서버와 규칙 항목을 삭제하지 않도록 주의하세요.
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
문제 해결을 위한 권장 기준은 접근 가능한 DNS 설정 하나를 유지하고 DNS 관련 옵션을 여러 개 동시에 변경하지 않는 것입니다. 시스템 DNS에서 수동 DNS로 바꾼다면 같은 도메인과 네트워크, 서버를 사용해 다시 테스트하고 반환된 주소가 달라졌는지 확인하세요. 주소가 달라졌다고 해서 반드시 오류는 아닙니다. 같은 서비스라도 위치와 부하에 따라 다른 결과를 반환할 수 있습니다. 응답 결과와 후속 연결, 실제 접속 결과를 함께 비교해야 변경 효과를 판단할 수 있습니다.
캐시, IPv6 및 로컬 네트워크 이름
DNS 캐시는 앱, 시스템, 접속 도구의 서로 다른 계층에 저장될 수 있습니다. 설정을 바꾼 뒤에도 이전 주소가 보인다고 해서 설정이 적용되지 않았다고 단정할 수 없습니다. 기존 연결이 닫히지 않았거나 캐시가 유효한 상태일 수도 있습니다. 현재 화면에 캐시 삭제 기능이 있다면 이전 결과를 기록한 뒤 사용하고, 다시 연결하여 새 요청을 보내세요. 해당 기능이 없다면 숨겨진 조작법을 추측하지 마세요. 웹페이지를 새로고침해도 기존 연결을 재사용할 수 있으므로 로그를 통해 새 DNS 해석과 연결이 실제로 이루어졌는지 확인하세요.
IPv4와 IPv6 주소를 모두 반환하는 대상은 한쪽 주소로 접속된다고 해서 전체가 정상이라고 판단할 수 없습니다. 네트워크에서 IPv6 주소를 제공하더라도 대상 연결이 안정적으로 완료되지 않을 수 있고, 특정 주소 계열만 제한될 수도 있습니다. 문제를 진단할 때는 실제 연결 주소와 주소 유형을 기록하고 동일한 조건에서 결과를 비교하세요. 처음부터 특정 주소 계열을 영구적으로 비활성화하는 해결책을 쓰지 마세요. 로컬 네트워크 호스트 이름, 라우터 관리 주소, 조직 내부 도메인을 사용하는 경우 현재 네트워크 전용 DNS에 의존하는지도 확인해야 합니다.
외부 DNS를 사용하도록 바꾸면 로컬 네트워크 이름이 올바르게 해석되지 않을 수 있습니다. 그렇다고 원격 서버 정보가 잘못된 것은 아닙니다. 먼저 원래 네트워크에서 해당 이름에 직접 접속되는지 확인한 다음 내부 트래픽이 부적절한 경로를 따르도록 규칙이 설정되어 있는지 살펴보세요. 네트워크 로그인 페이지는 시스템 DNS와 리디렉션 조건에 의존할 수 있으므로 네트워크 인증이 끝나기 전에 DNS를 크게 바꾸지 않는 편이 좋습니다. 네트워크 접속을 완료한 뒤 Shadowrocket 테스트를 다시 진행하면 환경 문제와 설정 문제를 더 쉽게 구분할 수 있습니다.
04 / ON DEMAND
On Demand와 연결 수명 주기
자동 연결과 규칙 기반 트래픽 분리를 구분하세요
On Demand는 설정된 조건에 따라 연결 동작을 시작하는 기능으로, 연결 수명 주기를 관리합니다. Global Routing은 연결이 설정된 뒤 요청을 처리하는 방식을 결정합니다. 두 기능은 같은 스위치가 아닙니다. On Demand를 켜도 잘못된 서버 정보가 수정되거나 완전한 트래픽 분리 규칙이 자동으로 만들어지지는 않습니다. 사용하기 전에 수동 연결 상태에서 서버, Config, 대상 접속이 정상인지 확인하세요. 그렇지 않으면 같은 실패 과정이 반복되어 문제 해결이 어려워질 수 있습니다.
기본적으로 활성화되어 있는지는 현재 기기의 화면과 시스템 VPN 설정을 기준으로 확인하세요. 특히 백업을 복원했거나 기기를 교체한 경우에는 주의해야 합니다. 문제를 진단하는 동안에는 잠시 수동 연결을 사용하고 On Demand의 원래 활성화 상태와 조건을 기록한 뒤 네트워크 전환을 테스트하는 것이 좋습니다. 수동 연결이 안정적으로 작동하면 실제 필요에 따라 자동 연결 조건을 하나씩 복원하세요. ‘항상 연결’되는 것처럼 보이게 하려고 모든 조건을 검증 없이 켜지 마세요. 조건이 많을수록 서로 어떻게 매칭되는지 명확히 확인해야 합니다.
네트워크 전환 후 다시 연결될 수 있는 이유
Wi-Fi에서 모바일 네트워크로 전환하면 로컬 주소와 라우팅, 사용 가능한 DNS가 달라질 수 있어 기존 연결을 다시 설정해야 할 수 있습니다. 이때 상태가 잠시 변하더라도 설정이 손상되었다는 뜻은 아닙니다. 현재 연결 과정이 끝날 때까지 기다린 뒤 실제 요청을 확인하세요. 네트워크를 전환할 때마다 실패하지만 원래 네트워크에서는 계속 정상적으로 작동한다면 자동 연결 스위치만 바꾸지 말고 두 네트워크에서 서버 주소와 포트, DNS 경로에 접근할 수 있는지 비교하세요. 자동 연결은 시도를 시작할 수 있을 뿐, 네트워크 환경 자체를 바꾸지는 않습니다.
설정에서 Wi-Fi 이름이나 네트워크 유형별로 연결 조건을 지정했다면 현재 연결이 실제로 조건을 충족하는지 먼저 확인하세요. 이름이 비슷한 두 Wi-Fi가 동일한 규칙 범위에 속한다고 볼 수 없으며, 시스템이 관련 네트워크 정보를 앱에 제공하는지도 권한과 시스템 동작에 따라 달라집니다. 테스트할 때는 현재 Wi-Fi에서 한 번 확인하는 등 명확한 상황을 정한 뒤 다른 네트워크로 전환하세요. 각 단계에서 연결이 시작되었는지, 성공적으로 설정되었는지, 실패 후 재시도가 계속되었는지 기록하세요.
- 자동 연결을 끄고 수동 연결과 실제 접속이 모두 가능한지 확인하세요.
- 기존 조건을 기록한 뒤 이번에 확인할 On Demand 조건 하나만 남기세요.
- 네트워크를 한 번 전환하고 상태가 안정될 때까지 기다린 다음 새 요청을 확인하세요.
- 테스트가 끝나면 원래 값으로 복원해 임시 조건이 일상 설정에 남지 않게 하세요.
수동으로 연결을 끊은 뒤 다시 연결될 때 확인할 사항
수동으로 연결을 끊은 직후 다시 연결되면 먼저 On Demand가 활성화된 상태인지, 시스템 VPN 설정에 해당 연결 동작이 남아 있는지 확인하세요. 다음으로 연결 동작을 호출하는 다른 승인된 자동화가 있는지도 살펴보세요. 재연결을 막으려고 스위치를 계속 누르지 마세요. 짧은 시간 동안 연결 및 해제 기록이 여러 번 생겨 로그를 읽기 어려워집니다. 먼저 자동 연결을 유발하는 요소를 중지한 다음 명확한 수동 동작을 한 번 실행하는 편이 결과를 해석하기 쉽습니다.
시스템 VPN 표시는 상태를 파악하는 단서로 사용할 수 있지만, 대상 트래픽이 어떤 규칙을 거쳤는지 또는 기존 서비스 정보가 여전히 유효한지를 단독으로 증명하지는 못합니다. Shadowrocket의 연결 상태와 실제 요청도 함께 확인하세요. 기기 잠금, 일시적인 네트워크 중단, 시스템 리소스 관리가 연결 상태에 영향을 줄 수 있습니다. 모든 상황에서 같은 세션을 계속 유지한다고 보장할 수는 없습니다. 장시간 전송 작업은 페이지를 여는 순간만 확인하지 말고 네트워크 전환 후 복구되는지도 테스트하세요.
네트워크 로그인이 필요한 Wi-Fi에서 자동 연결이 반복해서 실패하면 On Demand를 잠시 중지하고 시스템 네트워크 인증을 완료한 뒤 수동 연결을 테스트하세요. 해당 네트워크를 벗어난 뒤에는 원래 설정을 복원하세요. 특정 네트워크에서만 문제가 발생한다면 네트워크 유형과 발생 순서만 기록해도 충분합니다. 전체 네트워크 이름이나 개인 위치를 공개할 필요는 없습니다. 장기적으로는 목적이 분명한 최소한의 연결 조건만 유지하고, 기기를 교체하거나 Config를 변경한 뒤에도 기존 사용 목적에 맞는지 확인하세요.
05 / CONNECTIVITY TEST
Ping, Connectivity Test 및 시간 초과 판단
이름이 비슷한 테스트도 측정 대상은 다를 수 있습니다
일상적으로 Ping을 지연 시간 테스트의 뜻으로 널리 사용하지만, 앱의 구체적인 테스트에는 서로 다른 과정이 포함될 수 있습니다. 네트워크 계층 탐지, 서버 포트 연결 테스트, 프록시를 통한 테스트 대상 접속은 구분해야 합니다. Connectivity Test를 사용하기 전에 현재 화면에서 제공하는 테스트 방식과 대상 설명을 확인하세요. 목록 옆에 시간 값이 표시된다는 이유만으로 인증, DNS, 규칙, 웹페이지 로딩까지 모두 검증되었다고 판단하지 마세요. 테스트가 어느 계층까지 확인하는지가 중요합니다.
기본 테스트 방식과 대상, 시간 초과 값은 현재 화면을 기준으로 확인하세요. 이 문서에서는 확인되지 않은 출고 기본값을 제시하지 않습니다. 현재 정상 작동하는 값을 유지하고 테스트 대상에 접근할 수 없거나 응답이 느리거나 현재 네트워크에 적합하지 않다는 점이 확인된 경우에만 변경하는 것이 좋습니다. 테스트 주소를 직접 입력해야 한다면 직접 확인할 수 있고 응답이 안정적이며 로그인이 필요하지 않은 대상을 선택하세요. 테스트가 프록시를 거치는지도 확인해야 합니다. 개인 매개변수나 액세스 토큰, 임시 인증 정보가 포함된 링크를 공용 테스트 주소로 사용하지 마세요.
지연 시간, 처리량, 서비스 사용 가능성을 따로 확인하세요
응답 시간이 한 번 짧게 측정된 것은 해당 시점과 테스트 방식, 대상의 결과일 뿐 대용량 파일 전송이 더 빠르다는 뜻은 아닙니다. 처리량은 연결 대역폭, 혼잡, 서버 제한, 대상 사이트 부하에도 영향을 받습니다. 페이지 로딩에는 여러 도메인과 다수의 요청이 포함될 수 있습니다. 이미 보유한 서버를 선택할 때는 먼저 필요한 서비스가 정상적으로 작동하는지 확인하고 동일한 조건에서 여러 번 테스트하여 안정성을 비교하세요. 한 번 측정한 최저값만 보고 현재 선택을 바꾸거나 테스트 결과를 장기적인 보장으로 간주하지 마세요.
| 관찰된 결과 | 우선 확인할 항목 | 다음 검증 단계 |
|---|---|---|
| 테스트 시간 초과, 실제 접속은 정상 | 테스트 대상, 방식, 시간 초과 범위 | 실제 요청은 그대로 유지하고 다른 테스트 방식과 비교 |
| 테스트는 응답하지만 웹페이지는 실패 | 인증, DNS, 규칙 및 대상 서비스 | 로그에서 구체적으로 실패한 연결 단계 확인 |
| 특정 네트워크에서만 실패 | 서버 포트 및 네트워크 경로 | 정상 작동이 확인된 다른 네트워크에서 같은 테스트 반복 |
| 간헐적인 결과 변동 | 네트워크 전환, 동시 전송, 대상 부하 | 같은 테스트 조건으로 시간대를 달리해 반복 |
시간 초과가 발생했다고 서버가 작동하지 않는 것은 아닙니다. 테스트 대상이 예상한 대로 응답하지 않았거나 현재 네트워크에서 서버 포트에 접근할 수 없거나, 테스트 시간 초과 설정이 실제 완료 시간보다 짧을 수 있습니다. 다른 접속도 동시에 실패하는지 먼저 확인해 문제 범위를 좁히세요. 한 가지 테스트 방식만 실패한다면 테스트 메커니즘을 우선 점검하세요. 모든 요청이 실패하면 서버 주소와 포트, 비밀번호 또는 키, 기기의 연결이 실제로 설정되었는지를 확인하세요.
재현 가능한 비교 테스트 진행
여러 항목을 테스트하기 전에 대용량 파일 전송을 중지하고 기기를 가능한 한 같은 네트워크에 유지한 뒤, 기존 기록 몇 개만 선택해 확인하세요. 동시에 많은 테스트를 실행하면 연결 리소스를 차지해 기기와 네트워크 부하에 따라 결과가 달라질 수 있습니다. 서로 다른 테스트 묶음의 결과를 그대로 순위화하지 마세요. 같은 기록을 몇 차례 연속 테스트하여 매번 완료되는지 살펴보세요. 처음 한 번만 느리다면 연결 설정이나 DNS 해석, 캐시가 원인일 수 있으므로 프로토콜 매개변수를 바로 변경하지 말고 로그를 함께 확인하세요.
두 설정을 비교하려면 변경 전 방식과 대상, 결과를 기록한 다음 값 하나만 바꾸세요. 테스트 중에는 Subscribe를 업데이트하거나 Global Routing을 전환하거나 DNS를 바꾸지 마세요. 테스트가 끝나면 같은 페이지를 다시 열고 주요 리소스가 로드될 때까지 기다리는 등 실제 사용 동작도 확인하세요. 테스트와 실제 접속의 변화 방향이 일치해야 일상적인 선택에 결과를 활용할 수 있습니다. 두 결과가 다르면 실제 작업을 완료할 수 있는 설정을 우선 유지하고 차이가 생긴 이유를 계속 확인하세요.
Subscribe가 여러 개 있다면 별칭이 같아도 연결 매개변수가 다를 수 있으므로 테스트 전에 해당 기록이 어느 출처에 속하는지 확인하세요. 업데이트 후 항목이 중복되면 실제로는 서로 다른 서버를 비교하고 있다고 착각할 수도 있습니다. 그룹화, 정렬, 중복 항목 관리는 여러 구독 관리 가이드를 참고하세요. 이 절에서는 테스트 방법만 다룹니다. 테스트 수치를 근거로 서비스 출처를 평가하거나 추천하지 않으며 테스트 목록을 서비스 품질의 증거로 간주하지 않습니다.
06 / LOG
Log, Data 및 단계별 문제 해결
시간 범위를 좁힌 다음 오류 메시지 확인
Log에서는 연결 과정을 확인할 수 있으며, Data의 트래픽 기록은 데이터 전송 여부를 파악하는 데 도움이 됩니다. 하지만 둘 다 총량만으로 특정 대상에 접속이 성공했다고 증명할 수는 없습니다. 로그 위치와 표시 항목은 현재 화면을 기준으로 확인하세요. 문제를 재현한 시간을 기록한 다음 테스트 동작을 한 번만 실행하세요. 과거 기록이 많이 섞여 있으면 백그라운드 요청의 오류를 현재 페이지 실패의 원인으로 오해할 수 있습니다. 따라서 처음부터 모든 항목을 읽기보다 관찰할 시간 범위를 먼저 좁히세요.
기본 로그 상세 수준은 현재 설정을 기준으로 확인하세요. 일상적으로는 기본적인 진단에 필요한 수준을 유지하고 복잡한 문제를 재현할 때만 상세 수준을 일시적으로 높이는 것이 좋습니다. 화면에 로그 수준 옵션이 없다면 문서에 맞추려고 존재하지 않는 스위치를 추측하지 마세요. 상세 로그는 저장 공간과 처리 부담을 늘리고 접속 상황을 더 많이 노출할 수 있습니다. 문제를 파악한 뒤에는 원래 설정으로 복원하고 개인정보 보호 필요에 따라 기존 기록을 관리하세요. 실제로 필요한 범위를 넘어선 정보를 장기간 수집하지 마세요.
DNS 해석, 연결, 인증, 앱 응답 단계별로 확인
먼저 요청 기록이 있는지 확인하세요. 대상 관련 기록이 전혀 없다면 앱이 연결 중인지, 대상이 기존 세션을 재사용하는지, 해당 트래픽이 현재 처리 범위에 포함되는지 확인하세요. 다음으로 대상 주소를 얻었는지 확인하고, 서버 또는 대상 포트에 연결했는지 살펴보세요. 주소 해석 실패와 포트 연결 실패는 서로 다른 단계이므로 해결 방법도 다릅니다. timeout이라는 문구만 보고 비밀번호 오류라고 단정하지 마세요. 시간 초과는 연결 과정의 여러 지점에서 발생할 수 있습니다.
인증이 실패하면 사용자가 보유한 서버 정보에서 프로토콜과 포트, 비밀번호 또는 키, 암호화 매개변수를 확인하세요. 필요한 경우 TLS 및 전송 매개변수도 점검해야 합니다. 한 프로토콜의 필드를 다른 프로토콜에 그대로 적용하지 마세요. 연결이 설정된 뒤 TLS 단계에서 실패하면 서버가 요구하는 이름, 인증서 유효 조건, 기기 시간을 확인하세요. 검증을 끄는 것을 범용 해결 방법으로 삼지 마세요. 대상에서 앱 계층 오류 응답을 받았다면 대상 권한이나 서비스 상태를 추가로 확인해야 합니다.
[Rule]
DOMAIN,example.com,PROXY
FINAL,DIRECT
위의 범위가 좁은 규칙은 구성 복사본에서 비교 테스트에 사용할 수 있습니다. 정확한 도메인만 PROXY로 보내고 나머지는 FINAL에 따라 처리합니다. 해당 웹사이트의 하위 도메인에는 적용되지 않으며 완전한 문제 해결용 구성도 아닙니다. 기본 페이지와 정적 리소스의 경로가 다르면 로그에 여러 호스트 이름이 표시됩니다. 각각 확인하세요. 확인이 끝나면 임시 규칙을 삭제하거나 원본 파일을 복원하여 테스트용 FINAL이 일상적인 요청 경로를 바꾸지 않도록 하세요. 구성을 저장하는 것과 실제로 해당 구성을 사용하는지 확인하는 것은 모두 필요한 단계입니다.
로그를 공유 가능한 재현 자료로 정리
유용한 문제 기록에는 기기 플랫폼, 네트워크 유형, Global Routing, 현재 Config의 용도, 실패한 동작, 완료한 비교 테스트가 포함되어야 합니다. 버전 정보는 앱에서 확인하고 실제로 표시된 값을 사용해 문의하세요. 오래된 글에서 복사하지 마세요. 오류 문구는 원문과 주변 내용을 가능한 한 그대로 기록하되 공유 전에는 전체 구독 주소와 인증 정보, 개인 도메인, 네트워크 이름 등 민감한 내용을 삭제하세요. 비밀번호만 가리고 토큰이 포함된 링크를 남겨도 서비스 접근 권한이 노출될 수 있습니다.
Config에서 일부 대상만 접속된다면 성공한 요청과 실패한 요청의 규칙 매칭 및 주소 유형을 비교하세요. 서버 기록 하나만 실패한다면 원래 자료와 내용이 일치하는지 확인하세요. 하나의 네트워크에서 모든 기록이 실패하지만 다른 네트워크에서는 정상이라면 네트워크 경로를 우선 조사하세요. 이러한 분기별 확인으로 문제 범위를 좁힐 수 있습니다. 반대로 앱을 계속 재설치하거나 전체 구성을 삭제하거나 여러 옵션을 동시에 초기화하면 유용한 증거를 잃고 복구할 수 있었던 상태를 되찾지 못할 수 있습니다.
문제 해결이 끝나면 회귀 테스트를 진행하세요. 로그 수준과 임시 규칙을 복원하고 이전에 정상 작동한 대상에 계속 접속할 수 있는지 확인하세요. On Demand에 임시 테스트 조건이 남지 않았는지 살펴보고 비정상적인 재연결이 계속되는지도 확인하세요. 문제 설명은 ‘네트워크를 바꾸자 포트 연결이 복구됨’처럼 관찰한 사실에 근거해야 합니다. 막연히 ‘설정을 고쳤다’고만 하지 마세요. 증거가 충분하지 않다면 불확실성을 남기고 한 번씩 재현한 기록을 더 수집하세요. 우연히 한 번 성공한 결과를 고정된 해결 방법으로 제시하지 마세요.
07 / BACKUP
iCloud 동기화, Config 백업 및 기기 이전
동기화는 별도의 과거 백업이 아닙니다
iCloud 동기화는 조건을 충족하는 기기 간에 앱이 지원하는 데이터를 전달합니다. 지원 항목은 현재 화면과 실제 복원 결과를 기준으로 확인해야 하며 모든 서버, 규칙, 로그, 시스템 권한이 함께 이전된다고 가정할 수 없습니다. 동기화는 원하는 시점의 과거 상태로 언제든 돌아갈 수 있는 백업과도 다릅니다. 삭제하거나 잘못 수정한 내용이 동기화로 다른 기기에 전달될 수 있습니다. 따라서 Config를 대대적으로 정리하거나 기록을 여러 개 삭제하거나 기기를 교체하기 전에 별도로 보관할 수 있는 백업을 내보내고 파일을 읽을 수 있는지 확인하세요.
기본 동기화 상태는 앱 내 옵션과 시스템 iCloud 권한, 계정 상태를 각각 확인하세요. 계정에 로그인되어 있다고 Shadowrocket이 동기화되었다고 단정할 수 없습니다. 현재 정상 작동하는 기기는 그대로 둔 채 다른 기기에서 예상한 내용이 나타나는지 먼저 확인한 다음 옵션을 변경하세요. 특정 기능이 일부 플랫폼에서만 제공된다면 해당 플랫폼의 실제 메뉴를 사용하세요. 특히 플랫폼 간에 기기를 이전할 때 한 시스템의 클라우드 동기화 기능이 모든 플랫폼에서 사용할 수 있는 파일 전송 방식이라고 간주하지 마세요.
규칙, 서버 정보, 설정 기록을 각각 백업
Config 파일에는 주로 구성 내용이 들어 있지만 서버나 원격 리소스를 참조하기만 하고 전체 정보를 포함하지 않을 수도 있습니다. 내보내기 전에 파일을 열어 규칙과 DNS 매개변수, 리소스 참조, 인증 정보 중 무엇이 포함되어 있는지 확인하세요. 파일 이름만 저장했다고 백업이 완전한 것은 아니며 Subscribe 주소만 따로 저장해도 나중에 콘텐츠를 다시 가져올 수 있다고 보장할 수 없습니다. 원본 정보는 사용자가 직접 안전하게 보관하고 실제 인증 정보는 공개 메모나 공유 폴더에 기록하지 마세요.
기기 이전을 세 부분으로 준비하는 것이 좋습니다. 첫째, 현재 정상 작동하는 Config의 복사본을 저장합니다. 둘째, 보유한 서버 기록을 다시 만들 수 있는 자료를 보관합니다. 셋째, Global Routing, On Demand, 테스트 방식, 로컬 포트 용도 등 앱 설정을 기록합니다. 내보낸 파일은 통제된 위치에 보관하고 파일 이름에 용도를 표시하되 비밀번호나 구독 토큰을 포함하지 마세요. 민감한 백업을 다른 사람에게 함부로 보내지 말고 공개 클라우드 링크를 장기 보관 수단으로 사용하지 마세요.
- 기존 기기에서 현재 연결이 정상인지 확인한 다음 Config를 내보내고 파일 내용을 점검하세요.
- 보유한 서버 정보와 Subscribe를 복원할 수 있는 원본 자료가 있는지 별도로 확인하세요.
- 새 기기로 가져온 뒤 Config와 Global Routing, 현재 서버를 다시 선택하세요.
- 실제 접속과 자동 연결 테스트를 완료한 다음 기존 기기와 중복 파일을 정리하세요.
동기화 충돌 및 새 기기 복원 확인
두 기기에서 같은 구성을 동시에 편집하면 덮어쓰기가 발생하거나 복사본을 구분하기 어려워질 수 있습니다. 작업을 시작하기 전에 양쪽 파일을 보존하고 규칙과 리소스 참조, 주요 설정을 비교한 뒤 어느 쪽을 기준으로 사용할지 결정하세요. 파일 이름이 같다고 내용도 같다고 간주하지 말고 동기화가 완료되기 전에 연달아 삭제하거나 다시 만들지 마세요. 이번 편집을 진행할 기기 하나를 지정하고 다른 기기에서는 잠시 수정을 중단하는 것이 변경 출처를 추적하기 쉽습니다.
복원 후에는 먼저 수동으로 연결하고 On Demand 활성화는 미루세요. 새 기기에서는 시스템 VPN 권한을 다시 확인해야 하는 경우가 많으며 로컬 네트워크 접근 권한과 기타 시스템 권한도 실제 안내에 따라 점검해야 합니다. 다음으로 Global Routing이 기존 용도에 맞는지, 올바른 Config 파일이 선택되었는지, 서버가 유효한 기록을 가리키는지 확인하세요. 규칙이 원격 리소스를 참조한다면 해당 리소스를 정상적으로 가져올 수 있는지도 살펴보세요. 파일이 목록에 표시되어도 모든 외부 의존 항목이 준비되었다는 뜻은 아닙니다.
기존 기기에서는 작동하지만 새 기기에서 실패하더라도 동기화 손상으로 바로 단정하지 마세요. 두 기기가 서로 다른 네트워크에 연결되어 있거나 DNS 조건이 다르거나 이름은 같지만 매개변수가 다른 기록을 선택했을 수 있습니다. 먼저 비교 가능한 환경으로 맞춘 뒤 구성 내용과 현재 선택을 확인하세요. 보유한 서비스가 동시 연결을 제한하는지도 고려해야 합니다. 이는 사용자가 이미 이용 중인 서비스의 조건이며 클라이언트 표시 이름을 바꿔 해결할 수 없습니다. 테스트를 위해 계정 인증 정보를 공개해서도 안 됩니다.
전체 기기 이전 순서는 구성 백업 및 기기 교체 가이드에서 확인하세요. 이전 데이터를 삭제하기 전에 앱을 다시 시작한 뒤 실제 접속 테스트를 한 번 이상 완료하고 백업을 별도로 가져올 수 있는지 확인해야 합니다. 새 기기의 앱 설치가 끝나지 않았다면 먼저 다운로드 페이지에서 설치 및 시스템 안내를 확인한 다음 구성을 복원하세요. 앱 설치, 자료 복원, 연결 확인은 서로 다른 단계입니다. 순서대로 나누어 진행하면 설치 문제와 동기화 문제, 네트워크 문제를 혼동하지 않을 수 있습니다.
08 / LOCAL ACCESS
Proxy 포트, Widget 및 일상적인 유지 관리 기준
로컬 Proxy 포트는 서버 포트와 다릅니다
로컬 Proxy 포트는 해당 프로토콜을 지원하는 프로그램이 클라이언트에 연결하도록 사용합니다. Home에 표시되는 서버 포트는 원격 서버에 연결하기 위한 매개변수입니다. 둘의 값이 우연히 같을 수는 있지만 반드시 같아야 하는 것은 아닙니다. 프로그램에서 HTTP 또는 SOCKS5 프록시를 입력하라고 하면 현재 플랫폼의 Shadowrocket이 해당 수신 기능을 제공하고 활성화했는지 먼저 확인하세요. 기존 서비스에서 해당 연결 방식을 요구하는 경우가 아니라면 원격 서버의 주소와 포트를 로컬 프록시 설정에 그대로 입력하지 마세요.
포트 값과 수신 주소, 기본 활성화 여부는 실제 Settings 화면을 기준으로 확인하세요. 이 문서에서는 모든 기기에 통용되는 숫자를 지정하지 않습니다. 권장 기준은 명시적인 프록시 연결이 필요한 프로그램이 없다면 로컬 네트워크 공유를 추가로 켜지 않는 것입니다. 기기 안의 프로그램만 사용한다면 접근 범위를 가능한 한 기기 내부로 제한하세요. 수신 포트를 바꾸기 전에 원래 값을 기록하고 새 포트를 다른 프로그램이 사용 중이지 않은지 확인한 다음 해당 포트를 사용하는 프로그램도 함께 업데이트하세요. 한쪽만 바꾸고 다른 쪽이 이전 포트를 계속 사용하면 연결 거부나 시간 초과가 발생합니다.
| 항목 | 의미 | 확인할 사항 |
|---|---|---|
| 수신 주소 | 연결을 수신하는 로컬 네트워크 인터페이스 | 기기 내부 접근과 로컬 네트워크 접근 범위는 다릅니다 |
| 로컬 포트 | 클라이언트가 프록시 요청을 수신하는 위치 | 호출 프로그램에 입력한 포트와 일치해야 합니다 |
| 프록시 프로토콜 | 호출 프로그램과 로컬 수신 기능 간의 연결 방식 | HTTP와 SOCKS5를 임의로 바꿔 사용할 수 없습니다 |
| 서버 포트 | 보유한 원격 서비스의 연결 매개변수 | 사용자가 보유한 서버 정보를 기준으로 확인 |
로컬 네트워크 공유 시 주의사항 및 확인 순서
로컬 네트워크 기기의 접속을 허용하면 접근 범위가 넓어지므로 명확한 필요가 있고 네트워크가 안전하게 관리될 때만 사용하세요. 먼저 연결 기기와 Shadowrocket 실행 기기 간 통신이 가능한지 확인한 뒤 시스템 방화벽과 수신 주소, 포트를 점검하세요. 같은 Wi-Fi 이름을 사용해도 기기 간 통신이 보장되지는 않습니다. 게스트 네트워크의 기기 간 통신 차단이 연결을 막을 수 있습니다. 프로그램 하나를 확인하려고 시스템 보호를 전부 낮추거나 불필요한 외부 네트워크에 로컬 수신 기능을 노출하지 마세요.
프록시 주소를 입력할 때 호출 프로그램과 다른 기기에서 말하는 ‘이 기기’는 같은 대상을 가리키지 않습니다. 프로그램에서 로컬 루프백 주소는 그 프로그램이 실행 중인 기기를 뜻하며, Shadowrocket이 실행 중인 다른 기기를 자동으로 가리키지는 않습니다. 기기 간 연결에는 실제로 접근 가능한 로컬 네트워크 주소를 사용하고 네트워크를 다시 연결한 뒤 주소가 달라질 수 있다는 점도 고려하세요. 테스트가 끝나 더 이상 공유할 필요가 없다면 해당 연결 기능을 끄고 원래 수신 범위로 되돌린 뒤 호출 프로그램에 남은 프록시 설정을 삭제하세요.
Widget은 실행을 위한 바로가기이며 연결 확인을 대신하지 않습니다
Widget은 상태를 빠르게 보거나 동작을 실행하는 편리한 진입점입니다. 실제로 제공되는 동작은 현재 시스템과 앱의 Widget 기능을 기준으로 확인하세요. 추가하기 전에 앱에서 연결이 정상인지 확인한 다음 시스템의 위젯 관리 방법에 따라 설정하세요. Widget 표시는 시스템 스케줄에 따라 갱신되므로 특정 순간에 표시된 문구나 아이콘을 실시간 네트워크 모니터링으로 간주할 수 없습니다. 표시 상태와 실제 접속 결과가 다르면 Shadowrocket을 열어 현재 연결과 서버를 확인한 뒤 요청을 보내세요. Widget에서 스위치를 연속으로 전환하지 마세요.
Widget을 기본적으로 추가할지는 시스템 레이아웃과 사용자 선택에 따라 달라지며 Config 파일에 공통으로 적용되는 값이 아닙니다. 용도가 분명한 바로가지만 유지하고 잠금 화면이나 공유 화면에 서버 별칭 등의 정보가 표시되는지 주의하세요. 기기를 교체하거나 백업을 복원하면 Widget의 위치와 권한을 다시 확인해야 할 수 있습니다. Widget이 복원되어도 Config, Global Routing, 현재 서버를 확인해야 합니다. Widget으로 동작을 실행할 수 있다고 서버 정보나 시스템 권한까지 완전히 복원된 것은 아닙니다.
일상적인 유지 관리는 다음 순서로 진행할 수 있습니다. 먼저 보유한 서비스 정보를 확인하고 현재 구성 및 규칙 참조를 점검한 다음 DNS와 자동 연결, 테스트 설정을 확인하고 마지막으로 로컬 포트와 Widget을 살펴보세요. 한 번에 현재 문제와 관련된 한 계층만 조정하고 사용 가능한 복사본과 복구 기록을 남기세요. 앱을 다시 설치해야 한다면 전체 플랫폼 다운로드 페이지를 방문하세요. 처음 설정을 마쳤다면 빠른 시작 가이드로 돌아가 연결을 확인하세요. 설정을 계속 추가하기보다 안정적인 기준 상태를 유지하는 편이 이후 변화를 파악하는 데 도움이 됩니다.