공식 가이드 · 첫 연결

Shadowrocket 사용법

기존 서비스를 추가하고 Global Routing을 선택한 뒤 연결과 작동 여부를 확인하세요. iPhone과 iPad 모두 같은 순서로 진행하면 됩니다.

먼저 기본 연결을 완료한 다음 규칙과 자동 연결을 설정하세요. 구독 업데이트, 일괄 정리 및 백업 방법은 구독 및 서버 관리 가이드에서 확인할 수 있습니다.

단계 01 · 연결 정보 준비

Add Server와 Subscribe

Shadowrocket을 열고 Home에 머무른 상태에서 연결 스위치는 꺼 두세요. 아래의 SERVER 그룹을 확인하고 본인의 서버 항목이 없다면 Add Server를 엽니다. 먼저 가진 정보가 서버 목록을 업데이트하는 구독 링크인지, 특정 서버의 프로토콜·주소·포트·인증 정보인지 확인하세요. 입력 방법이 서로 다르므로 구독 링크를 Host에 입력하면 안 됩니다.

기존 구독이 있는 경우: Subscribe 선택

Add Server에서 Type을 열고 Subscribe를 선택한 뒤, 본인의 전체 구독 링크를 해당 URL 입력란에 입력하세요. 링크는 기존 서비스 정보에서 확인해야 합니다. 복사할 때 전체 경로와 쿼리 매개변수를 포함하세요. 채팅이나 문서에 있는 줄바꿈, 앞뒤 공백, 한글 문장 부호 때문에 가져오기가 실패할 수 있습니다. 메모는 구독을 구분하는 용도로 원하는 내용을 입력할 수 있지만, 연결 매개변수에는 영향을 주지 않습니다.

저장한 뒤 Home으로 돌아와 해당 구독 그룹과 서버 항목이 표시되는지 확인하세요. 그룹 이름만 보이고 항목이 없다면 링크가 완전한지 확인한 다음 구독 업데이트를 시도하세요. 구독을 가져왔다는 것은 클라이언트가 서버 정보를 읽었다는 뜻일 뿐, 모든 서버에 연결할 수 있거나 서비스가 아직 유효하다는 의미는 아닙니다. 다음 단계에서는 그룹 제목만 선택하지 말고 실제 항목을 선택해야 합니다.

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

단일 서버 정보를 받았다면 자료와 일치하는 프로토콜을 Type에서 선택한 뒤 각 항목을 입력하세요. 예를 들어 Shadowsocks에서 흔히 입력하는 항목은 Host, Port, Password, Method입니다. Host에는 호스트 이름이나 주소를, Port에는 포트 번호를 입력하세요. Password와 Method는 원본 정보와 일치해야 하며, 이름이 비슷하다는 이유로 임의로 바꾸면 안 됩니다. 다른 프로토콜에는 인증, 전송 또는 TLS 관련 항목이 다르게 표시될 수 있습니다. 항목의 의미가 불확실하다면 먼저 용어 설명을 확인하고, 다른 프로토콜의 입력 방법을 그대로 적용하지 마세요.

QR 코드나 공유 링크로도 기존 서버 정보를 가져올 수 있습니다. Add Server의 Scan QR Code에서 본인의 QR 코드를 스캔할 수 있습니다. 클립보드에서 가져오려면 전체 공유 링크를 복사한 뒤 앱에 표시되는 안내에 따라 진행하고, 저장한 다음 Type과 주소를 다시 확인하세요. Import from Cloud JSON은 해당 형식의 자료를 위한 기능이며, 모든 구독 링크에 사용할 수 있는 일반적인 가져오기 메뉴가 아닙니다. 해당 형식의 자료가 없다면 Subscribe를 사용하거나 직접 입력하세요.

iPad에서는 콘텐츠 영역의 너비와 목록 배치가 iPhone과 다를 수 있지만, Home, SERVER, Add Server를 찾아 진행하면 됩니다. 가져온 뒤에는 세 가지를 확인하세요. 항목이 실제로 표시되는지, Type이 자료와 일치하는지, 사용할 항목을 선택할 수 있는지 확인합니다. 같은 구독을 반복해서 일괄 추가하지 마세요. 중복 항목이 많으면 나중에 확인하기 어려워집니다. 서버 정보 한 묶음을 확인한 뒤 Global Routing으로 이동하세요.

