공식 매뉴얼 / 첫 설정

Shadowrocket 시작하기

먼저 기존 서버를 추가하고 Global Routing을 선택한 다음 연결과 확인을 진행합니다. 첫 설정에는 약 10분 정도를 확보하고, 순서대로 진행하면서 여러 설정을 동시에 바꾸지 마세요.

단계 01 / Home에서 서버 선택 항목 확인하기

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

먼저 보유한 정보의 종류를 확인하세요. 서버 목록이 포함된 정기 갱신 링크라면 구독으로 가져오고, 주소와 포트, 프로토콜, 인증 정보만 있다면 개별 서버로 입력합니다. 두 방법 중 하나만 선택하면 되며 같은 정보를 중복으로 추가할 필요는 없습니다. 구독 링크는 본인의 서비스 제공업체에서 받아야 합니다. 가져오기 전에 본인 계정에 연결된 링크인지 확인하고, 복사할 때 안내 문구나 줄 끝의 공백이 포함되지 않도록 하세요.

구독 링크가 있는 경우: Subscribe 사용

Home을 열고 추가 버튼을 눌러 Add Server로 이동한 다음 Type을 눌러 목록에서 Subscribe를 선택합니다. 양식으로 돌아와 URL 항목에 구독 링크 전체를 입력하고, 필요하면 알아보기 쉬운 메모를 작성한 뒤 화면의 저장 버튼을 누릅니다. 구독은 서버 항목을 가져와 관리하는 기능이며 연결 스위치를 대신하지 않습니다.

저장한 뒤 Home으로 돌아가 구독 정보를 불러올 때까지 기다린 다음 SERVER에 해당 그룹과 서버가 표시되는지 확인합니다. 구독 이름만 보이고 선택할 서버가 없다면 연결 단계로 넘어가지 말고 업데이트가 정상적으로 완료됐는지 확인하세요. 링크가 만료됐거나 로그인 안내 등 사용할 수 없는 내용이 반환됐을 수 있습니다. 자세한 내용은 문제 해결의 구독 및 서버 가져오기 안내를 참고하세요.

개별 서버 정보가 있는 경우: Type에 맞춰 입력

Add Server에서 Type을 자료에 표시된 프로토콜로 설정한 다음 Host, Port, Password 등의 항목을 하나씩 입력합니다. Host에는 서버 호스트 이름이나 주소를, Port에는 해당 포트 번호를 입력합니다. Method 항목이 있다면 보유한 정보와 일치시켜야 합니다. Type에 따라 입력 항목이 다르므로 항목 이름이 비슷해 보인다는 이유로 그대로 입력하지 말고, 구독 링크 전체를 Host에 붙여 넣지도 마세요.

예시 호스트 이름은 example.com처럼 입력할 수 있습니다. 이는 항목의 의미를 설명하기 위한 예시일 뿐, 실제로 사용할 수 있는 서버가 아닙니다. 별도 인증, TLS 또는 다른 매개변수가 필요하다면 보유한 원본 정보를 항목별로 확인하세요. 저장한 뒤 Home으로 돌아가 서버 이름과 프로토콜이 예상대로 표시되는지 확인합니다. 비밀번호 같은 민감한 정보는 메모에 적지 말고, 메모는 용도나 출처를 구분하는 데만 사용하세요.

QR 코드 및 클립보드: 가져온 뒤에도 확인하기

정보가 QR 코드 형태라면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용한 뒤, 보유한 자료의 QR 코드를 스캔합니다. 서버 공유 링크를 받았다면 앱에서 제공하는 클립보드 가져오기 기능을 사용할 수 있습니다. 가져오기에 성공하면 Type, Host, Port를 확인하고 저장하세요. QR 코드와 공유 링크는 설정 정보를 전달하는 방법일 뿐, 스캔에 성공했다고 서버에 연결할 수 있는 것은 아닙니다.

이 단계가 끝나면 Home에 선택 가능한 서버가 하나 이상 표시되어야 합니다. 여러 구독, 중복 항목, 업데이트 방식 및 백업은 첫 설정에서 한꺼번에 처리할 필요가 없습니다. 나중에 구독 및 서버 관리 매뉴얼을 참고해 정리할 수 있습니다. 다음 단계에서는 트래픽 처리 방식을 정한 뒤 연결 스위치를 켭니다.

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을 누릅니다. 처음 사용할 때는 세 가지 모드를 구분하세요: Config, Proxy, Direct. 이 설정은 연결이 켜졌을 때 트래픽을 처리하는 방식을 정하며, 서버 세 개를 뜻하거나 서버 정보를 자동으로 채워 주는 기능이 아닙니다. 전환하기 전에 기존 선택을 기록해 두면 테스트를 마친 뒤 되돌리기 쉽습니다.

