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

구독 링크가 있는 경우: Subscribe 선택

Shadowrocket을 열고 Home으로 이동한 다음 추가 메뉴에서 Add Server를 엽니다. Type에서 Subscribe를 선택하고 전체 구독 링크를 해당 URL 입력란에 붙여 넣으세요. 구독 링크에는 계정 식별 정보가 포함되는 경우가 많습니다. 복사할 때는 처음부터 끝까지 빠짐없이 포함하고, 채팅에 붙은 따옴표나 설명, 줄바꿈은 넣지 마세요. 서비스 제공업체의 계정 관리 페이지 주소를 구독 링크로 사용해서도 안 됩니다.

앱에서 저장 또는 완료를 눌러 Home으로 돌아가 구독 내용이 불러와질 때까지 기다립니다. 그런 다음 SERVER 그룹에 서버 항목이 표시되는지 확인하세요. 목록에서 선택할 수 있는 서버가 보여야 가져오기가 완료된 것입니다. 입력란에 링크가 들어간 것만으로는 충분하지 않습니다. 구독 이름만 있고 서버가 없다면 업데이트 결과와 링크가 온전한지 확인하세요. 같은 링크를 반복해서 추가해 중복 그룹을 만들지 마세요.

구독 업데이트는 서비스 제공업체가 제공한 목록을 다시 가져오는 기능입니다. 앱 구매 복원 기능이 아니며 서버 연결 가능 여부를 보장하지도 않습니다. 이미 항목이 있다면 방금 가져온 그룹과 사용할 서버를 확인한 뒤 다음 단계로 진행하세요. 링크를 해석하지 못했거나 목록이 비어 있다면 이 페이지의 5단계에서 확인하고, 우선 규칙은 변경하지 마세요.

서버 정보가 따로 있는 경우: Type에 맞춰 직접 입력

서버 주소, 포트, 인증 정보가 있다면 Add Server에서 올바른 Type을 먼저 선택한 뒤 화면에 표시된 항목을 입력하세요. 프로토콜마다 입력란이 다르므로 비밀번호가 있다는 이유만으로 같은 유형을 선택해서는 안 됩니다. 스크린샷에는 Host, Port, Password, Method 입력란이 표시되어 있습니다. 다른 유형에서는 항목이 다르게 나타날 수 있습니다.

Host에는 서버 도메인이나 IP를 입력하고 웹페이지 경로는 덧붙이지 마세요. Port에는 제공받은 포트 번호를 입력합니다. Password와 Method는 한 글자씩 정확히 확인하고, 복사할 때 앞뒤에 공백이 붙지 않았는지도 살펴보세요. UUID, TLS, SNI 또는 전송 계층 매개변수도 보유한 서버 정보를 그대로 입력해야 하며 임의로 추측해 채우지 마세요. 저장 후 Home으로 돌아와 새 항목이 보이는지 확인하고 알아보기 쉬운 메모를 붙이세요.

QR 코드 및 클립보드: 내용을 확인한 뒤 가져오기

QR 코드가 있다면 앱 내 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용하세요. 앱에서 제공하는 클립보드 가져오기를 이용한다면 클립보드에 설명 스크린샷이나 웹페이지 본문이 아니라 전체 공유 링크가 있는지 먼저 확인합니다. 스캔이나 가져오기가 끝난 뒤에도 목록으로 돌아와 항목 유형, 주소와 그룹을 확인하세요. QR 코드 스캔 완료만으로 매개변수 확인을 대신할 수는 없습니다.

스크린샷에 보이는 Import from Cloud JSON은 별도의 가져오기 메뉴이며, 임의의 구독 링크를 입력하는 곳이 아닙니다. 처음 설정할 때는 보유한 자료에 맞는 방법 하나만 선택하세요. 구독, 단일 공유 링크와 Config 파일의 차이는 용어 가이드에서 확인할 수 있습니다. 여러 항목의 정리와 업데이트 방법은 구독 및 서버 관리 가이드를 참고하세요.

