공식 매뉴얼 · 처음 사용하기

Shadowrocket 시작하기

기존 정보를 바탕으로 추가, 모드 선택, 연결, 테스트를 차례로 진행합니다. 먼저 연결이 정상적으로 작동하는지 확인한 뒤 규칙이나 자동 연결 설정을 조정하세요.

아래 이미지는 App Store 공식 스크린샷으로, 화면과 입력 항목을 확인하는 데 사용합니다. 실제 선택 항목은 프로토콜과 앱 화면에 따라 다를 수 있습니다. 본인의 정보만 입력하고 스크린샷의 예시 내용을 그대로 사용하지 마세요. 구독 링크, 암호, 설정 파일에는 접속 정보가 포함될 수 있으므로 공개하지 마세요.

단계 01 · 가져오기

Add Server / Subscribe: 기존 정보 추가

구독 링크와 개별 서버 정보는 서로 다른 입력 방식입니다. 보유한 정보에 맞는 한 가지 방법을 선택하면 됩니다.

구독 링크가 있는 경우: Subscribe 선택

Shadowrocket의 Home을 열고 SERVER 그룹에서 Add Server를 찾아 추가 화면으로 이동합니다. Type을 누르고 Subscribe를 선택한 다음 본인의 전체 구독 링크를 URL 필드에 입력합니다. 저장하기 전에 링크의 프로토콜, 경로, 쿼리 매개변수를 확인하고, 복사 과정에서 안내 문구나 줄바꿈, 앞뒤 공백이 들어가지 않았는지 살펴보세요. 메모는 항목을 구분하기 위한 용도이며 실제 링크를 대신할 수 없습니다.

저장한 뒤 Home으로 돌아가 구독 내용이 로드될 때까지 기다립니다. 정보가 정상적으로 불러와지면 목록에 구독 그룹과 서버 항목이 표시되어야 합니다. 구독 이름만 보이고 선택할 서버가 없다면 가져오기가 완료된 것이 아닙니다. 먼저 링크가 유효한지 확인한 뒤 해당 구독 항목의 업데이트 기능을 사용하세요. 구독을 업데이트하면 원격 콘텐츠를 다시 가져오며 로컬 변경 사항을 백업하는 것은 아닙니다. 처음 사용할 때는 기존 설정을 그대로 유지하세요.

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

단일 서버의 주소, 포트, 인증 정보가 있다면 Add Server의 Type에서 해당 프로토콜을 선택한 뒤 Host, Port와 프로토콜별 필수 항목을 입력합니다. Shadowsocks의 Method, Trojan의 TLS 관련 설정, WireGuard의 키는 서로 바꿔 사용할 수 없습니다. Type에 따라 화면에 표시되는 항목이 다릅니다. 필수 정보가 없다면 임의의 값을 입력하지 말고 서비스 제공자에게 먼저 확인하세요.

Host에는 보통 안내받은 도메인이나 주소를, Port에는 해당 포트 번호를 입력합니다. Password의 대소문자와 특수문자는 원문 그대로 입력해야 합니다. SNI, 전송 방식, 경로가 별도로 안내된 경우 현재 프로토콜 화면의 해당 항목에 각각 입력하세요. 브라우저에서 여는 웹페이지 주소를 서버 주소로 입력하지 마세요. 저장한 뒤 Home으로 돌아와 메모와 유형을 확인하여 새로 추가한 항목을 기존 항목과 혼동하지 않도록 합니다.

기존 QR 코드가 있는 경우: Scan QR Code 사용

정보가 QR 코드로 제공된 경우 Add Server에서 Scan QR Code를 선택하고 시스템 안내에 따라 카메라 접근을 허용한 뒤 코드를 스캔합니다. 인식이 끝난 뒤에도 Type, 주소, 포트를 확인하고 저장하세요. QR 코드에는 구체적인 정보가 담겨 있으므로 일반 웹페이지 이미지에서 서버 정보를 추측할 수는 없습니다. Import from Cloud JSON은 별도의 가져오기 기능이므로 구독 링크를 이 절차에 임의로 입력하지 마세요.

Type, Host, Port, Password, Method 및 Scan QR Code 기능이 표시된 Shadowrocket Add Server 화면
Add Server: 먼저 Type을 선택한 다음 해당 프로토콜 정보를 입력합니다.
단계 02 · 트래픽 분기

