공식 가이드 첫 사용 / 5단계

Shadowrocket 사용 가이드가져오기, 연결 및 확인.

iPhone / iPad 화면을 기준으로 기존 자료부터 시작합니다. 먼저 서버 연결을 확인한 다음 규칙이 요청을 예상대로 처리하는지 점검합니다. 문제가 생기면 같은 순서로 다시 확인합니다.

§ 01ADD SERVER / SUBSCRIBE

서버를 추가하거나 구독을 가져옵니다.먼저 목록에 자료를 표시합니다.

Shadowrocket을 열고 Home으로 이동합니다. 먼저 보유한 자료의 유형을 확인하세요. 서버 목록을 가져오는 전체 링크라면 일반적으로 구독으로 가져오고, 서버 주소와 포트, 프로토콜 및 인증 매개변수가 각각 적혀 있다면 직접 입력하는 것이 적합합니다. 두 방법 중 하나만 선택하면 되며 같은 자료를 중복으로 추가할 필요는 없습니다. 가져오기에 성공했다는 것은 앱이 자료를 읽었다는 뜻일 뿐, 서버를 사용할 수 있다는 의미는 아닙니다.

기존 구독 링크: Add Server에서 Subscribe 선택

Home에서 Add Server를 누르고 Type을 연 다음 Subscribe를 선택합니다. 본인의 전체 구독 링크를 URL 필드에 붙여 넣고 처음과 끝에 공백, 따옴표 또는 줄바꿈이 없는지 확인합니다. 알아보기 쉬운 이름을 입력하고 저장합니다. 링크에 긴 쿼리 매개변수가 포함될 수 있으므로 표시 길이를 줄이려고 물음표 뒤의 내용을 삭제하지 마세요. 서비스 제공자의 웹 로그인 주소를 구독 주소로 사용해서도 안 됩니다.

저장한 뒤 Home으로 돌아가 구독 자료가 로드될 때까지 기다린 다음 SERVER 영역에 해당 그룹과 서버 항목이 표시되는지 확인합니다. 그룹 이름만 보이고 선택할 항목이 없다면 구독 주소와 현재 네트워크부터 확인하세요. 같은 링크를 바로 반복해서 추가하지 마세요. 기존 그룹을 새로 고치려면 해당 그룹에서 업데이트 작업을 실행합니다. 업데이트에 실패하면 비교에 사용할 수 있는 정보를 잃지 않도록 기존 항목을 먼저 보관하세요.

기존 서버 매개변수: Type에 맞는 필드 입력

자료가 단일 서버의 매개변수라면 Add Server로 이동하되, Type은 제공된 프로토콜에 맞춰 선택해야 합니다. Shadowsocks를 예로 들면 Host, Port, Password, Method를 확인해 입력합니다. Host는 서버 주소이며 일반적으로 웹 주소의 경로를 추가할 필요가 없습니다. Port는 자료와 정확히 일치해야 하고 Method도 원래 값에 따라 선택해야 합니다. 이름이 비슷하다는 이유로 추측해서는 안 됩니다.

Type마다 표시되는 인증 필드는 서로 다릅니다. 자료에 기재된 식별 정보, TLS, 전송 방식 또는 기타 옵션을 하나씩 확인하세요. 한 프로토콜의 비밀번호를 다른 프로토콜의 필드에 입력해서는 안 됩니다. QR 코드가 있다면 Scan QR Code를 사용할 수 있으며, 가져온 후에도 Type과 주소를 다시 확인해야 합니다. Import from Cloud JSON은 해당 형식의 자료를 가져올 때만 사용하며 일반 구독 링크를 붙여 넣는 범용 입력란이 아닙니다.

저장한 후 Home으로 돌아가 사용할 서버를 누르고 선택 표시가 해당 항목으로 이동했는지 확인합니다. 여기까지는 ‘자료 추가 및 대상 선택’만 완료된 상태입니다. 다음 단계에서는 요청을 어떤 방식으로 처리할지 정합니다. 구독 관리와 중복 항목 처리에 대한 자세한 내용은 자주 묻는 질문에서 확인할 수 있습니다. 처음 연결하기 전에 모든 그룹을 정리할 필요는 없습니다.

Shadowrocket Add Server 페이지. Type, Host, Port, Password, Method 및 QR 코드 가져오기 항목이 표시됩니다
Add Server: 필드는 Type에 따라 달라지므로 본인의 서버 정보를 기준으로 입력하세요.
§ 02GLOBAL ROUTING / CONFIG

Global Routing 모드를 선택합니다.서버와 규칙을 구분하세요.