완료 기준: Home의 SERVER 목록에 사용할 서버가 있고, 출처와 매개변수를 확인할 수 있습니다. 다음 단계에서는 어떤 상황에 이 서버를 사용할지 정합니다.

Home에서 Global Routing을 눌러 현재 선택을 확인합니다. 이 가이드에서 다루는 모드는 Config, Proxy, Direct이며 앱에 영어로 표시됩니다. 모드를 선택한 뒤 Home으로 돌아와 Global Routing 옆의 현재 값도 다시 확인하세요. 화면을 이동한 뒤 설정이 바뀌었다고 착각하지 않도록 주의해야 합니다.

Config: 현재 설정에 따라 트래픽 분기

사용할 Config 파일이 분명히 있다면 Config를 선택하세요. 그런 다음 Config로 이동해 실제로 사용할 파일이 선택되어 있는지 확인합니다. Config의 규칙에 따라 요청이 Proxy, Direct 또는 다른 방식으로 처리됩니다. 파일에서 정책 그룹을 참조한다면 그룹이 실제로 사용하는 서버도 확인해야 합니다. 구독 목록만 있다고 해서 필요한 트래픽 분기 규칙까지 준비된 것은 아닙니다.

오른쪽 공식 스크린샷은 Config 파일 편집 화면으로, General, Rule, Hosts, URL Rewrite, HTTPS Decryption 항목이 보입니다. 처음 연결할 때 이 섹션을 하나씩 수정하거나 테스트를 위해 HTTPS Decryption 설정을 추가할 필요는 없습니다. 현재 설정을 유지하고 Rule의 역할을 파악한 뒤 조정하세요. Add Rule은 규칙을 추가하는 메뉴이며 서버 추가 메뉴가 아닙니다.

Proxy: 서버만 따로 확인

Config가 올바른지 확신할 수 없다면 잠시 Proxy를 선택해 현재 서버의 연결 경로를 확인할 수 있습니다. 규칙 매칭으로 인한 변수를 줄이는 방법입니다. 이 모드가 서버 품질을 보장하는 것은 아닙니다. 서버 정보가 맞지 않거나 인증이 만료되었거나 기본 네트워크에 문제가 있다면 여전히 접속할 수 없습니다. 확인을 마친 뒤 평소 규칙에 따라 트래픽을 분기해야 한다면 Config로 돌아가 다시 테스트하세요.

Direct: 직접 연결과 비교

Direct에서는 트래픽이 직접 연결 방식으로 처리됩니다. 따라서 연결 스위치가 켜져 있어도 목록의 Proxy 서버를 사용하고 있다고 볼 수 없습니다. 기본 네트워크 상태를 비교하는 데는 유용하지만 Proxy 서버가 정상인지 확인하는 방법은 아닙니다. 모드를 바꾸기 전에 기존 값을 기록하고 테스트가 끝나면 복원하세요. 그래야 나중에 Direct 결과를 규칙 적용 결과로 오해하지 않습니다.

여기서는 먼저 모드 간 차이를 파악하세요. 규칙 순서, 정책 이름과 매칭 범위는 실제 Config를 함께 살펴봐야 합니다. 자세한 내용은 Global Routing 기능 안내를 참고하세요. 규칙의 목적을 모르는 상태에서 키워드 몇 개만 복사해 전체 Config를 바꾸지 마세요.

완료 기준: 현재 Config, Proxy, Direct 중 어떤 모드를 선택했는지 설명할 수 있어야 합니다. Config를 선택했다면 사용 중인 파일도 알고 있어야 합니다. 다음 단계에서 연결을 켭니다.

서버를 선택한 다음 스위치 켜기

Home으로 돌아와 SERVER 목록에서 사용할 항목을 선택하고 선택 표시를 확인하세요. 구독 그룹이 여러 개라면 비슷한 메모가 붙은 항목이 서로 다른 그룹에 속하지 않는지도 살펴보세요. Config를 선택했고 Config가 정책 그룹을 참조한다면 그룹에서 실제로 사용할 대상도 확인해야 합니다. Home에서 항목 하나를 선택해도 Config에 지정된 모든 정책이 그 항목을 사용하게 되는 것은 아닙니다.

