공식 가이드 · 초기 설정

Shadowrocket 설정 가이드

기존 서버 또는 구독을 추가한 뒤 트래픽 분기를 설정하고 연결을 켜세요. 실제 요청을 보내 결과를 확인하는 순서로 안내합니다.

01 정보 가져오기

Add Server에서 서버를 추가하거나 구독 가져오기

Shadowrocket을 열고 Home으로 이동합니다. SERVER 영역에서 Add Server를 찾아 추가 화면을 엽니다. 보유한 정보의 종류를 확인하세요. 프로토콜, 호스트, 포트 등의 정보가 한 세트로 제공되면 서버 하나를 추가하면 됩니다. 서비스 제공자가 준 구독 주소는 여러 항목을 가져올 때 사용합니다. 구독 주소를 서버 하나의 Host 항목에 붙여 넣지 마세요.

서버 하나를 직접 입력하기

먼저 Type에서 제공받은 정보에 적힌 프로토콜을 선택한 뒤, 선택한 유형에 따라 화면에 표시되는 항목을 확인합니다. 스크린샷의 항목을 예로 들면 Host에는 호스트 이름이나 주소를, Port에는 포트 번호를 입력합니다. 해당 유형에 Password 또는 Method가 표시되면 제공받은 정보에 따라 각각 입력하거나 선택하세요. 다른 프로토콜의 같은 이름 항목을 참고해 값을 추측하지 마세요. 붙여 넣은 뒤 앞뒤에 불필요한 공백이 없는지 확인하고, 호스트와 포트 전체를 하나의 항목에 입력하지 않도록 주의합니다. 저장한 다음 Home으로 돌아가 새 항목이 SERVER에 표시되는지 확인합니다.

Subscribe로 기존 구독 가져오기

Add Server에서 Subscribe를 선택하고 서비스 제공자가 준 구독 주소 전체를 주소 입력란에 넣은 다음 저장합니다. 복사할 때 물음표 뒤의 매개변수를 지우지 말고, 링크와 메모를 함께 붙여 넣지 마세요. Home으로 돌아가 목록이 로드되면 해당 그룹을 펼쳐 선택 가능한 서버가 있는지 확인합니다. 그룹은 표시되지만 항목이 없다면 구독을 불러오는 과정부터 확인하세요. 빈 그룹을 가져오기가 완료된 상태로 간주하지 마세요.

서버 하나의 QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 인식된 뒤에도 유형과 주요 항목을 확인해야 합니다. 스크린샷의 Import from Cloud JSON은 별도의 가져오기 기능이며 Subscribe를 대신하지 않습니다. 목록을 확인한 뒤 다음 단계에서 테스트할 항목을 기억해 두세요. 먼저 트래픽 처리 방식을 정하고 연결을 켭니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method와 하단의 가져오기 메뉴 두 개가 표시됩니다.
Add Server: 먼저 Type을 선택한 뒤 해당 유형에 필요한 항목을 입력합니다.

02 모드 선택

Global Routing에서 트래픽 처리 모드 선택

Home으로 돌아가 Global Routing을 엽니다. 여기서는 트래픽 처리 방식을 정하며, 서버 선택이나 연결 시작을 하는 것은 아닙니다. 일반적인 규칙 분기를 확인하려면 우선 Config를 사용하세요. 단순 비교 테스트를 하려면 나머지 두 모드를 잠시 선택한 뒤, 테스트를 마치면 원래 옵션으로 되돌립니다.

  • Config: 현재 구성 파일의 규칙에 따라 요청을 프록시, 직접 연결 또는 지정된 다른 정책으로 처리합니다. 대상에 따라 트래픽이 예상대로 분기되는지 확인할 때 적합합니다.
  • Proxy: 클라이언트가 처리하는 트래픽을 구성 파일의 규칙별 분기 대신 프록시 경로로 보냅니다. 선택한 서버가 실제 요청을 처리할 수 있는지 잠시 확인할 때 적합합니다.
  • Direct: 클라이언트가 처리하는 트래픽을 프록시 서버를 거치지 않고 전송합니다. 같은 기기와 네트워크에서 비교할 때 적합하며, Home의 연결 스위치를 끄는 것과는 다릅니다.

Config를 사용할 때 구성 파일 먼저 확인하기