Shadowrocket 공식 Add Server 스크린샷: Type, Host, Port, Password, Method 및 QR 코드 스캔 메뉴 표시
Add Server: 먼저 Type을 선택하고 기존 정보에 맞춰 항목을 입력하세요.
단계 02 · 요청 경로 확인

Global Routing의 세 가지 모드

서버를 추가한 뒤 Home으로 돌아와 Global Routing을 엽니다. 여기에서 요청의 라우팅 방식을 결정하며, SERVER에서 선택하는 서버와는 별개의 설정입니다. 처음 설정할 때 현재 선택 항목을 기록해 두세요. 연결에 실패했을 때 서버와 모드를 동시에 바꾸면 어떤 변경으로 결과가 달라졌는지 알기 어렵습니다.

Config: 구성 파일의 규칙에 따라 처리

Config를 선택하면 현재 사용 중인 구성 파일과 그 안의 규칙에 따라 요청이 처리됩니다. Config로 이동해 실제로 어떤 파일이 선택되어 있는지 확인한 다음 Rule 등의 항목을 살펴보세요. 파일을 Config 목록에 가져오기만 했다고 현재 적용되는 것은 아닙니다. 앱에 표시된 선택 상태를 확인해야 합니다. 확인된 구성이 있다면 처음 연결하기 전에 복잡한 규칙을 추가할 필요 없이 기존 파일을 사용하세요.

규칙에는 일반적으로 조건과 동작이 포함됩니다. PROXY는 해당 프록시 정책에 따라 처리하고, DIRECT는 대상에 직접 연결하며, REJECT는 조건에 일치하는 요청을 거부합니다. 규칙에서 특정 정책 이름을 참조할 수도 있으므로 구성 파일을 함께 확인해야 합니다. 규칙은 순서대로 적용되므로 앞에 있는 조건이 먼저 결과를 결정할 수 있습니다. FINAL은 앞선 규칙과 일치하지 않은 요청을 처리하며, 이때의 동작도 최종 경로에 영향을 줍니다. 이러한 기준을 이해해야 연결을 켰는데도 일부 요청이 직접 연결되는 이유를 파악할 수 있습니다.

Proxy와 Direct

Proxy는 프록시 경로로 요청을 처리하므로 서버 연결 상태와 규칙이 예상대로 작동하는지 각각 확인할 때 유용합니다. 다만 모든 대상에 접속할 수 있다고 보장하지는 않습니다. Direct는 직접 연결 경로를 사용합니다. 현재 대상에 프록시 경로가 필요한 경우 Direct를 선택한 뒤 접속되지 않더라도 서버 정보가 잘못됐다고 단정할 수 없습니다. 문제를 확인한 뒤에는 일상 사용에 적합한 모드로 되돌리세요.

처음 확인할 때는 모드를 하나로 명확히 선택하고 같은 대상을 테스트하세요. 신뢰할 수 있는 구성을 보유하고 규칙에 따라 사용하려면 Config를 선택하세요. 규칙의 영향을 잠시 배제하려면 기존 설정을 기록한 뒤 Proxy로 바꿔 비교할 수 있습니다. 지연 시간 테스트에 한 번 성공했다고 필요에 맞지 않는 모드를 계속 사용하지 말고, 세 가지 모드를 서로 다른 서버라고 생각하지도 마세요.

오른쪽 스크린샷은 Config 편집 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption을 보여줍니다. 처음 연결할 때 이 항목을 하나씩 수정할 필요는 없으며, 이 가이드를 따라 하기 위해 HTTPS Decryption을 조정할 필요도 없습니다. 현재 구성이 예상한 내용과 일치하는지 확인한 뒤 계속 진행하세요. 규칙 키워드와 조건에 관한 자세한 설명은 규칙 및 인터페이스 용어 설명에서, 파일 관리는 구독 가이드에서 확인할 수 있습니다.

Shadowrocket 공식 Config 편집 스크린샷: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 구성(Config) 모드에서는 현재 파일과 Rule 내용을 함께 확인해야 합니다.
단계 03 · 시스템 연결 설정

