[General]

Shadowrocket 빠른 시작

기존 구성 추가 → 라우팅 모드 선택 → 연결 켜기 → 결과 확인 → 문제 원인 찾기.

처음 설정할 때는 확인 가능한 연결 하나를 완성하는 데 집중하세요. 모든 옵션을 한꺼번에 조정할 필요는 없습니다. 먼저 보유한 정보가 단일 서버 정보인지 구독 링크인지 구분하세요. 단일 서버 정보에는 연결에 필요한 주소, 포트, 인증 정보가 포함되고, 구독 링크는 서버 목록을 가져오는 데 사용됩니다. 구성 파일은 주로 요청을 어떻게 분기할지 결정합니다. 이 세 종류의 정보를 같은 입력란에 섞어 입력하지 마세요. 각 단계를 마칠 때마다 Home으로 돌아가 결과를 확인한 뒤 다음 단계로 진행하세요.

01 · Add Server / Subscribe: 기존 정보 추가

보유한 정보의 종류에 맞는 메뉴를 선택하고, 저장 후 Home에서 서버를 찾을 수 있는지 확인하세요. Home을 열고 SERVER 그룹 근처에서 Add Server를 누르면 서버 편집 화면으로 이동합니다. 완전한 서버 정보가 있다면 먼저 Type을 선택한 뒤 해당 항목을 입력하세요. 구독 링크가 있다면 Type에서 Subscribe를 선택하고 전체 주소를 입력한 뒤 저장하세요. 구독 주소를 단일 서버의 Host로 입력하지 마세요.

직접 입력할 때 Type은 보유한 정보에 기재된 프로토콜과 일치해야 합니다. Shadowsocks, VMess, VLESS, Trojan 등은 사용하는 인증 항목이 서로 다르므로 서버 주소가 같다는 이유로 Type을 바꾸어 사용하면 안 됩니다. 스크린샷에는 Type, Host, Port, Password, Method가 표시된 편집 화면이 나옵니다. Type을 바꾸면 표시되는 항목도 달라질 수 있으니 현재 프로토콜에 해당하는 정보를 하나씩 입력하세요.

Host는 서버 주소이고 Port는 포트입니다. 인증 정보는 빠짐없이 입력하고 복사할 때 앞뒤 공백이나 줄바꿈이 들어가지 않았는지 확인하세요. Method 등의 매개변수는 보유한 서버 구성과 일치해야 합니다. 무작위로 선택해 연결을 시도하지 마세요. TLS, 서버 이름 또는 전송 설정도 보유한 구성 정보를 기준으로 입력하세요. 항목의 의미가 불분명하면 먼저 용어 빠른 확인을 살펴본 다음 이 단계로 돌아오세요.

QR 코드가 있다면 Scan QR Code로 가져온 뒤 인식된 항목을 확인할 수 있습니다. Import from Cloud JSON은 다른 유형의 정보 가져오기 메뉴이며 Subscribe와는 다릅니다. 해당 형식의 정보를 보유한 경우에만 사용하세요. 어떤 메뉴를 선택하든 저장하기 전에 서버 유형, 주소, 인증 항목을 확인하세요. 익숙한 이름인지 여부만으로 판단하지 마세요.

Shadowrocket Add Server 화면: Type, Host, Port, Password, Method와 Scan QR Code, Import from Cloud JSON 메뉴 표시
Add Server: Type에 따라 항목이 달라집니다. 기존 서버 정보를 기준으로 입력하세요.

구독을 저장한 뒤에는 이름뿐 아니라 서버 목록을 확인하세요

Subscribe를 가져올 때는 주소 끝의 쿼리 매개변수를 포함해 구독 링크 전체를 복사하세요. 일부 링크에는 계정을 식별하는 정보가 포함되어 있어 매개변수를 삭제하면 다른 내용이 반환되거나 가져오기에 실패할 수 있습니다. 이 문서에는 실제 구독 주소를 표시하지 않습니다. 본인이 보유한 링크를 사용하고 공개 스크린샷, 채팅 기록 또는 문의 내용에 노출하지 마세요. 저장한 뒤 앱이 정보를 가져올 때까지 기다리고 Home으로 돌아가 서버 항목이 표시되는지 확인하세요.

