[용어집]공식 매뉴얼 · 용어 참고

Shadowrocket 용어집

인터페이스 위치와 구성 용도에 따라 용어를 찾아보세요. 먼저 현재 항목이 스위치, 프로토콜, 규칙 키워드 중 무엇인지 확인한 다음 매개변수를 점검하세요. 같은 영어 단어도 표시 위치에 따라 의미가 달라질 수 있습니다.

인터페이스 용어는 영어 그대로 표기 규칙 키워드는 대소문자를 구분 예시 도메인은 실제 사용 가능한 서비스를 뜻하지 않음

[Interface]

인터페이스와 스위치

인터페이스 이름과 라우팅 모드를 구분하세요. Global Routing의 구성, 프록시, 직접 연결은 각각 Config, Proxy, Direct에 해당합니다. Config는 구성 파일을 관리하는 화면을 가리키기도 합니다.

Home
서버 항목을 확인하고 연결 대상을 선택하거나 연결을 제어하는 화면입니다. 목록에 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 인증이나 DNS 조회 또는 연결이 성공했다는 의미는 아닙니다. 처음 사용할 때는 선택한 항목을 확인하고 연결 스위치와 시스템에 표시되는 연결 상태를 점검하세요.
Global Routing
요청에 적용할 전체 라우팅 방식을 정하는 설정입니다. Config는 구성에 따라 요청을 처리하고, Proxy는 프록시 모드를, Direct는 직접 연결 모드를 사용합니다. 서버 프로토콜을 선택하는 기능은 아닙니다. 특정 규칙이 적용되지 않는 것 같다면 먼저 Config가 선택되어 있는지 확인한 다음 규칙 순서를 점검하세요.
Config
Global Routing 옵션으로 사용할 때는 현재 구성의 규칙과 설정에 따라 요청을 처리합니다. 인터페이스 이름으로 사용할 때는 구성 파일을 관리하고 선택하거나 편집하는 화면을 뜻합니다. 따라서 “Config를 가져옴”과 “Config로 라우팅 중”은 같은 의미가 아닙니다. 파일을 수정한 뒤에는 이름이 비슷한 다른 사본이 아니라 해당 파일이 현재 선택되어 있는지 확인하세요.
Proxy
Global Routing의 프록시 모드에서는 해당 요청을 현재 프록시를 통해 처리합니다. 시스템과 구성에 설정된 우회 범위도 고려해야 합니다. 서버 주소, 비밀번호, 전송 매개변수를 자동으로 채우거나 선택한 서버에 연결할 수 있다고 보장하지는 않습니다. 인터페이스의 Proxy와 규칙에 쓰인 대문자 PROXY는 각각 표시된 위치의 의미에 따라 해석해야 합니다.
Direct
Global Routing의 직접 연결 모드에서는 해당 요청이 현재 네트워크를 통해 대상에 직접 연결됩니다. 프록시 경로에서만 문제가 발생하는지 비교하는 데 도움이 될 수 있지만, 모드를 바꾼 뒤 대상에 접속된다고 해서 기존 서버 매개변수가 모두 올바르다는 뜻은 아닙니다. 직접 연결도 현재 네트워크와 DNS, 대상 서비스의 상태에 영향을 받습니다.
Add Server
서버 정보를 직접 추가하는 메뉴입니다. 사용 전에 사용자가 이미 보유한 서버 매개변수를 준비하세요. 올바른 프로토콜을 선택한 뒤 SERVER, 포트, 인증 및 전송 관련 항목을 입력합니다. 같은 이름의 항목이라도 프로토콜에 따라 서로 바꿔 쓸 수 없는 경우가 있습니다. 저장이 완료되어도 항목만 만들어진 것이므로 이후 연결 테스트가 필요합니다.
Connectivity Test
항목의 연결 가능 여부를 확인하는 테스트 기능입니다. 결과는 테스트 방식과 대상 주소, 현재 네트워크 상태에 따라 달라질 수 있습니다. 표시된 소요 시간은 실제 다운로드 속도와 같지 않으며 테스트를 통과해도 모든 웹사이트, UDP 요청, 장시간 연결이 정상 작동한다고 볼 수는 없습니다. 문제를 진단할 때는 테스트 방식을 기록하고 실제 접속 결과 및 Log를 함께 확인하세요.

