Shadowrocket 공식 매뉴얼 · 빠른 시작

Shadowrocket 구독 가져오기 및 첫 연결

기존 구독 또는 서버 정보부터 시작해 “가져오기 → 모드 선택 → 연결 → 확인 → 문제 해결” 순서로 진행합니다. 먼저 하나의 항목으로 반복 가능한 접속 테스트를 마친 뒤 규칙을 추가로 조정합니다.

단계 01 · 먼저 정보 유형 확인

Add Server: 서버 추가 및 Subscribe

Shadowrocket을 열고 Home으로 이동한 다음 SERVER 그룹 근처에서 Add Server를 찾습니다. 페이지의 추가 버튼을 사용해도 됩니다. 먼저 보유한 정보가 무엇인지 확인합니다. 여러 서버 항목을 일괄 업데이트하는 주소는 구독 링크이고, 주소·포트·프로토콜 및 인증 매개변수의 조합은 단일 서버 정보입니다. 두 입력 방식을 혼용하지 마세요. 특히 구독 주소 전체를 Host에 입력하면 안 됩니다.

기존 구독 링크가 있는 경우

Add Server로 이동한 뒤 Type을 열어 Subscribe를 선택하고, 본인의 구독 링크를 해당 주소 입력란에 붙여 넣습니다. 인터페이스에 메모 입력란이 있다면 출처를 식별하기 쉬운 이름을 적고 저장합니다. Home으로 돌아와 구독을 업데이트하고, 파싱이 완료될 때까지 기다린 다음 SERVER에 실제 서버 항목이 표시되는지 확인합니다. 구독 주소를 저장하는 것과 서버 항목을 가져오는 것은 별개의 작업입니다. 구독 이름만 있고 선택 가능한 서버가 없다면 바로 연결 단계로 넘어가면 안 됩니다.

붙여 넣기 전에 링크의 시작과 끝을 확인해 공백, 줄바꿈, 채팅 설명 또는 한글 문장 부호가 섞이지 않았는지 확인합니다. 링크의 매개변수는 인증 정보인 경우가 많으므로 임의로 삭제하거나 수정하지 말고 공개해서도 안 됩니다. 업데이트 후 오류가 표시되거나 목록이 비어 있으면 원래 주소를 보관하고 오류 안내를 확인하세요. 같은 구독을 연속해서 중복 추가하지 마세요. 구독 만료 여부와 현재 요청의 허용 여부는 사용자가 이미 이용 중인 서비스 제공업체에 확인해야 합니다. 이 상태는 클라이언트 설치나 구매 여부에 따라 결정되지 않습니다.

단일 서버 정보가 있는 경우

Type에서 실제 프로토콜을 선택한 다음 원본 정보에 따라 Host, Port 및 해당 프로토콜에 필요한 인증 필드를 입력합니다. Shadowsocks의 경우 Password와 Method를 확인해야 합니다. 다른 프로토콜을 선택하면 필드가 달라질 수 있으므로 화면에 보이는 필드 조합을 그대로 따라 입력하지 마세요. Host에는 일반적으로 서버 도메인 또는 IP 주소를 입력하고, Port에는 포트 번호를 입력합니다. 비밀번호와 기타 인증 값은 대소문자를 포함해 원본 그대로 입력합니다.

가져올 수 있는 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. Import from Cloud JSON은 해당 JSON 데이터 출처를 위한 기능이며 임의의 구독 링크를 대신 가져오는 일반적인 방법은 아닙니다. 가져온 뒤에도 항목을 열어 프로토콜과 주소가 기존 정보와 일치하는지 확인합니다. 마지막으로 저장하고 Home으로 돌아가 SERVER 그룹에 선택 가능한 항목이 있는지 확인한 뒤 Global Routing을 선택합니다. 프로토콜 필드의 차이는 용어 매뉴얼에서 확인할 수 있습니다. 이 단계에서는 아직 이해하지 못한 고급 매개변수를 변경할 필요가 없습니다.

Shadowrocket Add Server 페이지: Type, Host, Port, Password, Method 필드와 QR 코드 및 JSON 가져오기 메뉴
공식 스크린샷 · Add Server. 서버 필드 조합을 보여 주며 실제 필드는 Type에 따라 달라집니다.
단계 02 · 트래픽 처리 방식 선택

Global Routing: 세 가지 모드 선택