Global Routing: 연결 모드 선택

세 가지 모드는 Config, Proxy, Direct입니다. 모드는 트래픽 처리 경로를 정하며 서버 정보를 보완하거나 수정하지는 않습니다.

Home으로 돌아와 Global Routing을 눌러 현재 선택 항목을 확인합니다. 평소 규칙을 사용하려면 Config를 선택하고, 프록시 경로를 일시적으로 확인하려면 Proxy를, 직접 연결하려면 Direct를 선택합니다. 선택한 뒤 Home으로 돌아와 Global Routing 항목에 방금 선택한 값이 표시되는지 확인하고 연결하세요.

Config: 현재 설정 파일 확인

Config는 현재 설정의 규칙에 따라 요청을 처리합니다. 하단의 Config 화면으로 이동해 사용 중인 설정 파일을 확인하세요. 내용을 확인하려면 해당 파일의 편집 화면을 열면 General, Rule, Hosts 등의 섹션을 볼 수 있습니다. 처음 사용할 때는 섹션별 내용을 수정할 필요가 없습니다. 먼저 Rule이 예상한 대로 설정되어 있는지 확인하세요. 기존 설정을 사용한다면 여러 출처의 규칙을 섞기보다 해당 설정의 설명을 먼저 읽어보세요.

아래 내용은 규칙의 의미를 설명하기 위한 것으로, 처음 연결할 때 붙여 넣을 필요는 없습니다. DOMAIN-SUFFIX는 도메인 접미사를 일치시킨 뒤 지정된 정책으로 전달합니다. FINAL은 앞선 규칙에 일치하는 항목이 없을 때 적용되는 기본 처리 규칙입니다. 예시의 example.com은 사용할 수 있는 서버 주소가 아니며 PROXY도 구독 이름이 아닙니다. 규칙을 수정하기 전에 원본 파일을 보관하세요. 규칙, DNS, 연결 설정을 한꺼번에 바꾸면 어떤 변경이 영향을 주었는지 판단하기 어렵습니다.

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

Proxy와 Direct: 트래픽 경로 구분

Proxy는 요청에 프록시 경로를 사용하며, 짧은 테스트로 서버 연결 문제와 규칙 일치 문제를 구분할 때 유용합니다. Direct는 직접 연결을 사용하므로 연결 스위치가 켜져 있어도 웹사이트 요청이 서버를 통해 전달된다고 볼 수는 없습니다. 실제 설정과 앱의 옵션을 함께 확인해야 하며, 한 가지 모드를 모든 문제의 해결책으로 사용하지 마세요.

Proxy로 잠시 전환했을 때 대상 페이지가 열리고 Config로 돌아온 뒤 문제가 생긴다면 같은 구독을 반복해서 가져오기보다 설정과 규칙 순서를 확인하세요. 규칙에 대한 자세한 설명은 기능 안내를, 체계적인 문제 해결은 문제 해결 매뉴얼을 참고하세요. 모드를 확인한 다음 연결 스위치를 켭니다.

General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시된 Shadowrocket Config 설정 편집 화면
Config: 현재 파일의 Rule 섹션을 확인하세요. Global Routing 모드 선택은 Home에서 할 수 있습니다.
단계 03 · 연결

Home: 서버를 선택한 뒤 스위치 켜기

목록에 항목이 있다고 해서 선택된 것은 아닙니다. 스위치가 켜져 있다고 해서 모든 웹사이트 접속이 확인된 것도 아닙니다.

Home으로 돌아와 SERVER 그룹에서 이번에 사용할 서버를 선택합니다. 항목 왼쪽에 선택 표시가 나타났는지 확인하고 Global Routing이 앞서 선택한 모드로 유지되고 있는지도 살펴보세요. 항목의 편집 화면을 열어 정보를 확인한 뒤 돌아오는 것만으로는 기본 서버가 선택되지 않습니다. 그룹이 여러 개라면 선택 표시가 어느 항목에 있는지 특히 주의하세요.

