공식 가이드 · 첫 연결

Shadowrocket 사용법

‘추가 → 경로 선택 → 연결 → 확인’ 순서로 기본 설정을 완료합니다. 각 단계의 결과를 확인한 뒤 다음 단계로 진행하세요. 처음부터 모든 Settings를 조정할 필요는 없습니다.

이미지는 App Store 공식 스크린샷으로, 화면과 입력 항목을 확인하는 데 사용됩니다. 실제 기기에 표시되는 화면을 기준으로 진행하세요. 스크린샷의 예시 항목은 사용할 수 있는 서비스 정보가 아닙니다.

STEP 01 / IMPORT

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

Shadowrocket을 열고 Home으로 이동합니다. 먼저 보유한 정보의 유형을 확인하세요. 서버 목록을 갱신하는 전체 링크라면 Subscribe로 가져오고, 프로토콜·서버 주소·포트·인증 정보가 있다면 서버를 직접 추가합니다. 두 정보는 용도가 다릅니다. 구독 링크를 Host에 입력하거나 웹사이트 주소를 구독 주소로 사용하지 마세요.

서버 정보가 하나만 있는 경우

  1. Home에서 Add Server를 탭해 추가 화면으로 이동합니다. 먼저 Type을 보유한 서버 정보에 맞게 선택하세요. Type에 따라 입력해야 할 항목이 달라집니다. 유형을 잘못 선택하면 주소와 포트가 정확해도 연결되지 않을 수 있습니다.
  2. 보유한 정보에 따라 Host와 Port를 입력합니다. Host는 서버의 호스트 이름이나 주소이지 구독 링크가 아닙니다. Port는 해당 서비스가 사용하는 포트입니다. 복사한 뒤 앞뒤에 공백이나 줄바꿈이 들어가지 않았는지 확인하세요.
  3. 선택한 유형에 필요한 인증 항목을 입력합니다. 공식 스크린샷의 Password와 Method는 스크린샷에 선택된 유형에 해당하며, 다른 유형에서는 다른 항목이 표시될 수 있습니다. 인증 정보, 암호화 방식 및 기타 연결 매개변수를 보유한 정보와 하나씩 대조하세요. 이름이 비슷하다는 이유로 임의로 바꾸지 마세요.
  4. 입력 내용을 확인하고 저장한 뒤 Home으로 돌아가 SERVER 그룹에 추가한 항목이 표시되는지 확인합니다. 사용할 서버를 탭해 선택하세요. 항목이 표시되는 것은 정보가 저장되었다는 뜻일 뿐이며, 연결 가능 여부는 이후 단계에서 확인해야 합니다.

구독 링크가 있는 경우

Add Server의 Type에서 Subscribe를 선택한 다음 해당 URL 입력란에 전체 구독 링크를 붙여 넣고 저장합니다. Home으로 돌아가 가져오기가 완료될 때까지 기다린 후 해당 그룹을 펼쳐 서버가 표시되는지 확인하세요. 항목이 로드되지 않았다면 구독 항목의 업데이트 기능으로 다시 요청할 수 있습니다. 처음에 시간이 걸린다고 같은 구독을 여러 개 만들지 마세요.

구독 링크에 접속 정보가 포함될 수 있으므로 신뢰할 수 있는 곳에 보관하고 공개 스크린샷, 댓글 또는 문제 해결 기록에 올리지 마세요. 링크의 매개변수를 임의로 삭제해서는 안 됩니다. 메신저에서 줄바꿈이 들어가거나 링크가 일부만 복사되어도 가져오기에 실패할 수 있습니다. 업데이트가 완료되면 기존 서버 하나를 선택한 뒤 경로 방식을 선택하세요. 구독 목록 업데이트와 Config 설정 파일 업데이트는 서로 다른 작업입니다. 전자는 주로 서버 정보를 바꾸고 후자는 규칙 등의 설정에 영향을 줍니다.