Home에서 서버 선택 및 연결

라우팅 모드를 확인한 뒤 Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하세요. 먼저 항목 옆에 선택 표시가 있는지 확인하고, Global Routing이 앞에서 설정한 모드로 유지되는지도 살펴보세요. 구독에 여러 항목이 있다면 정보가 명확하고 현재 사용할 수 있는 항목 하나를 선택해 확인하세요. 브라우저를 새로고침할 때마다 임의로 서버를 바꾸면 결과를 비교하기 어렵습니다.

그런 다음 Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 Not Connected와 같은 안내가 표시됩니다. 스위치를 켠 뒤에는 버튼 위치만 보지 말고 상태가 바뀌는지 확인하세요. 처음 연결할 때 시스템에서 VPN 구성 추가 승인 안내가 나타날 수 있습니다. 안내를 읽고 시스템 요구에 따라 승인하고, 필요한 경우 기기 인증을 완료하세요. 이 승인은 Shadowrocket이 시스템 네트워크 연결을 설정하도록 허용하는 것으로, 구독을 가져오거나 서버 정보를 자동으로 채워 주지는 않습니다.

시스템 확인을 마친 뒤 Shadowrocket으로 돌아와 연결 상태가 업데이트될 때까지 기다리세요. 앞서 승인을 취소했다면 앱에서 다시 연결을 시작하고 안내에 따라 처리하세요. 스위치를 빠르게 반복해서 켰다 끄지 마세요. 안내가 처리됐는지, 상태가 안정적인지 확인한 뒤 다음 작업을 결정하세요. 기기에서 다른 VPN 구성이 작동 중이라면 실제로 어느 구성이 활성화되어 있는지도 확인해야 다른 연결 상태를 현재 결과로 착각하지 않습니다.

연결 상태와 실제 접속을 각각 확인

연결 스위치가 켜져 있다는 것은 클라이언트가 연결 중이거나 연결을 설정했다는 의미지만, 대상 웹사이트, DNS, 모든 프로토콜 트래픽이 정상이라는 뜻은 아닙니다. 다음 단계에서 계속 확인하고 Settings를 대거 수정하지 마세요. 특히 Config에서는 일부 요청이 Rule에 따라 DIRECT로 처리되는 것이 정상일 수 있습니다. 특정 페이지의 접속 경로만 보고 전체 연결이 실패했다고 판단하면 안 됩니다.

브라우저로 이동하기 전에 현재 서버 이름과 Global Routing을 기록해 둘 수 있습니다. Home으로 돌아왔을 때 연결이 끊긴 상태라면 오류 안내가 있는지 확인하세요. 연결 상태는 유지되지만 웹페이지가 열리지 않는다면 ‘연결은 됐지만 접속에 문제가 있는’ 상황으로 분류하고 다섯 번째 단계에서 차례로 확인하세요. 두 경우에 필요한 점검 항목이 다르므로 구분하면 같은 정보를 반복해서 입력하는 일을 줄일 수 있습니다.

이번에는 수동 연결만 사용하고 On Demand 자동 실행은 잠시 사용하지 마세요. 수동 연결을 확인한 뒤 자동 연결 조건을 설정하면 시스템의 자동 실행 문제와 서버 문제를 구분하기 쉽습니다. 테스트가 끝나고 당분간 연결이 필요 없다면 Home에서 스위치를 끄세요. 이후 On Demand를 설정했다면 연결이 다시 시작될 수 있는지도 함께 확인해야 합니다.

Shadowrocket 공식 Home 스크린샷: Not Connected 스위치, Global Routing, Connectivity Test, SERVER 그룹 및 Add Server 표시
Home: 먼저 SERVER 항목을 선택한 다음 상단의 연결 스위치를 켜세요.
단계 04 · 실제 접속 결과 확인

Connectivity Test 및 실제 접속 확인

