Shadowrocket 공식 매뉴얼 · 사용법

Shadowrocket 사용법구독 가져오기 및 연결 확인

기존 정보를 먼저 가져온 다음 트래픽 처리 방식을 선택합니다. 아래 다섯 단계에 따라 처음 연결하고 실제 접속으로 결과를 확인하세요. 모든 고급 설정을 먼저 변경할 필요는 없습니다.

PROXY DIRECT REJECT
단계 01 · 목록 준비

Add Server: 서버 추가 및 Subscribe 가져오기

Shadowrocket을 열고 Home 화면에 머뭅니다. 처음 설정할 때는 상단 연결 스위치를 꺼둬도 됩니다. Add Server를 찾아 추가 화면으로 이동한 다음, 보유한 정보에 맞는 방법을 선택합니다. 전체 구독 링크가 있으면 Subscribe를 사용하고, 단일 서버 정보가 있으면 해당 프로토콜의 항목을 직접 입력합니다. 구독 주소를 서버 주소와 비밀번호로 나누어 입력하거나, 단일 공유 링크를 구독 주소로 입력하지 마세요.

기존 구독 링크가 있는 경우

Add Server의 Type에서 Subscribe를 선택하고 전체 구독 링크를 해당 URL 입력란에 붙여넣습니다. 붙여넣은 뒤 링크의 앞뒤를 확인해 따옴표, 공백 또는 채팅 메시지의 설명 문구가 포함되지 않았는지 살펴보세요. 링크의 쿼리 매개변수는 그대로 유지해야 합니다. 구독 이름을 알아보기 쉽게 지정한 뒤 저장하고 Home으로 돌아갑니다. 버전에 따라 메뉴 위치가 다를 수 있으므로 실제 화면에 표시된 Subscribe와 URL 항목을 기준으로 진행하세요.

가져온 뒤 구독 내용을 불러올 때까지 기다리고 목록에 서버 항목이 나타나는지 확인합니다. 구독 이름만 보이고 선택할 서버가 없다면 가져오기가 완료된 것이 아닙니다. 먼저 링크가 유효한지, 현재 네트워크에서 링크에 접속할 수 있는지 확인하세요. 구독 업데이트는 목록을 다시 가져오는 작업이며, 각 항목의 연결 가능 여부까지 보장하지는 않습니다. 처음에는 기존 항목 하나를 선택해 이후 확인을 진행하고, 문제의 원인을 구분하기 어려워지지 않도록 여러 구독을 한꺼번에 가져오지 마세요.

기존 단일 서버 정보가 있는 경우

Add Server로 돌아가 먼저 올바른 Type을 선택한 다음 제공된 정보를 입력합니다. 예를 들어 Shadowsocks를 선택했다면 Host, Port, Password, Method를 하나씩 확인합니다. Host에는 서버 도메인 또는 IP를 입력하고 웹 경로는 추가하지 마세요. Port에는 숫자 포트를 입력합니다. Method는 서버 설정과 일치해야 하며 이름이 비슷하다는 이유로 추측해서 선택하면 안 됩니다. 다른 프로토콜에 표시되는 항목은 다를 수 있으므로 서비스 제공업체의 정보를 빠짐없이 입력하세요.

QR 코드가 있으면 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 권한을 허용합니다. 호환되는 JSON 구성을 명확히 전달받은 경우에만 Import from Cloud JSON을 사용하세요. 일반 구독 링크와는 다른 메뉴입니다. 어떤 가져오기 방법을 사용하든 저장 후 Home으로 돌아가 SERVER 그룹에서 항목을 확인하고 서버 하나를 선택합니다. 공유 링크, 구독 업데이트, 중복 항목 정리를 더 알아보려면 서버 관리 매뉴얼을 참고하세요. 처음 연결하기 전에 모든 항목을 정리할 필요는 없습니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 입력 항목과 Scan QR Code 등 가져오기 메뉴가 표시됩니다
Add Server: 먼저 Type을 선택한 다음 보유한 정보에 맞는 항목을 입력합니다.
단계 02 · 처리 방식 선택

Global Routing: 구성, 프록시 및 직접 연결

