이 글 미리보기

사용 가능한 Shadowrocket 구성이 있다면 먼저 차단할 범위가 도메인 전체인지, 같은 도메인의 특정 URL 경로인지 확인합니다. 전자는 [Rule]에서 REJECT를 지정하고, 후자는 [URL Rewrite]에서 확인 가능한 전체 URL을 매칭합니다. 테스트할 때는 대상 요청과 비교 요청을 각각 한 번씩 보내고 매칭 결과를 확인하면 규칙 적용 여부, 구성 비활성화 여부, 오차단 여부를 구분할 수 있습니다. 아래 설명은 iPhone / iPad 인터페이스를 기준으로 합니다.

규칙 매칭의 어느 단계에서 REJECT가 적용되나요?

REJECT는 매칭 조건이 아니라 매칭 후 적용되는 처리 정책입니다. DOMAIN-SUFFIX,telemetry.example.com,REJECT에서 첫 번째 필드는 규칙 유형, 두 번째 필드는 매칭 범위, 세 번째 필드는 매칭된 연결을 거부하는 정책입니다. 요청이 이 규칙에 매칭되려면 먼저 Shadowrocket의 처리 범위에 들어와야 하며, 매칭 조건에 필요한 정보도 확인할 수 있어야 합니다.

앱 요청트래픽 가로채기대상 식별규칙 매칭정책 실행

Config에서 실제로 활성화된 구성을 확인하고, 편집하기 전에 복사본을 보관합니다. Home으로 돌아가 연결이 켜져 있는지 확인한 다음 Global Routing에서 Config를 선택합니다. 스위치가 켜져 있다고 해서 트래픽이 구성에 따라 분기되는 것은 아닙니다. Proxy와 Direct는 규칙 테스트의 기준으로 적절하지 않으며, Scene을 사용하면 현재 적용되는 모드가 장면 설정에 따라 달라집니다. 문제를 확인할 때는 먼저 Config로 고정하고 네트워크와 모드를 동시에 바꾸지 마세요.

필드 3개
도메인 규칙 예시: 유형, 매칭 값, 정책
80
HTTP 기본 포트
443
HTTPS 기본 포트. 포트만으로는 URL 경로를 확인할 수 없습니다.

DOMAIN-SUFFIX 설정: 도메인 범위 차단

원치 않는 요청만 전담하는 호스트라면 요청 경로를 확인하지 않고 도메인 기준으로 차단할 수 있습니다. DOMAIN-SUFFIX,telemetry.example.com,REJECT는 telemetry.example.com과 v2.telemetry.example.com 같은 하위 도메인에 매칭되지만, api.example.com에는 매칭되지 않습니다. 호스트 이름 하나만 차단하려면 DOMAIN을 사용하세요. 무심코 example.com까지 범위를 넓히면 같은 도메인의 로그인, 이미지, API 요청도 거부될 수 있습니다.

[Rule]
DOMAIN-SUFFIX,telemetry.example.com,REJECT
FINAL,DIRECT

위 코드는 독립적으로 테스트하기 위한 예시이므로, 검증할 수 있는 대상 도메인으로 바꿔야 합니다. 현재 사용 중인 구성에 합칠 때는 새 항목만 기존 [Rule]에 추가하고 기존 FINAL은 유지하세요. 테스트를 위해 평소의 기본 처리 방식을 DIRECT로 바꾸지 마세요. 하나의 요청이 여러 규칙에 매칭될 수 있다면 먼저 매칭된 항목의 정책이 적용됩니다. 예를 들어 광범위한 DOMAIN-SUFFIX,example.com,PROXY가 앞에 있으면 그 뒤에 작성한 하위 도메인 차단 규칙은 이미 매칭된 요청을 처리하지 못합니다.

도메인 및 하위 도메인 차단

구성 섹션
[Rule]
매칭 조건
DOMAIN-SUFFIX,telemetry.example.com
매칭 시 적용할 정책
REJECT
배치 위치
같은 대상에 적용되는 광범위한 규칙보다 앞

호스트 전체를 차단해도 되는 경우에 적합합니다. 경로별로 구분하지 않습니다.

하위 도메인 예외 지정

정확한 조건
DOMAIN,health.telemetry.example.com
예외 정책
DIRECT (직접 연결이 적절하다고 확인된 경우에만 사용)
배치 위치
해당 DOMAIN-SUFFIX 차단 규칙보다 앞

구체적인 예외를 먼저 처리한 뒤 더 넓은 도메인 접미사를 처리하세요. 예외에는 해당 호스트에 원래 필요한 아웃바운드 정책을 적용해야 합니다.

URL Rewrite 설정: 특정 경로만 차단

같은 호스트에서 로그인, 동기화, 분석 API를 함께 제공할 수 있습니다. /telemetry만 차단하고 /account는 허용하려면 먼저 [Rule]에서 호스트 전체를 차단한 뒤 URL Rewrite로 특정 경로를 허용하려 해서는 안 됩니다. 경로 차단만 따로 검증하려면 테스트 호스트 전체를 차단하는 구성이 없는지 먼저 확인하세요.

[URL Rewrite]
^https:\/\/api\.example\.com\/telemetry(?:[/?]|$) - reject

