OFFICIAL MANUAL / GLOSSARY

Shadowrocket 용어집

인터페이스 위치와 매칭 대상을 기준으로 용어를 찾아 연결 설정과 규칙 정책을 구분하세요.

이 페이지는 Shadowrocket 공식 매뉴얼의 일부입니다. 영어 인터페이스 용어, 프로토콜 이름, 규칙 키워드는 원문 그대로 표기하며, 설명은 iPhone과 iPad에서 사용하는 상황을 중심으로 합니다. 용어를 찾은 뒤에는 먼저 해당 용어가 표시된 위치를 확인하고, 서버 매개변수와 라우팅 방식 중 무엇에 영향을 주는지 또는 개별 요청의 처리 결과를 뜻하는지 판단하세요.

  • 자주 쓰는 용어 30개
  • 5개 범주별 개념 찾아보기
  • 규칙 예시는 학습 목적으로만 제공됩니다

01 / INTERFACE

인터페이스와 스위치

같은 영어 단어도 표시 위치에 따라 의미가 다를 수 있습니다. 특히 Global Routing의 모드, 페이지 이름, 규칙에 쓰이는 대문자 정책을 구분해야 합니다.

인터페이스와 스위치

Home

서버 목록을 확인하고 서버를 선택한 뒤 연결 스위치를 조작하는 주요 화면입니다. 목록에 항목이 있다는 것은 정보가 가져와졌다는 뜻일 뿐, 원격 서비스가 사용 가능하거나 연결이 수립됐다는 뜻은 아닙니다. 처음 확인할 때는 선택된 항목, 연결 스위치, 시스템 연결 상태를 각각 살펴보세요. 세 상태를 하나로 묶어 판단하지 마세요.

인터페이스와 스위치

Global Routing

전체 트래픽 처리 방식을 결정하는 설정입니다. Config, Proxy, Direct는 각각 설정, 프록시, 직접 연결에 해당합니다. 특정 도메인이 규칙대로 처리되지 않는 이유를 확인할 때는 먼저 이 모드를 확인한 다음 규칙 내용을 살펴보세요. 모드를 전환해도 서버 비밀번호, 인증서 이름, 기타 연결 매개변수는 수정되지 않습니다.

인터페이스와 스위치

Config

Global Routing에서 현재 설정에 따라 트래픽을 처리하는 모드를 뜻합니다. 요청은 규칙에 따라 프록시를 이용하거나 직접 연결되거나 거부될 수 있으므로 모든 요청이 프록시를 통과한다는 뜻은 아닙니다. 페이지 이름으로 쓰이는 Config는 설정 파일 관리 화면을 가리킵니다. 튜토리얼을 읽을 때는 모드와 페이지 중 무엇을 뜻하는지 먼저 확인하세요. 파일을 가져오기만 하고 선택하지 않는 실수를 피할 수 있습니다.

인터페이스와 스위치

Proxy

Global Routing의 프록시 모드로, 현재 설정에 따라 개별 규칙을 적용하는 대신 트래픽을 프록시 방식으로 처리합니다. 대문자 PROXY는 규칙에서 사용하는 정책이므로 서로 다른 단계의 개념입니다. 글자가 비슷하다고 같은 스위치로 보면 안 됩니다. 테스트할 때는 현재 서버가 유효한지 확인하세요. 모드 전환만으로 인증 실패를 해결할 수는 없습니다.

인터페이스와 스위치

Direct

Global Routing의 직접 연결 모드로, 트래픽을 직접 연결 방식으로 처리합니다. 현재 Direct 모드라면 요청이 프록시를 거치지 않는 현상을 규칙 오류로 오해하지 마세요. 규칙 라우팅을 확인하려면 먼저 Config로 전환해야 합니다. 규칙 끝에 쓰이는 대문자 DIRECT는 해당 규칙이 일치한 뒤의 처리 방식만 나타내며 전체 모드가 바뀌었다는 뜻은 아닙니다.

인터페이스와 스위치

On Demand

설정한 조건에 따라 연결을 시작하는 기능으로, 연결 스위치를 수동으로 조작하는 것과는 다릅니다. 수동으로 중지했는데 다시 연결된다면 설정을 반복해서 삭제하기보다 여전히 충족되는 On Demand 조건이 있는지 확인하세요. 변경 전에는 기존 조건을 기록하고, 한 번에 한 항목씩만 바꾼 뒤 같은 네트워크 환경에서 동작을 살펴보세요.

02 / PROTOCOLS

프로토콜

프로토콜은 양측이 연결을 수립하고 데이터를 주고받는 방식을 정하며, 회선 품질을 나타내지는 않습니다. 보유한 서버 정보를 기준으로 유형을 선택하세요. 이름이나 테스트 수치만 보고 다른 프로토콜로 바꾸어 사용하면 안 됩니다.

