공식 안내서 / 첫 설정

Shadowrocket 시작하기

구독 가져오기 → Global Routing → 연결 확인

순서대로 연결을 완료한 뒤 규칙과 자동 연결을 설정하세요. 이 안내는 주로 iPhone과 iPad의 조작 과정을 다루며, 앱에서 찾아보기 쉽도록 화면의 항목명은 영어 그대로 표기합니다.

  • 기존 구독 또는 서버 정보
  • 5단계 진행 순서
  • 공식 App Store 스크린샷 참고

시작 전 확인: App Store에서 Shadowrocket을 설치했고 본인의 구독 링크나 서버 정보를 보유해야 합니다. 이 사이트는 노드나 구독을 제공하거나 판매하거나 추천하지 않습니다. 앱은 한 번 구매하면 이용할 수 있지만, 회선 요금제가 아니며 앱을 구매해도 서버 정보가 자동으로 생성되지는 않습니다.

아직 설치하지 않았다면 먼저 다운로드 안내 및 정품 확인을 참고하세요. 시스템 요구 사항은 App Store 페이지의 안내를 기준으로 합니다. 구독 링크와 서버 인증 정보는 민감한 자료이므로 공개 스크린샷이나 공개 메시지에 포함하지 마세요.

단계 01 / 정보를 목록에 추가하기

Add Server와 Subscribe 가져오기

수동 입력 정보, 구독 링크, QR 코드는 서로 다른 형식입니다. 보유한 정보에 맞는 메뉴를 선택하세요.

Add Server: 서버 하나 입력하기

Shadowrocket을 열고 Home으로 이동해 SERVER 영역에서 Add Server를 찾습니다. Add Server 화면에서 먼저 Type을 확인하세요. Type에 따라 입력해야 할 항목이 달라지므로 주소가 같다는 이유만으로 기본 유형을 그대로 사용하면 안 됩니다. 보유한 정보에 Shadowsocks, VMess, VLESS 또는 다른 프로토콜이 명시되어 있다면 해당 Type을 선택하고 항목을 하나씩 확인하세요. 유형을 추측하며 반복해서 시도하지 마세요.

Host에는 보유한 정보에 기재된 서버 도메인이나 주소를, Port에는 해당 포트 번호를 입력합니다. Password와 Method 등의 항목이 표시되는지, 어떻게 입력하는지는 선택한 프로토콜에 따라 다릅니다. 스크린샷은 해당 항목이 표시되는 화면의 한 예이며, 모든 Type에 같은 값이 필요한 것은 아닙니다. 구독 링크 전체를 Host에 입력하거나 웹 주소의 경로를 서버 도메인으로 사용하지 마세요. 복사한 뒤 앞뒤 공백과 줄바꿈을 확인하고 저장한 다음 Home으로 돌아갑니다.

정보에 TLS, Server Name, 전송 방식, 경로 등이 포함되어 있다면 해당 옵션도 확인하세요. 주소와 포트가 정확해도 연결 대상만 입력된 것이며 인증 및 전송 설정이 모두 완료된 것은 아닙니다. 특정 항목이 아직 익숙하지 않다면 원래 정보에 있는 값을 그대로 사용하세요. 프로토콜 항목에 관한 자세한 내용은 기술 참고의 프로토콜 설명을 확인하세요.

Subscribe: 기존 구독 링크 가져오기

전체 구독 링크가 있다면 Config에서 Subscribe를 열어 링크를 추가하고 저장한 뒤 구독을 업데이트합니다. 화면 상태에 따라 버튼 위치가 조금 다를 수 있으므로 Subscribe라는 메뉴명을 찾아보세요. 구독은 서버 항목을 읽어 관리하는 데 사용되며, 구성 파일에는 규칙과 기타 설정이 포함될 수 있습니다. 이름에 모두 ‘구성’이라는 말이 들어간다고 해서 서로 대체할 수 있는 것은 아닙니다.