이어서 Home 상단의 스위치를 켭니다. 연결되지 않은 동안에는 상단에 Not Connected가 표시됩니다. 연결이 시작되면 상태가 어떻게 바뀌는지 확인하세요. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 설정 추가를 허용할지 물을 수 있습니다. 팝업에 표시된 앱 이름과 설명을 읽고 현재 작업에서 요청한 것이 맞는지 확인한 다음 허용하고, 시스템 안내에 따라 기기 인증을 완료하세요. 이 과정은 앱이 네트워크 연결 설정을 만들도록 허용하는 절차이며 다시 구매하는 과정이 아닙니다.

권한을 허용한 뒤 Shadowrocket으로 돌아와 스위치가 켜진 상태로 유지되는지, 상단에서 Not Connected가 사라졌는지 확인하세요. 스위치가 바로 꺼지면 앱의 오류 메시지를 먼저 확인하고 빠르게 반복해서 누르지 마세요. 이전에 권한을 거부했다면 다시 연결을 시도해 시스템 안내에 따라 처리할 수 있습니다. 기기 관리 정책이나 시스템 제한이 설정 생성에 영향을 줄 수도 있으므로 기기에서 허용된 작업 범위를 확인하세요.

처음 테스트하는 동안에는 다른 VPN 연결을 동시에 사용하지 말고 On Demand도 바로 켜지 마세요. 수동 스위치로 같은 절차를 반복할 수 있도록 합니다. 동일한 서버를 선택하고 같은 네트워크에서 연결한 뒤 결과를 확인하세요. 상태 표시줄의 VPN 표시는 시스템에 VPN 연결 상태가 있음을 뜻할 뿐, 특정 도메인에 예상한 정책이 적용되었음을 증명하지는 않습니다.

상단에 Not Connected 스위치가 있고 아래에 Global Routing, Connectivity Test, SERVER 및 Add Server가 표시된 Shadowrocket Home 화면
Home: SERVER 항목을 선택한 뒤 상단 스위치로 연결하세요.
단계 04 · 확인

Connectivity Test: 연결 상태와 실제 접속을 따로 확인

테스트 결과, 실제 접속, 규칙 경로 순으로 확인하세요. 한 번의 테스트 성공이 모든 웹사이트와 요청 유형의 정상 작동을 뜻하지는 않습니다.

먼저 Home에서 Connectivity Test를 실행하고 현재 테스트 결과가 나올 때까지 기다립니다. 테스트는 연결 상태를 파악하는 데 참고가 되며, 결과는 테스트 방식과 대상, 현재 네트워크의 영향을 받습니다. 시간이 초과되면 어떤 서버와 네트워크에서 발생했는지 기록하세요. 응답 결과가 표시되어도 숫자만 보고 장기적인 속도를 판단하지 마세요. 특정 수치를 목표로 하기보다 같은 조건에서 테스트가 완료되는지 비교하는 것이 중요합니다.

이어서 브라우저를 열고 현재 네트워크 환경에서 정상 작동이 확인된 페이지에 접속합니다. 먼저 일반 웹페이지를 열어 본 뒤 확인하려는 대상에 접속하세요. 브라우저에 이전 페이지가 계속 표시되면 새로고침하거나 새 탭을 열어 캐시된 내용을 연결 성공의 근거로 착각하지 않도록 합니다. 테스트하는 동안 서버를 그대로 유지해야 현재 결과를 앞선 단계와 비교할 수 있습니다.

Config를 사용하는 경우 대상 요청이 원래 PROXY 경로를 사용해야 하는지도 확인하세요. 규칙은 위에서 아래 순서로 적용됩니다. 대상이 DIRECT 규칙에 일치하면 페이지가 열려도 프록시 경로가 확인된 것은 아닙니다. 반대로 특정 페이지가 열리지 않는다고 해서 서버 전체가 작동하지 않는다고 단정할 수도 없습니다. 원래 설정을 보관한 채 Proxy로 잠시 전환해 다시 테스트할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌리고 두 결과를 함께 기록하세요.

일반 페이지는 열리지만 특정 웹사이트만 문제가 있다면 해당 사이트의 규칙, DNS 조회, 사이트 자체 상태를 먼저 확인하세요. 모든 페이지에 문제가 있다면 연결 스위치를 끄고 기존 네트워크를 확인합니다. 기존 네트워크에서도 접속할 수 없다면 먼저 네트워크를 복구한 뒤 이 튜토리얼을 이어서 진행하세요. 원인을 더 구분하려면 자주 묻는 질문과 증상별 문제 해결 매뉴얼을 참고하세요.