프로토콜

Shadowsocks

프록시 프로토콜의 하나로, 클라이언트와 서버의 주소, 포트, 비밀번호, 암호화 방식이 서로 일치해야 합니다. ss://로 시작하는 텍스트는 보통 서버 항목 하나를 담은 공유 링크이며, 새로 고칠 수 있는 구독을 뜻하지는 않습니다. 가져온 뒤에는 메모 이름만 확인하지 말고 암호화 방식이 원래 정보와 일치하는지도 확인하세요.

프로토콜

VMess

인증을 사용하는 프록시 프로토콜입니다. UUID는 흔히 쓰이는 인증 정보지만 연결 설정 전체를 구성하지는 않습니다. 전송 방식, 경로, Host, TLS 등 관련 매개변수를 입력해야 하는지는 서버의 실제 설정에 따라 다릅니다. 가져온 뒤 연결되지 않으면 서버 주소만 바꾸지 말고 원본 정보를 항목별로 대조하고 기기의 시간도 정확한지 확인하세요.

프로토콜

VLESS

인증 정보, 전송 방식, 보안 매개변수가 함께 연결 설정을 구성하는 프록시 프로토콜입니다. UUID가 올바르더라도 나머지 필드가 완성됐다고 볼 수 없으며, 보안 옵션을 프로토콜 이름만으로 추측해서도 안 됩니다. 보유한 vless:// 공유 정보를 사용할 때는 가져온 뒤 관련 필드가 제대로 유지됐는지 확인하세요. 특히 서버가 요구하는 매개변수 조합을 임의로 변경하지 마세요.

프로토콜

Trojan

일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 비밀번호는 인증에 사용되며 TLS 설정은 보안 연결 수립에 영향을 줍니다. 서버 주소와 인증서 검증에 사용하는 이름은 서로 다른 역할을 할 수 있으므로 주소가 IP라는 이유만으로 이름을 지우지 마세요. 인증서 오류가 발생하면 검증을 바로 끄기보다 이름, 기기 시간, 원본 설정을 먼저 확인하세요.

프로토콜

Hysteria2

QUIC 기반 프록시 프로토콜로, 네트워크에서 UDP를 사용할 수 있어야 합니다. 주소, 포트, 인증 정보가 올바르더라도 현재 네트워크의 제한으로 시간 초과가 발생할 수 있으므로 설정 확인과 네트워크 확인을 나누어 진행하세요. 이름이 비슷한 프로토콜 세대가 서로 호환된다고 단정하지 말고, 보유한 서버에서 명시한 유형을 기준으로 선택하세요.

프로토콜

WireGuard

키 기반 터널 프로토콜로, 인터페이스 주소, 피어 정보, 라우팅 범위를 함께 설정해야 합니다. 일반적인 사용자 이름과 비밀번호 조합을 사용하지 않으므로 다른 프로토콜의 필드를 그대로 가져와서는 안 됩니다. 개인 키는 민감한 연결 정보입니다. 설정을 점검하거나 공유하기 전에 제거하고, 공개 스크린샷에도 키 전체가 나오지 않도록 하세요.

프로토콜

HTTP / SOCKS5

서로 다른 두 프록시 프로토콜로, 핸드셰이크 방식, 인증 형식, 지원하는 트래픽 유형이 다를 수 있습니다. 주소가 같더라도 HTTP 포트를 SOCKS5 포트로 사용할 수는 없습니다. UDP 지원 여부, 인증 필요 여부, 암호화 전송 사용 여부를 서버 정보에서 각각 확인하세요. 프로토콜 이름만 보고 판단하지 마세요.

03 / RULE KEYWORDS

규칙 키워드

먼저 매칭 대상을 확인한 다음 처리 정책을 살펴보세요. 아래 예시의 example.com은 설명용 도메인이며 실제 연결 서비스를 제공하지 않습니다. 규칙을 읽을 때는 현재 설정에서 해당 규칙이 놓인 위치도 확인해야 합니다.

규칙 키워드

DOMAIN

전체 도메인과 일치시키는 규칙 키워드입니다. 예를 들어 DOMAIN,example.com,PROXY는 이 도메인 전체를 대상으로 합니다. 접미사가 같다는 이유로 www.example.com까지 적용되지는 않으며 웹페이지 경로와도 일치하지 않습니다. 특정 호스트 이름 하나만 처리하려면 먼저 정확한 매칭을 고려해 다른 도메인에 미치는 영향을 줄이세요.

규칙 키워드

DOMAIN-SUFFIX

