공식 매뉴얼 / 용어 참고

Shadowrocket 용어집

영어 원문을 유지하고 사용 위치에 따라 의미를 확인하세요. 먼저 인터페이스 모드, 프로토콜, 규칙 동작을 구분한 다음 기존 구독 또는 서버 정보의 매개변수를 살펴보세요.

용어 30개 인터페이스 용어와 규칙 키워드 범주별로 보기

Shadowrocket은 Apple 플랫폼용 유료 클로즈드 소스 앱으로, 주로 iPhone과 iPad에서 사용하며 App Store에서만 받을 수 있습니다. 구매 전에 정품 확인 안내에서 개발자 Shadow Launch Technology Limited, 공식 아이콘 및 앱 ID 932747118을 확인하세요. 시스템 요구 사항과 기기 호환성은 App Store 페이지에 표시된 내용을 기준으로 합니다.

이 표는 개념을 설명하며 구체적인 조작 절차를 대신하지 않습니다. 처음 가져오는 경우 입문 가이드를 참고하고, 설정값과 문제 해결 순서는 설정 매뉴얼에서 확인하세요. 아래 내용은 사용자가 자신의 구독 또는 서버 정보를 보유한 경우를 전제로 합니다.

01 / 인터페이스와 스위치

모드 이름과 주요 화면

Global Routing에는 Config, Proxy, Direct 세 가지 모드가 있습니다. 모드는 연결 처리 방식을 정하며 서버의 사용 가능 여부를 나타내지는 않습니다.

인터페이스와 스위치Home (홈): 서버 항목과 구독 그룹을 확인하고 연결 대상을 선택하는 주요 화면입니다. 목록에 항목이 표시되면 연결 정보가 저장된 것이며, 인증 성공이나 연결 성립을 의미하지는 않습니다. 문제를 확인할 때는 먼저 선택한 항목을 확인하고 연결 스위치와 실제 접속 결과를 살펴보세요.

인터페이스와 스위치Global Routing (전체 라우팅): 연결 처리 방식을 선택하는 항목으로 Config, Proxy, Direct가 있습니다. Config는 현재 구성의 규칙에 따라 분기하고, Proxy는 프록시 경로로, Direct는 직접 연결 경로로 처리합니다. 모드 전환과 서버 변경은 서로 다른 작업이므로 테스트 전에 두 설정의 현재 상태를 기록해 두세요.

인터페이스와 스위치Config (구성): 이 용어는 구성 관리 화면 또는 Global Routing의 구성 모드를 가리킬 수 있으므로 표시 위치를 확인해야 합니다. 구성 모드에서는 현재 활성화된 규칙에 따라 연결 경로가 결정됩니다. 서버 구독을 가져오는 것만으로 구성이 선택되거나 모든 연결이 프록시를 거치게 되는 것은 아닙니다.

인터페이스와 스위치Proxy (프록시): Global Routing의 옵션으로 선택하면 연결을 프록시 모드로 처리합니다. 문제 해결 시 Config 모드와 조건을 통제해 비교하는 데 사용할 수 있습니다. 잘못된 비밀번호, 사용할 수 없는 주소, 프로토콜 매개변수 불일치가 해결되는 것은 아닙니다. 인터페이스 용어 Proxy와 규칙 동작 PROXY는 대소문자와 적용 단계가 다릅니다.

인터페이스와 스위치Direct (직접 연결): Global Routing의 옵션으로 선택하면 연결이 선택한 프록시 서버를 거치지 않습니다. Direct 연결도 현재 네트워크, DNS 조회, 대상 서비스의 사용 가능 여부에 영향을 받으며 기기 네트워크를 끄는 기능은 아닙니다. Direct로 전환한 뒤 접속에 성공해도 직접 연결 경로가 사용 가능하다는 뜻일 뿐, 프록시 매개변수가 올바르다는 의미는 아닙니다.

인터페이스와 스위치Add Server (서버 추가): 보유한 서버 정보를 직접 입력하는 화면입니다. 입력 항목은 선택한 프로토콜에 따라 달라집니다. 먼저 올바른 프로토콜을 선택한 다음 주소, 포트, 인증 정보, 전송 관련 매개변수를 하나씩 확인하세요. 양식을 채우기 위해 알 수 없는 값을 입력하거나 구독 주소를 서버 호스트 주소로 사용하지 마세요.