Scan QR Code는 보유한 유효한 서버 QR 코드를 스캔할 때 사용합니다. Import from Cloud JSON은 해당 형식의 가져오기 기능입니다. 모든 텍스트를 인식한다는 뜻은 아닙니다. 정보 형식이 확실하지 않다면 원본 형식부터 확인하고, 가져오기 방식을 반복해서 바꾸지 마세요. 지원 형식과 업데이트 오류는 문제 해결에서 더 확인할 수 있습니다.

Shadowrocket Add Server 화면: Type, Host, Port, Password, Method 및 하단의 가져오기 메뉴 표시
Add Server: Type을 먼저 선택한 뒤 보유한 정보에 맞게 입력하세요. 유형에 따라 인증 항목이 다를 수 있습니다.

STEP 02 / ROUTING

Global Routing: Config, Proxy 또는 Direct 선택

서버를 저장하고 선택한 뒤 Home으로 돌아가 Global Routing을 탭합니다. 이곳에서 전체 트래픽의 라우팅 방식을 정합니다. 프로토콜을 선택하거나 서버 정보를 자동으로 수정하는 기능은 아닙니다. 세 가지 방식은 Config, Proxy, Direct입니다. 처음 사용할 때는 각 방식의 용도를 확인한 뒤 현재 테스트 목적에 맞는 항목을 선택하세요.

Config: 현재 설정에 따라 트래픽 처리

Config를 선택하면 트래픽이 현재 활성화된 설정에 따라 처리됩니다. Config로 이동해 실제로 어떤 설정이 사용 중인지 확인한 다음 Rule을 살펴보세요. 공식 스크린샷에는 General, Rule, Hosts 등의 구역과 Add Rule 메뉴가 있는 설정 편집 화면이 표시됩니다. 설정 내용을 확인하는 화면이지 Global Routing 선택 메뉴 자체는 아닙니다.

규칙은 일반적으로 순서대로 매칭되며, 먼저 일치하는 규칙이 해당 요청의 정책을 결정합니다. PROXY는 해당 프록시 정책을 사용하고 DIRECT는 직접 연결합니다. 따라서 Config에서는 웹사이트에 따라 프록시를 사용하거나 직접 연결하는 것이 의도된 동작일 수 있습니다. 현재 설정을 확인하기 전에는 특정 웹사이트가 서버를 거치지 않았다는 이유만으로 연결 실패라고 판단하지 마세요.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

위 내용은 규칙 문법 예시입니다. example.com과 그 하위 도메인은 PROXY에 매칭되고, 매칭되지 않은 나머지 요청은 FINAL,DIRECT가 처리합니다. 완성된 설정이 아니며 기존 내용을 그대로 덮어쓰라는 뜻도 아닙니다.

Proxy와 Direct: 목적에 따라 선택하는 연결 방식

Proxy는 클라이언트가 처리하는 요청을 해당 모드의 프록시로 보내는 방식이며, 임시 비교 테스트에도 사용할 수 있습니다. 서버를 선택했다고 모든 웹사이트에 접속할 수 있는 것은 아닙니다. 서버 자체, 도메인 확인, 대상 사이트에 문제가 있을 수도 있습니다. Direct는 해당 트래픽을 선택한 프록시 서버를 거치지 않고 직접 연결하므로 기존 네트워크가 정상인지 확인할 때 유용합니다.

일상적으로 규칙에 따라 트래픽을 분류하려면 설정이 유효한지 확인한 뒤 Config를 사용하세요. 특정 오류가 규칙과 관련 있는지 확인하려면 현재 선택을 기록하고 잠시 Proxy로 바꿔 같은 대상에 다시 접속해 보세요. 테스트가 끝나면 원래 방식으로 되돌립니다. 비교 결과를 확인할 수 있도록 라우팅 방식만 바꾸고 서버와 설정은 동시에 변경하지 마세요. 규칙에 관한 자세한 내용은 문제 해결에서 확인할 수 있습니다.

Shadowrocket Config 설정 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 설정 편집 화면: Config를 선택한 경우 Home의 서버 선택만 확인하지 말고 현재 활성화된 설정과 Rule도 확인해야 합니다.

STEP 03 / CONNECT

