Shadowrocket 공식 매뉴얼 / 사용 가이드

Shadowrocket
가져오기, 연결 및 확인

iPhone / iPad 화면을 기준으로 처음 연결하는 과정을 다섯 단계로 안내합니다. 먼저 서버 연결을 확인하고, 규칙이 요청을 처리하는 방식도 확인합니다.

사용 가능한 서버 항목이 이미 있다면 두 번째 단계부터 시작할 수 있습니다. 아직 설치를 마치지 않았다면 먼저 다운로드 및 처음 열기 안내를 읽고, 시스템 설치 안내와 앱 내 연결 오류를 같은 문제로 취급하지 마세요.

STEP 01 / IMPORT

서버 추가 또는 구독 가져오기

먼저 가지고 있는 정보의 종류를 구분한 다음 해당하는 메뉴를 선택합니다. 서버 하나에는 일반적으로 프로토콜 유형, 서버 주소, 포트, 비밀번호 또는 인증 정보가 포함됩니다. 구독 링크는 여러 서버 항목을 가져오는 데 사용하며, 구성 파일에는 규칙, 정책 및 기타 설정이 들어 있을 수 있습니다. 용도가 서로 다르므로 링크 모양만 보고 판단할 수 없습니다. 보유한 서비스 정보의 안내를 따르고, 구성 파일 주소를 서버 주소란에 입력하거나 웹페이지 소개 주소를 구독 주소로 사용하지 마세요.

Add Server로 직접 입력

Shadowrocket을 열고 Home으로 이동한 다음 오른쪽 위의 추가 메뉴를 눌러 Add Server로 들어갑니다. 먼저 보유한 서버와 같은 프로토콜 유형을 선택한 뒤 주소, 포트 및 인증 정보를 하나씩 입력합니다. 프로토콜 유형에 따라 다음에 표시되는 필드가 달라지므로 유형을 먼저 선택한 다음 내용을 입력해야 합니다. 필드를 이해하기 어렵다는 이유로 이름이 비슷한 다른 프로토콜을 선택해 저장하지 마세요. 서로 다른 프로토콜의 매개변수는 대신 사용할 수 없습니다.

입력할 때 서버 주소에 공백이 잘못 포함되지 않았는지, 포트가 빠짐없이 입력되었는지, 비밀번호와 인증 정보의 대소문자가 그대로 유지되었는지 확인합니다. 서비스 정보에 전송 방식, TLS, 서버 이름 또는 경로가 있다면 원래 안내에 맞춰 입력하세요. 주소와 비밀번호만 입력해서는 안 됩니다. 저장 후 Home으로 돌아와 SERVER 목록에 새 항목이 표시되는지 확인합니다. 이 단계에서는 저장만 완료된 것이며 서버 연결이 확인된 것은 아닙니다.

Subscribe로 기존 구독 가져오기

구독 링크가 있다면 Config 페이지로 이동해 Subscribe에 해당하는 구독 작업 메뉴를 찾고, 안내에 따라 전체 링크를 붙여 넣은 뒤 가져오기를 확인합니다. 링크에는 쿼리 매개변수가 포함되는 경우가 많으므로 복사할 때 전체 내용을 유지하세요. 도메인만 복사하거나 채팅 메시지의 안내 문구를 함께 붙여 넣지 마세요. 시스템에서 클립보드 읽기를 요청하면 클립보드에 이번에 가져올 정보가 들어 있는지 확인한 뒤 허용하세요.

가져오기가 끝나면 Home으로 돌아와 SERVER 목록에 구독에 해당하는 서버 항목이 표시되는지 확인합니다. Config에 구성 파일만 추가되고 Home에 선택 가능한 서버가 없다면, 가져온 콘텐츠의 유형을 먼저 확인하세요. “파일 다운로드 완료”를 “서버 가져오기 완료”로 간주하면 안 됩니다. 화면 배치에 따라 메뉴 위치는 조금 다를 수 있지만, 작업 대상이 서버 구독인지 구성 파일인지 확인하는 것이 중요합니다.

QR 코드 및 가져온 항목 확인