[Settings]

Settings 항목

설정은 DNS 조회, 연결 트리거, 테스트, 기록 등의 동작을 바꿉니다. 여기서는 개념을 설명하며 모든 플랫폼의 메뉴 위치나 기본값이 같다고 가정하지 않습니다. 실제 값은 현재 인터페이스와 사용 중인 구성에 맞춰 확인하세요.

DNS
도메인 이름을 IP 주소로 변환하는 방식으로, 여러 연결을 시작하기 전에 필요한 과정입니다. DNS 조회 실패와 프록시 인증 실패는 서로 다른 문제이므로 프록시 비밀번호를 바꿔도 도메인 조회 오류가 해결되지는 않습니다. 점검할 때는 DNS 서버, DNS 요청이 거치는 경로, 조회된 주소가 예상과 일치하는지 각각 확인하세요. 비교 기준이 흐려지지 않도록 여러 설정을 한꺼번에 바꾸지 마세요.
On Demand
설정한 조건에 따라 연결을 시작하는 기능이며, “어떤 상황에서도 연결을 계속 유지”한다는 뜻은 아닙니다. 트리거 조건과 시스템 상태, 네트워크 변화가 실제 동작에 함께 영향을 줍니다. 직접 연결을 끈 뒤 다시 연결되는지도 현재 설정에 따라 확인해야 합니다. 설정을 변경한 뒤에는 관련 Wi-Fi, 셀룰러 네트워크, 네트워크 전환 상황에서 각각 테스트하고 스위치가 켜져 있는지만 보지 마세요.
Ping
설정이나 테스트 안내에서 연결 상태를 확인하는 항목을 가리키는 경우가 많으며, 정확한 의미는 현재 테스트 방식에 따라 달라집니다. 밀리초로 표시되는 결과를 모두 같은 ICMP 왕복 시간으로 간주하거나 대역폭으로 환산해서는 안 됩니다. 두 항목을 비교할 때는 테스트 방식과 대상, 네트워크 상태를 최대한 동일하게 맞추세요.
Log
연결 과정을 진단할 때 참고하는 기록으로, DNS 조회, 연결 수립, 인증, 프로토콜 협상 중 어느 단계에서 문제가 생겼는지 파악하는 데 도움이 됩니다. 먼저 문제를 한 번 재현한 다음 그 시점과 가까운 관련 기록을 확인해 오래된 오류를 현재 원인으로 오해하지 않도록 하세요. 기록을 공유하기 전에는 구독 주소, 인증 정보, 서버의 비공개 정보, 개인의 접속 행동을 식별할 수 있는 내용을 삭제하세요.
iCloud 동기화
지원되는 Apple 기기 간에 iCloud를 통해 앱이 지원하는 데이터를 동기화합니다. 동기화 범위는 현재 앱 설정에 따라 다릅니다. 실시간 연결 상태를 옮기는 기능이 아니며 복구 가능 여부를 확인한 별도 백업을 대신할 수도 없습니다. 기기를 바꾼 뒤에는 서버 항목, 구성 선택, 동기화 상태를 하나씩 확인하고 점검이 끝나기 전에 기존 기기의 데이터를 삭제하지 마세요.

[Protocol]

프로토콜

프로토콜 이름은 연결 방식을 식별하는 데 쓰이며 서비스 품질이나 기본 매개변수를 나타내지는 않습니다. 다음 설명은 사용자가 서버 정보를 이미 보유하고 있다는 전제입니다. 가져온 뒤에도 프로토콜, 인증, 보안 계층, 전송 방식이 서로 맞는지 확인해야 합니다.