Home: 연결 스위치 켜기

Home으로 돌아가 연결 전 마지막으로 확인합니다. SERVER에서 사용할 서버가 선택되어 있고 Global Routing에 앞서 결정한 방식이 표시되는지 확인하세요. Config를 사용하는 경우 Config에서 예상한 설정이 활성화되어 있어야 합니다. 유효한 서버를 선택하지 않은 상태에서 연결 스위치만 켜도 서비스 정보가 보완되지는 않습니다.

  1. Home 상단의 연결 스위치를 탭합니다. 공식 스크린샷의 Not Connected는 촬영 당시 연결되지 않은 상태라는 뜻입니다. 실제로 조작할 때는 상태가 바뀌는지 확인하세요.
  2. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 안내 내용을 확인하고 방금 직접 시작한 작업이 맞는지 확인한 다음, 시스템 절차에 따라 허용하고 기기에서 요구하는 인증을 완료하세요.
  3. Shadowrocket으로 돌아와 연결 상태가 안정될 때까지 기다립니다. 스위치가 바로 꺼지거나 연결 상태가 계속 설정되지 않으면 빠르게 반복해서 켜고 끄지 말고 아래의 문제 해결 단계를 확인하세요.

시스템의 VPN 권한은 앱이 해당 네트워크 연결 구성을 만들 수 있도록 허용합니다. 서버 서비스를 구매하거나 사용할 수 있게 되는 것은 아닙니다. 권한 승인과 원격 서버 접속 가능 여부는 별개입니다. 전자는 기기 시스템이 확인하며, 후자는 가져온 정보와 현재 네트워크, 원격 서비스 상태에 따라 달라집니다. 따라서 연결 상태가 바뀌어도 다음 단계에서 실제 접속을 확인해야 합니다.

기존 VPN 연결이 작동 중이라면 시스템 설정에서 현재 어떤 연결을 사용 중인지 먼저 확인하세요. 테스트 중 연결이 다른 항목으로 바뀌는 일을 방지할 수 있습니다. 첫 테스트에서는 On Demand를 함께 켤 필요가 없습니다. 먼저 수동으로 재현 가능한 연결을 만든 다음 경로가 올바른지 확인하고, 필요에 따라 자동 연결 조건을 살펴보세요.

iPad에서도 같은 순서로 Home, 서버 선택 및 시스템 권한을 확인합니다. 기기의 화면 공간에 따라 화면 배치는 달라질 수 있지만, 확인 기준은 현재 서버와 Global Routing, 연결 상태입니다. 스크린샷의 특정 위치를 기준으로 삼지 마세요.

Shadowrocket Home 화면: 상단에 Not Connected 연결 스위치, 아래에 Global Routing, Connectivity Test, SERVER 및 Add Server 표시
Home: 연결 전에 Global Routing과 SERVER 선택을 확인하고, 연결 후 Connectivity Test와 실제 접속 결과를 확인하세요.

STEP 04 / VERIFY

Connectivity Test: 테스트 및 접속 결과 확인

연결 스위치가 켜진 상태를 유지하면 Home에서 Connectivity Test를 실행해 서버 테스트 결과를 확인합니다. 테스트 결과는 연결 상태를 파악하는 데 도움이 되지만 테스트 방식과 대상, 당시 네트워크 환경에 따라 달라집니다. 한 번의 측정 결과가 모든 웹사이트에 접속할 수 있다는 보장은 아닙니다. 테스트 시간이 초과되더라도 실제 요청과 함께 판단하고, 한 번의 결과만으로 서버를 바로 삭제하지 마세요.

