이 글 미리보기

이 글은 Shadowrocket에 직접 준비한 서비스 정보를 가져왔고, 트래픽 분기 규칙을 편집하려는 사용자를 위한 안내입니다. 먼저 현재 사용 중인 Config와 Global Routing을 확인한 뒤 도메인 조건, IP 조건, 기본 처리 조건을 구분합니다. 읽고 나면 규칙이 어떤 요청에 적용되는지, 어느 위치에 배치해야 하는지, 수정 후 어떤 연결 기록을 확인해야 하는지 파악할 수 있습니다.

1. 기기별 설치 경로와 규칙 위치 확인

아직 설치하지 않았다면 전체 플랫폼 다운로드 페이지에서 기기를 선택하세요. iPhone / iPad 버전은 App Store에서 제공되며 $2.99 일회성 결제입니다. 개발자는 Shadow Launch Technology Limited이며, 시스템 요구 사항은 App Store 페이지를 확인하세요. Mac(Apple 칩 / Intel), Windows, Android, Linux 버전은 무료입니다. 이 글에서는 클라이언트 규칙만 다룹니다. 프록시 서버나 구독은 제공·판매·추천하지 않으며, 아래 내용은 사용자가 자신의 서비스 제공업체와 구독 정보를 준비한 경우를 전제로 합니다.

트래픽 분기 규칙은 Config 파일의 [Rule] 섹션에 있습니다. Home에서 선택한 연결은 사용할 프록시 출구를 제공하고, Config에서 활성화한 설정은 트래픽 분기 조건을 구성합니다. 둘은 서로 다른 선택 항목입니다. 서비스 정보를 가져왔더라도 규칙 Config가 활성화된 것은 아니며, 현재 요청이 반드시 프록시를 통과하는 것도 아닙니다.

  1. Config 백업

    Config로 이동해 현재 활성화된 설정을 확인하고 먼저 복사본을 보관하세요. 이후에는 복사본의 [Rule]만 수정하고, 기존 연결 매개변수와 다른 설정 섹션은 유지하면 변경을 되돌리기 쉽습니다.

  2. 프록시 출구 확인

    Home으로 돌아가 자신의 서비스 정보가 가져와졌는지, 필요한 프록시 출구를 사용할 수 있는지 확인하세요. 규칙의 PROXY는 처리 정책일 뿐, 서버 주소나 포트, 인증 정보를 자동으로 만들지 않습니다.

  3. 트래픽 분기 방식 선택

    Home → Global Routing → Config에서 Config에 따라 처리하도록 선택하세요. 현재 Proxy 또는 Direct를 선택한 상태라면 접속 결과만으로 [Rule]의 특정 행이 적용됐는지 판단할 수 없습니다.

  4. 규칙 편집 및 확인

    Config로 돌아가 해당 설정의 편집 화면을 열고 규칙을 수정한 뒤 저장하세요. 활성화된 설정이 계속 이 Config인지 확인합니다. 그런 다음 새 요청을 보내 연결 기록에서 대상, 적용된 규칙, 처리 정책을 확인하세요.

2. 규칙 형식: 조건 다음에 처리 정책

일반적인 규칙은 영문 반각 쉼표로 필드를 구분합니다. 대부분의 조건 규칙은 유형,매칭값,정책 형식으로 작성합니다. FINAL에는 매칭값이 없으므로 정책을 바로 지정합니다. 도메인 매칭값에는 https://, 웹 경로, 쿼리 매개변수 또는 포트를 입력하지 않습니다. https://example.com:8443/docs에 접속하더라도 도메인 조건에는 전체 URL이 아니라 example.com을 입력합니다.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,example,REJECT
GEOIP,CN,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY

