Home
Home은 서버 목록을 확인하고 기본 서버를 선택해 연결을 제어하는 주요 화면입니다. 정보를 가져온 뒤 사용할 서버를 탭하고 선택 표시가 있는지 확인한 다음 연결 토글을 켜세요. 목록에 서버가 있어도 선택되었거나 연결된 상태라는 뜻은 아닙니다.
Shadowrocket 공식 설명서 · 용어 참고
Shadowrocket 용어 설명
화면 위치와 설정 용도에 따라 용어를 찾아보세요. 연결 모드, 서버 프로토콜, 규칙 정책을 먼저 구분한 뒤 해당 설정을 조정하면 됩니다. 같은 영어 단어도 표시되는 위치에 따라 기능이 다를 수 있습니다.
이 페이지는 용어를 설명하며, 조작 절차를 안내하지는 않습니다. 처음 사용한다면 튜토리얼을 확인하고, 앱은 다운로드 안내에서 받으세요.
화면 메뉴와 연결 모드
인터페이스 옵션은 첫 글자를 대문자로 표기하고, 규칙 정책 키워드는 모두 대문자로 표기합니다. 이름이 비슷하다고 해서 기능도 같다고 판단하지 마세요.
Config
화면 이름인 Config는 설정 파일을 관리하고 선택하는 메뉴입니다. Global Routing의 옵션인 Config는 설정 규칙에 따라 트래픽을 처리한다는 뜻입니다. 두 항목은 서로 관련되지만 같은 기능은 아닙니다. 설정 파일이 있어도 올바른 파일이 활성화되어 있고 해당 모드가 선택되었는지 확인해야 합니다. 규칙이 적용되지 않을 때는 두 곳을 모두 살펴보세요.
Global Routing
Global Routing은 전체 라우팅 모드를 결정하며 Config, Proxy, Direct 중에서 선택합니다. 도메인이나 IP에 따라 트래픽을 분기하려면 서버만 변경하지 말고 Config가 선택되어 있는지 확인하세요. 이 설정을 바꾸면 관리 대상 트래픽의 처리 방식이 달라지므로 테스트 후에는 원하는 모드로 되돌려야 합니다.
Proxy
Proxy는 Global Routing의 프록시 모드로, 관리 대상 트래픽을 프록시 경로로 보냅니다. 트래픽 분기 규칙이 문제인지 확인할 때 사용할 수 있습니다. 규칙 끝에 지정하는 PROXY와는 다릅니다. 전자는 전체 모드이고 후자는 개별 규칙의 처리 정책입니다. Proxy를 선택해도 잘못된 서버 매개변수나 연결할 수 없는 원격 서비스를 해결할 수는 없습니다.
Direct
Direct는 Global Routing의 직접 연결 모드로, 관리 대상 트래픽을 직접 연결 경로로 보냅니다. 로컬 네트워크에서 대상에 접속할 수 있는지 비교해 볼 때 유용하지만, 클라이언트 연결 토글이 꺼졌다는 뜻은 아닙니다. 설정 규칙에 따른 라우팅으로 돌아가려면 Config를 다시 선택하세요.
On Demand
On Demand는 설정한 네트워크 조건에 따라 연결을 시작합니다. 연결을 시도할 시점을 정하는 기능이지, 트래픽이 어떤 규칙에 매칭되는지를 정하지는 않습니다. 자동 연결이 필요하면 Settings에서 관련 조건과 현재 네트워크가 일치하는지 확인하세요. 수동으로 연결을 끊은 뒤 다시 연결된다면 설정을 삭제하기 전에 이 트리거 조건부터 확인하세요.
Connectivity Test
Connectivity Test는 연결 가능 여부를 확인하는 기능입니다. 기본 서버를 선택하고 연결을 켠 뒤 실행하는 것이 좋습니다. 테스트 성공은 해당 테스트 경로에서 요청이 처리되었다는 뜻일 뿐, 모든 웹사이트와 앱에서 같은 결과가 나온다는 보장은 아닙니다. 테스트에 실패하면 로컬 네트워크, 서버 매개변수, DNS, 현재 라우팅 모드를 함께 확인하세요.
서버 유형과 전송 조건
프로토콜 유형은 보유한 서버 정보와 일치해야 합니다. 프로토콜 이름만으로 전체 설정을 알 수 없으며 연결 속도도 판단할 수 없습니다.
Shadowsocks
Shadowsocks는 프록시 프로토콜입니다. 일반적으로 서버 주소, 포트, 암호화 방식, 비밀번호가 필요합니다. 클라이언트와 서버의 암호화 방식이 일치하는지 확인하고 주소와 비밀번호만 확인하는 데 그치지 마세요. 추가 전송 옵션이 제공되었다면 원본 정보를 기준으로 하나씩 확인해야 합니다.
VMess
VMess는 인증을 사용하는 프록시 프로토콜입니다. 사용자 식별 정보와 전송 설정이 모두 연결 성립 여부에 영향을 줍니다. 정보를 가져온 뒤 서버 주소, 포트, 사용자 식별 정보와 제공된 TLS, Host, 경로 등을 확인하세요. 연결 실패 원인을 프로토콜 이름만으로 판단할 수 없으며 시스템 시간이 맞는지도 살펴볼 필요가 있습니다.
VLESS
VLESS는 프록시 프로토콜이며 인증 정보와 전송 계층 설정을 각각 확인해야 합니다. VLESS를 선택했다고 해서 모든 암호화 및 인증서 옵션이 자동으로 설정되는 것은 아닙니다. TLS 등 보호 기능은 연결 방식에 따라 달라집니다. 보유한 서버 정보를 기준으로 입력하고 다른 프로토콜의 매개변수를 그대로 적용하지 마세요.
Trojan
Trojan은 일반적으로 TLS와 함께 사용하며, 올바른 서버 주소, 포트, 비밀번호가 필요합니다. 인증서 검증을 사용하는 경우 서버 이름 등 관련 설정이 서버 측 정보와 일치하는지도 확인하세요. 인증서 검증을 끄는 것을 일반적인 해결 방법으로 삼지 말고, 먼저 이름 오류, 시스템 시간, 인증서 설정을 확인해야 합니다.
Hysteria2
Hysteria2는 QUIC 기반 프록시 프로토콜이며, 연결에 적절한 UDP 네트워크 환경이 필요합니다. 주소와 인증 정보가 올바르더라도 로컬 네트워크에서 UDP를 제한하면 연결에 실패할 수 있습니다. 대역폭 관련 옵션은 실제 회선 성능에 맞게 설정하세요. 값을 높인다고 실제 속도가 향상되는 것은 아닙니다.
WireGuard
WireGuard는 키 기반 터널링 프로토콜입니다. 설정에는 일반적으로 키, 엔드포인트, 인터페이스 주소, 라우팅 범위가 포함됩니다. 라우팅 범위에 따라 터널로 들어가는 대상이 달라지므로 서버 주소만 입력해서는 설정이 끝나지 않습니다. 개인 키는 민감 정보입니다. 문제를 확인하거나 스크린샷을 공유하기 전에 제거하고 전체 설정을 공개하지 마세요.
HTTP
서버 유형으로 표시되는 HTTP는 HTTP 프록시를 뜻하며, 대상 웹사이트 URL이 HTTP로 시작하는지만 판단하는 항목이 아닙니다. 이러한 프록시는 CONNECT를 사용해 해당 터널 요청을 처리할 수 있으며, 지원 범위는 서버에 따라 다릅니다. 서버 인증이 필요하다면 올바른 사용자 이름과 비밀번호도 입력하세요.
SOCKS5
SOCKS5는 범용 프록시 프로토콜입니다. 서버에서 사용자 이름과 비밀번호를 요구하거나 다른 접근 제한을 적용할 수 있습니다. UDP 등 특정 트래픽의 처리 가능 여부는 서버 기능과 클라이언트 설정에 따라 달라지므로 이름만으로 판단할 수 없습니다. SOCKS5 자체가 전송 내용을 암호화하는 것은 아닙니다. 프록시 프로토콜과 앱 자체의 암호화 연결을 구분하세요.
매칭 조건과 처리 정책
먼저 규칙이 무엇을 매칭하는지 확인한 뒤 끝에 어떤 정책이 지정되었는지 살펴보세요. 예시의 example.com은 문법 설명을 위한 도메인이며, 서비스를 추천하는 의미가 아닙니다.
규칙
규칙은 도메인, IP 또는 기타 조건에 따라 처리 방식을 선택하는 설정 항목입니다. 일반적으로 위에서 아래로 확인하며, 조건에 맞는 규칙을 찾으면 해당 정책을 적용합니다. 구체적인 조건을 포괄적인 조건보다 앞에 두어 앞선 규칙에 가려지지 않도록 하세요. 규칙 기반 라우팅을 사용하려면 Global Routing에서 Config를 선택하고 원하는 설정 파일이 활성화되어 있는지 확인해야 합니다.
DOMAIN
DOMAIN은 지정한 도메인과 정확히 일치시키며 모든 하위 도메인을 자동으로 포함하지 않습니다. 예를 들어 example.com 규칙은 api.example.com에도 적용된다는 뜻이 아닙니다. 특정 호스트 이름을 제어할 때 사용할 수 있으며, 입력값은 경로가 포함된 전체 URL이 아니라 도메인이어야 합니다.
DOMAIN-SUFFIX
DOMAIN-SUFFIX는 지정한 도메인과 그 하위 도메인을 매칭하므로 같은 도메인의 여러 서비스를 하나의 정책으로 처리할 때 적합합니다. 예를 들어 example.com 규칙은 api.example.com에도 적용될 수 있지만, example이라는 문자열이 들어간 모든 도메인에 적용되는 것은 아닙니다. 특정 하위 도메인에 예외를 적용하려면 더 구체적인 규칙을 앞에 두세요.
DOMAIN-KEYWORD
DOMAIN-KEYWORD는 도메인에 지정한 키워드가 포함되어 있는지 확인해 매칭하며, 일반적으로 DOMAIN-SUFFIX보다 넓은 범위에 적용됩니다. 키워드가 너무 짧으면 무관한 도메인까지 영향을 받을 수 있으므로 추측만으로 여러 규칙을 추가하지 마세요. 잘못된 라우팅이 발생하면 먼저 포괄적인 키워드 규칙이 앞에 있는지 확인하세요.
GEOIP
GEOIP는 IP 데이터베이스의 지역 분류를 기준으로 매칭합니다. 도메인의 언어를 판단하는 기능도, 정확한 물리적 위치를 알려주는 기능도 아닙니다. 콘텐츠 전송 네트워크나 데이터베이스 변경으로 같은 도메인도 시점에 따라 다른 결과가 나올 수 있습니다. 확인할 때는 웹사이트 이름만 보지 말고 실제로 확인된 IP와 규칙 매칭 결과를 함께 살펴보세요.
IP-CIDR
IP-CIDR은 IPv4 주소 범위를 매칭합니다. 주소 뒤의 프리픽스 길이는 네트워크 범위를 나타냅니다. 예를 들어 192.168.0.0/16은 단일 기기 주소가 아니라 사설 주소 범위를 뜻합니다. 도메인 요청에서 DNS 조회가 필요한지는 설정 옵션에 따라 달라지므로 주소 범위 규칙으로 모든 도메인 판단을 대신할 수는 없습니다.
IP-CIDR6
IP-CIDR6은 IPv6 주소 범위를 매칭합니다. 프리픽스 표기 방식은 IPv4의 IP-CIDR과 대응하지만 주소 형식은 다릅니다. IPv4 규칙만 작성했다고 해서 같은 서비스의 IPv6 연결까지 처리되는 것은 아닙니다. 듀얼 스택 네트워크를 사용하는 기기라면 DNS 조회 결과와 두 주소 유형의 처리 정책을 각각 확인하세요.
FINAL
FINAL은 앞선 규칙에 하나도 매칭되지 않을 때 적용하는 기본 규칙으로, 대개 규칙 목록의 마지막에 둡니다. 명시적으로 지정하지 않은 대상을 어떻게 처리할지 결정하며 전체 규칙을 다시 한 번 실행하는 기능은 아닙니다. FINAL을 변경하면 분류되지 않은 요청에 광범위하게 영향을 줄 수 있으므로 기본 정책을 바꾸기 전에 누락된 규칙이 있는지 확인하세요.
PROXY / DIRECT / REJECT
PROXY는 프록시 경로, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 세 키워드는 매칭 후의 처리 방식을 지정합니다. 서버 프로토콜이 아니며 Global Routing의 인터페이스 옵션인 Proxy, Direct와 혼동해서는 안 됩니다. 이 설명서에서는 파란색, 초록색, 주황색 상태 점으로 세 정책을 구분하지만 실제 설정에는 영문 키워드를 사용해야 합니다.
가져오기 메뉴와 파일 용도
서버 항목은 연결 대상을 결정하고, 설정 파일은 트래픽 처리 방식을 결정합니다. 둘 중 하나를 가져왔다고 다른 하나까지 설정된 것은 아닙니다.
Subscribe
Subscribe는 이미 보유한 구독을 추가하거나 관리하는 메뉴로, 서버 항목을 가져오고 업데이트할 때 사용합니다. 서비스 제공자에게 받은 유효한 링크를 사용하고 업데이트한 뒤 항목이 정상적으로 표시되는지 확인하세요. 구독 업데이트가 모든 규칙과 DNS 설정까지 자동으로 바꾼다고 볼 수는 없습니다. 가져온 데이터의 실제 유형을 확인하세요.
Add Server
Add Server는 서버 정보를 추가하는 메뉴입니다. 먼저 보유한 정보에 맞는 유형을 선택한 다음 주소, 포트, 인증 매개변수를 입력하세요. 프로토콜마다 표시되는 입력란이 다를 수 있으며, 필요한 정보가 없다면 원본 정보를 제공한 곳에 확인해야 합니다. 저장한 뒤 Home으로 돌아가 서버를 선택하세요. 항목을 저장하는 것만으로 연결 확인이 끝나는 것은 아닙니다.
구독
구독은 클라이언트가 서버 목록을 읽고 업데이트할 수 있도록 제공하는 데이터 소스이지, 클라이언트 구매 증빙이 아닙니다. 구독 링크에는 개인 액세스 정보가 포함될 수 있으므로 공개하거나 도움 요청 스크린샷에 전체 링크를 올리지 마세요. 업데이트에 실패하면 모든 서버 매개변수를 반복해서 바꾸기보다 링크 유효성, 현재 네트워크, 응답 내용을 먼저 확인하세요.
설정 파일
설정 파일은 규칙, DNS 및 기타 연결 옵션을 구성하며 서버 목록만 업데이트하는 구독과 용도가 다릅니다. 파일을 가져온 뒤 사용할 파일이 활성화되어 있는지, Global Routing에서 Config가 선택되었는지 확인하세요. 파일을 교체하기 전에는 기존에 정상 작동하던 파일을 보관하는 편이 좋습니다. 그래야 문제를 확인할 때 서버, 규칙, DNS를 동시에 바꿔 비교 기준을 잃지 않습니다.
이름 확인, 응답 시간, 요청 처리
연결 가능 여부, 도메인 확인 여부, 페이지 열림 여부, 다운로드 속도는 각각 다른 결과이므로 따로 확인해야 합니다.
DNS
DNS는 도메인을 IP 주소로 변환하며 대부분의 네트워크 서비스에 접속할 때 필요한 과정입니다. DNS 조회 결과는 실제 대상 주소와 IP 기반 규칙 매칭에 영향을 줄 수 있습니다. 도메인으로는 열리지 않지만 알고 있는 주소로는 접속되는 경우 DNS 조회 경로를 먼저 확인하세요. 설정을 변경한 뒤에도 캐시 때문에 결과가 바로 바뀌지 않을 수 있습니다.
DNS over HTTPS
DNS over HTTPS는 DNS 쿼리를 HTTPS로 전송하는 방식이며, 흔히 DoH라고 합니다. 쿼리 전송 방식을 바꿀 뿐 모든 앱 트래픽을 자동으로 프록시 처리하지 않으며, 서버 문제를 단독으로 해결해 주지도 않습니다. 설정하기 전에 DNS 서비스 주소와 연결 가능 여부를 확인하고 기존 DNS 방식과 한 번에 하나씩 비교 테스트하세요.
지연 시간
지연 시간은 특정 테스트 방식과 대상에 대한 응답 시간이며 다운로드 속도와 같은 의미가 아닙니다. 테스트 수치가 낮아도 대용량 파일의 처리량이 더 높다는 보장은 없으며, 시간 초과가 발생했다면 테스트 대상에 접속 가능한지도 확인해야 합니다. 결과를 비교할 때는 로컬 네트워크, 테스트 방법, 대상을 최대한 동일하게 유지해 조건 변화와 서버 변화를 혼동하지 마세요.
URL Rewrite
URL Rewrite는 표현식에 따라 일치하는 URL을 처리하며, 연결에 사용할 경로를 고르는 규칙 기반 라우팅과는 다른 기능입니다. 규칙의 적용 여부는 매칭 범위와 요청이 처리 가능한 조건을 갖췄는지에 따라 달라지므로 도메인이 같다는 이유만으로 판단할 수 없습니다. HTTPS 콘텐츠 처리에는 인증서와 신뢰 설정도 영향을 줍니다. 용도를 모른다면 관련 항목을 한꺼번에 활성화하지 마세요.
문제별 추가 안내
가져온 항목으로 연결할 수 없다면 Home, Add Server, Connectivity Test 순서로 확인하세요. 특정 대상의 연결 경로가 잘못되었다면 Global Routing을 먼저 확인한 뒤 해당 규칙과 FINAL을 살펴보세요. 한 번에 관련 설정 하나만 변경하고 변경 전후의 증상을 기록하세요.
- 첫 연결 튜토리얼: 기존 정보를 가져오는 단계부터 연결 확인까지 순서대로 안내합니다.
- 자주 묻는 질문: 설치, 정보 가져오기, 트래픽 분기 문제에 따른 점검 방법을 찾아보세요.
- 정품 확인 안내: 개발자, 앱 ID, 구매 항목 복원 방법을 확인하세요.
- 전체 플랫폼 다운로드 안내: Mac의 두 칩 버전 다운로드 경로와 각 운영체제의 설치 방법을 확인하세요.
iPhone / iPad의 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. 화면 항목의 위치는 기기와 앱 업데이트에 따라 달라질 수 있으므로 용어를 찾을 때 해당 화면과 입력란의 맥락도 함께 살펴보세요.