공식 가이드 · 기능 및 설정

Shadowrocket 프록시 모드 및 주요 설정

먼저 Global Routing에서 연결을 처리할 방식을 선택한 뒤 Config의 규칙과 Settings의 세부 옵션을 조정합니다. 모드, 서버, DNS는 각각 다른 설정 항목입니다. 변경 사항의 영향을 파악하려면 한 번에 하나씩 바꾸세요.

  • Global Routing: 연결 처리 방식 선택
  • Config: 규칙 및 정책 설정
  • Diagnostics: 문제 발생 지점 확인

이 페이지에서는 iPhone / iPad 화면을 기준으로 안내합니다. 운영체제와 앱 버전에 따라 메뉴 위치가 다를 수 있으므로 현재 기기에 표시되는 옵션을 확인하세요. 처음 사용하는 경우 먼저 사용 안내를 읽고, 앱이 필요하면 앱 다운로드 페이지를 확인하세요.

기능 및 설정목차

연결은 되지만 분류 결과가 예상과 다르면 앞의 두 섹션부터 확인하세요. 연결할 수 없다면 서버 정보를 확인한 다음 DNS와 Diagnostics를 점검하세요.

Home · Global Routing

Config, Proxy, Direct 세 가지 모드 비교

Global Routing은 연결의 전반적인 처리 방식을 정합니다. 서버 목록의 특정 서버나 시스템 연결 스위치와는 다른 설정입니다.

Home에서 Global Routing을 찾아 사용 목적에 따라 Config, Proxy 또는 Direct를 선택하세요. 세 모드는 각각 설정에 따른 처리, 프록시 처리, 직접 연결을 뜻합니다. Config는 현재 설정의 정책에 따라 연결을 처리하고, Proxy는 앱이 가로챈 연결을 프록시로 전달하며, Direct는 가로챈 연결을 대상에 직접 연결합니다. 여기서 설명하는 것은 앱이 처리하는 트래픽이며, 모드 이름만으로 시스템의 모든 동작을 단정할 수는 없습니다.

화면 표시 및 의미 사용 시점 설정 전 확인 사항 혼동하기 쉬운 점
Config · 설정 평소 도메인이나 주소 등의 조건에 따라 트래픽을 분류할 때 사용합니다. Config에서 올바른 설정을 선택하고 규칙과 FINAL을 확인하세요. Config로 전환해도 규칙이 자동으로 추가되거나 잘못된 서버 정보가 수정되지는 않습니다.
Proxy · 프록시 선택한 서버로 원하는 대상에 연결할 수 있는지 잠깐 확인할 때 사용합니다. 선택한 서버와 프로토콜 설정이 올바른지, 기본 네트워크가 작동하는지 확인하세요. Config에서 평소 적용되는 규칙과 같은 방식으로 트래픽을 분류하지 않으므로, 규칙이 올바른지 확인하는 테스트로는 적합하지 않습니다.
Direct · 직접 연결 프록시 서버를 거치지 않고 기본 네트워크로 대상에 접속할 수 있는지 확인합니다. 테스트할 대상을 정하고 전환 전 모드를 기록하세요. Direct는 연결 스위치를 끄는 것과 다릅니다. 앱이 계속 활성화된 상태일 수 있습니다.

테스트 목적에 맞게 전환한 뒤 평소 설정으로 복원

예를 들어 같은 웹사이트가 Proxy에서는 열리지만 Config에서는 열리지 않는다면, 서버를 바로 바꾸기보다 Config에서 해당 연결에 적용된 규칙부터 확인하세요. Direct에서도 기본적인 웹사이트에 접속할 수 없다면 Wi-Fi, 셀룰러 네트워크 또는 네트워크 로그인 상태를 먼저 점검하세요. 모드를 바꿀 때마다 새 요청을 보내고, 필요하면 기존 페이지를 닫았다가 다시 열어 이전 연결이 재사용되어 결과에 영향을 주지 않도록 하세요.

비교를 마친 뒤에는 원래 사용하던 Global Routing 모드로 되돌리세요. 모드와 서버, DNS를 한꺼번에 바꾸면 결과가 어떤 변경 때문인지 알기 어렵습니다. 일시적으로 접속이 복구되더라도 재현 가능한 문제 해결 방법을 찾을 수 없습니다.

Config · Rule

규칙 매칭 및 정책 선택

규칙은 ‘어떤 연결’을 처리할지, 정책은 ‘어떻게 처리할지’를 정합니다. 사용 전에 Global Routing이 Config인지 확인하세요.