방금 선택한 서버와 Global Routing 설정을 그대로 유지한 채 Home에서 Connectivity Test를 실행하고 현재 선택된 항목의 결과를 확인하세요. 이 테스트는 연결 상태를 파악하는 데 참고가 되지만 모든 웹페이지에 접속할 수 있음을 보증하지는 않습니다. Test Method마다 테스트 방식이 다릅니다. 한 가지 방법에서 응답을 받았다고 해서 모든 도메인 해석, 인증, 실제 접속이 정상이라고 단정할 수는 없습니다.

그다음 브라우저를 열고 평소 정상적으로 사용하는, 내용이 명확한 페이지에 접속해 보세요. 페이지 로딩이 시작될 뿐 아니라 텍스트와 필요한 리소스가 모두 표시되는지 확인한 뒤 이번에 확인할 대상에도 접속합니다. 기본 접속을 먼저 확인하고 특정 대상을 확인하면 네트워크 전체 문제와 특정 대상의 문제를 구분할 수 있습니다. 이전에 열었던 페이지라면 다시 로드하고 캐시된 내용만 표시되는 것은 아닌지 살펴보세요. 기존 페이지가 보인다고 새 요청이 완료된 것은 아닙니다.

규칙에 따른 분기를 확인하려면 Config에서 실제로 일치한 규칙을 살펴보세요. DIRECT로 처리되어야 하는 대상은 직접 연결 규칙에 따라 처리되어야 하고, PROXY 대상은 프록시 경로를 확인하는 데 사용해야 합니다. REJECT 규칙에 일치한 요청이 차단되는 것은 해당 동작의 결과입니다. 요청 기록을 볼 수 있다면 대상 도메인, 일치한 규칙, 동작을 함께 확인하세요. 서버 이름이나 테스트 수치만 확인하지 마세요. 특정 외부 IP 주소를 보여주는 페이지는 해당 요청의 연결 경로만 나타낼 뿐, 모든 앱과 연결을 대표하지 않습니다.

결과가 일치하지 않으면 먼저 현재 상태를 기록하세요. 예를 들어 “Connectivity Test 결과는 있지만 브라우저에서 도메인 해석 실패가 표시됨”은 DNS 해석 또는 대상 접속 문제로 기록합니다. “스위치를 켜자마자 연결이 끊김”이라면 승인, 서버 정보, 시스템 연결 상태부터 확인하세요. 현상을 구체적으로 적어 두는 편이 구독을 반복해서 업데이트하는 것보다 효과적이며, 다음 문제 해결 단계도 선택하기 쉽습니다.

비교 테스트를 할 때는 한 번에 하나의 조건만 변경하세요. 대상은 그대로 두고 다른 서버 하나만 선택하거나, 서버를 유지한 채 Proxy와 Config를 비교할 수 있습니다. 변경할 때마다 다시 접속해 차이를 기록하세요. 서버, DNS, 규칙, 테스트 방식을 동시에 바꾸면 접속이 다시 되더라도 원인을 알기 어렵습니다. 확인이 끝나면 일상적으로 사용할 구성으로 되돌리고, 정상 작동을 확인한 설정을 보관하세요.

단계 05 · 원인을 단계별로 확인

자주 발생하는 문제와 확인 순서

문제가 생기면 가장 기본적인 순서부터 확인하세요. 기기 기본 네트워크, 가져온 정보, 현재 선택 항목, 연결 상태, 대상 접속 순입니다. 처음부터 모든 구성을 삭제하지 마세요. 사용할 수 있는 백업이 있다면 보관하세요. 백업이 없다면 현재 설정과 오류 문구를 먼저 기록한 뒤 되돌릴 수 있는 범위에서 조금씩 조정하세요.

가져온 뒤 SERVER에 항목이 표시되지 않음

Subscribe를 사용했는지 확인하고 URL이 완전한지 살펴보세요. 구독 주소와 관리 페이지 주소는 다릅니다. 브라우저에서 관리 페이지가 열리더라도 해당 주소를 바로 가져올 수 있다는 뜻은 아닙니다. 업데이트 중 오류가 발생하면 오류 유형을 기록하고 본인의 서비스 상태와 링크 유효성을 확인하세요. 같은 이름의 그룹을 계속 만들지 마세요. 서버를 직접 추가했다면 Add Server로 돌아가 저장이 완료됐는지, 특히 필수 항목을 빠뜨리지 않았는지 확인하세요.

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

