Shadowrocket 사용법

먼저 보유한 정보의 종류를 확인한 뒤 가져오기 방법을 선택하세요. 서버 한 대의 주소, 포트 및 인증 정보는 수동 추가에 사용하고, 구독 링크는 여러 서버 항목을 불러올 때 사용합니다. 두 가지를 서로 대신 입력할 수는 없습니다. 예를 들어 구독 링크 전체를 Host에 입력하면 안 됩니다. 시작하기 전에 기기의 네트워크가 정상적으로 연결되는지 확인하고, 서버 목록을 정리할 때까지 연결 스위치는 끄세요.

서버 정보 직접 입력

Home에서 Add Server를 탭하거나 서버 추가 메뉴를 열어 같은 이름의 화면으로 이동합니다. 먼저 Type을 탭해 보유한 서버 정보에 표시된 프로토콜을 선택한 다음 항목을 입력하세요. Shadowsocks를 예로 들면 일반적으로 Host, Port, Password, Method를 확인해야 합니다. Type에 따라 입력 항목이 다르므로 선택한 프로토콜에 해당하는 양식을 사용하세요. 다른 프로토콜의 항목 조합으로 대신 입력하면 안 됩니다.

Host에는 서버 주소를, Port에는 포트 번호를 입력합니다. 인증 정보와 Method는 서버 설정과 일치해야 합니다. 입력할 때 복사한 내용 앞뒤의 공백, 포트 번호, 대소문자를 꼼꼼히 확인하세요. 프로토콜에 추가 매개변수가 필요하면 보유한 정보를 확인해 입력하고, 주소 모양만 보고 추측하지 마세요. 입력을 마친 뒤 화면의 저장 기능을 사용해 Home으로 돌아가 SERVER 그룹에 새 항목이 표시되는지 확인하세요. 비슷한 이름의 서버를 잘못 선택하지 않도록 메모와 주소도 다시 살펴봅니다.

Subscribe로 기존 구독 가져오기

구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 해당 URL 입력란에 링크 전체를 입력합니다. 알아보기 쉬운 메모를 추가한 뒤 저장할 수 있습니다. Home으로 돌아와 구독 정보를 불러올 때까지 기다리세요. 자동으로 불러오지 않으면 해당 구독 항목의 업데이트 기능을 사용합니다. 빈 그룹만 표시되는 것이 아니라 구독에 포함된 서버 목록이 나타나야 합니다. 업데이트 오류가 발생하면 메시지를 보관하고, 링크가 유효하며 현재 네트워크에서 열리는지 먼저 확인하세요. 같은 링크를 반복해서 추가하지 마세요.

호환되는 QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 읽어 온 뒤에도 가져온 Type과 매개변수를 확인하세요. Import from Cloud JSON은 해당 JSON 콘텐츠를 위한 별도의 가져오기 메뉴이며, 임의의 구독 링크를 넣는 공용 메뉴가 아닙니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 주소 전체가 보이는 화면을 공개하지 마세요. 이 단계가 끝나면 선택할 수 있는 서버 항목이 하나 이상 있어야 합니다. 다음 단계에서 해당 서버를 어떻게 사용할지 정합니다.

서버가 목록에 표시된다고 해서 모든 요청이 해당 서버를 사용하는 것은 아닙니다. Home으로 돌아와 Global Routing을 열고 현재 선택 항목을 확인하세요. 세 가지 모드는 Config / Proxy / Direct이며, 앱이 처리하는 요청에 적용할 정책을 결정합니다. 먼저 사용 목적을 분명히 한 뒤 모드를 선택하세요. 서버 매개변수를 수정하는 동시에 모드를 계속 바꾸면 어떤 변경이 결과에 영향을 주었는지 판단하기 어렵습니다.

• Config: 현재 선택된 설정에 따라 요청을 처리합니다. 도메인, 주소 또는 기타 조건에 따라 트래픽을 나누려는 경우에 적합합니다. 선택한 뒤 Config에서 현재 설정도 확인해야 합니다. Home에 Config가 표시된다는 사실만으로 규칙이 올바르다고 판단할 수는 없습니다.
• Proxy: 앱이 처리하는 요청에 프록시 경로를 사용합니다. 문제를 확인할 때 서버 연결 문제와 규칙 선택 문제를 구분하는 데 도움이 될 수 있습니다. 시스템의 모든 요청이 반드시 같은 경로를 사용한다는 뜻은 아니며, 대상 서비스에 접속할 수 있다고 보장하지도 않습니다.
• Direct: 요청을 직접 연결 방식으로 처리합니다. 선택한 서버의 프록시 경로를 확인하려는 경우 Direct로 설정하면 확인하려는 방향과 맞지 않습니다.

