OFFICIAL MANUAL / QUICKSTART

Shadowrocket 사용법 가져오기, 연결 및 확인

기존 설정으로 재현 가능한 연결을 먼저 한 번 완료한 다음 트래픽 분기와 자동 연결을 조정하세요. 이 공식 핸드북은 iPhone과 iPad에서 처음 사용할 때 필요한 절차를 다루며, 아래 5단계 순서대로 진행합니다.

작업 원칙: 각 단계를 마칠 때마다 결과를 확인하세요. 구독 가져오기 성공, 연결 스위치 켜짐, 실제 요청이 예상한 경로로 처리됨은 각각 별개의 확인 항목입니다.

STEP 01 / IMPORT

Add Server / Subscribe: 기존 정보 가져오기

Shadowrocket를 열고 먼저 Home으로 이동합니다. 여기서 서버를 확인하고 선택할 수 있습니다. 아직 정보를 추가하지 않았다면 연결 스위치를 켤 필요가 없습니다. 보유한 정보의 종류를 확인하세요. 구독 링크는 여러 서버 정보를 가져오며, 단일 공유 링크에는 보통 서버 하나의 정보가 담겨 있습니다. 직접 입력할 정보에는 프로토콜, 주소, 포트 및 인증 정보가 포함됩니다. 정보 종류에 따라 가져오는 메뉴가 다를 수 있으므로 링크 모양만 보고 서로 혼용하지 마세요.

기존 구독 링크가 있다면 Subscribe 선택

Home에서 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동합니다. 유형 선택 메뉴에서 Subscribe를 선택하고 본인의 전체 구독 링크를 URL 입력란에 붙여 넣은 뒤 저장합니다. 메모 입력란이 나타나면 알아보기 쉬운 이름을 사용할 수 있습니다. 붙여 넣은 링크의 앞뒤가 온전한지 확인하세요. 특히 물음표 뒤의 매개변수를 빠뜨리지 말고, 채팅 문구나 따옴표, 공백이 함께 들어가지 않도록 주의하세요.

저장한 뒤 Home으로 돌아가 구독 정보가 로드될 때까지 기다린 다음 해당 그룹에 선택 가능한 서버가 표시되는지 확인합니다. 구독 이름만 보이고 서버가 없다면 가져오기가 완료된 것이 아닙니다. 현재 네트워크에서 정보를 가져오지 못했거나 링크가 유효한 구독 정보 대신 웹페이지 안내를 반환했을 수 있습니다. 같은 주소를 계속 다시 추가하기보다 링크 상태와 가져오기 결과를 먼저 확인하세요. 구독 업데이트 메뉴의 위치는 현재 화면을 기준으로 확인하고, 업데이트한 뒤 목록을 다시 확인합니다.

기존 서버 정보가 있다면 해당 프로토콜 선택

더하기 버튼을 눌러 Add Server로 이동하고, 유형 선택에서 보유한 정보에 해당하는 프로토콜을 고른 뒤 주소, 포트, 인증 정보를 항목별로 입력합니다. Shadowsocks, VMess, VLESS, Trojan, WireGuard 등은 필요한 입력 항목이 서로 다릅니다. 제공된 정보에 명시된 항목만 입력하고, 전송 방식, TLS, 서버 이름 등의 추가 매개변수도 원본 정보와 일치시켜야 합니다. 입력란을 모두 채우려고 제공되지 않은 항목에 임의의 값을 넣지 마세요.

단일 서버 공유 링크를 받았다면 앱에서 제공하는 링크 가져오기 기능을 사용할 수 있습니다. QR 코드 정보는 Scan QR Code로 읽을 수 있습니다. 어떤 방식을 사용하든 저장한 뒤 Home으로 돌아가 목록에 항목이 있는지 확인하고 사용할 항목을 선택하세요. 구독 주소에는 개인 인증 정보가 포함될 수 있으므로 댓글, 스크린샷, 문제 해결 기록에 공개하지 마세요. 일반 웹 링크처럼 공유해서도 안 됩니다.

이 단계에서는 정보가 목록에 추가되고 선택 가능한지만 확인합니다. 서버에 연결할 수 있다는 뜻은 아닙니다. 또한 구독은 보통 서버 목록을 업데이트하며, Config 페이지에서는 설정 파일과 규칙을 관리합니다. 구독을 가져왔다고 해서 트래픽 분기 규칙까지 준비되었다고 단정하지 마세요. 목록이 정상인지 확인한 다음 Global Routing을 선택합니다.

STEP 02 / ROUTING

Global Routing: 처리 방식 선택