서버를 가져온 다음에는 연결 스위치를 바로 켜지 마세요. Home에서 Global Routing을 열고 현재 Config, Proxy 또는 Direct 중 무엇을 사용하는지 확인합니다. 서버 항목은 “어떤 서버를 사용할지”를 정하고, Global Routing은 “요청을 어떤 방식으로 처리할지”를 정합니다. 서버를 선택했더라도 전역 모드를 잘못 선택하면 접속 결과가 예상과 다를 수 있습니다.

  1. 구성(Config): 현재 구성 파일의 규칙에 따라 요청을 PROXY, DIRECT 또는 REJECT로 처리합니다. 규칙 분할을 사용하는 일상적인 환경에 적합하지만, 올바른 구성을 선택했고 규칙이 대상에 맞아야 합니다.
  2. 프록시(Proxy): 요청을 전역 프록시 모드로 처리합니다. 서버와 Config 규칙 중 어느 쪽에 문제가 있는지 구분할 때 잠시 사용할 수 있습니다. 특정 웹사이트의 규칙을 자동으로 생성하는 기능은 아닙니다.
  3. 직접 연결(Direct): 요청을 직접 연결 방식으로 처리합니다. 프록시 서버가 정상 작동하는지 확인하는 데 사용하지 마세요. 원래 네트워크의 접속 상태를 비교할 때 잠시 사용할 수 있으며, 테스트 후에는 원하는 모드로 되돌립니다.

Config를 사용하려면 하단의 Config 페이지를 열어 원하는 구성 파일이 선택되어 있는지 확인합니다. 서버 구독과 구성 파일은 서로 다른 정보입니다. 전자는 연결 가능한 항목을 관리하고, 후자는 규칙 및 기타 설정을 포함합니다. 구독을 업데이트해 서버 항목이 늘어났다고 Config의 분할 규칙까지 업데이트된 것은 아닙니다. 구성 편집 페이지에는 General, Rule, Hosts, URL Rewrite 등의 섹션이 표시됩니다. 처음 사용하는 경우 Rule의 실제 내용만 확인하고 여러 섹션을 동시에 수정하지 않아도 됩니다.

아래 조각은 규칙 순서를 이해하기 위한 예시이며, 새 사용자가 기존 구성을 즉시 교체할 필요는 없습니다. example.com 및 하위 도메인은 PROXY로 보내고 나머지 요청은 DIRECT로 처리하는 예입니다. 예시 도메인은 문법을 보여 주기 위한 것이며 실제 테스트 대상이 아닙니다. 실제로 구성하기 전에는 본인의 대상으로 바꾸고 기존 구성의 사본을 보관하세요.

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

Rule은 일반적으로 위에서 아래 순서로 일치 여부를 확인합니다. FINAL은 기본 처리에 사용할 위치에 두어야 합니다. 너무 앞에서 일치하면 뒤에 있는 대상 규칙은 해당 요청을 처리하지 못합니다. 규칙을 추가하려면 Add Rule을 사용하고 저장 후 순서를 확인합니다. 규칙 유형, 정책 및 우선순위에 대한 자세한 설명은 규칙 및 구성 참고에서 확인하세요. 모드와 구성을 확인한 뒤 Home으로 돌아가 다음 단계에서 연결을 설정합니다. 구성 편집과 연결 문제를 한꺼번에 확인하지 마세요.

Shadowrocket Config 편집 페이지: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule
공식 스크린샷 · Config 편집 페이지. Global Routing은 Home에서 선택하고 Rule은 구성 파일에서 확인합니다.
단계 03 · 항목을 선택한 뒤 연결

Home: 연결 시작 및 시스템 권한 승인

Home으로 돌아와 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시가 원하는 항목에 있는지 확인합니다. 비슷한 이름의 항목이 여러 개라면 항목을 열어 Host와 Port를 확인한 다음 돌아와 선택합니다. 한 번에 하나의 서버만 테스트하세요. 스위치를 켜는 동안 항목을 반복해서 바꾸면 실패 원인이 된 매개변수를 확인하기 어렵습니다.

Global Routing에 방금 선택한 모드가 표시되는지 확인한 다음 상단의 Not Connected 근처에 있는 연결 스위치를 켭니다. 처음 연결할 때 iPhone / iPad에서 VPN 구성을 추가할지 묻습니다. Shadowrocket에서 요청한 작업인지 확인하고 시스템 안내에 따라 허용한 다음 기기 암호 또는 생체 인증을 완료합니다. 이 요청을 취소했다면 앱에 필요한 권한이 부여되지 않은 상태입니다. 모든 서버를 다시 가져오지 말고 Home으로 돌아와 연결을 다시 시도하세요.