업데이트가 끝나면 Home으로 돌아와 SERVER 영역에 해당 항목이 표시되는지 확인합니다. 구독 이름이 보인다고 해서 구독 내용까지 정상적으로 읽힌 것은 아닙니다. 그룹에 선택할 수 있는 서버가 실제로 있는지 확인하세요. 결과가 비어 있거나 업데이트 오류가 발생하면 링크가 온전한지, 아직 유효한지, 현재 네트워크에서 내용을 불러올 수 있는지 먼저 확인합니다. 아직 연결 단계가 아니므로 Global Routing이나 DNS를 먼저 변경할 필요는 없습니다.

Scan QR Code 및 클립보드 정보

정보가 QR 코드로 제공된다면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용하세요. 인식한 뒤 유형과 항목을 확인하고 저장합니다. 공유 링크가 있다면 앱에서 제공하는 클립보드 가져오기 안내나 메뉴를 사용할 수도 있습니다. 클립보드에는 가져올 전체 내용만 있어야 하며 설명 문구를 함께 넣지 마세요. Import from Cloud JSON은 해당 형식의 정보를 가져오는 메뉴로, 모든 링크에 사용할 수 있는 범용 가져오기 메뉴가 아닙니다.

이 단계의 완료 기준: Home의 SERVER 영역에 보유한 정보에 해당하는 항목이 있고, 항목을 열어 유형과 주소를 확인할 수 있어야 합니다. 이후 테스트에 사용할 서버를 하나 정하세요. 어떤 설정이 적용되는지 헷갈리지 않도록 출처를 알 수 없는 구성을 여러 개 한꺼번에 가져오지 마세요.

Shadowrocket의 Add Server 화면에 표시된 Type, Host, Port, Password, Method와 Scan QR Code 및 Import from Cloud JSON 메뉴
Add Server: Type을 먼저 선택한 뒤 해당 유형에 필요한 항목을 확인하세요.

단계 02 / 요청 처리 방식 정하기

Global Routing 모드 선택

Config / Proxy / Direct

정보를 가져온 뒤 Home으로 돌아와 Global Routing을 탭하고 현재 선택된 모드를 확인합니다. SERVER 목록에서는 사용할 서버를 선택하고, Global Routing에서는 요청 처리 방식을 정합니다. 두 설정은 서로 독립적입니다. 서버를 선택해도 모든 요청이 해당 서버를 통과하는 것은 아니며, Direct로 전환해도 저장된 서버 정보가 삭제되지는 않습니다.

Config: 구성 규칙에 따라 처리

일상적으로 프록시와 직접 연결 요청을 구분하려면 Config를 선택하세요. 먼저 Config로 이동해 사용할 구성 파일이 선택되어 있는지 확인합니다. 목록에 저장되어 있기만 하고 실제로 선택되지 않은 상태와 구분해야 합니다. 구성 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 각각 다른 설정 영역입니다. 이번에는 Rule만 확인하고, 첫 연결을 위해 다른 기능을 하나씩 활성화할 필요는 없습니다.

Rule의 규칙은 일반적으로 순서대로 확인합니다. 요청이 규칙에 일치하면 해당 규칙에 지정된 정책을 적용합니다. DOMAIN-SUFFIX는 도메인 접미사를 기준으로 일치 항목을 찾고, FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 아래 예시는 ‘지정한 도메인은 프록시로, 나머지는 직접 연결’의 의미만 보여줍니다. example.com은 예시 도메인이지 서버 주소나 실제로 사용해야 하는 규칙 대상이 아닙니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

직접 규칙을 추가하려면 구성 편집 화면에서 Rule과 Add Rule을 찾아 대상 도메인과 정책을 입력하고, 구체적인 규칙을 FINAL 앞에 배치합니다. 현재 구성의 정책 이름과 연결 대상도 확인해야 합니다. 텍스트를 복사하는 것만으로 프록시 서버가 선택되는 것은 아닙니다. 이미 사용할 수 있는 구성이 있다면 첫 연결 확인이 끝날 때까지 그대로 두고, 이후 항목별로 조정하세요.

Proxy와 Direct: 비교를 위한 모드

