OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어 설명

인터페이스에 표시된 영어 원문으로 의미를 확인한 뒤 현재 설정을 살펴보세요. 연결 모드, 프로토콜 매개변수와 규칙 정책을 구분해 이름이 비슷한 옵션을 같은 설정으로 혼동하지 않도록 합니다.

용어 5개 범주
영어 원문 대조
각 항목은 앵커 링크로 바로 이동할 수 있습니다

01 / INTERFACE

인터페이스 및 스위치

먼저 현재 화면과 모드를 확인한 다음, 특정 스위치가 연결에 영향을 주는지 살펴보세요. 전체 절차는 시작하기에서 확인할 수 있습니다.

Home: 서버 항목과 현재 선택 항목, 연결 스위치를 확인하는 주요 화면입니다. 가져오기가 완료되었다는 것은 항목이 추가되었다는 뜻일 뿐, 해당 항목이 선택되었거나 연결이 설정되었다는 뜻은 아닙니다. 확인하기 전에 실제 선택 항목을 살펴보고 스위치 상태를 확인하세요. 화면에 그룹이 여러 개라면 테스트할 항목이 선택되어 있는지도 확인해야 합니다.

Global Routing: 요청을 전반적으로 어떤 방식으로 처리할지 정하는 전역 옵션입니다. Config, Proxy, Direct 세 가지 모드가 있습니다. 규칙이 적용되지 않는 것 같다면 규칙을 바로 수정하기보다 먼저 이 설정을 확인하세요. 모드를 바꾸면 문제를 진단하는 조건도 달라지므로 테스트 중에는 현재 선택된 모드를 기록해 두세요.

Config / Proxy / Direct: Global Routing에서 Config는 현재 설정의 규칙에 따라 처리하고, Proxy는 프록시 모드, Direct는 직접 연결 모드로 처리합니다. 여기서 Config는 모드이며 설정 파일 관리 화면 자체를 뜻하지 않습니다. Proxy와 Direct도 규칙에 사용하는 대문자 정책 키워드와 구분해야 합니다. 평소처럼 사용하기 전에 임시 테스트 모드로 남아 있지 않은지 확인하세요.

On Demand: 시스템 조건에 따라 VPN 연결을 시작하는 온디맨드 기능으로, 서버 속도 측정이나 자동 복구 기능은 아닙니다. 수동으로 연결을 끊었는데 다시 연결되면 적용 중인 온디맨드 조건이 있는지, 시스템의 VPN 설정 상태는 어떤지 먼저 확인하세요. 연결 문제를 테스트할 때는 조건을 기록한 뒤 잠시 비활성화해 결과를 비교할 수 있습니다.

Add Server: 기존 서버 정보를 직접 입력하는 메뉴입니다. 먼저 프로토콜 유형을 선택한 다음 해당 필드를 입력하세요. 주소, 포트, ID 또는 비밀번호, 전송 방식과 TLS 매개변수는 서버 정보와 하나씩 대조해야 하며 이름만 보고 추측해서는 안 됩니다. 저장한 뒤 Home으로 돌아가 항목이 선택되어 있는지 확인하고 실제 연결도 테스트하세요.

Connectivity Test: 현재 네트워크에서 대상 항목에 연결할 수 있는지 확인합니다. 결과는 테스트 대상, 네트워크 경로와 테스트 방식에 따라 달라집니다. 표시된 지연 시간은 파일 다운로드 속도가 아니며 모든 웹사이트에 접속할 수 있다는 보장도 아닙니다. 이상이 있으면 동일한 네트워크와 테스트 조건에서 다시 확인한 다음 실제 접속 상태와 로그를 함께 살펴보세요.

02 / PROTOCOLS

프로토콜

프로토콜 이름에 따라 매개변수를 해석하는 방식이 달라집니다. 가져온 뒤 사용자가 보유한 서버 정보와 대조하세요. 특정 프로토콜 이름이 속도나 안정성을 보장하는 것은 아닙니다.

Shadowsocks: 정해진 암호화 방식과 인증 매개변수로 프록시 트래픽을 전송하는 프로토콜입니다. 클라이언트와 서버의 설정이 일치해야 합니다. 주소, 포트, 비밀번호와 암호화 방식을 최소한 확인하고, 비밀번호만 맞는지 확인해서는 충분하지 않습니다. 서버 정보에 추가 전송 매개변수가 있다면 원래 값 그대로 입력해 누락되지 않도록 하세요.