구독 그룹만 표시되고 선택할 서버가 없다면 연결 스위치를 바로 켜지 말고 가져오기 또는 업데이트 결과를 먼저 확인하세요. 주소가 유효하고 전체 내용이 복사되었는지, 현재 네트워크에서 접속 가능한지 확인하세요. 업데이트가 필요하면 해당 구독에 제공된 업데이트 기능을 사용하세요. 업데이트가 끝난 뒤에도 목록을 다시 확인하세요. 서버 이름, 순서 또는 내용이 달라질 수 있습니다. 그런 다음 SERVER 목록에서 사용할 서버를 선택하고 선택 표시가 나타나는지 확인하세요. 첫 번째 항목이 현재 서버라고 단정하지 마세요.

이 단계가 끝나면 두 가지를 명확히 알 수 있어야 합니다. 목록에 사용할 서버 정보가 있는지, 현재 어떤 서버가 선택되어 있는지입니다. 구독을 성공적으로 가져왔다는 것은 목록을 불러왔다는 뜻일 뿐, 모든 서버를 사용할 수 있다는 뜻은 아닙니다. 두 가지를 확인한 뒤 라우팅 모드 설정으로 진행하면 가져오기 문제를 규칙 문제로 오인하지 않을 수 있습니다.

02 · Global Routing: 요청 처리 방식 선택

먼저 모드를 확인한 다음 규칙을 점검할지 결정하세요. Home으로 돌아가 Global Routing을 눌러 현재 선택을 확인합니다. 세 가지 모드는 Config, Proxy, Direct입니다. 이 설정은 요청 처리 방식을 제어하며 서버 주소를 대신 입력하거나 기존 서비스의 인증 정보를 변경하지 않습니다.

Config는 현재 구성 파일의 규칙에 따라 요청을 처리합니다. 대상에 따라 서로 다른 정책을 적용하려면 올바른 구성 파일이 선택되어 있는지 먼저 확인한 뒤 이 모드를 사용하세요. Proxy는 요청이 현재 프록시를 통해 처리되는지 임시로 확인할 때 유용하지만 구성 규칙 검증을 대신할 수는 없습니다. Direct는 직접 접속할 때 사용합니다. 이 모드에서는 요청이 프록시 방식으로 처리되지 않습니다.

Config를 사용하려면 하단의 Config를 열고 현재 사용 중인 구성 파일을 찾으세요. 파일 편집 화면에서 Rule을 확인합니다. 공식 스크린샷에는 General, Hosts, URL Rewrite, HTTPS Decryption 메뉴도 표시됩니다. 처음 설정할 때는 어떤 파일을 사용 중인지, 규칙이 예상과 일치하는지만 확인하면 됩니다. 연결을 완료하기 위해 모든 섹션을 수정할 필요는 없습니다.

규칙은 순서대로 검사되며 먼저 일치하는 규칙이 정책을 결정합니다. DOMAIN과 DOMAIN-SUFFIX는 일치 범위가 다르며 FINAL은 일반적으로 마지막에 기본값으로 배치됩니다. PROXY, DIRECT, REJECT는 규칙 정책 키워드입니다. PROXY는 Global Routing의 Proxy와 다른 설정 단계에 해당합니다. 비슷한 이름이 보이면 규칙을 편집하는 중인지 전역 모드를 바꾸는 중인지 먼저 확인하세요.

Shadowrocket Config 구성 파일 편집 화면: General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config: 현재 파일을 확인한 뒤 Rule 내용과 순서를 점검하세요.

간단한 규칙으로 Config 이해하기

아래는 문법 예시이며 기존 파일을 통째로 바꾸라는 뜻이 아닙니다. 첫 번째 규칙은 example.com과 하위 도메인을 PROXY에 연결하고, 두 번째 규칙은 앞선 규칙에 일치하지 않은 나머지 요청을 DIRECT로 처리합니다. 예시 도메인은 작성 방법을 설명하기 위한 것이므로 실제 대상의 접속 결과를 판단하는 데 사용할 수 없으며 서버 인증 정보도 포함하지 않습니다.

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