위 예시는 여섯 가지 형식을 보여 주기 위한 것입니다. 실제 Config에 전체를 그대로 붙여 넣는 것은 권장하지 않습니다. 한 요청이 여러 조건에 동시에 해당할 수 있으며, 앞선 규칙이 뒤의 규칙보다 먼저 적용됩니다. 192.0.2.0/24는 문서용 예시 네트워크이며 사용할 수 있는 서비스 주소가 아닙니다. example.com과 하위 도메인도 문법 설명에만 사용한 예시입니다.

6가지
이 글에서 다루는 대표적인 매칭 키워드
3가지
정책 예시: PROXY / DIRECT / REJECT
마지막 행
앞선 규칙에 해당하지 않는 요청을 처리하는 FINAL

판단 순서: 적용된 규칙을 찾은 뒤 출구 확인

규칙을 수정한 뒤에는 새 요청이 어떤 행에 적용됐는지 먼저 확인하세요. 정책이 올바르다면 해당 정책에 연결된 출구를 점검합니다. 웹페이지가 열리는지만 보고 규칙 적용 여부를 판단하지 마세요.

3. DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD의 차이

이 세 가지 규칙은 모두 매칭에 사용할 수 있는 대상 도메인이 필요하지만, 적용 범위는 서로 다릅니다. DOMAIN은 도메인 전체가 일치하는지 확인합니다. DOMAIN-SUFFIX는 지정한 도메인과 그 하위 도메인에 적용됩니다. DOMAIN-KEYWORD는 도메인에 포함된 문자열을 기준으로 하며 도메인 계층을 구분하지 않습니다. 조건이 구체적일수록 범위가 명확한 규칙을 우선 사용하세요.

같은 예시 도메인에 적용되는 세 가지 매칭 범위
규칙 예시매칭 대상범위 설명
DOMAIN,example.com,PROXY example.com api.example.com은 포함하지 않으므로 별도의 규칙이 필요합니다.
DOMAIN-SUFFIX,example.com,DIRECT example.com、api.example.com、img.api.example.com 도메인 경계를 기준으로 매칭하며, 임의의 문자열 끝부분을 비교하지 않습니다.
DOMAIN-KEYWORD,api,REJECT api.example.com、myapi.example.com 키워드가 도메인의 어느 위치에든 있으면 매칭되므로 관련 없는 요청까지 포함될 수 있습니다.

특정 API 도메인 하나만 프록시로 보내려면 키워드 규칙보다 DOMAIN,api.example.com,PROXY가 적용 여부를 확인하기 쉽습니다. 같은 도메인의 모든 하위 도메인을 직접 연결하려면 DOMAIN-SUFFIX,example.com,DIRECT를 사용할 수 있습니다. 키워드 규칙은 도메인 계층과 관계없이 동일한 문자열을 찾아야 할 때 적합합니다. 짧은 단어가 매칭됐다고 해서 해당 서비스의 도메인이라고 단정하지 마세요.

4. GEOIP와 IP-CIDR: 대상 IP를 기준으로 판단

GEOIP,CN,DIRECT는 대상 IP의 지역 데이터베이스 결과를 기준으로 매칭하며, CN은 지역 코드입니다. 웹페이지 내용이나 도메인 접미사, 계정 지역, 현재 기기 위치를 판단하는 규칙은 아닙니다. CDN, DNS 응답 차이, 데이터베이스 차이에 따라 같은 도메인도 서로 다른 IP 판정 결과가 나올 수 있습니다.

IP-CIDR은 지정한 IPv4 네트워크 대역을 매칭합니다. 192.0.2.0/24의 앞 24비트는 네트워크 프리픽스이며, 192.0.2.0부터 192.0.2.255까지의 주소 범위를 포함합니다. IPv4 주소 하나만 지정하려면 /32를 사용할 수 있습니다. 마스크 숫자가 클수록 일반적으로 매칭 범위가 좁아집니다. 한 번 조회된 IP 하나를 웹사이트의 모든 주소로 여기지 마세요.

IP-CIDR,192.0.2.8/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
GEOIP,CN,DIRECT

