[Features]공식 가이드 · 기능 안내

기능 및 주요 설정

먼저 트래픽 경로, 서버 매개변수, 시스템 실행 조건을 구분한 다음 DNS와 진단 옵션을 조정하세요. 각 설정의 역할은 다르므로 연결에 실패하면 한 번에 하나씩만 변경해야 합니다.

Global Routing 규칙 및 서버 Settings 및 Diagnostics

아래 설명은 iPhone / iPad 화면의 메뉴 이름을 기준으로 합니다. 다른 플랫폼은 메뉴 배치가 다를 수 있으니 현재 클라이언트에 표시되는 내용을 확인하세요.

[Routing]

Global Routing의 세 가지 모드

기능: Global Routing은 요청을 설정 규칙에 따라 처리할지, 모두 프록시 또는 직접 연결로 처리할지 결정합니다. 설정, 프록시, 직접 연결은 각각 화면의 Config, Proxy, Direct에 해당합니다. 이는 서버 선택과는 별개의 설정입니다. 서버를 선택해도 모든 요청이 해당 서버를 거치는 것은 아닙니다.

위치 및 설정 방법: Home에서 Global Routing을 열고 사용 목적에 맞는 모드를 선택하세요. 평소 규칙에 따라 사용하려면 Config를 선택하고, Config 페이지에서 올바른 구성 파일이 활성화되어 있는지 확인합니다. 등록된 서버의 연결 여부를 확인할 때는 잠시 Proxy로 전환할 수 있습니다. 테스트를 마치면 원래 모드로 되돌리세요.

모드 주요 동작 사용 상황 확인할 사항
구성 Config 현재 구성의 규칙에 따라 처리 방식을 결정합니다. 도메인, IP 주소 또는 지역 조건에 따라 트래픽을 분기할 때 활성 구성, 규칙 순서, 마지막 처리 규칙을 확인합니다.
프록시 Proxy 클라이언트가 처리하는 요청은 일반적으로 현재 프록시를 사용합니다. 문제가 규칙 분기와 관련 있는지 일시적으로 확인할 때 선택한 서버, 프로토콜 매개변수, 네트워크 연결 상태를 확인합니다.
직접 연결 Direct 클라이언트가 처리하는 요청은 일반적으로 직접 연결됩니다. 로컬 네트워크 자체의 접속 상태를 비교할 때 직접 연결을 선택해도 시스템의 VPN 연결이 해제되는 것은 아닙니다.

주의사항: 시스템 트래픽 제외, 로컬 네트워크 우회, 플랫폼별 제한에 따라 실제 경로가 달라질 수 있습니다. Proxy를 선택했다고 기기의 모든 패킷이 원격 서버를 거친다고 단정하지 마세요. 같은 대상이 Proxy에서는 정상이고 Config에서는 실패한다면 서버를 바로 다시 만들기보다 먼저 규칙이 어떻게 적용됐는지 확인하세요.

[Rule]

규칙 유형과 처리 방식

기능: 규칙은 매칭 조건과 처리 방식으로 구성됩니다. 도메인 접미사, 도메인 키워드, IP 대역, 지역 데이터베이스는 각각 용도가 다릅니다. 규칙은 일반적으로 구성에 적힌 순서대로 확인하며, 먼저 일치하는 항목이 처리 방식을 결정합니다. PROXY, DIRECT, REJECT는 처리 방식 키워드이며 서버 프로토콜이 아닙니다.

위치 및 설정 방법: Config로 이동해 활성 구성을 확인한 다음 [Rule] 부분을 살펴보거나 수정하세요. 범위가 좁고 명확한 예외 규칙은 포괄적인 규칙보다 앞에 두고, 구성 마지막의 FINAL도 확인합니다. 아래는 규칙 문법 예시입니다. 예시 도메인은 실제 서비스를 가리키지 않으며 접속 가능한 서버 정보도 제공하지 않습니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
키워드매칭 대상사용 시 주의사항
DOMAIN지정한 전체 도메인다른 하위 도메인은 자동으로 포함하지 않습니다.
DOMAIN-SUFFIX지정한 도메인과 그 하위 도메인같은 도메인 체계에 속한 트래픽을 분기할 때 적합합니다.
DOMAIN-KEYWORD도메인에 포함된 키워드범위가 넓어 이름이 비슷한 대상까지 매칭될 수 있습니다.
IP-CIDR / IP-CIDR6IPv4 / IPv6 대역대역 범위와 요청의 실제 대상 주소를 확인하세요.
GEOIPIP 주소의 지역 정보판정 결과는 데이터베이스와 대상 주소에 따라 달라집니다.
FINAL앞선 규칙에 매칭되지 않은 요청뒤에 오는 규칙을 먼저 덮어쓰지 않도록 보통 규칙의 마지막에 둡니다.