기본 규칙을 앞에 두면 뒤에 있는 규칙이 적용되지 않을 수 있습니다. 실제 구성을 점검할 때는 규칙 내용뿐 아니라 목록에서의 위치도 확인하세요. 처음 검증할 때는 기존 구성을 유지하고 Global Routing 선택을 기록해 두세요. 연결은 됐지만 특정 대상의 처리 방식이 예상과 다를 때 이 부분을 확인하면 됩니다. 복잡한 규칙, 정책 및 구성 섹션에 대한 자세한 설명은 규칙 및 구성 항목 참고에서 확인할 수 있습니다. 이 튜토리얼에서는 기본 모드 확인만 다룹니다.

이 단계가 끝나면 현재 모드가 Config, Proxy, Direct 중 무엇인지 알아야 합니다. Config를 사용한다면 현재 파일 이름도 확인하세요. Home으로 돌아가 Global Routing에 선택한 값이 표시되는지 다시 확인한 뒤 연결 단계로 진행합니다.

03 · Home: 권한을 허용하고 연결 켜기

연결하기 전에 서버 선택과 Global Routing을 모두 확인하세요. Home으로 돌아가 SERVER 목록에서 예상한 서버가 선택되어 있는지, Global Routing에 앞서 확인한 모드가 표시되는지 확인합니다. 상단의 Not Connected는 앱 연결이 아직 수립되지 않았음을 뜻합니다. 옆의 스위치를 켜 연결을 시작하세요.

처음 연결을 시작할 때 시스템에서 VPN 구성 추가를 허용할지 물어볼 수 있습니다. 안내가 현재 사용 중인 Shadowrocket에서 나온 것인지 확인한 다음 허용하고 기기에서 요구하는 인증을 완료하세요. 이 권한은 연결에 필요한 구성을 시스템에 추가하기 위한 것입니다. 구독을 성공적으로 가져왔다는 뜻도, 서버 인증에 성공했다는 뜻도 아닙니다.

시스템 안내를 취소했다면 앱으로 돌아가 연결을 다시 시도하고 시스템 VPN 설정에서 관련 구성 상태를 확인하세요. 권한 설정이 완료됐는지 확인하기 전에는 서버를 계속 바꾸지 마세요. 시스템 권한과 서버 인증은 별개의 확인 단계입니다. 전자는 기기에서 관리하고, 후자는 가져온 항목과 기존 서버 상태에 따라 달라집니다.

권한 설정을 마친 뒤 Home으로 돌아가 상단 연결 상태와 스위치가 켜져 있는지 확인하세요. 스위치가 바로 꺼지거나 연결되지 않은 상태가 계속되거나 오류 메시지가 나타나면 메시지 내용을 기록하고 이 문서의 문제 해결 단계로 이동하세요. 시스템 상태 표시줄의 아이콘만으로 원격 서비스가 정상이라고 판단하지 마세요. 아이콘 표시, 앱 연결 상태, 실제 요청 성공 여부는 서로 다른 결과입니다.

Shadowrocket Home 화면: 상단의 Not Connected 스위치, Global Routing의 Config 옵션, Connectivity Test와 하단의 SERVER 그룹 및 Add Server 표시
Home: 서버와 모드를 확인한 뒤 상단 스위치로 연결하세요.

기기에 다른 VPN 구성이 있다면 테스트 중 예상하지 못한 연결로 전환되지 않도록 현재 활성화된 구성을 먼저 확인하세요. 처음 검증할 때는 On Demand도 함께 조정하지 않는 것이 좋습니다. 조건에 따라 연결 동작이 달라지면 수동으로 스위치를 켠 결과인지 조건이 작동한 결과인지 구분하기 어렵습니다. 먼저 수동으로 연결해 작동하는지 확인한 뒤 필요에 따라 On Demand를 설정하세요.

연결 상태가 안정되면 바로 구성을 변경할 필요는 없습니다. 같은 서버와 Global Routing 모드를 유지한 채 확인 단계로 진행하세요. 그래야 다음 단계에서 차이가 나타났을 때 테스트 방식, 대상 규칙 또는 서버 중 어디에 문제가 있는지 판단할 수 있습니다. 여러 설정을 동시에 바꾸면 원인을 구분하기 어렵습니다.