Home의 Global Routing에 Config가 표시되면 현재 규칙을 사용하도록 선택된 상태입니다. 화면 하단의 Config는 구성 파일을 확인하고 관리하는 메뉴입니다. 이 메뉴를 열어 현재 선택된 파일을 확인한 다음 해당 편집 화면에서 Rule을 살펴봅니다. 파일 이름이 비슷하다는 이유만으로 두 구성의 내용이 같다고 판단하지 마세요. 스크린샷의 General, Hosts, Rule은 각각 용도가 다릅니다. 처음 트래픽 분기를 확인할 때는 주로 Rule을 보면 되며, 모든 항목을 수정할 필요는 없습니다.

예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 접미사에 일치하는 요청에 PROXY 정책을 적용한다는 뜻입니다. 실제로 확인할 때는 구성에 존재하는 대상을 선택하고, 앞에서 먼저 일치하는 규칙이 있는지와 일치하는 규칙이 없는 요청에 적용되는 기본 정책을 살펴봅니다. 처음 연결할 때 Add Rule을 누를 필요는 없습니다. 기존 규칙으로 먼저 확인하고 서버 문제와 규칙 문제를 구분할 수 있게 된 뒤 수정하세요. 프로토콜 매개변수는 기술 참고 자료에서, 모드별 용도는 프록시 모드에서 확인할 수 있습니다.

Shadowrocket의 Config 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시됩니다.
Config 편집 화면: Rule에서 규칙 내용과 순서를 확인합니다.

03 연결 설정

Home에서 연결 스위치 켜기

Home으로 돌아가 SERVER 아래에서 방금 가져온 그룹을 열고 사용할 서버를 선택합니다. 같은 그룹에 이름이 비슷한 항목이 여러 개 있다면 테스트하려는 항목을 제대로 선택했는지 먼저 확인하세요. 다음으로 현재 Global Routing 모드를 다시 확인해 앞선 비교 테스트에서 다른 옵션을 선택한 채 남겨 두지 않았는지 살펴봅니다. 규칙을 확인하려면 모드를 Config로 유지하세요.

페이지 상단에서 Not Connected 상태 옆에 있는 스위치를 켭니다. 처음 시작할 때 iPhone 또는 iPad에 VPN 구성을 추가하라는 시스템 안내가 표시될 수 있습니다. 안내가 방금 실행한 Shadowrocket에 해당하는지 확인한 다음 시스템 지시에 따라 허용하고 기기 인증을 완료합니다. Home으로 돌아가 연결 상태가 갱신될 때까지 기다리세요. 스위치를 켠 직후 Not Connected로 돌아오면 반복해서 켜고 끄지 말고 문제 해결 단계에 따라 권한과 연결 충돌을 확인하세요.

상단에 연결됨으로 표시되면 기기에서 연결이 설정된 것은 알 수 있지만, 선택한 서버가 작동하거나 특정 사이트에 예상한 규칙이 적용된다는 뜻은 아닙니다. 처음 테스트할 때는 가능한 한 기기의 네트워크를 그대로 유지하고 현재 서버, 모드, 구성 파일 이름을 기록해 두세요. 그러면 다음 단계에서 결과가 예상과 달라도 같은 조건으로 다시 확인할 수 있습니다.

Shadowrocket의 Home 화면. Not Connected 스위치, Global Routing, Connectivity Test, SERVER 그룹이 표시됩니다.
Home: 위쪽에는 연결 스위치, 아래쪽에는 서버 목록이 있습니다.

04 결과 확인

Connectivity Test와 실제 요청으로 확인

먼저 Home에서 Connectivity Test를 누르고 테스트 결과가 갱신될 때까지 기다립니다. 방금 선택한 항목의 결과를 확인하고, 주변 서버의 결과로 판단하지 마세요. 사용 가능 결과가 표시되면 해당 항목이 당시 네트워크와 테스트 방법에서 응답했다는 뜻입니다. 시간 초과가 발생해도 구성 오류라고 단정할 수 없습니다. 테스트 대상에 연결할 수 없거나 현재 네트워크가 불안정해도 같은 현상이 나타날 수 있습니다. 실제 용도를 확인하려면 이어서 실제 요청을 보내야 합니다.

Config 모드에서 두 가지 경로 확인