서버 QR 코드가 있다면 Home의 QR 스캔 메뉴에서 Scan QR Code를 사용할 수 있습니다. 처음 사용할 때는 시스템 안내에 따라 카메라 권한을 허용하고, 인식 후에는 분석된 프로토콜과 주소를 확인한 뒤 추가를 완료합니다. QR 코드와 구독 링크에는 인증 정보가 포함될 수 있으므로 공개 토론 공간에 게시하거나 전체 내용을 문제 해결용 스크린샷에 넣지 마세요. 가져온 뒤에는 항목 하나를 명확히 선택해 다음 단계로 진행하고 같은 구독을 반복해서 가져오지 마세요. 중복 항목이 생기면 이후 확인이 더 어려워집니다.

이 단계의 완료 기준은 Home에 예상한 서버가 있고 유형과 필요한 매개변수를 확인할 수 있는 것입니다. 구독 링크를 인식하지 못하거나 업데이트 후 항목이 비어 있는 문제는 다섯 번째 단계에서 가져오기 과정을 따라 확인하세요. 메뉴 위치 차이는 네 가지 가져오기 메뉴 안내에서 확인할 수 있습니다.

STEP 02 / ROUTING

Global Routing 모드 선택

서버 항목을 추가했다면 다음에는 요청을 처리할 방식을 정합니다. Home으로 돌아와 Global Routing을 열고 현재 선택된 항목을 확인합니다. 세 가지 모드는 Config / Proxy / Direct입니다. 이 모드는 요청 처리 방식을 제어하며 연결 품질을 나타내는 세 가지 상태가 아닙니다. 서버 자체의 프로토콜이나 인증 매개변수도 변경하지 않습니다.

Config: 현재 구성에 따라 처리

Config를 선택하면 현재 활성화된 구성의 규칙에 따라 요청을 판단합니다. Config에서 구성 파일 목록에 파일이 있는지만 확인하지 말고 실제로 어떤 파일이 선택되어 있는지 확인하세요. 파일을 기기에 다운로드하는 것과 현재 구성으로 설정하는 것은 별개의 작업입니다. 활성화되지 않은 파일을 편집해도 현재 사용하는 규칙은 바뀌지 않습니다. 처음 사용할 때는 용도를 이해하고 있는 기존 구성을 선택하고 원본 내용을 유지하세요. 한 번에 많은 규칙을 수정하면 문제의 원인을 파악하기 어렵습니다.

규칙은 일반적으로 위에서 아래로 일치 여부를 확인하고, 일치하면 해당 정책을 적용합니다. PROXY는 해당 프록시 정책으로 처리하고, DIRECT는 직접 연결하며, REJECT는 거부합니다. 마지막의 FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 정책이 실제로 어디를 가리키는지는 현재 구성을 함께 확인해야 하므로 “Config 선택”이 “모든 요청이 현재 서버를 거침”을 의미하지는 않습니다.

Proxy: 먼저 서버 경로 확인

Proxy를 선택하면 범위를 명확히 정해 연결을 확인할 수 있습니다. 같은 네트워크에서 서버 하나를 선택하고 확인할 대상을 정해 테스트하세요. Proxy에서는 접속할 수 있지만 Config에서는 불가능하다면, 서버 정보를 바로 다시 입력하기보다 구성 파일, 규칙 및 정책 연결을 우선 확인해야 합니다. 테스트가 끝나면 평소 용도에 맞는 모드로 돌아가 임시 확인 상태를 장시간 유지하지 마세요.

Direct: 로컬 네트워크 결과 구분

Direct를 선택하면 일반 요청은 선택한 프록시 서버로 전달되지 않습니다. 기본 네트워크와 프록시 경로를 비교하는 데는 유용하지만 원격 서버가 정상인지 판단할 수는 없습니다. 요청이 프록시를 거치기를 기대하는데 Direct가 선택되어 있으면 연결 스위치가 켜져 있어도 직접 연결 결과가 나올 수 있습니다. 다음 단계로 넘어가기 전에 선택된 항목을 기록하고, 이후 확인에서도 조건을 명확히 유지하세요.