04 · Connectivity Test: 연결 및 분기 확인

[Rule]

테스트 결과는 실제 접속 결과와 함께 확인하세요. Home에서 Connectivity Test를 누르고 결과가 나올 때까지 기다립니다. Settings의 Test Method에서 테스트 방식을 확인할 수 있습니다. 방식마다 확인하는 단계가 다르므로 한 번의 테스트 결과만으로 모든 웹사이트, 프로토콜, 앱이 정상 작동한다고 볼 수는 없습니다. 테스트에 실패해도 먼저 사용한 방식과 테스트 조건을 확인한 뒤 서버 문제인지 판단하세요.

서버에 도달할 수 있는지, 앱 연결이 수립됐는지, 대상 요청이 예상한 정책에 따라 처리되는지는 각각 별도로 확인해야 합니다. 목록 테스트에 응답이 있어도 인증 정보나 이후 전송 과정에 문제가 있을 수 있습니다. 상단 스위치가 켜져 있어도 규칙에 따라 특정 대상이 DIRECT 또는 REJECT로 처리될 수 있습니다. 검증을 시작하기 전에 서버 이름, Global Routing, 현재 구성을 기록하고 같은 조건으로 다시 확인할 수 있도록 준비하세요.

이어서 브라우저나 사용할 앱을 열고 본인이 익숙하며 접속 권한이 있는 대상에 접속해 첫 화면뿐 아니라 페이지가 정상적으로 로드되는지 확인하세요. Config를 사용한다면 DIRECT로 처리될 것으로 예상되는 대상과 PROXY로 처리될 것으로 예상되는 대상을 각각 확인하세요. 앱에서 연결 기록을 볼 수 있다면 대상, 일치한 규칙, 최종 정책을 확인합니다. 페이지가 열리는지만으로 요청이 어떤 경로로 처리됐는지 정확히 판단할 수는 없습니다.

실제 결과가 예상과 다르면 Config로 돌아가 해당 대상에 적용되는 규칙과 그 앞에 있는 규칙을 확인하세요. 도메인 접미사, 전체 도메인, IP 주소는 일치 조건이 서로 다릅니다. 페이지에서 다른 리소스 도메인으로 요청할 수도 있으므로 기본 페이지는 열리지만 일부 리소스가 실패한다면 주소 표시줄의 도메인만 살펴보지 말고 실패한 요청을 확인하세요. 규칙 작성 방법이 궁금하면 DOMAIN-SUFFIX 개념 설명과 구성 항목 참고를 확인하세요.

문제 범위를 좁히려면 기존 설정을 기록한 뒤 Proxy로 잠시 전환해 같은 대상을 다시 테스트할 수 있습니다. Proxy에서는 작동하지만 Config에서는 예상대로 처리되지 않는다면 현재 구성과 규칙 순서를 먼저 확인하세요. 두 모드 모두 실패한다면 서버 정보와 연결 상태를 다시 살펴보세요. 이는 문제 범위를 좁히기 위한 방법이지 특정 모드를 계속 사용하라는 뜻은 아닙니다. 확인을 마치면 필요한 모드로 되돌리고 다시 테스트하세요.

이 단계가 끝나면 실제 요청이 하나 이상 완료됐는지, 현재 모드가 용도에 맞는지 확인해야 합니다. 테스트 결과만 있고 실제 접속 기록이 없다면 검증은 아직 끝나지 않았습니다. 기존 구성이 정상 작동하면 이후 비교를 위해 현재 상태를 유지하세요. 문제가 계속되면 구체적인 증상을 기록하고 다음 단계로 진행합니다.

05 · Settings / Diagnostics: 실패 단계별 점검

복잡한 설정을 살펴보기 전에 기본 네트워크와 가져온 정보를 먼저 확인하세요. Home으로 돌아가 연결을 끄고 같은 기기에서 기본 네트워크로 정상 접속이 가능한지 확인합니다. 기본 네트워크 자체에 문제가 있다면 먼저 네트워크 연결을 해결한 뒤 Shadowrocket을 테스트하세요. Wi-Fi와 셀룰러 네트워크를 바꿔 보면 현재 네트워크와 관련된 문제인지 확인하는 데 도움이 됩니다. 이때 서버와 모드는 그대로 유지해 여러 조건을 동시에 바꾸지 마세요.