Config: 현재 구성의 규칙에 따라 처리

Config를 선택하면 트래픽이 현재 선택된 구성 파일의 규칙과 일치하는지 확인한 뒤 해당 정책에 따라 처리됩니다. Config 화면에서 사용할 구성 파일이 올바르게 선택되어 있는지 먼저 확인하세요. 내용 확인이 필요할 때 구성 파일 편집 화면을 여세요. 공식 스크린샷의 General, Rule, Hosts 등의 구분은 구성 내용이며, 첫 연결을 위해 하나씩 입력해야 하는 양식이 아닙니다.

신뢰할 수 있는 구성이 있다면 먼저 설명을 읽고 규칙에서 참조하는 정책이 실제로 있는지 확인하세요. 규칙은 일반적으로 순서대로 적용됩니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 접미사에 지정된 정책을 사용한다는 뜻입니다. 예시의 PROXY는 실제 구성의 문맥에서 올바른 의미를 가져야 합니다. 예시 한 줄을 따로 붙여 넣었다고 트래픽 분류가 완료되는 것은 아닙니다.

Proxy: 선택한 서버의 연결 확인

Proxy를 사용하면 이 모드가 처리하는 트래픽이 프록시 경로를 이용합니다. 첫 문제 해결 과정에서는 규칙 선택의 영향을 줄여 선택한 서버의 기본 연결 가능 여부를 확인하도록 잠시 선택할 수 있습니다. 이는 점검을 위한 단계일 뿐 모든 상황에서 Proxy를 계속 사용해야 한다는 뜻도, 모든 대상에 반드시 접속할 수 있다는 뜻도 아닙니다. 테스트를 마친 뒤 본인의 구성 목적에 맞춰 Config로 돌아갈지 결정하세요.

Direct: 선택한 프록시 서버를 사용하지 않음

Direct는 직접 연결할 때 사용합니다. 현재 Direct가 선택되어 있다면 VPN 구성이 활성화되어 있어도 트래픽이 선택한 서버를 거친다고 판단할 수 없습니다. 접속 결과가 예상과 다르면 구독을 다시 가져오기보다 먼저 Global Routing으로 돌아가 현재 선택을 확인하는 편이 효과적입니다.

첫 설정 중에는 URL Rewrite 또는 HTTPS Decryption을 함께 변경하지 마세요. 이 기능들은 서버 연결을 위한 필수 조건이 아니며, 구성에 미치는 영향도 서로 다릅니다. 이 단계에서는 현재 모드를 기억하고 Config의 파일 선택 또는 Proxy의 서버 선택을 확인하면 됩니다. 규칙 순서와 정책 이름에 대한 자세한 내용은 규칙 분류 및 문제 해결에서 확인할 수 있습니다. 이 가이드에서는 이어서 실제 연결을 진행합니다.

Shadowrocket Config 구성 편집 공식 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 구성 편집 화면: Global Routing에서 Config를 선택한 뒤 현재 사용할 구성 파일도 확인해야 합니다. 첫 연결을 위해 모든 항목을 수정할 필요는 없습니다.

단계 03 / 서버 선택 및 VPN 구성 허용

Home: 연결 스위치 켜기

Home으로 돌아가 SERVER에서 보유한 서버 하나를 선택합니다. 구독 그룹 이름만 보는 것이 아니라 구체적인 서버 항목을 선택해야 합니다. 항목이 여러 개라면 첫 테스트에서는 하나로 고정하세요. 서버와 모드를 매번 바꾸면 어떤 변경이 결과에 영향을 줬는지 판단하기 어렵습니다. Global Routing이 앞서 선택한 모드로 유지되고 있는지도 확인합니다.

Home 상단의 Not Connected 옆 스위치를 찾아 켭니다. 처음 연결할 때 iPhone 또는 iPad에 VPN 구성을 추가하라는 시스템 안내가 표시될 수 있습니다. 현재 사용 중인 Shadowrocket에서 요청한 작업인지 확인한 뒤 안내에 따라 추가를 허용하고 시스템에서 요구하는 기기 인증을 완료하세요. 이 권한은 기기의 VPN 구성을 설정하기 위한 것이며 앱이나 구독 구매를 확인하는 절차가 아닙니다.

권한 설정을 완료한 뒤 앱으로 돌아와 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 시스템 안내를 취소했다면 연결을 다시 시작해 권한을 완료하세요. 앱을 바로 삭제할 필요는 없습니다. 시스템 상태 막대의 VPN 표시는 구성이 활성화됐는지 확인하는 데 도움이 될 수 있지만, 기기와 표시 위치에 따라 다를 수 있으므로 Home의 상태도 함께 확인해야 합니다.

