SETTINGS REFERENCE
Shadowrocket Settings 설정 항목 참고
먼저 설정이 어디에 적용되는지 확인한 다음 값을 변경하세요. 이 페이지는 문제별로 찾아볼 수 있는 공식 매뉴얼입니다. 기존 구독을 처음 가져오고, 노드를 선택해 연결하는 방법은 먼저 사용 설명서를 확인한 뒤, 기본 절차를 마치고 해당 항목으로 돌아오세요.
Shadowrocket은 iPhone, iPad, Mac, Windows, Android, Linux에서 사용할 수 있습니다. 이 페이지는 iPhone / iPad의 Settings 화면 용어를 기준으로 설명합니다. 다른 플랫폼은 해당 메뉴가 실제로 제공되는 경우에만 참고하고, 특정 시스템 전용 기능이 모든 플랫폼에 있다고 가정하지 않습니다.
iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하며, Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 다운로드 경로와 시스템에서 실행을 허용하는 방법은 전체 플랫폼 다운로드 페이지에서 확인하세요. iPhone / iPad의 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다. 클라이언트 구매와 회선 요금제는 별개입니다. 구독이나 서버 정보는 이용 중인 서비스 제공업체에서 확인하세요. 이 사이트는 해당 서비스를 제공하거나 판매·추천하지 않습니다.
기본값이 권장값을 뜻하는 것은 아닙니다
기존 설치 환경에는 백업 복원, 구성 가져오기, 이전 설정이 남아 있을 수 있습니다. 확인되지 않은 스위치의 공통 기본값을 임의로 단정하지 않습니다. 여기서 ‘기본 상태 유지’란 현재 설치에서 변경하지 않은 초기 상태를 유지하고, 화면에 표시된 값을 먼저 기록하는 것을 뜻합니다. 한 번에 변수 하나만 바꾸고 결과를 확인한 뒤 유지 여부를 결정하세요.
01 / SCOPE
적용 범위, 기본 상태 및 변경 순서
먼저 Settings, Config, 시스템 권한을 구분하세요
설정을 점검하기 전에 문제를 세 단계로 나누세요. Settings는 테스트 방식, 로그, 앱 기본 설정 등 클라이언트 동작을 관리합니다. Config의 현재 구성은 규칙과 일부 네트워크 처리 방식을 결정합니다. 시스템 권한은 클라이언트가 시스템 네트워크 연결을 만들고, 로컬 네트워크에 접근하거나 클라우드 기능을 사용할 수 있는지 결정합니다. 같은 증상도 원인은 서로 다른 단계에 있을 수 있습니다. 연결 스위치가 유지되지 않는다고 해서 반드시 DNS가 잘못된 것은 아니며, 웹페이지가 열리지 않는다고 바로 규칙이 적용되지 않았다고 단정할 수도 없습니다. 현재 화면, 선택한 구성, 실제로 표시된 안내를 먼저 기록한 다음 관련 설정을 확인하면, 반복해서 값을 바꾸면서 어떤 변경이 효과가 있었는지 모르는 상황을 줄일 수 있습니다.
이 페이지에서 말하는 ‘기본 상태 확인’은 특정 조합으로 모든 스위치를 되돌리라는 뜻이 아니라 확인 절차를 의미합니다. 처음 확인할 때는 각 항목의 현재 값, 비어 있는지 여부, 구성에서 제공한 값인지, 시스템 권한 안내가 있는지를 기록하세요. 이전 기기에서 옮겨온 설정은 새로 설치했을 때의 기본값을 보여주지 않을 수 있습니다. 클라우드에서 복원된 내용도 현재 네트워크에 적합하지 않을 수 있습니다. 표준값을 맞추려고 사용 중인 구성을 삭제하거나 앱을 재설치하지 마세요. 여러 조건이 동시에 바뀌어 문제를 재현하기 어려워집니다.
Global Routing은 규칙 적용 여부를 결정합니다
Global Routing의 Config, Proxy, Direct는 각각 현재 구성에 따른 규칙 처리, 프록시 경로, 직접 연결을 의미합니다. Config는 현재 구성의 규칙에 따라 요청을 처리합니다. Proxy는 관련 트래픽을 프록시 경로로 처리하고, Direct는 직접 연결합니다. 이 설정들은 서버 매개변수를 수정하거나 대상에 연결할 수 있게 해주는 기능이 아닙니다. 규칙을 점검할 때는 Config를 사용하세요. 다른 경로로 잠시 전환하는 것은 같은 대상이 경로에 따라 어떻게 동작하는지 비교하기 위한 것입니다. 테스트가 끝나면 원래 설정으로 되돌리세요. 그렇지 않으면 이후 규칙을 수정해도 효과가 없는 것처럼 보일 수 있습니다.
| 모드 | 확인할 항목 | 확인에 적합한 질문 |
|---|---|---|
| Config | 현재 구성, 규칙 순서 및 정책 | 이 요청에 적용된 규칙은 무엇인가요? |
| Proxy | 선택한 노드와 연결 매개변수 | 프록시 경로 자체가 작동하나요? |
| Direct | 로컬 네트워크와 대상에 대한 연결 가능성 | 프록시 경로를 거치지 않으면 증상이 달라지나요? |
스위치를 연달아 바꾸는 대신 되돌릴 수 있는 기록을 남기세요
기본 정보 네 가지를 기록하는 것이 좋습니다. Wi-Fi 또는 셀룰러 네트워크 중 어떤 네트워크를 사용하는지, 현재 어떤 구성과 노드를 선택했는지, Global Routing이 어떤 모드인지, 문제가 연결 전과 연결 후 중 언제 발생하는지 기록하세요. 그런 다음 변경할 항목 하나와 예상되는 변화를 적습니다. 예를 들어 DNS를 조정할 예정이라면 검증 목표를 ‘같은 도메인이 조회되고 열리는가’로 정하고, 막연히 네트워크가 빨라졌는지만 보지 마세요. 테스트 대상을 동일하게 유지해야 결과를 이번 설정 변경과 연결할 수 있습니다.
값을 변경한 뒤에는 먼저 요청을 새로 시작하세요. 터널 설정 단계에 영향을 주는 항목이라면 연결을 끊었다가 다시 연결한 다음 테스트할 수 있습니다. 연결을 오래 유지하는 앱은 기존 세션을 계속 사용할 수 있으므로, 이전에 열어 둔 페이지가 여전히 오류를 표시한다고 해서 새 값이 적용되지 않았다고 단정할 수 없습니다. 연속으로 새로고침하기보다는 해당 페이지를 닫고 다시 방문하세요. 결과가 나아지지 않으면 방금 기록한 값으로 먼저 되돌린 뒤 다음 항목을 확인하세요. 한 번의 테스트에서 노드와 구성을 바꾸고 DNS를 수정하며 On Demand까지 켜지 마세요. 정상으로 돌아와도 원인을 알 수 없게 됩니다.
권장 초기 설정 원칙
정상 작동하는 항목은 그대로 두세요. 서비스 제공업체가 지정한 프로토콜 매개변수는 원본 자료에 따라 입력하세요. 자동 재연결이나 외부 연결 허용 같은 추가 동작은 기본 연결을 검증한 뒤에 활성화하세요. 의미를 모르는 항목은 이름만 보고 추측하지 말고 현재 초기 상태로 유지하세요.
문제를 정확히 파악해야 한다면 테스트마다 한 문장으로 결과를 기록하세요. 무엇을 변경했는지, 요청을 어떻게 시작했는지, 결과가 어땠는지, 되돌렸는지 적으면 됩니다. 구독 주소나 비밀번호는 기록할 필요가 없습니다. 기기 간 결과를 비교할 때도 시스템 권한, 네트워크, 구성 사본이 다를 수 있으므로 각각 따로 기록하세요. 화면 용어는 용어집에서 확인할 수 있습니다. 이 페이지의 나머지 항목은 같은 기록 방법에 따라 설정별 점검 절차를 설명합니다.
02 / DNS
DNS: 조회 경로와 웹페이지가 열리지 않는 문제 확인
DNS는 이름을 조회하며 연결이나 규칙을 대신하지 않습니다
DNS는 도메인 이름을 주소로 변환하며, 웹사이트에 접속하기 전에 거치는 일반적인 단계입니다. 실제 접속에는 규칙 매칭, 서버 연결, TLS 협상, 콘텐츠 전송도 포함될 수 있습니다. 따라서 ‘지연 시간은 정상인데 웹페이지가 열리지 않는다’는 증상만으로 DNS 문제라고 단정할 수 없습니다. 먼저 로그에서 대상 주소가 조회되는지 확인하고, 그다음 연결 단계에서 실패하는지 살펴보세요. 주소가 이미 조회됐는데 연결 시간 초과가 발생한다면 DNS 서버를 계속 바꿔도 연결 경로나 프로토콜 매개변수 오류가 해결되지 않습니다. 선택한 노드의 서버 도메인조차 조회되지 않는다면 프록시 연결을 시작하기 전의 기본 DNS부터 점검하세요.
DNS 설정은 현재 Config에 포함된 관련 항목의 영향을 받을 수 있습니다. Settings에서 값을 바꾸기 전에 현재 구성을 함께 확인하세요. 한쪽을 수정해도 다른 설정이 실제 동작을 결정할 수 있습니다. 입력란이 비어 있다고 해서 ‘DNS가 없다’고 단정할 수는 없습니다. 시스템이나 구성에서 제공하는 방식을 따르는 상태일 수 있습니다. 기본 상태는 현재 설치 화면과 선택한 구성을 기준으로 확인하세요. 네트워크가 정상이라면 기존 조회 방식을 유지하는 것이 좋습니다. 재현 가능한 조회 오류가 있을 때만 비교 테스트를 거쳐 조정하세요.
주소를 입력하기 전에 필드가 요구하는 형식을 확인하세요
먼저 화면에서 요구하는 값이 DNS 서버 주소인지, 프로토콜이 포함된 엔드포인트인지, 구성 텍스트의 한 줄인지 확인하세요. 이름에 DNS가 들어간다고 해서 서로 다른 필드에 같은 값을 복사할 수 있는 것은 아닙니다. 입력 전 앞뒤 공백, 전각 문장 부호, 줄바꿈을 확인하세요. 암호화된 DNS 엔드포인트를 사용한다면 해당 입력란에서 그 형식을 지원하는지, 엔드포인트에 실제로 접속할 수 있는지도 확인해야 합니다. 주소가 올바른 모양이라고 해서 경로가 작동한다고 볼 수는 없습니다. DNS 서비스 연결은 현재 네트워크, 인증서 검증, 기기 시간에도 영향을 받습니다.
현재 네트워크에서 연결할 수 있고 기존 구성에 명시된 조회 방식을 우선 사용하세요. 변경이 필요하면 작동하는 기본 경로를 남겨 두고, 출처가 불분명한 주소를 한꺼번에 여러 개 입력하지 마세요. DNS 서버가 많다고 더 안정적인 것은 아닙니다. 그중 하나가 비정상 응답을 보내면 요청에 따라 결과가 달라질 수 있습니다. 테스트 중에는 네트워크와 노드를 고정하고, 이전에 오류가 났던 도메인 하나와 평소 정상인 도메인 하나를 각각 방문해 주소가 반환되는지 기록하세요. 우연히 페이지 하나가 열렸는지만 보지 마세요.
| 관찰된 증상 | 우선 확인할 항목 | 다음 단계 |
|---|---|---|
| 노드 도메인을 조회할 수 없음 | 연결 전 시스템 네트워크와 기본 DNS 조회 | 기본 네트워크를 먼저 복구한 뒤 연결 |
| 대상 도메인 조회 실패 | 현재 DNS 설정 및 구성의 관련 항목 | 조회 방식만 조정한 뒤 요청을 다시 보내기 |
| 주소는 있지만 연결 시간 초과 | 선택한 정책, 노드 및 대상 연결 가능성 | 연결 로그를 확인하고 DNS를 무작정 바꾸지 않기 |
| 일부 네트워크에서만 실패 | 네트워크 제한, 주소 체계, DNS 엔드포인트 연결 가능성 | Wi-Fi와 셀룰러 네트워크 결과를 따로 기록 |
캐시, 주소 체계, 규칙 간 상호 영향
시스템과 앱이 모두 조회 결과를 저장할 수 있으므로, 설정을 바꾼 직후 이전 페이지를 새로고침해도 이전 주소를 계속 사용할 수 있습니다. 먼저 연결을 다시 설정하고 접속 요청을 새로 시작하세요. 현재 화면에 DNS 캐시 삭제 기능이 있다면 기록을 남긴 뒤 사용할 수 있지만, 캐시 삭제를 장기적인 해결책으로 삼지는 마세요. 잠시 정상으로 돌아왔다가 다시 문제가 생긴다면 상위 DNS 응답이나 네트워크 변화를 확인해야 합니다. 특정 앱에서만 문제가 발생한다면 앱 자체의 DNS 조회 경로를 사용할 가능성도 고려하세요. 브라우저가 정상이라는 이유만으로 모든 앱이 같은 설정을 사용한다고 단정할 수 없습니다.
도메인은 IPv4와 IPv6 주소를 모두 반환할 수 있으며, 현재 네트워크에서 두 주소 유형의 연결 가능성은 다를 수 있습니다. IPv6가 보인다고 바로 비활성화하지 말고, 특정 주소 유형의 장애를 전체 DNS 장애로 오해하지도 마세요. 먼저 로그에서 실제 연결에 사용된 주소를 확인한 다음, 네트워크를 바꿨을 때 결과가 달라지는지 비교하세요. IP-CIDR 또는 IP-CIDR6 규칙을 사용하는 경우에는 조회된 주소가 바뀌어 규칙 적용 결과가 달라졌는지도 확인해야 합니다. DNS 조회 성공과 예상한 분할 처리는 각각 별도로 검증해야 합니다.
고정 주소 하나로 모든 도메인을 확인하지 마세요
일부 서비스는 도메인, TLS 호스트 이름, 동적 주소에 의존합니다. IP 주소로 직접 접속하지 못했다고 DNS 오류라고 단정할 수 없으며, 직접 접속에 성공해도 도메인을 사용한 전체 접속 과정이 정상이라는 뜻은 아닙니다.
조정이 끝나면 정상 도메인과 문제가 있던 도메인을 각각 다시 방문하고, 로그에서 DNS 조회와 연결 단계를 확인하세요. 특정 웹사이트에서만 문제가 생긴다면 발생 시각과 실패 단계를 기록하고 변경 범위를 넓히지 마세요. ‘테스트는 응답하지만 페이지가 열리지 않는’ 상황을 단계별로 확인하려면 DNS 문제 해결 안내를 참고하세요.
03 / ON DEMAND
On Demand: 자동 연결 조건과 수동 스위치
자동 조건을 켜기 전에 수동 연결부터 확인하세요
On Demand는 조건에 따라 연결 동작을 실행하는 기능이지 서버 가용성을 복구하는 스위치가 아닙니다. 노드를 직접 선택하고 연결을 켠 뒤 대상에 접속하는 과정이 모두 정상일 때만 자동 조건을 설정하는 것이 좋습니다. 그렇지 않으면 자동 재시도가 기존 문제와 뒤섞여 ‘끊자마자 다시 연결됨’, ‘네트워크를 바꾼 뒤 계속 시도함’ 같은 현상이 생길 수 있습니다. 처음 문제를 점검할 때는 기존 조건을 기록하고 On Demand를 잠시 비활성화하세요. 연결을 매번 직접 시작해야 실패 시점을 정확히 파악할 수 있습니다.
기본 상태는 현재 설치의 On Demand 화면에서 전체 스위치와 각 조건을 모두 확인하세요. 구성이나 기기 백업을 복원했다면 전체 스위치만 보고 모든 조건이 초기 상태라고 판단할 수 없습니다. 필요한 네트워크 상황에만 동작하도록 범위를 좁혀 시작하세요. 조건에 진입하고 벗어나는 상황을 한 번씩 확인한 뒤 다른 조건을 단계적으로 추가하는 것이 좋습니다. 다른 사람의 네트워크 이름을 그대로 사용하지 말고, 이름이 같다고 접속 가능한 네트워크도 같다고 가정하지 마세요.
네트워크 조건과 시스템 권한을 함께 확인하세요
현재 화면에서 네트워크 유형이나 Wi-Fi 이름별 조건을 설정할 수 있다면, 각 조건이 연결을 요구하는지 연결 해제를 요구하는지, 더 넓은 범위의 조건이 덮어쓰는지 확인하세요. 기기에서 실제로 인식하는 네트워크 이름을 기준으로 점검해야 합니다. 공백, 대소문자, 비슷한 문자가 판단에 영향을 줄 수 있습니다. 네트워크 정보를 읽는 데 시스템 권한이 필요할 수도 있습니다. 앱이 조건 판단에 필요한 정보를 가져오지 못한다면 같은 이름의 조건을 계속 추가하지 말고 시스템 권한과 화면 안내를 먼저 확인하세요.
현재 Wi-Fi에서 시작해 테스트할 수 있습니다. 수동 연결 상태를 기록하고 조건 하나를 활성화한 다음 해당 네트워크에서 나갔다가 다시 연결해 예상한 동작이 나타나는지 살펴보세요. 그다음 셀룰러 네트워크를 별도로 테스트하세요. 네트워크 전환에는 시스템이 연결을 다시 설정하는 과정이 포함되므로, 짧은 시간 동안 여러 번 전환한 뒤 최종 스위치 상태만 확인해서는 안 됩니다. 각 단계에서 네트워크가 안정될 때까지 기다린 뒤 새 요청을 보내고, 조건이 실행된 시각을 연결 로그와 대조하세요. 그래야 조건 미일치와 연결 실패를 구분할 수 있습니다.
수동으로 끊은 뒤 다시 연결되면 실행 조건을 확인하세요
On Demand가 활성 상태라면 수동으로 연결을 끊어도 자동 실행이 영구히 중단되지 않을 수 있습니다. 이후 네트워크 이벤트나 요청이 발생하면 시스템이 기존 조건을 다시 처리할 수 있습니다. 연결을 계속 끊어 두어야 한다면 연결 스위치를 반복해서 누르지 말고 On Demand 전체 스위치와 관련 조건을 확인하세요. 변경 후 시스템 VPN 상태를 다시 살펴보고 여전히 작동 중인 자동 조건이 없는지 확인하세요. 실행 여부는 실제 조건과 시스템 동작을 기준으로 판단하고, 반복 연결을 모두 ‘스위치 고장’으로 뭉뚱그리지 마세요.
시스템에 저장된 VPN 구성과 현재 연결 상태도 구분해야 합니다. 구성 추가를 허용했다는 것은 시스템에 해당 연결 구성이 있다는 뜻이지, 항상 트래픽이 전송되고 있다는 뜻은 아닙니다. 이전에 권한을 거부했거나 시스템 구성을 삭제했다면 On Demand도 이 문제를 우회할 수 없습니다. 먼저 수동 연결을 시도하고 시스템 안내에 따라 권한을 부여한 다음 조건 설정으로 돌아오세요. 권한과 시스템 구성의 관계는 VPN 구성 추가 안내를 참고하세요.
네트워크 전환 문제의 되돌리기 순서
조건 기록 → On Demand 일시 중지 → 수동 재연결 → 안정된 네트워크에서 확인 → 조건을 하나씩 복원. 시스템 구성을 삭제하고 노드 매개변수를 동시에 변경하지 마세요. 어느 변경이 결과에 영향을 주었는지 알 수 없게 됩니다.
자동 연결은 사용 가능한 경로를 자동으로 선택하는 기능이 아닙니다
연결을 실행하고, 노드를 선택하고, 대상에 연결할 수 있는지 확인하는 일은 서로 다릅니다. On Demand가 정상적으로 연결을 시작해도 선택한 노드가 만료되었거나 매개변수가 맞지 않을 수 있습니다. 연결이 되더라도 모든 대상이 예상대로 분할 처리되는 것은 아닙니다. 반복해서 확인할 수 있도록 테스트 대상을 정해 두세요. 하나는 로컬 네트워크, 하나는 프록시 경로를 확인하는 데 사용하고, 현재 규칙 적용 결과도 살펴보세요. 문제가 생기면 이 세 단계에 따라 확인하고, 스위치를 켜진 상태로 유지하려고 자동 조건 범위를 계속 넓히지 마세요.
공용 네트워크에서 로그인이나 확인 페이지를 먼저 완료해야 한다면, 자동 연결을 확인하기 전에 기본 네트워크를 사용할 수 있는지 확인하세요. 기본 접속이 불가능한 네트워크는 선행 조건이 충족되지 않은 상태이므로, 더 적극적인 재연결 조건으로 문제를 가려서는 안 됩니다. 테스트를 마친 뒤 조건을 사용하는 목적과 적용할 네트워크를 기록하세요. 이후 네트워크 이름, 기기 권한, 사용 습관이 바뀌면 기록을 기준으로 하나씩 점검하는 편이 조건 전체를 다시 가져오는 것보다 관리하기 쉽습니다.
04 / PING
Ping 및 Connectivity Test: 테스트 결과의 한계
테스트 방식을 확인한 뒤 지연 시간을 해석하세요
Ping은 진단을 시작하는 수단이지, 모든 테스트가 같은 방식으로 탐지한다고 볼 수는 없습니다. 실제 결과는 선택한 테스트 방식, 대상, 현재 네트워크에 따라 달라집니다. TCP 연결, 일반 탐지, 프록시를 거치는 앱 계층 요청은 확인하는 경로가 서로 다릅니다. 설정을 열면 현재 방식을 먼저 기록하고 테스트를 실행하세요. 기본 테스트 방식은 현재 화면에 표시된 값을 기준으로 확인하고, 검증하지 않은 특정 방식을 공통 초기값으로 간주하지 마세요. 두 결과를 비교하려면 테스트 방식과 대상을 동일하게 유지해야 합니다. 그렇지 않으면 수치 자체를 직접 비교할 수 없습니다.
노드에서 응답이 확인되면 보통 이번 탐지가 확인한 단계에서 응답을 받았다는 뜻일 뿐입니다. 인증 매개변수, 대상 웹사이트 접속, 지속적인 전송 안정성을 단독으로 증명하지는 않습니다. 반대로 시간 초과가 발생했다고 서버가 완전히 오프라인이라는 뜻도 아닙니다. 테스트 대상에 연결할 수 없거나 해당 유형의 탐지가 제한되었거나 제한 시간이 부족해도 비슷한 결과가 나올 수 있습니다. 테스트 결과는 범위를 좁히는 단서로 활용하고 실제 요청으로 다시 확인하세요. 노드 목록의 숫자 하나만으로 최종 결론을 내리지 마세요.
테스트 대상, 시간 초과, 반복 횟수 선택
현재 화면에서 테스트 주소를 지정할 수 있다면, 이용 권한이 있고 안정적으로 접속되며 응답 과정이 단순한 대상을 선택하세요. 테스트 대상에서 로그인이 필요하거나 리디렉션이 발생하거나 접속이 제한되면 변수가 늘어납니다. 수치가 작아 보이는 주소를 찾으려고 자주 바꾸지 마세요. 기존 대상을 기준으로 유지하고 실패가 반복되는지 확인한 다음, 대상만 바꿔 비교하세요. 대상을 바꾼 뒤 정상으로 돌아왔다면 대상 차이 때문인지 연결 경로가 실제로 복구된 것인지 확인해야 합니다.
시간 초과 설정이 있다면 우선 초기값을 유지하는 것이 좋습니다. 너무 짧으면 정상이나 느린 요청을 시간 초과로 판정할 수 있고, 너무 길면 각 테스트에서 기다리는 시간만 늘어날 뿐 서버 연결 가능성이 높아지지는 않습니다. 현재 네트워크에서 연결을 설정하는 데 실제로 더 긴 시간이 필요하다고 확인된 경우에만 값을 조금씩 조정하고 다시 테스트하세요. 반복 횟수는 적은 횟수로 간격을 두고 테스트하는 편이 결과를 읽기 쉽고, 순간적인 네트워크 변동을 장기적인 상태로 오해하는 일도 줄여줍니다.
| 테스트 단계 | 확인할 수 있는 내용 | 단독으로 증명할 수 없는 내용 |
|---|---|---|
| 서버 포트 연결 | 주소와 포트에 연결을 설정할 수 있는지 | 프로토콜 인증과 대상 접속의 정상 여부 |
| 프록시를 거치는 요청 | 이번 프록시 요청이 완료되었는지 | 모든 웹사이트와 앱의 정상 작동 |
| Connectivity Test | 현재 테스트 조건에서의 연결 상태 | 향후 네트워크 전환 후에도 계속 사용할 수 있는지 |
시간 초과 후 확인 순서
먼저 기기의 기본 네트워크가 작동하는지 확인한 다음 서버 주소와 포트를 점검하세요. 이어서 프로토콜 유형과 인증 항목을 확인합니다. Shadowsocks의 암호화 방식과 비밀번호, VMess 또는 VLESS의 ID 항목, Trojan의 인증 및 TLS 관련 설정은 모두 서버 원본 자료와 하나씩 대조해야 합니다. WireGuard와 Hysteria2에도 각각의 매개변수가 있으므로 일부 항목이 비슷해 보인다는 이유로 서로 적용하지 마세요. 서비스 제공업체의 안내가 불분명하면 정확한 매개변수를 제공업체에 문의하고, 무작위로 값을 바꿔 결과를 시험하지 마세요.
기기 시간도 확인할 만한 항목입니다. 시간 차이는 인증서 검증이나 시간 조건이 있는 연결 과정에 영향을 줄 수 있지만, 시간을 맞추는 것이 모든 시간 초과 문제의 해결책은 아닙니다. 먼저 시스템 시간과 시간대를 올바르게 설정한 뒤 같은 테스트를 반복하세요. 특정 노드만 문제가 있다면 네트워크를 그대로 두고 해당 노드를 확인하세요. 모든 노드에서 동시에 문제가 발생한다면 네트워크, DNS, 테스트 대상처럼 공통된 조건부터 살펴보세요. 올바른 노드 매개변수를 하나씩 변경하지 않도록 주의하세요.
테스트가 정상이어도 실제 접속을 확인하세요
사용할 노드를 선택하고 Global Routing 모드를 확인한 다음 연결을 설정하고 새 요청을 보내세요. Log에서 요청이 예상한 정책을 따랐는지 확인합니다. 백그라운드에서 이미 연결된 장시간 세션만으로 판단하지 마세요. 새로 연 페이지가 해당 요청의 로그와 연결하기 쉽습니다. 업로드, 스트리밍 또는 장시간 세션이 중요하다면 실제 사용 환경에서도 추가로 확인하세요. 짧은 탐지 테스트만으로 이런 앱 사용 상황을 대신할 수는 없습니다.
문제 해결 기록에는 테스트 방식, 네트워크 유형, 실패 단계, 발생 순서만 남기면 됩니다. 보통 노드 정보를 전부 공개할 필요는 없습니다. 노드 시간 초과를 정해진 절차에 따라 확인하려면 노드 시간 초과 및 연결 실패 점검 순서를 참고하세요. 테스트를 마친 뒤에는 평소 테스트 빈도로 되돌리세요. 수치를 확인하려고 탐지를 계속 대량 실행하지 마세요. 설정을 유지할지는 필요한 요청이 안정적으로 완료되는지를 기준으로 판단합니다.
05 / LOG
Log와 Data: 요청 순서에 따라 문제 단서 확인
로그는 결론 목록이 아니라 처리 과정의 기록입니다
Log를 사용하면 요청이 어떤 단계를 거쳤는지 확인할 수 있습니다. 대상 정보 수신, DNS 조회, 정책 매칭, 연결 설정, 완료 또는 실패 여부를 살펴보세요. 프로토콜과 로그 수준에 따라 표시되는 세부 정보는 다를 수 있으므로 매번 완전히 같은 행이 나타나야 하는 것은 아닙니다. 방금 작업한 시각과 가까운 기록을 먼저 찾고 같은 대상이나 세션의 후속 이벤트를 따라가세요. 오류 한 줄만 따로 보면 앞뒤 맥락이 사라질 수 있습니다. 예를 들어 앞서 DNS 조회가 실패했다면 뒤이어 표시된 연결 실패는 그에 따른 결과일 수 있습니다.
로그의 기본 기록 여부, 보관되는 내용의 양, 선택 가능한 수준은 현재 Log 화면에서 확인하세요. 일상적으로는 기본 문제 해결에 필요한 수준을 유지하고, 가장 상세한 기록을 계속 켜 두지 않는 것이 좋습니다. 진단할 때만 잠시 세부 수준을 높이고 한 번 재현한 뒤 바로 되돌리세요. 로그가 상세할수록 접속 대상, 네트워크 정보, 구성 관련 단서가 포함될 가능성이 높아지고 확인해야 할 내용도 많아집니다. 모든 기록을 켜고 하나씩 검색하기보다 어떤 단계를 확인할지 먼저 정하는 편이 효과적입니다.
한 번의 깔끔한 재현으로 시간대를 연결하세요
시작하기 전에 현재 네트워크, 구성, 노드, Global Routing 모드를 기록하세요. 오래된 로그를 지울 예정이라면 가치 있는 문제 해결 기록을 먼저 보관하세요. 로그 삭제는 기록만 지울 뿐 네트워크를 복구하지 않습니다. 다른 앱의 네트워크 활동을 줄이고 문제가 있는 대상 하나만 열어 작업 시각을 기록한 다음 Log를 확인하세요. 시스템 백그라운드에서도 요청이 발생할 수 있으므로 로그에 이 작업만 남는다고 보장할 수는 없습니다. 최신 행이 문제 요청이라고 단정하지 말고 대상 도메인, 시각, 요청 순서를 함께 고려하세요.
대상을 찾으면 먼저 클라이언트 처리 범위에 들어왔는지 확인한 다음 정책을 살펴보세요. 규칙상 PROXY를 사용해야 하는데 기록에는 DIRECT로 표시된다면 규칙과 Global Routing부터 확인하세요. 예상한 정책을 따르는데 인증에 실패하면 노드 매개변수를 확인합니다. 연결은 성공했지만 앱에서 오류가 발생한다면 대상의 응답, 앱 세션, 관련된 다른 요청도 살펴봐야 합니다. 웹페이지 하나가 여러 도메인에 요청할 수 있으므로 기본 페이지가 열렸다고 이미지, 로그인, API 요청까지 성공한 것은 아닙니다. 필요하면 접속 과정에 따라 계속 추적하세요.
| 로그 단계 | 우선 확인할 항목 | 피해야 할 오판 |
|---|---|---|
| DNS 조회 단계에서 실패 | DNS와 기본 네트워크 | 모든 인증 매개변수를 바로 다시 입력 |
| 정책이 예상과 다름 | Global Routing, 현재 구성, 규칙 순서 | 분할 처리 문제를 서버 오프라인으로 오해 |
| 인증 또는 TLS 단계에서 실패 | 프로토콜 항목, 호스트 이름, 시스템 시간 | 포트 연결만으로 매개변수 오류를 배제 |
| 연결된 뒤 중단 | 네트워크 전환, 대상 응답, 세션 지속 여부 | 한 번의 중단을 모든 요청의 실패로 일반화 |
Data 통계와 개별 요청 로그는 서로 대체할 수 없습니다
Data 통계는 일정 범위의 트래픽 상태를 파악하는 데 쓰이며, 개별 요청의 성공률을 보여주지는 않습니다. 트래픽이 있다는 것은 데이터 활동이 있었다는 뜻일 뿐입니다. 백그라운드 서비스에서 발생했거나 실패 전에 일부 데이터가 전송된 것일 수 있습니다. 누적값은 집계 기간과 초기화 작업에도 영향을 받으므로 두 설정의 효율을 직접 비교하는 데 적합하지 않습니다. 특정 웹페이지가 규칙에 따라 처리됐는지 확인하려면 해당 요청의 Log를 살펴보세요. 총 트래픽이 증가했는지만으로 판단하지 마세요.
마찬가지로 시스템 상태 표시줄에 연결이 표시된다고 해서 모든 앱 요청이 성공하는 것은 아닙니다. 터널 상태, 규칙 적용, 대상 응답은 각각 다른 단계입니다. 먼저 연결 상태로 터널이 설정되었는지 확인하고, Log에서 요청 경로를 살펴본 다음 실제 앱에서 기능이 복구됐는지 확인하세요. 세 가지 결과가 일치해야 충분한 결론을 내릴 수 있습니다. 통계만 달라지고 대상 로그를 찾을 수 없다면 재현 방법, 로그 기록 상태, 현재 연결에서 발생한 데이터를 확인하고 있는지 다시 점검하세요.
문제 해결 자료를 공유하기 전에 민감 정보를 삭제하세요
구독 링크, 인증 항목, QR 코드 전체 이미지, 클라우드 구성 주소를 공개하지 마세요. 오류 단계, 정책 유형, 필요한 맥락만 남기면 됩니다. 도메인과 주소를 명확한 예시 문자열로 바꿔도 되지만, 어떤 항목을 바꿨는지 표시하세요.
문제 해결이 끝나면 임시로 조정한 로그 수준을 되돌리고 핵심 결과를 간단히 남기세요. 문제가 어떻게 재현됐는지, 어떤 항목을 바꾸자 결과가 달라졌는지, 최종적으로 어떤 값을 사용했는지 기록합니다. 변경해도 나아지지 않았다면 되돌렸다는 내용도 적어 다음에 같은 테스트를 반복하지 않도록 하세요. 정리되지 않은 로그를 많이 쌓는 것보다 분명한 과정 기록이 관리하기 쉽습니다. 규칙 순서를 확인하려면 사용자 지정 규칙 및 FINAL 안내를 참고하세요.
06 / WIDGET
Widget: 빠른 실행, 상태 표시, 시스템 새로고침
Widget은 실행 진입점이지 독립적인 연결 엔진이 아닙니다
Widget은 시스템에서 허용하는 위치에 빠른 실행이나 상태 정보를 제공합니다. 실제 기능은 현재 기기에서 사용할 수 있는 구성 요소에 따라 달라집니다. 처음 권한을 받는 과정, 유효한 구성, 사용 가능한 노드를 대신할 수는 없습니다. 처음 사용할 때는 Shadowrocket에서 수동 연결을 완료한 다음 시스템 구성 요소 추가 화면에서 사용 가능한 Widget을 추가하고, 앱이 제대로 열리거나 화면에 제공된 동작이 실행되는지 확인하세요. 시스템에서 특정 구성 요소가 보이지 않는다고 해서 구성 파일에 한 줄이 빠졌다고 추측하지 마세요. 시스템 구성 요소와 무관한 문제를 네트워크 규칙으로 해결하려고 하지도 마세요.
Widget의 기본 상태는 두 곳에서 확인해야 합니다. 앱 내부의 관련 설정과 시스템 홈 화면 또는 구성 요소 페이지에 실제로 추가했는지 여부입니다. 앱에 Widget 진입점이 있어도 시스템에 구성 요소가 배치된 것은 아닙니다. 배치된 구성 요소도 표시 내용이 계속 실시간으로 갱신된다는 뜻은 아닙니다. 앱의 초기 옵션은 우선 그대로 두고 일상적으로 필요한 진입점만 추가하는 것이 좋습니다. 구성 요소의 개수와 크기는 조작을 알아보기 쉽게 하는 데 맞추세요. 연결 문제를 확인한다고 모든 형태를 한꺼번에 추가할 필요는 없습니다.
상태 문자는 실제 연결 변경보다 늦게 갱신될 수 있습니다
시스템이 Widget을 갱신하는 시점을 정하므로 Widget에 표시된 문자와 앱의 현재 상태가 잠시 다를 수 있습니다. 연결을 누른 뒤에는 앱과 시스템 VPN 상태로 결과를 확인하고 실제 요청을 하나 보내세요. Widget에 이전 상태가 계속 표시된다고 반복해서 누르지 마세요. 조작을 여러 번 하면 연결 상태가 오락가락해 어떤 동작이 적용됐는지 판단하기 어려워질 수 있습니다. 구성 요소 상호작용 문제를 확인할 때는 한 번 조작하고 결과를 확인한 다음 다음 단계로 넘어가세요.
상태가 오랫동안 갱신되지 않으면 먼저 앱을 열어 현재 연결을 확인한 뒤 시스템 구성 요소 화면으로 돌아와 살펴보세요. 여전히 일치하지 않는다면 앱 구성을 유지한 채 Widget을 제거하고 다시 추가할 수 있습니다. 다시 배치하는 것은 표시 진입점을 새로 만드는 것이며 노드나 DNS 문제를 해결하지는 않습니다. 앱 내부 연결도 실패한다면 구성 요소 문제 해결을 중단하고 기본 네트워크, 권한, 노드 매개변수를 점검하세요. 구성 요소 문제를 파악하기 전에 Config 전체를 삭제하면 표시 문제를 구성 복구 문제로 확대할 수 있습니다.
잠금 화면, 시스템 권한, 표시 정보
잠금 화면이나 다른 시스템 위치에 특정 구성 요소를 배치할 수 있는지는 기기 시스템과 현재 사용 가능한 구성 요소 형식에 따라 다릅니다. 실제 시스템에서 제공하는 추가 경로만 사용하고 다른 시스템 버전의 화면 배치를 현재 기기에 필수라고 생각하지 마세요. 구성 요소가 동작을 완료하기 위해 앱을 열어야 한다면 시스템 안내에 따라 진행하세요. 이는 연결 기능이 실패했다는 뜻이 아닙니다. 잠금 해제 후에만 완료할 수 있는 작업은 먼저 잠금을 해제한 뒤 확인해 시스템 접근 제한을 앱의 무응답으로 오해하지 않도록 하세요.
다른 사람이 볼 수 있는 위치에 표시되는 정보가 적절한지도 고려하세요. 노드 메모에 개인 기기, 지역, 용도에 관한 단서가 포함될 수 있고 구성 이름도 사용 습관을 드러낼 수 있습니다. 본인은 알아볼 수 있으면서 지나치게 구체적이지 않은 이름을 사용하고 잠금 화면에는 필요한 정보만 표시하는 것이 좋습니다. 이름을 바꾼 뒤 Widget에 반영되는지 확인하세요. 이름은 식별을 위한 표시일 뿐입니다. 화면을 깔끔하게 정리하려고 서버 주소, 인증 항목, 구독 주소를 변경하지 마세요. 각 항목은 전혀 다른 용도로 사용됩니다.
빠른 실행 문제와 연결 문제 구분
앱에서 연결할 수 있는데 Widget 동작에 문제가 있다면 시스템 구성 요소와 새로고침을 확인하세요. 앱에서도 연결할 수 없다면 권한, 네트워크, 노드를 점검하세요. 두 문제 해결 경로에서 설정을 동시에 변경하지 마세요.
On Demand 연동 시 최종 실행 조건을 확인하세요
Widget에서 수동으로 연결을 끊은 뒤 다시 연결된다면 구성 요소가 동작을 반복 실행한 것이 아니라 On Demand 조건이 계속 적용 중일 수 있습니다. 앱에서 자동 조건을 확인하고 잠시 비활성화한 뒤 Widget으로 다시 테스트하세요. 이때 동작이 예상대로라면 구성 요소를 반복해서 제거하지 말고 자동 연결 조건을 조정하세요. 테스트 중에는 네트워크를 고정하세요. Wi-Fi 전환 시점과 겹치면 수동 조작과 시스템 네트워크 이벤트의 영향을 혼동할 수 있습니다.
유지 관리 시에는 연결 절차의 마지막에 Widget을 확인하는 것이 좋습니다. 기본 네트워크가 정상인지, 앱에서 연결할 수 있는지, 규칙이 예상대로 적용되는지, 자동 조건을 확인했는지 점검한 다음 빠른 실행을 테스트하세요. 구성 요소를 잠시 사용할 수 없어도 앱 내부에서 조작할 수 있습니다. 처음 연결하고 시스템 권한을 설정하는 전체 절차는 사용 설명서를 확인하세요. 이 장에서는 진입점, 상태, 새로고침만 다루며 Widget을 네트워크 성능을 높이는 설정으로 보지 않습니다.
07 / ICLOUD
iCloud 동기화: 동기화 범위, 충돌, 복구
먼저 동기화 대상을 확인하고 연결에 필수라고 생각하지 마세요
iCloud 관련 기능은 시스템과 앱이 허용하는 범위에서 데이터를 저장하거나 동기화하는 데 사용되며, 프록시 연결에 필수는 아닙니다. 먼저 현재 기기에서 구성이 작동하는지 확인한 다음 다른 기기로 동기화하세요. 동기화 항목은 현재 화면에 표시된 항목과 동작을 기준으로 확인해야 합니다. 노드, 구성, 환경설정, 로그, 시스템 권한이 모두 한꺼번에 복사된다고 가정하지 마세요. 특히 시스템 VPN 권한은 기기별로 승인해야 합니다. 클라우드에 구성 파일이 나타났다고 다른 기기에서 바로 연결할 수 있는 것은 아닙니다.
기본 상태도 현재 기기에서 확인해야 합니다. 앱 내부 스위치, 시스템 iCloud 설정, 사용 중인 계정이 결과에 모두 영향을 줄 수 있으므로 스위치 하나가 켜져 있다는 이유로 동기화가 끝났다고 단정하지 마세요. 먼저 현재 기기에서 사용할 수 있는 사본을 유지하고 구분하기 쉬운 구성 하나로 소규모 테스트를 하세요. 화면에 가져오기, 내보내기, 클라우드에서 파일 선택 같은 기능이 있다면 콘텐츠를 한 번 복사하는 작업인지 이후에도 동기화 관계를 유지하는 기능인지 구분하세요. 작업 이름이 비슷해도 이후 업데이트 방식은 다를 수 있습니다.
처음 활성화하기 전에 복구할 수 있는 로컬 기준본을 준비하세요
작업 전에 현재 사용 중인 구성의 이름, 출처, 마지막으로 직접 수정한 내용을 기록하세요. 백업이 필요하다면 현재 앱에서 제공하는 내보내기 기능을 사용하고 파일을 직접 관리할 수 있는 위치에 저장하세요. 백업 파일에는 구독 주소와 인증 정보가 들어 있을 수 있으므로 민감 자료로 취급하고 공개 폴더나 공유 스크린샷에 넣지 마세요. 백업 내용과 복구 경로를 확인할 수 있을 때만 클라우드 사본을 처리하세요. 잘못된 변경 내용도 다른 기기로 전파될 수 있으므로 동기화는 별도 백업을 대신하지 않습니다.
첫 테스트는 한 기기에서 이름 변경처럼 연결에 영향을 주지 않고 알아보기 쉬운 변경을 한 다음, 다른 기기에 예상한 변화가 나타날 때까지 기다리는 방식으로 진행할 수 있습니다. 이후 반대 방향으로도 확인하세요. 실제 기능이 파일 가져오기만 지원한다면 자동 변경을 기다리지 말고 일회성 복사로 이해해야 합니다. 동기화를 서두르려고 계정을 반복해서 전환하거나 같은 파일을 연달아 가져오거나 로컬 구성을 삭제하지 마세요. 사본이 늘어나 어느 구성이 유효한지 불분명해질 수 있습니다.
두 기기에서 동시에 변경했을 때 처리 방법
충돌이 발생하면 다른 기기에서 편집을 계속하지 말고 두 기기의 내용을 각각 저장하세요. 이름만 보고 최신 파일을 판단하지 마세요. 이름이 같아도 내용이 다를 수 있습니다. 시스템에 표시된 시각을 각 설정의 수정 시각과 동일하다고 보아서도 안 됩니다. 서버 항목, 규칙 순서, 정책 이름, 최근 직접 변경한 부분을 중심으로 비교하세요. 기준본으로 남길 사본을 정한 뒤 명확한 가져오기 또는 저장 작업으로 통일하세요. 방향을 확인하지 않은 채 덮어쓰기를 선택하지 마세요.
구독 업데이트와 클라우드 동기화는 서로 다른 경로입니다. Subscribe 업데이트는 일반적으로 기존 서비스 제공업체 주소에서 내용을 가져오고, 클라우드 작업은 기기 간 또는 파일 위치 간 데이터를 처리합니다. 노드가 업데이트되지 않으면 먼저 Subscribe 업데이트 결과를 확인하고 iCloud를 끄지 마세요. 로컬 규칙이 이전 내용으로 복원된 경우에는 가져오기 출처와 동기화 사본을 확인하세요. Subscribe 업데이트로 직접 수정한 부분이 바뀔 수 있는지도 살펴봐야 합니다. 중요한 사용자 지정 내용은 기억에 의존해 다시 입력하지 말고 별도로 기록하세요.
| 증상 | 먼저 확인 | 권장 조치 |
|---|---|---|
| 다른 기기에서 내용이 보이지 않음 | 계정, 시스템 클라우드 권한, 실제 동기화 대상 | 구성 하나로 확인하고 여러 파일을 반복해서 가져오지 않기 |
| 비슷한 사본이 여러 개 표시됨 | 일회성 가져오기를 여러 번 실행했는지 여부 | 사용 가능한 기준본을 확인한 뒤 이름 정리 |
| 노드 내용이 갱신되지 않음 | Subscribe 업데이트 결과 | 먼저 구독 경로 확인 |
| 구성은 있지만 연결할 수 없음 | 현재 기기 권한, 네트워크, 서버 매개변수 | 새 기기의 첫 연결 절차에 따라 검증 |
복구 후에도 실행 환경을 항목별로 확인하세요
복구 성공 여부는 파일이 나타났는지가 아니라 예상한 구성을 선택하고, 노드 정보를 확인하고, 연결을 설정하고, 올바른 규칙이 적용되는지로 판단해야 합니다. 기기마다 네트워크 환경이 다르므로 DNS와 On Demand 조건도 별도로 확인해야 할 수 있습니다. 한 기기에서 사용할 수 있다고 다른 기기의 권한 안내가 불필요하다고 생각하지 마세요. 해당 기기의 시스템 안내에 따라 권한을 승인한 뒤 이 페이지의 단계별 방법으로 확인하세요.
동기화가 방금 수정한 내용을 덮어쓸까 걱정된다면 사본 두 개를 보존하고 편집을 잠시 중단하세요. 현재 기능의 동기화 방향을 확인한 뒤 평소 작업을 재개하세요. 구독 주소가 필요하면 서비스 제공업체에서 정확한 정보를 받으세요. 링크를 공개해 도움을 요청하지 마세요. Subscribe, 직접 입력, QR 코드 가져오기의 차이는 구독 가져오기 방법을 참고하세요. 가져오기 방식에 따라 이후 업데이트를 진행해야 하는 위치도 달라집니다.
08 / PROXY AND CONFIG
Proxy 포트, 규칙 연동, 최종 되돌리기
로컬 수신 포트와 원격 서버 포트는 다릅니다
Proxy 관련 포트는 먼저 연결 방향을 구분해야 합니다. Add Server의 포트는 원격 서버에 연결할 때 사용하는 매개변수이며 서비스 제공업체의 정보와 일치해야 합니다. 로컬 프록시 수신 포트는 다른 프로그램이 이 기기의 진입점에 연결할 때 사용하며, 두 포트가 반드시 같을 필요는 없습니다. 시스템 연결 기능만 사용하는 경우 구성을 완성하려고 로컬 수신 기능을 추가로 켤 필요는 없습니다. 현재 플랫폼과 화면에서 관련 기능을 제공하고 실제 필요가 있을 때만 설정하세요. 특정 플랫폼의 수신 기능이 모든 기기에서 제공된다고 가정하지 마세요.
기본 포트, 수신 주소, 로컬 네트워크 접근 허용 여부는 현재 화면을 기준으로 확인하세요. 이 페이지에서는 모든 플랫폼에 공통으로 적용되는 초기값을 지정하지 않습니다. 명확한 필요가 없다면 현재 상태를 유지하는 것이 좋습니다. 다른 프로그램에서 로컬 프록시를 사용해야 한다면 먼저 이 기기에서만 확인하고 프록시 유형이 대상 프로그램에서 지원하는 유형과 일치하는지 확인하세요. HTTP와 SOCKS5는 임의로 바꿔 쓸 수 있는 이름이 아닙니다. 대상 프로그램에서 유형을 잘못 선택하면 포트에 연결할 수 있어도 요청을 완료하지 못할 수 있습니다.
수신 주소와 접근 범위를 각각 확인하세요
루프백 주소로 수신하면 이 기기에서만 사용할 수 있습니다. 다른 주소에서 수신하도록 설정하면 접근 범위가 넓어질 수 있습니다. 포트 문제를 확인하려고 로컬 네트워크 전체에 바로 공개하지 마세요. 먼저 다른 프로세스가 해당 포트를 사용 중인지, 대상 프로그램에 올바른 로컬 주소를 입력했는지, 프록시 기능이 실제로 실행 중인지 확인하세요. 로컬 네트워크의 다른 기기에서 접근해야 한다면 시스템 권한, 방화벽, 현재 네트워크의 기기 간 통신 제한, 앱의 접근 제어를 확인하세요. 직접 관리하는 네트워크에서만 테스트하고 수신 포트를 통제할 수 없는 네트워크에 노출하지 마세요.
포트가 충돌하면 현재 시스템에서 사용할 수 있고 다른 프로세스가 점유하지 않은 포트를 선택한 뒤 해당 포트를 사용하는 프로그램도 함께 수정하세요. 한쪽만 변경하면 새로운 문제가 생깁니다. 변경한 뒤 연결을 새로 시작하고 필요하면 관련 수신 기능을 재시작하세요. 확인이 끝나면 임시로 넓힌 접근 범위를 닫으세요. 로컬 네트워크 주소는 네트워크에 따라 바뀔 수 있고 다른 기기에 저장된 이전 주소도 무효가 될 수 있습니다. 기기 간 접속에 실패하면 원격 노드부터 수정하지 말고 현재 주소를 먼저 확인하세요.
규칙은 경로를 결정할 뿐 프로토콜 매개변수를 수정하지 않습니다
Config 모드에서는 일반적으로 규칙을 위에서 아래로 확인하고, 일치하는 규칙을 찾으면 해당 정책으로 처리합니다. DOMAIN-SUFFIX는 도메인 접미사로, IP-CIDR 및 IP-CIDR6는 주소 범위로 일치 여부를 확인합니다. GEOIP는 해당 주소의 지리적 분류를 사용하고 FINAL은 다른 규칙에 일치하지 않는 요청에 적용됩니다. PROXY, DIRECT, REJECT는 각각 프록시, 직접 연결, 차단 정책을 나타냅니다. 규칙이 올바르더라도 비밀번호, 인증서 호스트 이름, 서버 포트 오류는 해결할 수 없습니다. 분할 처리와 연결 상태를 따로 확인해야 합니다.
아래 예시는 규칙 순서를 이해하기 위한 일부 규칙이며 전체 구성이 아닙니다. 도메인과 네트워크 대역은 매칭 관계를 설명하기 위한 예시이므로 현재 파일에 검토 없이 그대로 대체하지 마세요. 실제로 사용하기 전에 정책 이름이 유효한지 확인하고 원본 파일 사본을 보관하세요. 특히 FINAL에 어떤 정책을 지정하느냐에 따라 나머지 요청의 경로가 결정됩니다. 예시에서 특정 정책을 사용했다고 해서 모든 네트워크에 적합하다고 볼 수는 없습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
검증할 때는 대상 규칙이 명확히 적용될 요청을 보낸 다음 Log에서 실제로 일치한 규칙을 확인하세요. 규칙이 적용되지 않는 것 같다면 Global Routing이 Config인지, 수정한 구성이 선택되어 있는지, 앞에 더 포괄적인 규칙이 있는지, 요청이 기존 연결을 재사용하는지 차례로 확인하세요. 도메인 규칙만 수정한 테스트라면 기존 세션을 유일한 판단 근거로 삼지 말고 도메인 요청을 새로 보내세요. 규칙 순서에 대한 자세한 설명은 규칙 우선순위와 FINAL을 참고하세요.
최소한의 변경으로 문제 해결을 마무리하세요
마지막으로 임시 테스트 항목을 하나씩 복원하세요. 더 이상 필요하지 않은 로컬 수신 기능을 끄고, 일시적으로 높인 로그 수준을 되돌리고, Global Routing을 평소 모드로 복원하고, 검증된 On Demand 조건만 남기세요. 그런 다음 안정된 네트워크에서 다시 연결해 문제가 있던 대상을 방문하고 규칙과 로그를 한 번 더 확인하세요. 설정을 복원한 직후 문제가 다시 발생하면 해당 변경이 다음 점검 대상이 됩니다. 모든 옵션을 다시 조정할 필요는 없습니다.
완료 기준
연결을 반복해서 설정할 수 있고, 대상 요청이 예상한 정책을 따르며, 네트워크 전환 후에도 설정한 동작이 유지되고, 복구 가능한 구성 사본을 보관해야 합니다. 스위치가 켜져 있거나 테스트에서 한 번 응답을 받은 것만으로는 이 검증을 대신할 수 없습니다.
문제가 계속되면 최소 재현 기록을 정리하세요. 플랫폼, 네트워크 유형, 현재 모드, 실패 단계, 시도 후 되돌린 항목을 기록하면 됩니다. 구독 정보나 인증 정보를 전부 첨부하지 마세요. 처음 연결하는 문제라면 사용 설명서의 순서에 따라 다시 확인하세요. 클라이언트를 다시 받거나 시스템에서 실행을 허용하는 방법을 확인하려면 다운로드 페이지의 설치 안내를 이용하세요. 결과를 설명할 수 있는 설정은 유지하고 근거가 없는 변경은 되돌리는 것이 이후에도 안정적으로 관리할 수 있는 출발점입니다.