Home으로 돌아가 Global Routing을 엽니다. 여기서 요청을 전반적으로 처리할 방식을 선택하며 서버 정보를 대신 입력해 주지는 않습니다. 처음 설정할 때는 현재 선택 항목을 기록해 두세요. 설치 상태, 기존 설정, 이전 변경 사항에 따라 화면에 표시되는 항목이 달라질 수 있으므로 이 안내에서는 기본값을 하나로 정하지 않습니다. 선택지는 Config, Proxy, Direct이며 이번 확인 목적에 맞는 항목을 선택하세요.

Config: 현재 설정 파일에 따라 처리

사용 가능한 규칙 파일이 있고 규칙에 따라 트래픽을 분기하려면 Config를 선택합니다. 먼저 Config 페이지에서 파일이 있는지 확인하고 이번에 사용할 설정 파일을 선택하세요. 규칙은 요청마다 DIRECT, PROXY 또는 다른 정의된 정책을 적용할 수 있으므로 연결 후 일부 요청이 직접 연결되는 것은 정상일 수 있습니다. Config를 선택한 것만으로 규칙이 설정된 것은 아니며 모든 요청이 Home에서 현재 선택한 서버를 사용한다는 뜻도 아닙니다.

Proxy: 프록시 경로 확인

방금 가져온 서버가 작동하는지 확인하려면 짧은 테스트 동안 Proxy를 선택하고 Home에서 서버가 올바르게 선택되어 있는지 확인할 수 있습니다. 이렇게 하면 설정 파일 규칙이 비교 결과에 미치는 영향을 줄일 수 있지만, 기기의 모든 트래픽이 반드시 같은 경로를 거친다고 단정할 수는 없습니다. 테스트 후 일상적으로 규칙 분기를 사용하려면 준비된 Config로 되돌린 다음 필요한 접속을 확인하세요.

Direct: 직접 연결 및 비교

Direct는 직접 연결에 사용하며, 선택한 프록시 서버가 작동한다는 증거로 삼을 수 없습니다. 문제 해결 시 직접 연결과 프록시 경로의 차이를 비교하는 데 활용할 수 있지만, 전환 전후에 테스트 대상과 로컬 네트워크를 동일하게 유지하세요. 평소에도 접속 가능한 페이지가 열린 것만으로는 Direct와 Proxy를 구분할 수 없습니다. 현재 모드, 설정 규칙 및 후속 기록을 함께 살펴보세요.

처음 확인할 때는 서버 연결을 먼저 확인하고 그다음 규칙에 따른 트래픽 분기를 확인하는 식으로 명확한 목표 하나만 선택하세요. 한 번의 테스트에서 Global Routing을 바꾸고 DNS를 수정하고 설정 파일까지 교체하면 결과가 달라져도 원인을 찾기 어렵습니다. 규칙 순서, DNS, 정책의 관계는 첫 연결을 마친 뒤 Settings 설정 핸드북에서 확인할 수 있습니다.

STEP 03 / CONNECT

Home: 연결 스위치 켜기

Home으로 돌아가 두 가지를 확인합니다. 올바른 서버가 선택되어 있는지, Global Routing이 방금 정한 방식으로 유지되는지 확인하세요. 구독에 이름이 비슷한 항목이 있다면 선택한 뒤 다시 확인하고 목록의 첫 번째 항목을 무조건 선택하지 마세요. 현재 Wi-Fi 또는 셀룰러 네트워크로 인터넷에 접속할 수 있는지 확인한 다음 Home 상단의 연결 스위치를 켭니다. 연결 정보가 저장되어 있어도 연결을 시작하려면 이 단계가 필요합니다.

처음 연결할 때 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 방금 Shadowrocket에서 연결을 시작한 결과로 표시된 요청인지 확인한 뒤 시스템 안내에 따라 허용하고 기기 인증을 완료하세요. 이 팝업은 시스템 네트워크 구성 권한을 요청하는 것이며 다른 서비스를 구매하라는 뜻이 아닙니다. 이전에 권한 요청을 취소했다면 앱으로 돌아가 연결을 다시 시작하고 표시되는 안내에 따르세요. 기기가 관리되거나 제한되어 있다면 관련 시스템 제한도 확인해야 합니다.

권한을 허용한 뒤 Home으로 돌아가 스위치와 연결 상태가 유지되는지 확인합니다. 시스템의 VPN 표시는 네트워크 확장 기능의 상태를 확인하는 데 도움이 되지만, 표시가 나타났다고 모든 원격 서버, DNS 요청 또는 대상 페이지가 정상 작동한다는 뜻은 아닙니다. 반대로 스위치를 켜자마자 꺼지거나 앱에서 연결 오류를 표시하면 트래픽 분기 규칙을 급히 수정하지 말고 권한과 서버 정보를 먼저 확인하세요.

