설정 기준과 Config 적용 범위
설정을 바꾸기 전에 먼저 되돌릴 수 있는 기준 상태를 기록하세요. Shadowrocket의 동작에는 Settings, 현재 선택한 서버, 사용 중인 Config, 시스템 네트워크 상태가 함께 영향을 줄 수 있습니다. 스위치가 켜져 있다는 사실만으로 현재 요청의 경로를 결정한다고 볼 수는 없습니다. 먼저 Home에서 서버 이름과 연결 상태를 기록하고 Global Routing을 확인한 다음 Config에서 사용 중인 구성 파일을 확인하세요. 기록에는 식별에 필요한 이름만 남기고 구독 주소, 비밀번호, 키를 공개 메모에 붙여 넣지 마세요. 이후의 테스트를 같은 조건에서 시작해야 변화가 어떤 항목에서 비롯됐는지 판단할 수 있습니다.
기본값: 현재 설치 상태를 기준으로 확인
이 가이드는 모든 기기의 초기값이 같다고 가정하지 않습니다. 최초 설치, 백업 복원, 구성 가져오기, 시스템 업그레이드에 따라 표시되는 상태가 달라질 수 있으며, 일부 옵션은 특정 조건에서만 표시됩니다. 여기서 ‘기본 상태 확인’이란 해당 항목을 수정하기 전에 화면에 표시된 값과 그 출처를 기록하는 것이지, 모든 설정을 먼저 초기화하는 것이 아닙니다. 권장 기준은 용도에 따라 달라집니다. 문제가 없다면 기존 값을 유지하고, 가설을 확인할 때는 한 항목만 조정한 뒤 효과가 없으면 원래대로 되돌리세요. 가이드의 화면과 똑같이 만들기 위해 정상적으로 작동하는 연결을 바꾸지 마세요.
Global Routing: 먼저 세 가지 모드 확인
Global Routing은 전체 라우팅 모드를 결정하지만 각 연결을 직접 확인하는 절차를 대신하지는 않습니다. Config 모드에서는 현재 Config의 규칙에 따라 요청을 처리합니다. Proxy 모드는 서버 경로를 비교할 때 사용할 수 있고, Direct 모드는 현재 네트워크에서 직접 접속할 때의 결과를 확인하는 데 쓸 수 있습니다. 세 모드는 문제 해결을 위한 조건이지 속도 등급이 아닙니다. Proxy를 사용할 때도 로컬 네트워크, 서버 주소, DNS에 접근할 수 있는지 확인해야 합니다. Direct에서 접속된다고 해서 모든 앱이 반드시 정상 작동하는 것도 아닙니다. 모드를 비교할 때는 같은 대상과 네트워크를 사용하고 시간 간격도 좁혀 대상 자체의 변화가 모드 차이로 오인되지 않게 하세요.
| 모드 | 주요 용도 | 확인할 항목 |
|---|---|---|
| Config 모드 | Config 규칙에 따라 요청 처리 | 활성 Config, 일치한 규칙, 적용된 정책 |
| Proxy 모드 | 서버 경로 비교 | 선택한 서버, 프로토콜 매개변수, 연결 결과 |
| Direct 모드 | 현재 네트워크와 비교 | 네트워크 인증, 직접 접속, DNS 응답 |
규칙 조각과 구성 파일의 범위
규칙은 일반적으로 위에서부터 순서대로 적용되므로 앞에 있는 광범위한 규칙이 뒤의 구체적인 규칙보다 먼저 일치할 수 있습니다. 아래 내용은 구문을 이해하기 위한 일부 예시일 뿐, 기존 파일을 대체할 수 있는 완전한 Config가 아닙니다. PROXY는 실제로 사용할 수 있는 정책 또는 Config 정의와 연결되어 있어야 합니다. DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치시키고, GEOIP는 IP 주소의 지역 정보에 따라 처리하며, FINAL은 앞서 일치하지 않은 요청을 처리합니다. 수정하기 전에 Config 사본을 저장하고 사본에서 규칙 순서를 조정하세요. 해당 도메인의 연결이 이미 유지되고 있다면 규칙을 바꾼 뒤 새 요청을 만들어 테스트해야 기존 세션을 계속 관찰하는 일을 피할 수 있습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
변경을 누적하지 말고 결과를 기록하세요
매번 ‘기존 상태, 변경 항목, 테스트 대상, 관찰 결과, 복원 여부’를 기록하는 것이 좋습니다. 예를 들어 서버와 네트워크는 그대로 두고 Global Routing만 바꿔 보세요. 차이가 없다면 원래 모드로 되돌린 뒤 DNS를 테스트합니다. 구독 업데이트와 수동 편집도 따로 진행하세요. 파일이 새로고침되면 수동 변경 사항이 남아 있는지 확인하기 어려워질 수 있습니다. 모르는 키워드가 Config에 있다면 일괄 삭제하지 말고 용어 가이드에서 먼저 확인하세요. 테스트를 마친 뒤에는 원래 정상적으로 작동하던 앱으로 회귀 테스트를 해 단일 대상만 해결하고 평소 연결 경로를 바꾸지 않았는지 확인하세요.
DNS: DNS 응답과 연결 경로
DNS는 도메인 이름을 연결에 사용할 주소로 변환합니다. DNS 응답 성공과 연결 성공은 서로 다른 단계입니다. 페이지가 열리지 않는 원인은 주소를 받지 못한 경우, 주소는 받았지만 연결하지 못한 경우, 이후 암호화 협상에서 실패한 경우 등 다양합니다. 따라서 모든 연결 오류를 DNS 문제로 단정하지 마세요. 먼저 문제가 특정 도메인에만 발생하는지 확인하고, 현재 네트워크에서 같은 대상에 접속해 본 뒤 Log에서 실패 단계를 살펴보세요. 정상적으로 작동하는 Config라면 특정 DNS 서비스가 ‘더 빠르다’는 설명만으로 기존 설정을 모두 바꾸기보다 현재 방식을 유지하는 것이 좋습니다.
기본 상태: Settings와 Config를 모두 확인
시작하기 전에 Settings의 DNS 관련 옵션과 활성 Config의 DNS 항목을 각각 확인하세요. 화면에 표시된 주소가 모든 DNS 조회에 최종적으로 사용된다고 단정할 수는 없습니다. Config 파일, 시스템 네트워크, 특정 규칙이 결과에 함께 영향을 줄 수 있습니다. 기존 주소와 순서, 관련 스위치를 기록하세요. 값이 명확하게 표시되지 않는다면 임의로 추측해 추가하지 마세요. 가져온 Config에 DNS 항목이 있다면 안내를 먼저 읽고 수정 여부를 결정하세요. 문제를 찾을 때는 출처를 명확히 식별할 수 있는 항목 하나만 변경하고 Config가 실제로 선택되어 있는지도 확인하세요. 활성화되지 않은 파일만 편집해도 현재 연결 동작은 바뀌지 않습니다.
일반 DNS와 암호화 DNS 구분하기
일반 DNS와 암호화 DNS는 전송 방식이 다릅니다. 둘 다 주소를 반환한다는 이유만으로 설정 조건이 같다고 볼 수는 없습니다. 도메인 이름을 사용하는 암호화 DNS 엔드포인트라면 그 엔드포인트 자체를 어떻게 찾을지, 현재 네트워크에서 접속 가능한지부터 확인해야 합니다. 시스템 시간이 크게 어긋나면 인증서 검증에도 영향을 줄 수 있습니다. 출처와 전송 방식을 파악할 수 있고 현재 네트워크에서 접속 가능한 DNS 구성을 사용하는 것이 좋습니다. 출처가 불분명한 주소를 여러 개 추가하는 것은 문제 해결에 도움이 되지 않을 수 있습니다. 응답 결과와 실패 대기 시간을 해석하기 더 어려워질 수 있기 때문입니다. 네트워크를 바꾼 뒤에도 같은 DNS 방식이 작동하는지 다시 확인하세요.
IPv4, IPv6 및 규칙 일치
같은 도메인에서 IPv4와 IPv6 주소가 모두 반환될 수 있습니다. IPv6 경로에 연결 문제가 있으면 한참 기다린 뒤 접속되거나 일부 앱만 실패할 수 있습니다. 그러나 이런 현상만으로 IPv6 기능을 모두 꺼야 한다고 단정할 수는 없습니다. 현재 네트워크와 다른 네트워크에서 각각 재현해 보고 연결 기록에 표시된 주소 유형을 확인하세요. Config가 IP-CIDR 또는 IP-CIDR6로 일치하는 경우 실제 주소가 예상 범위에 포함되는지도 확인해야 합니다. 도메인 기반 규칙과 IP 주소 기반 규칙은 관찰하는 대상이 다릅니다. 문제를 확인할 때 도메인과 주소 유형의 대응 관계를 함께 기록하세요.
| 관찰된 현상 | 우선 확인할 항목 | 바로 단정하면 안 되는 결론 |
|---|---|---|
| 특정 도메인 하나만 실패 | 해당 도메인의 DNS 응답과 대상 서비스 | 모든 DNS가 작동하지 않음 |
| 네트워크를 바꾸면 정상 작동 | 네트워크 인증, DNS 엔드포인트 접속 가능 여부 | 서버 매개변수 오류가 확실함 |
| DNS 응답 후 연결 시간 초과 | 대상 주소, 라우팅 및 전송 경로 | DNS 주소를 더 추가하면 해결됨 |
한 번에 한 가지 변경 사항 확인
테스트 중인 요청을 종료하고 현재 활성 Config를 기록한 뒤 DNS 관련 항목 하나만 변경하세요. 저장 후 화면의 안내에 따라 연결을 새로 설정하고 같은 도메인으로 새 요청을 보내 Log에서 DNS 조회와 연결 기록을 확인합니다. 앱, 시스템, 브라우저가 캐시를 사용할 수 있으므로 새로고침을 반복해도 새로운 DNS 조회가 발생하지 않을 수 있습니다. 새 조회가 보이지 않는다고 곧바로 변경이 무효라고 판단하지 마세요. 테스트 앱을 종료한 뒤 다시 시도하고 새로운 시각의 기록과 비교해 볼 수 있습니다. 실패하는 도메인이 늘어나면 기록해 둔 기존 값으로 되돌린 뒤 주소, 프로토콜 형식, 엔드포인트 경로를 잘못 입력하지 않았는지 확인하세요. 다른 변경 사항을 계속 추가하지 마세요.
설명할 수 있는 결과만 유지
DNS를 조정한 뒤에는 원래 정상이던 대상과 문제가 있던 대상을 모두 확인해 변경 범위가 넓어지지 않았는지 점검하세요. 특정 Wi-Fi에서만 실패한다면 먼저 해당 네트워크의 로그인을 완료하세요. 특정 서비스만 문제라면 규칙 일치 여부와 대상 서비스 상태를 확인합니다. 서버 IP를 웹 주소 대신 입력해 테스트하지 마세요. HTTPS에는 호스트 이름과 인증서도 관련되므로 결과가 서로 같지 않습니다. 원인을 찾기 어렵다면 질문과 답변의 문제 분류에 따라 확인하고, 민감한 정보를 가린 오류 단계와 네트워크 조건만 기록하세요. 전체 Config를 공개하지 마세요.
On Demand: 트리거 조건과 자동 연결
On Demand는 조건에 따라 연결 동작을 결정하며 서버가 현재 용도에 적합한지 판단하거나 Global Routing을 대체하지는 않습니다. On Demand는 ‘언제 연결을 시작하거나 바꿀지’를 정하고, Global Routing은 ‘연결 후 요청을 어떻게 처리할지’를 정합니다. 수동 연결이 안정적이지 않다면 서버와 Config를 먼저 확인할 때까지 수동 방식을 유지하는 것이 좋습니다. 그렇지 않으면 자동 트리거, 수동 전환, 서버 오류가 뒤섞여 ‘왜 다시 연결됐는지’와 ‘왜 접속에 실패했는지’를 구분하기 어렵습니다. 자동 동작을 테스트하기 전에 기본 연결이 가능한지 먼저 확인하세요.
기본 상태: 기존 스위치와 조건 확인
On Demand에 들어가면 전체 스위치 상태, 기존 조건, 표시 순서를 먼저 기록하세요. 새 기기의 설정이 반드시 꺼져 있다고 가정하지 마세요. 시스템 복원이나 설정 이전 후에는 현재 상태가 최초 설치 때와 다를 수 있습니다. 규칙이 이미 있다면 새 조건을 추가하기 전에 각 규칙이 적용되는 네트워크 범위를 파악하세요. Wi-Fi 이름이 하나 보인다고 해서 그것만이 유일한 트리거라고 볼 수는 없습니다. 최소한의 조건부터 시작해 특정 네트워크에서 동작을 확인한 다음 다른 상황으로 확대하는 것이 좋습니다. 일시적으로 연결 문제를 확인해야 한다면 자동 트리거를 끄고 기존 상태를 기록한 뒤 테스트가 끝나면 복원하세요.
Wi-Fi 이름과 셀룰러 네트워크 조건
Wi-Fi 이름을 조건으로 사용할 때는 대소문자, 공백, 비슷한 문자를 포함해 실제 네트워크 이름과 일치하는지 확인하세요. 같은 이름의 네트워크가 서로 다른 장소에 있을 수 있습니다. 이름 일치는 네트워크의 신뢰성을 인증하지 않으며 보안 경계로 사용할 수도 없습니다. 셀룰러 조건은 Wi-Fi에서 실제로 벗어난 뒤 확인해야 합니다. 상태 표시줄이 잠깐 바뀌는 것만으로 결론을 내리지 마세요. 듀얼 SIM 전환, 핫스팟, 네트워크 인증 화면도 테스트 조건을 바꿀 수 있습니다. 먼저 ‘이 네트워크에 연결되어 있을 때 어떤 상태여야 하는지, 벗어나면 어떻게 바뀌어야 하는지’를 정리한 뒤 실제 결과를 확인하세요. 스위치가 켜졌는지만 보지 마세요.
도메인 조건은 웹사이트 전체 접속 규칙이 아닙니다
도메인 트리거는 일반적으로 DNS 조회나 시스템 네트워크 요청과 관련되며, 브라우저 주소창의 모든 동작을 하나씩 검사하는 기능은 아닙니다. 웹페이지 하나가 여러 도메인을 호출할 수 있고 앱이 기존 연결이나 캐시된 결과를 재사용할 수도 있으므로 같은 페이지를 열어도 매번 같은 방식으로 트리거되지 않을 수 있습니다. 도메인 조건을 테스트할 때는 식별할 수 있는 새 요청을 보내고 빠른 새로고침을 반복하는 대신 이벤트 발생 시각을 확인하세요. On Demand의 도메인 조건을 Config의 DOMAIN-SUFFIX 규칙과 혼동하지 마세요. 두 기능은 역할이 다르므로 트리거 결과와 요청의 최종 경로를 각각 확인해야 합니다.
조건 순서와 기본 조건
조건이 여러 개라면 화면에 표시된 순서대로 확인하고 각 규칙 동작의 의미를 파악하세요. 범위가 넓은 조건이 뒤의 세부 조건보다 먼저 적용되어 예외 조건이 작동하지 않을 수 있습니다. 구체적인 조건과 기본 조건을 구분해 작성하고 실제 네트워크에서 하나씩 확인하세요. 목록이 완성돼 보인다는 이유만으로 설정을 끝내지 마세요. 플랫폼이나 시스템 버전에 따라 예상한 조건이 표시되지 않는다면 다른 기기의 화면을 보고 없는 메뉴를 찾아 헤매지 마세요. 네트워크 전환 예시는 On Demand 조건부 연결 설정을 참고하세요. 이 페이지에서는 확인 순서와 문제 해결의 범위를 중점적으로 설명합니다.
자동 재연결과 네트워크 인증 문제 해결
수동으로 연결을 끊었는데 다시 연결되면 전체 스위치를 반복해서 누르기보다 On Demand의 트리거 조건이 여전히 충족되는지 확인하세요. 자동 트리거와 연결 실패를 구분하려면 On Demand를 잠시 끄고 Home에서 직접 연결해 볼 수 있습니다. 수동 연결도 실패한다면 서버, DNS, 규칙을 먼저 확인하세요. 웹 인증이 필요한 Wi-Fi를 사용할 때는 인증 절차를 완료한 뒤 자동 연결을 확인하세요. 인증을 마치지 않아 접속할 수 없는 상황을 규칙 오류로 오인할 수 있습니다. 해결되지 않은 기본 네트워크 문제를 보완하려고 조건을 계속 추가하지 마세요.
최종 확인에는 대상 네트워크에 머무르기, 해당 네트워크에서 벗어나기, 다시 돌아오기 등 최소 세 가지 상황이 포함되어야 합니다. 네트워크를 전환할 때마다 시스템이 변경을 완료할 때까지 기다리세요. 기록에는 네트워크 이름, 트리거 조건, 예상 동작, 실제 동작을 포함하세요. 잠금 화면에서 변화가 즉시 일어나는지는 시스템 스케줄링의 영향을 받을 수 있으므로 초 단위 응답을 보장할 수 없습니다. 테스트가 끝나면 임시 조건을 지우고 용도를 설명할 수 있는 규칙만 남기세요. 네트워크 이름을 바꾸거나 기기를 옮긴 뒤에는 다시 확인해야 합니다. 자동 연결은 모든 옵션을 켜는 것보다 조건이 명확하고 동작을 예측할 수 있을 때 유용합니다.
Connectivity Test와 Ping 결과 확인
Connectivity Test는 특정 테스트 조건에서 접속 가능한지 확인하는 기능이지 서버의 종합적인 품질 순위가 아닙니다. 목록에 표시된 시간은 해당 테스트에서 측정한 결과일 뿐 다운로드 속도, 동영상 재생 안정성, 모든 웹사이트의 응답 속도를 의미하지 않습니다. Ping도 실제 테스트 방식과 함께 해석해야 하며 표시된 모든 지연 시간을 ICMP 왕복 시간으로 간주해서는 안 됩니다. 먼저 선택한 테스트 항목, 대상, 네트워크를 확인한 뒤 결과를 살펴보세요. 조건이 다르면 두 수치를 직접 비교할 수 없습니다. 특히 Wi-Fi와 셀룰러 네트워크에서 각각 얻은 결과로 서버의 우열을 판단하지 마세요.
기본 상태: 테스트 방식과 대상 확인
테스트를 시작하기 전에 Connectivity Test에서 현재 어떤 방식을 선택했는지, 주소나 시간 제한 등의 옵션이 표시되는지 확인하세요. 표시되지 않은 매개변수를 임의로 추측하거나 다른 버전의 값을 그대로 따라 하지 마세요. 테스트 대상을 바꿀 수 있다면 접근 권한이 있고 현재 접속 가능하며 응답이 안정적인 주소를 선택해 기존 값을 기록하세요. 기존 테스트 설정은 그대로 두고 대상 자체에 접속할 수 없거나 응답 방식이 테스트에 적합하지 않을 때만 변경하는 것이 좋습니다. 특정 대상에 접속하지 못한다는 사실은 그 대상과 현재 경로의 조합에 문제가 있다는 뜻일 뿐, 서버 전체가 사용할 수 없다는 의미는 아닙니다.
연결 시간과 전체 요청 시간 구분
전송 연결 설정, 암호화 협상, HTTP 요청 전송, 응답 수신은 서로 다른 단계입니다. 테스트마다 이 중 일부 또는 여러 단계가 포함될 수 있으므로 같은 단위를 사용해도 같은 대상을 측정한다고 볼 수 없습니다. 서버 포트에 연결된다고 인증 정보가 올바른 것은 아닙니다. 테스트 응답을 받았다고 특정 서비스 웹사이트까지 정상적으로 이용할 수 있는 것도 아닙니다. Connectivity Test는 초기 점검 도구로 활용하고 실제 업무 경로는 가벼운 요청으로 확인하세요. 프로토콜 매개변수를 확인할 때는 반복해서 지연 시간을 측정하지 말고 서비스 제공업체가 안내한 프로토콜, 주소, 포트, 인증 정보를 확인하세요.
timeout 및 비정상 결과의 의미
시간 초과는 이번 대기 시간 안에 예상한 결과를 받지 못했다는 뜻입니다. 원인은 로컬 네트워크, DNS 응답, 서버, 테스트 대상, 응답 경로 등 여러 곳에 있을 수 있습니다. 대기 시간이 너무 짧으면 느리지만 작동하는 경로도 실패로 기록될 수 있고, 너무 길면 판단만 늦어질 뿐 문제를 해결하지는 못합니다. 명확한 테스트 목적이 없다면 성공 표시를 얻으려고 시간 제한을 계속 늘리지 마세요. 먼저 정상 작동이 확인된 경로를 비교 대상으로 테스트한 뒤 문제가 있는 경로를 확인하세요. 모든 항목이 동시에 실패한다면 서버를 모두 삭제하기보다 네트워크 인증을 마쳤는지, 기기에서 외부 서비스에 실제로 접속할 수 있는지 먼저 확인하세요.
| 결과 조합 | 다음 단계 | 유지할 변수 |
|---|---|---|
| 테스트 성공, 실제 서비스 실패 | 서비스 도메인의 규칙과 연결 로그 확인 | 서버, 네트워크, 테스트 시각 |
| 테스트 실패, 실제 서비스 사용 가능 | 테스트 대상과 방식 확인 | 서비스 대상, 라우팅 모드 |
| 같은 네트워크에서 모두 실패 | 네트워크 인증과 직접 접속 확인 | 서버 매개변수와 Config 사본 |
비교 가능한 반복 테스트 방법
네트워크, 서버, 테스트 방식을 고정하고 네트워크를 많이 사용하는 전송 작업은 잠시 멈춘 뒤 비슷한 조건에서 몇 차례 반복하세요. 최소 수치만 골라 결론을 내리지 말고 시간 초과가 계속 발생하는지, 결과 변동이 큰지, 실제 접속이 완료되는지 살펴보세요. 테스트를 여러 개 동시에 실행하면 기기와 네트워크에 추가 부하가 생겨 관찰하려는 상황이 달라질 수 있으므로 일상적인 사용 상태를 판단하며 대량 테스트를 계속하지 않는 것이 좋습니다. 서버 두 대를 비교한다면 동일한 테스트 조건을 각각 적용하세요. 네트워크를 바꿨다면 별도 실험으로 기록하고 이전 결과와 섞어 순위를 매기지 마세요.
테스트 결과와 규칙 교차 확인
Config 모드에서 서비스 요청의 경로는 규칙에 따라 결정되므로 서버 테스트가 성공했다고 현재 웹사이트 요청도 그 서버를 거친다고 볼 수는 없습니다. 먼저 해당 도메인의 연결 기록과 적용된 정책을 확인한 뒤 Proxy 모드로 잠깐 비교하고 테스트가 끝나면 Config로 되돌리세요. 테스트는 성공했지만 특정 앱이 실패한다면 앱이 이전 연결을 캐시했는지, 다른 도메인을 사용하는지, 서버가 해당 서비스의 전송 방식을 지원하는지 확인할 수 있습니다. 문제 기록에는 ‘어떤 테스트는 성공했고 어떤 요청은 실패했는지’를 구체적으로 남기세요. ‘네트워크 정상’처럼 뭉뚱그려 쓰지 않으면 후속 점검을 실패한 단계에 집중할 수 있습니다.
확인이 끝나면 테스트 주소, 시간 제한, 모드를 기록해 둔 기존 값으로 되돌리거나 변경을 유지하는 이유를 명확히 기록하세요. 테스트 기록에 모든 수치를 계속 쌓아 둘 필요는 없습니다. 대표적인 실패 단계와 재현 조건만 남기세요. 지연 시간은 정상이지만 연결이 계속 끊긴다면 Ping 수치만 더 살펴보기보다 Log와 네트워크 전환을 확인하세요. 서버를 계속 사용할 수 없다면 로컬 테스트 항목을 모두 바꾸는 것보다 현재 서비스 제공업체에 상태와 매개변수를 확인하는 편이 효과적입니다.
Log와 Data: 실패 단계 찾기
Log는 이벤트 순서를 파악하는 데, Data는 트래픽이나 연결 통계를 확인하는 데 쓰입니다. 둘 다 문제가 재현된 시점과 함께 살펴봐야 합니다. 트래픽이 증가했다면 통계 범위 내에서 데이터가 이동했다는 뜻일 뿐 대상 웹페이지가 완전히 열렸다는 증거는 아닙니다. 예상한 로그가 보이지 않는 이유도 기록 범위, 필터 조건, 기존 연결 재사용 등일 수 있습니다. 먼저 안정적으로 재현되는 문제를 기록한 뒤 필요한 로그만 잠시 켜고 한 번 작업한 직후 확인하세요. 정상 접속을 계속 기록하면 확인할 내용이 늘고 민감한 정보가 남을 수 있으므로 일상적인 문제 해결의 첫 단계로 적합하지 않습니다.
기본 상태: 기록 범위를 확인한 뒤 상세 수준 조정
관련 페이지를 열고 기록 기능의 활성화 여부, 현재 필터 조건, 표시되는 시간 범위, 기록 삭제 또는 내보내기 기능을 먼저 확인하세요. 화면에 표시되는 세부 정보는 환경에 따라 다를 수 있으므로 모든 설치 상태에 공통으로 적용되는 로그 수준을 정하지 않습니다. 평소에는 기존 기록 방식을 유지하고 문제를 확인할 때만 필요한 범위까지 상세 수준을 높인 뒤 원래대로 돌리는 것이 좋습니다. 기존 기록을 지우려면 필요한 민감 정보 제거 완료 구간을 먼저 저장하세요. 로그를 지워도 연결이 복구되거나 새 요청이 자동으로 만들어지지는 않습니다. 다음에 확인할 시간 범위를 줄이는 데만 도움이 됩니다.
타임라인으로 실패 단계 확인
요청은 DNS 조회, 규칙 일치, 연결 설정, 인증 또는 암호화 협상, 데이터 전송 단계로 나눠 살펴볼 수 있습니다. 오류 메시지는 이 순서에 맞춰 해석하세요. 주소 조회에 실패했다면 DNS를 먼저 확인합니다. 연결은 됐지만 인증에 실패했다면 서버 정보를 점검하세요. 데이터가 전송된 뒤 연결이 끊겼다면 대상 서비스와 네트워크 전환도 고려해야 합니다. 구체적인 오류 문구는 실제 화면에 표시된 내용을 기준으로 판단하세요. 서로 다른 오류를 모두 같은 원인으로 해석하지 마세요. 마지막으로 명확히 성공한 단계를 찾고 그다음 실패한 지점을 확인하면 모든 설정을 처음부터 바꾸는 것보다 검증 가능한 결론을 얻기 쉽습니다.
규칙 일치와 실제 경로
요청에 어떤 정책이 적용됐는지 확인하는 것이 Config의 동작을 파악하는 핵심입니다. 기록에 도메인, 주소, 규칙, 정책이 표시된다면 함께 살펴보세요. 도메인은 접미사 규칙과 일치할 수 있고 주소는 IP 범위 규칙과 일치할 수 있으며, 어느 규칙에도 해당하지 않는 요청은 FINAL로 처리될 수 있습니다. 규칙을 수정한 뒤에는 새 요청을 보내 새 기록을 확인하세요. 파일에 목표 규칙이 입력된 것만 보고 적용됐다고 판단하지 마세요. 같은 웹페이지에서 여러 연결이 보인다면 여러 리소스 도메인에 접속한 것일 수 있습니다. 한 항목만 찾고 전체 페이지가 같은 경로를 사용한다고 결론 내리지 말고 각각 확인하세요.
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
이 예시는 규칙 순서를 설명합니다. 정확히 example.com인 도메인은 먼저 DOMAIN에 일치하고, 그 밖에 접미사 조건을 만족하는 요청은 DOMAIN-SUFFIX 규칙을 이어서 확인합니다. 실제로 사용하기 전에 Config에서 PROXY가 유효한 의미를 갖는지 확인하고 올바른 위치에 조합하세요. 전체 Config를 이 조각으로 대체해서는 안 됩니다. 순서를 바꾸면 정확한 도메인도 접미사 규칙에 먼저 처리될 수 있으므로 새 요청으로 결과를 확인하세요. 이 규칙 예시는 실제 사이트 접속을 권장하는 내용이 아니라 Config 동작을 설명하기 위한 것입니다.
Data 통계는 서비스 완료 여부와 다릅니다
Data의 업로드, 다운로드, 연결 통계에는 앱의 백그라운드 요청, 재시도, 다른 실행 중인 작업이 포함될 수 있습니다. 특정 작업을 확인할 때는 시작 상태를 기록하고 한 가지 테스트만 수행한 뒤 증가분을 살펴보세요. 통계를 초기화할 수 있다면 초기화 범위를 먼저 확인해 필요한 기록을 잃지 않도록 합니다. 통계 계산 방식은 시스템이나 통신사의 요금 내역과 다를 수 있으므로 두 수치가 다르다는 이유만으로 문제를 단정하지 마세요. Data는 ‘전송이 있었는지, 재시도가 계속되는지’를 파악하는 단서로 사용하고 Log와 대상 앱의 결과를 함께 확인해 요청이 실제로 완료됐는지 판단하세요.
내보내기, 민감 정보 제거, 기록 중지
Log를 공유하기 전에 구독 주소, 인증 정보, 개인 도메인, 내부 네트워크 주소, 개인을 식별할 수 있는 요청 경로를 제거하세요. 서버 표시 이름만 가리는 것으로는 충분하지 않습니다. 쿼리 매개변수, 오류 앞뒤의 기록에 민감한 내용이 남아 있을 수 있습니다. 현재 서비스 제공업체에 문제를 설명할 때는 네트워크 유형, 실패 시각, 프로토콜 이름, 민감 정보를 제거한 오류 단계만 우선 전달하세요. 전체 백업을 보내지 마세요. 문제 해결이 끝나면 기록 옵션을 복원하고 필요에 따라 임시 파일을 정리하세요. 앱 데이터를 삭제할 계획이라면 유효한 Config를 별도로 저장했는지 확인하기 위해 먼저 iCloud 동기화 및 백업 안내를 읽으세요.
Widget: 상태 표시와 빠른 작업
Widget은 시스템에서 제공하는 빠른 정보 표시 또는 작업 실행 수단이지, 별도의 연결 구성을 사용하는 기능은 아닙니다. 어떤 정보를 표시하고 얼마나 자주 새로고침하며 어떤 동작을 실행할 수 있는지는 현재 시스템과 앱이 제공하는 Widget 유형에 따라 다릅니다. 먼저 Home에서 연결이 정상인지 확인한 다음 Widget을 추가하세요. Widget과 앱의 상태가 다르게 표시되면 앱을 다시 열어 실제 상태를 확인하는 것부터 시작하세요. Widget에 남은 오래된 표시 하나만 보고 서버 오류라고 판단하지 마세요. Widget이 바로 갱신되지 않는다고 기기 전체의 네트워크가 끊겼다고 볼 수도 없습니다. 표시 상태와 연결 상태를 각각 확인해야 합니다.
기본 상태: 추가된 Widget 기준으로 확인
홈 화면에 Widget이 있는지는 기기 배치와 이전 복원 상태에 따라 달라지며 앱 설치 후 자동으로 추가된다고 가정할 수 없습니다. 먼저 시스템의 Widget 선택 화면에서 Shadowrocket을 찾고 사용 가능한 크기와 설명을 확인하세요. 시스템에서 제공하지 않는 Widget을 다른 기기의 스크린샷을 보고 찾으려 하지 마세요. 필요한 정보를 분명하게 확인할 수 있는 크기를 선택하고 가능한 한 많은 항목을 넣는 데 집중하지 마세요. 추가한 뒤에는 기존 설정을 유지하면서 어떤 앱과 Config를 참조하는지 확인하고 표시 옵션을 하나씩 조정하세요. Widget 편집을 지원한다면 현재 선택된 항목을 기록해 Home의 선택을 항상 그대로 따르는 것으로 오해하지 않도록 하세요.
상태 갱신과 시스템 스케줄링
시스템이 백그라운드 갱신 빈도를 제한할 수 있으므로 Widget 표시가 늦어지는 일은 흔합니다. 잠금 화면, 저전력 상태, 최근 앱 사용 여부, 시스템 리소스 관리가 갱신 시점에 영향을 줄 수 있습니다. 먼저 Shadowrocket을 열어 상태를 확인한 뒤 홈 화면으로 돌아와 Widget이 갱신되는지 살펴보세요. 앱 안의 연결은 안정적이고 Widget만 늦게 갱신된다면 DNS나 서버를 바꾸기보다 표시 과정부터 확인하는 것이 좋습니다. 새로고침을 유도하려고 연속해서 빠르게 누르지 마세요. 연결을 실제로 전환하는 동작이 실행될 수 있어 단순한 표시 문제를 새로운 연결 문제로 만들 수 있습니다.
빠른 작업과 On Demand의 관계
Widget을 통한 동작과 On Demand의 자동 트리거가 차례로 발생할 수 있습니다. 연결을 끊었는데 곧 다시 연결되면 Widget을 먼저 삭제하지 말고 On Demand 조건을 확인하세요. 빠른 작업을 확인하려면 자동 트리거를 잠시 끄고 Home에서 초기 상태를 확인한 다음 Widget에서 한 번 동작을 실행하고 앱으로 돌아와 결과를 확인할 수 있습니다. 테스트 후에는 원래 On Demand 상태를 복원하세요. 여기서 확인할 것은 동작 요청이 전달됐는지 여부이며 Widget의 모든 문구가 즉시 바뀌는지가 아닙니다. 표시 갱신과 실제 작업 결과를 따로 기록해야 문제가 어느 단계에 있는지 판단할 수 있습니다.
Config 전환 후 참조 항목 확인
서버 추가, 기존 항목 삭제, Config 복원 후에는 빠른 작업이 참조하는 항목을 다시 확인해야 할 수 있습니다. Widget에서 서버나 동작을 선택할 수 있다면 편집 화면을 열어 유효한 항목을 참조하는지 확인하세요. 선택 기능이 없다면 실제 Widget 설명을 기준으로 판단합니다. 이름이 같은 서버 두 개를 완전히 동일하다고 보지 마세요. 구독 업데이트로 항목 내용이 달라졌을 수 있습니다. 자주 사용하는 항목에는 본인이 구분하기 쉽고 민감한 정보를 노출하지 않는 이름을 지정하세요. 변경한 뒤 앱 안에서 먼저 테스트하고 빠른 작업도 확인하면 참조 항목 문제와 네트워크 연결 문제를 나눠서 처리할 수 있습니다.
홈 화면 및 잠금 화면의 개인정보 보호
Widget 유형과 시스템 설정에 따라 다른 사람이 화면에서 연결 상태, 트래픽, 항목 이름을 볼 수 있습니다. 추가하기 전에 실제 미리보기를 확인하고 개인 서비스 주소나 계정 정보를 표시 이름에 넣지 마세요. 기기 스크린샷을 공유할 때도 Widget이 사용 습관을 드러내지 않는지 확인해야 합니다. 잠금 화면에 표시되는 정보와 작업 권한은 시스템 설정의 영향을 받으므로 홈 화면에서 실행할 수 있는 동작이 잠금 화면에서도 같다고 가정하지 마세요. 업무용 또는 관리 대상 기기라면 기기 관리 정책도 준수해야 합니다. 이해하지 못한 시스템 제한을 빠른 작업을 위해 바꾸지 마세요.
Widget이 계속 비어 있다면 앱이 정상적으로 열리는지, Widget 유형이 여전히 제공되는지, 참조 항목이 존재하는지 순서대로 확인한 다음 Widget을 제거하고 다시 추가해 보세요. 다시 추가하는 것은 표시 문제를 점검하는 방법입니다. 앱을 삭제하거나 Config를 초기화하는 것부터 시작하지 마세요. 다시 추가해도 문제가 남지만 Home의 연결과 접속이 정상이라면 앱 안에서 작업을 이어가고 재현 조건을 기록해 추가로 확인하세요. 빠른 작업 하나 때문에 네트워크 설정 전체를 다시 만들 필요는 없습니다. 문제 해결 범위는 항상 실제 문제가 발생한 계층으로 제한하세요.
iCloud 동기화, 백업 및 복원
동기화는 기기 간에 상태를 전달하고 백업은 복구할 수 있는 과거 사본을 보관하는 기능이므로 서로 같지 않습니다. 동기화가 변경 사항이나 삭제를 전파할 수 있으므로 iCloud를 켜 두었다고 실수로 삭제한 내용을 언제든 복구할 수 있는 것은 아닙니다. 주요 Config를 바꾸기 전에 앱에서 제공하는 방식으로 식별 가능한 Config 사본을 내보내고 동기화 상태도 확인하세요. 내보낸 Config에 모든 서버, 구독, 앱 설정이 포함된다고 자동으로 가정하지 마세요. 내보내기 항목마다 실제 범위를 확인해야 합니다. 새 기기로 옮기기 전에 앱 복원, Config 복원, 서비스 정보 재확인을 각각 별도로 고려하세요.
기본 상태: 시스템과 앱 양쪽 조건 확인
먼저 시스템 설정에서 기기에 예상한 계정이 로그인되어 있고 iCloud 관련 기능을 사용할 수 있는지 확인한 다음 Shadowrocket의 동기화 옵션을 살펴보세요. 메뉴 위치는 현재 시스템과 앱 화면을 기준으로 확인하세요. 다른 기기의 메뉴 경로를 고정된 안내로 보지 마세요. 동기화 가능하다고 명시된 항목과 기기에만 저장되는 항목을 기록하세요. 화면에 설명이 없는 항목은 자동으로 이전된다고 가정하지 마세요. 기존 기기를 사용할 수 있을 때 다른 기기에서 Config 이름과 내용이 나타나는지 비교하는 등 작은 항목 하나로 확인하는 것이 좋습니다. 스위치가 켜져 있는 것만으로 최근 변경 사항이 성공적으로 전달됐다고 볼 수 없습니다.
내보내기 전에 파일 내용과 민감 정보 확인
Config를 내보낼 때 먼저 현재 사용 중인 파일이 선택됐는지 확인하세요. 이름이 같은 오래된 사본을 내보내지 않도록 주의합니다. 저장 후 파일을 다시 열 수 있는지, 규칙이 온전히 들어 있는지 확인하고 용도를 구분할 수 있는 이름을 지정하세요. Config에는 서버 주소, 인증 정보, 원격 리소스 주소가 포함될 수 있으므로 본인이 관리하고 적절한 접근 제한을 설정할 수 있는 곳에 백업하세요. 전체 파일을 공개 공유 폴더에 넣거나 도움을 받기 위해 파일 전체를 보내지 마세요. 파일 용도, 활성 모드, 별도로 복구해야 할 항목을 설명하는 짧은 메모도 보관하세요. 민감한 인증 정보를 메모 제목에 적지 마세요.
여러 기기에서 충돌이 나면 먼저 보존한 뒤 동기화
두 기기에서 같은 내용을 오프라인으로 수정한 뒤 다시 동기화하면 버전 충돌이 발생하거나 결과가 예상과 다를 수 있습니다. 이때 양쪽에서 편집을 계속하지 말고 접근 가능한 사본을 각각 내보낸 다음 실제 내용을 비교하세요. 파일 이름이 같다고 내용도 같다고 단정하지 마세요. 수정 시간이 더 최근인 파일이 반드시 올바르다고 가정해서도 안 됩니다. 기기 시간, 동기화 지연, 일부 내용만 편집한 상황이 판단에 영향을 줄 수 있습니다. 먼저 검증을 마친 기준 사본을 하나 선택하고 앱에서 현재 제공하는 동기화 또는 가져오기 방식으로 복원하세요. 충돌 처리 안내가 명확하지 않다면 원하는 결과가 나올 때까지 동기화를 반복해서 껐다 켜지 마세요.
기기 교체 후 단계별 복원 확인
새 기기에서 복원한 뒤 Shadowrocket이 실행되는지 먼저 확인하세요. 이어서 서버 목록, 구독 항목, Config 파일, Global Routing을 확인하고 마지막으로 On Demand와 Widget 등 추가 기능을 테스트합니다. 사용자가 보유한 구독을 다시 업데이트해야 할 수 있으며 일부 인증은 기기나 서비스 상태에 따라 달라질 수 있으므로 현재 서비스 제공업체에 확인하세요. 새 기기에서는 Home에서 수동으로 한 번 연결해 기본 접속이 정상인지 확인한 뒤 자동 연결을 활성화하는 것이 좋습니다. 이전 기기의 환경 조건이 새 기기의 테스트에 영향을 주지 않게 하세요. 복원이 끝났다고 확인까지 완료된 것은 아닙니다. 목록에 항목이 보이는 것만 확인하지 말고 각 요청을 실제로 테스트하세요.
| 단계 | 확인할 내용 | 기존 기기를 보관하는 이유 |
|---|---|---|
| 서비스 정보 | 구독, 서버 및 인증 사용 가능 여부 | 누락 항목을 확인하기 쉽습니다 |
| Config 파일 | 규칙, 정책, 활성 파일이 일치하는지 | 실제 내용을 비교할 수 있습니다 |
| 자동 동작 | On Demand와 Widget이 새 환경에 맞는지 | 이전 네트워크 조건을 그대로 적용하지 않도록 합니다 |
동기화 문제 확인 순서
변경 내용이 보이지 않으면 먼저 두 기기에서 예상한 계정을 사용 중인지, 네트워크를 사용할 수 있는지, 클라우드 저장 공간에 문제가 없는지, 앱에 오류 메시지가 표시되는지 확인하세요. 이어서 각 기기에서 앱을 열고 동기화를 기다린 뒤 특정 항목 하나를 비교합니다. 한 번에 많은 항목을 수정하지 마세요. 아직 동기화되지 않은 로컬 데이터가 복구되지 않을 수 있으므로 계정에서 즉시 로그아웃하거나 앱을 삭제하지 마세요. 자세한 단계별 안내는 iCloud 동기화, Config 내보내기 및 기기 교체 후 복원 절차를 참고하세요. 새 기기의 Config와 연결을 모두 확인할 때까지 기존 기기와 별도 백업을 보관하세요.
Proxy 포트와 설정 복구 순서
로컬 Proxy 포트는 다른 프로그램이 접속하는 진입점이지 원격 서버 포트가 아닙니다. 원격 포트는 사용자가 보유한 서비스의 연결 매개변수이고 로컬 수신 포트는 현재 기기 또는 접근이 허용된 프로그램이 사용하는 포트입니다. 숫자가 같아도 의미는 다릅니다. 로컬 프록시를 사용할 분명한 이유가 없다면 관련 옵션을 기존 상태로 유지하고 ‘속도 향상’을 위해 임의로 바꾸지 마세요. 수신 기능 지원 여부, 사용할 수 있는 프로토콜, 다른 기기에서 접속할 수 있는지는 현재 플랫폼의 실제 옵션을 확인해야 합니다. 데스크톱이나 다른 기기의 설정을 현재 환경에 그대로 적용하지 마세요.
기본값: 포트, 프로토콜, 수신 주소 확인
확인할 때는 포트, 프록시 프로토콜, 수신 주소, LAN 접속 허용 여부를 함께 기록하세요. HTTP와 SOCKS5가 같은 진입점을 사용한다고 가정하지 말고 예시 숫자를 제품의 고정 기본값으로 보지 마세요. 클라이언트 프로그램에서 지정한 프로토콜은 수신 포트의 프로토콜과 일치해야 합니다. 그렇지 않으면 포트에 연결되더라도 요청 형식이 거부될 수 있습니다. 포트가 다른 로컬 서비스와 충돌하지 않는지도 확인하세요. 활성화 직후 사용 중이라는 메시지가 나오면 숫자를 계속 바꾸기보다 충돌 원인을 먼저 찾으세요. 기존 설정을 기록하고 해당 진입점을 사용할 프로그램을 확인한 뒤 필요한 범위만 조정하는 것이 좋습니다.
기기 내부 접속과 LAN 접속의 범위
루프백 주소에서 수신하도록 설정하면 일반적으로 현재 기기에서만 접속할 수 있습니다. 다른 기기의 접속을 허용하려면 수신 범위, 네트워크 격리, 방화벽, 기기의 전원 및 연결 상태를 함께 고려해야 합니다. 현재 기기에서 사용할 수 있다고 같은 Wi-Fi의 다른 기기에서도 작동한다고 단정하지 마세요. 필요한 범위만 허용하는 것이 좋으며 현재 기기에서만 사용할 경우 LAN으로 범위를 넓히지 마세요. 기기 간 접속이 꼭 필요하다면 네트워크를 신뢰할 수 있는지, 접근 제어와 인증 옵션이 적절한지 먼저 확인하고 사용이 끝나면 설정을 되돌리세요. 공용 네트워크의 다른 기기가 로컬 Proxy에 접속할 권한이 있다고 가정해서는 안 됩니다.
Proxy 루프와 반복 전달 방지
프로그램에서 로컬 Proxy를 사용하도록 설정할 때 요청이 같은 진입점으로 다시 전달되어 루프가 생기지 않는지 확인하세요. 요청이 계속 재시도되거나 연결 수가 비정상적으로 늘거나 Proxy를 켠 뒤 관련 요청이 모두 멈추는 현상이 단서일 수 있습니다. 먼저 테스트 프로그램 하나만 해당 진입점을 사용하게 하고 대상 주소와 포트를 확인하세요. 시스템 Proxy, 앱 Proxy, Config를 동시에 바꾸지 마세요. 되돌릴 때는 먼저 테스트 프로그램의 Proxy 설정을 취소한 다음 Shadowrocket의 수신 옵션을 복원하세요. 이렇게 하면 로컬 진입점이 작동하지 않더라도 프로그램이 더 이상 존재하지 않는 주소를 가리키지 않습니다.
실패 단계에 따라 설정 복원
여러 항목을 바꾼 뒤 원인을 알기 어렵다면 가장 최근에 기록한 항목 하나부터 기존 값으로 되돌린 다음 바깥 단계부터 차례로 확인하세요. 현재 네트워크에서 직접 접속할 수 있는지, Home에서 수동 연결이 되는지, Global Routing이 명확하게 설정됐는지, 활성 Config가 올바른지, DNS 응답을 설명할 수 있는지, 대상 요청에 예상한 정책이 적용되는지 확인합니다. 그다음 On Demand와 Widget 같은 자동 연결 및 표시 기능을 복원하세요. 데이터 전체 삭제를 첫 단계로 삼지 마세요. 문제를 확인할 근거와 사용 가능한 Config가 함께 사라질 수 있습니다. 다시 가져와야 한다면 가치 있는 데이터를 먼저 내보내고 사용 중인 구독과 서버 정보를 다시 받을 수 있는지 확인하세요.
앱 설치 문제와 다운로드 경로를 따로 확인
앱을 다시 받아야 한다면 전체 플랫폼 다운로드 페이지에서 제공 경로를 확인하세요. iPhone / iPad 버전은 App Store에서 $2.99 일회성 구매이며, Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 데스크톱 및 Android 설치 파일은 이 사이트의 /dl/에서 제공합니다. iPhone / iPad의 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. 개발자 Shadow Launch Technology Limited와 앱 ID 932747118도 확인할 수 있습니다. 앱을 다시 설치해도 서버 매개변수 확인을 대신하거나 만료된 구독을 자동으로 해결하지는 않습니다. 작업 전에 Config를 안전하게 보관하세요.
데스크톱이나 Android에서 처음 실행할 때 시스템이 차단하면 먼저 파일을 이 사이트의 다운로드 페이지에서 받았는지 확인한 뒤 페이지 안내를 따르세요. macOS에서는 ‘개인정보 보호 및 보안’에서 확인한 뒤 ‘그래도 열기’를 선택하고, Windows에서는 SmartScreen을 확인한 다음 ‘자세한 정보’를 여세요. Android에서는 실제로 파일을 다운로드한 브라우저에만 ‘알 수 없는 앱 설치 허용’을 켜고 설치 후에는 권한을 끌 수 있습니다. Mac은 ‘이 Mac에 관하여’에서 칩 정보를 확인해 알맞은 설치 파일을 선택하세요. 기기 아키텍처를 추측하지 마세요. 설치 단계별 안내는 설치 허용 안내에서 확인하세요. DNS, Ping, Proxy 포트를 바꿔 시스템 설치 경고를 해결하려 하지 마세요.
다시 재현할 수 있는 결론을 남기세요
문제 해결을 마칠 때는 ‘모든 스위치를 켜니 정상 작동’이라고 쓰기보다 ‘지정한 네트워크에서 기존 DNS를 복원하자 대상 요청이 완료됨’처럼 효과가 있었던 변경과 조건을 한 문장으로 설명하세요. 원래 정상이던 앱, 네트워크 전환, 수동 재연결도 각각 확인한 뒤 테스트 규칙, 임시 Log, 더 이상 사용하지 않는 로컬 진입점을 정리하세요. 문제가 계속되면 민감 정보를 제거한 실패 단계와 함께 질문과 답변에서 원인을 더 찾아보세요. 전체 절차를 다시 진행해야 한다면 빠른 시작 가이드로 돌아가세요. 설정 가이드는 각 변경 사항을 설명하고 확인한 뒤 원래대로 복구할 수 있도록 돕습니다.