공식 가이드 · 용어 색인
Shadowrocket 용어 가이드
인터페이스, 프로토콜, 설정 관련 용어를 확인하세요. 인터페이스의 Proxy는 라우팅 모드이고, 규칙 끝에 쓰이는 PROXY는 개별 규칙의 처리 정책입니다.
인터페이스와 스위치
먼저 서버 선택, 연결 상태, 라우팅 모드를 구분하세요. 각각 사용할 연결, 연결 활성화 여부, 프록시로 처리할 요청을 결정합니다.
- Home
- 서버 목록과 현재 선택 항목, 연결 스위치를 확인하는 화면입니다. 서버 옆의 선택 표시는 선택된 항목만 나타내며, 연결이 완료되었다는 뜻은 아닙니다. 웹페이지가 열리지 않으면 먼저 올바른 항목을 선택했는지 확인한 다음 스위치와 테스트 결과를 점검하세요.
- Global Routing
- 트래픽 처리 방식을 선택합니다.
Config(설정)는 현재 설정을 적용하고,Proxy(프록시)는 프록시 모드를,Direct(직접 연결)는 직접 연결 모드를 사용합니다. 규칙 적용 여부를 확인하려면 먼저Config모드인지 확인하세요. 모드를 바꿔도 기존 서버의 프로토콜은 변경되지 않습니다.
- Config
- 탐색 메뉴에서는 설정 파일을 관리하는 화면을 뜻하고,
Global Routing에서는 현재 설정에 따라 트래픽을 처리하는 모드를 뜻합니다. 규칙을 수정했는데 예상한 결과가 나타나지 않으면 선택된 파일과 현재 사용 중인 모드를 각각 확인하세요.
- On Demand
- 기기 네트워크가 바뀌는 경우처럼 설정한 조건을 충족할 때 연결을 시작합니다. 연결을 시도할 시점을 정할 뿐, 연결 후 특정 도메인이 프록시 또는 직접 연결 중 어느 쪽으로 처리될지는 결정하지 않습니다. 연결을 끈 뒤 자동으로 다시 켜진다면
On Demand상태와 실행 조건을 확인하세요.
- Add Server
- 서버 정보를 이미 알고 있을 때 직접 서버를 추가하는 메뉴입니다. 먼저 보유한 정보에 맞는 프로토콜을 선택한 다음 주소, 포트, 해당 프로토콜에서 요구하는 인증 매개변수를 확인하세요. 항목을 저장해도 입력만 완료된 상태이므로, 해당 항목을 선택하고 연결을 테스트해야 합니다.
프로토콜
프로토콜은 클라이언트와 서버가 통신하는 방식을 결정합니다. 기존 서버 정보에 따라 종류를 선택하세요. 주소와 포트가 같더라도 프로토콜이 다르면 서로 바꿔 사용할 수 없습니다.
- Shadowsocks
- 암호화된 트래픽 전달을 주 용도로 하는 프록시 프로토콜입니다. 직접 입력할 때 주소, 포트, 암호화 방식, 비밀번호가 모두 서버 측 설정과 일치해야 합니다. 주소와 포트만 확인해서는 암호화 방식이나 인증 정보의 오류를 찾을 수 없습니다.
- VMess
UUID로 사용자를 식별하는 프록시 프로토콜입니다.UUID는 연결에 사용할 사용자 신원을 식별하며, 서버 주소가 아닙니다. 자료에 전송 방식, 경로 또는 TLS 매개변수도 지정되어 있다면 해당 항목도 함께 확인하세요. 주소와 포트만으로 나머지를 추정해서는 안 됩니다.
- VLESS
- 프록시 프로토콜과 전송 보안을 별도로 처리하며, 연결 보호 여부는 실제로 설정한 보안 계층에 따라 달라집니다.
VMess와 마찬가지로UUID를 사용할 수 있지만, 필드가 비슷하다고 해서 두 프로토콜이 호환되는 것은 아닙니다. 기존 항목을 복사할 때 프로토콜 이름만 바꾸고 나머지 매개변수를 그대로 사용하지 마세요.
- Trojan
- TLS를 통해 사용하는 프록시 프로토콜이며, 일반적으로 비밀번호로 인증합니다. 서버 주소는 연결 대상의 위치를 지정하고, TLS 서버 이름은 인증서가 해당해야 하는 호스트를 식별하므로 두 값이 다를 수 있습니다. 인증서 이름이 일치하지 않는다면 먼저 보유한 정보와 관련 항목을 대조하세요.
- HTTP / SOCKS5
- 서로 다른 두 가지 프록시 인터페이스입니다. HTTP 프록시는
CONNECT로 터널을 만들 수 있고,SOCKS5는 별도의 연결 및 인증 협상 절차를 거칩니다. 사용자 이름과 비밀번호가 필요한지는 서버 설정에 따라 다릅니다. 인터페이스 이름만으로 프록시 서버까지의 연결이 암호화되는지 알 수는 없습니다.
- WireGuard
- UDP로 전송하는 암호화 터널 프로토콜이며, 키로 상대방을 식별합니다. 엔드포인트 주소와 포트뿐 아니라 터널 주소와 터널을 통과하도록 허용된 주소 대역도 연결에 영향을 줍니다. 공개 키와 개인 키의 용도는 다릅니다. 문제를 확인할 때 개인 키를 로그나 스크린샷에 노출하지 마세요.
- Hysteria2
- QUIC 기반 프록시 프로토콜로, 서버까지 UDP 경로가 연결되어야 합니다. 같은 설정이 한 네트워크에서는 작동하고 다른 네트워크에서는 시간 초과된다면 네트워크 환경도 점검 항목입니다. 한 번의 테스트만으로 모든 기기에서의 속도나 배터리 소모를 판단할 수는 없습니다.
규칙 키워드
규칙 키워드는 요청을 매칭하고, 정책은 매칭 결과를 처리합니다. 규칙을 확인할 때는 전체 도메인, 도메인 접미사, 대상 IP 중 무엇을 매칭하려는지 먼저 확인한 다음 규칙 순서를 점검하세요.
- DOMAIN
- 전체 도메인과 정확히 일치합니다. 조건으로
example.com을 지정하면www.example.com은 함께 매칭되지 않습니다. 특정 호스트 이름 하나만 처리하려면 정확히 매칭해 같은 사이트의 다른 하위 도메인에 영향을 주지 않도록 하세요.
- DOMAIN-SUFFIX
- 지정한 도메인과 하위 도메인을 매칭합니다. 예를 들어 하나의 조건으로
example.com과docs.example.com을 모두 포함할 수 있습니다. 도메인 계층을 기준으로 매칭하며, 문자열이 어디에든 포함되는 방식은 아닙니다. 규칙 조건에는 도메인을 입력하고 URL의 프로토콜 접두사나 경로는 넣지 마세요.
- GEOIP
- GeoIP 데이터베이스에서 대상 주소를 분류한 결과를 기준으로 매칭하며, 페이지에 쓰인 언어나 도메인 접미사를 기준으로 판단하지 않습니다. 하나의 서비스가 여러 주소로 해석될 수 있고, 주소가 달라지면 분류 결과도 바뀔 수 있습니다. 매칭 결과를 확인할 때는 해당 연결에서 사용한 대상 주소를 확인하세요.
- IP-CIDR / IP-CIDR6
- IPv4와 IPv6 주소 대역을 각각 기준으로 매칭하며, 슬래시 뒤의 숫자는 프리픽스 길이를 나타냅니다. IPv4 주소 대역만 지정하면 같은 서비스의 IPv6 주소까지 포함되지 않습니다. 규칙이 매칭되지 않는 이유를 확인할 때는 실제 연결에서 어떤 주소 유형을 사용했는지 먼저 확인하세요.
- FINAL
- 앞선 규칙에 매칭되지 않은 요청에 적용할 기본 정책을 지정하며, 일반적으로 규칙 구간의 마지막에 둡니다. 특정 요청이 기본 정책으로 처리된다면 앞선 조건이 실제 요청 대상을 포함하는지 확인하세요. 기본 정책을 변경하면 다른 미매칭 요청에도 영향을 줍니다.
구독과 설정
서버 항목은 연결에 사용하고, 설정 파일은 규칙 등의 설정을 저장합니다. 기존 구독을 가져오기, 설정 파일을 활성화하기, 기기 간 앱 데이터를 동기화하기는 서로 다른 작업입니다.
- Subscribe
- 사용자가 보유한 구독 링크로 서버 목록을 가져옵니다. 새로 고침하면 원본 내용의 변경에 따라 항목이 추가되거나 삭제될 수 있지만, 라우팅 규칙이 바뀌는 것은 아닙니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 문제 해결 정보를 공유하기 전에 가리세요.
- SERVER
- 서버 항목을 구성하거나 표시하는 인터페이스 레이블입니다. 항목 이름은 식별을 위한 텍스트일 뿐이며, 실제 연결은 주소, 포트, 프로토콜, 인증 정보 등의 매개변수에 따라 달라집니다. 이름이 같더라도 같은 서버를 사용한다고 단정하지 마세요.
- 설정 파일
- 규칙 등의 설정을 저장하는 파일입니다. 예를 들어
[Rule]섹션에서 요청의 매칭 조건과 처리 정책을 지정합니다. 파일을 가져왔다고 해서 선택된 것은 아니며,Global Routing이Config로 전환된 것도 아닙니다. 기존 파일을 수정하기 전에 원본을 보관해 두면 내용을 확인하고 복원하기 편리합니다.
- iCloud 동기화
- 계정 및 시스템 설정 조건을 충족하면 iCloud를 통해 기기 간 앱 데이터를 동기화합니다. 기기를 교체할 때 App Store에서 다시 사용할 수 있는 것은 앱 구매 내역이며, 설정 백업은 아닙니다. 동기화한 뒤 새 기기에서 설정과 서버 항목이 실제로 표시되는지 확인하세요.
정책과 진단
매칭된 정책은 요청을 어떤 방식으로 처리하는지 나타내고, 테스트 결과는 한 번의 확인을 완료했는지 보여 줍니다. 스위치가 켜져 있거나 지연 시간이 표시된다는 사실만으로 특정 웹사이트에 접속할 수 있다고 단정할 수 없습니다.
- PROXY
- 매칭된 요청을 프록시로 처리하는 규칙 정책입니다. 규칙이 매칭되었다고 해서 해당 서버를 사용할 수 있거나 대상 서비스가 응답했다는 뜻은 아닙니다. 문제를 확인할 때는 정책 매칭, 서버 연결 상태, 대상 서비스의 응답을 각각 점검하세요.
- DIRECT
- 매칭된 요청을 프록시 없이 기기의 현재 네트워크에서 직접 전송합니다.
Global Routing의Direct모드와 표기가 비슷하지만,DIRECT규칙 하나는 그 규칙에 매칭된 요청에만 적용됩니다. 직접 연결도 현재 네트워크와 도메인 해석 조건의 영향을 받습니다.
- REJECT
- 조건에 해당하는 요청을 거부하며, 해당 요청에 다른 정책을 대신 적용하지 않습니다. 웹사이트의 이미지, 로그인 또는 기타 기능이 거부된 도메인을 사용한다면 메인 페이지가 열리더라도 해당 기능은 작동하지 않을 수 있습니다. 문제를 확인할 때는 매칭 범위를 좁힌 다음 영향을 받은 기능을 다시 테스트하세요.
- DNS
- 도메인을 주소 등의 레코드로 변환하며, 변환 결과는 대상 IP에 의존하는 규칙에 영향을 줍니다. 해석에 성공했다는 것은 결과를 얻었다는 뜻일 뿐, 대상 서비스에 연결할 수 있다는 뜻은 아닙니다. 일부 도메인에서만 문제가 발생한다면 먼저 해석 오류가 있는지 확인한 다음 매칭된 규칙을 점검하세요.
- Connectivity Test
- 현재 네트워크 환경에서 지정한 테스트를 완료할 수 있는지 확인합니다. 한 번의 테스트에 성공해도 모든 웹사이트에 접속할 수 있거나 특정 규칙이 적용되었다고 볼 수는 없습니다. 결과를 비교할 때는 서버, 테스트 대상, 네트워크 환경을 최대한 동일하게 유지하세요.
- 지연 시간
- 한 번 측정한 소요 시간이며, 네트워크와 테스트 대상, 측정 방식의 영향을 받을 수 있습니다. 동일한 조건에서 비교하는 데 적합하지만, 지연 시간이 짧다고 대역폭이 넓거나 장시간 연결이 안정적이라는 뜻은 아닙니다. 시간 초과가 발생하면 먼저 테스트가 응답을 받았는지 확인한 다음 소요 시간을 비교하세요.