02 / Settings 항목

DNS, On Demand, 진단

Settings 항목에서 연결 동작을 조정하거나 상태를 확인할 수 있습니다. 문제가 생기면 한 번에 한 항목만 변경하고 변경 전 값을 기록하세요. 여러 조건을 동시에 바꾸면 원인을 파악하기 어렵습니다.

Settings 항목DNS (도메인 이름 조회): 도메인 이름을 연결 가능한 IP 주소로 변환하며, 변환 결과가 주소 기반 규칙의 일치 여부에도 영향을 줄 수 있습니다. DNS 조회 경로와 실제 서비스 연결 경로를 같은 것으로 보아서는 안 됩니다. DNS를 변경해도 결과가 바로 달라지지 않는다면 설정을 계속 추가하기보다 캐시, 현재 구성, 시스템 네트워크 상태를 확인하세요.

Settings 항목On Demand (요청 시 연결): 설정된 조건에 따라 시스템 연결 동작을 실행해 반복적인 수동 조작을 줄입니다. 연결을 시도하는 시점을 정할 뿐 서버 선택, 프로토콜 매개변수, 분기 규칙을 대신하지 않습니다. 수동으로 연결을 끊는 동작을 테스트할 때는 On Demand 조건도 확인하세요. 조건에 따른 재연결을 스위치가 작동하지 않는 것으로 오해할 수 있습니다.

Settings 항목Ping (응답 시간 측정): 응답 시간을 측정하는 설정 또는 테스트입니다. 결과는 측정 방법과 대상, 당시 네트워크 상태에 따라 달라집니다. 응답 시간이 짧아도 다운로드 속도가 빠르다는 뜻은 아니며, 한 번의 시간 초과만으로 모든 연결이 실패한다고 볼 수는 없습니다. 결과를 비교할 때는 같은 방법을 사용하고 실제 접속 결과와 로그도 함께 확인하세요.

Settings 항목Log (로그): 연결 과정을 살펴보고 DNS 조회, 서버 연결, 인증, 규칙 일치 중 어느 단계에서 문제가 생겼는지 파악하는 데 사용합니다. 명확한 테스트 작업을 한 번 수행한 뒤 해당 기록을 찾아보세요. 마지막 한 줄만으로 원인을 단정해서는 안 됩니다. 로그에 접속 대상이나 서버 정보가 포함될 수 있으므로 공유하기 전에 민감한 내용을 삭제하세요.

Settings 항목iCloud Sync (iCloud 동기화): iCloud를 통해 지원되는 기기 간에 앱 데이터를 동기화합니다. 실제 동기화 범위는 앱 내 안내를 확인하세요. 기기 전체 백업이나 App Store 구매 기록 복원과는 다릅니다. 기기를 교체하기 전에 동기화가 완료됐는지 확인하고, 계속 사용할 구독 및 서버 정보는 별도로 안전하게 보관하세요.

03 / 프로토콜

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

프로토콜은 클라이언트와 서버가 통신을 설정하는 방식을 정의합니다. 프로토콜 이름만으로 성능을 비교할 수는 없습니다. 보유한 서버가 실제로 지원하는 프로토콜을 사용하고 전송 방식과 보안 매개변수를 일치시켜야 합니다.

프로토콜Shadowsocks: 프록시 프로토콜입니다. 연결하려면 서버 주소, 포트, 암호화 방식, 비밀번호 등의 정보가 일치해야 합니다. 암호화 방식은 프로토콜 매개변수이므로 이름이 비슷하다는 이유만으로 서로 바꿔 사용할 수 없습니다. 기존 항목에 추가 매개변수가 있다면 주소와 포트만 복사하지 말고 서버 안내와 대조하세요.

프로토콜VMess: 인증 및 암호화 기능을 갖춘 프록시 프로토콜로, 일반적으로 구체적인 전송 설정도 함께 필요합니다. 인증 정보와 전송 유형, 관련 항목을 서버 설정과 일치시켜야 합니다. 주소가 맞는 것만으로 연결이 성립하지는 않습니다. 문제를 확인할 때는 프로토콜 인증과 전송 계층을 나눠 살펴보고 기기의 날짜와 시간이 올바른지도 확인하세요.