주의사항: DIRECT는 직접 연결, PROXY는 해당 프록시 정책 적용, REJECT는 매칭된 요청 거부를 뜻합니다. 규칙을 추가해도 서버에서 누락된 인증 정보가 보완되지는 않습니다. 새 규칙을 추가한 뒤 대상에 다시 요청을 보내고 기록을 확인하세요. 기존 장시간 연결은 이전 경로를 계속 사용할 수 있습니다. 설정의 전체 의미는 설정 참고 가이드에서 확인할 수 있습니다.

[Server]

구독 및 서버 관리

기능: 서버 항목에는 주소, 포트, 프로토콜, 인증 매개변수가 저장됩니다. 구독은 사용자가 보유한 링크를 통해 여러 서버 항목을 가져오고 업데이트하는 기능입니다. 서버 구독과 규칙 구성은 서로 다른 항목이므로, 서버 목록을 업데이트해도 Config의 트래픽 분기 규칙이 바뀌는 것은 아닙니다.

위치 및 설정 방법: Home에서 Add Server를 눌러 보유한 서버를 추가하세요. 구독 링크가 있다면 적절한 Subscribe 항목을 선택하고 서비스 제공자가 전달한 전체 주소를 붙여 넣습니다. QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 가져온 뒤 서버 항목이 표시되는지 확인하고, 서버를 하나 선택해 Connectivity Test를 실행하세요. 마지막으로 연결 스위치를 켜 실제로 접속해 봅니다.

프로토콜별 입력값 확인

서버를 직접 추가할 때는 올바른 프로토콜을 먼저 선택한 다음 주소와 포트를 입력하세요. Shadowsocks는 암호화 방식과 비밀번호를 확인해야 합니다. VMess와 VLESS는 인증 정보와 전송 설정을 확인하고, Trojan은 비밀번호, TLS, SNI를 확인하세요. HTTP, SOCKS5, WireGuard, Hysteria2도 기존 서버에서 제공한 전체 매개변수를 기준으로 설정해야 합니다. 비슷해 보이는 항목을 다른 프로토콜에 그대로 적용하지 마세요.

주의사항: 구독을 업데이트하면 원격에서 삭제된 항목이 다시 구성되거나 제거될 수 있으며, 임시로 직접 수정한 내용은 유지되지 않을 수 있습니다. 중요한 매개변수는 별도로 안전하게 보관하세요. 문제 기록을 공유할 때는 구독 주소, 인증 정보, QR 코드를 가려야 합니다. 테스트에서 연결 가능으로 표시돼도 모든 대상에 접속할 수 있다는 뜻은 아닙니다. TLS, DNS, 현재 규칙도 확인해야 합니다. 처음 가져오는 경우 빠른 시작 안내에 따라 진행하세요.

[On Demand]

조건에 따라 연결 시작하기

기능: On Demand는 시스템의 주문형 연결 기능을 사용해 설정한 조건이 충족될 때 연결을 시작합니다. 이 기능은 ‘언제 연결할지’를 제어하며, Global Routing과 규칙은 ‘연결 후 요청을 어떻게 처리할지’를 제어합니다. 두 기능을 구분해서 이해해야 합니다.

위치 및 설정 방법: Settings에서 On Demand 관련 항목을 찾아 사용할 수 있는 네트워크 조건과 실행 설정을 확인하세요. 수동 연결이 정상적으로 작동하는지 먼저 확인한 다음 기능을 켜고, 필요에 따라 Wi-Fi 또는 셀룰러 네트워크 조건을 설정합니다. Wi-Fi 이름을 기준으로 설정한다면 실제 네트워크 이름을 확인해 게스트 네트워크나 이름이 같은 다른 네트워크를 잘못 지정하지 않도록 하세요.

주의사항: 설정을 변경한 뒤 네트워크에 접속할 때, 네트워크에서 벗어날 때, 연결을 끊은 후 다시 접속할 때를 각각 테스트하세요. 수동으로 연결을 끊었는데 다시 자동 연결된다면 On Demand 조건이 여전히 충족되는지 먼저 확인하세요. 시스템 구성을 반복해서 삭제하지 마세요. 주문형 연결은 잘못된 서버 매개변수를 수정하지 않으며, 네트워크 전환 중 기존 연결이 계속 유지된다고 보장하지도 않습니다. 문제를 일시적으로 확인할 때는 주문형 조건을 끄고 수동 연결로 테스트한 뒤 다시 설정하세요.

[Data]

트래픽 통계와 확인 범위

기능: Data에서는 클라이언트가 기록한 트래픽 정보를 확인할 수 있으며, 업로드와 다운로드 및 제공되는 분류별 통계를 살펴볼 수 있습니다. 이 정보는 클라이언트가 기록할 수 있는 트래픽을 보여줍니다. 통신사 청구 내역이 아니며 구독 서비스의 잔여 용량으로 볼 수도 없습니다.