Proxy를 선택하면 현재 프록시 경로를 통해 요청을 처리합니다. Config의 분류 규칙이 문제의 원인인지 임시로 확인할 때 유용합니다. Direct를 선택하면 요청이 선택한 프록시 서버를 거치지 않으므로 현재 네트워크에서 대상에 직접 접속할 수 있는지 확인할 수 있습니다. Direct에서 웹사이트가 열린다고 프록시 서버가 정상이라는 뜻은 아니며, Proxy에서 열린다고 Config의 특정 규칙이 정확하다는 뜻도 아닙니다.

이 안내에서는 모드를 하나로 정해 다음 단계의 연결과 확인을 진행합니다. 규칙에 따른 분류가 목적이라면 테스트가 끝난 뒤 Config로 돌아가세요. 임시로 사용한 Proxy를 장기적인 규칙 설정으로 두지 않도록 합니다. Global Routing에 Scene 등의 선택지가 더 보이더라도 이번에는 설정할 필요가 없습니다. 우선 세 가지 기본 모드를 비교해 보세요.

Shadowrocket의 Config 구성 편집 화면에 표시된 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule
Config: 사용할 구성을 확인한 다음 Rule과 Add Rule을 살펴보세요.

단계 03 / 클라이언트 연결하기

Home 스위치와 VPN 구성 권한

이제 Home으로 돌아와 SERVER 목록에서 이번에 사용할 서버를 선택하고, 선택 표시가 원하는 항목에 있는지 확인한 다음 Global Routing도 다시 확인합니다. 구독에는 이름이 비슷한 항목이 여럿 있을 수 있고 업데이트 후 위치가 바뀔 수도 있으므로 이전 사용 경험에만 의존하지 말고 현재 선택 상태를 확인하세요.

화면 상단에서 Not Connected 옆의 스위치를 찾아 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가할지 물을 수 있습니다. 이 시스템 안내는 앱이 네트워크 연결 구성을 만들도록 허용하기 위한 것입니다. 안내에 표시된 앱을 확인한 뒤 시스템 요구 사항에 따라 승인하고, 필요한 경우 기기 인증을 완료하세요. 거부하거나 취소하면 앱이 이 단계를 완료할 수 없습니다. 연결을 다시 시작해 권한 요청을 처리해야 하며 Add Server로 돌아가 비밀번호를 다시 입력할 필요는 없습니다.

허용한 다음 Shadowrocket으로 돌아와 화면 상단의 연결 상태가 바뀌는지 확인합니다. 스위치가 바로 꺼지거나 미연결 상태가 반복된다면 현재 화면에 머물러 상황을 기록하고 스위치를 빠르게 반복해서 켜고 끄지 마세요. 시스템 구성이 만들어지는 과정, 원격 서버 인증, 대상 웹사이트 접속은 서로 다른 단계입니다. 스위치가 켜진 상태로 유지되면 다음 확인을 진행할 수 있지만, 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다.

기기에서 다른 VPN 구성을 사용 중이라면 시스템 설정에서 현재 실제로 연결된 항목을 먼저 확인하세요. 다른 연결 상태를 Shadowrocket의 결과로 오해하지 않도록 해야 합니다. 기기가 관리 대상인 경우 관리 정책에 따라 관련 권한이 제한될 수 있으므로 허용된 범위에서 조작하고, 용도를 모르는 시스템 구성을 삭제하지 마세요.

이 단계의 완료 기준: 시스템 권한 처리가 끝나고 Home의 연결 상태가 바뀌었으며 현재 서버와 Global Routing이 모두 의도한 대로 선택되어 있어야 합니다. 다음으로 Connectivity Test와 실제 접속을 확인하는 동안에는 이 선택을 유지하세요. 첫 연결 단계에서는 자동 연결 조건이 결과에 영향을 주지 않도록 On Demand를 아직 활성화하지 마세요.

Shadowrocket의 Home 화면: 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 있고 아래에 SERVER 그룹과 Add Server가 표시됨
Home: 서버와 Global Routing을 확인한 다음 상단 스위치를 켜세요.

