Shadowrocket 시작 가이드:
가져오기, 연결 및 확인

단계 01 / 연결 정보 입력

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 Home으로 이동해 아래쪽의 SERVER 그룹을 확인합니다. 처음 사용하는 경우 서버가 없으므로 Add Server를 누릅니다. 추가 버튼으로 표시되는 경우에는 해당 버튼을 눌러 페이지 제목이 Add Server인지 확인하세요. 보유한 정보에 따라 한 가지 방법을 선택합니다. 명확한 서버 매개변수가 있다면 직접 입력하고, 서비스 제공업체가 발급한 본인 구독 주소가 있다면 Subscribe로 가져오면 됩니다. 두 방법을 모두 반복할 필요는 없습니다.

직접 입력: Type을 선택하고 항목 확인

Add Server에서 먼저 Type을 선택해 정보에 기재된 프로토콜과 일치시키세요. 예를 들면 Shadowsocks, VMess, VLESS 또는 Trojan이 있습니다. Type에 따라 입력해야 하는 항목이 달라지므로 먼저 입력을 마친 뒤 프로토콜을 임의로 바꾸지 마세요. 오른쪽 공식 스크린샷에는 Host, Port, Password, Method가 있는 양식이 표시되어 있습니다. 다른 Type은 항목이 다를 수 있으므로 해당 프로토콜 정보를 기준으로 입력하고, 스크린샷에 나온 모든 항목을 무조건 채우지 마세요.

Host에는 서버 호스트 이름 또는 IP 주소를, Port에는 포트를, Password에는 서비스 정보에 지정된 비밀번호를 입력합니다. Method가 표시되면 서버 설정과 일치하는 방식을 선택하세요. 호스트 이름에 공백, 웹페이지 경로 또는 설명 문구가 포함되지 않도록 하고, 포트에 콜론까지 함께 붙여 넣지 마세요. 프로토콜에서 추가로 요구하는 인증 정보, 전송 및 TLS 매개변수도 일치해야 합니다. 화면에서 비워 둘 수 있다는 이유만으로 서버에 해당 정보가 필요 없다고 판단하지 마세요. 입력을 저장하고 Home으로 돌아와 SERVER에 해당 항목이 나타나는지 확인합니다.

기존 구독: Subscribe로 가져오기

구독 링크가 있다면 Add Server의 Type에서 Subscribe를 선택하고 화면 안내에 따라 구독 주소를 입력한 뒤 저장합니다. 링크 전체를 빠짐없이 복사하고, 특히 끝부분의 매개변수가 누락되지 않았는지, 복사할 때 줄바꿈이 포함되지 않았는지 확인하세요. 저장한 뒤 Home으로 돌아와 콘텐츠를 가져올 때까지 기다립니다. 구독 그룹과 그 안의 서버가 표시되는지 확인하세요. 현재 버전에서 수동 업데이트가 필요한 경우에는 해당 구독의 작업 메뉴에서 업데이트합니다. 구독 이름이 표시된다고 해서 서버 정보까지 가져온 것은 아니므로 그룹 안의 실제 항목도 확인해야 합니다.

구독 링크에는 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷, 대화 기록 또는 문제 해결 게시물에 올리지 마세요. 페이지에 나온 예시 도메인은 실제로 사용할 수 있는 서비스가 아니며 본인의 정보를 대신하지 않습니다. Add Server 하단의 Scan QR Code는 사용자가 보유한 서버 QR 코드를 스캔할 때 사용할 수 있습니다. Import from Cloud JSON은 해당 형식의 데이터를 위한 기능이므로 일반 구독 링크를 이 메뉴에 임의로 입력하지 마세요. 정보 형식에 맞는 메뉴를 선택해야 합니다.

이 페이지를 마치면 Home에 선택 가능한 서버가 하나 이상 있는지 확인한 뒤 Global Routing을 설정합니다. 지금은 여러 고급 옵션을 서둘러 조정하지 마세요. 가져오기에 실패하면 먼저 주소와 네트워크를 확인하고, 자세한 내용은 문제 해결 페이지에서 확인하세요.

단계 02 / 요청 처리 방식 선택

Global Routing: 라우팅 모드 선택

서버를 준비한 다음 Home으로 돌아와 Global Routing을 엽니다. 이 설정은 요청을 전체적으로 처리할 방식을 정합니다. 선택한 서버와 Global Routing은 서로 다른 설정입니다. 서버 항목은 연결 매개변수를 제공하고, Global Routing은 요청이 프록시를 사용할지, 사용한다면 어떻게 사용할지를 정합니다. Config, Proxy, Direct 세 가지 모드를 먼저 이해한 다음 연결하면 모드 선택 문제를 서버 매개변수 오류로 오해하는 일을 줄일 수 있습니다.