세 단계로 작동 여부 확인

  1. 먼저 연결이 유지되는지 확인합니다. Home으로 돌아가 상태가 연결 끊김으로 바뀌지 않았는지 확인하세요. 스위치가 켜진 상태를 유지하지 못한다면 권한이나 연결 설정 문제부터 해결해야 합니다. 아직 웹사이트 규칙을 판단할 단계가 아닙니다.
  2. 실제 접속을 확인합니다. 브라우저에서 접근 권한이 있고 테스트하려는 웹사이트를 열어 새 페이지 요청을 보냅니다. 이미 열려 있는 페이지나 캐시된 화면만 확인하지 마세요. 기기 상태 표시줄의 VPN 아이콘만으로 원격 사이트 접속 여부를 판단해서도 안 됩니다.
  3. 마지막으로 예상한 정책이 적용되는지 확인합니다. Config에서는 현재 규칙에 따라 대상 트래픽이 PROXY 또는 DIRECT 중 어디로 가야 하는지 확인합니다. Proxy에서는 선택한 서버를 확인하고, Direct에서는 요청이 선택한 프록시 서버를 거치지 않는다는 점을 고려하세요.

추가로 확인하려면 Data를 열어 테스트 중 트래픽 변화를 살펴볼 수 있습니다. 전체 사용량이 늘었다고 해서 각 웹페이지 요청에 같은 정책이 적용되었다고 단정할 수는 없습니다. 최신 웹페이지는 여러 도메인에 요청을 보낼 수 있습니다. 메인 페이지는 열리지만 이미지나 로그인 요청이 실패한다면 주소창의 도메인 하나만 확인하지 말고 관련 도메인과 규칙을 각각 점검하세요.

같은 대상이 Proxy에서는 정상이고 Config에서는 실패한다면 설정과 규칙의 매칭 순서를 먼저 확인하세요. 두 방식에서 모두 실패하지만 Direct로 다른 자주 방문하는 사이트에 접속할 수 있다면 서버 정보, 원격 서비스 상태 및 도메인 확인 문제를 집중적으로 살펴보세요. 같은 대상과 네트워크를 유지하고 조건을 하나씩 바꾸면 일시적인 변동을 설정 문제로 오해하지 않을 수 있습니다.

STEP 05 / DIAGNOSE

Settings: 실패 단계별 점검

문제가 생기면 먼저 어느 단계에서 실패했는지 확인합니다. 구독 가져오기 실패, 서버 테스트 실패, 연결 유지 실패, 일부 웹사이트만 접속 실패는 각각 점검 방향이 다릅니다. Settings의 스위치를 전부 바꾸거나 Config를 바로 덮어쓰지 마세요. 현상을 먼저 기록하고 정상 작동이 확인된 경로 하나를 비교 기준으로 유지합니다.

구독 가져오기 실패 또는 목록 미갱신

구독 항목으로 돌아가 전체 링크가 정확한지 확인하고, 링크가 유효하며 인식 가능한 형식인지, 현재 기기 네트워크에서 구독 주소에 접속할 수 있는지 확인합니다. 구독 요청에도 일반적으로 기본 네트워크 연결이 필요합니다. 사용할 수 있는 연결이 없다고 해서 작동하지 않는 연결을 켜면 구독이 자동으로 복구될 것이라고 기대해서는 안 됩니다. 기기의 날짜와 시간이 정확한지 확인한 뒤 다시 업데이트하세요. 업데이트에 실패해도 이전 목록이 남아 있을 수 있으므로 기존 항목이 보인다고 해서 이번 업데이트가 성공한 것은 아닙니다.

정보가 보유한 서비스에서 제공된 것이라면 유효 상태와 사용 조건을 확인하세요. 같은 링크를 반복해서 추가해도 해결되지 않습니다. 문제 해결 기록에는 필요한 오류 문구만 남기고 전체 구독 URL, 인증 항목 또는 접속 정보가 담긴 QR 코드를 공개하지 마세요.

서버는 표시되지만 테스트 또는 연결 실패

먼저 Type, Host, Port 및 인증 항목이 보유한 정보와 일치하는지 확인합니다. 특히 복사 과정에서 빠진 문자, 잘못된 포트, 맞지 않는 Method를 살펴보세요. 그런 다음 연결을 끊고 자주 방문하는 웹사이트를 열어 현재 Wi-Fi나 셀룰러 네트워크 자체가 작동하는지 확인합니다. 공용 네트워크에서 웹 로그인이 필요하다면 먼저 해당 네트워크의 접속 절차를 완료하세요.