단계 04 / 연결 상태와 실제 접속을 따로 확인하기

Connectivity Test 연결 확인

Home에서 Connectivity Test를 탭하고 테스트가 끝날 때까지 기다립니다. 테스트는 선택한 방법으로 해당 연결 조건을 확인하므로 뚜렷한 이상을 파악하는 데 유용하지만, 모든 웹사이트의 실제 응답 속도를 보여주는 것은 아닙니다. 테스트 방법과 대상, 시간대별 네트워크 환경에 따라 결과가 달라질 수 있으므로 조건이 다른 수치를 고정된 순위처럼 비교하지 마세요.

테스트 시간이 초과되어도 항목을 바로 삭제하지 마세요. 서버에 연결할 수 없는 문제, 현재 네트워크, 테스트 방식이나 대상이 원인일 수 있습니다. 같은 서버와 모드를 유지한 채 실제로 접속하려는 웹사이트를 열어 로딩되는지 확인하세요. 반대로 테스트 결과가 나오는데 웹사이트가 열리지 않는다면 도메인 확인, 규칙 일치 여부, 대상 웹사이트 상태를 추가로 확인해야 합니다.

실제 요청으로 분류 결과 확인

Config를 사용할 때는 프록시를 거쳐야 하는 대상과 직접 연결해야 하는 대상을 각각 하나씩 선택해 확인하세요. 둘 다 열린다는 사실만으로 접속 성공을 확인할 수 있습니다. 실제 경로까지 확인하려면 현재 구성의 규칙과 앱에서 확인할 수 있는 요청 기록을 함께 살펴보세요. 웹페이지가 열린 속도만으로 어떤 정책이 적용됐는지 추측하면 안 됩니다. 일부 도메인만 프록시를 사용하는 구성이라면 FINAL에 원하는 정책이 지정되어 있는지도 특히 확인하세요.

실제 접속에 실패하면 서버를 그대로 둔 채 Config에서 Proxy로 임시 전환해 다시 시도할 수 있습니다. Proxy는 되는데 Config가 되지 않는다면 규칙 순서, 정책 연결 및 관련 설정을 먼저 확인하세요. 두 모드 모두 실패하면 서버 항목과 현재 네트워크를 확인합니다. 비교가 끝나면 원래 사용할 모드로 되돌리고 다시 테스트해 진단 중의 임시 설정이 최종 구성으로 남지 않게 하세요.

확인 과정에서는 한 번에 조건 하나만 바꾸세요. 서버 교체, 네트워크 전환, DNS 수정, 구성 업데이트를 동시에 하지 마세요. 문제가 해결되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다. 웹사이트 캐시가 확인을 방해한다면 페이지를 새로고침하거나 닫았다가 다시 여세요. DNS에 관한 시스템 설명은 기술 참고의 DNS 장에서 확인할 수 있습니다.

다음 세 가지 결과를 기록하는 것이 좋습니다: Home에서 연결 상태가 유지되는지, Connectivity Test 결과가 무엇인지, 대상 웹사이트에 실제로 접속할 수 있는지 확인하세요. 각 결과는 서로 다른 단계를 나타내므로 단순히 ‘연결이 안 된다’고 설명하는 것보다 원인을 찾기 쉽습니다.

단계 05 / 가장 먼저 실패한 단계부터 확인하기

Settings와 자주 발생하는 문제

현재 증상과 관련된 설정만 확인하고, 반복 재설치로 문제 원인 확인을 대신하지 마세요.

목록이 비어 있거나 구독 업데이트 결과가 없음

첫 번째 단계로 돌아가 ‘구독 기록이 저장된 상태’와 ‘서버 내용을 읽어 온 상태’를 구분하세요. 링크의 쿼리 부분이 빠지지 않았는지, 여러 줄로 붙여넣지 않았는지, 기존 구독이 아직 유효한지 확인합니다. 업데이트가 같은 그룹의 항목을 덮어쓸 수 있으므로 수동 변경을 영구 저장 방법으로 사용하지 마세요. 유지할 설정이 있다면 먼저 명확히 기록한 뒤 원래 정보에 따라 복원해야 합니다. 서버 항목이 아직 생성되지 않았다면 연결 모드를 바꿔도 가져오기 문제는 해결되지 않습니다.

