공식 매뉴얼 · 용어 색인

Shadowrocket 용어집

먼저 인터페이스 항목, 프로토콜 이름과 규칙 정책을 구분한 다음 세부 매개변수를 확인하세요. 이 페이지는 자주 쓰는 용어를 다섯 가지 항목으로 정리했습니다. 앱과 설정에 표시되는 영어 표기는 그대로 두고, 각 용어의 역할과 범위, 혼동하기 쉬운 부분을 한국어로 설명합니다.

이 페이지는 사용자가 자신의 구독 또는 서버 정보를 보유하고 있다는 전제로 앱 사용법만 설명합니다. 단계별 사용 방법은 사용 가이드에서, 설정 전체 맥락은 설정 매뉴얼에서 확인하세요.

01 · 인터페이스 및 스위치

화면 이름과 라우팅 모드

연결이 켜져 있는지, 트래픽을 어떻게 처리하는지, 어떤 서버를 선택했는지는 서로 다른 문제입니다.

인터페이스 및 스위치

Home

Home은 기존 서버, 현재 선택 항목과 연결 상태를 확인하는 주요 화면입니다. 서버 항목이 보인다는 것은 정보가 가져와졌다는 뜻일 뿐, 인증과 네트워크, 원격 서비스까지 정상적으로 확인되었다는 뜻은 아닙니다. 문제를 진단할 때는 먼저 선택된 항목과 연결 상태를 기록해 두세요. 확인 중에 설정을 바꾸면 결과를 판단하기 어려워질 수 있습니다.

인터페이스 및 스위치

Global Routing

Global Routing은 트래픽 처리 방식을 전체적으로 선택하는 설정으로, Config, Proxy, Direct가 있습니다. 연결 스위치와는 다르며 서버 매개변수를 채우는 기능도 아닙니다. 이 설정을 변경하면 기존 규칙이 적용되는 방식이 달라질 수 있으므로 규칙을 확인하기 전에 현재 모드를 먼저 살펴보세요.

인터페이스 및 스위치

Config / Proxy / Direct

세 가지 모드는 구성에 따른 처리, 프록시 연결, 직접 연결을 뜻합니다. Config는 현재 설정에 따라 트래픽을 처리하고, Proxy는 프록시 경로를 주된 처리 방식으로 사용하며, Direct는 직접 연결을 주된 처리 방식으로 사용합니다. 실제 시스템 트래픽과 예외는 설정 상태에 따라 확인해야 합니다. 여기서 첫 글자를 대문자로 표시한 인터페이스 항목은 규칙 끝에 쓰는 대문자 정책 키워드와 다릅니다.

인터페이스 및 스위치

On Demand

On Demand는 설정된 네트워크 조건에 따라 연결 동작을 실행하며, Wi-Fi나 셀룰러 네트워크 등의 조건에 맞춰 연결할 수 있습니다. 접속 실패를 감지해 서버를 자동으로 복구하는 기능은 아닙니다. 수동으로 연결을 끊은 뒤 다시 연결된다면 스위치만 반복해서 조작하지 말고, 트리거 조건과 시스템 상태를 확인하세요.

인터페이스 및 스위치

Add Server

Add Server는 사용자가 보유한 서버 정보를 입력하는 화면입니다. 프로토콜 유형, 주소, 포트와 인증 항목은 모두 같은 유효한 정보에서 가져와야 합니다. 일부 유형은 전송 방식과 TLS 매개변수도 필요합니다. 저장에 성공해도 항목이 생성되었다는 뜻일 뿐이므로, 이후 연결을 테스트하고 실제 접속으로 결과를 확인하세요.

인터페이스 및 스위치

Settings