Global Routing을 확인한 다음 화면 상단의 연결 스위치를 켭니다. 공식 스크린샷에는 연결 전 상태인 Not Connected가 표시되어 있어 메뉴 위치를 확인하는 데 도움이 됩니다. 스크린샷은 현재 작업 상태를 보여주는 실시간 화면이 아닙니다. 스위치를 누른 뒤 실제 기기에서 상태가 어떻게 바뀌는지 확인하세요.

시스템의 VPN 구성 안내 확인

처음 연결할 때 iPhone 또는 iPad에 VPN 구성 추가를 요청하는 시스템 안내가 표시될 수 있습니다. 앱이 시스템 수준 연결을 설정하기 위한 권한 절차이며, 서버 비밀번호를 입력하는 창이 아닙니다. Shadowrocket에서 시작한 작업인지 확인하고 안내를 읽은 뒤 시스템 요청에 따라 허용하세요. 기기 암호나 다른 기기 인증 절차도 완료해야 합니다. 기기 인증 화면에 서버 비밀번호를 입력하지 마세요.

권한 요청을 취소했다면 서버 항목이 있어도 앱이 완전한 연결을 설정할 수 없습니다. Home으로 돌아가 연결을 다시 시작하고 실제 시스템 안내에 따라 진행하세요. 권한을 허용한 직후 스위치가 다시 꺼진다면 표시된 안내를 기록하고 5단계에서 항목별로 확인하세요. 앱을 바로 삭제하거나 모든 구독을 다시 만들 필요는 없습니다.

테스트 조건을 일정하게 유지

연결을 테스트하는 동안에는 같은 네트워크를 유지하고 Wi-Fi, 셀룰러 네트워크, 서버와 모드를 동시에 바꾸지 마세요. 기기의 VPN 연결을 관리하는 다른 기능을 사용 중이라면 현재 어떤 연결 구성이 적용되는지 먼저 확인하세요. 구성 전환으로 발생한 중단을 서버 문제로 오해하지 않도록 합니다. 관리 대상 기기에서는 시스템 정책이 권한 설정에 영향을 줄 수 있으므로 기존 기기 관리 지침을 따르세요.

연결 상태가 바뀌어도 곧바로 On Demand를 켜거나 다른 설정을 수정하지 마세요. 수동 연결이 성공했다는 것은 이 단계가 완료된 것일 뿐, 원하는 요청을 처리할 수 있는지는 다음 단계에서 확인해야 합니다. 사용을 마친 뒤에는 Home으로 돌아가 스위치를 끌 수 있습니다. 조건에 따라 자동 연결하려면 On Demand를 별도로 확인하세요.

완료 기준: 시스템 권한 설정을 마쳤고 연결 상태가 유지되며, 선택한 서버와 모드가 예상대로 유지됩니다. 다음으로 테스트 결과와 실제 페이지를 함께 확인하세요.

첫 번째: 연결을 끄고 기본 네트워크 확인

먼저 Home에서 연결을 끄고 평소 이용하는 페이지를 열어보세요. 연결을 꺼도 페이지를 이용할 수 없다면 Wi-Fi, 셀룰러 네트워크 또는 현재 네트워크의 로그인 요구 사항부터 확인합니다. 기본 네트워크가 정상으로 돌아온 뒤 연결을 다시 켜세요. 이렇게 비교하면 모든 접속 실패를 구독 문제로 오해하지 않을 수 있습니다. 테스트 중에는 네트워크 조건을 일정하게 유지하세요.

두 번째: 가져온 내용과 업데이트 결과 확인