스위치를 켜도 연결 상태가 유지되지 않음

먼저 시스템 VPN 구성 권한을 승인했는지 확인한 다음 현재 실제로 사용 중인 시스템 연결을 살펴보세요. 권한 처리가 끝났다면 선택한 서버로 돌아가 Type, Host, Port, 인증 항목을 하나씩 확인합니다. 특히 프로토콜에 필요한 옵션이 빠짐없이 설정되어 있는지 확인하세요. Type을 확인하지 않고 Password만 바꾸거나 구독 접근 인증 정보를 단일 서버 인증 정보와 혼동하지 마세요. 두 정보는 서로 다를 수 있습니다.

연결된 것으로 표시되지만 대상 웹사이트가 열리지 않음

먼저 이전 섹션의 모드 비교를 마친 다음 Settings를 확인할지 결정하세요. 특정 대상만 실패하면 해당 규칙, 이름 확인, 대상의 접속 가능 여부를 살펴보세요. 여러 대상이 모두 실패하면 선택한 서버와 현재 네트워크를 다시 확인합니다. Settings의 Proxy, TCP, UDP는 각각 구체적인 역할이 있으므로 범용 해결 스위치로 사용할 수 없습니다. 확실하지 않은 항목은 기본값을 유지하고 기본 연결을 확인하기 전에 변경 범위를 넓히지 마세요.

테스트에 이상이 있거나 Diagnostics를 확인해야 함

Settings에서 Test Method를 찾아 현재 테스트 방식을 확인한 다음 Home으로 돌아와 Connectivity Test를 다시 실행합니다. 테스트 방식이 바뀌면 결과의 의미도 달라질 수 있으므로 수치뿐 아니라 방식을 함께 기록하세요. 원인을 더 확인해야 한다면 Diagnostics의 정보를 살펴보고 어느 단계에서 실패했는지 확인합니다. 다른 사람에게 문제를 설명하기 전에는 서버 주소, 구독 링크, 인증 정보를 가리세요.

Settings의 On Demand는 조건에 따라 연결을 시작하는 기능입니다. 잘못된 서버 항목을 수정하거나 특정 도메인에 적용할 규칙을 정하는 기능은 아닙니다. 수동 연결이 안정된 뒤 자신의 네트워크 조건에 맞게 설정하세요. 직접 조작하지 않았는데 연결이 다시 시작된다면 Home 스위치를 반복해서 끄는 대신 On Demand 조건을 확인합니다.

완료 후 설정을 유지하는 순서

마지막으로 Home으로 돌아와 대상 서버, Global Routing, 연결 상태를 확인한 다음 실제 접속을 한 번 더 테스트하세요. 이번에 사용할 수 있다고 확인된 조합을 유지하고, 나중에 규칙이나 설정을 변경할 때는 이 상태에서 시작해 한 번에 한 항목만 바꾸세요. 구독 내용이 업데이트된 뒤에는 선택한 항목도 다시 확인해 이름이 바뀌면서 의도하지 않은 서버가 선택되지 않았는지 점검합니다.

이제 기본 절차가 완료되었습니다. 기존 정보가 SERVER 목록에 추가되고, 목적에 맞는 모드를 선택했으며, 시스템이 연결을 허용하고 실제 요청도 확인했습니다. 프로토콜 항목, 규칙, DNS 작동 방식을 더 알아보려면 기술 참고를 확인하세요. 조작 순서만 다시 살펴보려면 이 안내서의 정보 가져오기 단계로 돌아가면 됩니다. 고급 설정을 한꺼번에 변경할 필요는 없습니다.

Shadowrocket의 Settings 화면에 표시된 Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 설정 메뉴
Settings: 증상에 따라 Test Method, Diagnostics, On Demand를 확인하세요.