Home
iPhone / iPad의 Home은 연결 상태와 SERVER 목록을 확인하는 주요 화면입니다. Not Connected는 현재 연결되지 않았다는 뜻입니다. 목록에 서버 정보가 표시되어도 저장된 상태일 뿐, 인증이나 접속이 성공했다는 의미는 아닙니다.
연결 상태를 확인할 때는 먼저 선택된 서버를 확인한 뒤 스위치와 상태 표시를 살펴보세요. 구독 업데이트 성공을 연결 성공으로 착각하지 마세요.
공식 매뉴얼 · 용어 설명
Shadowrocket 용어집
이름을 기준으로 화면 메뉴, 프로토콜, 규칙 정책을 확인하세요. 먼저 ‘언제 연결하는지’, ‘무엇을 매칭하는지’, ‘어떤 경로로 처리하는지’를 구분한 다음 관련 설정을 변경하세요. 메뉴 위치는 플랫폼에 따라 다를 수 있습니다.
화면 항목과 스위치
iPhone / iPad에서 자주 보이는 화면 용어로 메뉴를 찾을 수 있습니다. 연결 상태, 전체 라우팅 방식, 서버 선택은 각각 따로 확인하세요.
Global Routing
Global Routing은 전체 트래픽 처리 방식을 정합니다. 설정 사용, 프록시, 직접 연결은 각각 Config, Proxy, Direct에 해당합니다. Config는 현재 설정에 따라 트래픽을 분기하고, Proxy는 프록시 경로를, Direct는 직접 연결 경로를 사용합니다.
규칙이 예상대로 적용되지 않으면 먼저 Config가 선택되어 있는지 확인하세요. Proxy로 전환했다고 해서 특정 규칙이 매칭됐다는 뜻은 아닙니다.
On Demand
iPhone / iPad의 On Demand는 설정된 시스템 네트워크 조건에 따라 연결을 시작합니다. 구체적인 조건은 앱 내 옵션을 확인하세요. On Demand는 연결 시점을, Rule은 연결 후 트래픽 경로를 결정하므로 서로 다른 설정입니다.
수동으로 연결을 끊은 뒤 다시 연결할 때는 서버 정보를 반복해서 삭제하기보다 On Demand 조건이 여전히 충족되는지 확인하세요.
Connectivity Test
Connectivity Test는 지정된 테스트 방식으로 서버 연결 가능 여부나 응답을 확인하는 진단 메뉴입니다. 테스트 실패 원인은 현재 네트워크, 대상 주소, 서버 매개변수 등 다양하므로 규칙 문제라고 단정하지 마세요.
결과를 비교할 때는 같은 네트워크와 테스트 방식을 사용하세요. 테스트 값은 실제 웹페이지 접속이나 다운로드 대역폭을 대신하지 않습니다.
Settings
Settings는 앱 설정을 모아 둔 메뉴이며, 항목은 플랫폼과 실제 화면에 따라 다를 수 있습니다. 사용법에 설정 이름이 나온다고 해서 모든 기기에서 해당 설정을 변경해야 하는 것은 아닙니다.
문제를 확인하기 전에 기존 값을 기록하고, 증상과 직접 관련된 옵션을 한 번에 하나씩만 조정한 뒤 같은 대상을 다시 테스트하세요. 그래야 변경 효과를 판단할 수 있습니다.
Add Server
Add Server에서는 사용자가 이미 보유한 서버 정보를 직접 입력합니다. 먼저 프로토콜을 올바르게 선택한 뒤 주소, 포트, 인증 정보를 입력하세요. 주소만으로는 설정이 완성되지 않을 수 있으며 TLS와 전송 방식 등 추가 매개변수가 필요할 수도 있습니다.
보유한 서버 정보를 항목별로 확인하세요. 구독 링크 전체를 서버 주소 입력란에 붙여 넣지 마세요.
프록시 프로토콜
모든 플랫폼에서 사용자가 보유한 서버의 프로토콜과 매개변수에 맞춰 설정해야 합니다. 프로토콜 이름은 통신 방식을 나타낼 뿐 속도 순위를 뜻하지 않으며, 서버 설정을 대신하지도 않습니다.
Shadowsocks
Shadowsocks는 암호화 프록시 프로토콜입니다. 일반적인 설정 항목은 서버 주소, 포트, 암호화 방식, 비밀번호입니다. 암호화 방식은 프로토콜 매개변수이므로 이름이 비슷하다는 이유로 임의 변경하지 마세요.
연결되지 않으면 먼저 암호화 방식과 비밀번호가 서버 설정과 정확히 일치하는지 확인하세요. 자료에 추가 옵션이 포함되어 있다면 함께 입력해야 합니다.
VMess
VMess는 사용자 ID 등의 정보로 인증하는 프록시 프로토콜입니다. 서버 주소와 포트 외에 전송 방식, 경로, TLS 매개변수가 필요할 수 있습니다. 사용자 ID가 같더라도 전송 설정을 임의로 공통 적용할 수 있는 것은 아닙니다.
가져온 뒤에는 프로토콜 종류와 전체 항목을 확인하세요. 특히 경로와 서버 이름이 누락되지 않았는지 살펴보세요.
VLESS
VLESS는 프록시 프로토콜의 하나입니다. 프로토콜 이름만으로 전송 암호화 여부를 알 수 없으므로 TLS 등의 설정을 함께 확인해야 합니다. 사용자 ID, 전송 유형, 관련 보안 매개변수도 서버 설정과 일치해야 합니다.
다른 서버 정보의 프로토콜 이름만 VLESS로 바꾸지 마세요. 보유한 자료를 기준으로 전체 정보를 새로 입력하거나 다시 가져와야 합니다.
Trojan
Trojan은 일반적으로 TLS와 함께 사용합니다. 연결하려면 비밀번호 인증에 더해 서버 이름과 인증서 검증 조건도 충족해야 합니다. 인증서 오류와 비밀번호 오류는 서로 다른 문제이므로 해결 방법도 다릅니다.
인증 관련 안내가 표시되면 기기 시간, 서버 이름, 서버 인증서를 먼저 확인하세요. 검증을 끄는 것은 일반적인 해결 방법이 아닙니다.
Hysteria2
Hysteria2는 QUIC 기반 프록시 프로토콜입니다. UDP 통신이 가능해야 연결할 수 있으며 인증과 TLS 매개변수도 정확해야 합니다. 일반 웹페이지가 열리는 네트워크라고 해서 UDP 경로도 사용할 수 있는 것은 아닙니다.
문제를 확인할 때는 다른 네트워크에서의 결과를 비교한 뒤 서버 포트와 매개변수를 점검하세요. 한 번의 시간 초과만으로 프로토콜이 지원되지 않는다고 판단하지 마세요.
WireGuard
WireGuard는 키 인증 기반 터널 프로토콜입니다. 일반적으로 개인 키, 피어 공개 키, 엔드포인트, 터널 주소, 라우팅 범위를 설정해야 합니다. 일반 비밀번호 인증과 키 구조가 다르므로 항목을 서로 바꿔 사용할 수 없습니다.
진단 정보를 공유할 때는 개인 키를 반드시 숨기세요. 핸드셰이크에 성공해도 DNS와 대상 라우팅이 올바르게 설정됐다는 뜻은 아닙니다.
규칙 키워드와 정책
Config로 트래픽을 분기할 때는 규칙을 위에서 아래로 확인하고, 처음 일치한 규칙의 정책을 실행합니다. 키워드는 ‘무엇을 매칭하는지’, 정책은 ‘어떻게 처리하는지’를 나타냅니다.
DOMAIN
DOMAIN은 전체 도메인을 정확히 매칭합니다. 예를 들어 DOMAIN,example.com,DIRECT는 example.com에 적용됩니다. 모든 하위 도메인을 자동으로 포함하지 않으며 전체 URL의 경로를 기준으로 매칭하지도 않습니다.
특정 호스트 이름 하나만 처리하려면 이 키워드로 범위를 좁힐 수 있습니다. 변경 후에는 앞선 규칙이 먼저 매칭되는지 확인하세요.
DOMAIN-SUFFIX
DOMAIN-SUFFIX는 지정한 도메인과 그 하위 도메인을 매칭합니다. 예를 들어 example.com과 www.example.com이 해당됩니다. 도메인 계층을 기준으로 하며 임의의 문자열 포함 여부나 URL의 디렉터리 경로를 확인하지 않습니다.
하위 도메인마다 서로 다른 정책을 적용하려면 더 구체적인 규칙을 앞에 두고, 전체 도메인에 적용할 접미사 규칙을 뒤에 배치하세요.
IP-CIDR / IP-CIDR6
IP-CIDR과 IP-CIDR6은 각각 IPv4와 IPv6 주소 대역을 기준으로 매칭합니다. 예를 들어 IP-CIDR,192.168.0.0/16,DIRECT는 IPv4 대역을 나타냅니다. 슬래시 뒤의 접두사 길이는 범위를 정하며 포트 번호가 아닙니다.
IPv4 규칙만 추가했다고 IPv6까지 적용되는 것은 아닙니다. 대상에서 어떤 주소 유형을 사용하는지 실제 DNS 조회 결과와 연결 기록을 확인하세요.
GEOIP
GEOIP는 IP 지리 데이터베이스에 등록된 지역 정보를 기준으로 매칭합니다. 웹페이지 표시 언어, 도메인 접미사, 회사 등록 주소를 기준으로 하는 것은 아닙니다. 하나의 도메인이 여러 서버 주소를 사용하면 연결에 따라 매칭 결과가 달라질 수 있습니다.
특정 도메인을 안정적으로 처리해야 한다면 지리 정보에만 의존하기보다 더 구체적인 도메인 규칙을 우선 고려하세요.
FINAL
FINAL은 규칙 맨 끝에서 앞선 규칙에 매칭되지 않은 트래픽을 처리하는 기본 규칙입니다. 예를 들어 FINAL,PROXY와 같이 씁니다. 앞에 있는 규칙의 우선순위를 높이는 것이 아니라 남은 연결의 처리 방식을 지정합니다.
규칙 맨 끝에 배치하세요. 너무 앞에 두면 기본 규칙이 트래픽을 먼저 처리해 뒤에 있는 구체적인 규칙이 적용되지 않습니다.
PROXY
PROXY는 규칙에서 사용하는 프록시 정책으로, 매칭된 트래픽을 프록시 경로로 처리합니다. 실제 연결에는 선택한 서버와 관련 설정도 필요합니다. Global Routing의 Proxy 모드와는 대소문자 표기와 적용 범위가 다릅니다.
규칙에 PROXY를 지정해도 연결 성공이 보장되지는 않습니다. 인증, 서버 연결 가능 여부, DNS를 각각 확인해야 합니다.
DIRECT
DIRECT는 매칭된 연결이 선택한 프록시 서버를 거치지 않고 현재 네트워크를 통해 대상에 직접 접속하도록 합니다. DNS를 건너뛴다는 뜻도, 대상에 반드시 연결할 수 있다는 뜻도 아닙니다.
규칙의 DIRECT는 매칭된 연결에만 적용됩니다. Global Routing의 Direct는 전체 라우팅 방식이므로 문제를 확인할 때 둘을 구분하세요.
REJECT
REJECT는 매칭된 연결을 거부하는 규칙 결과입니다. 프록시 서버 시간 초과와는 다릅니다. 웹페이지 본문은 열리지만 일부 기능이 작동하지 않는다면 관련 요청이 이 정책에 매칭됐는지 확인하세요.
변경하기 전에 해당 도메인과 규칙 위치를 찾아 매칭 범위를 좁히세요. 원인을 확인하지 않은 상태에서 설정 전체를 삭제하지 마세요.
구독과 설정 파일
모든 플랫폼에서 사용자가 보유한 구독이나 서버 정보를 사용해야 합니다. 서버 목록은 연결 정보를 관리하고, 설정 파일은 규칙과 관련 설정을 관리하므로 서로 대체할 수 없습니다.
구독 / Subscribe
구독은 링크를 통해 서버 목록을 가져오고 업데이트하는 방식이며 Subscribe는 관련 메뉴 이름입니다. 업데이트 성공은 목록을 가져와 읽었다는 뜻일 뿐, 목록의 모든 서버에 연결할 수 있다는 뜻은 아닙니다.
링크에 포함된 인증 정보는 민감한 정보입니다. 스크린샷이나 로그를 공유하기 전에 가리고, 업데이트하면 직접 수정한 항목이 덮어써질 수 있는지도 확인하세요.
서버 / SERVER
서버 정보는 클라이언트가 연결할 원격 서비스를 나타내며, 보통 주소, 포트, 프로토콜, 인증 매개변수가 포함됩니다. SERVER는 화면에서 서버 목록을 표시하는 항목입니다. 표시 이름은 서버를 구분하기 위한 것이며 프로토콜이나 성능을 증명하지 않습니다.
이름이 같은 서버 정보라도 주소가 다를 수 있습니다. 문제를 확인할 때는 이름이나 그룹만 보지 말고 실제 설정 항목을 비교하세요.
설정 파일 / Config
설정 파일에는 공통 옵션, 규칙 및 기타 기능 섹션이 구성됩니다. 흔히 쓰이는 섹션은 [General], [Rule], [Host], [URL Rewrite]입니다. Config는 설정 메뉴를 가리키기도 하고, 설정에 따른 트래픽 분기 방식을 나타내기도 합니다.
파일을 다운로드하거나 저장한 뒤 현재 해당 설정 파일을 사용 중인지 확인하세요. 파일이 있다는 것만으로 활성화된 것은 아닙니다.
DNS
DNS는 도메인을 IP 주소로 변환하는 연결 과정의 한 단계입니다. 도메인 확인 실패, 프록시 서버 연결 실패, 대상 서비스의 접속 거부는 서로 다른 문제이므로 모두 ‘DNS 변경’으로 해결하려 해서는 안 됩니다.
문제를 확인할 때 실패한 도메인, 현재 네트워크, 실제 DNS 조회 결과를 기록한 다음 설정의 DNS 항목을 점검하세요. 라우팅과 DNS 설정을 동시에 바꾸지 않는 것이 좋습니다.
URL Rewrite
URL Rewrite는 조건에 따라 요청 URL을 바꾸거나 리디렉션하는 기능으로, Rule에서 연결 정책을 선택하는 것과 다릅니다. URL이 바뀌면 다른 대상에 접속할 수 있지만 전체 라우팅 모드가 전환되는 것은 아닙니다.
HTTPS 요청을 처리할 때는 암호화 및 인증서 조건도 적용됩니다. 재작성 규칙 하나로 모든 암호화된 요청을 직접 읽을 수 있다고 생각하지 마세요.
지연 시간
지연 시간은 특정 테스트 조건에서 관찰된 응답 시간으로, 해당 테스트 경로의 결과입니다. 지속적인 다운로드 대역폭과는 다릅니다. 수치가 낮더라도 인증, DNS 조회, 실제 웹페이지 로딩이 모두 정상이라고 보장할 수 없습니다.
비교할 때는 같은 기기, 네트워크, 테스트 방식을 사용하고 실제 접속 결과도 함께 확인하세요. 서로 다른 네트워크에서 한 번 측정한 값은 직접 비교하기 어렵습니다.
설치와 시스템 권한
iPhone / iPad의 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 확인하세요. Mac, Windows, Android, Linux의 설치 방법은 앱 다운로드 페이지를 참고하세요. 시스템의 설치 허용과 앱 내 연결 권한은 각각 처리해야 합니다.
VPN 구성 권한
iPhone / iPad에서 처음 연결할 때 시스템이 VPN 구성 추가를 허용할지 물을 수 있습니다. 이 권한은 클라이언트가 네트워크 터널을 만들도록 허용합니다. 권한을 허용한 뒤에도 올바른 서버 정보가 필요하며, 구독이나 원격 서버가 자동으로 생성되지는 않습니다.
권한을 거부했다면 시스템 안내나 설정에서 다시 확인하세요. VPN 표시가 나타나더라도 모든 대상에 접속할 수 있다는 뜻은 아닙니다.
구입 항목
iPhone / iPad의 구입 항목에서 기존 계정의 앱 구입 내역을 확인할 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 구입 당시 사용한 계정부터 확인하세요. 앱 재다운로드와 서버 목록, 구독, 설정 파일 복구는 서로 다른 절차이며, 후자는 직접 만든 백업이 필요합니다.
iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제이며, Mac / Windows / Android / Linux 버전은 무료입니다. 각 스토어에 표시되는 금액을 기준으로 확인하세요.
Apple 실리콘 / Intel
Mac용 Apple 실리콘 버전과 Intel 버전은 서로 다른 프로세서 아키텍처에 맞춰 제공됩니다. 먼저 ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인한 뒤 해당 dmg를 선택하세요. 두 설치 파일은 기능 모드가 다르거나 외관 및 컴퓨터 이름으로 구분되는 것이 아닙니다.
처음 실행할 때 개발자를 확인할 수 없다는 안내가 표시되면 먼저 파일을 이 사이트에서 받았는지 확인하세요. 그런 다음 시스템 설정의 ‘개인정보 보호 및 보안’에서 ‘그래도 열기’를 선택할 수 있습니다. 자세한 절차는 설치 허용 안내를 참고하세요.
시스템 설치 허용
Windows의 SmartScreen, macOS의 실행 경고, Android의 ‘알 수 없는 앱 설치 허용’은 다운로드 파일을 제어하는 시스템 기능이며 구독이나 프로토콜 오류와는 무관합니다. 파일을 이 사이트에서 받았는지 확인한 뒤 Windows에서는 ‘추가 정보 → 실행’을 선택하고, Android에서는 실제로 파일을 다운로드한 브라우저에만 해당 권한을 허용하세요.
Linux의 AppImage는 실행 권한도 설정해야 합니다. 각 플랫폼의 현재 안내에 따라 처리하고, 설치를 위해 시스템 보호 기능 전체를 끄지 마세요. 자세한 절차는 설치 허용 안내표를 참고하세요.