먼저 시스템 VPN 구성 승인 절차를 마쳤는지 확인한 다음 선택한 서버의 Type, Host, Port와 인증 항목을 살펴보세요. 비밀번호는 대소문자를 구분하며, 포트는 제공된 정보와 일치해야 합니다. 프로토콜에 필요한 추가 항목도 임의로 생략하면 안 됩니다. 그다음 기기 네트워크 자체가 정상인지 확인하세요. 연결을 잠시 끄고 평소 사용하는 페이지에 접속해 기본 연결을 점검한 뒤 Shadowrocket으로 돌아오세요. 네트워크를 바꿔 비교할 때는 다른 설정을 그대로 유지해 한 번에 여러 조건을 바꾸지 않도록 하세요.

테스트 결과는 있지만 웹페이지가 열리지 않음

먼저 브라우저에 표시된 오류가 DNS 해석 실패, 연결 시간 초과, 인증서 문제, 웹사이트 자체 오류 중 무엇인지 확인하세요. 그런 다음 Global Routing을 살펴보세요. Config에서는 실패하고 Proxy에서는 정상이라면 현재 Config의 Rule, 정책 참조, FINAL을 중점적으로 확인하세요. 두 모드 모두 실패한다면 서버와 DNS 관련 설정을 계속 살펴보세요. 모든 오류를 DNS 탓으로 돌리지 말고, 테스트가 한 번 정상이라고 서버 연결 문제를 완전히 배제하지도 마세요.

Settings에서 Test Method와 Diagnostics 등의 메뉴를 찾을 수 있습니다. Test Method에서는 현재 테스트 방식을 확인하고, Diagnostics는 추가 진단 정보를 살펴볼 때 사용할 수 있습니다. 실제 이용 가능한 항목은 앱에 표시되는 내용을 기준으로 합니다. 테스트 당시의 네트워크, 선택한 항목, 라우팅 모드, 오류 현상을 기록해야 전후 결과를 비교할 수 있습니다. DNS는 구성의 해석 경로와 네트워크 조건에 따라 달라질 수 있으므로 현재 설정을 이해한 뒤 필요한 부분을 조정하세요. 자세한 용어는 DNS 및 네트워크 용어 설명에서 확인할 수 있습니다.

일부 대상만 실패하거나 연결이 반복해서 복구됨

특정 대상만 실패한다면 해당 도메인에 REJECT 규칙이 적용됐는지, 적절하지 않은 DIRECT 규칙에 일치했는지, 페이지 리소스가 다른 도메인에서 제공되는지 확인하세요. 한 페이지 때문에 모든 규칙을 삭제하지 마세요. 더 자세히 확인하려면 Config에서 실제 규칙 적용 순서를 살펴보고 기능 및 규칙 분기 안내를 참고해 각 동작의 차이를 파악하세요.

수동으로 연결을 끈 뒤 다시 연결된다면 Settings에서 On Demand와 관련 실행 조건을 확인하세요. 자동 연결은 연결을 시작하는 시점을 정할 뿐, 서버에 접속할 수 있음을 보장하지 않습니다. 관련 자동 실행을 잠시 중지하고 수동 테스트를 마친 다음 항목별로 다시 설정하세요. ‘자동 재연결’과 ‘사용 가능 여부 확인’을 같은 의미로 보면 안 됩니다. 이전, 구독 업데이트, 일괄 삭제는 첫 연결에 필요한 작업이 아닙니다. 진행하기 전에 구독 및 서버 관리 가이드의 정리와 백업 안내를 읽어보세요.

이 가이드에 따라 한 번 연결을 완료하면 평소에는 선택한 항목, Global Routing, 연결 상태만 확인하면 됩니다. 규칙을 추가하거나 On Demand를 켤 때도 ‘작은 범위로 변경하고, 실제 접속을 확인하고, 복구할 수 있는 설정을 보관’하는 순서를 따르세요. 매번 처음부터 다시 가져올 필요는 없습니다.

Shadowrocket 공식 Settings 스크린샷: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: Test Method, On Demand, Diagnostics를 확인하고 증상에 따라 하나씩 점검하세요.