서버는 “프록시 연결을 어느 대상으로 보낼지”를 정하고, Global Routing은 “요청을 어떤 방식으로 처리할지”를 정합니다. 두 설정은 서로 다릅니다. Home에서 Global Routing을 누르고 현재 선택된 Config, Proxy, Direct를 확인합니다. “스위치는 켜졌지만 일부 요청이 계속 직접 연결되는” 경우에는 구독을 다시 가져오기보다 여기부터 확인하세요.

Config: 현재 설정의 규칙에 따라 처리

평소 규칙에 따라 트래픽을 분기하려면 Config를 선택합니다. 그런 다음 하단의 Config 페이지로 이동해 사용할 설정 파일이 있고 선택되어 있는지 확인합니다. Config 페이지와 Global Routing의 Config 모드는 서로 관련되어 있지만 역할은 다릅니다. 전자는 설정을 관리하고 후자는 연결 시 규칙에 따라 처리한다는 뜻입니다. 모드만 바꿔도 원격 규칙이 앱에 자동으로 가져와지는 것은 아닙니다.

설정 편집 페이지에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 처음에는 Rule의 내용을 확인하면 되며 연결을 위해 모든 섹션을 동시에 수정할 필요는 없습니다. Add Rule은 규칙을 추가할 때 사용합니다. 변경하기 전에 기존 설정의 사본을 보관하고 원래 규칙 순서를 기록하세요. 출처가 불분명하거나 용도를 알 수 없는 추가 설정은 잠시 수정하지 말고, 연결 문제와 설정 문제를 동시에 발생시키지 않도록 합니다.

규칙은 순서대로 일치 여부를 확인하며, 앞쪽 규칙이 이미 적용되면 일반적으로 뒤쪽 규칙은 같은 요청의 결과를 결정하지 않습니다. 아래 두 줄은 규칙 구조를 보여주는 예시입니다. 첫 줄은 로컬 네트워크 주소에 DIRECT를 사용하고, 두 번째 줄은 최종 일치 항목입니다. 서버 설정이 아니며 기존 파일을 그대로 덮어쓰도록 권장하는 완전한 설정도 아닙니다. PROXY의 의미는 실제 설정에 정의된 정책에 따라 해석해야 합니다.

IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Proxy와 Direct: 경로 지정 및 비교에 사용

Proxy는 일반적으로 처리 가능한 요청을 프록시 경로로 보냅니다. 규칙 선택이 문제의 원인인지 임시로 비교할 때 사용할 수 있지만 모든 앱과 모든 시스템 트래픽이 반드시 서버를 통과한다는 뜻은 아닙니다. Direct는 직접 연결을 비교할 때 사용합니다. Direct 상태라면 연결 스위치가 켜져 있어도 선택한 서버를 요청에 사용 중이라고 단정할 수 없습니다.

처음 문제를 확인할 때는 Proxy로 서버 연결을 비교한 다음 Config로 돌아와 평소 규칙의 동작을 확인할 수 있습니다. 모드를 바꿀 때마다 현재 상태를 기록하세요. 서버 교체, 규칙 변경, 네트워크 전환을 한꺼번에 하지 마세요. 규칙 키워드와 설정 관리에 관한 추가 내용은 자주 묻는 질문을 참고하세요. App Store 이용 및 계정 문제는 App Store 가이드에서 확인할 수 있습니다.

Shadowrocket Config 설정 편집 페이지. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 현재 설정을 확인한 다음 Rule을 살펴보고, 변경 전에 사본을 보관하세요.
§ 03HOME / VPN

연결 스위치를 켭니다.시스템 승인 후 상태를 확인하세요.

Home으로 돌아가 SERVER에서 선택된 서버를 확인한 다음 Global Routing이 방금 정한 모드인지 확인합니다. 스크린샷의 Not Connected는 당시 연결이 설정되지 않은 상태를 나타내며 스위치 위치를 확인하기 위한 초기 상태입니다. 사용 중인 기기의 목록 내용이 완전히 같아야 한다는 뜻은 아닙니다.

Home 상단의 연결 스위치를 켭니다. 처음 실행할 때 시스템에서 VPN 구성을 추가하도록 요청할 수 있습니다. 안내를 읽고 요청이 Shadowrocket에서 시작된 것을 확인한 뒤 시스템의 안내에 따라 기기 인증을 완료합니다. 이 과정은 기기에서 네트워크 연결 구성을 승인하는 단계이며, 시스템 계정 인증 창에 서버 비밀번호를 입력하라는 뜻이 아닙니다. 승인을 완료한 후 앱으로 돌아와 연결 상태가 바뀔 때까지 기다리세요. 안내를 처리하기 전에 스위치를 연속으로 누르지 마세요.