연결 상태가 표시된다는 것은 연결 절차가 시작됐다는 뜻일 뿐, 모든 접속이 성공적으로 확인됐다는 뜻은 아닙니다. 서버에 연결할 수 없거나 매개변수가 일치하지 않거나 규칙 선택이 잘못되면 앱의 연결 상태와 실제 접속 결과가 다를 수 있습니다. 스위치를 켠 직후 여러 설정을 한꺼번에 바꾸지 말고 다음 단계에서 범위를 좁혀 확인하세요.

사용을 중지하려면 Home으로 돌아가 스위치를 끄고 상태가 정상적으로 바뀌었는지 확인합니다. 기기에서 다른 VPN 구성이 작동 중이라면 테스트 전에 현재 어떤 구성이 연결을 처리하는지 확인하세요. 여러 구성을 동시에 전환하면 결과를 잘못 판단할 수 있습니다. 첫 설정에서는 수동 연결을 유지하고, On Demand는 기본 연결을 확인한 다음 별도로 설정하세요.

Shadowrocket Home 공식 스크린샷: 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 표시되고 아래에 SERVER와 Add Server가 표시됨
Home: SERVER에서 선택한 항목, Global Routing, 상단 스위치를 순서대로 확인합니다. Connectivity Test는 다음 단계에서 점검할 때 사용합니다.

단계 04 / 상태, 연결 가능 여부 및 접속 결과를 따로 확인

Connectivity Test: 작동 여부 확인

세 단계로 확인합니다. 먼저 연결 상태를 보고, 다음으로 서버 테스트를 진행한 뒤, 마지막으로 실제 접속을 확인합니다. 각 단계는 서로 다른 질문에 답하므로 하나로 다른 단계를 대신할 수 없습니다. Home 상단은 연결 활성화 여부를 보여 주고, Connectivity Test는 특정 테스트 방식에 따른 결과를 제공하며, 실제 페이지 접속은 현재 네트워크와 서버, 모드 조합으로 필요한 요청을 처리할 수 있는지 보여 줍니다.

Home에서 Connectivity Test를 눌러 기존 서버를 테스트합니다. 먼저 결과가 나오는지 확인하고, 이어서 결과가 안정적인지 살펴보세요. 한 번 낮게 측정된 지연 시간을 속도나 안정성의 보장으로 여겨서는 안 됩니다. 테스트 방법마다 측정 대상이 다르므로 같은 테스트 방법과 비슷한 네트워크 환경에서 나온 수치끼리만 참고할 수 있습니다. 한 항목에서 시간 초과가 발생하면 구독 전체를 바로 삭제하지 말고 한 번 더 테스트하고 기본 네트워크를 확인하세요.

그다음 평소 사용하며 정상적으로 접속되는 것을 확인한 페이지를 열고 새로 고친 뒤 다른 페이지도 열어 보세요. 이전에 캐시된 내용만 표시되는 상황을 피할 수 있습니다. 간단한 페이지부터 확인하고 실제로 필요한 앱을 테스트하세요. 간단한 페이지는 열리는데 특정 앱만 실패한다면 문제 범위가 좁혀진 것이므로 모든 연결이 실패했다고 단정하지 마세요.

Config를 사용하는 경우 결과가 본인의 트래픽 분류 목적에 맞는지도 확인해야 합니다. 일부 대상은 DIRECT로 접속하고 다른 대상은 프록시를 거쳐야 할 수 있습니다. 직접 접속에 성공했다고 프록시 경로도 정상이라는 뜻은 아닙니다. 앱에서 제공하는 연결 기록을 확인해 대상에 어떤 규칙과 정책이 적용됐는지 현재 구성과 비교할 수 있습니다. 기록에 도메인이나 기타 접속 정보가 포함될 수 있으므로 공유하기 전에 민감한 정보를 가리세요.

연결 상태가 정상이고 테스트에 응답이 있으며 실제 접속 결과도 예상과 맞으면 첫 연결이 완료된 것입니다. 나중에 문제를 확인할 수 있도록 사용한 서버 메모, Global Routing 모드, 네트워크 유형을 기록해 두세요. 어느 한 단계에서든 실패하면 다음 단계에서 기본 네트워크부터 앱 설정까지 차례로 확인하면 됩니다. 가져오기 과정을 반복할 필요는 없습니다.

단계 05 / 기존 정보를 보존하고 원인을 단계별로 좁히기

Settings 및 첫 연결 문제 해결

먼저 어느 단계에서 실패했는지 확인합니다. 구독에서 서버 항목을 불러오지 못했는지, 스위치가 켜진 상태를 유지하지 못하는지, Connectivity Test에 응답이 없는지, 아니면 일부 접속만 실패하는지 살펴보세요. 증상마다 확인할 사항이 다릅니다. 정확한 화면 안내를 기록한 뒤 해당 단계만 점검하세요. 앱을 먼저 삭제하면 로컬 구성과 문제 해결에 필요한 정보가 함께 사라질 수 있습니다.

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