어디서 시작할지 모르겠다면 Proxy로 기존 서버가 대상 요청을 처리할 수 있는지 먼저 확인한 다음 Config에서 규칙을 점검하세요. 여기서 전체 구성을 작성할 필요는 없습니다. 각 설정의 용도는 Global Routing 설정 안내에서, 프로토콜 매개변수의 의미는 프로토콜 참고 자료에서 확인할 수 있습니다.

STEP 03 / CONNECT

서버 선택 및 연결 스위치 켜기

Home으로 돌아와 SERVER 목록에서 사용할 서버를 명확하게 선택합니다. “방금 가져온 항목”이 “현재 선택된 항목”이라고 단정하지 말고 목록의 선택 표시를 다시 확인하세요. 서버가 많다면 먼저 하나의 항목만 고정해 확인하고 다른 서버로 전환하지 마세요. 그래야 연결 결과를 특정 매개변수와 연결해 판단할 수 있습니다.

연결하기 전에 Connectivity Test로 테스트 결과를 확인할 수 있습니다. 테스트에서 시간 값이 반환되면 해당 테스트 조건에서 응답을 받았다는 뜻입니다. 모든 웹사이트, 앱 및 요청이 반드시 성공한다는 의미는 아닙니다. 시간 초과가 나타나도 테스트 방법과 실제 접속 결과를 함께 살펴봐야 합니다. 테스트 결과는 문제 범위를 좁히는 데 쓰이며 다음 단계의 페이지 접속 확인을 대신하지 않습니다. 표시된 숫자의 크기만 비교하고 서버가 실제 요청을 처리할 수 있는지 확인하지 않는 방식은 피하세요.

서버와 Global Routing을 확인한 뒤 Home의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻습니다. 사용 중인 앱을 확인한 뒤 허용을 선택하고 기기 암호 또는 기타 인증을 완료하세요. 이 권한은 시스템 네트워크 연결 구성을 만드는 데 사용되며 서버 비밀번호 필드와는 다른 정보입니다. 기기 암호를 Add Server에 입력하지 마세요.

권한 허용을 마치면 Home으로 돌아와 스위치가 켜진 상태를 유지하는지 확인하고 시스템 연결 상태를 살펴봅니다. 스위치가 곧바로 꺼지면 구성 오류, 권한 안내 또는 다른 연결이 사용 중인지 먼저 확인하세요. 스위치를 빠르게 반복해서 켜고 끄지 마세요. 다른 VPN 연결이 실행 중이라면 먼저 끈 다음 Shadowrocket으로 돌아와 다시 시도하세요. 시스템 연결 전환으로 잘못 판단하지 않도록 매번 명확한 테스트 상태 하나만 유지합니다.

연결 스위치가 켜져 있다는 것은 클라이언트가 연결 상태에 들어갔다는 뜻이지 원격 인증이 성공했거나 대상 요청이 예상대로 분기되었다는 뜻은 아닙니다. 이때 DNS, 규칙 및 프로토콜 매개변수를 변경하지 말고 현재 조건을 유지한 채 다음 단계에서 실제 요청을 확인하세요. 서버를 바꿔야 한다면 변경 전 항목과 증상을 기록한 뒤 같은 확인 절차를 다시 진행합니다.

STEP 04 / VERIFY

실제 접속 및 규칙 결과 확인

확인은 세 단계로 나뉩니다. 스위치가 켜져 있는지, 대상에 접속할 수 있는지, 대상이 예상한 정책을 따르는지 확인합니다. 시스템 VPN 표시만 보면 시스템 연결이 어떤 형태로든 활성 상태라는 점만 알 수 있습니다. 페이지 하나가 열리는 것만으로도 해당 대상이 원래 직접 연결 가능했을 수 있습니다. 구체적인 접속 결과를 현재 Global Routing, 선택한 서버 및 요청 기록과 함께 판단하세요.

대상 요청을 다시 보내기