위치 및 설정 방법: Data를 열고 통계 범위, 기간, 화면에서 제공하는 분류를 확인한 다음 재현 가능한 접속을 한 번 진행해 보세요. 변경 전후를 비교할 때는 같은 네트워크와 대상, 비슷한 사용 조건을 유지해야 합니다. 기록을 새로 시작하려면 재설정 작업의 적용 범위를 화면에서 먼저 확인하고, 필요한 정보를 저장한 다음 실행하세요.

주의사항: 백그라운드 작업, 시스템 트래픽, 연결 재사용, 통계 시작 및 종료 시점에 따라 숫자가 달라질 수 있습니다. 다운로드 통계가 증가했다는 사실은 확인 범위에서 데이터가 전송됐다는 뜻일 뿐, 특정 요청이 의도한 규칙에 매칭됐다는 근거는 아닙니다. 실제 트래픽 경로를 확인하려면 전체 사용량만 보지 말고 요청 기록, 대상 도메인, 선택한 모드와 정책을 함께 확인하세요.

[Settings]

주요 설정 항목별 안내

Settings의 옵션은 DNS 조회, 테스트, 빠른 실행 메뉴, 데이터 동기화 등의 동작을 조정합니다. 플랫폼과 클라이언트 버전에 따라 메뉴 구성이 다를 수 있습니다. 용도를 확인하기 전에는 현재 설정을 유지하고, 다른 기기의 화면을 그대로 따라 설정하지 마세요. 아래에서는 고정된 기본값을 제시하지 않으며 현재 화면, 활성 구성, 실제 네트워크 조건을 기준으로 확인해야 합니다.

DNS: 먼저 DNS를 처리하는 위치 확인

용도 및 위치: DNS는 도메인 이름을 IP 주소로 변환합니다. 관련 동작은 Settings의 DNS 옵션이나 Config의 [General] 항목에 따라 달라질 수 있습니다. 확인할 때는 활성 구성을 연 다음 클라이언트의 현재 DNS 설정과 대조하세요. 한쪽만 확인해서는 안 됩니다.

설정 및 주의사항: 먼저 현재 DNS 방식으로 정상 작동하는 기준 상태를 확인하세요. 명확한 DNS 조회 실패, 비정상 주소, 특정 네트워크와의 호환성 문제가 있을 때만 현재 네트워크 조건에 맞춰 설정을 변경합니다. 구성의 dns-server = system은 시스템 DNS를 사용한다는 뜻입니다. 변경 후 테스트 요청을 다시 보내고 캐시와 기존 연결의 영향을 고려하세요. DNS가 정상이어도 서버 인증이 정상이라는 뜻은 아니며, 암호화된 DNS를 사용해도 서비스 요청이 반드시 프록시를 거치는 것은 아닙니다.

Test Method: 무엇을 테스트하는지 확인

용도 및 위치: Settings에서 Test Method를 확인하세요. 이 항목은 연결 가능성 테스트 방식을 결정합니다. 방식에 따라 네트워크 계층의 연결만 확인하거나 테스트 대상에 실제로 접속할 수 있으므로, 선택한 방식을 고려해 결과를 해석해야 합니다.

설정 및 주의사항: 여러 서버를 비교할 때는 동일한 테스트 방식을 사용하고 화면에서 설정할 수 있는 테스트 대상도 확인하세요. 테스트는 실패했지만 실제 접속이 정상이라면 테스트 대상에 연결할 수 없거나 응답하지 않는 문제부터 확인해야 합니다. Connectivity Test 결과는 참고용입니다. 테스트를 통과해도 실제 서비스 요청을 확인해야 하며, 한 번의 테스트 결과만으로 장기적인 연결 품질을 판단할 수 없습니다.

Today Widget: 빠른 확인 메뉴

용도 및 위치: Today Widget 설정은 시스템에서 지원하는 빠른 확인 또는 조작 메뉴를 구성합니다. Settings에서 클라이언트가 제공하는 옵션을 확인한 다음 시스템에서 위젯을 추가할 수 있는 위치로 이동해 설정하세요. 사용할 수 있는 기능은 시스템과 현재 클라이언트에 따라 달라집니다.

설정 및 주의사항: 위젯을 추가한 뒤 표시되는 내용이 올바른지 확인하고, 빠른 조작 결과가 앱 내부 상태와 일치하는지 테스트하세요. 위젯은 시스템의 새로고침 주기에 영향을 받으므로 표시 내용이 즉시 갱신되지 않을 수 있습니다. 연결 상태가 의심되면 Home으로 돌아가 확인하세요. 위젯에 표시된 이전 상태만 보고 반복해서 전환하지 마세요.