Shadowsocks
프록시 프로토콜의 하나로, 일반적인 구성에는 서버 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 암호화 방식과 비밀번호는 모두 서버 설정과 일치해야 하며 이름만 바꿔도 프로토콜 동작이 달라지지는 않습니다. 기존 구성에 추가 전송 매개변수가 있다면 원본 정보를 기준으로 확인하세요. 주소와 포트만 복사했다고 구성이 완성되는 것은 아닙니다.
VMess
사용자 ID 등의 매개변수로 인증하는 프록시 프로토콜입니다. 일반적인 구성에는 전송 방식과 TLS 설정도 포함됩니다. 서버 주소, 사용자 ID, 전송 계층 매개변수는 각각 역할이 다르므로 서로 대신 사용할 수 없습니다. 연결에 실패하면 기기의 시간이 정확한지 확인한 뒤 원본 매개변수와 하나씩 대조하세요.
VLESS
사용자 ID, 전송 방식, 보안 계층 설정을 각각 확인해야 하는 프록시 프로토콜입니다. VLESS라는 이름만으로 TLS 사용 여부를 추정할 수 없으며 다른 전송 방식의 경로나 Host를 그대로 적용해서도 안 됩니다. 가져온 항목은 보이지만 연결되지 않는다면 원본 구성의 인증 및 전송 관련 항목부터 대조하세요.
Trojan
일반적으로 TLS로 전송을 보호하는 프록시 프로토콜입니다. 비밀번호, 서버 주소, 포트, SNI 등의 정보를 확인해야 합니다. SNI는 TLS 핸드셰이크에서 서버 이름을 전달하는 데 사용되며 연결 주소와 항상 같은 것은 아니므로 기존 서비스 매개변수에 맞춰 입력하세요. 인증서 오류가 발생하면 이름, 시스템 시간, 인증서 설정부터 확인하고 Allow Insecure를 일반적인 해결책으로 사용하지 마세요.
HTTP / SOCKS5
인증, 대상 연결, 전송 기능을 처리하는 방식이 서로 다른 두 프록시 프로토콜입니다. HTTP 프록시는 CONNECT를 사용해 터널을 만들 수 있지만, 프로토콜 이름만으로 클라이언트와 프록시 서버 사이의 통신이 암호화되었다고 볼 수는 없습니다. 추가할 때는 서버가 제공하는 프로토콜 종류를 확인하고 인증 방식과 별도의 TLS 설정이 필요한지도 점검하세요.
WireGuard
키 인증과 UDP 전송을 사용하는 터널 프로토콜이며, 구성에는 키, 엔드포인트, 주소, 라우팅 정보가 포함됩니다. 키 항목은 일반 사용자 이름이나 비밀번호처럼 취급해서는 안 되며, 개인 키를 공개 스크린샷이나 로그에 노출하지 마세요. 문제를 진단할 때는 엔드포인트 도메인뿐 아니라 UDP 연결 가능 여부, 키 쌍, 터널 내부 주소와 라우팅도 함께 확인해야 합니다.
Hysteria2
QUIC 기반 프록시 프로토콜입니다. 연결 수립과 데이터 전송에는 현재 네트워크에서 UDP를 사용할 수 있어야 합니다. 가져올 때는 서버 인증, 포트, TLS 등 관련 설정을 일치시켜야 하며 프로토콜 이름이 구체적인 매개변수를 대신하지는 않습니다. 한 네트워크에서는 실패하고 다른 네트워크에서는 정상이라면 네트워크 상태를 함께 살펴보세요. 원인을 판단하려고 비밀번호만 반복해서 바꾸지는 마세요.

[Rule]

규칙 키워드