Config를 사용할 때 현재 구성에서 DIRECT로 처리될 대상과 PROXY로 처리될 대상을 각각 하나씩 찾습니다. 브라우저나 해당 앱을 열어 요청을 새로 보내고 캐시된 콘텐츠가 표시되는 것은 아닌지 확인하세요. 요청의 매칭 기록을 볼 수 있다면 요청 시각을 기준으로 실제 대상 도메인과 적용된 정책을 찾아 Rule의 규칙 순서와 비교합니다. 웹 주소창의 기본 도메인이 모든 요청의 대상인 것은 아닙니다. 페이지 이미지나 로그인 인터페이스는 다른 도메인을 사용할 수 있으므로 페이지가 열렸다는 사실만으로 모든 트래픽에 같은 규칙이 적용됐다고 판단할 수 없습니다.

결과가 예상과 다르면 조건 하나씩만 변경

프록시로 처리되어야 할 대상만 실패한다면 네트워크와 선택한 서버는 그대로 둔 채 Proxy로 잠시 바꿔 같은 대상을 다시 테스트합니다. Proxy에서는 작동하지만 Config에서 실패하면 대상에 실제로 적용된 규칙이나 정책을 먼저 확인하세요. 두 모드에서 모두 실패하면 서버 매개변수와 테스트 방법을 확인합니다. 직접 연결 경로를 비교하려는 경우에는 Direct로 잠시 전환해 서버를 거치지 않을 때 같은 대상이 어떻게 동작하는지 확인합니다. 테스트가 끝나면 원래 모드로 되돌리고 기존 설정으로 다시 시도하세요.

05 문제 원인 찾기

증상에 따라 Settings와 연결 조건 확인

가장 먼저 문제가 발생한 단계부터 확인합니다. 항목이 불러와지지 않으면 가져오기부터 살펴보고, 스위치가 켜진 상태를 유지하지 못하면 기기 연결을 확인합니다. 연결은 되지만 일부 요청이 실패한다면 서버, 테스트 방법, 규칙을 확인하세요. 한 번에 조건 하나만 변경한 뒤 방금 실패한 작업을 다시 수행합니다.

그룹이 비어 있거나 다시 가져와도 항목이 보이지 않음

Add Server로 돌아가 유형이 Subscribe로 선택되어 있는지 확인하고 주소 전체가 입력되었는지, 서비스 제공자가 현재 제공하는 주소인지 확인합니다. 서버를 직접 추가했다면 Type이 제공받은 정보와 일치하는지, Host와 Port를 바꿔 입력하지 않았는지 살펴봅니다. 같은 주소를 반복해서 가져와도 실패 원인을 파악하는 데 도움이 되지 않습니다. 문제 해결을 요청할 때는 오류 안내와 발생 단계를 기록하고 전체 구독 링크, 비밀번호, 키는 공유하지 마세요.

스위치가 다시 꺼지거나 연결을 끊은 뒤 자동으로 다시 연결됨

스위치가 다시 꺼지면 처음 표시된 시스템 안내를 승인했는지 확인하고, 기기에 다른 VPN 연결이 활성화되어 있는지 살펴봅니다. 조직에서 관리하는 기기는 구성 변경이 제한될 수 있으므로 관리 안내가 표시되면 기기 관리자에게 먼저 문의하세요. 반대로 수동으로 연결을 끊은 뒤 다시 연결된다면 Settings에서 On Demand가 켜져 있는지 확인합니다. 자동 연결이 발생한 당시의 네트워크 환경을 기록하고 온디맨드 연결 조건이 작동한 것인지 확인하세요. 자동 재연결과 서버 테스트 시간 초과를 혼동하지 마세요.

테스트 시간이 초과되거나 일부 앱에서만 접속 오류 발생

Settings에서 Test Method를 기록한 다음 Home으로 돌아가 같은 서버를 다시 테스트합니다. 동일한 구독에 다른 서버가 있다면 모드와 네트워크를 변경하지 않고 비교해 볼 수 있습니다. 한 항목만 실패하면 해당 항목의 매개변수를 먼저 확인합니다. 여러 항목이 모두 실패하면 기기의 기본 네트워크와 테스트 조건부터 살펴봅니다. 테스트 결과는 나오지만 일부 앱에서만 오류가 발생한다면 Diagnostics에서 확인할 수 있는 진단 정보를 살펴보고, 실패 시각과 대상 도메인, 실제 모드를 기록한 다음 확인 단계에 따라 원인을 찾습니다. 먼저 기록한 뒤 수정하세요. 규칙 변경, 서버 전환, 네트워크 변경을 동시에 하지 마세요.

Shadowrocket의 Settings 화면. Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 항목이 표시됩니다.
Settings: 테스트 방법, 온디맨드 연결, 진단 메뉴를 확인합니다.