Shadowrocket 용어집
인터페이스, 프로토콜, 규칙

Home

현재 연결 상태는 어디서 확인하나요? Home은 서버 항목과 현재 선택 항목, 연결 스위치를 확인하는 주요 화면입니다. 먼저 선택된 항목을 확인하고 스위치 상태를 살펴보세요. 연결됨으로 표시되어도 터널 상태만 나타낼 뿐, 대상 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 문제가 있으면 테스트 결과와 모드, 규칙도 확인해야 합니다.

Global Routing

모드를 바꾸면 접속 결과가 달라지는 이유는 무엇인가요? Global Routing은 전체 트래픽의 처리 방식을 결정합니다. 구성, 프록시, 직접 연결은 각각 Config, Proxy, Direct에 해당합니다. 설정에 따라 트래픽을 분리하려면 Config를 확인하세요. 임시 문제 해결에는 다른 모드와 비교해 볼 수 있지만, 테스트가 끝나면 원래 의도한 설정으로 되돌려 테스트 상태를 일상 설정으로 오인하지 않도록 하세요.

Config

Config는 파일인가요, 모드인가요? 설정 관리 화면에서는 구성 파일을 확인하고 편집하거나 선택하는 항목을 뜻합니다. Global Routing에서는 현재 설정에 따라 요청을 처리하는 모드를 뜻합니다. 파일을 편집한 뒤에는 그 파일이 현재 사용 중인 설정인지 다시 확인하세요. 저장에 성공했다는 이유만으로 규칙이 적용되었다고 판단할 수는 없습니다.

Proxy / Direct

이 두 모드는 규칙 정책과 같은 건가요? Proxy와 Direct는 Global Routing의 모드 이름으로, 각각 전체 프록시 처리와 직접 연결에 사용됩니다. 규칙 행의 PROXY와 DIRECT는 대문자 정책 키워드입니다. 문제를 해결할 때는 먼저 모드를 기록한 뒤 규칙을 확인하세요. 설정에 따른 분리가 아닌 상태에서 규칙 파일을 반복해서 수정하지 않도록 주의하세요.

On Demand

네트워크가 바뀐 뒤 연결이 시작되는 이유는 무엇인가요? On Demand는 네트워크 등의 조건에 따라 VPN 연결을 시작하는 기능입니다. 구체적인 조건은 앱 내 옵션을 기준으로 확인하세요. On Demand는 ‘언제 연결할지’를, 규칙은 ‘요청을 어떻게 처리할지’를 정하므로 서로 다른 기능입니다. 변경 후에는 Wi-Fi와 셀룰러 네트워크에서 각각 실제 동작을 확인하세요.

Add Server / Subscribe

이미 보유한 정보는 어디에 입력하나요? Add Server는 연결 정보를 추가하는 화면이고, Subscribe는 구독 유형의 이름입니다. 직접 추가할 때는 보유한 매개변수와 일치하는 프로토콜을 선택하세요. 구독을 가져올 때는 본인의 구독 주소를 입력한 뒤 생성된 항목을 확인합니다. 구독 주소를 단일 서버의 주소 입력란에 넣지 마세요.

Connectivity Test

테스트에 성공하면 무엇을 알 수 있나요? Connectivity Test는 선택한 테스트 방식으로 연결 상태를 확인하며, 결과는 당시의 테스트 조건에만 해당합니다. 항목을 비교하려면 테스트 방식과 네트워크를 동일하게 유지한 뒤 실제 대상에 접속해 확인하세요. 한 번 실패했다고 매개변수가 잘못되었다고 단정할 수 없고, 한 번 성공했다고 모든 서비스에 접속할 수 있는 것도 아닙니다.

Rule

규칙은 어떤 역할을 하나요? Rule은 요청의 매칭 조건을 처리 정책과 연결합니다. 일반적으로 목록의 위에서 아래로 확인하고, 일치하는 항목을 찾으면 해당 정책을 적용합니다. 더 구체적인 예외를 범위가 넓은 조건보다 앞에 두세요. 문제를 해결할 때는 마지막으로 추가한 행만 보지 말고, 가장 먼저 일치하는 행을 찾으세요.

DOMAIN

정확한 도메인 하나만 매칭하려면 어떻게 하나요? DOMAIN은 지정한 도메인과 정확히 일치합니다. 예를 들어 example.com을 지정해도 www.example.com은 자동으로 포함되지 않습니다. 조건에는 도메인만 입력하고 https://, 포트, 웹페이지 경로는 넣지 마세요. 하위 도메인까지 포함하려면 DOMAIN-SUFFIX가 적합한지 확인하세요.

DOMAIN,example.com,DIRECT

DOMAIN-SUFFIX

루트 도메인과 하위 도메인을 함께 포함하려면 어떻게 하나요? DOMAIN-SUFFIX는 도메인 접미사의 경계를 기준으로 매칭합니다. example.com은 해당 도메인과 www.example.com 등의 하위 도메인을 포함하지만, 임의의 문자열 포함 여부를 검사하지는 않습니다. 특정 하위 도메인에 다른 정책을 적용하려면 범위가 넓은 규칙보다 구체적인 규칙을 앞에 두세요.

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-KEYWORD

