공식 매뉴얼 · 시작하기

Shadowrocket 사용법

기존 설정 가져오기 → Global Routing → 첫 연결 → 확인 및 문제 해결

이 페이지는 iPhone과 iPad의 실제 조작 순서에 따라 구성했습니다. 기존 설정으로 먼저 연결을 완료한 다음 규칙 조정과 주문형 연결을 살펴보세요. 프로토콜 원리와 매개변수 설명은 기술 참고 자료에서 다루며, 첫 사용 단계에서는 자세히 설명하지 않습니다.

인터페이스 항목은 영어 원문 그대로 표기합니다. 기기에 따라 메뉴 위치가 조금 다를 수 있으므로 이름을 기준으로 찾아보세요. 이 페이지에는 앱 인터페이스 이미지가 없습니다.

단계 01 · 설정 준비

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 먼저 Home에 머뭅니다. 아직 연결 스위치는 켜지 마세요. 보유한 정보가 서버 목록을 업데이트하는 구독 링크인지, 프로토콜·주소·포트·인증 정보가 명시된 개별 서버 매개변수인지 확인합니다. 두 정보는 입력 위치가 다릅니다. 구독 링크를 서버 주소로 입력할 수 없으며, 개별 서버 공유 정보가 반드시 구독인 것도 아닙니다.

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

Home 오른쪽 상단의 추가 버튼을 탭해 Add Server로 이동한 다음, 유형 선택에서 Subscribe를 선택합니다. 본인의 전체 구독 링크를 URL 필드에 붙여 넣고 알아보기 쉬운 이름을 입력한 뒤 저장합니다. 붙여 넣기 전후에 링크에 공백이나 줄바꿈이 추가되지 않았는지 확인하세요. 특히 물음표 뒤의 쿼리 매개변수는 그대로 유지해야 합니다. 구독 식별에 필요한 값일 수 있어 일부를 삭제하면 가져오기에 실패할 수 있습니다.

저장 후 Home으로 돌아가 구독 내용을 가져올 때까지 기다립니다. 정상적으로 완료되면 구독 그룹과 그 안의 서버 항목이 표시됩니다. 구독 이름만 나타났다고 해서 연결 가능한 서버를 가져온 것은 아닙니다. 목록이 비어 있거나 오류가 표시되거나 내용이 계속 나타나지 않는다면 먼저 가져오기 결과를 확인하세요. 연결 스위치를 반복해서 켜는 것으로 해결하려 하지 마세요. 처음 가져올 때는 현재 네트워크에서 구독 주소에 접속할 수 있어야 하는 경우가 많습니다.

구독 링크는 민감 정보로 취급하고 공개 댓글이나 스크린샷에 노출하지 마세요. 구독을 업데이트하면 원격 목록을 다시 읽어 항목이 추가·삭제·교체될 수 있습니다. 특정 서버 매개변수를 변경하려면 먼저 구독에서 관리하는 항목인지 확인하세요. 업데이트 후 수동 변경 사항이 덮어써질 수 있습니다.

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

개별 서버 매개변수를 받았다면 마찬가지로 Add Server로 이동하되, 자료에 지정된 프로토콜 유형을 선택합니다. 예를 들어 Shadowsocks, Trojan, WireGuard가 있습니다. 필드 이름에 따라 서버 주소와 포트를 입력한 다음 해당 프로토콜에 필요한 비밀번호, 식별자 또는 키를 입력합니다. 프로토콜마다 인증 필드가 다르므로 서로 바꿔 쓸 수 없습니다. 주소가 같다는 이유만으로 다른 프로토콜을 선택하지 마세요.

자료에 TLS, SNI 또는 전송 관련 항목이 있다면 각각 원본과 동일하게 입력합니다. 서버 주소는 연결에 사용되고 SNI는 TLS에서 서비스 이름을 식별하는 데 사용됩니다. 일부 설정에서는 두 값이 다를 수 있으므로 임의로 같게 바꾸지 마세요. 항목을 이해하기 어렵다면 추측해서 입력하지 말고 프로토콜 기술 참고 자료를 확인하세요.

저장한 뒤 Home으로 돌아와 SERVER 목록에서 사용할 항목을 선택하고, 선택 표시가 원하는 서버에 있는지 확인합니다. 기록이 여러 개라면 이름이 비슷해도 매개변수는 다를 수 있습니다. 알아보기 쉽도록 이름을 지정하되 비밀번호는 이름에 입력하지 마세요. 이제 서버 정보 준비가 끝났습니다. 다음 단계에서는 트래픽에 적용할 라우팅 모드를 정합니다.

단계 02 · 트래픽 정책 결정

Global Routing: 연결 모드 선택