서버 항목을 준비한 뒤 Home으로 돌아가 Global Routing을 엽니다. 여기서는 구독이 아니라 요청을 처리할 방식을 결정합니다. 선택지는 구성(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 규칙 분기가 필요한지, 서버 연결만 확인하려는지 먼저 판단한 다음 선택하세요. 목록에서 서버를 선택했다고 해서 모든 요청이 반드시 해당 서버를 통과하는 것은 아닙니다.

일상적인 사용에는 구성(Config) 선택

구성(Config)은 현재 구성 파일의 규칙에 따라 처리 방식을 정하므로 요청별로 분기해야 하는 일상적인 사용에 적합합니다. 선택한 뒤 하단의 Config 페이지로 이동해 사용할 파일이 활성화되어 있는지 확인합니다. 파일을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 구분 항목을 볼 수 있습니다. 처음 설정할 때는 Rule을 중점적으로 확인하세요. 연결을 위해 모든 항목을 수정할 필요는 없으며 HTTPS Decryption을 활성화할 필요도 없습니다.

규칙의 PROXY는 프록시 정책에 따라 처리하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부한다는 뜻입니다. 규칙은 위에서 아래로 확인하며 먼저 일치한 항목이 결과에 영향을 줍니다. 연결이 이미 설정되었더라도 특정 대상은 DIRECT로 처리될 수 있으며, 반드시 오류인 것은 아닙니다. 편집기의 Add Rule은 새 규칙을 추가할 때 사용하지만, 이 단계에서는 기존에 사용할 수 있는 구성을 유지하고 연결을 확인한 뒤 변경하는 편이 좋습니다. 규칙 키워드의 자세한 의미는 용어 매뉴얼에서 확인하세요.

진단에는 프록시(Proxy)와 직접 연결(Direct) 사용

프록시(Proxy)는 요청을 프록시 방식으로 처리해 규칙 일치가 결과에 미치는 영향을 일시적으로 줄여 확인할 때 유용합니다. 다만 선택한 서버, 유효한 인증 정보, 사용 가능한 네트워크가 필요하며 잘못된 서버 항목을 수정해 주지는 않습니다. 직접 연결(Direct)은 요청을 직접 보내므로 기본 네트워크 상태를 비교할 때 사용할 수 있습니다. 목록에 서버가 있어도 자동으로 프록시를 사용하지는 않습니다. 처음 확인할 때는 기본 네트워크를 확인하고, Proxy로 기존 서버를 테스트한 다음 Config로 돌아가 규칙 분기를 살펴보세요.

Shadowrocket의 Config 구성 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 포함됩니다
Config: 활성화된 파일과 Rule을 확인하세요. 모든 항목을 먼저 변경할 필요는 없습니다.
단계 03 · 시스템 연결 설정

Home: 연결 스위치를 켜고 권한 설정

이제 Home으로 돌아가 두 항목을 다시 확인합니다. SERVER에서 테스트할 서버를 선택했는지, Global Routing에 방금 정한 모드가 표시되는지 확인하세요. 확인이 끝나면 페이지 상단의 Not Connected 옆 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 나타날 수 있습니다. 앱이 시스템 네트워크 연결 기능을 사용하기 위해 필요한 권한이므로 안내 내용을 읽고 시스템 요구에 따라 승인하거나 기기 확인을 완료하세요.

방금 권한 요청을 취소했다면 서버 주소를 반복해서 수정하지 말고 앱으로 돌아가 다시 시도하세요. 권한을 허용한 뒤 Home으로 돌아와 상태가 바뀔 때까지 기다리고, 스위치를 빠르게 여러 번 켰다 끄지 마세요. 스위치가 바로 꺼지거나 화면에 계속 Not Connected가 표시되면 이 단계가 완료되지 않은 것입니다. 먼저 권한, 시스템 네트워크 설정, 현재 작업에 영향을 줄 수 있는 다른 네트워크 연결 구성을 확인하세요.

시스템 연결이 설정되는 것과 원격 서버를 사용할 수 있는 것은 서로 다른 문제입니다. 스위치가 켜져 있으면 앱이 연결 상태로 동작하기 시작했다는 뜻이지만, 비밀번호가 정확하거나 서버에 접속할 수 있거나 대상 사이트가 작동한다는 보장은 아닙니다. 연결 상태가 바뀐 뒤에는 설정을 더 추가하기보다 Connectivity Test를 실행하고 실제 접속을 확인하세요. ‘연결을 켤 수 있는지’와 ‘연결 후 요청을 완료할 수 있는지’를 구분해 기록하면 문제를 더 쉽게 찾을 수 있습니다.

처음 확인하는 동안에는 현재 Wi-Fi 또는 모바일 네트워크를 유지하고, 상태가 안정될 때까지 앱을 전면에 두는 것이 좋습니다. 서버를 바꿔야 한다면 새 항목을 선택했는지 확인한 뒤 테스트를 다시 진행하세요. 네트워크, 서버, Global Routing을 동시에 바꾸면 성공 또는 실패의 원인을 파악하기 어렵습니다. 자동 연결이 필요할 때 On Demand를 살펴보고, 처음에는 수동 스위치로 재현 가능한 기준 상태를 만드세요.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치, Global Routing, Connectivity Test가 있고 아래에 SERVER와 Add Server가 표시됩니다
Home: 서버를 선택하고 Global Routing을 확인한 뒤 상단 스위치를 켭니다.
단계 04 · 요청 확인

Connectivity Test: 테스트와 실제 접속 확인

연결 스위치를 켠 다음 Home에서 Connectivity Test를 누릅니다. 테스트는 현재 연결 상태를 참고하는 용도이며 실제 서비스의 동작 확인을 대신하지 않습니다. 테스트가 끝날 때까지 기다린 뒤 브라우저를 열어 원래 접속하려던 페이지를 새로고침하세요. 캐시된 페이지 내용만 보지 말고 새 요청을 보내는 것이 좋습니다. 특정 앱을 확인하려는 경우 해당 앱에서도 관련 작업을 다시 시도해야 합니다.

확인할 때는 세 가지를 각각 기록하세요. Home의 연결 상태, Connectivity Test의 완료 여부, 실제 페이지의 동작 상태입니다. 세 결과가 항상 일치하지는 않습니다. 예를 들어 테스트는 완료되지만 특정 페이지가 실패한다면 대상 도메인의 규칙, 대상 서비스 또는 DNS와 관련된 문제일 수 있습니다. 테스트는 실패하지만 실제 페이지가 열릴 수도 있으며, 이 경우 현재 네트워크에 적합하지 않은 테스트 방식이나 대상일 수 있습니다. 하나의 테스트 수치만으로 구독 전체가 유효하지 않다고 판단하거나 서비스 품질 순위로 해석하지 마세요.

한 번의 비교로 문제 범위 좁히기

구성(Config)에서 페이지가 열리지 않는다면 같은 서버와 같은 대상을 유지한 채 일시적으로 프록시(Proxy)로 바꾸어 다시 시도하세요. Proxy에서는 되지만 Config에서는 되지 않는다면 서버 정보를 모두 바꾸기보다 활성 구성 파일, 일치한 규칙, DNS 설정을 먼저 확인하세요. Proxy에서도 실패하면 기본 네트워크와 기존 서버 항목을 확인합니다. 직접 연결(Direct)은 대상에 원래 직접 접속할 수 있는지 판단하는 데 도움이 되지만, 직접 연결에 성공해도 프록시 경로가 정상이라는 뜻은 아닙니다.

프록시 연결이 가능한 것을 확인한 다음 일상적으로 사용하는 Config로 돌아가 PROXY로 처리될 것으로 예상하는 대상과 DIRECT로 처리될 것으로 예상하는 대상에 접속하세요. Data에서 현재 버전이 제공하는 요청 또는 트래픽 정보를 확인하고 규칙과 함께 살펴볼 수 있습니다. 트래픽 수치가 바뀌었다는 사실만으로 특정 대상이 어떤 규칙에 일치했는지 알 수는 없습니다. 자세한 규칙 예시, 순서 확인, 구독 관리는 서버 관리 매뉴얼에서 확인하세요. 처음 확인할 때 여러 새 규칙을 한꺼번에 추가하지 마세요.

단계 05 · 단계별 문제 해결

Settings: 일반적인 실패 원인과 재확인 순서

문제가 생기면 어느 단계에서 멈췄는지 먼저 확인한 뒤 Settings로 이동합니다. 여기에는 Test Method, On Demand, Diagnostics, Proxy, TCP, UDP 등의 항목이 있지만 처음 연결할 때 전부 조정해야 하는 것은 아닙니다. 관련 없는 옵션은 그대로 두고 한 번에 조건 하나만 변경한 다음 다시 연결해 확인해야 변경 효과를 판단할 수 있습니다.

가져오기에 실패하거나 목록이 비어 있는 경우

선택할 서버가 아직 나타나지 않았다면 구독 입력란으로 돌아가 URL이 완전한지 확인하세요. 특히 링크 끝의 매개변수와 복사 과정에서 줄바꿈이나 추가 문자가 포함되었는지 살펴봅니다. 현재 네트워크에서 구독 링크에 접속할 수 있는지 확인한 다음 다시 업데이트하세요. 같은 링크를 반복해서 추가하면 중복 그룹이 생길 수 있으며, 유효하지 않은 주소가 수정되지는 않습니다. 서비스 제공업체가 링크를 변경했거나 접속 조건을 조정했다고 확인해 주었다면 최신 정보를 사용하세요. 주소의 문자를 임의로 추측하지 마세요.

스위치는 켜졌지만 요청이 실패하는 경우

먼저 선택한 항목을 확인한 다음 Type, Host, Port와 인증 정보를 살펴보세요. 수동으로 입력할 때 프로토콜 종류와 Method가 일치하지 않거나 비밀번호 앞뒤에 공백이 있으면 연결에 실패할 수 있습니다. 항목을 확인한 뒤 같은 네트워크에서 본인이 보유한 다른 서버 하나와 비교해 볼 수 있습니다. 모든 항목이 실패한다면 기본 네트워크와 시스템 권한을 다시 확인하세요. 문제를 찾는 동안 TCP, UDP 등 여러 설정을 동시에 변경하지 마세요. 새로운 변수가 추가될 수 있습니다.

테스트 결과와 페이지 상태가 다른 경우

Settings에서 Test Method를 확인해 현재 테스트 방식과 결과 해석이 맞는지 살펴보세요. 네트워크에 따라 특정 테스트는 가능하지만 실제 페이지에 필요한 요청은 완료하지 못하거나 그 반대의 경우도 있습니다. 일부 도메인만 실패한다면 먼저 Config에서 관련 규칙과 DNS를 확인한 뒤 Proxy와 비교하세요. 추가로 기록해야 한다면 Diagnostics를 사용해 문제 발생 시간, 선택한 모드, 오류 문구, 재현 절차를 기록하세요. 스위치 화면의 스크린샷 한 장만 남겨서는 충분하지 않습니다.

연결이 자동으로 바뀌거나 네트워크 전환 후 문제가 생기는 경우

수동으로 연결을 끈 뒤 다시 연결된다면 On Demand가 활성화되어 있는지, 시스템에 해당 자동 연결 설정이 저장되어 있는지 확인하세요. 처음 문제를 확인할 때는 직접 활성화한 자동 연결 조건을 일시적으로 끈 다음 3단계에 따라 수동으로 연결할 수 있습니다. Wi-Fi와 모바일 네트워크를 전환한 뒤에만 문제가 생긴다면 두 네트워크에서 각각 따로 테스트하고 차이를 기록하세요. 네트워크 전환 직후의 일시적인 결과를 구독 내용의 문제로 단정하지 마세요.

기존 회선에 관해 서비스 제공업체에 문의할 때는 필요한 오류 현상만 전달하고 구독 URL의 접속 매개변수, Password, QR 코드와 개인 정보는 가리세요. 앱을 삭제하거나 목록을 한꺼번에 비우는 것은 우선적인 문제 해결 방법이 아니며 기존 구성을 복구하지 못하게 할 수 있습니다. 먼저 사용할 수 있는 파일과 항목을 보존하고 문제가 있는 항목을 처리하세요. 구독 백업, 그룹 및 업데이트 방식은 서버 관리 매뉴얼에서 확인할 수 있으며, 익숙하지 않은 영어 항목은 용어 매뉴얼을 참고하세요.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP가 표시됩니다
Settings: 문제 상황에 따라 Test Method, On Demand, Diagnostics를 확인하세요.

연결 완료 후 구성 유지

사용 중인 구독 이름, 서버 선택, 구성 파일을 유지하세요. 규칙을 변경하거나 구독을 업데이트할 때는 이번에 연결에 성공한 조건과 비교하면 됩니다. 구성을 추가하기 전에 백업해 사용 가능한 상태와 테스트 중인 상태가 섞이지 않도록 하세요.

계속 읽기: 구독 및 서버 관리 · 화면 용어 및 규칙 키워드 · 첫 설치 시 차단 해제 안내