Shadowrocket 시작하기

Shadowrocket을 열고 Home으로 이동합니다. 아래의 SERVER 그룹에는 저장된 서버가 표시됩니다. 처음 사용하는 경우 먼저 Add Server를 찾으세요. 목록에 아무 항목이나 추가하는 것이 아니라, 가지고 있는 정보를 유형에 맞게 저장해야 합니다. 먼저 보유한 정보가 구독 링크인지, 서버 공유 링크인지, 아니면 주소·포트·인증 정보로 나뉘어 있는지 확인한 뒤 적절한 방법을 선택하세요.

기존 구독 링크가 있다면: Subscribe 사용

Add Server에서 Type을 Subscribe로 선택하고 전체 구독 링크를 URL 입력란에 붙여 넣습니다. 알아보기 쉬운 메모를 입력한 다음 화면의 저장 기능으로 Home에 돌아가 구독을 불러올 때까지 기다리세요. 항목이 펼쳐져 있지 않으면 해당 구독 그룹을 확인합니다. 다시 불러오려면 구독 항목의 업데이트 기능을 사용해 같은 링크를 반복해서 추가하지 마세요.

링크를 복사할 때는 처음부터 끝까지 빠짐없이 선택하고 끝부분의 매개변수, 줄바꿈, 공백을 확인하세요. 로그인 페이지나 안내 페이지 주소를 구독 링크로 사용하지 말고, 불필요해 보이는 매개변수도 임의로 삭제하지 마세요. 아래에는 링크 형식만 예시로 표시했습니다. 실제 작업에는 본인의 유효한 링크를 사용하고 예시를 그대로 복사하지 마세요.

https://example.com/sub?token=xxxx

기존 서버 정보가 있다면: Type에 맞춰 직접 입력

개별 서버 정보가 있다면 Add Server에서 먼저 해당하는 Type을 선택한 뒤 Host, Port 및 프로토콜에 필요한 인증 항목을 입력합니다. 예를 들어 Shadowsocks는 Password와 Method를 확인해야 합니다. 프로토콜에 따라 입력 항목이 달라지므로 모든 유형에 같은 항목을 적용하지 마세요. 주소에는 지정된 호스트 이름이나 IP만, 포트에는 포트 값만 입력하고 인증 정보는 원문 그대로 사용합니다.

TLS 또는 전송 설정이 포함된 경우 기존 서버 정보를 바탕으로 각 항목을 입력하세요. 선택 사항처럼 보인다고 임의로 변경하면 안 됩니다. 특히 지정된 서버 이름, 경로 및 전송 유형을 유지하세요. 정보가 부족하다면 기존 서비스를 제공한 곳에 먼저 확인합니다. 저장이 완료되었다는 것은 항목이 기록되었다는 뜻일 뿐, 원격 인증이나 연결이 성공했다는 의미는 아닙니다.

기존 QR 코드 또는 공유 링크가 있다면: 확인 후 저장

QR 코드가 있다면 Scan QR Code를 사용하고, 처음 스캔할 때는 시스템 안내에 따라 카메라 접근을 허용하세요. 전체 서버 공유 링크가 있다면 복사해서 앱으로 돌아옵니다. 가져오기 안내가 표시되면 파싱된 유형, 호스트 이름, 포트를 확인한 뒤 진행하세요. Import from Cloud JSON은 해당 JSON 데이터를 가져오는 기능으로, 모든 구독 링크를 여기에 입력하는 것은 아닙니다. 이름이 비슷하다는 이유만으로 기능을 혼용하지 마세요.

Home으로 돌아와 SERVER에 원하는 항목이 표시되는지 확인하고 사용할 서버를 선택합니다. 구독에 여러 항목이 있다면 처음 확인할 때는 정보가 명확한 항목 하나만 선택하세요. 모든 이름과 순서를 바로 정리할 필요는 없습니다. 여러 구독 관리, 업데이트 시 덮어쓰기, 삭제 전 백업은 구독 및 서버 관리를 참고하세요. 이 단계가 끝나면 트래픽 처리 모드를 선택합니다.

서버를 저장하고 선택한 다음 Home에서 Global Routing을 엽니다. 이 설정은 요청에 적용할 처리 정책을 결정하며, 앞서 입력한 서버 주소와는 별개의 설정입니다. 서버 정보가 정확해도 모드가 예상과 다르면 앱에는 연결된 것으로 표시되지만 접속 결과가 다를 수 있습니다. 먼저 이번 작업이 서버 확인을 위한 것인지, 기존 규칙에 따라 평소처럼 사용하기 위한 것인지 정한 뒤 선택하세요.