Config 사용 시 현재 설정 확인

Config 페이지에서 사용 중인 설정 파일을 확인한 다음 내용을 엽니다. 공식 화면에 표시된 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 서로 다른 설정 항목입니다. 처음 설정할 때는 General과 Rule을 중심으로 확인하세요. 첫 연결을 위해 다른 기능을 하나씩 모두 켤 필요는 없으며, 용도가 분명하지 않다면 모든 설정을 변경하지 마세요.

Rule의 규칙은 일반적으로 위에서 아래로 적용되며, 처음 일치하는 규칙의 정책을 사용합니다. PROXY는 프록시 정책을 사용하고, DIRECT는 직접 연결하며, REJECT는 요청을 거부합니다. Add Rule로 규칙을 추가할 때는 일치 조건과 정책을 먼저 확인한 다음 삽입 위치를 살펴보세요. 범위가 지나치게 넓은 규칙이 앞에 있으면 뒤의 구체적인 규칙이 적용되지 않을 수 있습니다. FINAL은 앞선 규칙과 일치하지 않은 요청을 처리하도록 마지막에 둡니다.

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

위 내용은 문법 예시입니다. example.com과 하위 도메인에는 PROXY를 사용하고, 나머지 요청은 FINAL을 통해 DIRECT로 처리한다는 뜻입니다. 완성된 설정이 아니며 실제 연결 테스트 대상도 아닙니다. 예시를 그대로 복사해 기존 설정을 덮어쓰지 마세요. 사용할 모드와 현재 설정 파일을 확인한 뒤 Home으로 돌아가세요. 규칙 키워드의 자세한 의미는 용어집에서, 전체 기능 설명은 Global Routing 기능 안내에서 확인할 수 있습니다.

Home으로 돌아와 SERVER 목록에서 사용할 서버를 탭하고 선택 표시가 올바른 항목에 있는지 확인하세요. 구독 그룹의 서버는 메모가 비슷할 수 있으므로 선택 전에 주소나 메모를 대조하세요. 목록의 첫 번째 항목이라는 이유만으로 선택하지 마세요. 그런 다음 Global Routing을 다시 확인해 앞서 선택한 모드가 유지되는지 살펴봅니다. 서버 선택, 라우팅 모드, 현재 설정은 서로 다른 항목이므로 각각 확인해야 합니다.

페이지 상단의 Not Connected 표시 영역에서 연결 스위치를 탭합니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 안내를 읽고 허용한 뒤 기기에서 요구하는 인증을 완료하세요. 이 절차는 시스템에 Shadowrocket이 사용할 VPN 구성을 추가하는 것으로, 앱에서 서비스를 구매하거나 서버 정보를 입력하는 절차가 아닙니다. 취소했다면 앱으로 돌아와 다시 연결을 시작하고 시스템 안내에 따라 권한을 허용하세요.

권한을 허용한 뒤 Home으로 돌아와 상단 상태가 Not Connected에서 연결됨으로 바뀌는지, 스위치가 켜진 상태로 유지되는지 확인하세요. 스위치를 켜자마자 꺼지더라도 빠르게 연속해서 누르지 마세요. 먼저 상태 메시지를 기록하고 마지막 단계의 순서에 따라 점검하세요. 시스템 설정의 VPN 항목은 연결 상태를 확인하는 데 도움이 될 수 있지만, 특정 대상에 접속할 수 있는지는 별도로 확인해야 합니다.

iPad에서도 같은 순서로 진행하세요. 화면 공간이 넓으면 iPhone 이미지와 레이아웃이 다를 수 있으므로 Home, SERVER, Global Routing 등의 이름으로 메뉴를 찾으세요. 처음 사용할 때는 앱을 전면에 둔 상태에서 연결과 확인을 한 번 완료한 뒤 다른 자동화 설정을 살펴보는 것이 좋습니다. 수동 연결에 On Demand 설정은 필요하지 않습니다. 이전에 설정했다면 수동으로 연결을 끊은 뒤 다시 연결을 시작하는지 확인하세요.

당분간 사용하지 않을 때는 Home으로 돌아와 연결 스위치를 끄고 상태가 바뀌는지 확인하세요. 스위치가 켜져 있는데 웹페이지에 접속할 수 없더라도 연결되었다고 해서 반드시 정상 작동한다고 단정하지 마세요. 서버 응답, 실제 요청, 규칙 선택을 각각 확인해야 합니다. 각 결과가 서로 일치해야 현재 연결이 기대한 대로 작동하는지 알 수 있습니다.