규칙은 일반적으로 위에서 아래 순서로 검사하며, 먼저 일치한 규칙이 적용할 정책을 결정합니다. 규칙 한 줄을 읽을 때는 매칭 유형, 조건, 정책을 차례로 확인하세요. 도메인 규칙과 IP 규칙은 서로 다른 정보에 따라 매칭됩니다.

DOMAIN
지정한 도메인과 정확히 일치시키는 규칙 키워드입니다. 예: DOMAIN,example.com,DIRECT. 이 규칙은 www.example.com까지 자동으로 포함하지 않습니다. 이는 별도의 도메인입니다. 완전한 도메인 하나에만 정책을 적용하려면 범위가 명확한 이 매칭 방식을 먼저 고려하세요.
DOMAIN-SUFFIX
도메인 접미사 경계를 기준으로 지정된 도메인과 하위 도메인을 매칭합니다. 예: DOMAIN-SUFFIX,example.com,PROXY. example.com과 api.example.com을 포함할 수 있지만, 임의의 문자열이 포함된 도메인을 모두 매칭하지는 않습니다. 특정 하위 도메인에 예외를 적용하려면 범위가 넓은 이 규칙보다 구체적인 규칙을 먼저 배치하세요.
DOMAIN-KEYWORD
도메인에 지정한 문자열이 포함되어 있는지 확인해 매칭합니다. 예: DOMAIN-KEYWORD,example,PROXY. 정확한 도메인 및 접미사 규칙보다 범위가 넓어 직접 관련이 없는 도메인도 함께 매칭될 수 있습니다. 사용하기 전에 문자열 매칭이 필요한지, 특정 도메인과 하위 도메인 범위를 매칭해야 하는지 확인하세요.
IP-CIDR
IPv4 대역을 기준으로 대상 주소를 매칭합니다. CIDR에서 슬래시 뒤의 숫자는 네트워크 접두사 길이를 뜻합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 지정한 사설 주소 범위에 정책을 적용할 수 있습니다. 웹사이트 이름이 아니라 주소를 검사하므로 요청에 매칭 가능한 주소 정보가 있는지도 규칙 판정에 영향을 줍니다.
IP-CIDR6
IPv6 대역을 기준으로 대상 주소를 매칭하며, IPv6 주소에 해당하는 접두사 표기법을 사용합니다. IPv4의 IP-CIDR 항목이 IPv6까지 자동으로 포함하지 않으므로 같은 대상에 주소 계열을 달리해 연결하면 서로 다른 규칙이 적용될 수 있습니다. 같은 도메인이 때때로 다른 정책을 사용하는 것 같다면 DNS 조회 결과의 IPv4와 IPv6를 모두 확인하세요.
GEOIP
IP 지리 데이터베이스의 귀속 정보를 기준으로 대상 주소를 매칭합니다. 예: GEOIP,CN,DIRECT. 데이터베이스 기록은 사용자 위치, 콘텐츠에 쓰인 언어, 웹사이트 운영자의 위치를 뜻하지 않으며 실제 배포 변경 사항이 반영되기까지 시간이 걸릴 수 있습니다. 특정 도메인을 안정적으로 처리해야 한다면 GEOIP만으로 해당 도메인의 모든 연결 동작을 추정해서는 안 됩니다.
FINAL
앞선 규칙과 일치하지 않은 요청에 최종 정책을 지정하며, 일반적으로 규칙 목록 마지막에 둡니다. 예를 들어 FINAL,PROXY는 나머지 요청을 PROXY로 처리한다는 뜻이며 첫 번째 규칙부터 다시 검사하지 않습니다. 많은 요청이 FINAL에 도달한다면 앞선 규칙의 범위와 순서, 그리고 의도한 구성이 현재 사용 중인지 먼저 확인하세요.
PROXY / DIRECT / REJECT
규칙에서 흔히 사용하는 정책 식별자로, 각각 프록시 정책으로 처리, 직접 연결, 요청 거부를 뜻합니다. 규칙에 일치한 뒤 적용되는 처리 방식이지 Shadowsocks나 VLESS 같은 프로토콜이 아닙니다. PROXY가 실제로 사용할 대상은 현재 선택한 프록시와 구성에 따라 달라집니다. REJECT는 요청을 명시적으로 거부하므로 이로 인해 발생한 실패를 서버에 연결할 수 없는 상황으로 오해하지 마세요.