권한 승인을 마친 뒤 앱으로 돌아와 상단 상태가 바뀌는지, 스위치가 계속 켜져 있는지 확인합니다. 시스템 상태 영역에 VPN 표시가 나타나는지는 기기 및 현재 화면에 따라 달라질 수 있으므로 표시만으로 결과를 판단하지 마세요. 연결이 수립되었다는 것은 시스템 수준의 연결 절차가 진행되었다는 뜻이며, 대상 웹사이트, DNS 및 분할 규칙이 모두 확인되었다는 뜻은 아닙니다. 따라서 이 단계를 마친 뒤 실제 접속과 테스트를 진행해야 합니다.

스위치가 바로 꺼지면 표시된 시스템 안내나 앱 오류 문구를 기록합니다. 기기에 현재 작동 중인 다른 VPN 구성이나 관리 정책이 있는지 확인해 연결 설정이 서로 영향을 주지 않도록 합니다. 관리되는 기기에서는 조직의 요구사항을 따르고 관리 구성을 임의로 삭제하지 마세요. 직접 관리할 수 있는 다른 연결은 먼저 중지한 뒤 다시 시도합니다. 시스템 권한 승인을 마쳤는데도 계속 실패한다면 마지막 단계에서 실패 지점에 따라 확인합니다.

연결을 중지하려면 Home으로 돌아와 상단 스위치를 끕니다. 처음 문제를 확인할 때는 “끄기 → 상태 확인 → 다시 켜기”를 한 번 진행해 현재 구성을 다시 적용할 수 있습니다. 스위치를 빠르게 연속해서 누르지 마세요. 연결 상태가 안정되면 현재 서버와 Global Routing 선택을 유지한 채 다음 단계에서 확인합니다. 이렇게 하면 각 테스트의 시작 상태를 분명히 알 수 있습니다.

Shadowrocket Home 페이지: 상단 Not Connected 스위치, Global Routing, Connectivity Test, SERVER 그룹 및 Add Server
공식 스크린샷 · Home. 서버와 Global Routing을 선택한 뒤 상단 연결 스위치를 켭니다.
단계 04 · 연결과 실제 접속 구분

Connectivity Test: 적용 여부 확인

연결 스위치가 켜져 있는 상태에서 Home의 Connectivity Test를 실행합니다. 테스트 결과는 해당 테스트 방식과 대상에서의 상태만 보여 주며 모든 웹사이트에 접속할 수 있다는 뜻은 아닙니다. 테스트 응답은 있지만 실제 대상에 접속할 수 없다면 대상 자체와 규칙을 추가로 확인합니다. 테스트는 실패했지만 대상에 정상적으로 접속할 수 있다면 서버가 작동하지 않는다고 바로 판단하지 말고 Settings의 Test Method를 확인하세요.

  1. 먼저 원래 네트워크를 확인합니다. 제어 가능한 환경에서 연결을 끄고 평소 정상적으로 접속하는 페이지를 열어 Wi-Fi 또는 셀룰러 네트워크가 작동하는지 확인합니다. 원래 네트워크에 문제가 있으면 기본 연결을 복구한 뒤 클라이언트 테스트를 반복합니다.
  2. 그다음 프록시 경로를 확인합니다. Shadowrocket 연결을 켜고 정상 작동이 확인되었으며 PROXY로 처리될 것으로 예상되는 대상에 접속합니다. 테스트 대상은 사용자가 직접 정해야 합니다. 규칙 예시의 example.com을 프록시 작동 확인에 사용하지 마세요.
  3. 마지막으로 규칙을 확인합니다. Config를 사용하는 경우 앱에서 확인할 수 있는 연결 기록과 함께 대상 도메인, 적용된 정책 및 실제 접속 결과를 살펴봅니다. 페이지가 열려도 PROXY를 사용했다는 뜻은 아닙니다. DIRECT로 요청이 정상 처리되었을 수도 있습니다.

서버 문제와 규칙 문제를 구분하려면 같은 서버를 유지하고 Global Routing을 구성(Config)에서 프록시(Proxy)로 잠시 바꾼 다음 같은 대상에 다시 접속합니다. Proxy에서는 되지만 Config에서는 되지 않으면 선택한 구성, 도메인 규칙 및 FINAL을 먼저 확인합니다. 둘 다 실패하면 서버 매개변수, 인증 정보, 현재 네트워크 및 서버 상태를 우선 확인합니다. 이 비교는 원인을 좁히기 위한 것이며 Proxy를 계속 사용하라는 뜻은 아닙니다.

한 번에 변수 하나만 변경합니다. 모드를 바꿨다면 서버, DNS 및 테스트 네트워크를 동시에 바꾸지 마세요. 전후 비교에서는 같은 대상과 작업을 사용하고, 필요한 경우 페이지나 앱을 다시 열어 이전 연결 및 캐시의 영향을 줄입니다. 테스트가 끝나면 원래 사용하려던 모드로 되돌립니다. 규칙 분할이 목적이라면 Config로 돌아가 직접 연결할 요청과 프록시를 사용할 요청이 각각 예상대로 처리되는지 확인합니다.