구독을 가져올 수 없거나 목록이 비어 있다면 전체 구독 주소, 유효 여부, 가져오기 결과를 확인하세요. 서버를 가져왔지만 연결할 수 없다면 해당 항목의 편집 화면을 열고 원본 정보와 Type, Host, Port, 인증 항목 및 관련 전송 설정을 대조하세요. 대소문자, 빠진 매개변수, 불필요한 공백도 하나씩 확인해야 합니다. 인증 항목의 오류를 규칙 변경으로 해결하려 하지 마세요.

스위치가 켜진 상태를 유지하지 못한다면 시스템 VPN 권한이 완료됐는지 확인하고 앱에 표시된 오류를 읽어보세요. 연결은 수립됐지만 대상에 문제가 있다면 Global Routing, 선택한 서버, Config 파일을 확인하세요. 테스트 후 Direct에 그대로 머물러 있거나 구성을 업데이트한 뒤 현재 파일이 바뀌지 않았는지도 확인해야 합니다. 기본 항목을 모두 확인한 다음 세부 설정을 살펴보세요.

Settings를 열고 Test Method, Diagnostics 등의 메뉴를 찾습니다. Test Method에서는 테스트 방식을 확인하거나 조정할 수 있고, Diagnostics에서는 진단 정보를 살펴볼 수 있습니다. Settings에는 On Demand, Proxy, TCP, UDP 등의 항목도 있지만 처음 문제를 해결할 때 하나씩 바꿀 필요는 없습니다. 현재 증상과 관련된 설정만 변경하고 테스트 후 원래 값으로 복구할 수 있도록 기록해 두세요.

Shadowrocket Settings 화면: Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings: 먼저 테스트 방식을 확인하고 필요하면 Diagnostics를 살펴보세요.

증상에 맞는 다음 확인 단계

확인된 증상 먼저 확인할 항목 다음 단계
Subscribe 저장 후 서버가 표시되지 않음 전체 주소, 유효 여부, 가져오기 결과 정보를 확인하고 다시 업데이트한 다음 SERVER 목록을 살펴봅니다
연결 스위치가 바로 꺼짐 시스템 VPN 권한, 오류 메시지 권한 완료 여부를 확인한 뒤 서버 항목을 대조합니다
Connectivity Test 실패 Test Method, 기본 네트워크, 서버 상태 다른 조건은 그대로 유지하고 실제 접속과 함께 다시 테스트합니다
Proxy는 작동하지만 Config 결과가 예상과 다름 현재 파일, Rule 순서, 일치한 정책 대상 규칙보다 앞에 다른 규칙이 일치하는지 확인합니다
일부 요청만 실패 실패한 대상, 프로토콜 요구 사항, 연결 기록 요청별로 원인을 확인하고 모든 설정을 한꺼번에 초기화하지 않습니다

기존 서비스의 상태를 더 확인해야 한다면 증상, 발생 조건, 이미 진행한 점검 내용을 정리한 뒤 해당 서비스 제공자에게 확인하세요. 문의할 때 사용한 프로토콜, 현재 Global Routing, 테스트 방식, 오류 메시지를 포함할 수 있지만 전체 구독 링크, 비밀번호 또는 다른 인증 정보는 포함하지 마세요. Diagnostics 정보나 스크린샷을 공유하기 전에도 민감한 내용이 들어 있는지 확인하고 필요한 오류 정보만 남기세요.

기본 점검을 마친 뒤 규칙 일치나 구성 항목이 문제로 보이면 규칙 및 구성 항목 참고에서 계속 확인하세요. 용어만 불분명하다면 용어 빠른 확인에서 필요한 내용을 살펴보면 됩니다. 빠른 시작의 완료 기준은 옵션을 얼마나 많이 조정했는지가 아니라 어떤 정보를 가져왔는지, 어떤 모드를 선택했는지, 연결이 수립됐는지, 실제 요청이 예상대로 처리됐는지 설명할 수 있는지입니다.