• Config: 현재 구성 파일의 규칙에 따라 정책을 결정합니다. 요청에 따라 PROXY, DIRECT 또는 REJECT가 적용될 수 있으므로 모든 요청이 프록시를 거친다고 볼 수 없습니다.
• Proxy: 트래픽을 프록시 방식으로 처리합니다. 기본 연결 문제를 확인할 때 Config와 비교하기 좋습니다. 규칙 구성이 올바르다는 뜻은 아니며 모든 대상에 접속할 수 있다고 보장하지도 않습니다.
• Direct: 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 현재 기본 네트워크를 확인하는 데 사용할 수 있지만, 웹페이지가 열린다고 해서 프록시 연결이 정상이라는 의미는 아닙니다.

평소 규칙에 따라 라우팅하려면 Config를 선택한 다음 Config를 열어 현재 사용 중인 구성 파일을 확인합니다. 목록에 파일이 있는 것과 해당 파일이 실제로 선택되어 사용 중인 것은 다릅니다. 현재 적용된 항목을 확인한 뒤 해당 내용을 살펴보세요. 공식 스크린샷에는 구성 편집 페이지의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시되어 있습니다. 처음에는 Rule만 확인하고 모든 섹션을 한꺼번에 변경하지 마세요.

Rule에 들어가면 위에서 아래 순서로 규칙을 확인합니다. 구체적인 조건은 실제로 일치할 수 있는 위치에 두고, 앞선 규칙과 일치하지 않는 요청의 최종 정책을 정하는 FINAL은 보통 맨 끝에 둡니다. 아래는 구문을 읽기 위한 예시일 뿐 기존 구성을 덮어쓰라는 뜻이 아닙니다. 첫 번째 규칙은 예시 도메인에 PROXY를 적용하고, 두 번째 규칙은 지정된 사설 주소 범위에 DIRECT를 적용하며, 마지막 규칙은 기본 정책을 지정합니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Add Rule로 규칙을 추가하려면 먼저 기존 구성을 백업한 다음 유형, 일치 조건 및 정책을 확인하고, 저장 후 사용할 파일이 계속 선택되어 있는지 확인하세요. 처음 연결을 확인할 때는 출처를 알 수 없는 구성을 대량으로 가져오지 않는 것이 좋습니다. 규칙이 바뀌면 요청 경로가 달라져 문제 원인을 파악하기 어려워집니다. 일치 순서에 대한 설명은 규칙 순서 및 FINAL 안내를 참고하세요. 구성을 확인한 다음 Home으로 돌아가 연결합니다.

단계 03 / 시스템 연결 설정

Home에서 연결 켜기

Home으로 돌아가 SERVER에서 사용할 서버를 선택하고 선택 표시가 원하는 항목에 있는지 확인합니다. 구독에 이름이 비슷한 항목이 여러 개 있을 수 있으므로 목록에서의 위치만 기억하지 마세요. 업데이트 후 목록이 바뀔 수 있으니 현재 선택을 다시 확인해야 합니다. 이어서 Global Routing이 방금 정한 모드인지 확인합니다. 이전 문제 해결 과정에서 남긴 Direct 설정이 이번 확인에 영향을 주지 않도록 하세요.

Home 상단의 연결 스위치를 누릅니다. 처음 연결할 때 시스템에서 VPN 구성 추가를 허용할지 요청할 수 있습니다. 안내를 읽고 방금 실행한 Shadowrocket에서 요청한 것이 맞는지 확인한 다음 기기 안내에 따라 권한을 허용하거나 인증을 완료하세요. 이 시스템 권한은 네트워크 터널을 설정하는 용도이며 서버 정보를 생성하지 않습니다. 안내를 거절하면 앱이 정상 연결 상태로 전환되지 않을 수 있으므로 연결을 다시 시작해 권한을 완료해야 합니다.

권한을 완료한 뒤 Home으로 돌아와 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 스위치가 잠시 바뀌었다가 다시 꺼지거나, 시스템 안내가 완료되지 않았거나, 상태가 계속 예상과 다르더라도 곧바로 DNS를 수정하지 마세요. 권한이 실제로 완료되었는지, 현재 네트워크를 사용할 수 있는지, 다른 VPN 연결이 이번 연결에 영향을 주는지 먼저 확인합니다. 문제를 확인할 때는 다른 연결을 중지하고 Shadowrocket만 따로 테스트하세요. 네트워크 조건을 여러 개 동시에 바꾸지 마세요.

연결 스위치가 켜졌다는 것은 시스템 연결 절차가 해당 단계까지 진행되었다는 의미일 뿐, 모든 서버, 도메인 또는 앱이 확인을 통과했다는 뜻은 아닙니다. 다음으로 Connectivity Test를 실행하고 브라우저에서 실제 요청을 확인해야 합니다. 사용을 중지하려면 Home으로 돌아가 상단 스위치를 끄세요. 처음 확인할 때는 수동 스위치로 제어하고, 결과가 안정된 뒤 On Demand를 검토하세요.