iCloud: 동기화 범위를 직접 확인

용도 및 위치: Settings에서 iCloud 동기화 옵션을 찾고 시스템에서 Shadowrocket의 iCloud 접근을 허용했는지 확인하세요. 동기화는 지원되는 데이터를 같은 계정의 기기 간에 일치시키는 기능입니다. 모든 실행 상태가 완전히 복제되는 것은 아닙니다.

설정 및 주의사항: 기기를 옮기기 전에 기존 기기에서 동기화가 완료됐는지 확인하고 중요한 구성 파일을 별도로 저장하세요. 새 기기에서 같은 iCloud 계정을 사용한 뒤 서버, 구독, 활성 구성을 각각 확인합니다. 시스템 연결 권한은 새 기기에서 따로 확인해야 합니다. 동기화에는 지연이 발생할 수 있고 삭제 작업도 전파될 수 있으므로 과거 상태를 복원하는 백업으로 간주하지 마세요. 민감한 구성이 있다면 기기와 계정의 접근 권한도 확인해야 합니다.

[Diagnostics]

진단 및 로그 활용 방법

기능: Diagnostics와 관련 로그 옵션은 연결 과정의 단서를 수집해 DNS 조회, 서버 연결, 인증, 규칙 매칭 문제를 구분하는 데 도움을 줍니다. 로그 기록 자체가 연결 문제를 해결해 주지는 않으며, 문제가 있는 대상이 없는데 수집 범위를 계속 넓힐 필요도 없습니다.

위치 및 설정 방법: Settings에서 Diagnostics 또는 현재 화면에서 제공하는 로그 메뉴를 찾으세요. 네트워크 유형, 선택한 서버, Global Routing 모드를 먼저 기록한 뒤 필요한 로그를 켜고 실패한 요청을 한 번 다시 보내세요. 대상 주소가 올바른지, DNS 오류나 연결 실패 또는 인증 관련 정보가 나타나는지 확인하고 문제 발생 단계를 파악합니다.

주의사항: 한 번에 문제 하나만 재현해 백그라운드 요청이 단서를 덮지 않도록 하세요. 기록을 공유하기 전 구독 링크, 비밀번호, 인증 정보, 개인 도메인, 불필요한 접속 기록을 삭제하세요. 진단이 끝나면 적절한 로그 수준으로 되돌립니다. 특정 Wi-Fi에서만 실패한다면 같은 구성으로 네트워크를 바꿔 다시 테스트하세요. Config에서만 실패한다면 TLS 검사를 바로 완화하지 말고 규칙부터 확인해야 합니다.

[Verify]

설정 간 의존 순서대로 확인

기능 간에는 의존 관계가 있습니다. 유효한 서버 매개변수는 연결의 기반이고, 올바른 구성은 트래픽 분기를 결정하며, DNS는 도메인 조회 결과를 좌우합니다. On Demand는 연결을 시작하는 조건만 제어합니다. 이 단계들을 혼동해 함께 변경하면 문제를 재현하기 어렵고 원래 설정으로 되돌리기도 힘들어집니다.

  1. 먼저 입력값을 확인합니다. 기존 구독이 업데이트되는지, 또는 수동으로 추가한 서버의 프로토콜, 주소, 포트, 인증 정보가 모두 입력됐는지 확인하세요. 누락된 매개변수를 규칙 변경으로 보완하지 마세요.
  2. 기본 연결을 확인합니다. 서버를 하나 선택해 현재 네트워크에서 테스트를 실행하고 실제로 접속해 보세요. 필요한 경우 문제 범위를 좁히기 위해 잠시 Proxy를 사용한 뒤 원래 모드로 되돌립니다.
  3. 그다음 트래픽 분기를 확인합니다. Config로 전환해 활성 구성, 규칙 순서, FINAL을 확인하세요. 같은 대상에 다시 요청을 보내고 어떤 규칙이 적용됐는지 확인합니다.
  4. 마지막으로 자동화 기능을 추가합니다. 수동 연결이 안정적으로 작동한 뒤 On Demand, 위젯 메뉴, 동기화를 설정하세요. 항목을 하나씩 추가하며 각각 작동을 확인하고 원래 설정으로 되돌릴 수 있도록 정보를 남겨 두세요.

문제를 계속 찾기 어렵다면 자주 묻는 질문에서 증상별로 확인하세요. 설정 간의 영향을 알아보려면 Settings 설정 참고를 살펴보세요. ‘어떤 네트워크에서, 어떤 모드로, 어떤 대상에 접속할 때 실패했는지’를 기록하면 여러 설정을 한꺼번에 바꾸는 것보다 원인을 찾는 데 도움이 됩니다.