Home
Home은 서버 목록을 확인하고 연결 기록을 선택하거나 연결 스위치를 조작하는 주요 화면입니다. 목록에 이름이 표시되더라도 클라이언트에 기록이 저장되었다는 뜻일 뿐, 주소와 인증 정보 또는 원격 서버 상태가 확인된 것은 아닙니다. 처음 연결한 뒤에는 실제 요청을 보내 결과를 확인하세요. 스위치 상태만으로 성공 여부를 판단하면 안 됩니다.
Shadowrocket 용어와 개념
먼저 인터페이스 메뉴, 연결 프로토콜, 규칙 정책을 구분한 뒤 세부 매개변수를 확인하세요. 아래 용어는 iPhone과 iPad에서의 사용을 기준으로 설명합니다. 영어 명칭은 앱과 설정 파일에 표시되는 그대로 유지했으며, 각 카드의 제목 링크에서 해당 항목을 찾을 수 있습니다.
용어 28개
주제 5개
읽는 순서 메뉴 → 매개변수 → 정책
01 / 인터페이스와 스위치
메뉴 이름과 연결 상태
화면, 모드, 스위치는 각각 다른 역할을 합니다. 서버를 가져온 상태, 스위치를 켠 상태, 요청이 성공한 상태는 각각 따로 확인해야 합니다.
Global Routing
Global Routing은 전체 접속에 적용할 처리 방식을 결정합니다. 설정 파일은 Config, 프록시는 Proxy, 직접 연결은 Direct에 해당합니다. Config는 현재 설정 파일의 규칙에 따라 트래픽을 분기하고, Proxy는 프록시 모드, Direct는 직접 연결 모드로 동작합니다. 규칙이 적용되지 않을 때는 먼저 Config가 선택되어 있는지 확인한 다음 해당 규칙을 살펴보세요.
Config
Config는 설정 파일을 관리하는 화면을 뜻할 수도 있고, Global Routing의 모드 중 하나를 뜻할 수도 있습니다. Config 화면에서 파일을 확인했다고 해서 해당 파일이 활성화된 것은 아니며, 전체 모드가 전환된 것도 아닙니다. 파일 내용, 선택 상태, Global Routing을 차례로 확인해 세 가지 작업을 혼동하지 않도록 하세요.
On Demand
On Demand는 설정한 네트워크 조건에 따라 VPN 연결을 시작합니다. 구체적인 동작은 설정된 조건과 시스템 상태에 따라 달라집니다. 구독 업데이트, 서버 필터링, 매개변수 수정 기능은 아닙니다. 먼저 수동으로 연결하고 접속을 확인한 뒤 자동 실행 조건을 설정하면 연결 매개변수와 실행 조건 중 어디에 문제가 있는지 파악하기 쉽습니다.
Add Server
Add Server에서는 서버 기록을 직접 추가합니다. 선택한 프로토콜에 따라 입력 항목이 달라집니다. 주소, 포트, 인증 정보, 전송 방식, TLS 설정을 보유한 서버 정보와 하나씩 대조하세요. 저장한 뒤 기록을 다시 열어 각 항목을 확인하고, 메모 이름을 서버 주소란에 입력하지 않도록 주의하세요.
02 / 프로토콜
인증, 전송, 보안 매개변수
프로토콜은 클라이언트와 서버가 통신하는 방식을 정하며, 어떤 대상에 프록시를 적용할지는 결정하지 않습니다. 아래에서는 기술 구성만 설명합니다. 구체적인 항목은 앱에서 선택할 수 있는 옵션과 보유한 서버 정보를 기준으로 확인하세요.
Shadowsocks
Shadowsocks는 서버 주소, 포트, 암호화 방식, 비밀번호 등의 매개변수로 프록시 연결을 설정합니다. 암호화 방식과 비밀번호는 서버 측 설정과 일치해야 합니다. 주소에 연결할 수 있다는 사실만으로 인증이 올바르다고 볼 수는 없습니다. 서버 정보에 플러그인이나 추가 매개변수가 있다면 앱에서 해당 옵션을 지원하는지 확인하세요. 이를 생략하고 같은 기능이라고 가정하면 안 됩니다.
VMess
VMess는 사용자 식별자와 관련 인증 매개변수를 확인해야 하는 프록시 프로토콜입니다. 사용자 식별자는 UUID 형식인 경우가 많습니다. 전송 방식, 경로, Host, TLS는 연결의 다른 계층에 해당하므로 프로토콜 이름만 확인해서는 부족합니다. 인증에 실패하면 전체 매개변수와 기기 시간을 함께 확인하고, 포트만 반복해서 바꾸지 마세요.
VLESS
VLESS는 사용자 식별자로 인증하며, 실제 연결에는 전송 방식과 보안 계층 설정이 추가로 필요할 수 있습니다. 프로토콜 이름만으로 암호화 보호 수준을 알 수는 없으므로 실제 TLS 설정 등을 함께 확인해야 합니다. 가져온 뒤 앱에서 인식한 항목을 확인하고 다른 프로토콜의 옵션을 그대로 적용하지 마세요.
Trojan
Trojan은 일반적으로 TLS와 함께 사용하며 비밀번호 등의 정보로 인증합니다. 서버 주소, 포트, 비밀번호, 인증서 검증에 사용되는 이름을 서버 측 정보와 대조해야 합니다. 주소와 인증서 이름은 서로 다를 수 있습니다. 인증서 오류가 발생하면 먼저 이름, 기기 시간, 서버 인증서 상태를 확인하세요. 검증을 끄는 것은 일반적인 해결 방법이 아닙니다.
Hysteria2
Hysteria2는 QUIC 기반 프록시 프로토콜이며, 하위 통신 계층에서 UDP를 사용합니다. 같은 주소의 다른 연결 방식이 작동하더라도 현재 네트워크에서 필요한 UDP 통신이 허용된다는 뜻은 아닙니다. 문제를 확인할 때는 먼저 프로토콜 유형, 인증, TLS 매개변수를 확인한 다음 로컬 네트워크와 원격 서버 간 UDP 경로를 점검하세요.
WireGuard
WireGuard는 키로 터널을 구성하며, 설정에는 일반적으로 인터페이스 주소, 피어 공개 키, Endpoint, 허용 주소 범위가 포함됩니다. 공개 키와 개인 키는 용도가 다르므로 서로 바꿔 쓸 수 없습니다. 개인 키가 포함된 설정 파일을 공개하지 마세요. 연결 후 접근 가능한 범위는 라우팅과 DNS 설정에도 영향을 받으므로 키 형식만 확인해서는 부족합니다.
HTTP
HTTP 프록시는 일반적으로 주소와 포트로 프록시 진입점을 지정하며, 사용자 이름과 비밀번호가 필요할 수도 있습니다. HTTPS 대상에 접속할 때는 보통 CONNECT로 터널을 설정하지만, 그렇다고 클라이언트와 프록시 진입점 사이에서 반드시 TLS를 사용한다는 뜻은 아닙니다. 입력할 때 프록시 진입점의 보안 설정과 대상 웹사이트의 프로토콜을 구분하세요.
SOCKS5
SOCKS5는 여러 유형의 연결 요청을 처리할 수 있는 프록시 프로토콜이며, 서버 설정에 따라 인증을 사용할 수 있습니다. UDP 포워딩 지원 여부는 클라이언트 설정, 서버 기능, 중간 네트워크에 따라 달라지므로 프로토콜 이름만으로 판단할 수 없습니다. SOCKS5 자체가 연결의 암호화를 보장하는 것도 아니므로 실제 네트워크 경로를 확인해야 합니다.
03 / 규칙 키워드
일치 조건과 처리 정책
일반적으로 규칙을 순서대로 확인해 일치 항목을 찾은 다음 해당 행에 지정된 정책을 적용합니다. 예시의 example.com은 문법 설명용입니다. PROXY, DIRECT, REJECT는 정책 키워드이며 서버 주소가 아닙니다.
DOMAIN
DOMAIN은 대상 도메인 전체와 일치시킵니다. 특정 호스트 이름 하나에만 적용할 때 적합합니다. 예를 들어 DOMAIN,example.com,DIRECT는 해당 도메인에 DIRECT를 적용하며 모든 하위 도메인까지 자동으로 포함하지는 않습니다. 조건에는 프로토콜, 포트, 경로가 포함된 전체 URL이 아니라 도메인을 입력하세요.
DOMAIN-SUFFIX
DOMAIN-SUFFIX는 도메인 접미사와 일치시킵니다. 루트 도메인과 하위 도메인에 같은 정책을 적용할 때 적합합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인에 적용됩니다. 일부 하위 도메인에 예외 정책을 적용하려면 더 구체적인 규칙을 이 넓은 범위의 규칙보다 앞에 배치하세요.
DOMAIN-KEYWORD
DOMAIN-KEYWORD는 대상 도메인에 지정한 문자열이 포함되어 있는지 확인합니다. 일반적으로 전체 도메인 일치보다 적용 범위가 넓습니다. 짧은 키워드는 관련 없는 여러 도메인에 동시에 일치할 수 있으므로 실제 일치 결과를 확인해야 합니다. 문자열 일치가 꼭 필요한 경우에만 사용하고, 고정 도메인을 알고 있다면 더 정확한 조건을 우선 고려하세요.
GEOIP
GEOIP는 기기의 위치나 웹페이지 언어가 아니라 주소 데이터베이스에 기록된 대상 IP의 지역을 기준으로 일치시킵니다. 데이터베이스 기록, DNS 조회 결과, 대상이 사용하는 분산 서비스가 일치 결과에 영향을 줄 수 있습니다. 예상과 다른 정책이 적용되면 실제 대상 IP를 먼저 확인한 뒤 데이터베이스와 규칙 순서를 점검하세요.
IP-CIDR 및 IP-CIDR6
IP-CIDR은 IPv4 주소 범위, IP-CIDR6은 IPv6 주소 범위에 사용합니다. 슬래시 뒤의 프리픽스 길이가 범위를 결정합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 해당 IPv4 네트워크에 DIRECT를 적용합니다. IPv4 조건만으로 IPv6까지 자동 처리되지는 않으므로 듀얼 스택 환경에서는 각각 확인해야 합니다.
FINAL
FINAL은 앞선 조건 중 어느 것도 일치하지 않을 때 적용하는 기본 규칙이며, 일반적으로 규칙 목록의 마지막에 둡니다. 예를 들어 FINAL,PROXY는 나머지 요청을 PROXY로 처리합니다. 앞선 요청까지 모두 프록시를 사용한다는 뜻은 아닙니다. 특정 대상의 경로를 확인하려면 먼저 가장 먼저 일치하는 구체적인 규칙을 찾고, 해당하지 않을 경우 FINAL이 적용되는지 확인하세요.
PROXY、DIRECT、REJECT
PROXY는 프록시 처리, DIRECT는 직접 연결, REJECT는 요청 거부를 뜻합니다. 규칙에서 설정 파일에 정의된 정책 그룹 이름을 참조할 수도 있습니다. 대문자 정책 키워드와 Global Routing의 Proxy, Direct는 서로 다른 맥락에서 사용됩니다. 전자는 개별 규칙의 결과로 지정할 수 있습니다. VPN이 연결된 상태에서도 일부 요청은 DIRECT로 처리될 수 있으므로 이를 근거로 스위치 상태를 판단하면 안 됩니다.
04 / 구독과 설정 파일
링크, 기록, 파일
구독은 콘텐츠를 가져오는 방법을, 서버 기록은 연결 방법을, 설정 파일은 요청을 처리하는 방법을 설명합니다. 링크가 열리더라도 반환되는 내용이 현재 가져오기 메뉴에 적합하다는 뜻은 아닙니다.
Subscribe
Subscribe는 구독 관련 메뉴를 뜻합니다. 서버 목록을 가져오는지 원격 설정 파일을 가져오는지는 현재 화면과 링크 내용을 함께 확인해야 합니다. 본인이 보유한 구독 정보를 사용하고, 자료에 설명된 콘텐츠 유형을 확인한 뒤 알맞은 메뉴를 선택하세요. 구독 URL에는 접속 정보가 포함될 수 있으므로 공개하거나 공개 스크린샷에 넣지 마세요.
서버 기록
서버 기록은 클라이언트에 저장된 연결 매개변수 모음이며, 직접 입력하거나 공유 링크, QR 코드, 구독을 통해 생성할 수 있습니다. 메모는 기록을 구분하는 데 사용합니다. 실제 연결에는 주소, 포트, 인증 정보가 사용되므로 메모를 수정해도 원격 서버 문제는 해결되지 않습니다. 여러 기록이 같은 주소를 가리킬 수도 있으니 이름만으로 중복 여부를 판단하지 말고 프로토콜과 포트도 확인하세요.
설정 파일
설정 파일에는 규칙, 정책 참조, 관련 네트워크 설정이 포함됩니다. 서버 목록만 포함하는 구독과는 용도가 다릅니다. 가져온 뒤 정책 이름이 존재하는지, 규칙이 완전한지, 해당 파일이 현재 선택되어 있는지 확인하세요. Config 모드인데도 예상대로 트래픽이 분기되지 않으면 모드, 파일 선택, 규칙 일치 여부를 각각 점검해야 합니다.
구독 업데이트
구독 업데이트는 기존 링크에 다시 요청을 보내 반환된 내용으로 기록을 동기화하는 기능이며, Shadowrocket 앱 자체를 업데이트하지는 않습니다. 업데이트 후 기록의 이름, 개수, 매개변수가 바뀔 수 있으므로 현재 선택이 예상한 서버를 가리키는지 확인하세요. 구독에서 생성된 내용을 직접 수정하기 전에 다음 업데이트에서 변경 사항이 덮어써지는지 확인하고 필요한 개인 백업을 보관하세요.
05 / DNS와 네트워크
이름 확인, 테스트, 요청 변경
한 번의 접속에는 여러 단계가 포함됩니다. 테스트에 응답이 있다고 해서 대상 웹사이트에 접속할 수 있다는 뜻은 아니며, 도메인이 조회되더라도 이후 연결이 성공한다는 보장은 없습니다.
DNS
DNS는 도메인을 IP 주소로 변환합니다. 변환 결과는 이후 연결에 사용되며 IP 기반 규칙의 일치 여부에도 영향을 줄 수 있습니다. 도메인 접속에 실패하면 조회 결과가 없는 경우, 적절하지 않은 결과가 반환된 경우, 올바른 결과를 얻었지만 연결에 실패한 경우를 구분해야 합니다. 점검할 때는 사용한 DNS 설정과 실제 결과를 기록하고, 규칙과 서버를 동시에 변경하지 말고 한 번에 변수 하나만 조정하세요.
지연 시간
지연 시간은 지정된 테스트 방식으로 측정한 왕복 또는 응답 시간입니다. 테스트 대상, 프로토콜, 로컬 네트워크, 일시적인 혼잡 상태에 따라 수치가 달라집니다. 사용 가능한 대역폭을 의미하지 않으며 웹페이지, 동영상 등 다른 요청의 성능을 단독으로 증명하지도 않습니다. 측정값을 비교할 때는 테스트 방식과 네트워크 환경을 최대한 동일하게 유지하고 실제 접속 결과도 함께 확인하세요.
Connectivity Test
Connectivity Test는 서버 연결 상태를 확인하는 기능입니다. 결과는 앱에서 선택한 테스트 방식과 대상에 따라 달라집니다. 특정 테스트가 실패해도 대상의 응답, 프로토콜 경로, 네트워크 제한 때문일 수 있으며 모든 접속이 실패한다는 뜻은 아닙니다. 테스트를 다시 실행한 뒤 같은 서버에 실제 요청을 보내 확인하고, 문제를 파악할 수 있도록 두 결과를 모두 기록하세요.
URL Rewrite
URL Rewrite는 조건에 따라 요청 URL을 변경하거나 리디렉션합니다. 요청의 경로를 결정하는 분할 라우팅 규칙과는 다릅니다. 일치 표현식과 대체 대상을 함께 확인해야 하며, 조건이 지나치게 넓으면 예상하지 못한 요청에도 영향을 줄 수 있습니다. HTTPS 콘텐츠는 암호화와 관련 설정의 제약도 받으므로 표현식 하나만 추가하면 모든 요청을 처리할 수 있다고 가정하지 마세요.
문제에 따라 다음 단계 선택
첫 연결을 아직 완료하지 않았다면 안내된 순서대로 사용 방법을 확인하세요. 이미 가져왔지만 기록이 완전하지 않다면 먼저 구독 유형과 각 입력 항목을 점검하세요. 용어는 각 구성 요소의 역할을 설명할 뿐이므로, 실제 진단은 현재 설정과 앱 내 결과를 함께 확인해야 합니다.