Home
Home은 서버 목록을 확인하고 서버를 선택하거나 연결을 제어하는 주요 화면입니다. 가져온 항목이 목록에 표시되는지도 여기서 확인할 수 있습니다. 항목을 선택했다는 것은 연결 후보를 지정했다는 뜻일 뿐, 연결이 완료된 것은 아닙니다. 연결 스위치와 시스템 권한, 실제 접속 결과도 확인하세요.
Shadowrocket 공식 매뉴얼 · 용어 색인
Shadowrocket
용어 및 규칙 키워드
먼저 용어가 표시된 화면을 확인한 다음, 연결·서버 목록·요청 분기 중 무엇에 영향을 주는지 살펴보세요. 이 페이지는 영문 인터페이스 용어와 프로토콜 이름을 그대로 두고 자주 쓰이는 용어를 다섯 가지로 나누어 설명합니다. 카드 제목의 링크를 눌러 해당 항목으로 바로 이동할 수 있어 실제 화면과 대조하기 좋습니다.
인터페이스와 스위치
먼저 ‘어디에서 조작하는지’와 ‘트래픽을 어떤 방식으로 처리하는지’를 구분하세요. 같은 용어라도 표시되는 위치에 따라 서로 다른 설정 단계를 가리킬 수 있습니다.
Global Routing
Global Routing은 전체 트래픽을 처리하는 모드를 정합니다. 화면의 Config, Proxy, Direct는 각각 설정에 따른 처리, 프록시 연결, 직접 연결을 뜻합니다. 요청별로 규칙을 적용하려면 보통 Config를 선택합니다. 문제를 점검하느라 모드를 임시로 바꿨다면 테스트 결과를 규칙 적용 결과로 오해하지 않도록 원래 설정으로 되돌리세요.
Config
Config는 두 가지 맥락에서 쓰입니다. 하나는 설정 파일을 관리하는 화면이고, 다른 하나는 Global Routing에서 설정에 따라 트래픽을 처리하는 모드입니다. 전자는 파일 가져오기, 편집, 활성화에 관한 것이고 후자는 실제 연결에서 사용할 라우팅 방식에 관한 것입니다. 파일을 가져오기만 하고 활성 항목을 확인하지 않았다면 규칙이 적용 중이라고 볼 수 없습니다.
Proxy / Direct
Global Routing의 Proxy와 Direct는 각각 전체 트래픽을 프록시 또는 직접 연결로 처리하는 모드이며, 넓은 범위의 요청 라우팅을 바꿉니다. 규칙 행에 쓰이는 대문자 PROXY, DIRECT와는 다릅니다. 전자는 모드 선택이고 후자는 개별 규칙의 처리 결과이므로, 문제를 점검할 때 먼저 어느 단계의 설정을 바꿨는지 확인하세요.
On Demand
On Demand는 미리 지정한 네트워크 조건에 따라 연결을 시작합니다. 네트워크 환경에 맞춰 연결을 자동으로 설정할 때 유용합니다. On Demand는 ‘언제 연결할지’를 정하고 Rule은 ‘연결 후 요청을 어떻게 처리할지’를 정합니다. 설정을 변경한 뒤에는 해당 네트워크 조건에서 테스트해야 하며, 스위치가 켜져 있는지만 확인해서는 충분하지 않습니다.
Settings / Data
Settings에서는 앱 설정을, Data에서는 관련 사용 데이터를 확인합니다. 구체적인 항목은 기기의 현재 화면을 기준으로 확인하세요. 설정값은 예상 동작을, 데이터 기록은 관찰된 활동을 나타냅니다. 누적 트래픽이 늘었다는 사실만으로 특정 도메인이 의도한 전략을 사용했다고 판단할 수는 없습니다.
프록시 프로토콜
프로토콜은 클라이언트와 서버가 통신하는 방식을 정하며, 트래픽 분기 대상은 정하지 않습니다. 프로토콜을 선택한 뒤에도 보유한 서버 정보를 기준으로 인증, 전송 및 보안 매개변수를 입력해야 합니다. 서로 다른 프로토콜의 필드를 그대로 옮겨 적지 마세요.
Shadowsocks
Shadowsocks는 지정된 암호화 방식과 비밀번호 등의 매개변수로 프록시 연결을 설정합니다. 서버 주소, 포트, 암호화 방식과 비밀번호가 서로 일치해야 합니다. 주소가 같아도 암호화 방식이나 비밀번호가 다르면 연결이 실패할 수 있습니다. 추가 전송 매개변수가 있는 설정은 해당 항목도 빠짐없이 입력해야 하며, 주소와 포트만 복사해서는 안 됩니다.
VMess
VMess는 사용자 식별 정보 등을 사용해 인증하며, 일반적인 설정에는 전송 방식, 경로와 TLS 설정도 포함됩니다. 사용자 식별 정보가 맞더라도 경로나 전송 유형이 다르면 연결에 영향을 줄 수 있습니다. 가져온 뒤에는 이름만 보고 서버 설정을 추측하지 말고 원래 정보와 필드를 대조하세요.
VLESS
VLESS는 사용자 식별 정보로 인증하며 프로토콜 자체는 트래픽을 암호화하지 않습니다. 실제 보안은 함께 설정하는 전송 방식과 보안 매개변수에 따라 달라집니다. 프로토콜, 전송 방식, 보안 설정을 한꺼번에 확인해야 하며, VLESS와 VMess는 이름만 바꾸면 호환되는 설정이 아닙니다.
Trojan
Trojan은 일반적으로 TLS와 함께 사용하고 비밀번호로 인증합니다. 설정의 서버 이름은 핸드셰이크와 인증서 검증에 사용될 수 있습니다. 연결 주소, 포트, 비밀번호뿐 아니라 서버 이름과 전송 매개변수도 확인하세요. 인증서 오류가 발생하면 먼저 설정, 인증서 유효기간, 기기 시간을 점검하고 검증을 바로 끄지 마세요.
Hysteria2
Hysteria2는 QUIC 기반이며 UDP 전송을 사용합니다. 인증 및 TLS 매개변수는 서버 측 설정과 일치해야 합니다. 현재 네트워크에서 UDP가 제한되면 다른 방식으로 웹페이지를 열 수 있더라도 이 연결은 실패할 수 있습니다. 문제를 점검할 때 네트워크 전송 조건과 서버 설정을 구분하고, 한 번의 시간 초과만으로 비밀번호 오류라고 단정하지 마세요.
WireGuard
WireGuard는 공개 키 인증으로 암호화 터널을 설정합니다. 로컬 개인 키, 피어 공개 키, 연결 엔드포인트와 주소 범위는 각각 역할이 다릅니다. 개인 키는 비밀로 관리해야 하며 피어 공개 키에 로컬 공개 키를 입력해서는 안 됩니다. 핸드셰이크 기록과 앱 접속 성공은 별개의 확인 항목이므로 주소, 라우팅과 DNS도 확인하세요.
규칙 키워드
규칙은 보통 위에서 아래 순서로 검사하고, 일치하는 규칙의 전략을 적용합니다. 아래의 example.com은 문법 설명을 위한 예시일 뿐이며, 예시 규칙을 모든 상황에 그대로 사용할 수 있는 것은 아닙니다.
PROXY · 프록시로 처리
DIRECT · 직접 연결
REJECT · 요청 거부
PROXY / DIRECT / REJECT
PROXY는 프록시로 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 규칙에 쓰이는 전략이며 프로토콜 이름은 아닙니다. 해당 전략은 규칙에 일치하는 요청에만 적용됩니다. 파란색, 초록색, 주황색 점은 보조 표시에 불과하므로 전략 텍스트와 실제 연결 기록을 기준으로 판단하세요.
DOMAIN / DOMAIN-SUFFIX
DOMAIN은 지정한 도메인과 일치하고 DOMAIN-SUFFIX는 해당 도메인과 하위 도메인에도 일치하므로 보통 후자의 적용 범위가 더 넓습니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인과 하위 도메인에 적용할 수 있습니다. 이런 규칙은 웹페이지 URL의 경로와 일치하지 않으므로 /login을 도메인 접미사로 입력하면 안 됩니다.
DOMAIN-KEYWORD
DOMAIN-KEYWORD는 도메인에 지정한 키워드가 포함되어 있는지 확인합니다. 예: DOMAIN-KEYWORD,example,PROXY. 키워드가 서로 관련 없는 여러 도메인에 포함될 수 있어 예상보다 넓은 범위에 적용될 수 있습니다. 한 도메인과 하위 도메인만 처리하려면 범위가 명확한 DOMAIN-SUFFIX를 우선 고려하세요.
IP-CIDR / IP-CIDR6
IP-CIDR과 IP-CIDR6은 각각 IPv4 및 IPv6 주소 대역을 기준으로 일치 여부를 판단합니다. 슬래시 뒤의 프리픽스 길이는 네트워크 범위를 나타냅니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 주소 대역을 지정하며 서버 포트 하나를 뜻하지 않습니다. IPv4 규칙만 있다고 해서 해당 IPv6 요청에도 같은 전략이 적용된다고 볼 수는 없습니다.
GEOIP
GEOIP는 IP 지리 데이터베이스에 기록된 지역 정보를 기준으로 일치 여부를 판단합니다. 예: GEOIP,CN,DIRECT. 지역 정보는 페이지 콘텐츠의 언어, 도메인 접미사 또는 사업자 소재지와 같지 않으며, DNS 결과와 데이터베이스 내용도 바뀔 수 있습니다. 특정 도메인을 정확하게 처리하려면 그보다 앞에 더 구체적인 도메인 규칙을 배치하는 것을 고려하세요.
FINAL
FINAL은 앞선 규칙이 하나도 일치하지 않을 때 적용하는 기본 항목입니다. 일반적인 형식은 FINAL,PROXY이며 보통 목록의 맨 아래에 둡니다. 앞선 규칙에 이미 일치한 요청을 다시 처리하지는 않습니다. 기본 전략이 맞는데도 접속 방향이 예상과 다르면 FINAL을 반복해서 바꾸기보다 앞선 규칙부터 확인하세요.
구독 및 설정 파일
서버 항목에는 연결 매개변수가 저장되고, 설정 파일에는 규칙과 설정이 포함되며, 구독은 서버 항목을 일괄로 가져오고 업데이트합니다. 먼저 가져온 항목의 종류를 구분해야 업데이트 후 어느 화면에서 변경 사항을 확인할지 알 수 있습니다.
Subscribe
Subscribe는 구독 주소로 서버 항목을 가져오고 업데이트하는 기능입니다. 구독은 서비스 제공업체에서 받으세요. 업데이트가 완료되면 목록 내용이 새로고침된 것이며 트래픽 분기 설정까지 업데이트된 것은 아닙니다. 업데이트 후 항목 수나 이름이 달라졌다면 먼저 그룹과 현재 선택 항목을 확인한 뒤 연결을 테스트하세요.
SERVER / Add Server
SERVER는 서버 관련 항목을 뜻하며 Add Server는 서버 추가 기능입니다. 완전한 연결 매개변수를 보유한 경우 사용할 수 있습니다. 직접 입력할 때는 먼저 프로토콜을 확인하고 주소, 포트, 인증 정보와 전송 설정을 차례로 대조하세요. 표시 이름은 항목을 구분하기 위한 것이며 이름을 바꿔도 실제 서버 주소는 달라지지 않습니다.
Scan QR Code
Scan QR Code는 QR 코드에서 가져올 수 있는 정보를 읽습니다. QR 코드는 정보가 담기는 수단일 뿐, 반드시 서버 설정 한 개만 포함하는 것은 아닙니다. 스캔 후 정보 유형, 프로토콜과 매개변수를 확인하고 저장하세요. QR 코드에 비밀번호나 구독 주소가 포함될 수 있으므로 화면을 공유할 때는 주변 텍스트뿐 아니라 QR 코드도 가려야 합니다.
공유 링크
공유 링크는 서버 연결 매개변수를 텍스트로 담은 형식입니다. 예를 들어 ss://, vmess:// 같은 프로토콜 식별자로 시작합니다. 여러 항목을 일괄 새로고침하는 구독 주소와는 용도가 다릅니다. 링크에 인증 정보가 포함될 수 있으므로 민감한 정보로 관리하세요. 가져올 때는 불필요한 공백이 포함되지 않았는지 확인하고 표시 이름을 연결 주소로 착각하지 않도록 주의하세요.
설정 파일
설정 파일에는 [General], [Rule] 등의 섹션이 포함될 수 있으며 일반 설정과 규칙을 저장합니다. 파일 이름만으로 규칙 내용을 판단할 수는 없습니다. 가져온 뒤 현재 활성 항목과 Global Routing 모드를 확인하세요. 편집하기 전에 사본을 보관하면 규칙이 잘못 일치할 때 이전에 사용할 수 있던 설정으로 돌아갈 수 있습니다.
iCloud 동기화
iCloud 동기화는 해당 시스템과 앱 설정에서 지원하는 범위 내에서 설정 데이터를 동기화하는 기능입니다. 동기화 대상과 스위치는 실제 화면을 기준으로 확인하세요. 별도 백업이나 스토어 구매 복원과는 다릅니다. 중요한 설정을 삭제하거나 변경하기 전에 별도로 저장하고, 동기화된 기기에 이전 사본이 남아 있다고 가정하지 마세요.
연결 및 진단
테스트 결과는 대상, 시간, 방법에 따라 달라집니다. 먼저 특정 요청을 재현한 뒤 네트워크, DNS 확인, 핸드셰이크와 규칙을 각각 점검하세요. 지연 시간 테스트 한 번으로 전체 사용 가능 여부를 판단하지 마세요.
Connectivity Test
Connectivity Test는 지정한 대상과 연결 과정을 확인하는 기능입니다. 결과는 테스트 주소, 방식과 현재 네트워크의 영향을 받습니다. 성공은 해당 테스트 조건에서 필요한 단계가 완료됐다는 뜻일 뿐, 모든 웹사이트나 앱에 접속할 수 있다는 의미는 아닙니다. 실패하면 테스트 대상과 오류 메시지를 기록한 뒤 실제 앱 요청과 대조하세요.
지연 시간
지연 시간은 특정 테스트 상호작용을 완료하는 데 걸리는 시간으로, 보통 밀리초 단위로 표시합니다. 다운로드 대역폭이나 지속적인 전송 안정성과는 다릅니다. 서버를 비교할 때는 같은 네트워크, 대상과 테스트 방식을 사용하세요. 시간 초과는 대상에 연결할 수 없거나 프로토콜이 제한된 경우에도 발생할 수 있으므로 서버가 영구적으로 작동하지 않는다고 단정하지 마세요.
DNS
DNS는 도메인을 IP 주소로 변환하며, 변환 결과와 캐시는 이후 연결 및 일부 규칙 판단에 영향을 줍니다. dns-server = system은 시스템 DNS 설정을 사용한다는 뜻입니다. 문제를 점검할 때는 도메인, 반환된 주소와 최종 전략을 함께 확인하세요. DNS 설정을 바꿨다고 모든 요청이 프록시로 처리된다고 단정할 수는 없습니다.
TLS / SNI
TLS는 전송 데이터를 암호화하고 신원을 확인합니다. SNI는 핸드셰이크 중 요청한 서버 이름을 전달하며, 이 이름은 연결 주소와 다를 수 있습니다. 인증서 또는 핸드셰이크 오류가 발생하면 서버 이름, 인증서 유효기간, 기기 시간과 원래 설정을 차례로 확인하세요. 검증을 끄는 것은 잘못된 설정 항목을 바로잡는 방법이 아닙니다.
TCP / UDP
TCP와 UDP는 자주 쓰이는 전송 계층 프로토콜입니다. 앱과 프록시 프로토콜에 따라 사용하는 전송 방식이 다를 수 있습니다. TCP 테스트 성공이 UDP 사용 가능을 의미하지 않으며, 웹페이지가 열린다고 모든 실시간 통신이 정상인 것도 아닙니다. 앱, 선택한 프로토콜과 현재 네트워크 조건을 함께 확인하세요.
연결 로그
연결 로그에서 요청 대상, 일치한 규칙, 처리 전략과 오류 메시지를 확인하면 가져오기, 규칙, 전송 중 어떤 문제인지 구분하는 데 도움이 됩니다. 점검할 때는 재현 시각을 먼저 기록한 뒤 대상 요청을 한 번 실행하세요. 기록을 공유하기 전 서버 인증 정보, 전체 구독 주소와 개인정보를 삭제하고 필요한 오류 문구만 남기세요.