[Profile]

구독 및 구성

서버 항목은 연결 대상을 설명하고 구성 파일은 처리 규칙을 설명하므로 서로 혼동해서는 안 됩니다. 이 사이트는 사용자가 이미 보유한 구독이나 서버 정보를 관리하는 방법만 안내하며 노드나 구독을 제공·판매·추천하지 않습니다.

Subscribe
사용자가 보유한 구독 주소를 통해 서버 항목을 가져오고 업데이트하는 기능입니다. 주소는 이용 중인 서비스 제공업체에서 확인하세요. 링크에는 계정 식별 정보나 접근 권한을 부여하는 매개변수가 포함될 수 있으므로 민감 정보로 취급하고 공개적으로 붙여 넣지 마세요. 구독 업데이트는 일반적으로 해당 구독이 관리하는 항목을 새로 고치는 기능입니다. 규칙 구성 전체나 직접 편집한 내용까지 동기화되었다고 볼 수는 없습니다.
SERVER
서버 주소 입력란에는 보통 도메인 이름이나 IP 주소를 입력하며, 별도의 포트 및 인증 입력란과 함께 사용합니다. 이 항목에서 완전한 링크를 요구한다고 명시되어 있지 않다면 구독 주소나 웹 주소, 경로가 포함된 URL을 서버 도메인으로 입력하지 마세요. 서버 기록에는 일반적으로 프로토콜 등의 매개변수도 포함되므로 SERVER 값만으로는 연결할 수 없습니다.
구성 파일
[General], [Rule] 등의 설정과 규칙을 담아 요청 처리 방식을 지정하는 문서입니다. 파일을 가져와도 실제로 선택되었다거나 Global Routing이 Config로 설정되었다는 뜻은 아닙니다. 편집하기 전에 복원할 수 있는 사본을 보관하세요. 수정한 뒤에는 파일을 저장할 수 있는지만 확인하지 말고 특정 요청을 대상으로 규칙 적용 동작을 검증하세요.
URL Rewrite
조건에 따라 요청 URL을 다시 쓰거나 해당 처리를 수행하는 기능입니다. 요청이 어떤 연결 경로를 사용할지 결정하는 라우팅 규칙과는 별개의 계층입니다. DOMAIN-SUFFIX 규칙에 일치한다고 자동으로 적용되지는 않으며, HTTPS 콘텐츠를 처리할 수 있는지는 적용 조건과 인증서 신뢰 등의 요소에도 영향을 받습니다. 규칙의 출처와 적용 범위를 이해한 뒤에만 사용하고 일반적인 연결 문제를 해결하려고 무작정 재작성 항목을 추가하지 마세요.
구입 항목
App Store에서 계정 구입 내역을 확인하는 메뉴입니다. Shadowrocket 구입 내역과 재다운로드 가능 여부를 확인할 수 있습니다. iPhone/iPad 버전은 App Store에서 $2.99에 한 번 결제해 이용하며 두 기기에서 같은 구입 계정의 내역을 사용할 수 있습니다. Mac, Windows, Android, Linux 버전은 무료입니다. 다시 다운로드할 때는 스토어에 로그인한 계정이 원래 구입 계정과 같은지 확인하고, 이용 가능 여부는 스토어 페이지에 표시된 내용을 기준으로 하세요.

용어를 알아도 연결되지 않는다면 자주 묻는 질문에서 DNS 조회, 인증, 규칙 매칭 문제를 구분해 보세요. 특정 설정을 변경해야 한다면 Settings 설정 참고에서 항목별로 확인하세요.