Settings에서 Test Method 등 테스트 관련 항목을 확인할 수 있습니다. 서로 다른 테스트 방식의 결과를 동일한 지표로 간주하지 마세요. 한 가지 방식을 유지해 반복 테스트한 뒤 실제 웹사이트 접속 결과와 비교하세요. 기기 네트워크를 바꿀 때는 같은 서버와 같은 대상을 유지해 한 번에 여러 조건이 바뀌지 않도록 합니다.

스위치가 유지되지 않거나 끈 뒤 자동으로 다시 연결됨

시스템의 VPN 구성과 권한 상태를 확인하고 다른 연결이 현재 연결을 대체하고 있지 않은지 살펴보세요. 연결을 끈 뒤 다시 연결된다면 On Demand가 활성화되어 있는지, 어떤 조건이 설정되어 있는지 확인합니다. 수동으로 문제를 해결할 때는 원래 설정을 기록한 뒤 관련 자동 연결 동작을 잠시 중지해 테스트 중 연결 상태가 바뀌지 않도록 할 수 있습니다. 앱 화면을 닫는 것만으로 네트워크 연결이 끊긴다고 단정하지 말고 Home 또는 시스템 설정에서 실제 상태를 확인하세요.

일부 웹사이트만 접속되지 않음

Global Routing으로 돌아가 앞서 안내한 비교 방법으로 규칙 문제와 서버 문제를 구분합니다. Config 문제로 범위를 좁혔다면 현재 설정, Rule 순서 및 기본 처리 정책을 먼저 확인하세요. 도메인 확인이 관련된 경우에는 해당 DNS 설정을 살펴봅니다. 웹페이지 하나 때문에 HTTPS Decryption을 바로 켜거나 Proxy, TCP, UDP 설정을 크게 바꾸지 마세요. 이런 항목은 첫 연결에 필요한 설정이 아닙니다.

Diagnostics에서 추가 진단을 시작할 수 있습니다. 진단 기록을 사용할 때는 먼저 서버 인증 정보와 구독 접속 정보를 제거한 뒤 실패 단계를 보여주는 내용만 남기세요. 구독 업데이트, DNS 및 규칙 문제는 문제 해결에서 자세히 확인할 수 있습니다. 스토어 지역, 구매 및 기기 변경 후 복원에 관한 내용은 App Store 구입 안내를 참고하세요. 구매 문제를 해결하기 위해 연결 설정을 변경할 필요는 없습니다.

Shadowrocket Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: Test Method, On Demand 및 Diagnostics의 용도를 확인한 뒤 파악된 실패 단계에 맞춰 설정을 점검하세요.

첫 설정 완료 후 확인 목록

Home으로 돌아가 사용할 서버만 선택되어 있는지, Global Routing 방식이 평소 이용 목적에 맞는지, 연결 상태가 정상적으로 유지되는지 확인합니다. 실제 요청을 완료한 뒤 비교를 위해 임시로 선택했던 방식은 원래 기대한 설정으로 되돌립니다. ‘설정을 완벽히 마치기’ 위해 모든 기능을 켤 필요는 없습니다. 용도를 설명하고 결과를 확인할 수 있는 최소한의 변경만 유지하세요.

  • 기존 구독이 정상적으로 업데이트되고 서버 정보의 출처와 유효 상태를 확인했습니다.
  • 이번 접속 목적에 맞게 Config, Proxy 또는 Direct를 선택했습니다.
  • 연결 상태, Connectivity Test 및 실제 접속 결과를 각각 확인했습니다.
  • 구독 링크와 인증 정보가 공개 스크린샷이나 문제 해결 기록에 포함되지 않았습니다.

나중에 문제가 발생하면 이 페이지에서 해당 실패 단계를 먼저 확인한 다음 문제 해결을 살펴보세요. 앱 구매와 재설치는 App Store에서 처리하고, 기존 서버나 구독의 유효성은 보유한 서비스 정보를 바탕으로 확인해야 합니다. 두 문제를 혼동하지 마세요.

App Store에서 다운로드