방금 승인을 거부했다면 앱으로 돌아가 연결을 다시 시도하고 시스템에서 새 안내가 표시되는지 확인하세요. 그래도 연결되지 않으면 기기가 조직의 관리 정책으로 제한되어 있는지, 다른 VPN 연결이 실행 중인지 확인합니다. 알 수 없는 시스템 구성을 함부로 삭제하지 마세요. 관리 대상 기기는 먼저 사용 권한을 확인한 뒤 관리 지침에 따라 처리해야 합니다.

스위치가 켜져 있고 앱 상태가 바뀐 다음에 다음 단계로 넘어가 확인합니다. 상태 변화는 로컬 연결 과정이 진행되었음을 뜻하지만 원격 서버 인증 성공, 대상 웹사이트 접속 가능 여부 또는 규칙의 완전한 적용을 단독으로 증명하지는 않습니다. 반대로 스위치가 즉시 꺼지더라도 다시 구매하거나 설치할 필요는 없습니다. 먼저 시스템 안내를 기록하고 승인 및 설정을 확인하세요.

첫 연결 중에는 현재 Wi-Fi 또는 셀룰러 네트워크를 유지하고 새 On Demand 조건은 아직 활성화하지 않는 것이 좋습니다. 먼저 수동으로 연결과 연결 해제를 한 번씩 완료해 기본 절차가 정상인지 확인한 다음 자동 연결을 고려하세요. 이렇게 하면 수동 연결 자체의 실패와 자동 연결 조건으로 인한 반복 전환을 구분하기 쉽습니다.

Shadowrocket Home 페이지. 상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 및 Add Server가 표시됩니다
Home: 서버, Global Routing, 상단 연결 상태 순서로 확인하세요.
§ 04CONNECTIVITY TEST / VERIFY

연결이 적용되는지 확인합니다.테스트 결과와 실제 접속을 구분하세요.

확인할 때 먼저 수치를 비교하기보다 기본 네트워크가 작동하는지 확인합니다. 필요한 경우 Shadowrocket 연결을 해제하고 평소 직접 접속되는 페이지를 열어 Wi-Fi 또는 셀룰러 네트워크 자체가 정상인지 확인하세요. 네트워크에서 웹 로그인을 기다리고 있거나 신호가 끊겼거나 시스템이 앱의 네트워크 접속을 제한하고 있다면 서버 테스트도 실패할 수 있습니다. 이 경우 먼저 기본 연결을 복구해야 합니다.

Home으로 돌아가 Connectivity Test를 사용해 후보 서버를 확인합니다. 테스트는 현재 Test Method에 따라 실행되므로 결과는 특정 테스트 조건에서의 연결 가능성을 나타냅니다. 응답 수치가 표시되더라도 대상 웹페이지, 동영상 또는 다른 서비스가 작동한다는 뜻은 아닙니다. 시간 초과가 발생해도 한 번의 테스트만으로 서버 정보가 영구적으로 만료됐다고 판단하지 마세요. 먼저 테스트 방법을 확인하고 같은 조건으로 한 번 더 테스트합니다.

그다음 연결을 켜 둔 상태로 실제 사용해야 하는 페이지를 열고 새로 로드되는지 확인합니다. 브라우저에 이미 열려 있던 내용만 확인하는 것으로는 충분하지 않습니다. 캐시에서 표시된 내용일 수 있기 때문입니다. 페이지를 새로고침하거나 같은 서비스의 다른 페이지를 열어 보세요. 특정 앱 하나에서만 문제가 발생하면 전체 연결이 끊겼다고 바로 판단하지 말고 해당 앱, 대상 주소 또는 관련 규칙으로 문제 범위를 좁힙니다.

이어서 Global Routing을 확인합니다. Config에서는 대상이 DIRECT, PROXY 또는 다른 정의된 정책에 해당할 수 있습니다. 페이지가 열려도 프록시를 사용했다는 뜻은 아닙니다. 경로를 비교하려면 서버와 네트워크를 유지한 채 Proxy로 잠시 전환해 같은 대상을 테스트한 다음 Config로 복원하세요. Proxy는 정상이고 Config에서만 문제가 발생하면 규칙과 설정을 먼저 확인합니다. 둘 다 실패하면 서버 매개변수, 인증 및 기본 네트워크를 다시 확인하세요.

확인에 성공하면 정상 작동이 확인된 설정을 보관합니다. 이후 규칙이나 On Demand를 변경한 뒤 새 문제가 발생하면 이 기준 설정과 비교할 수 있습니다. 구독 업데이트, 연결 시간 초과 및 규칙 문제는 증상에 따라 자주 묻는 질문에서 확인하세요. 처음 연결할 때 모든 설정을 한꺼번에 변경할 필요는 없습니다.