VMess / VLESS: 서로 다른 두 프록시 프로토콜이므로 항목에 UUID가 모두 표시되더라도 프로토콜 유형을 바꿔 쓸 수 없습니다. 인증 정보, 전송 방식, Host, 경로와 TLS 설정을 함께 확인해야 하며, 필요한 필드는 서버 구성에 따라 달라집니다. VLESS라는 이름만으로 전송 암호화가 활성화되었다고 볼 수 없으므로 TLS 등의 설정을 별도로 확인하세요.

Trojan: TLS로 전송하고 비밀번호로 인증하는 프록시 프로토콜입니다. 인증과 인증서 검증은 별도로 확인해야 합니다. 연결에 실패하면 인증서 검증을 바로 끄기보다 비밀번호, 연결 주소, 포트와 SNI를 각각 확인하세요. 서버 이름을 잘못 입력했거나 기기 시간이 맞지 않아도 인증서가 일치하지 않을 수 있습니다.

Hysteria2: QUIC 기반 프록시 프로토콜로, 현재 네트워크의 UDP 연결 가능 여부와 올바른 인증 및 TLS 매개변수에 따라 연결됩니다. 특정 네트워크에서 계속 시간 초과가 발생한다면 다른 네트워크의 결과와 먼저 비교한 뒤 매개변수 오류인지 확인하세요. 프로토콜 유형이 같아도 서버마다 인증, 난독화 또는 대역폭 관련 설정을 공통으로 사용할 수 있는 것은 아닙니다.

WireGuard: 공개 키 체계로 암호화 터널을 만드는 프로토콜입니다. 로컬 개인 키, 피어의 공개 키, Endpoint, 주소와 라우팅 범위를 함께 확인해야 합니다. 서버 주소만으로는 완전한 설정을 구성하기 어려우며, 라우팅 범위가 잘못되면 일부 요청에만 연결 문제가 생길 수 있습니다. 개인 키는 민감 정보이므로 문제 해결 기록과 스크린샷에서 가리세요.

HTTP / SOCKS5: 서로 다른 두 프록시 프로토콜입니다. 주소, 포트와 선택 사항인 계정 인증 정보가 서버 설정과 일치해야 합니다. 프로토콜 이름만으로 TLS 암호화가 적용되었다고 볼 수 없으므로 실제 전송 설정을 확인하세요. SOCKS5에서 UDP를 사용할 수 있는지는 서버 기능과 클라이언트 설정에 따라 달라지므로 웹페이지 한 번 접속한 결과만으로 판단하지 마세요.

TLS / SNI: TLS는 암호화 연결을 설정하고 피어의 신원을 확인하며, SNI는 핸드셰이크 중 서버 이름을 지정합니다. 연결 주소는 IP일 수 있지만 인증서는 도메인 이름에 발급될 수 있습니다. 이 경우 주소를 그대로 복사하지 말고 서버 정보에 따라 이름을 입력하세요. 인증 오류가 발생하면 이름, 인증서 유효 기간과 시스템 시간을 먼저 확인한 뒤 서버 측 문제를 살펴보세요.

03 / RULE KEYWORDS

규칙 키워드

먼저 일치 조건을 읽고 마지막에 처리 정책을 확인하세요. 아래 문법은 규칙을 설명하기 위한 예시이며, 사용 중인 설정 파일 전체를 그대로 바꾸라는 뜻은 아닙니다.

Rule: 규칙은 도메인, 주소 또는 기타 요청 특성에 따라 처리 정책을 선택합니다. 일반적으로 위에서 아래 순서로 일치 여부를 확인하고, 일치하면 해당 규칙을 적용합니다. 앞쪽의 범위가 넓은 규칙이 뒤쪽의 구체적인 규칙에 영향을 줄 수 있으므로 순서와 조건 모두 중요합니다. 수정하기 전에 Global Routing이 Config인지 확인하고 현재 파일을 복사해 두세요.

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN은 전체 도메인과 일치하고, DOMAIN-SUFFIX는 도메인 자체 및 하위 도메인과 일치하며, DOMAIN-KEYWORD는 도메인에 포함된 키워드와 일치합니다. 세 키워드의 적용 범위는 서로 다릅니다. 키워드가 너무 짧으면 처리 대상이 아닌 도메인까지 영향을 받을 수 있습니다. 특정 호스트 하나만 처리할 때는 전체 도메인을 먼저 고려하고, 여러 하위 도메인을 포함해야 할 때 접미사 조건을 검토하세요.