Settings는 앱 설정을 확인하고 조정하는 화면이며, Config의 설정 파일과 혼동하면 안 됩니다. 문제를 진단할 때는 먼저 옵션의 기존 값을 기록한 다음 증상과 관련된 설정을 하나씩 바꾸세요. 여러 항목을 한꺼번에 변경하면 결과를 재현하기 어렵고 어떤 설정이 연결에 영향을 주었는지 확인하기도 힘듭니다.

02 · 프로토콜

프로토콜 이름과 매개변수 범위

프로토콜 유형은 사용자가 보유한 서버 정보와 일치해야 합니다. 이름만으로 속도, 안정성이나 적합한 네트워크를 판단할 수는 없습니다.

프로토콜

Shadowsocks

Shadowsocks는 프록시 프로토콜로, 일반적으로 서버 주소, 포트, 암호화 방식과 비밀번호를 설정합니다. 암호화 방식은 원격 서버 설정과 일치해야 합니다. 주소가 맞는다고 설정이 완성된 것은 아니므로, 가져온 뒤 연결되지 않으면 임의로 인증이나 암호화 항목을 바꾸지 말고 기존 정보를 하나씩 확인하세요.

프로토콜

VMess

VMess는 해당 프로토콜의 인증 정보를 사용하며 여러 전송 설정과 함께 구성할 수 있습니다. 인증 정보가 같더라도 전송 경로, Host 또는 TLS 조건까지 같은 것은 아니므로 관련 항목을 함께 확인해야 합니다. 기기 시간이 잘못되어 있으면 인증 판단에 영향을 줄 수 있으니 시스템 시간이 정확한지도 살펴보세요.

프로토콜

VLESS

VLESS는 인증 정보와 전송 설정을 함께 사용해야 하며, 프로토콜 이름만 바꾸면 되는 방식이 아닙니다. 이름만으로 연결에 어떤 암호화 보호가 적용되는지 알 수 없으므로 TLS 등 관련 조건을 확인해야 합니다. 기존 항목을 가져올 때는 원래 정보에 포함된 전송 매개변수와 서버 이름을 그대로 유지하세요.

프로토콜

Trojan

Trojan은 일반적으로 TLS와 함께 사용합니다. 서버 주소, 포트, 비밀번호와 검증에 사용할 서버 이름을 확인해야 합니다. 연결에 사용하는 주소와 인증서에 해당하는 이름은 서로 다른 역할을 할 수 있으므로 무조건 같은 값을 입력하면 안 됩니다. 인증서 오류가 발생하면 이름, 기기 시간과 인증서 조건부터 확인하세요.

프로토콜

Hysteria2

Hysteria2는 QUIC 기반 프록시 프로토콜이며 연결 상태는 UDP 사용 가능 여부에 영향을 받습니다. 서버 매개변수가 모두 맞아도 현재 네트워크에서 해당 전송을 제한하면 시간 초과가 발생할 수 있습니다. 프로토콜 이름만으로 실제 전송 속도를 보장할 수는 없으므로 네트워크 조건, 인증 설정과 실제 접속 결과를 함께 살펴보세요.

프로토콜

WireGuard

WireGuard는 키 쌍으로 상대를 인증하는 터널 프로토콜이며, 설정에 로컬 주소, 키와 상대편 정보가 필요합니다. 공개 키, 개인 키와 사전 공유 키는 용도가 서로 다르므로 바꿔 입력하면 안 됩니다. 문제 해결 정보를 공유할 때는 개인 키 등 민감한 내용을 숨기고, 주소 범위와 라우팅 설정이 기존 구성에 맞는지 확인하세요.

프로토콜

HTTP / SOCKS5

HTTP와 SOCKS5는 서로 다른 프록시 프로토콜이므로 주소와 포트가 같다는 이유로 바꿔 쓸 수 없습니다. 인증 필요 여부, 추가 암호화 보호 여부와 처리할 수 있는 트래픽 유형은 구체적인 설정을 확인해야 합니다. 이름만 보고 기능을 추측하지 말고 사용자가 보유한 서버 정보에 맞는 유형을 선택하세요.