한 번에 하나의 항목만 변경하고, 변경 후에는 앞 단계에서 수행한 같은 테스트를 반복하세요. 먼저 현재 서버, Global Routing, 설정 파일과 오류 메시지를 기록한 다음 아래 순서대로 확인합니다. 이렇게 하면 문제의 원인을 구분하고 변경이 효과가 없을 때 원래 상태로 되돌리기 쉽습니다. 처음부터 모든 설정을 삭제하지 마세요.

1. 먼저 기기의 네트워크를 확인합니다. Shadowrocket 연결을 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 일반적인 접속이 가능한지 확인하세요. 네트워크 로그인 인증이 필요하다면 먼저 인증을 완료합니다. 기본 네트워크에 연결할 수 없다면 서버 암호를 바꾸기보다 네트워크 연결부터 해결하세요.
2. 다음으로 목록과 선택 항목을 확인합니다. Home으로 돌아와 실제 선택된 항목을 확인하세요. 구독 업데이트에 성공해도 사용하려는 서버가 자동으로 선택되는 것은 아닙니다. 목록이 비어 있다면 Subscribe로 돌아가 업데이트 오류, 링크 유효성, 불러오기 결과를 확인하세요.
3. 프로토콜과 인증 정보를 확인합니다. 해당 항목의 편집 화면을 열어 Type, Host, Port, 인증 정보를 하나씩 확인하세요. 프로토콜에 추가 매개변수가 필요한 경우 보유한 서버 정보를 참고합니다. 구독으로 관리되는 항목은 다음 업데이트 때 내용이 다시 적용될 수 있으므로, 임시로 직접 수정해 정보 출처 문제를 가리지 마세요.
4. 서버 문제와 규칙 문제를 구분합니다. Config 사용 중 문제가 발생하면 용도가 분명한 경우에 한해 Proxy로 잠시 바꾸고 같은 대상을 다시 테스트할 수 있습니다. 결과가 달라졌다면 Config로 돌아가 적용된 정책, 규칙 순서, FINAL을 확인하세요. 테스트가 끝나면 원래 모드로 되돌립니다. 두 모드에서 모두 실패한다면 규칙만의 문제라고 단정하지 말고 서버나 기본 연결도 확인하세요.
5. 시스템 권한과 다른 연결을 확인합니다. 스위치가 켜진 상태로 유지되지 않으면 VPN 구성 추가 권한을 허용했는지, 기기의 다른 VPN 연결이나 관리 제한이 현재 작업에 영향을 주는지 확인하세요. 용도를 모르는 시스템 구성을 함부로 제거하지 마세요. 관리형 기기의 제한은 해당 기기 관리자에게 확인해야 합니다.

추가 단서가 필요하면 Diagnostics 사용

Settings를 열고 Test Method와 Diagnostics를 찾습니다. 전자는 테스트 방식을, 후자는 추가 점검 기능을 제공합니다. 방식이 다르면 측정값을 같은 지표처럼 직접 비교하지 마세요. Proxy, TCP, UDP 등의 설정에도 각각 용도가 있으므로 처음 문제를 확인할 때는 기존 값을 유지하고 여러 항목을 한꺼번에 바꾸지 마세요.

도메인 관련 오류가 발생하면 주소를 확인할 수 있는지와 연결을 설정할 수 있는지를 먼저 구분하고, Diagnostics의 구체적인 결과를 함께 살펴보세요. 출처를 알 수 없는 DNS 설정을 임의로 입력하지 마세요. 특정 대상만 실패하고 다른 대상은 정상이라면 구독을 전부 다시 가져오기보다 해당 대상의 주소 확인, 적용된 정책, 오류 메시지를 중심으로 범위를 좁히세요.

기록을 정리할 때는 작업 순서, 오류 메시지, 선택한 모드와 테스트 결과만 보관하면 됩니다. 화면이나 로그를 공유하기 전에 구독 링크 전체, 암호, 인증 식별 정보 및 기타 개인 정보를 삭제하세요. 연결이 복구되지 않으면 Shadowrocket 연결 안 됨: 자주 발생하는 문제 확인을 참고하세요. 앱 설치, 구매 또는 구입 항목 복원에서 문제가 발생했다면 App Store 안내로 이동하세요. 두 문제의 해결 절차를 혼동하지 마세요.