IP-CIDR / IP-CIDR6: 각각 IPv4 및 IPv6 주소 대역을 일치시킵니다. 슬래시 뒤의 접두사 길이에 따라 적용 범위가 정해집니다. 접두사 길이가 짧을수록 일반적으로 더 넓은 주소 범위가 포함되며, 잘못 입력하면 관련 없는 요청에도 같은 정책이 적용될 수 있습니다. 도메인 조회 결과가 달라지면 주소 규칙의 일치 여부도 달라질 수 있으므로 실제 대상 IP를 확인하세요.

GEOIP: IP 지리 데이터베이스의 분류 결과를 기준으로 일치시키며, 사용자의 현재 위치를 기준으로 판단하지 않습니다. 데이터베이스 기록, 서비스 배포 위치와 도메인의 용도가 일치하지 않을 수 있으므로 분류 결과만으로 접속 동작을 단정하지 마세요. 특정 사이트에 예상과 다른 정책이 적용되면 대상 IP를 확인한 뒤 더 구체적인 도메인 규칙을 검토할 수 있습니다.

FINAL: 앞선 규칙이 모두 일치하지 않을 때 적용하는 기본 규칙으로, 보통 규칙 맨 아래에 둡니다. FINAL,PROXY는 일치하지 않은 요청을 PROXY로 보낸다는 뜻이지, 그보다 앞선 요청도 모두 프록시를 거친다는 뜻은 아닙니다. 많은 요청이 예상과 달리 FINAL에 적용된다면 위쪽 규칙이 실제 요청의 도메인이나 주소와 일치하는지 먼저 확인하세요.

PROXY / DIRECT / REJECT: 규칙 끝부분에 자주 쓰이는 처리 정책으로, 각각 프록시 정책 적용, 직접 연결, 연결 거부를 뜻합니다. PROXY의 실제 출구는 현재 선택된 서버와 설정을 함께 확인해야 합니다. DIRECT도 대상에 반드시 연결된다는 뜻은 아닙니다. 대문자 정책 키워드는 규칙 문법이며, Global Routing의 Proxy 및 Direct 인터페이스 옵션과 다릅니다.

URL Rewrite: 일치 조건에 따라 요청 URL을 처리하는 설정 기능으로, 서버 변경이나 DNS 수정, 일반적인 도메인 분기와는 다른 기능입니다. 효과는 요청을 확인할 수 있는지, 프로토콜 유형과 관련 설정에 따라 달라집니다. 규칙을 추가했다고 모든 HTTPS 요청이 처리되는 것은 아닙니다. 페이지 이동에 문제가 생기면 기존 규칙을 기록하고 한 번에 하나씩 비활성화해 결과를 비교하세요.

읽는 방법: 첫 번째 규칙은 도메인 접미사로 일치 여부를 확인하고 PROXY를 사용합니다. 두 번째 규칙은 그 밖의 요청에 적용하는 기본 정책입니다. example.com은 예시 도메인일 뿐, 서비스 접속 주소가 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

04 / CONFIGURATION

구독 및 설정

서버 항목과 규칙 파일을 구분하세요. 한쪽을 업데이트해도 다른 쪽까지 업데이트되는 것은 아닙니다. 구독과 QR 코드는 모두 사용자가 보유한 정보만 처리합니다.

SERVER: 서버 정보를 가리키는 인터페이스 용어입니다. 사용 가능한 항목은 일반적으로 프로토콜, 주소, 포트와 인증 정보로 구성됩니다. 표시 이름은 항목을 구분하기 위한 라벨일 뿐, 이름이 같다고 설정이나 실제 출구가 같다는 뜻은 아닙니다. 연결에 문제가 생기면 표시 이름만 바꾸지 말고 구체적인 필드를 확인하세요.

Config: 설정 파일 관리 화면에서 Config는 설정을 확인하고 가져오거나 선택하는 페이지를 뜻합니다. 파일에는 General, Rule 등이 포함될 수 있습니다. 파일을 가져온 뒤에는 목록에 파일 이름이 보인다는 사실만으로 적용되었다고 판단하지 말고 실제 사용 중인 파일을 확인하세요. Global Routing의 같은 이름을 가진 Config 모드와 관련은 있지만, 같은 메뉴는 아닙니다.