첫 테스트에서는 조건을 단순하게 유지하세요. 서버 하나, 로컬 네트워크 하나, Global Routing 방식 하나를 정하고 On Demand 같은 자동 연결 조건은 당분간 조정하지 않습니다. 관련 옵션의 초기값은 현재 앱 화면을 기준으로 확인하세요. 자동 연결 조건이 이미 활성화되어 있다면 기록해 두세요. 수동으로 껐는데도 자동 연결되어 스위치 이상으로 오해할 수 있습니다. 문제를 해결하려고 잘 모르는 Settings 항목을 한꺼번에 초기화하지 마세요.

iPad에서는 iPhone과 화면 배치가 다를 수 있지만 확인 순서는 같습니다. Home에서 항목을 선택하고, Global Routing을 정하고, 연결을 켠 다음 시스템 권한 요청을 처리합니다. 연결한 뒤에는 여러 앱이나 네트워크를 바로 전환하지 말고 다음 단계에서 확인할 수 있도록 상태를 유지하세요. 연결을 직접 중단하려면 Home으로 돌아가 스위치를 끄고 시스템 상태를 확인합니다. On Demand 조건이 설정되어 있다면 해당 트리거 설정도 함께 확인해야 합니다.

STEP 04 / VERIFY

Connectivity Test: 실제 결과 확인

연결 스위치가 켜진 상태에서 Home의 Connectivity Test를 사용해 목록 항목별 결과를 확인합니다. 테스트 방식과 대상은 현재 설정의 영향을 받으므로 결과값은 동일한 조건에서 비교할 때 유용하며, 실제 다운로드 속도로 간주해서는 안 됩니다. 한 번의 테스트에 실패해도 바로 항목을 삭제하지 마세요. 먼저 테스트 조건을 확인하고 실제 접속으로 다시 판단합니다.

이어서 사용할 웹페이지나 앱을 열고 페이지를 새로 고침하거나 새 콘텐츠를 요청하는 등 명확한 작업을 한 번 수행하세요. 캐시된 페이지만 확인하지 않는 것이 좋습니다. 캐시된 콘텐츠가 표시되어도 방금 연결한 경로가 새 요청을 처리했다는 뜻은 아닙니다. 로드 여부, 대기 시간, 일부 리소스만 실패하는지 기록하세요. 이런 정보가 단순히 '작동하지 않음'이라고 적는 것보다 문제를 찾는 데 도움이 됩니다.

Config를 사용할 때 실제 요청은 규칙에 따라 서로 다른 경로로 처리될 수 있습니다. 한 페이지가 열린다고 다른 도메인도 같은 정책을 적용받는 것은 아닙니다. 페이지 본문은 표시되지만 이미지가 실패하는 경우에도 여러 도메인이나 서로 다른 요청이 관련되었을 수 있습니다. 구체적인 처리 경로를 확인하려면 앱 내 관련 연결 기록이나 Log를 확인하고 현재 설정과 함께 살펴보세요. VPN 표시만으로 모든 트래픽의 경로를 판단하지 마세요.

결과가 불분명하면 조건을 제한해 비교할 수 있습니다. 서버와 로컬 네트워크는 그대로 둔 채 현재 Config에서의 현상을 기록하고, 같은 대상을 Proxy로 잠시 테스트한 다음 원래 방식으로 되돌리세요. Proxy에서는 정상인데 Config에서만 문제가 생기면 설정 파일, 일치하는 규칙, 정책을 우선 확인하세요. 둘 다 실패하면 서버 정보와 네트워크 연결 가능 여부를 먼저 확인합니다. 비교는 원인을 좁히기 위한 방법이지, 설정을 무작정 반복해서 바꾸는 방식이 아닙니다.

첫 확인이 끝나면 민감 정보가 없는 간단한 기록을 남기세요. 사용한 로컬 네트워크, 서버 메모, Global Routing, Connectivity Test 결과와 실제 접속 상태를 적어 두면 나중에 설정을 바꾼 뒤 같은 대상으로 다시 테스트해 변화를 비교할 수 있습니다. 연결과 접속이 모두 예상대로 작동하면 기본 사용 절차를 마쳐도 됩니다. 다른 Settings 항목은 필요할 때 하나씩 확인하세요.

STEP 05 / TROUBLESHOOT

일반적인 문제: 발생 순서대로 점검

문제가 생기면 실패한 단계에서 멈추고 전체 절차를 처음부터 반복하지 마세요. 아래 순서에 따라 정보 가져오기, 연결, 실제 접속을 확인합니다. 한 번에 조건 하나만 바꾸고 다시 테스트한 뒤 다음 단계로 진행하세요. 이미 정상 작동하는 부분은 가능한 한 그대로 두어 문제가 여러 변수로 번지지 않도록 합니다.