프로토콜VLESS: 경량 프록시 프로토콜입니다. 프로토콜 인증과 연결 전송의 보안 설정은 각각 구분해 확인해야 합니다. 항목을 가져온 뒤에는 인증 정보와 서버가 요구하는 전송 및 보안 옵션을 모두 살펴보세요. VMess와 비슷한 형식의 식별자를 사용한다고 해서 두 프로토콜의 연결 유형을 서로 바꿀 수는 없습니다.

프로토콜Trojan: 일반적으로 TLS로 연결을 보호하고 비밀번호로 인증하는 프록시 프로토콜입니다. 주소, 포트, 비밀번호와 함께 서버 이름 및 인증서 검증 요구 사항도 확인하세요. 인증서 오류가 발생하면 이름, 기기 시간, 서버 설정부터 점검해야 합니다. 검증을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.

프로토콜Hysteria2: QUIC 기반 프록시 프로토콜로, 하위 통신에 해당 UDP 경로가 필요합니다. 서버 인증 매개변수가 올바르더라도 현재 네트워크에서 UDP 통신을 제한하면 연결되지 않을 수 있습니다. 프로토콜 이름만으로 속도가 보장되지는 않습니다. 대역폭 관련 항목은 실제 서버 안내에 따라 입력하세요.

프로토콜WireGuard: 공개 키와 개인 키로 인증하는 터널 프로토콜입니다. 엔드포인트, 키, 주소 및 라우팅 매개변수를 올바르게 설정해야 합니다. 공개 키와 개인 키는 용도가 다르므로 서로 바꿀 수 없으며, 개인 키는 민감한 인증 정보로 안전하게 보관하세요. 항목을 가져왔더라도 주소와 라우팅이 현재 환경에 적합한지 확인하고 실제 연결을 테스트해야 합니다.

프로토콜HTTP / SOCKS5: 서로 다른 두 프록시 프로토콜이며 이름만 다른 같은 유형이 아닙니다. 인증과 전송 기능은 실제 서버 설정에 따라 달라집니다. 포트 번호만으로 어떤 프로토콜을 선택해야 하는지 판단할 수 없습니다. 일반 HTTP 프록시와 SOCKS5는 그 자체로 암호화 터널이 아니므로 연결 경로의 보안 조건을 별도로 확인하세요.

04 / 규칙 키워드

일치 조건과 처리 동작

규칙은 일반적으로 일치 유형, 일치 값, 처리 동작으로 구성됩니다. 먼저 조건에 해당하는지 확인한 다음 동작이 연결을 어디로 보내는지 살펴보세요. 규칙 순서도 최종 결과에 영향을 줍니다.

규칙 키워드DOMAIN / DOMAIN-SUFFIX: DOMAIN은 지정한 전체 도메인과 일치하고 DOMAIN-SUFFIX는 도메인 접미사 및 하위 도메인과 일치합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인과 하위 도메인을 대상으로 합니다. 일치 값에는 경로를 포함한 전체 URL이 아니라 도메인을 입력해야 합니다. 두 규칙의 적용 범위는 서로 다릅니다.

규칙 키워드DOMAIN-KEYWORD: 도메인에 지정한 키워드가 포함되어 있는지 확인해 일치시킵니다. 일반적으로 전체 도메인이나 도메인 접미사보다 적용 범위가 넓습니다. 짧거나 흔한 문자열은 의도하지 않은 도메인에도 일치할 수 있습니다. 특정 대상에만 적용하려면 DOMAIN 또는 DOMAIN-SUFFIX로 범위를 명확히 지정할 수 있는지 먼저 확인하세요.

규칙 키워드GEOIP: IP 지리 위치 데이터베이스를 기준으로 주소를 일치시킵니다. 예: GEOIP,CN,DIRECT. 데이터베이스에 등록된 주소의 지리적 위치를 판단하며, 웹페이지의 언어, 콘텐츠 출처, 웹사이트 운영 주체의 소재지를 판단하는 것은 아닙니다. 데이터베이스 변경, 도메인 조회 결과, 캐시에 따라 실제 일치 결과가 달라질 수 있습니다.