도메인 접미사와 그 하위 도메인을 기준으로 일치시킵니다. 예를 들어 example.com을 조건으로 지정하면 해당 도메인과 하위 도메인에 적용될 수 있습니다. 여기서 접미사는 도메인 계층을 기준으로 판단하며, 문자열 끝부분이 임의로 같다고 해서 일치하는 것은 아닙니다. 웹사이트 리소스가 다른 도메인에 분산돼 있다면 별도로 확인하세요. 접미사 규칙 하나가 관련 요청을 모두 처리한다고 가정하면 안 됩니다.

규칙 키워드

DOMAIN-KEYWORD

도메인에 지정한 문자열이 포함되어 있는지 확인하며, 일반적으로 전체 도메인이나 접미사 매칭보다 범위가 넓습니다. 같은 키워드가 포함된 관계없는 도메인도 일치할 수 있으므로 추가 전에 의도한 범위를 확인하세요. 검사 대상은 도메인이며 웹페이지 본문, 검색어, URL 경로가 아닙니다. 세밀하게 제어하려면 더 좁은 조건이 적합한지 먼저 살펴보세요.

규칙 키워드

GEOIP

운영 주체의 소재지, 페이지 콘텐츠가 아니라 IP 지리 위치 데이터베이스를 기준으로 일치시킵니다. 데이터베이스 기록은 실제 서비스 위치와 다를 수 있으며 CDN을 사용하는 웹사이트는 다른 주소로 확인될 수도 있습니다. 문제를 확인할 때는 해당 시점의 대상 IP와 규칙 순서를 함께 살펴보세요. 사이트 이름만 보고 어느 지역에 일치해야 한다고 판단하지 마세요.

규칙 키워드

IP-CIDR / IP-CIDR6

IPv4와 IPv6 주소 범위를 각각 일치시키며, 슬래시 뒤의 프리픽스 길이가 네트워크 범위를 결정합니다. 주소 규칙은 IP를 대상으로 하며 도메인 문자열을 대상으로 하지 않습니다. 도메인 확인 결과가 바뀌면 일치하는 주소 범위도 달라질 수 있습니다. 규칙을 작성하기 전에 주소 계열과 프리픽스 길이를 확인해 단일 주소를 대상으로 하려다 네트워크 전체를 포함하지 않도록 하세요.

규칙 키워드

FINAL

앞선 규칙이 하나도 일치하지 않을 때 적용되는 기본 키워드입니다. 예를 들어 FINAL,DIRECT는 나머지 요청을 직접 연결 방식으로 처리한다는 뜻입니다. 뒤에 있는 구체적인 규칙이 의도대로 작동하도록 FINAL은 규칙 목록 맨 마지막에 배치해야 합니다. 기본 정책을 변경하면 앞에서 처리되지 않은 모든 요청에 영향을 주므로 적용 범위를 확인한 뒤 저장하고 테스트하세요.

규칙 키워드

PROXY / DIRECT / REJECT

규칙에서 프록시, 직접 연결, 거부를 나타내는 정책 표시로, 보통 규칙의 처리 결과 부분에 위치합니다. 이 표시는 “일치한 뒤 어떻게 처리할지”를 나타내고 DOMAIN 같은 키워드는 “무엇을 매칭할지”를 나타냅니다. 정책 위치에 설정 파일에서 정의한 정책 그룹 이름이 올 수도 있으므로 그룹 이름과 실제 선택을 확인하세요. 규칙 조건만 확인해서는 부족합니다.

규칙 키워드

규칙 매칭 순서

규칙 목록은 보통 위에서 아래로 확인하며 처음 일치하는 항목을 적용합니다. 뒤에 있는 규칙이 앞의 일치 결과를 자동으로 덮어쓰지는 않습니다. 구체적인 예외 규칙은 이를 가로챌 수 있는 범위가 넓은 규칙보다 앞에 두고, FINAL은 맨 마지막에 둡니다. 규칙이 올바른 것처럼 보이는데 적용되지 않으면 중복 규칙을 추가하기 전에 위쪽에서 먼저 일치하는 규칙이 있는지 확인하세요.

04 / SUBSCRIPTION & CONFIG

구독 및 설정

서버 목록은 “어떤 원격 서비스에 연결할 수 있는지”를, 설정 파일은 “트래픽을 어떻게 처리할지”를 나타냅니다. 두 항목은 관련이 있지만 가져오기, 새로 고침, 선택해 사용하기는 서로 다른 작업입니다.

구독 및 설정

Subscribe

구독 관리와 관련된 인터페이스 용어입니다. 구독은 보통 주소를 통해 서버 항목을 가져오고 새로 고칩니다. 보유한 구독 주소를 사용하고 링크 유형에 맞게 가져오세요. 서버 목록과 설정 파일은 서로 다른 내용입니다. 구독 업데이트는 목록을 다시 가져오려는 시도일 뿐, 목록의 모든 서버에 연결할 수 있음을 보장하지 않습니다.