구독을 저장했는데 서버가 표시되지 않음

먼저 URL이 완전한지, 공백이 포함되었는지, 해당 정보가 실제 구독 링크인지 확인합니다. 그런 다음 현재 네트워크에서 구독 정보를 가져올 수 있는지 확인하고 앱에 표시된 업데이트 안내를 살펴보세요. 링크가 만료되었거나 인증 정보가 올바르지 않거나 응답 형식이 맞지 않으면 목록이 생성되지 않을 수 있습니다. 원본 정보를 제공한 곳에 유효한지 확인하세요. 오류 페이지를 구독 링크로 다시 가져오지 말고 전체 링크를 공개해 도움을 요청하지도 마세요.

연결 스위치가 켜진 상태로 유지되지 않음

먼저 시스템의 VPN 구성 권한을 허용했는지 확인한 다음 Home에서 현재 선택된 항목을 점검합니다. 직접 입력한 정보라면 주소뿐 아니라 프로토콜, 포트, 인증 항목, TLS 등의 추가 매개변수도 확인하세요. 기기에 관리 제한이 있거나 다른 네트워크 설정이 영향을 미치는 경우 시스템 안내를 먼저 살펴봅니다. 정보를 수정하기 전에 원본을 보관해 문제를 확인하는 동안 처음 입력한 값을 잊지 않도록 하세요.

연결은 켜졌지만 접속되지 않음

먼저 로컬 네트워크가 정상인지 확인한 다음 같은 서버를 서로 다른 로컬 네트워크에서 사용했을 때의 결과를 비교하세요. 특정 서버 하나만 실패하면 해당 서버의 정보와 상태를 중점적으로 확인합니다. 보유한 모든 항목이 실패하면 공통된 로컬 네트워크 환경과 설정을 먼저 살펴보세요. DNS, 프로토콜, 전송 항목을 여러 개 동시에 바꾸지 마세요. 제공된 정보나 진단 결과가 변경 필요성을 분명히 보여 줄 때만 해당 항목을 수정하고 결과를 기록하세요.

일부 사이트는 정상인데 일부 요청이 실패함

문제가 발생한 대상과 작업을 기록하고 Global Routing이 예상한 방식인지 확인합니다. Config에서는 현재 활성화된 설정과 일치하는 정책을 먼저 살펴본 뒤 같은 대상으로 필요한 비교 테스트를 진행하세요. 한 웹페이지나 앱에서만 문제가 발생한다면 대상 서비스 상태와 캐시의 영향도 고려해야 합니다. 규칙에 따른 트래픽 분기에 대한 자세한 설명은 설정 핸드북에서 확인할 수 있습니다. 처음 설정하는 단계에서 규칙을 한꺼번에 수정하지 않는 것이 좋습니다.

테스트 결과는 있지만 속도가 기대에 미치지 않음

Connectivity Test 응답 결과와 지속적인 데이터 전송 성능은 서로 다른 지표입니다. 테스트 대상을 고정하고 로컬 네트워크 상태를 비교한 다음 선택한 서버와 프로토콜 정보를 확인하세요. 한 번에 조건 하나만 바꾸세요. 문제 해결 방법을 더 살펴보려면 느린 연결을 단계별로 점검하는 방법을 읽어 보세요. 한 번의 결과로 장기적인 성능을 판단하거나 정상 설정을 반복해서 삭제하지 마세요.

Log를 확인해야 한다면 관련 오류를 한 번만 재현하고 해당 시간대의 기록을 확인해 불필요한 로그가 판단을 방해하지 않도록 하세요. 정보를 제공한 곳에 문제를 설명할 때는 어느 단계에서 실패했는지, 현재 모드, 네트워크 유형, 민감 정보를 제거한 오류 내용을 전달할 수 있습니다. 비밀번호, 전체 구독 주소, 인증 매개변수, 개인 접속 기록은 반드시 삭제하세요. 정보의 유효성은 원본 제공처에 확인하고, 앱 사용 방법은 이 페이지의 해당 단계에서 다시 살펴보세요.

다음 단계: 정상 작동 상태를 유지하고 항목별로 설정하세요.

이 안내에서는 첫 연결까지 다룹니다. DNS, On Demand, Ping, Log 등의 의미와 권장 확인 순서는 Settings 설정 핸드북 →에서 확인하세요. 정보를 다시 가져오려면 첫 번째 단계인 Add Server / Subscribe부터 시작하면 됩니다.