연결을 잠시 중지하고 현재 Wi-Fi 또는 셀룰러 네트워크가 정상적으로 작동하는지 확인합니다. 로그인이 필요한 네트워크라면 먼저 인증을 완료하세요. 그런 다음 구독 업데이트가 성공했는지 확인합니다. 업데이트에 실패했다면 링크 전체와 유효 상태, 복사한 내용을 점검하고 필요하면 본인의 서비스 제공업체에 원래 링크가 여전히 유효한지 문의하세요. 구독 주소에 계정 인증 정보가 포함될 수 있으므로 전체 링크를 공개 스크린샷이나 질문 글에 붙여 넣지 마세요.

서버 항목과 모드 재확인

직접 추가한 서버는 원본 정보를 대조해 Type, Host, Port, Password와 해당 프로토콜에 필요한 다른 매개변수를 하나씩 확인합니다. 항목이 존재한다고 해서 값이 올바른 것은 아닙니다. 비슷한 문자, 누락된 내용, 잘못 선택한 Method가 연결에 영향을 줄 수 있습니다. 구독에서 가져온 항목은 구독으로 관리되는 경우가 있으므로 먼저 업데이트 상태를 확인한 뒤 수정하세요. 로컬 변경 사항이 다음 업데이트에서 덮어써질 수 있습니다.

서버 테스트에 응답이 있지만 실제 접속에 실패한다면 Home으로 돌아가 Global Routing을 확인합니다. Config에서는 선택한 파일과 규칙 정책을 확인하고, 필요하다면 조건 비교를 위해 Proxy로 잠시 바꿔 보세요. Config에서만 문제가 발생한다면 규칙과 정책을 먼저 확인하고 이미 정상 작동을 확인한 서버를 다시 입력하지 마세요. Direct가 선택되어 있다면 이번 테스트의 목적에 맞는 설정인지 먼저 확인해야 합니다.

마지막으로 테스트 설정 및 시스템 권한 확인

Settings에서 Test Method를 찾아 현재 테스트 방식을 확인한 다음 Home으로 돌아가 같은 방식으로 다시 테스트합니다. Settings의 Diagnostics에서 추가 점검을 진행할 수도 있습니다. 진단 정보는 원인을 찾는 데 도움을 주는 자료이며 모든 연결 문제를 자동으로 해결하지는 않습니다. 기록을 정리할 때는 오류 안내, 테스트 방식, 발생 단계만 남기고 비밀번호와 구독 링크 및 다른 인증 정보를 가리세요.

상단에 Not Connected가 계속 표시되면 처음 시스템 권한 요청을 취소했는지 확인한 뒤 연결을 다시 시작해 안내에 따라 설정합니다. 스위치는 켜져 있지만 접속에 실패한다면 시스템 권한만 반복해서 조작하지 말고 서버와 모드를 다시 확인하세요. 기록에 익숙하지 않은 오류가 있다면 단어 하나만 보고 고급 옵션을 여러 개 바꾸지 말고 문제 해결에서 증상에 맞는 안내를 확인하세요.

On Demand: 기본 연결 확인 후 설정

On Demand는 설정한 조건에 따라 연결을 시작하는 기능이지 서버 매개변수를 수정하는 스위치가 아닙니다. 먼저 수동 연결과 연결 중지 여부를 확인한 다음 본인의 네트워크 사용 방식에 맞게 설정하세요. 테스트 중 자동으로 다시 연결된다면 On Demand가 활성화되어 있는지 확인하고 현재 조건을 이해한 뒤 일시적으로 조정합니다. 첫 설정에서 Settings의 Proxy, TCP, UDP 등 고급 항목을 함께 바꿀 필요는 없습니다.

이 가이드의 완료 기준은 서버를 선택할 수 있고, Global Routing이 목적에 맞으며, 연결 스위치를 정상적으로 켜고 끌 수 있고, 실제 접속도 확인된 상태입니다. 구독 정리와 업데이트, 백업은 나중에 진행해도 됩니다. 서버 관리 매뉴얼을 참고하세요. 특정 증상이 발생하면 현재 구성을 보존하고 문제 유형에 따라 확인하는 편이 처음부터 다시 설정하는 것보다 원인을 찾기 쉽습니다.

Shadowrocket Settings 공식 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 문제 해결 시 먼저 Test Method와 Diagnostics를 확인하세요. On Demand 등의 설정은 수동 연결이 정상적으로 확인된 뒤 필요에 따라 조정합니다.