Shadowrocket 사용 설명서
기존 서비스를 추가하고 규칙 모드를 선택한 뒤 연결을 확인합니다.
이 페이지는 처음 사용할 때의 순서에 따라 안내합니다. 먼저 연결 정보를 준비한 다음 반복 가능한 접속 테스트를 진행합니다. 순조롭게 진행되면 주요 절차를 약 10분 안에 마칠 수 있습니다. 권한 또는 연결 문제가 발생하면 현재 결과를 기록하고 해당 확인 항목으로 바로 이동하세요. 구성을 반복해서 삭제할 필요는 없습니다.
스크린샷은 화면과 입력란을 확인하기 위한 것이며, 서버 정보를 그대로 옮겨 적는 용도가 아닙니다. 화면에 표시되는 항목은 실제 설치된 버전에 따라 다를 수 있습니다. 영어 설정 항목은 원문 그대로 표기하여 쉽게 찾을 수 있도록 했습니다.
단계 01 · 연결 항목 준비
Add Server: 추가 및 가져오기
Shadowrocket을 열고 Home으로 이동합니다. SERVER 그룹에서 기존 항목을 확인합니다. 아직 추가한 항목이 없다면 Add Server를 눌러 입력 화면으로 이동합니다. 먼저 보유한 정보의 종류를 확인하세요. 프로토콜, 서버 주소, 인증 정보가 포함된 자료는 단일 서버 정보이고, 여러 항목을 가져오는 웹 주소는 구독 주소입니다. 둘 다 구성에 사용할 수 있지만 입력 위치가 다르므로 구독 주소를 Host에 입력하지 마세요.
서버 한 대 직접 추가
Add Server에서 Type을 누르고 보유한 정보에 맞는 프로토콜을 선택한 다음 아래 필드를 입력합니다. Type에 따라 표시되는 입력 항목이 달라지므로 프로토콜을 먼저 선택하고 내용을 입력하세요. Shadowsocks를 예로 들면 Host, Port, Password, Method를 확인합니다. Host에는 서버 도메인 또는 IP 주소를 입력하고, Port에는 연결 포트를 입력합니다. Password와 Method는 보유한 정보를 그대로 입력합니다. 웹 페이지 경로, 설명 문구 또는 불필요한 공백을 서버 주소에 포함하지 마세요.
프로토콜마다 인증 방식이 다릅니다. VMess, VLESS, Trojan 등의 항목은 추가 식별자, 전송 방식 또는 TLS 관련 필드가 필요할 수 있습니다. 사용자가 보유한 전체 연결 정보를 기준으로 입력하세요. 양식을 채우기 위해 매개변수를 추측하거나 한 프로토콜의 필드를 다른 프로토콜에 그대로 적용하지 마세요. 입력을 마치고 저장한 다음 Home으로 돌아와 SERVER 아래에 새 항목이 추가되었는지 확인합니다.
기존 구독 가져오기
구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 구독 주소 필드에 전체 URL을 붙여 넣은 뒤 화면 안내에 따라 저장합니다. 구독 주소에는 사용자를 식별하는 쿼리 매개변수가 포함될 수 있으므로 기존 내용을 그대로 유지하세요. 물음표 뒤의 부분을 잘라내거나 URL을 공개 토론 공간에 올리지 마세요. 저장한 다음 읽기가 완료될 때까지 기다리고 Home으로 돌아가 해당 그룹에 서버 항목이 나타나는지 확인합니다.
구독 가져오기의 성공 여부는 이름만 저장된 것이 아니라 실제 서버가 표시되는지로 판단합니다. 구독 그룹만 나타나고 항목이 없다면 먼저 링크가 온전한지, 현재 네트워크에서 구독을 읽을 수 있는지, 서비스가 유효한지 확인한 다음 해당 그룹을 업데이트합니다. 같은 주소를 반복해서 추가해도 대개 중복 그룹만 늘어나며 읽기 오류는 해결되지 않습니다.
QR 코드 또는 공유 링크 사용
보유한 QR 코드가 있다면 Scan QR Code로 읽을 수 있습니다. 카메라를 처음 사용할 때는 시스템 안내에 따라 권한을 허용하세요. 프로토콜 공유 링크가 있다면 앱에서 제공하는 가져오기 메뉴를 사용하고 저장 전에 해석된 Type, Host, Port를 확인합니다. Import from Cloud JSON은 다른 데이터 가져오기 방식입니다. 자료가 해당 형식을 사용하는 경우에만 이용하고 임의의 구독 URL을 입력하지 마세요.
세 가지 방법을 모두 사용할 필요는 없으며 하나만 완료하면 됩니다. Home으로 돌아가 서버를 선택해 이번 테스트 대상으로 지정하고 선택한 항목의 이름을 기억해 둡니다. 다음 단계에서는 Global Routing만 조정하고 서버는 동시에 바꾸지 마세요. 그래야 확인에 실패했을 때 원인을 구분할 수 있습니다. 링크 유형의 자세한 차이는 용어집에서 확인하세요.
단계 02 · 트래픽 경로 결정
Global Routing: 모드 선택
선택 가능한 서버가 있으면 Home으로 돌아가 Global Routing을 누릅니다. 여기서는 연결에 사용할 라우팅 모드를 정하며 프로토콜을 다시 선택하는 것이 아닙니다. 화면의 세 가지 모드는 Config, Proxy, Direct에 해당합니다. 각 모드의 역할을 이해한 다음 이번 연결에 필요한 항목을 선택하세요.
Config: 현재 구성 파일에 따라 트래픽 분기
Config는 현재 적용 중인 구성 파일에 따라 연결을 처리합니다. 규칙에 따라 일부 대상은 Proxy로 보내고 다른 대상은 직접 연결할 수 있으며, 특정 연결을 거부할 수도 있습니다. 따라서 서버를 선택했다고 해서 모든 접속이 해당 서버를 통과하는 것은 아닙니다. 대상이 어떤 규칙에 일치하는지, 해당 규칙에서 어떤 정책을 사용하는지 확인해야 합니다.
하단의 Config로 전환해 현재 사용 중인 구성 파일을 확인한 다음 파일 내용을 살펴봅니다. 공식 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집 페이지의 각 구역입니다. 규칙은 주로 Rule에서 확인하고 Add Rule로 규칙을 추가합니다. 처음 사용할 때 모든 구역을 수정할 필요는 없으며, 일반 연결 테스트를 위해 HTTPS Decryption을 활성화할 필요도 없습니다.
규칙은 보통 순서대로 일치 여부를 확인하며, 구체적인 동작은 규칙 유형과 구성에 따라 달라집니다. 아래는 문법을 알아보기 위한 예시이며 현재 파일을 대체할 수 있는 완전한 구성은 아닙니다. example.com은 예시 도메인이고, PROXY도 실제 구성에 사용할 수 있는 정책이 있어야 합니다. 완전한 구성 정보가 없다면 몇 줄만 복사해 현재 파일을 덮어쓰지 마세요.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYProxy: 먼저 서버가 작동하는지 확인
Proxy는 프록시 가능한 연결을 현재 선택한 서버로 전달하므로 서버를 처음 확인하거나 Config의 결과와 비교할 때 적합합니다. 잘못 입력한 비밀번호, 만료된 서비스 또는 연결할 수 없는 포트를 해결해 주지는 않습니다. 모든 앱의 모든 시스템 트래픽이 반드시 같은 경로로 전달된다는 뜻도 아닙니다. 테스트하기 전에 서버가 선택되었는지 확인한 뒤 모드를 전환하세요.
Direct: 직접 접속 결과 비교
Direct는 선택한 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 현재 기본 네트워크의 작동 여부를 판단하는 데 도움이 되지만 프록시 서버의 작동을 확인하는 용도로는 사용할 수 없습니다. 스위치를 켠 뒤에도 접속 결과가 이전과 같다면 앱을 바로 재설치하지 말고 Global Routing이 Direct에 머물러 있는지 먼저 확인하세요.
처음에는 Proxy로 연결을 확인한 다음 서버가 기본적으로 작동하는지 확인하고, 평소 사용을 위해 Config로 전환해 규칙을 점검하는 방법을 권장합니다. 모드는 문제 해결을 위한 변수 중 하나이므로 변경 전에 원래 선택을 기억해 두세요. 규칙 순서, 정책 참조 및 구성 파일 관리에 대한 자세한 내용은 사용 매뉴얼을 참고하세요.
단계 03 · 시스템 연결 설정
Home: 연결 스위치 켜기
Home으로 돌아가 먼저 두 가지를 확인합니다. SERVER 그룹에서 방금 추가한 서버가 선택되어 있고, Global Routing에 이번에 사용할 모드가 표시되어야 합니다. 확인한 다음 상단 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected가 표시됩니다. 이 상태 문구를 서버 이름으로 오해하거나 서버 항목을 저장했다는 이유만으로 연결이 완료되었다고 판단하지 마세요.
시스템의 VPN 구성 추가 허용
처음 연결할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 이 권한은 Shadowrocket이 시스템 네트워크 연결을 설정하는 데 필요합니다. 서버를 가져오는 기능이 아니며 사용자 대신 서버 정보를 입력해 주지도 않습니다. 방금 연 Shadowrocket에서 요청한 것이 맞는지 확인한 뒤 허용을 선택하고 기기 안내에 따라 암호 또는 시스템 인증으로 권한을 승인합니다.
취소를 누르면 앱이 연결되지 않은 상태로 돌아갈 수 있습니다. 상단 스위치를 다시 켜 시스템 요청을 완료하면 됩니다. 같은 서버를 반복해서 추가하지 마세요. 기기가 조직에서 관리되거나 시스템 제한이 적용되면 현재 사용자가 권한을 승인하지 못할 수 있습니다. 이 경우 기기 관리 요건을 확인하고 알 수 없는 구성을 삭제하며 문제를 해결하려 하지 마세요.
Home으로 돌아가 연결 결과 확인
권한 승인이 끝나면 앱으로 돌아와 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 연결 설정에는 시간이 걸릴 수 있으므로 스위치를 빠르게 반복해서 누르지 마세요. 상태가 계속 바뀌지 않는다면 오류 메시지가 표시되는지, 시스템 권한 승인이 완료되었는지, 현재 어떤 서버가 선택되어 있는지 기록한 다음 아래의 문제 해결 단계를 진행합니다.
시스템 설정에서 확인하려면 iPhone / iPad 설정에서 VPN을 검색해 해당 구성과 연결 상태를 확인할 수 있습니다. 시스템 버전에 따라 메뉴 위치가 달라질 수 있으므로 고정된 경로를 기억하기보다 설정 검색을 이용하는 편이 좋습니다. 이전에 Shadowrocket의 VPN 구성을 삭제했다면 다시 연결할 때 안내에 따라 추가를 허용하세요.
VPN 상태는 시스템 연결이 설정되었는지만 보여 줍니다. 서버가 요청을 전달할 수 있는지, 특정 웹사이트가 프록시 규칙에 일치했는지는 보장하지 않습니다. 이 단계에서는 서버와 라우팅 모드를 그대로 유지하고 다음 단계에서 접속을 확인하세요. 테스트 중 다른 네트워크 연결 관리 기능이 작동하고 있다면 충돌 가능성을 확인하고 원래 설정을 복구할 수 있도록 보존하세요.
단계 04 · 결과 교차 확인
Connectivity Test: 작동 여부 확인
연결한 다음 먼저 Home에서 Connectivity Test를 실행하고 테스트가 끝날 때까지 기다립니다. 그런 다음 브라우저에서 이용 권한이 있는 대상 서비스에 접속합니다. 한 번의 테스트에 시간이 표시되거나 시스템에 VPN 표시가 나타나거나 어떤 페이지가 열렸다는 이유만으로 전체 구성이 올바르다고 판단하지 마세요. 테스트 방법, 대상 서비스의 상태 및 규칙 분기가 모두 관찰 결과에 영향을 줍니다.
세 가지 근거 구분
서버 테스트는 해당 테스트 방식에서의 연결 가능성을 확인하고, 시스템 연결 상태는 VPN 통로가 설정되었는지 확인하며, 브라우저나 서비스 앱의 접속 결과는 실제 요청을 확인합니다. 각 결과가 답하는 질문은 서로 다릅니다. 서버 테스트는 통과했지만 웹 페이지에 접속할 수 없다면 DNS, 대상 사이트 및 규칙을 확인하세요. 웹 페이지는 열리지만 서버 테스트가 실패한다면 테스트 대상이나 방법이 현재 서비스에 적합하지 않을 수도 있습니다.
확인할 때는 같은 대상과 비슷한 네트워크 조건을 사용하세요. 먼저 현재 연결을 유지하고 대상 페이지를 새로 고친 뒤 사이트 내 다른 페이지를 여는 등 실제 작업을 수행합니다. 연결 해제 상태와 비교하려면 연결을 끄고 같은 작업을 반복한 다음 다시 연결해 테스트합니다. 브라우저 캐시 때문에 이미 열려 있던 페이지가 계속 보일 수 있으므로 이전 페이지에 오류가 없다고 해서 새 요청이 성공한 것은 아닙니다.
Config에서 실제 트래픽 경로 확인
Proxy에서는 접속할 수 있지만 Config로 전환한 뒤 결과가 달라지면 현재 구성 파일과 대상에 일치하는 규칙을 먼저 확인합니다. 앱에서 제공하는 연결 기록 메뉴에서 대상 도메인, 적용된 정책 및 결과를 확인해 예상한 Proxy 또는 DIRECT로 연결되었는지 확인하세요. 규칙에 지정된 도메인과 실제 요청 도메인이 다를 수 있으며 페이지에서 추가 리소스 도메인을 요청할 수도 있습니다. 브라우저 주소 표시줄만으로 모든 연결을 판단할 수는 없습니다.
Data의 트래픽 변동은 참고할 수 있지만 총 트래픽이 늘었다는 사실만으로 특정 대상이 선택한 서버를 거쳤다고 단정할 수는 없습니다. 백그라운드 앱도 트래픽을 만들고 Config에서는 직접 연결과 프록시 연결이 함께 발생할 수 있습니다. 명확한 접속 시간, 연결 기록 및 선택한 모드를 서로 대조해 항목별로 확인하는 것이 더 정확합니다.
확인을 마친 다음 평소에 필요한 모드로 되돌립니다. 서버를 확인하기 위해 잠시 Proxy를 사용했다면 Config로 되돌리는 것을 잊지 마세요. 필요에 따라 나중에 On Demand를 사용할 수 있지만, 먼저 수동 연결을 확인한 다음 자동 실행 조건을 설정해야 자동 연결 문제와 서버 문제를 구분할 수 있습니다.
단계 05 · 한 번에 한 항목만 변경
Settings: 자주 발생하는 문제 해결
문제가 생기면 먼저 서버와 구성 파일을 그대로 보존하세요. 모든 내용을 삭제하는 것부터 시작하지 마세요. 현재 네트워크, 보유 정보, 선택한 모드, 실제 오류의 네 가지 항목으로 상황을 정리한 뒤 아래 순서대로 확인합니다. 한 항목을 변경할 때마다 다시 연결해 같은 접속 테스트를 반복하세요. 개선되지 않으면 원래 값으로 되돌려 여러 변경 사항이 쌓여 원인을 파악하기 어려워지는 일을 방지합니다.
서버가 없거나 구독 업데이트 후에도 비어 있음
추가 단계로 돌아가 구독 주소의 문자가 빠지거나 공백이 붙지 않았는지, 메신저에서 줄바꿈으로 나뉘지 않았는지 확인합니다. 주소를 저장할 수 있다고 해서 유효한 내용을 읽어올 수 있는 것은 아닙니다. 기본 네트워크와 서비스 유효 기간을 확인하고 업데이트 시 오류 메시지를 살펴보세요. 서비스 제공자가 구독 주소를 변경했다면 사용자가 보유한 새 주소로 기존 그룹을 수정하면 됩니다. 같은 구독을 여러 개 보관할 필요는 없습니다. 사용자 인증 정보는 적절한 비공개 경로로만 확인하세요.
스위치를 켜도 연결이 유지되지 않음
먼저 시스템의 VPN 권한이 승인되었는지 확인한 다음 서버가 선택되어 있는지 살펴봅니다. 인증 또는 연결 오류가 구체적으로 표시되면 안내에 따라 Type, Host, Port 및 인증 필드를 확인합니다. Wi-Fi와 셀룰러 네트워크를 전환해 비교하면 현재 네트워크 문제와 서버 문제를 구분하는 데 도움이 됩니다. 셀룰러 네트워크를 사용할 때는 데이터 사용량에 유의하세요.
연결은 설정되지만 모든 대상에 접속할 수 없음
먼저 연결을 끄고 기본 네트워크에서 일반 서비스에 접속할 수 있는지 확인합니다. 기본 네트워크 자체를 사용할 수 없다면 로그인 네트워크 또는 신호 문제를 먼저 해결하세요. 기본 네트워크가 정상이라면 잠시 Proxy를 사용해 같은 서버를 확인합니다. 계속 실패하면 서비스 유효 기간, 서버 상태 및 프로토콜 매개변수를 확인합니다. 사용자가 보유한 다른 이용 가능한 항목이 있다면 서버만 바꿔 비교하고 DNS와 규칙을 동시에 변경하지 마세요.
Config에서 일부 대상에만 접속할 수 없음
예상한 구성 파일이 실제로 적용되어 있는지 확인한 다음 규칙 순서와 실제 일치 결과를 확인합니다. 범위가 넓은 규칙이 앞에 있으면 뒤쪽의 세부 규칙이 적용되지 않을 수 있으며, FINAL은 앞의 규칙에 일치하지 않은 요청을 처리합니다. 접속에 실패했다고 모든 Rule을 삭제하거나 모든 연결을 DIRECT로 변경하지 마세요. 대상에 실제로 어떤 정책이 적용되는지 확인한 뒤 필요한 범위만 수정하세요.
테스트 실패 또는 도메인 조회 오류
Settings를 열고 Test Method를 확인합니다. 테스트 방식마다 확인하는 내용이 다르므로 하나의 결과가 모든 앱의 트래픽을 나타내지는 않습니다. 도메인 조회 관련 오류가 발생하면 현재 DNS 설정을 기록한 뒤 같은 도메인으로 다시 테스트합니다. 필요한 경우 사용 가능하다고 확인된 설정으로 되돌려 비교합니다. 알 수 없는 DNS 주소를 한 번에 여러 개 입력하거나 도메인 또는 인증서 불일치를 감추기 위해 TLS 확인을 끄지 마세요.
Settings의 Diagnostics를 사용해 원인을 더 자세히 확인할 수 있습니다. 진단 결과를 볼 때는 오류 유형, 발생 당시 네트워크 환경 및 작업 순서를 기록하세요. 공유하기 전에 구독 주소, 인증 정보, 개인 도메인 및 기타 민감한 내용을 가립니다. Proxy, TCP, UDP 등의 설정은 서로 다른 동작에 영향을 주므로 처음 문제를 해결할 때는 기존 값을 유지하고 모든 스위치를 한꺼번에 변경하지 마세요.
화면 잠금, 네트워크 전환 또는 자동 재연결 후에만 문제가 발생한다면 On Demand 조건과 시스템 네트워크 변화를 확인합니다. 자동 실행을 다루기 전에 수동 연결이 정상인지 확인하세요. 권한, 구독 업데이트 및 DNS 문제에 관한 자세한 내용은 자주 묻는 질문을 참고하세요. 영어 설정 항목을 확인하려면 용어집을 살펴보세요. 처음 사용하면서 모든 고급 옵션을 수정할 필요는 없습니다.
확인된 구성 보존
한 번 정상적으로 확인한 후 현재 사용 중인 구독 그룹, 서버, 라우팅 모드 및 구성 파일 이름을 기록해 둡니다. 구독을 업데이트할 때는 먼저 업데이트 결과를 확인하세요. 업데이트 후 항목 순서나 이름이 달라질 수 있으므로 선택된 항목을 다시 확인해야 합니다. 구성을 수정하기 전에 복구할 수 있는 사본을 보관하고, 사본에 개인 서버 정보가 포함될 수 있으므로 공개하지 마세요.
다음에 문제가 발생하면 마지막으로 정상 작동했던 상태와 비교합니다. 네트워크가 바뀌었는지, 구독 항목이 바뀌었는지, 구성 파일이 수정되었는지 확인하면 반복 작업을 줄일 수 있습니다. 권한, Data, Settings 및 일상적인 관리에 대한 자세한 내용은 Shadowrocket 사용 매뉴얼을 참고하세요.