Home에서 Global Routing을 찾아 엽니다. 이 안내에서는 세 가지 기본 모드인 Config, Proxy, Direct를 살펴봅니다. 각 모드는 요청에 적용할 정책을 결정하며 서버 가져오기 여부와는 별개입니다. 목록에 서버가 있어도 모든 요청이 해당 서버를 사용하는 것은 아닙니다.

모드 동작 방식 입문 단계에서의 사용 사례
Config 현재 선택된 설정의 규칙에 따라 정책을 적용합니다. 규칙 설정을 준비했고 내용을 이해한 경우
Proxy 일반적으로 요청을 현재 프록시 정책에 전달합니다. 기존 서버가 요청을 정상적으로 처리하는지 먼저 확인할 때
Direct 직접 연결 정책을 사용합니다. 직접 연결 경로를 확인하거나 일시적으로 직접 연결로 되돌릴 때

처음 사용하고 규칙 설정이 아직 없다면 먼저 Proxy를 선택해 현재 서버와 로컬 네트워크를 중심으로 확인할 수 있습니다. Proxy를 장기간 사용하려면 반드시 선택해야 하는 것은 아니며, 모든 상황에서 모든 시스템 트래픽이 프록시를 거친다는 뜻도 아닙니다. 선택한 다음 Home으로 돌아가 현재 서버를 다시 확인하세요. 다른 항목을 테스트하는 일을 방지할 수 있습니다.

Config를 사용하려면 먼저 Config 페이지로 이동해 원하는 설정이 있는지 확인하고 현재 설정으로 선택한 다음 Global Routing으로 돌아와 Config를 선택합니다. Config 페이지에서는 설정 파일을 관리하고, 라우팅 선택의 Config는 설정 규칙에 따라 트래픽을 처리한다는 뜻입니다. 두 항목의 이름은 관련이 있지만 파일이 존재하는 것과 해당 파일을 사용 중인 것은 다릅니다.

서버 구독과 규칙 설정도 구분해야 합니다. Subscribe로 가져오는 내용은 일반적으로 서버 목록을 관리하는 데 쓰이며, 이것만으로 분류 규칙까지 준비되었다고 볼 수는 없습니다. 연결 매개변수만 있다면 먼저 Proxy에서 연결을 확인한 뒤 규칙을 설정하세요. 기존 설정에서 정책 이름을 참조한다면 해당 이름이 실제로 사용 가능한 정책과 연결되는지도 확인해야 합니다.

Direct는 문제를 점검할 때 비교 기준으로 쓸 수 있지만 프록시 서버의 작동 여부를 증명하지는 않습니다. Direct로 전환한 뒤 페이지가 열렸다면 이번에는 직접 연결이 성공했다는 뜻일 뿐입니다. 규칙 순서, 최종 정책, Scene 설정에 관한 자세한 내용은 프록시 모드 안내에서 확인하세요. 익숙하지 않은 용어는 용어집을 참고할 수 있습니다.

단계 03 · 연결하기

Home: 스위치를 켜고 승인 완료

Home으로 돌아와 상단 연결 스위치를 켜기 전에 현재 서버, Global Routing, 네트워크를 빠르게 확인합니다. 비밀번호 입력이나 매개변수 편집 중이라면 먼저 저장하고 편집 화면을 닫으세요. 첫 연결을 확인할 때는 같은 네트워크를 유지하는 것이 좋습니다. 연결하는 동안 Wi-Fi와 셀룰러 네트워크를 오가면 실패 원인을 파악하기 어려워집니다.

연결 스위치를 켜면 처음 사용할 때 시스템에서 VPN 구성을 추가하라는 요청이 표시될 수 있습니다. 이는 Apple 시스템이 해당 네트워크 구성을 설정하기 위한 승인 절차입니다. 요청을 Shadowrocket이 시작했는지 확인한 뒤 시스템 안내에 따라 허용하고 기기에서 요구하는 인증을 완료합니다. 시스템 구성 승인과 구독 서버 인증은 별개입니다. 전자가 완료되어도 후자의 매개변수가 올바르다는 뜻은 아닙니다.

방금 시스템 요청을 취소했더라도 서버를 다시 가져올 필요는 없습니다. 앱으로 돌아가 연결을 직접 다시 켜고 실제 시스템 안내에 따라 진행합니다. 기기가 조직에서 관리되는 경우 관리 정책에 따라 권한이 제한될 수 있습니다. 이때는 기기 관리 요구 사항을 확인하고, 알 수 없는 관리 구성을 삭제해 해결하려 하지 마세요. VPN 구성을 추가할 수 없는 문제는 시스템 권한 단계에서 발생한 것이므로 서버 시간 초과와 구분해 점검해야 합니다.