HTTPS 경로와 쿼리 매개변수는 암호화된 콘텐츠에 포함됩니다. 도메인 기준으로 트래픽을 분기할 수 있다고 해서 경로 기준 매칭도 가능한 것은 아닙니다. 경로 규칙을 적용하려면 Shadowrocket이 해당 HTTP 요청을 처리하고 내용을 확인할 수 있어야 합니다. HTTPS에서는 일반적으로 적용 가능한 MITM 구성과 인증서 신뢰 설정이 필요합니다. 검사 권한이 있는 테스트 도메인에서만 기능을 켜고 범위를 해당 호스트로 제한하세요. 앱이 검사에 사용하는 인증서를 거부하면 테스트를 중단하고 복호화 범위를 다른 도메인으로 넓히지 마세요.

규칙 매칭을 확인하고 오차단 원인 찾기

  1. 먼저 기준 상태를 확인하세요. 규칙을 추가하기 전에 제어할 수 있고 원래 접속 가능한 테스트 서비스에 요청을 한 번 보내 실제 도메인과 경로, 예상 결과를 기록합니다. 기준 상태에서 이미 시간 초과, DNS 조회 실패, 오류 응답이 발생한다면 먼저 기준 상태를 해결하세요. 실패한 페이지 하나만으로 REJECT가 적용됐다고 판단할 수는 없습니다.
  2. 한 번에 규칙 하나만 변경하세요. 변경 사항을 저장한 뒤 활성화된 구성이 여전히 이 구성인지 확인하고, Home의 Global Routing이 Config인지 확인합니다. 도메인 테스트에는 대상 호스트 하나와 대상 접미사 범위에 속하지 않는 호스트 하나를 사용하세요. 경로 테스트에는 같은 호스트의 /telemetry와 /telemetry-status를 사용해 앞의 경로만 차단되는지 확인합니다.
  3. 앱에서 새 요청을 보내세요. 테스트 대상 앱을 종료한 뒤 다시 열거나 테스트 서비스에서 새로운 요청을 보내 캐시된 페이지나 이미 연결된 세션을 새 요청으로 오인하지 않도록 합니다. 연결 기록을 확인할 수 있다면 시간, 대상, 매칭된 정책을 확인하세요. 경로 테스트에서는 앱이 리디렉션된 주소가 아니라 예상한 URL을 실제로 요청했는지도 확인해야 합니다.
  4. 변경을 되돌리고 다시 테스트하세요. 정상적인 API도 실패한다면 이번에 추가한 항목을 먼저 삭제하거나 복사본을 복원한 다음 대상 요청과 비교 요청을 다시 보냅니다. 되돌린 뒤 정상 작동하면 도메인 범위나 경로 표현식을 좁히는 것이 우선입니다. 그래도 복구되지 않으면 DNS, 서버 상태, 네트워크 연결을 점검하세요.

차단할 수 없는 요청: 자주 묻는 질문

REJECT를 추가했는데 페이지의 콘텐츠가 그대로 보이는 이유는 무엇인가요?

페이지를 다시 열었을 때 새 연결이 발생했는지 먼저 확인하세요. 콘텐츠가 이미 로컬 캐시에 있거나 페이지의 주 응답에 포함되어 반환됐다면 차단할 별도의 대상 요청이 없을 수 있습니다. 캐시되지 않은 요청으로 실제 호스트를 확인하세요. 페이지 요소 하나를 없애려고 페이지 전체를 제공하는 도메인을 차단하지 마세요.

호스트 이름 규칙을 올바르게 작성했는데 연결 기록에는 IP만 표시되는 이유는 무엇인가요?

앱이 IP에 직접 연결하는지 먼저 확인하세요. Shadowrocket이 매칭 가능한 도메인 정보를 받지 못하면 DOMAIN-SUFFIX로 호스트를 추측할 수 없습니다. 주소가 고정되어 있고 소유 범위가 명확하며 다른 서비스에 영향을 주지 않는다고 확인된 경우에만 IP-CIDR 매칭을 고려하세요. 공유 IP는 도메인 규칙의 대체 수단으로 적절하지 않습니다.

규칙에 적은 경로와 같은데도 매칭되지 않는 이유는 무엇인가요?

실제 URL의 호스트, 포트 표기, 리디렉션 결과를 확인한 다음 현재 구성의 검사 범위에 해당 프로토콜이 포함되는지 살펴보세요. HTTPS 경로가 확인되지 않는다면 정규식을 계속 수정해도 소용없습니다. 앱의 연결 방식 때문에 예상한 검사가 불가능하다면 도메인 단위로 판단하고 같은 호스트의 경로를 구분할 수 없다는 점을 받아들여야 합니다.

한 네트워크에서는 차단되는데 다른 네트워크로 바꾸면 다시 나타나는 이유는 무엇인가요?

먼저 연결 상태와 Home의 Global Routing을 각각 확인하세요. 그런 다음 Settings → On Demand에서 네트워크에 따라 연결 조건이 다르게 설정되어 있는지 살펴봅니다. 규칙은 Shadowrocket의 처리 범위에 들어오지 않은 트래픽까지 자동으로 검사하지 않습니다. 같은 네트워크와 같은 구성으로 먼저 재현한 다음 네트워크를 바꾼 결과와 비교하세요.

REJECT는 클라이언트에 들어오고 조건에 맞는 새 요청을 처리합니다. 이미 다운로드된 콘텐츠를 삭제하거나 기기 전체의 접근을 제어하지는 않습니다. 검증된 결과는 “이 구성에서 대상 요청은 거부되고 비교 요청은 계속 접속할 수 있다”와 같이 표현해야 하며, “이 앱이나 페이지의 모든 유사 콘텐츠가 차단됐다”고 단정해서는 안 됩니다.