규칙은 보통 Config에서 현재 설정을 열어 확인하거나 수정합니다. 자주 쓰는 규칙 유형으로는 도메인을 정확히 매칭하는 DOMAIN, 도메인과 하위 도메인을 매칭하는 DOMAIN-SUFFIX, 도메인에 특정 문자열이 포함되어 있는지 확인하는 DOMAIN-KEYWORD, 주소 범위를 지정하는 IP-CIDR 및 IP-CIDR6가 있습니다. GEOIP는 해당 주소 데이터베이스를 사용하므로 그 결과만으로 기업의 소속 국가나 서버의 실제 운영 위치를 확정할 수는 없습니다.

PROXY는 프록시를 통해 처리하고, DIRECT는 직접 연결하며, REJECT는 매칭된 연결을 거부합니다. 규칙에서 설정에 정의된 정책 이름을 참조할 수도 있습니다. 이때 해당 이름이 실제로 존재하며 의도한 대상을 가리키는지 확인해야 합니다. 비슷한 이름이라고 같은 정책은 아니므로, 가져온 후 설정이 정상적으로 로드되는지 확인하세요.

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

다음은 문법을 보여 주기 위한 예시입니다. example.com과 example.org는 설명용 도메인이며 실제로 프록시를 사용해야 하는 웹사이트를 뜻하지 않습니다. 첫 번째 줄은 지정한 도메인만 대상으로 하고, 두 번째 줄은 example.org와 하위 도메인까지 포함합니다. 세 번째 줄은 사설 주소 대역을 직접 연결하도록 설정합니다. 마지막의 FINAL은 앞선 규칙에 매칭되지 않은 연결을 처리합니다.

규칙 순서와 적용 범위부터 확인

규칙은 일반적으로 위에서부터 차례로 매칭하며, 처음 일치한 규칙에 따라 처리됩니다. 범위가 넓은 규칙을 앞에 두면 뒤에 있는 구체적인 예외 규칙이 적용되지 않을 수 있습니다. 규칙을 추가할 때는 구체적인 예외를 먼저 쓰고, 더 넓은 범위의 규칙을 그다음에 배치한 뒤 FINAL을 확인하세요. DOMAIN-KEYWORD는 의도보다 넓게 매칭될 수 있습니다. 특정 웹사이트의 고정된 전체 도메인 목록이 아니라 문자열을 기준으로 매칭합니다.

수정 전에는 기존 설정을 복사해 보관하고, 저장한 뒤 수정한 설정이 현재 활성화되어 있는지 확인하세요. 웹페이지 하나가 이미지, 로그인 또는 API에 별도 도메인을 요청할 수도 있습니다. 따라서 ‘첫 화면이 열림’과 ‘페이지의 모든 기능이 정상 작동함’은 서로 다릅니다. 특정 웹사이트만 프록시로 연결하려면 DOMAIN-SUFFIX 및 FINAL 활용 예시를 참고하세요.

Home · Add Server · Subscribe

구독 및 서버 관리

Subscribe에서는 업데이트 가능한 서버 소스를 관리하고, Add Server에서는 서버 정보를 직접 입력합니다. 두 방법 모두 유효한 연결 정보가 필요합니다.

Home에서 추가 메뉴를 열고 Add Server로 이동하세요. 보유한 정보에 맞는 Type을 선택한 뒤 주소, 포트, 인증 정보를 입력합니다. 구독 링크가 있다면 Subscribe 메뉴에서 가져오고, QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 구독 링크는 이용 중인 서비스 제공업체에서 확인하세요. 복사할 때는 앞뒤 공백이나 줄바꿈, 안내 문구가 함께 복사되지 않았는지 살펴보세요.

Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2 등은 서로 다른 프로토콜 또는 연결 유형입니다. 이름이 비슷하다고 같은 매개변수를 적용할 수는 없습니다. Type을 잘못 선택하면 주소와 포트가 맞아 보여도 연결되지 않을 수 있습니다. TLS, SNI, 전송 방식 등의 항목을 원본 정보와 하나씩 대조하고, 경고를 없애기 위해 인증서 검증을 임의로 완화하지 마세요.

구독 업데이트와 개별 항목 수정의 차이

구독을 업데이트하면 해당 소스에서 서버 목록을 다시 가져옵니다. 구독으로 생성된 항목을 직접 수정하면 다음 업데이트에서 변경 내용이 덮어써질 수 있습니다. 먼저 해당 항목이 직접 관리되는지 구독으로 관리되는지 확인하세요. 계속 보관해야 하는 개인 메모나 별도의 테스트 기록은 현재 버전에 적합한 방식으로 관리하고, 업데이트 후에도 남아 있는지 확인하세요.