단계 05 / 한 번에 조건 하나씩 변경

실패 증상에 따라 Settings 확인

앞의 네 단계를 진행해도 결과가 안정적이지 않다면 증상에 따라 원인을 좁힌 뒤 Settings로 이동합니다. 여기에서 Language, Test Method, On Demand, Diagnostics와 Proxy, TCP, UDP 등의 항목을 확인할 수 있습니다. 각 항목은 서로 다른 기능을 위한 것이므로 모든 연결에 공통으로 적용할 하나의 설정은 없습니다. 조정할 수 있는 스위치가 있다는 이유만으로 처음 사용할 때 반드시 켜야 한다고 생각하지 마세요.

가져온 내용이 없음: 구독 가져오기 과정 확인

Home으로 돌아가 구독 주소가 완전한지, 그룹에 서버 정보가 포함되어 있는지 확인합니다. 기본 네트워크에서 구독 주소에 접근할 수 없으면 구독 이름을 저장해도 목록을 가져올 수 없습니다. 사용자가 보유한 서비스 정보가 변경되었다면 주소와 유효 상태를 다시 확인하세요. 가져오기에 성공한 뒤에도 예전 항목이 선택되어 있지 않은지 살펴봐야 합니다. 문제를 확인하려고 모든 구성을 삭제하지 마세요. 변경 사항을 비교할 수 있도록 기존 기록을 먼저 보존하세요.

가져오기는 되지만 연결 실패: 매개변수와 네트워크 확인

해당 항목의 편집 페이지를 열고 Type, Host, Port 및 인증 정보를 원본 정보와 하나씩 대조합니다. 비밀번호의 대소문자, 끝부분의 공백, 프로토콜별 매개변수가 결과에 영향을 줄 수 있습니다. 현재 네트워크에서 먼저 테스트한 다음, 여건이 되면 다른 네트워크에서도 다시 테스트하세요. 네트워크에 따라 증상이 달라진다면 네트워크 환경부터 확인합니다. 어느 변경이 영향을 주었는지 알 수 없게 서버 항목과 구성 규칙을 동시에 수정하지 마세요.

테스트와 웹페이지 결과가 다름: 테스트 방식과 DNS 조회 확인

Settings에서 Test Method를 확인해 이번 테스트에 사용된 방식을 확인한 다음 Home으로 돌아가 Connectivity Test를 다시 실행합니다. 테스트 방식마다 확인하는 단계가 다르므로 결과를 그대로 섞어 비교할 수 없습니다. 테스트는 정상이지만 웹페이지가 열리지 않으면 도메인 조회, 대상 접속 가능 여부 및 규칙 일치를 각각 확인하세요. 변경 범위를 최소화하고 DNS, 규칙, 서버를 동시에 바꾸지 마세요.

연결이 자동으로 복구되거나 반복해서 바뀜: On Demand 확인

연결을 끈 직후 자동으로 다시 켜지는 경우 On Demand가 활성화되어 있는지, 조건이 현재 네트워크에 해당하는지 먼저 확인합니다. 처음 문제를 확인할 때는 자동 실행을 잠시 끄고 Home 스위치로 수동 테스트를 반복하세요. 문제를 해결한 뒤에는 본인의 네트워크 사용 방식에 맞춰 On Demand를 설정합니다. 이 기능은 연결이 시작되는 조건을 제어하며 잘못 입력한 서버 정보를 수정하지는 않습니다.

문제가 계속됨: 재현 가능한 정보 정리

Diagnostics에서 현재 버전이 제공하는 진단 정보를 확인하고, 어느 단계에서 실패했는지, 현재 모드와 테스트 방식이 무엇인지, 특정 대상에만 영향을 주는지 기록합니다. 정보를 공유하기 전에 구독 링크, 비밀번호 및 개인 접속 기록을 가리세요. 개별 매개변수, 시스템 권한 및 그 밖의 실패 사례는 문제 해결에서 분류별로 확인하세요. App Store 다운로드 및 구매 복원 문제는 설치 안내를 참고하세요. 네트워크 문제를 확인하면서 앱을 다시 구매할 필요는 없습니다.

문제 해결을 마치면 4단계로 돌아가 다시 확인하고, 원래 사용하려던 Config, 서버 선택 및 자동 연결 설정을 복원합니다. 정상 작동을 확인한 구성은 백업해 두고 이후 조정할 때 변경 사항을 하나씩 기록하세요. 새로운 문제가 생겼을 때 처음부터 추측하지 않고 확인된 상태로 돌아갈 수 있습니다.