구독 및 설정

Add Server

서버 정보를 추가하는 화면입니다. 직접 입력할 때는 올바른 프로토콜을 먼저 선택한 다음 보유한 정보를 기준으로 주소, 포트, 인증 매개변수를 입력하세요. 프로토콜마다 필요한 필드가 다르므로 비어 있는 항목에 다른 프로토콜의 입력 방식을 임의로 적용하지 마세요. 저장 후 항목을 확인하고 연결을 테스트하세요. 자세한 순서는 사용법 안내를 참고하세요.

구독 및 설정

서버

클라이언트가 프록시 연결을 수립할 때 접속하는 원격 서비스이며, 화면의 목록 항목에는 보통 연결 매개변수가 저장됩니다. 메모 이름은 항목을 구분하기 위한 표시일 뿐, 지리적 위치, 사용 가능 여부, 인증 상태를 증명하지 않습니다. 연결에 실패하면 메모 내용만 보고 판단하지 말고 실제 주소, 포트, 프로토콜 매개변수를 대조하세요.

구독 및 설정

설정 파일

규칙, DNS 및 기타 동작 설정을 구성하는 파일로, 서버 목록만 설명하는 구독 내용과는 다릅니다. 설정 파일을 가져오는 것과 선택하는 것은 별개의 작업이며 파일이 존재한다고 해서 현재 사용 중인 것은 아닙니다. 변경 전에는 복원할 수 있도록 기존 설정을 보존하세요. 변경 후 현재 설정과 Global Routing을 확인해야 원하는 규칙이 처리에 적용되는지 판단할 수 있습니다.

05 / DNS & NETWORK

DNS와 네트워크

이름 확인, 연결 수립, 콘텐츠 로드는 서로 다른 단계입니다. 단일 테스트 결과는 실제로 검사한 과정만 보여줍니다. 문제를 확인할 때는 테스트 조건을 동일하게 유지하세요.

DNS와 네트워크

DNS

도메인 이름을 IP 주소로 변환하는 방식으로, 대부분 연결 수립 전에 필요한 단계입니다. 이름 확인에 성공해도 이후 연결까지 성공하는 것은 아니며 서버 지연 시간이 정상이라고 해서 대상 웹사이트의 DNS까지 정상이라는 뜻은 아닙니다. 문제를 확인할 때는 서버 도메인과 대상 웹사이트 도메인을 구분하고 어느 단계에서 실패했는지 기록한 뒤 관련 이름 확인 설정을 살펴보세요. 모든 옵션을 한꺼번에 바꾸지 마세요.

DNS와 네트워크

Connectivity Test

연결 상태를 확인하는 데 사용하는 테스트 화면이며 결과는 테스트 대상, 방식, 당시 네트워크 상태에 따라 달라집니다. 성공은 해당 테스트에서 확인한 경로에 접근할 수 있었다는 뜻일 뿐, 모든 웹사이트, 프로토콜, 리소스가 로드된다는 보장은 아닙니다. 테스트는 성공했는데 웹페이지가 열리지 않는다면 대상 도메인 확인, 규칙 매칭, 해당 요청의 오류를 계속 점검하세요.

DNS와 네트워크

지연 시간

테스트 요청을 보내고 응답을 받기까지 걸리는 시간으로, 보통 밀리초 단위로 표시합니다. 특정 테스트 조건에서의 응답 시간을 나타냅니다. 지연 시간은 대역폭이 아니며 웹페이지 로딩 속도와 같지도 않습니다. 테스트 방식이 다른 수치는 직접 비교하기 어렵습니다. 이상 여부를 판단할 때는 같은 네트워크와 테스트 대상을 사용해 반복 확인하고 실제 연결 결과도 함께 살펴보세요. 가장 낮은 숫자만 선택하지 마세요.

DNS와 네트워크

UDP

TCP와 같은 신뢰성 있는 순서 보장 전달 기능을 제공하지 않는 전송 계층 프로토콜입니다. 상위 계층 애플리케이션은 자체 프로토콜에 따라 패킷 손실과 재전송을 처리할 수 있습니다. 관련 서비스가 작동하려면 클라이언트 설정, 서버 기능, 네트워크 환경이 모두 지원해야 합니다. 일부 서비스만 작동하고 다른 서비스는 시간 초과된다면 서로 다른 전송 방식에 의존하는지 먼저 확인하세요. 웹페이지가 열린다는 이유만으로 네트워크 문제를 배제하지 마세요.

용어집 맨 위로 돌아가기 ↑