여러 Subscribe를 관리할 때는 소스와 용도를 기준으로 이름을 붙인 뒤 순서를 정리하세요. 이름이 같아도 같은 서버라고 단정할 수 없으므로 주소, 포트, 프로토콜, 인증 정보를 함께 확인해야 합니다. 삭제 전에는 현재 선택되어 있거나 설정의 정책에서 참조 중인지 확인하세요. 업데이트 후에는 선택된 서버도 다시 확인해 목록 변경으로 엉뚱한 항목을 사용하지 않도록 하세요.

구독 주소에 접근 자격 증명이 포함되어 있을 수 있습니다. 스크린샷, 내보낸 파일 또는 진단 자료를 공유하기 전에 전체 링크와 비밀번호, 인증 정보를 가리세요. 가져오기는 성공했지만 선택할 항목이 없다면 같은 구독을 반복해서 만들기보다 응답이 지원되는 구독 데이터인지, 소스에 접속할 수 있는지부터 확인하세요.

Settings · On Demand

On Demand 자동 연결

On Demand는 설정된 네트워크 조건에 따라 연결 동작을 시작합니다. Config의 개별 규칙을 대신하지는 않습니다.

Settings 또는 현재 버전에서 제공하는 On Demand 메뉴를 열고, 먼저 사용 가능한 조건을 확인하세요. Wi-Fi, 셀룰러 네트워크 또는 지정된 네트워크 등 실제로 표시되는 옵션에 맞춰 설정합니다. 먼저 Wi-Fi와 셀룰러 네트워크 간 전환처럼 확인하기 쉬운 조건 하나만 테스트하고, 예상대로 작동하는지 확인한 뒤 조건을 추가하세요.

활성화하기 전에 수동으로 정상 연결을 한 번 완료하고 선택한 서버와 Config가 작동하는지 확인하세요. 그렇지 않으면 자동 연결도 같은 실패를 반복할 뿐입니다. 설정 후 관련 화면을 닫고 실제로 네트워크를 전환해 시스템 연결 상태를 확인한 다음 다시 접속을 시도하세요. On Demand 스위치가 켜져 있다는 사실만으로 모든 조건이 제대로 작동한다고 볼 수는 없습니다.

수동으로 끈 뒤 다시 연결되면 트리거 조건 확인

네트워크가 바뀐 뒤 연결이 다시 설정된다면 On Demand 규칙이 여전히 적용 중일 수 있습니다. 자동 동작을 일시 중지하려면 Home의 연결 스위치만 반복해서 조작하지 말고 해당 조건을 확인하세요. 테스트가 끝나면 어떤 조건을 유지했는지 기록해 두면 나중에 자동 재연결을 오류로 오해하지 않을 수 있습니다.

호텔이나 공공장소처럼 웹페이지 인증이 필요한 네트워크에서는 프록시 연결을 시작하기 전에 네트워크 로그인을 완료해야 할 수 있습니다. 연결이 반복해서 바뀐다면 자동 연결 조건을 조정하기 전에 네트워크 인증과 신호 안정성부터 확인하세요. On Demand로 만료된 구독, 잘못된 비밀번호 또는 접속할 수 없는 서버를 사용할 수 있게 만들 수는 없습니다.

Data

트래픽 통계 및 확인 방법

Data에서는 앱에 기록된 트래픽 변화를 확인할 수 있습니다. 통계 범위와 초기화 주기는 화면에 표시된 내용을 따르세요.

Data를 열고 먼저 업로드, 다운로드, 현재 속도, 누적 사용량을 구분한 다음 화면에서 제공하는 필터나 기간을 확인하세요. 속도는 일정 시간 동안의 데이터 변화를 나타내고, 누적 사용량은 통계 기간 내 데이터 총량을 나타냅니다. 두 값은 서로 대체할 수 없으며, 특정 순간의 수치 하나만으로 연결 품질을 판단하기도 어렵습니다.

특정 동작의 영향을 확인하려면 먼저 현재 수치와 시간을 기록하고, 해당 동작만 수행한 다음 Data로 돌아와 변화를 비교하세요. 현재 버전에 초기화 기능이 있다면 기록을 보관해야 하는지 먼저 확인한 뒤 초기화하세요. 백그라운드 동기화, 이미지 로딩, 시스템 작업도 트래픽을 발생시킬 수 있으므로 테스트 중에는 다른 활동을 되도록 줄이세요.

기기 내 통계와 서버 측 사용량은 다를 수 있습니다