1. Config: 현재 구성의 규칙에 따라 요청을 처리합니다. 직접 연결 정책에 해당하는 요청은 직접 연결되고, 프록시 정책에 해당하는 요청은 지정된 프록시 경로를 사용합니다. 서버가 선택되어 있다는 사실만으로 각 요청의 경로를 판단할 수는 없습니다.
2. Proxy: 클라이언트가 처리하는 요청을 프록시 정책으로 보냅니다. 규칙의 영향을 잠시 줄여 확인할 때 유용합니다. 사용 가능한 서버가 필요하며, 서버 인증을 대신하거나 잘못된 매개변수를 자동으로 수정하지는 않습니다.
3. Direct: 직접 연결 정책을 사용합니다. 기본 네트워크나 대상 페이지에 직접 접속할 수 있는지 비교할 때 적합하지만, 프록시 서버가 정상 작동하는지를 확인하는 용도로 사용하면 안 됩니다.

기존 서버를 처음 확인할 때는 잠시 Proxy를 사용한 뒤, 확인이 끝나면 구성에 맞는 모드로 돌아갈 수 있습니다. 규칙 파일이 있다면 목록에 저장되어 있는지만 보지 말고 Config에서 현재 선택된 구성을 확인하세요. Config 모드의 처리 결과에는 현재 사용 중인 구성의 규칙만 영향을 줍니다.

Config 화면에서 확인할 항목

해당 구성의 편집 화면을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 처음에는 Rule과 정책 참조를 확인하세요. 연결을 위해 이 기능을 하나씩 활성화할 필요는 없습니다. Add Rule은 규칙을 추가하는 기능입니다. 기존 구성을 사용할 수 있다면 파일 전체를 먼저 다시 작성하지 않아도 됩니다.

규칙은 일반적으로 순서대로 적용되며, 앞쪽 규칙이 처리 방식을 먼저 결정할 수 있습니다. 앞선 규칙에 해당하지 않는 요청은 FINAL이 처리합니다. 아래는 규칙 문법 예시이며 현재 구성에 바로 덮어쓸 수 있는 완성된 파일이 아닙니다. PROXY가 가리키는 정책도 실제 구성에 있어야 합니다. 예시 도메인을 실제로 테스트해야 하는 서비스로 취급하지 마세요.

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

정책 이름과 프로토콜 이름의 차이가 헷갈린다면 용어집의 규칙 및 정책 설명을 먼저 확인하세요. 처음 연결할 때는 현재 모드, 현재 구성, 선택된 서버만 기억하면 됩니다. 확인을 마치면 Home으로 돌아가 연결 스위치를 켭니다.

Home으로 돌아와 SERVER에서 선택된 서버를 확인한 다음, Global Routing의 모드를 확인합니다. 상단에 Not Connected가 표시되면 클라이언트 연결이 아직 설정되지 않은 상태입니다. 옆의 연결 스위치를 눌러 연결을 시작하세요. 구독을 가져왔다고 해서 시스템이 자동으로 트래픽 처리를 시작하는 것은 아닙니다.

처음 스위치를 켜면 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 이는 앱이 시스템의 네트워크 기능을 사용해 기기 트래픽을 처리하는 데 필요한 권한입니다. 앱을 다시 구매하거나 서버를 추가하는 절차가 아닙니다. 안내가 Shadowrocket에 대한 것인지 확인한 뒤 시스템 절차에 따라 허용하고, 기기에서 요구하는 암호 또는 본인 인증을 완료하세요. 권한 설정은 시스템 화면에서 진행하며 기기 암호를 서버 항목에 입력하면 안 됩니다.

앞서 권한 요청을 취소했다면 앱으로 돌아가 스위치를 다시 켜고 안내가 다시 표시되는지 확인하세요. 권한 설정을 마친 뒤 Home으로 돌아와 연결 상태가 바뀔 때까지 기다립니다. 연결 상태와 시스템 VPN 표시를 통해 시스템 네트워크 연결이 설정되었는지 확인할 수 있지만, 선택한 서버가 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 다음 단계에서 실제 접속을 확인하세요.

연결 전후의 조건을 동일하게 유지

처음 문제를 확인할 때는 같은 Wi-Fi 또는 셀룰러 네트워크를 유지하고 네트워크, 서버, 구성, 모드를 한꺼번에 바꾸지 마세요. 다른 VPN 연결을 사용 중이라면 먼저 종료한 뒤 Shadowrocket으로 돌아와 다시 연결합니다. 그래야 시스템 연결 전환을 서버 문제로 오해하지 않습니다. 변경할 때마다 상단 상태를 확인하고, 스위치가 한 번 켜졌다는 사실만으로 판단하지 마세요.

iPad에서도 같은 순서로 진행합니다. 항목 선택, 모드 확인, 스위치 켜기, 시스템 권한 설정 순입니다. 기기와 앱 표시 방식에 따라 화면 배치는 달라질 수 있지만, 작업 기준은 동일한 영문 인터페이스 항목입니다. 연결을 중지하려면 상단 스위치를 끄세요. 연결을 끄더라도 저장된 서버나 구독은 삭제되지 않으므로 나중에 다시 사용할 수 있습니다.