Scan QR Code: QR 코드에서 기존 서버 또는 설정 정보를 읽어오는 메뉴입니다. QR 코드는 데이터를 담는 수단일 뿐, 내용이 완전하거나 출처를 신뢰할 수 있다는 뜻은 아닙니다. 인식에 성공하면 저장하기 전에 프로토콜 유형, 주소와 인증 정보를 확인하고 내용이 예상한 것과 일치하는지 살펴보세요. 인증 정보가 포함된 QR 코드는 원본 링크와 마찬가지로 안전하게 보관하고 공개하지 마세요.

05 / SYSTEM & STORE

시스템 및 App Store

시스템 권한, 데이터 동기화와 구입 기록은 각각 별개입니다. 앱을 다시 다운로드해도 설정이나 서버 정보가 복원되는 것은 아닙니다.

DNS: 도메인 이름을 IP 주소로 변환하는 기능으로, 도메인 접속 과정의 한 단계입니다. 연결 테스트에 결과가 나오는데 웹페이지의 도메인에 접속할 수 없다면 DNS 설정과 실제 반환된 주소를 확인하고 현재 네트워크에서의 동작도 비교하세요. dns-server = system은 시스템 DNS 설정을 사용한다는 뜻이며, 모든 네트워크에서 같은 결과를 얻는다는 뜻은 아닙니다.

VPN 설정: Apple 시스템에서 Shadowrocket이 네트워크 터널을 만들도록 허용하는 설정 및 권한입니다. 처음 연결을 켤 때 시스템 확인 메시지가 표시될 수 있습니다. 권한이 승인되면 시스템에서 연결을 만들도록 허용된 것이지만, 서버 인증, DNS 또는 규칙이 올바르다는 뜻은 아닙니다. 스위치를 켤 수 없다면 먼저 시스템 VPN 설정을 확인한 다음 문제 해결 매뉴얼에서 다음 점검 단계를 확인하세요.

iCloud 동기화: 계정 및 앱 설정에서 허용하는 범위 내에서 관련 데이터를 동기화합니다. 동기화할 수 있는 항목은 현재 앱 내 안내를 확인하세요. iCloud 데이터와 App Store 앱 구입 기록은 서로 다른 항목이므로 구입 기록만으로 설정이 남아 있는지 판단할 수 없습니다. 기기를 바꾸기 전에 동기화 상태를 확인하고 필요한 데이터를 백업하세요. 복원 후에는 파일과 서버 항목을 다시 확인해야 합니다.

구입 항목: App Store에서 과거 구입 내역을 확인하고 앱을 다시 다운로드하는 메뉴입니다. 계정 화면의 정확한 명칭은 시스템 인터페이스에 따라 달라질 수 있습니다. Shadowrocket을 찾을 수 없다면 먼저 ‘미디어 및 구입 항목’에 원래 구입에 사용한 계정이 로그인되어 있는지 확인한 다음 App Store 국가 또는 지역과 구입 내역을 살펴보세요. 전체 확인 순서는 구입 항목 복원 안내를 참고하세요. 다시 다운로드한 뒤에도 설정 데이터가 있는지 확인해야 합니다.

일회성 구매: Shadowrocket 앱 클라이언트의 결제 방식입니다. 앱은 상용 비공개 소스 앱이며, 유일한 구입 경로는 App Store입니다. 클라이언트 일회성 구매와 회선 요금제는 별개이며, 실제로 연결하려면 사용자가 자신의 구독 또는 서버 정보를 보유하고 있어야 합니다. 가격, 일반 구입 및 가족 공유 적용 범위는 App Store 페이지를 확인하세요.

App Store 호환성: App Store 제품 페이지에서 지원 기기와 시스템 요구 사항을 확인하는 항목입니다. 구입 전에 펼쳐서 확인하세요. Shadowrocket은 주로 iPhone과 iPad에서 사용하며, Mac, Apple TV, Apple Vision도 같은 App Store 페이지의 호환성 항목에 표시됩니다. 시스템 요구 사항은 App Store 페이지를 확인하세요. 정품 여부를 확인할 때는 공식 아이콘, 개발자 Shadow Launch Technology Limited와 앱 ID 932747118도 함께 살펴보세요.

단계별 조작 방법이 필요하면 해당 작업의 안내를 확인하세요. 문제가 발생하면 먼저 현재 모드와 오류 문구 원문을 기록해 두세요.

가져오기 및 첫 연결 → 증상별 문제 해결 → App Store 정품 확인 →