단계 05 · 실패가 발생한 단계부터 확인

Settings: 문제 발생 지점별 확인

가져온 뒤 선택 가능한 서버가 없는 경우

먼저 구독 항목으로 돌아가 Type이 Subscribe인지, 주소가 빠짐없이 복사되었는지, 업데이트를 실행했는지 확인합니다. 목록이 비어 있다면 저장을 반복해서 누르지 말고 응답이 로그인 페이지, 오류 페이지 또는 클라이언트와 호환되지 않는 데이터인지 확인합니다. 기존 서비스 제공업체의 이용 기간, 접속 제한 또는 링크 변경도 업데이트 결과에 영향을 줄 수 있습니다. 다시 가져오기 전에 원래 설정을 보관하세요. 항목이 지나치게 많이 중복되면 이후 선택과 문제 확인이 어려워집니다.

서버는 있지만 스위치가 켜진 상태를 유지하지 못하는 경우

먼저 시스템 권한 승인을 마쳤는지 확인한 다음 선택된 서버가 방금 입력한 항목인지 확인합니다. 직접 추가한 정보는 원본과 항목별로 비교합니다. 특히 Port, 인증 값, Method 및 프로토콜에 필요한 TLS 또는 기타 필드를 확인합니다. 빠진 매개변수 대신 “비슷해 보이는” 값을 사용하지 마세요. 구독에서 가져온 항목은 먼저 업데이트한 다음 기존 서비스 제공업체에 서버 상태를 확인합니다.

연결은 켜져 있지만 일부 대상에 접속할 수 없는 경우

먼저 Global Routing과 현재 Config를 확인한 다음 대상이 더 앞에 있는 규칙에 의해 DIRECT 또는 REJECT로 지정되었는지 살펴봅니다. 도메인 확인에 실패했다면 전체 구성을 바로 바꾸지 말고 사용 중인 DNS 설정과 네트워크 환경을 확인합니다. 웹사이트 로그인 상태, 대상 서비스의 점검, 앱 캐시 및 기존 연결도 결과에 영향을 줄 수 있습니다. 브라우저와 다른 앱에서 같은 대상에 접속한 결과가 다르면 각각 기록하세요. 한 번의 성공 또는 실패로 모든 요청을 판단할 수는 없습니다.

Settings를 사용해 원인 확인

하단의 Settings를 열어 먼저 Test Method가 현재 테스트 목적에 맞는지 확인한 다음 필요에 따라 Diagnostics를 사용해 오류 정보를 수집합니다. On Demand는 조건에 따라 연결을 시작하는 설정이며 구독이나 인증 오류를 해결하는 스위치가 아닙니다. 처음 확인할 때는 연결을 직접 시작하고 중지해 기본 경로가 작동하는지 확인한 뒤 자동 연결 조건을 설정하는 것이 좋습니다.

Settings에서는 Proxy, TCP, UDP 등 관련 설정도 볼 수 있습니다. 특정 대상이 열리지 않는다고 이 옵션을 하나씩 수정하지 마세요. 먼저 원래 값을 기록하고 현상과 직접 관련된 항목 하나만 변경한 다음 개선되지 않으면 되돌립니다. 기존 서비스 제공업체에 문제를 설명할 때는 네트워크 유형, Global Routing 모드, 오류 문구 및 재현 방법을 전달하면 됩니다. 스크린샷이나 Diagnostics 내용을 공유하기 전에 구독 주소, 비밀번호, 인증 매개변수 및 기타 개인 정보를 삭제하세요.

문제가 계속되면 “가져오기 실패, 연결 실패, 연결 후 접속 실패”로 분류한 뒤 FAQ 문제 해결을 확인합니다. 규칙 일치, DNS 또는 구성 필드를 추가로 수정해야 한다면 구성 필드 참고를 확인하세요. 모든 옵션을 한꺼번에 재설정하는 것보다 문제가 발생한 단계를 먼저 특정하는 편이 유용한 정보를 보존하기 쉽습니다.

Shadowrocket Settings 페이지: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정
공식 스크린샷 · Settings. Test Method와 Diagnostics는 문제 확인에 사용하고, On Demand는 수동 연결 확인 후 설정합니다.

연결 후 참고 자료

기본 연결 확인을 마친 뒤 필요에 따라 규칙과 자동 연결 조건을 조정합니다. 구독을 업데이트한 후에는 현재 선택한 서버가 여전히 유효한지 확인하고 정상 작동하는 구성 사본을 보관하세요.