스위치가 곧바로 꺼지거나 연결이 계속 완료되지 않으면 여기서 멈추고 시스템 안내를 기록하세요. 바로 모든 데이터를 삭제할 필요는 없습니다. 문제 해결 섹션으로 이동해 권한 문제와 원격 연결 문제를 구분할 수 있습니다. 연결 상태가 유지된다면 계속 확인하되, ‘연결됨’이라는 표시만으로 설정이 끝났다고 판단하지 마세요.

먼저 어느 단계에서 문제가 발생했는지 확인하세요. 가져온 뒤 서버가 표시되지 않는지, 스위치가 유지되지 않는지, 연결 후 모든 사이트에 접속할 수 없는지, 일부 요청만 예상과 다른지 구분합니다. 단계에 따라 확인할 위치가 다릅니다. 기존 데이터와 오류 메시지를 보존하고 한 번에 하나씩만 변경한 뒤 ‘연결 → 테스트 → 실제 접속’ 순서로 다시 확인하세요.

가져온 뒤 목록이 비어 있음: 입력 내용과 가져오기 결과 확인

구독 항목으로 돌아가 링크가 완전한지, 불필요한 공백이 붙거나 끝부분의 매개변수가 빠지지 않았는지 확인합니다. 입력한 주소가 실제 구독 링크인지, 계정 로그인 페이지가 아닌지도 확인하세요. 현재 네트워크에서 링크를 불러와야 한다면 먼저 기본 네트워크 연결을 점검합니다. 필요하면 기존 서비스를 제공한 곳에 구독 상태와 응답 형식을 문의하세요. 같은 링크를 여러 번 추가하지 말고, 공개된 곳에 문의할 때 전체 링크를 붙여 넣지 마세요.

스위치가 유지되지 않음: 시스템 권한부터 확인

VPN 구성을 추가하는 시스템 권한을 완료했는지 확인한 다음, 사용 중인 다른 VPN 연결이 있는지 살펴보세요. 시스템에 구체적인 오류가 표시되면 원문을 기록한 뒤 조치합니다. 모든 문제를 서버 암호 탓으로 돌리면 안 됩니다. 앱을 다시 열고 연결을 다시 시작한 뒤 같은 단계에서 멈추는지 확인하세요. 데이터 백업 위치를 확인한 뒤에만 구성 삭제나 재설치를 고려합니다.

연결되었지만 접속할 수 없음: 서버 정보와 모드 확인

현재 모드가 Direct가 아닌지 확인한 다음 선택된 서버의 Type, Host, Port와 인증, TLS 및 전송 매개변수를 확인하세요. 직접 입력한 경우 프로토콜을 잘못 선택하거나 포트를 잘못 입력하거나 암호에 공백이 들어가는 일이 흔합니다. 구독에서 가져온 항목은 먼저 구독 업데이트 결과를 확인하고, 추측으로 여러 항목을 한꺼번에 변경하지 마세요. 기본 네트워크에서도 일반적인 사이트에 접속할 수 없다면 네트워크 연결 문제부터 해결해야 합니다.

일부 요청만 실패함: 규칙과 테스트 방식 확인

Proxy에서는 접속되지만 Config에서 문제가 발생한다면 Config로 돌아가 현재 구성과 규칙 순서를 확인하세요. 테스트 결과만 이상하다면 Settings에서 Test Method를 확인하고, 선택된 방식이 실제 접속 방식과 맞는지 살펴봅니다. 테스트 방식을 바꿔도 테스트 기준만 달라질 뿐, 잘못된 서버 정보를 수정해 주지는 않습니다. TCP 및 UDP 관련 설정도 기존 서비스의 지원 여부에 맞춰 확인하고 문제 해결을 위해 모두 임의로 바꾸지 마세요.

연결 동작이 예상과 다름: On Demand 확인

Settings에서 On Demand를 확인하세요. 조건에 따른 자동 연결 동작을 제어하는 기능이지 서버 정보를 생성하는 기능은 아닙니다. 처음 연결을 설정할 때는 수동 연결을 사용하고 현재 설정을 기록해 둘 수 있습니다. 수동 연결이 안정적으로 작동하는 것을 확인한 뒤 자동 연결 조건을 하나씩 설정하세요. 연결을 끈 뒤 다시 연결되거나 네트워크 전환 후 동작이 달라진다면 구독을 삭제하기 전에 여기부터 확인합니다.

추가 분석이 필요하면 Diagnostics의 진단 정보를 활용하고, 동일하게 재현되는 명확한 작업 하나로 문제를 좁히세요. 진단 자료를 공유하기 전에는 구독 링크, 인증 정보, 개인 주소 및 기타 민감한 내용을 가리고 스크린샷에도 같은 정보가 보이지 않는지 확인합니다. 증상별 설명은 자주 묻는 질문에서, 업데이트 정책, 정렬 및 백업은 서버 관리 매뉴얼에서 확인하세요.