정상 동작을 알고 있고 접속 권한이 있는 대상 페이지를 브라우저에서 열어 다시 로드한 뒤 결과를 기다립니다. 이미 로드된 페이지나 앱 캐시만 확인하지 말고 새 요청을 보내세요. 처음 확인할 때는 같은 네트워크, 같은 서버 및 같은 대상을 유지하면서 페이지가 정상적으로 응답하는지, 오래 대기하는지, 명확한 오류가 나타나는지 기록합니다. 결과에 따라 문제를 확인할 방향이 달라집니다.

Data에서 요청 경로 확인

Shadowrocket으로 돌아와 Data에서 이번 접속에 해당하는 요청 기록이나 연결 정보를 확인하고 요청 시간과 대상 도메인으로 찾습니다. 데이터 양이 바뀌었는지만 보지 말고 실제로 사용된 정책, 확인 가능한 규칙 일치 결과 및 서버 연결을 살펴보세요. 기기 백그라운드에서도 요청이 발생할 수 있으므로 전체 트래픽 증가만으로 방금 테스트한 대상이 프록시를 거쳤다고 판단할 수 없습니다.

Config를 사용 중인데 기록에 DIRECT가 표시되고 PROXY를 예상했다면 현재 활성화된 구성의 규칙을 확인하세요. 먼저 대상 도메인이 규칙과 일치하는지 확인한 다음 앞에서 먼저 일치한 항목이 있는지 살펴보고 마지막으로 정책 연결을 확인합니다. 한 페이지가 여러 도메인에 요청을 보낼 수 있어 첫 페이지 문서, 이미지 및 API가 반드시 같은 규칙을 따르는 것은 아닙니다. 페이지 주소에 해당하는 규칙만 바꿔도 모든 하위 요청이 바뀌지는 않습니다.

변수 하나씩 비교해 범위 좁히기

Config에서 접속이 실패하면 서버는 그대로 두고 잠시 Proxy로 전환한 뒤 요청을 다시 보냅니다. Proxy는 성공하고 Config는 실패한다면 규칙과 현재 구성을 우선 확인합니다. 둘 다 실패한다면 서버 매개변수, 네트워크 연결 또는 대상 자체를 점검합니다. 비교가 끝나면 필요한 모드로 복원하고 접속을 다시 확인하세요. 네트워크, 서버 및 구성을 동시에 전환하면 정상으로 돌아와도 어떤 변경이 원인이었는지 알 수 없습니다.

완료 기준은 실제 대상에 예상대로 접속할 수 있고 요청 기록의 정책도 예상과 일치하는 것입니다. 다른 사람에게 문제를 설명해야 한다면 필요한 대상의 증상, 모드 및 오류 문구만 기록하고 서버 인증 정보와 구독 링크는 숨기세요. 규칙 순서에 관한 추가 설명은 사용자 지정 규칙 및 FINAL 대체 처리 안내를 읽어보세요.

STEP 05 / TROUBLESHOOT

실패한 단계에 따라 하나씩 확인

문제가 생기면 먼저 어느 단계에서 멈췄는지 확인합니다. 구독을 가져오지 못했는지, 서버 테스트가 실패했는지, 스위치가 켜진 상태를 유지하지 못하는지, 아니면 스위치는 정상인데 대상에 접속할 수 없는지 구분하세요. 각 단계의 해결 방법을 섞어 적용하지 마세요. 특히 시간 초과가 발생했다고 모든 구성을 삭제하거나 앱을 다시 설치하지 마세요. 기존 비교 조건을 잃게 되며 사용할 수 없는 서버 정보도 복구되지 않습니다.

기본 네트워크 및 구독 가져오기

먼저 연결을 잠시 끄고 현재 Wi-Fi 또는 셀룰러 네트워크 자체가 작동하는지 확인합니다. 로그인이 필요한 네트워크라면 먼저 로그인하세요. 기본 네트워크가 정상이면 구독 링크가 완전한지, 아직 유효한지, 가져오기 과정에서 오류가 반환되었는지 살펴봅니다. 가져온 항목이 비어 있다면 서비스 정보가 변경되었는지, 반환된 콘텐츠가 지원되는 형식인지 확인합니다. 새로 고침에 실패하더라도 기존에 사용할 수 있는 항목은 보존하고 연속으로 반복 추가해 복제 항목을 만들지 마세요.