이 독립 예시에서는 대상이 192.0.2.8일 때 단일 주소 규칙이 먼저 적용되고, 192.0.2.20일 때만 아래 네트워크 대역 규칙이 적용됩니다. /24 규칙을 첫 행에 두면 단일 주소 예외가 적용될 기회가 없습니다. no-resolve를 사용할지는 트래픽 분기 설계에 따라 결정해야 합니다. 일반적인 속도 향상 옵션으로 사용하지 마세요.

5. FINAL과 규칙 순서: 예외, 범위, 마지막으로 기본 처리

규칙은 일반적으로 위에서 아래 순서로 확인하며, 먼저 매칭된 규칙이 이후 처리를 결정합니다. 여러 매칭 결과를 모아 가장 정확한 규칙을 고르는 방식이 아닙니다. 따라서 ‘정확한 규칙 우선’은 작성 순서로 구현해야 하며 시스템이 자동으로 정렬해 주지 않습니다. FINAL은 앞선 규칙에 해당하지 않는 요청을 처리하므로 규칙 목록의 마지막에 배치하세요.

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

이 예시는 ‘특정 도메인 예외 → 도메인 범위 → IP 조건 → 기본 처리’ 순서로 구성한 것이며, 모든 환경에서 따라야 하는 고정 템플릿은 아닙니다. 실제로 사용하기 전에 지역 기반 직접 연결이 필요한지, 규칙에 해당하지 않는 트래픽을 PROXY로 보내도 되는지 확인하세요. 기존 Config에서 정책 그룹 이름을 사용한다면 그룹 정의를 확인하고 그대로 유지해야 합니다. 존재하지 않는 이름으로 임의 변경하지 마세요.

  1. blocked.example.com은 첫 행에서 REJECT로 거부되므로 아래 도메인 접미사 규칙은 확인하지 않습니다.
  2. api.example.com은 두 번째 행에서 PROXY로 처리됩니다. example.com에 속한다고 해서 이후 직접 연결로 바뀌지 않습니다.
  3. www.example.com은 세 번째 행에 매칭되어 DIRECT로 현재 네트워크를 통해 직접 연결됩니다.
  4. 도메인 또는 IP 조건에 해당하지 않는 나머지 요청은 마지막으로 FINAL,PROXY에서 처리됩니다.

DIRECT가 반드시 접속에 성공한다는 뜻은 아닙니다. 선택한 프록시 출구를 사용하지 않는다는 의미입니다. PROXY도 대상에 반드시 연결된다는 뜻은 아닙니다. 현재 프록시와 원격 서비스에 따라 달라집니다. REJECT는 매칭된 요청을 명시적으로 거부합니다. 이로 인해 브라우저에서 연결 실패가 발생했다면 프로토콜 매개변수를 바로 바꾸기 전에 규칙의 의도된 동작인지 먼저 확인하세요.

6. 규칙이 예상대로 적용되지 않을 때 확인할 순서

확인할 때는 한 번에 조건 하나만 수정하고 새 연결을 시작하세요. 브라우저의 기존 장기 연결은 연결을 맺을 당시 정해진 경로를 계속 사용할 수 있습니다. 규칙을 저장한 뒤 화면만 새로고침해도 새로운 연결 판정이 이루어지지 않을 수 있습니다. 테스트 대상, 현재 Global Routing, 활성 Config, 적용된 행, 최종 정책을 기록하면 문법 문제와 연결 문제를 구분하기 쉽습니다.

DOMAIN을 썼는데 하위 도메인은 왜 프록시로 연결되지 않나요?

요청 대상이 api.example.com인데 규칙에는 example.com만 작성했는지 확인하세요. 도메인과 모든 하위 도메인을 대상으로 하려면 DOMAIN-SUFFIX를 사용하세요. 하위 도메인 하나만 필요하다면 해당 도메인의 DOMAIN 규칙을 추가하고 더 넓은 범위의 규칙보다 앞에 배치하세요.

규칙을 추가했는데 모든 요청이 여전히 직접 연결되는 이유는 무엇인가요?