03 · 규칙 키워드

매칭 조건과 처리 정책

키워드는 ‘무엇을 매칭할지’, 정책은 ‘어떻게 처리할지’를 나타냅니다. 규칙 순서에 따라 먼저 적용되는 항목이 달라집니다.

규칙 키워드

[Rule]

[Rule]은 설정 파일의 규칙 섹션입니다. 규칙은 위에서 아래 순서로 확인하며 조건에 일치하면 해당 정책을 적용합니다. 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 수정하기 전에 Global Routing이 Config로 설정되어 있는지 확인하고 현재 설정을 백업하세요.

규칙 키워드

DOMAIN / DOMAIN-SUFFIX

DOMAIN은 도메인 전체를 매칭하고, DOMAIN-SUFFIX는 지정한 도메인과 하위 도메인을 매칭합니다. 접미사는 웹페이지 경로나 임의의 문자열 검색을 뜻하지 않습니다. 특정 호스트 이름 하나만 처리하려면 먼저 정확한 도메인 매칭을 고려해 전체 도메인 범위가 함께 포함되지 않도록 하세요.

규칙 키워드

DOMAIN-KEYWORD

DOMAIN-KEYWORD는 도메인에 포함된 문자열을 기준으로 매칭하므로 예상보다 범위가 넓을 수 있습니다. 같은 문자열이 서로 관련 없는 여러 도메인에 들어갈 수 있어 도메인 접미사 매칭과는 다릅니다. 특히 거부 규칙에 사용할 때는 매칭 기록을 확인해 정상 요청까지 잘못 처리하지 않도록 주의하세요.

규칙 키워드

IP-CIDR / IP-CIDR6

IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 기준으로 매칭하며, 슬래시 뒤 숫자는 프리픽스 길이를 나타냅니다. 이 규칙은 도메인 문자열이 아니라 주소 범위를 확인합니다. 서비스가 여러 주소를 사용할 수 있으므로, 한 번의 DNS 조회 결과만으로 모든 요청이 해당 규칙에 일치한다고 판단하면 안 됩니다.

규칙 키워드

GEOIP

GEOIP는 IP 지리 위치 데이터베이스를 기준으로 매칭하며 기기나 사용자의 실제 위치를 나타내지 않습니다. 데이터베이스에 등록된 위치와 서비스 운영 위치도 다를 수 있으며, 분산 서비스는 여러 지역의 주소를 사용할 수 있습니다. 라우팅 결과를 판단할 때는 대상 주소, 데이터베이스 정보와 규칙 순서를 함께 확인하세요.

규칙 키워드

FINAL

FINAL은 앞선 규칙에 하나도 일치하지 않은 트래픽에 기본 정책을 지정하며, 보통 규칙 섹션의 마지막에 둡니다. ‘마지막으로 한 번 더 연결한다’거나 속도에 따라 경로를 자동 선택한다는 뜻은 아닙니다. 이 항목을 바꾸면 앞선 규칙이 처리하지 않은 모든 트래픽에 영향을 주므로 기본 처리 대상을 정한 뒤 수정하세요.

규칙 키워드

PROXY / DIRECT / REJECT

대문자로 표기하는 이 세 단어는 규칙의 처리 정책입니다. PROXY는 프록시 경로로 전달하고, DIRECT는 직접 연결하며, REJECT는 조건에 일치한 트래픽을 거부합니다. 서버 프로토콜 이름도 아니고 인증 매개변수를 제공하는 항목도 아닙니다. 특정 요청이 왜 해당 방식으로 처리되는지 알려면 정책과 규칙 조건을 함께 살펴보세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
04 · 구독 및 설정

항목, 파일과 구매 기록

서버 목록, 라우팅 설정과 App Store 구매 기록은 서로 다른 정보를 저장하므로 서로 대체할 수 없습니다.

구독 및 설정

구독