규칙 키워드IP-CIDR / IP-CIDR6: 각각 IPv4 및 IPv6 주소 대역과 일치하며 슬래시 뒤의 접두사 길이가 범위를 결정합니다. 접두사 길이를 잘못 입력하면 적용 범위가 넓어져 관계없는 연결에도 같은 정책이 적용될 수 있습니다. IPv4 규칙만으로 IPv6까지 자동 처리되지는 않으므로 대상에서 사용하는 주소 유형을 함께 확인하세요.

규칙 키워드FINAL: 앞선 규칙에 일치하지 않은 연결을 처리하며, 일반적으로 규칙 목록 끝에 기본 규칙으로 둡니다. FINAL,PROXY는 남은 연결을 PROXY가 지정하는 처리 정책으로 보낸다는 뜻입니다. 서버 사용 가능 여부를 테스트하는 명령은 아닙니다. 앞선 규칙에 이미 일치한 연결에는 마지막 기본 규칙이 다시 적용되지 않습니다.

규칙 키워드PROXY / DIRECT / REJECT: 대문자로 표기된 이 키워드들은 도메인이나 프로토콜이 아니라 규칙 동작입니다. PROXY는 프록시 정책으로 전달, DIRECT는 직접 연결, REJECT는 연결 거부를 뜻합니다. PROXY가 실제로 사용할 대상은 현재 구성과 선택 항목을 함께 확인해야 합니다. 이 키워드와 Global Routing의 Proxy, Direct는 적용 단계가 다른 설정입니다.

05 / 구독 및 구성

데이터 출처, 가져오기, 구매 기록

서버 구독은 연결 항목을 갱신하고, 구성 파일은 처리 방식을 정리하며, App Store 기록은 앱 구매 정보를 보관합니다. 서로 별도로 저장하고 복원해야 합니다. 앱을 복원했다고 연결 정보도 복원된 것으로 오해하지 마세요.

구독 및 구성Server (서버 항목): 프로토콜, 호스트 주소, 포트, 인증 정보 등을 저장하는 연결 항목입니다. 목록의 별칭은 주로 항목을 구분하는 데 사용됩니다. 항목 이름이 같아도 매개변수가 다를 수 있고, 이름이 달라도 같은 서버를 가리킬 수 있습니다. 문제 해결이나 중복 항목 정리 시에는 별칭이나 그룹 이름만 보지 말고 실제 항목을 대조하세요.

구독 및 구성구성 파일: 규칙, DNS 및 기타 처리 옵션을 정리해 구성 모드에서 연결을 분기하는 방식을 결정합니다. 서버 구독은 주로 연결 대상을 갱신하고, 구성 파일은 주로 처리 방식을 정의하므로 서로 대체할 수 없습니다. 새 구성을 활성화하기 전에 되돌릴 수 있도록 사본을 보관하고, 구성에 지정된 정책이 실제 연결 대상과 맞는지 확인하세요.

구독 및 구성Scan QR Code (QR 코드 스캔): QR 코드에 담긴 연결 정보를 가져오는 화면입니다. QR 코드는 데이터를 전달하는 수단이지 별도의 프로토콜이 아닙니다. 출처가 분명하고 본인이 보유한 서비스의 정보인 경우에만 스캔한 뒤, 저장 전에 인식된 프로토콜과 필수 항목을 확인하세요. QR 코드에 민감한 인증 정보가 포함될 수 있으므로 일반 이미지처럼 공개하지 마세요.

구독 및 구성구입 항목: App Store에서 구매 계정에 연결된 앱 구매 기록으로, 조건에 따라 앱을 다시 받을 때 사용할 수 있습니다. 구매 기록을 복원해도 구독, 서버 항목, 로컬 구성까지 함께 복원되지는 않으므로 별도로 확인해야 합니다. iPhone과 iPad에서의 구매 적용 범위 및 다른 기기와의 호환성은 App Store 페이지에 표시된 내용을 기준으로 합니다.

가져오기와 첫 연결을 순서대로 진행하려면 입문 가이드를 참고하세요. 스토어 구매나 연결 안내에 문제가 있으면 자주 묻는 질문을 확인할 수 있습니다. 용어 설명은 항목을 식별하는 데 참고하고, 실제 입력란과 사용 가능한 옵션, 설정 위치는 앱 내 화면을 기준으로 확인하세요.

용어집 맨 위로 ↑