단계 05 · 문제 해결

Settings: 문제가 발생한 단계별로 확인

현재 정보를 유지하고 한 번에 한 항목만 변경하세요. 가져오기, 권한 승인, 연결, 규칙 처리 중 어디에서 문제가 발생했는지 먼저 파악합니다.

정보를 추가할 수 없거나 구독 목록이 비어 있음

정보 추가 단계로 돌아가 Type과 입력 내용이 서로 맞는지 확인하세요. Subscribe에는 전체 구독 링크가 필요하고, 단일 서버에는 해당 프로토콜의 정보가 필요합니다. 두 입력 방식을 섞어 사용할 수 없습니다. 구독이 업데이트되지 않으면 링크가 만료되었는지, 현재 네트워크에서 해당 주소에 접속할 수 있는지, 정보 제공자가 별도 작업을 요구하는지 확인하세요. 같은 이름의 구독을 반복해서 만들면 이후 선택한 서버가 어느 그룹에 속하는지 혼동할 수 있습니다.

스위치가 유지되지 않거나 연결 후 모든 사이트에 접속할 수 없음

스위치가 켜진 상태로 유지되지 않으면 시스템의 VPN 설정 권한을 먼저 확인한 뒤 앱의 오류 메시지를 살펴보세요. 스위치는 유지되지만 접속할 수 없다면 올바른 서버를 선택했는지, Host, Port, Password와 프로토콜별 추가 정보가 원래 자료와 일치하는지 확인합니다. 연결을 잠시 끄고 기존 네트워크가 정상적으로 작동하는지 확인하세요. 기존 네트워크에 문제가 없다면 다시 연결해 같은 테스트를 반복합니다. 그래야 문제가 서버 설정을 따라 발생하는지 판단할 수 있습니다.

Connectivity Test 시간 초과 또는 결과 불일치

Settings에서 Test Method를 열고 현재 테스트 방식을 확인합니다. 테스트 방식마다 확인하는 조건이 다르므로 결과를 동일한 지표로 간주할 수 없습니다. 테스트 방식을 바꾼다면 변경 전후 설정을 기록한 뒤 같은 서버로 다시 테스트하세요. 포트, DNS, 테스트 방식을 동시에 바꾸지 마세요. Wi-Fi와 셀룰러 네트워크를 비교할 때도 한 번에 네트워크 하나만 바꾸고 다른 조건은 유지합니다.

연결 상태가 자동으로 바뀌거나 특정 웹사이트에 문제가 있음

Settings에서 On Demand를 확인하세요. 켜져 있다면 조건에 따라 자동 연결 시점이 달라질 수 있습니다. 처음 문제를 확인할 때는 자동 연결을 잠시 끄고 수동 스위치로 문제를 재현한 뒤, 필요에 따라 다시 설정하세요. 특정 웹사이트만 문제라면 Config의 Rule과 현재 Global Routing을 먼저 확인하세요. 한 사이트 때문에 모든 Proxy, TCP, UDP 옵션을 변경하지 마세요.

원인을 더 자세히 확인하려면 Settings에서 Diagnostics를 살펴보세요. 문제를 정리할 때는 “현재 모드, 선택한 서버, 네트워크 유형, 테스트 시간 초과 여부, 실제 접속 현상”을 기록하는 것이 단순히 “연결되지 않음”이라고 쓰는 것보다 도움이 됩니다. 진단 정보를 다른 사람에게 전달하기 전에 구독 URL, 인증 정보와 기타 개인 정보를 가리세요. 전체 설정 파일을 그대로 공개하지 마세요. DNS, 배터리 소모, 업데이트 후 문제와 관련된 긴 해결 절차는 문제 해결 매뉴얼에서 해당 증상을 찾아 진행하세요.

이제 정보 가져오기부터 결과 확인까지 기본 절차를 마쳤습니다. 구매, 권한, 정보 관리에 대한 간단한 설명은 자주 묻는 질문을 참고하세요. 각 기능의 용도를 알아보려면 기능 안내를 이어서 읽어보세요.

Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시된 Shadowrocket Settings 화면
Settings: 먼저 Test Method와 On Demand를 확인하고, 증상에 따라 Diagnostics를 살펴보세요.