승인이 끝나면 Home으로 돌아와 연결 상태가 유지되는지 확인합니다. 스위치가 바로 꺼지거나 오류가 표시되거나 상태가 오랫동안 안정되지 않으면 안내 문구를 기록하고 스위치를 빠르게 반복해서 전환하지 마세요. 시스템 상태 영역의 VPN 표시는 기기와 시스템의 표시 방식에 따라 다를 수 있습니다. 표시가 나타나더라도 네트워크 구성이 연결된 상태라는 뜻일 뿐이며, 다음 단계에서 실제 접속을 확인해야 합니다.

첫 테스트를 반복해 확인할 수 있도록 일단 On Demand 설정은 그대로 두고, 수동으로 켜기·접속·끄기를 한 번 완료하세요. 이전에 주문형 연결을 활성화했다면 수동으로 꺼도 조건에 따라 다시 연결될 수 있습니다. 이 경우 스위치 문제로 판단하기 전에 On Demand 설정을 확인하세요. 자동 연결 조건을 변경하려면 기본 연결 확인을 마친 다음 진행할 수 있습니다.

iPad에서도 같은 순서로 진행합니다. 먼저 선택된 항목과 라우팅 모드를 확인한 뒤 시스템 승인을 완료하세요. 분할 화면이나 가로 모드에서는 메뉴 위치가 달라질 수 있지만 단계 간 순서는 같습니다. 이제 연결이 설정되었으므로 요청이 완료되는지, 결과가 선택한 정책에 맞는지 확인합니다.

단계 04 · 결과 확인

Connectivity Test: 연결 작동 여부 확인

먼저 Home에서 Connectivity Test를 찾아 실행하고 현재 서버의 결과를 확인합니다. 테스트 결과는 테스트 방식, 대상, 당시 네트워크에 따라 달라집니다. 연결 가능으로 표시되어도 모든 웹사이트에 접속할 수 있다는 뜻은 아니며, 한 번 시간 초과가 발생했다고 모든 요청이 실패하는 것도 아닙니다. 테스트는 초기 단서를 제공하지만 유일한 판단 기준으로 삼아서는 안 됩니다.

그다음 브라우저를 열어 익숙하고 접속 권한이 있는 HTTPS 페이지에 접속합니다. 캐시된 페이지만 보고 판단하지 않도록 새 요청을 보내세요. 페이지를 새로 고치거나 다른 페이지를 열어 본문과 이미지가 모두 로드되는지 확인할 수 있습니다. 일부 리소스만 실패했다면 페이지 전체가 열리지 않는 경우와 구분하고, 모든 연결 매개변수를 즉시 변경하지 마세요.

현재 Proxy를 사용 중이라면 방금 선택한 서버가 실제로 사용되는지 먼저 확인하고 접속 결과와 함께 연결 상태를 점검합니다. Config를 사용 중이라면 본인의 규칙에 따라 직접 연결되어야 하는 대상과 프록시를 사용해야 하는 대상을 각각 테스트합니다. 두 대상 모두 접속되더라도 이는 첫 단계의 확인일 뿐입니다. 각 대상에 적용된 정책이 예상과 일치하는지도 확인해야 합니다.

앱에서 연결 또는 요청 기록을 볼 수 있는 메뉴를 열어 테스트 대상의 도메인, 적용된 정책, 오류 정보를 확인합니다. 화면에 일치한 규칙 정보가 표시된다면 함께 점검하세요. 규칙은 일반적으로 일치 순서와 최종 정책에 영향을 받습니다. 설정에 규칙이 있다고 해서 이번 요청에 반드시 적용되는 것은 아닙니다. 분류 결과를 확인할 때는 페이지가 열리는지만 보는 것보다 기록을 확인하는 편이 유용합니다.

테스트할 때는 한 번에 조건 하나만 변경합니다. 예를 들어 서버와 대상을 그대로 두고 라우팅 모드만 바꾸거나, 모드와 대상을 유지한 채 로컬 네트워크만 변경합니다. 변경 전후 결과를 기록해야 어떤 조건이 연결에 영향을 주었는지 알 수 있습니다. 서버, 네트워크, 설정을 한꺼번에 바꾸면 접속이 복구되더라도 다음에 같은 문제가 발생했을 때 참고할 만한 결론을 얻기 어렵습니다.

DOMAIN-SUFFIX, GEOIP, FINAL의 의미를 알고 싶다면 먼저 규칙 키워드 및 인터페이스 용어를 확인하세요. 처음부터 규칙을 직접 작성할 필요는 없습니다. 작동하는 기본 설정을 유지한 채 필요한 항목을 하나씩 추가하면 관리하기 쉽습니다.

단계 05 · 실패 단계 찾기

흔한 실패 원인: 순서대로 범위 좁히기