특정 문자열이 포함된 도메인을 어떻게 매칭하나요? DOMAIN-KEYWORD는 도메인에 지정한 문자열이 포함되어 있는지 확인하며, 여러 도메인 접미사에 걸쳐 매칭될 수 있습니다. 전체 도메인이나 접미사 조건보다 범위가 넓어 의도하지 않은 대상에 적용될 수 있습니다. 사용하기 전에 예상한 매칭 사례와 예상하지 못한 사례를 정리하세요.

GEOIP

GEOIP는 대상을 어떻게 매칭하나요? IP 지리 데이터베이스의 할당 정보를 기준으로 대상 주소를 매칭하며, 웹페이지 언어나 방문자 위치를 기준으로 하지 않습니다. 데이터베이스와 실제 네트워크 배치 정보가 다를 수 있고 대상 주소가 바뀌면 결과도 달라집니다. 문제를 해결할 때는 실제로 해석된 주소와 규칙 매칭 결과를 확인하세요.

GEOIP,CN,DIRECT

IP-CIDR / IP-CIDR6

대상 주소 범위를 어떻게 지정하나요? IP-CIDR은 IPv4 주소 대역을, IP-CIDR6은 IPv6 주소 대역을 매칭합니다. 슬래시 뒤의 접두사 길이가 범위를 정합니다. 접두사 범위를 너무 넓게 설정하면 더 많은 주소가 포함됩니다. 앞부분이 비슷하다는 이유만으로 매칭이 올바르다고 판단하지 마세요. 대상에 두 주소 유형이 모두 있다면 실제로 사용된 주소 계열도 각각 확인하세요.

IP-CIDR,192.0.2.0/24,DIRECT
IP-CIDR6,2001:db8::/32,DIRECT

USER-AGENT

USER-AGENT는 모든 앱을 식별할 수 있나요? 확인 가능한 HTTP User-Agent 정보를 기준으로 매칭하며, 앱 자체의 식별 정보를 판별하는 기능은 아닙니다. 암호화된 요청에서는 해당 정보를 직접 확인할 수 없는 경우가 많아 매칭 여부가 요청의 가시성에 따라 달라집니다. 작성하기 전에 요청에 사용할 수 있는 필드가 실제로 있는지 확인하고, 일반적인 앱별 트래픽 분리 조건으로 간주하지 마세요.

FINAL

앞선 규칙이 하나도 일치하지 않으면 어떻게 하나요? FINAL은 최종 처리 정책을 지정하며, 보통 규칙 목록의 마지막에 둡니다. 구체적인 규칙보다 앞에 두면 뒤에 있는 조건이 예상대로 매칭되지 않습니다. DIRECT와 PROXY 중 어느 것을 선택할지는 자신의 설정 목적에 따라 정하고, 예시를 일반적인 답으로 그대로 적용하지 마세요.

FINAL,DIRECT

PROXY / DIRECT / REJECT

규칙이 일치하면 어떻게 처리되나요? PROXY는 프록시 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 실제 프록시 출구는 현재 선택 항목과 설정에 따라 달라집니다. 이 키워드들은 처리 결과를 나타내며 매칭 조건이 아닙니다. REJECT를 잘못 적용하면 대상에 접속할 수 없으므로 먼저 매칭 범위를 확인하세요.

DNS

도메인이 열리지 않으면 반드시 DNS 문제인가요? DNS는 도메인을 IP 주소로 변환합니다. 변환에 성공해도 연결, 인증, 규칙 처리 단계에서 실패할 수 있습니다. 먼저 예상한 주소를 얻었는지 확인한 다음 후속 연결 상태를 살펴보세요. DNS를 변경한 뒤에는 캐시의 영향을 고려하고 테스트 대상을 동일하게 유지하세요. 한 번 새로고침한 결과만으로 결론을 내리지 마세요.

Host

설정의 Host와 전송 매개변수의 Host는 같은 건가요? 구성 파일의 Host 섹션은 정적 도메인 매핑에 사용하고, 전송 매개변수의 HTTP Host는 요청 관련 필드로 사용하므로 용도가 다릅니다. 정적 매핑은 해석 결과에 영향을 주며 대상 주소가 변경되면 함께 조정해야 할 수 있습니다. 문제를 해결할 때는 먼저 어떤 설정을 보고 있는지 확인하세요.

지연 시간

수치가 낮으면 반드시 더 빠르게 접속할 수 있나요? 지연 시간은 특정 테스트 조건에서 측정한 응답 시간으로, 전송 처리량과 같지 않으며 모든 대상 웹사이트의 이용 경험을 나타내지도 않습니다. 같은 테스트 방식과 네트워크를 사용해 비교하고 실제 접속 결과도 확인하세요. 짧은 시간의 변동이나 한 번의 시간 초과만으로 장기적인 상태를 판단할 수 없습니다. 테스트 결과는 측정 조건과 함께 해석하세요.

TLS / SNI

서버 주소와 SNI가 다를 수 있는 이유는 무엇인가요? TLS는 연결을 보호하고, SNI는 핸드셰이크 중 서버 이름을 전달합니다. 연결 엔드포인트는 주소일 수 있지만, 인증에 사용하는 이름은 서비스 설정 및 인증서와 일치해야 합니다. 보유한 매개변수에 따라 입력하고 둘을 임의로 바꾸지 마세요. 인증서 오류가 발생하면 이름과 기기 시간, 인증서 상태를 확인한 뒤 다음 조치를 판단하세요.