먼저 Home → Global Routing에서 Direct가 아니라 Config를 선택했는지 확인하세요. 그런 다음 Config에서 실제 활성화된 파일을 확인합니다. 활성화되지 않은 복사본을 수정해도 현재 연결의 트래픽 분기에는 영향이 없습니다.

구독을 새로고침한 뒤 로컬 규칙이 되돌아간 이유는 무엇인가요?

먼저 Home의 서비스 구독 업데이트와 Config의 원격 설정 업데이트를 구분하세요. 전자는 주로 서비스 항목을 관리하고, 후자는 Config 내용을 바꿀 수 있습니다. 로컬 규칙을 계속 보존하려면 별도의 복사본을 저장하고 업데이트 전후의 [Rule]을 비교하세요. 유일한 복사본을 계속 덮어쓰며 수정하지 마세요.

On Demand를 켜면 규칙도 자동으로 적용되나요?

Settings → On Demand에서는 조건에 따라 연결을 시작하는 동작을 관리합니다. Global Routing의 트래픽 분기 선택을 대신하지는 않습니다. 연결이 시작된 뒤에도 현재 모드와 Config를 확인해야 합니다. 연결됐다는 사실만으로 특정 규칙에 따라 처리됐다고 볼 수 없습니다.

연결 기록에 예상한 규칙이 적용된 것으로 표시된다면 그다음에는 전송 계층을 확인하세요. 아래는 연결 진단에 나타날 수 있는 원문 오류 메시지이며, [Rule] 문법 오류에 항상 표시되는 문구는 아닙니다. 시스템마다 표현이 다를 수 있으므로 오류가 직접 연결 대상에서 발생했는지 프록시 출구에서 발생했는지 함께 확인하세요.

오류: Connection refused

원인: 대상 호스트나 중간 장비가 연결을 명시적으로 거부했을 수 있으며, 해당 포트에서 서비스가 대기 중이지 않을 수 있습니다. 해결: 먼저 적용된 정책을 확인한 뒤 자신의 서비스 주소와 포트, 서비스 상태를 점검하세요. DIRECT가 적용됐다면 프록시 매개변수만 바꾸지 말고 직접 연결 대상도 확인하세요.

오류: Operation timed out

원인: 제한 시간 안에 연결 또는 읽기·쓰기가 완료되지 않았다는 뜻입니다. 이 메시지만으로 규칙, DNS, 네트워크 경로 중 무엇이 원인인지 확정할 수 없습니다. 해결: 대상과 적용된 정책을 기록하고 도메인 조회 결과와 선택한 출구를 각각 확인한 다음 서비스 포트를 점검하세요. 여러 규칙과 프로토콜 설정을 한꺼번에 변경하지 마세요.

7. Config 저장 전 최소 점검 목록

규칙 파일은 많다고 관리하기 쉬워지는 것이 아닙니다. 중복 접미사, 지나치게 짧은 키워드, 너무 앞에 배치된 기본 처리 규칙은 이후 예외를 확인하기 어렵게 만듭니다. 수정 후에는 최소한 ‘정확한 예외’, ‘같은 접미사를 가진 다른 하위 도메인’, ‘규칙에 해당하지 않는 도메인’의 세 가지 대상을 골라 정책을 확인하세요. IP 규칙을 사용한다면 대상 주소와 조회 결과도 별도로 확인합니다.

기억할 때는 세 그룹으로 나누면 편리합니다. DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD는 ‘도메인이 조건에 맞는가’를 판단합니다. GEOIP, IP-CIDR은 ‘대상 IP가 조건에 맞는가’를 판단합니다. FINAL은 ‘나머지 요청을 어떻게 처리할 것인가’를 정합니다. 세 그룹의 역할과 위에서 아래로 적용되는 순서를 파악한 뒤 복잡한 정책을 추가하면, 문제 발생 시 구체적인 규칙 행을 찾아가기 쉽습니다.