구독 업데이트는 새로운 서버 목록을 가져오는 작업이고 Connectivity Test는 항목의 연결 상태를 시험하는 작업입니다. 두 작업은 서로 다릅니다. 업데이트에 성공했지만 서버가 계속 시간 초과되면 서버를 추가로 확인해야 합니다. 업데이트가 실패했더라도 기존 항목에 연결할 수 있다면 모든 연결이 실패했다고 볼 수 없습니다. 업데이트 메뉴와 실패 원인은 구독 수동 및 자동 업데이트 안내에서 확인할 수 있습니다.

서버 시간 초과 또는 인증 실패

Add Server의 편집 화면으로 돌아가 보유한 서비스 정보에 따라 프로토콜, 주소, 포트 및 인증 필드를 하나씩 확인한 다음 TLS, 서버 이름, 전송 방식 및 경로를 살펴봅니다. 선택 사항처럼 보여도 서버에서 실제로 요구하는 필드를 임의로 생략하지 마세요. 시스템 시간이 크게 어긋났다면 올바른 시간으로 되돌린 후 테스트합니다. 시간 차이가 인증서 또는 인증 판단에 영향을 줄 수 있습니다. 필요한 경우 사용할 권한이 있는 다른 네트워크에서 같은 서버를 테스트해 로컬 네트워크 차이인지 구분하세요.

테스트가 계속 실패한다면 보유한 서비스 제공자에게 서버 상태와 매개변수 변경 여부를 문의하세요. 증상과 오류 문구만 제공하고 전체 링크나 인증 정보는 공개하지 마세요. 비밀번호 변경이나 프로토콜 전환은 분명한 근거가 있을 때만 진행해야 하며, 무작위로 반복 변경해 작동하는 조합을 찾지 마세요. 자세한 확인 순서는 노드 시간 초과 및 연결 실패 확인 목록에서 볼 수 있습니다.

스위치는 정상이지만 접속 결과가 예상과 다름

먼저 Global Routing에서 실수로 Direct를 선택하지 않았는지 확인한 뒤 Config에서 현재 활성화된 파일을 확인합니다. Proxy는 정상이고 Config에 문제가 있다면 “대상 요청 → 처음 일치한 규칙 → 정책 연결” 순서로 점검하세요. 특정 대상만 문제가 있다면 해당 대상의 도메인 확인과 요청 기록을 살펴보고 모든 DNS 설정을 바로 변경하지 마세요. 변경 전에 기존 값을 기록하고 한 번에 하나만 수정한 다음 같은 요청을 다시 보냅니다.

페이지 문서는 열리지만 이미지나 API가 실패한다면 페이지 전체를 단일 연결로 취급하지 말고 실패한 리소스에 해당하는 도메인을 각각 확인하세요. 시스템 권한 허용을 마치지 않았다면 먼저 권한 문제를 해결합니다. 스위치는 안정적으로 켜져 있지만 원격에서 응답하지 않는다면 서버와 요청 경로를 확인하세요. 여러 설정을 한꺼번에 변경하는 것보다 문제를 정확한 계층에 한정하는 편이 복구와 재현에 유리합니다.

테스트를 마치고 사용 가능한 상태 유지

연결이 복구되면 현재 서버, Global Routing 및 활성화된 구성이 계속 사용할 조합인지 확인하고 문제를 찾으려고 추가한 임시 변경 사항은 되돌립니다. 연결이 필요하지 않을 때는 Home으로 돌아와 스위치를 끄세요. 다시 사용할 때 서버 선택을 확인한 뒤 스위치를 켜면 됩니다. 메뉴 및 권한 관련 문제는 FAQ에서, 프로토콜 필드의 자세한 내용은 프로토콜 참고 자료에서 확인할 수 있습니다. 처음 연결할 때 모든 고급 설정을 한꺼번에 바꿀 필요는 없습니다.