문제가 발생하면 먼저 가져오기, 승인, 연결, 접속 중 어느 단계에서 실패했는지 판단합니다. 처음부터 모든 설정을 삭제하거나 모든 실패를 서버 문제로 단정하지 마세요. 복구할 수 있도록 현재 자료를 보존하고 네트워크 유형, 라우팅 모드, 테스트 대상, 오류 안내를 기록한 뒤 아래 순서대로 확인합니다.

구독을 가져올 수 없거나 가져온 뒤 목록이 비어 있음

먼저 로컬 네트워크에 정상적으로 접속할 수 있는지 확인한 뒤 구독 링크가 완전하고 유효한지 확인합니다. 서버에서 로그인 페이지, 오류 안내, 일반 웹페이지를 반환하는 경우 주소가 열리더라도 가져오기에 적합한 내용이라는 뜻은 아닙니다. 본인의 서비스 제공자에게 링크의 용도와 유효 상태를 확인하세요. 링크를 공개하거나 인증 매개변수를 임의로 삭제·수정하지 마세요. 기존 목록을 사용할 수 있다면 다시 가져오지 못할 경우를 대비해 그대로 보존합니다.

서버는 표시되지만 연결 시간 초과 또는 인증 실패

해당 항목의 편집 화면을 다시 열고 원본 정보와 대조해 프로토콜, 주소, 포트, 인증 필드를 확인합니다. 포트에 공통으로 적용되는 고정값은 없으며 비밀번호의 대소문자나 앞뒤 공백도 인증에 영향을 줄 수 있습니다. TLS를 사용하는 설정에서는 SNI, 인증서 확인 설정, 기기의 날짜와 시간도 확인하세요. 시간이 크게 틀리면 인증서 유효성 판단에 영향을 줄 수 있습니다. 인증서 확인을 낮추는 방법을 기본 해결책으로 삼지 마세요. 매개변수가 불분명하다면 원본 정보를 다시 확인하세요.

같은 설정이 특정 로컬 네트워크에서만 실패한다면 여건이 되는 경우 다른 네트워크로 바꿔 다시 테스트하되 서버와 라우팅 모드는 그대로 유지합니다. 결과만으로는 두 네트워크 조건에 차이가 있다는 점만 알 수 있으므로 오류 안내도 함께 확인해야 합니다. 인증 실패가 계속되거나 서버가 연결을 거부한다면 본인의 서비스 제공자에게 서버 상태를 확인하세요. 클라이언트에서 반복해서 저장해도 서버 측 문제는 해결되지 않습니다.

연결은 되었지만 웹사이트 접속 결과가 예상과 다름

먼저 Global Routing을 확인합니다. Direct가 선택되어 있다면 이번 요청은 프록시 정책으로 처리되지 않았습니다. Config가 선택되어 있다면 예상한 설정이 현재 활성화되어 있는지, 요청에 어떤 정책이 적용되었는지 확인합니다. Proxy에서는 접속되지만 Config에서는 실패한다면 모든 서버 매개변수를 바로 교체하기보다 규칙, 정책 참조, 관련 DNS 조건을 먼저 점검하세요.

모든 대상에 접속할 수 없다면 기본 네트워크와 서버 연결부터 다시 확인합니다. 특정 대상만 실패한다면 해당 대상의 일치 규칙, 이름 해석, 서비스 상태를 확인하세요. 사용자 지정 DNS 설정이 있다면 기존 값을 기록한 뒤 하나씩 검증하고 출처를 모르는 설정을 여러 개 한꺼번에 추가하지 마세요. 도메인 이름 해석과 연결 경로의 관계는 프로토콜 매개변수 및 기술 참고 자료에서 더 확인할 수 있습니다. 이 페이지에서는 먼저 점검 범위를 최소화합니다.

다시 확인할 수 있도록 결과 기록하기

문제 해결 기록에는 현상과 필요한 조건만 남기면 됩니다. 예: “Wi-Fi에서 Proxy 사용, 대상 페이지 본문이 로드되지 않고 Connectivity Test 시간 초과”. 기록을 공유하기 전에 구독 링크, 비밀번호, 키 및 기타 인증 정보를 가리세요. 마지막으로 작동했던 설정으로 되돌린 뒤 항목을 하나씩 다시 변경합니다. 변경의 영향을 판단할 수 없다면 설정을 더 쌓지 말고 멈추세요.

이 페이지의 절차를 마치면 어떤 정보를 가져왔는지, 현재 어떤 서버를 선택했는지, 어떤 라우팅 모드를 사용 중인지, 요청을 어떻게 확인했는지 설명할 수 있어야 합니다. 이후 트래픽을 분류하려면 프록시 모드를, 프로토콜 항목을 확인하려면 기술 참고 자료를 읽어보세요. 연결 확인과 고급 설정을 나누어 진행하면 다음에 구독을 업데이트하거나 기기를 바꿀 때도 같은 점검 순서를 활용할 수 있습니다.