앱과 서버의 통계는 집계 기간, 프로토콜 오버헤드, 계산 방식이 다를 수 있습니다. 차이가 있다면 먼저 통계 기준을 맞춰 비교하세요. Data를 구독 잔여량을 확인하는 유일한 기준으로 삼거나, 특정 요청이 PROXY에 매칭되었다는 증거로 볼 수는 없습니다. 트래픽 분류 결과를 확인하려면 Global Routing, 현재 설정, 연결 기록을 함께 살펴보세요.

사용하지 않을 때에도 트래픽이 발생한다면 사진 동기화, 시스템 업데이트, 계속 실행 중인 오디오·비디오, 앱의 백그라운드 작업부터 확인한 뒤 추가 진단이 필요한지 판단하세요. 트래픽 그래프만으로 On Demand나 특정 규칙에 문제가 있다고 단정하지 마세요.

Settings · DNS · Config

DNS 설정 및 도메인 조회

DNS는 도메인을 연결에 필요한 주소로 변환합니다. 도메인 조회가 정상인지와 프록시 서버를 사용할 수 있는지는 각각 따로 확인해야 합니다.

Settings의 DNS 관련 메뉴와 현재 Config에서 조회 설정을 확인하세요. 설정에 따라 개별 DNS 항목이 있을 수 있으므로 수정 전에 실제 적용 중인 설정이 어디에서 오는지 확인하세요. 사용하지 않는 옵션만 바꾸는 일이 없도록 주의하세요. 처음 문제를 확인할 때는 작동 중인 기본 설정을 유지하고 서로 충돌하는 주소를 한꺼번에 입력하지 마세요.

DNS를 변경해야 한다면 기존 값을 기록한 뒤 형식이 올바르고 현재 네트워크에서 접속할 수 있는 DNS 서버 주소를 사용하세요. 암호화된 전송 방식의 DNS를 사용한다면 DNS 서버 자체의 연결 조건과 라우팅도 고려해야 합니다. 설정을 저장할 수 있다고 해서 해당 서버에 실제로 연결할 수 있는 것은 아닙니다.

DNS 조회 실패와 연결 실패를 구분하세요

‘서버 이름을 조회할 수 없음’, ‘주소는 확인됐지만 연결 시간 초과’, ‘연결 후 인증서 불일치’는 각각 다른 단계에서 발생하는 문제입니다. 현재 버전에서 제공하는 DNS 또는 진단 도구로 대상 도메인이 올바른 결과를 반환하는지 먼저 확인한 다음 서버 연결을 테스트하세요. 웹페이지가 열리는지만으로 모든 DNS 동작을 판단하지 마세요.

설정을 바꾼 뒤 새 요청을 보내고, 필요하면 앱 연결을 다시 설정해 기존 연결과 캐시의 영향을 줄이세요. 주소 규칙과 도메인 규칙은 서로 다른 정보에 따라 매칭될 수 있으므로 실제 기록을 바탕으로 확인해야 합니다. 특정 도메인이 조회한 주소 하나를 해당 웹사이트의 모든 서비스가 사용하는 고정 주소로 간주하지 마세요.

Settings

Test Method, Today Widget 및 iCloud

주요 설정은 각각 다른 목적에 사용됩니다. 테스트 방식은 테스트 결과에, 빠른 실행 위젯은 작업 진입 경로에, 동기화는 설정의 저장과 이전에 영향을 줍니다.

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

Settings에서 Test Method를 열어 사용할 수 있는 테스트 방식과 해당 매개변수를 확인한 다음 Home으로 돌아가 Connectivity Test를 실행하세요. 방식에 따라 연결 성립 여부만 확인하거나 지정한 대상에 요청을 보낼 수 있습니다. 테스트 성공은 해당 테스트 조건이 충족됐다는 뜻일 뿐, 모든 웹사이트와 프로토콜이 정상 작동한다는 의미는 아닙니다.

여러 서버를 비교할 때는 Test Method, 테스트 대상, 기본 네트워크를 동일하게 유지하세요. 조건이 다른 결과를 한데 모아 순위를 매기지 마세요. Connectivity Test는 성공하지만 실제 웹페이지가 열리지 않는다면 대상 웹사이트, 매칭된 규칙, DNS를 추가로 확인하세요. 테스트 대상 자체에 접속할 수 없다면 여러 서버가 동시에 오류로 표시될 수도 있습니다.

Today Widget: 빠른 실행 후 상태 확인