구독은 일반적으로 서버 항목을 가져오거나 업데이트하는 데 사용하는 주소이며, 사용자가 유효한 구독을 보유한 경우에 해당합니다. 전체 라우팅 규칙이 포함된 것은 아닐 수 있으며, 구독을 가져오는 것과 Config를 활성화하는 것은 별개의 작업입니다. 구독 주소에 접근 정보가 포함될 수 있으므로 공개 스크린샷, 로그나 문의 글에 그대로 노출하지 마세요.

구독 및 설정

서버

서버 항목에는 원격 주소, 프로토콜, 포트와 인증 정보 등이 저장되며, 목록의 항목을 노드라고 부르기도 합니다. 표시 이름은 항목을 식별하기 위한 이름일 뿐 실제 지역, 속도나 서비스 상태를 확인해 주지는 않습니다. 사용 가능 여부는 이름만 보지 말고 실제 매개변수, 연결 상태와 서비스 이용 조건을 확인하세요.

구독 및 설정

Config 설정 파일

설정 파일에는 일반 옵션과 규칙 등이 들어 있으며 서버 목록과는 별도로 관리합니다. 인터페이스의 Config 화면과 Global Routing의 Config 모드는 같은 단어를 사용하지만, 전자는 파일 관리와 관련되고 후자는 설정에 따라 트래픽을 처리한다는 뜻입니다. 파일을 가져온 다음에는 어떤 설정이 활성화되어 있는지 확인하세요.

구독 및 설정

[General]

[General]은 설정 파일의 일반 설정 섹션으로, DNS, 시스템 트래픽 처리와 프록시를 건너뛸 주소 등의 옵션을 포함할 수 있습니다. [Rule]과 용도가 다르므로 규칙 행을 이 섹션에 임의로 넣으면 안 됩니다. 일부 예시를 복사할 때는 해당 섹션, 필드 문법과 기존 설정에 미치는 영향을 함께 확인하세요.

구독 및 설정

Scan QR Code

Scan QR Code는 QR 코드에서 설정 내용을 읽어옵니다. QR 코드는 데이터 전달 수단일 뿐입니다. 스캔한 결과는 서버 정보 한 건일 수도 있고 추가 처리가 필요한 주소일 수도 있으므로 먼저 내용 유형을 확인하세요. 가져오기에 성공한 뒤에도 프로토콜과 매개변수를 확인해야 하며, 인증 정보가 포함된 QR 코드는 민감한 정보로 취급하세요.

구독 및 설정

구입 항목

구입 항목은 App Store에서 기존 구매 기록을 확인하는 화면입니다. 기기를 바꾸거나 앱을 다시 설치할 때는 먼저 구매했던 계정을 확인하세요. 구매 기록은 앱 설정 백업이 아니며, 앱을 다시 받더라도 서버와 규칙이 자동으로 복원되는 것은 아닙니다. iPhone과 iPad의 구매 적용 범위는 App Store 페이지의 안내를 따릅니다.

05 · 연결 및 진단

테스트 결과와 실제 접속

먼저 DNS 조회, 연결, 인증 또는 규칙 중 어느 단계에 문제가 있는지 확인하세요. 테스트 숫자 하나만으로 전체 접속 과정을 판단할 수는 없습니다.

연결 및 진단

DNS

DNS는 도메인을 주소로 변환하며 접속 과정의 한 단계입니다. DNS 조회에 성공해도 서버 인증이 성공한 것은 아니고, DNS 조회에 실패해도 프록시 서버가 오프라인이라는 뜻은 아닙니다. 일부 도메인에서만 문제가 생긴다면 DNS 설정, 반환된 주소, 캐시와 관련 규칙을 각각 확인하세요. 모든 서버 항목을 바로 변경하지 마세요.

연결 및 진단

Connectivity Test