SERVER에 사용할 수 있는 항목이 없다면 구독 정보를 다시 확인해 링크가 온전한지, 불필요한 공백이 붙었는지, 업데이트 결과가 어떻게 표시됐는지 살펴보세요. 구독 링크에는 계정 인증 정보가 포함될 수 있으므로 전체 링크를 공개된 게시물에 올리지 마세요. 서비스 상태, 이용 기간과 계정 제한은 서비스 제공업체에 확인해야 합니다. 업데이트 버튼을 반복해서 누른다고 계정 측 문제가 자동으로 해결되지는 않습니다.

서버를 직접 추가했다면 Type부터 시작해 Host, Port, 인증 및 전송 매개변수를 차례로 확인하세요. 프로토콜 유형을 그대로 둔 채 비밀번호만 바꾸는 실수를 특히 주의해야 합니다. 원본 정보에 필수 항목이 빠져 있다면 다른 항목의 정보를 조합하지 말고 서비스 제공업체에 전체 정보를 요청하세요.

세 번째: 모드를 비교해 규칙 문제 분리

연결 스위치는 켜진 상태인데 실제 접속 결과가 예상과 다르다면 현재 Config와 모드를 먼저 기록한 뒤 잠시 Proxy로 전환해 같은 대상을 다시 테스트하세요. Proxy에서는 되지만 Config에서는 실패한다면 현재 Config, 매칭 규칙과 정책 그룹의 대상을 중점적으로 확인합니다. 두 모드에서 모두 실패한다면 서버와 네트워크를 계속 살펴보세요. Direct는 직접 연결 비교에만 사용하며 Proxy 경로가 작동한다는 증거가 아닙니다.

네 번째: Test Method와 On Demand 확인

Settings로 이동해 Test Method를 살펴보고 테스트 결과가 어떤 방법에 해당하는지 확인하세요. 수치를 표시하려고 Proxy, TCP, UDP 아래의 여러 옵션을 함부로 변경하지 마세요. 문제가 무엇인지, 매개변수의 의미가 무엇인지 파악한 뒤 조정해야 합니다. 한 가지를 변경한 다음 Home으로 돌아가 같은 대상을 테스트해 변화가 해당 작업으로 인한 것인지 확인하세요.

연결을 끈 뒤 다시 켜진다면 On Demand에 현재 네트워크 조건에 맞는 자동 연결 규칙이 설정되어 있는지 확인하세요. 문제를 찾는 동안에는 On Demand를 잠시 끄고 직접 연결을 테스트할 수 있는 조건을 만드세요. 테스트를 마친 뒤 필요한 조건을 복원하면 됩니다. On Demand는 연결을 시작할 시점을 관리할 뿐, 잘못된 서버 정보를 바로잡지는 않습니다.

다섯 번째: 진단 정보 보존 후 추가 확인

원인을 찾지 못했다면 Diagnostics에서 앱이 제공하는 진단 내용을 확인하고 문제가 발생한 당시의 네트워크, 모드, 선택한 항목과 오류 메시지를 기록하세요. 다른 사람과 공유하기 전에는 구독 URL, 비밀번호, UUID, 계정 정보와 개인을 식별할 수 있는 접속 기록을 가리세요. 전체 설정 스크린샷보다 문제와 관련된 부분만 공유하는 편이 원인을 파악하기 쉽습니다.

다음 테스트는 같은 서버, 같은 모드, 같은 대상을 사용해 시작하세요. 효과가 없었던 변경 사항은 되돌린 뒤 다음 항목을 확인해야 설정을 복구하기 어려워지는 일을 막을 수 있습니다. 일반적인 오류에 대한 추가 설명은 문제 해결 가이드를 참고하세요. 구독 업데이트, 여러 그룹 정리, 삭제와 백업은 서버 관리 가이드에서 확인할 수 있습니다. 기본 단계를 마친 다음 필요에 맞게 규칙과 자동 연결 조건을 세부 조정하세요.

완료 기준: 문제가 발생한 단계를 파악하고 같은 방법으로 다시 테스트할 수 있어야 합니다. 문제를 해결한 뒤 4단계로 돌아가 실제 접속 결과를 다시 확인하세요.