현재 운영체제와 앱 버전에서 Today Widget을 지원한다면 시스템에서 허용하는 위젯 위치에 추가하고 Settings에서 관련 옵션을 확인하세요. 위젯은 빠른 실행이나 상태 확인을 위한 기능이며, 별도의 서버 설정을 갖고 있지는 않습니다. 작업을 마친 뒤 Home으로 돌아가 선택된 서버, Global Routing, 연결 상태를 확인하세요.

위젯 표시 방식과 새로고침 시점은 시스템의 제약에 따라 달라질 수 있습니다. 위젯이 보이지 않거나 상태가 바로 갱신되지 않으면 운영체제 버전, 위젯 추가 여부, 앱 내 스위치를 먼저 확인하세요. 위젯에 표시된 문구만으로 연결이 성립했는지 판단하지 말고, 정확한 확인이 필요하면 앱 내 상태와 실제 요청 결과를 함께 살펴보세요.

iCloud: 동기화 전에 복구 가능한 사본 보관

iCloud 동기화를 사용하기 전에 기기가 사용할 Apple 계정으로 로그인되어 있고 관련 iCloud 기능이 허용되어 있는지 확인하세요. Settings에서 동기화 옵션을 살펴보고 현재 버전에서 어떤 항목을 동기화하는지 확인한 다음 다른 기기에서 결과를 점검하세요. 동기화가 한 기기의 모든 시스템 권한, 네트워크 상태, 실행 중인 연결을 그대로 복사하는 것은 아닙니다.

기기를 옮기기 전에 보관할 Config를 별도로 내보내고 구독 소스를 기록해 두는 것이 좋습니다. 두 기기에서 같은 설정을 동시에 수정하면 변경 사항이 덮어써지거나 충돌할 수 있습니다. 한 기기에서 수정한 뒤 동기화가 완료되었는지 확인하고, 그다음 다른 기기에서 작업하세요. 서버 정보가 포함된 내보내기 파일은 안전하게 보관하고 공유 전에 인증 정보를 삭제하세요. 자세한 절차는 설정 백업 및 복원 안내를 참고하세요.

Settings · Diagnostics

Diagnostics 및 문제 해결 순서

진단의 목적은 모든 설정을 초기화하는 것이 아니라 어느 단계에서 문제가 발생했는지 확인하는 것입니다.

Settings에서 Diagnostics 또는 현재 버전의 진단 메뉴를 찾아 증상에 맞는 도구를 선택하세요. 먼저 현재 네트워크, 선택한 서버, Global Routing, Config 이름을 기록한 뒤 문제를 한 번 재현합니다. 연결 기록이 있다면 마지막 오류 한 줄만 보는 대신 대상 도메인, 매칭된 정책, 실패 단계에 주목하세요.

  1. 기본 네트워크를 확인하세요. Wi-Fi 또는 셀룰러 네트워크가 작동하는지, 먼저 네트워크 로그인을 해야 하는지 확인합니다.
  2. 서버 정보를 확인하세요. Type, 주소, 포트, 인증 매개변수가 올바른지 점검하고 잘못된 정보를 바탕으로 규칙을 반복해서 수정하지 마세요.
  3. Global Routing을 짧게 비교하세요. 테스트 목적을 명확히 한 뒤 Proxy와 Config를 비교하고, 완료 후 평소 사용하던 모드로 되돌리세요.
  4. DNS와 규칙을 확인하세요. 도메인 조회, 규칙 매칭 순서, 정책 참조, FINAL을 각각 확인해 설정의 차이를 파악하세요.
  5. 재현에 필요한 조건만 유지하세요. 한 번에 하나씩 변경하고 변경 내용과 결과를 기록하세요. 효과가 없는 변경은 바로 되돌리세요.

로그나 진단 내보내기 파일에 서버 주소, 접속 도메인, 구독 링크, 인증 정보가 포함될 수 있습니다. 문제 해결을 도와줄 사람에게 보내기 전에 민감한 내용을 확인하고 가리세요. 원본 전체를 공개 스크린샷에 올리지 마세요. 오류 유형, 작업 순서, 민감한 정보를 삭제한 규칙 일부를 공유하면 문제 재현에 도움이 됩니다.

네트워크 전환 후에만 문제가 생기면 On Demand의 트리거 조건을 확인하세요. 특정 웹사이트에서만 문제가 생기면 해당 사이트의 도메인과 정책을 먼저 살펴보세요. 모든 연결이 동시에 실패한다면 기본 네트워크, 서버, 인증 정보부터 점검하세요. 증상별 처리 절차는 문제 해결에서, 간단한 질문은 자주 묻는 질문에서 확인하세요.