§ 05SETTINGS / DIAGNOSTICS

일반적인 문제 해결.자료부터 네트워크까지 차례로 확인하세요.

가져온 후 목록이 비어 있거나 서버 수가 갑자기 줄어든 경우

먼저 소개 페이지나 계정 페이지가 아닌 전체 구독 링크를 가져왔는지 확인합니다. 그런 다음 현재 네트워크에서 구독 응답을 받을 수 있는지, 본인의 서비스 상태에서 자료를 가져올 수 있는지 확인하세요. 구독을 업데이트하면 서버 수와 이름이 바뀔 수 있으며 이는 클라이언트 연결 스위치와는 별개의 문제입니다. 기존 그룹을 보관하고 본인의 서비스 제공자에게 링크 유효성을 확인한 뒤 업데이트하세요. 같은 주소를 고치려고 그룹을 반복해서 만들지 마세요.

서버는 표시되지만 연결이 계속 실패하는 경우

해당 항목의 편집 페이지를 열고 Type, Host, Port 및 인증 필드를 하나씩 확인합니다. 복사할 때 포함된 공백, 대소문자 및 누락된 추가 매개변수에 주의하세요. 그런 다음 Home으로 돌아가 실제로 선택된 항목이 방금 확인한 서버인지, 다른 그룹의 이름이 같은 서버인지 확인합니다. 특정 네트워크에서만 문제가 발생하면 허용되는 범위에서 Wi-Fi와 셀룰러 네트워크를 바꿔 비교할 수 있습니다. 다만 판단 근거가 사라지지 않도록 설정을 동시에 변경하지 마세요.

테스트 응답은 있지만 실제 페이지가 열리지 않는 경우

Settings에서 Test Method를 확인해 방금 실행한 테스트가 무엇인지 파악합니다. 테스트 응답만으로 전체 프로토콜 핸드셰이크, DNS 확인 및 대상 서비스 접속이 모두 정상이라고 볼 수는 없습니다. 먼저 명확한 다른 대상을 테스트해 특정 사이트만의 문제인지 전반적인 실패인지 확인한 다음 Config의 규칙과 현재 Global Routing을 확인합니다. Proxy를 임시로 사용했을 때 정상이고 Config에서만 문제가 발생하면 DNS나 TLS 설정을 전부 변경하지 말고 규칙 순서와 최종 일치 항목을 먼저 확인하세요.

연결 상태가 반복해서 바뀌거나 네트워크 전환 후에만 문제가 생기는 경우

On Demand가 활성화되어 있는지, 기기에 VPN 연결에 영향을 줄 수 있는 다른 설정이 있는지 확인합니다. 자동 실행 조건을 제외하려면 원래 값을 기록한 뒤 On Demand를 잠시 비활성화하고 수동 연결 절차를 다시 테스트할 수 있습니다. Wi-Fi에서 셀룰러로 바꾼 뒤 연결이 끊겼다면 전환 전후 상태를 따로 기록하세요. 한 번 다시 연결되어 복구됐다고 해서 기존 규칙에 문제가 있었다고 단정할 수는 없습니다.

추가 확인이 필요한 경우 Diagnostics 사용

Settings의 Diagnostics에서 추가 문제 해결 정보를 확인할 수 있습니다. 오류가 발생한 시간, 대상 및 상태를 먼저 기록한 뒤 관련 진단 정보를 확인하세요. ‘전체 점검’을 위해 Proxy, TCP, UDP 등의 설정을 동시에 변경할 필요는 없습니다. 문제를 외부에 설명할 때는 필요한 오류 내용과 작업 순서만 제공하고 구독 URL, 비밀번호, 인증 식별 정보 등 민감한 내용을 가리세요. 진단 정보도 공유하기 전에 내용을 확인해야 합니다.

위 사항을 확인한 뒤에도 연결되지 않으면 재현 가능한 절차를 정리합니다. 사용한 네트워크 유형, 선택한 Type, 실패한 단계, 시스템이나 앱에 표시된 안내, Direct, Proxy, Config 비교 결과를 포함하세요. 서버 인증이나 구독 내용은 본인의 서비스 제공자에게 확인해야 합니다. 앱 다운로드 및 복구 문제는 App Store 가이드를 참고하고, 다른 사용 방법은 자주 묻는 질문에서 확인할 수 있습니다. 이런 정보가 있으면 단순히 “작동하지 않음”이라고 하는 것보다 원인을 찾기 쉽습니다.

Shadowrocket Settings 페이지. Language, Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정이 포함되어 있습니다
Settings: Test Method와 Diagnostics를 먼저 확인하고, 변경 전에 기존 값을 기록하세요.
Shadowrocket 다운로드