Connectivity Test는 현재 테스트 방식으로 연결 상태를 확인합니다. 결과는 테스트 대상과 네트워크, 당시 서버 상태에 따라 달라집니다. 테스트에 성공해도 모든 웹사이트와 요청이 정상적으로 처리된다고 보장할 수 없으며, 실패한 경우에도 로그를 함께 확인해야 합니다. 여러 항목을 비교할 때는 테스트 방식과 네트워크 조건을 동일하게 유지하세요.

연결 및 진단

지연 시간

지연 시간은 특정 조건에서 테스트 요청에 응답이 돌아오기까지 걸리는 시간을 나타내며 전송 대역폭과는 다릅니다. 수치가 낮다고 해서 대용량 파일 전송이나 장시간 연결 성능이 더 좋다고 보장할 수는 없습니다. 패킷 손실, 네트워크 혼잡과 원격 서버 부하도 사용 경험에 영향을 줍니다. 기존 서버를 선택할 때는 한 번의 결과만으로 순위를 정하지 말고 여러 차례 테스트와 실제 접속을 함께 확인하세요.

연결 및 진단

Data

Data 화면에서는 트래픽 기록과 관련 정보를 확인할 수 있어 대상, 규칙과 연결 동작을 점검하는 데 도움이 됩니다. 통계 기준은 화면에 따라 다르므로 표시된 숫자를 서버 측 정산 트래픽으로 간주하면 안 됩니다. 문제를 찾을 때는 같은 작업의 기록을 비교하고, 정보를 공유하기 전에 대상 주소와 인증 정보 등 민감한 내용을 숨기세요.

연결 및 진단

TLS

TLS는 전송 연결을 보호하는 방식입니다. 서버 이름, 인증서 신뢰 조건과 기기 시간이 검증에 영향을 줍니다. 연결 주소에 응답이 온다고 해서 인증서 검증까지 통과한 것은 아닙니다. 오류가 발생하면 기존 설정의 이름과 인증서 조건을 확인하고, 일상적인 문제 해결에서 검증 건너뛰기를 기본 방법으로 사용하지 마세요.

연결 및 진단

VPN 구성 승인

VPN 구성 승인은 Apple 시스템에서 앱이 네트워크 터널을 만들 때 필요한 권한이며, 처음 연결할 때 시스템 확인 창이 표시될 수 있습니다. 승인을 마쳐도 해당 설정으로 기존 서버에 연결할 수 있다는 뜻은 아닙니다. 시스템에 연결 상태가 표시되더라도 DNS, 라우팅 정책과 실제 접속 결과를 추가로 확인하세요.

문제별 추가 안내

항목을 가져왔지만 사용할 수 없다면 ‘서버 매개변수 → VPN 구성 승인 → Global Routing → DNS → 개별 규칙’ 순서로 범위를 좁혀 확인하세요. 한 번에 조건 하나만 바꾸고 원래 설정으로 복원할 수 있게 보관해야 변경 사항과 테스트 결과를 정확히 연결할 수 있습니다.

  • 처음 가져오고 연결하기: 사용 가이드에서 추가, 선택, 연결 및 확인 절차를 순서대로 살펴보세요.
  • 규칙 순서와 유지 관리: 설정 매뉴얼에서 전체 설정을 바탕으로 개별 규칙을 확인하세요.
  • 구매, 구입 항목 복원 및 정식 앱 확인: App Store 정식 앱 확인 안내를 참고하세요.
  • 주제별 사용 방법과 문제 해결: 기술 노트를 참고한 뒤 관련 용어를 다시 확인하세요.

인터페이스에서 사용할 수 있는 필드는 기기와 앱의 실제 상태에 따라 다를 수 있으므로 현재 앱에 표시되는 내용을 기준으로 확인하세요. 이 페이지는 용어를 설명하며 기존 서비스의 매개변수 안내를 대신하지 않습니다. 시스템 요구 사항과 구매 범위는 App Store 페이지의 안내를 따릅니다.