Shadowrocket 사용 설명:
구독 가져오기, 연결 및 확인
5단계로 처음 설정을 완료합니다. 먼저 기존 서버 하나가 연결되는지 확인한 뒤 규칙을 점검하세요. 문제가 생기면 가장 먼저 실패한 단계로 돌아가고, 여러 설정을 한꺼번에 변경하지 마세요.
스크린샷은 App Store에 게시된 공식 이미지로, 화면과 입력 항목을 식별하는 데 사용됩니다. 앱 화면의 배치는 변경될 수 있으므로 기기에 표시되는 영어 UI 용어를 기준으로 확인하세요.
01 서버 추가 및 구독 가져오기
Home에서 시작합니다. SERVER 그룹 근처의 Add Server를 찾거나 화면의 추가 메뉴를 사용합니다. 다음으로 가져오기 방법을 하나만 선택하세요. 전체 구독 링크가 있으면 Subscribe를 사용하고, 서버 하나의 프로토콜, 주소, 포트 및 인증 정보가 있으면 직접 입력합니다. 본인이 보유한 구성 QR 코드가 있으면 Scan QR Code를 사용합니다. 서로 다른 세 종류의 정보를 같은 항목에 섞어 입력하지 마세요.
Subscribe로 기존 구독 가져오기
- 먼저 이용 중인 서비스 제공자로부터 전체 구독 링크를 받습니다. 복사할 때 경로, 쿼리 매개변수 및 마지막 문자를 빠뜨리지 마세요. 도메인만 복사하거나 안내 문구까지 함께 선택하지 않도록 합니다.
- Add Server로 이동해 Type에서 Subscribe를 선택합니다. URL 항목에 링크를 붙여 넣고, 알아보기 쉬운 이름을 필요에 따라 입력한 뒤 저장합니다.
- Home으로 돌아와 구독을 읽어 올 때까지 기다립니다. 해당 구독 그룹이나 서버 항목이 표시되는지 확인한 뒤 그중 하나를 선택합니다. 이름은 표시되지만 선택할 서버가 없다면 바로 연결을 시도하기보다 먼저 구독을 읽어 온 결과를 확인하세요.
구독 링크에는 일반적으로 접근 인증 정보가 포함되므로 비밀번호처럼 다루어야 합니다. 전체 링크가 보이는 화면을 공개적으로 공유하거나, 댓글이나 문제 해결 기록에 붙여 넣지 마세요. 구독을 업데이트하면 원격 콘텐츠를 다시 읽어 옵니다. 업데이트에 실패하면 기존 항목을 유지하고 링크가 아직 유효한지, 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인한 뒤 다시 가져올지 결정하세요. 같은 주소를 반복해서 추가하면 목록만 중복될 수 있으며, 원격 응답 오류가 해결되지는 않습니다.
Add Server에서 매개변수 직접 입력하기
직접 추가할 때는 먼저 Type을 설정한 다음 해당 프로토콜에 필요한 항목을 입력합니다. 스크린샷은 Host / Port / Password / Method가 포함된 양식입니다. 다른 프로토콜에서는 표시되는 항목이 다를 수 있습니다. Host에는 서비스 정보에 안내된 서버 주소를, Port에는 해당 포트를 입력합니다. 경로가 포함된 구독 링크를 Host에 입력하지 마세요. Password, Method 및 기타 인증 매개변수는 서버 측 설정과 일치해야 합니다. 항목 이름만 보고 값을 추측하거나, 익숙해 보인다는 이유로 다른 값으로 바꾸지 마세요.
QR 코드가 있다면 Add Server에서 Scan QR Code를 사용하고 시스템 안내에 따라 카메라 접근을 허용합니다. 인식한 뒤에도 Type과 주소를 확인해야 합니다. Import from Cloud JSON은 해당 형식의 자료를 위한 기능이며, 일반 구독 URL을 대신 가져오는 메뉴가 아닙니다. 저장한 뒤 Home으로 돌아와 새 항목이 표시되고 선택 가능한지 확인하세요. 이 단계를 마친 다음 Global Routing을 선택합니다.
02 Global Routing 선택
항목을 추가한 뒤 Home으로 돌아와 Global Routing을 엽니다. 여기서 요청의 경로를 선택하며, “어떤 서버를 선택했는지”와는 별개의 설정입니다. 처음 사용할 때는 무엇을 확인할지 먼저 정한 다음 모드를 선택하세요. 세 가지 모드는 Config / Proxy / Direct입니다. 상단 연결 스위치만 보고 Proxy를 사용 중인지 판단하지 마세요.
| 모드 | 처리 방식 및 사용 시점 |
|---|---|
| Config | 현재 선택된 구성 파일의 규칙에 따라 요청을 처리합니다. PROXY와 DIRECT를 구분하는 일반적인 사용에 적합합니다. |
| Proxy | 선택된 Proxy를 통해 요청을 처리합니다. 서버가 기본적으로 작동하는지 먼저 확인할 때 적합합니다. 웹사이트별 규칙에 따른 요청 확인과는 다른 방식입니다. |
| Direct | 요청을 직접 처리해 기본 네트워크가 정상인지 비교할 수 있습니다. 서버의 Proxy 작동 여부를 확인하는 데 사용하지 마세요. |
Config 파일과 Config 모드의 관계
Home의 Config 모드는 “구성에 따라 처리”할지 선택하는 기능이고, 하단의 Config 화면은 구성 파일을 관리하는 곳입니다. Config로 이동해 사용할 파일이 선택되어 있는지 확인합니다. 파일을 열면 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 등의 섹션을 볼 수 있습니다. 처음 연결할 때는 파일 출처가 신뢰할 수 있는지, Rule의 정책 대상이 분명한지 확인하면 됩니다. 기본 연결을 위해 다른 기능을 섹션별로 모두 활성화할 필요는 없습니다.
규칙은 순서대로 적용되며 앞쪽 조건이 일치하면 실제 경로에 영향을 줍니다. FINAL은 앞선 조건이 모두 일치하지 않을 때 적용되는 기본 규칙입니다. 아래 예시는 규칙 순서를 이해하기 위한 것으로, 기존 파일을 그대로 대체할 수 있는 완성된 구성은 아닙니다. example.com과 그 하위 도메인은 PROXY를 사용하고 나머지 요청은 DIRECT로 처리합니다. 실제 파일을 수정하기 전에 복사본을 저장하고, 확인 없이 업무용 도메인에 예시를 일괄 적용하지 마세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
현재 규칙이 올바른지 확실하지 않다면 먼저 Proxy 모드로 선택한 서버를 확인할 수 있습니다. 서버가 작동하면 Config로 돌아와 분기를 확인하세요. Proxy에서는 접근되지만 Config에서 예상과 다른 결과가 나오면 선택한 파일, 규칙 순서 및 대상 정책부터 확인하고 서버 비밀번호를 바로 다시 입력하지 마세요. 규칙에 관한 자세한 내용은 특정 웹사이트의 DOMAIN-SUFFIX 및 FINAL 설정을 참고하세요. App Store 구매 및 계정 관련 내용은 App Store 안내를 확인하세요.
03 항목 선택 및 연결 켜기
Home으로 돌아와 SERVER 목록에서 사용할 서버를 선택하고 선택 표시가 올바른 항목에 있는지 확인합니다. 구독 그룹 이름은 관리에 참고할 정보일 뿐, 실제 항목을 선택하는 것을 대신하지 않습니다. 그런 다음 Global Routing을 다시 확인하세요. 앞서 Direct로 전환해 비교했다면 이제 이번 확인에 사용할 Proxy 또는 Config로 돌아가야 합니다. 그렇지 않으면 연결 스위치를 켜도 예상한 Proxy 경로를 확인할 수 없습니다.
- Home 상단의 연결 스위치를 누릅니다. 아직 연결되지 않은 경우 화면에 Not Connected가 표시될 수 있습니다. 스위치를 켠 뒤 상태가 바뀌는지 확인합니다.
- 처음 사용할 때 시스템에서 VPN 구성을 추가하라는 요청이 표시될 수 있습니다. 안내를 읽고 직접 Shadowrocket에서 시작한 작업인지 확인한 다음 추가를 허용하고, 안내에 따라 기기 인증을 완료합니다.
- Shadowrocket으로 돌아와 상단 스위치가 켜진 상태로 유지되고 연결 해제 상태로 바로 돌아가지 않는지 확인한 뒤 다음 단계에서 실제로 테스트합니다. 스위치가 자동으로 꺼지면 건너뛰지 말고 시스템 권한 또는 구성 문제부터 해결하세요.
시스템 VPN 권한은 클라이언트가 필요한 네트워크 처리 통로를 설정하는 데 사용되며, 구독이나 서버 정보를 대신 채워 주지는 않습니다. 연결 상태가 바뀌었다는 사실만으로 통로의 상태가 변경되었음을 알 수 있을 뿐, 원격 서버, DNS 및 대상 웹사이트가 모두 정상이라는 뜻은 아닙니다. 시스템 상태 표시줄의 VPN 아이콘만으로 작동 여부를 판단하지 말고 테스트를 실행한 뒤 실제 페이지도 열어 보세요.
기기에서 다른 VPN 구성이 이미 작동 중이라면 시스템 네트워크 통로가 동시에 사용되지 않도록 먼저 다른 연결을 중지하세요. 관리되는 기기에서는 VPN 구성 추가가 제한될 수 있습니다. 이런 제한이 있으면 기기 관리 정책을 확인하고 모든 네트워크 설정을 반복해서 삭제하지 마세요. 처음 연결하기 전에 On Demand를 활성화할 필요도 없습니다. 수동 스위치를 사용하면 각 작업과 상태 변경의 관계를 더 쉽게 확인할 수 있습니다.
04 연결 및 분기 작동 확인
연결한 뒤 Home에서 먼저 Connectivity Test를 실행하고 현재 테스트 방법의 결과를 확인합니다. 그런 다음 브라우저를 열어 실제로 사용할 웹사이트에 접속합니다. 테스트 성공은 현재 방법으로 테스트한 경로가 응답했다는 뜻이지, 모든 프로토콜과 웹사이트가 작동한다는 뜻은 아닙니다. 테스트 실패가 인증 매개변수 오류를 의미하는 것도 아닙니다. 테스트 대상에 일시적으로 접근할 수 없거나 테스트 방법이 다르거나 기본 네트워크에 문제가 있어도 결과에 영향을 줄 수 있습니다.
“서버 작동 여부”와 “규칙 정확성”을 나누어 확인하기
- 먼저 기본 네트워크를 확인합니다: 연결을 잠시 중지하고 기기 자체에서 일상적으로 사용하는 웹사이트에 정상적으로 접근할 수 있는지 확인합니다. 기본 네트워크가 연결되지 않으면 Wi-Fi, 셀룰러 네트워크 또는 네트워크 로그인 페이지부터 점검하세요.
- 그다음 서버를 확인합니다: 매개변수를 확인한 항목을 사용해 Proxy 모드로 연결한 뒤 해당 서버를 통해 접근할 수 있어야 하는 대상을 방문합니다. 실패하면 규칙을 바로 수정하지 말고 구체적인 증상을 기록하세요.
- 마지막으로 분기를 확인합니다: Config로 돌아가 PROXY를 사용해야 하는 대상과 DIRECT를 사용해야 하는 대상을 각각 방문합니다. 현재 화면에서 요청 또는 연결 기록을 제공한다면 대상 도메인, 일치한 규칙 및 정책을 함께 확인하세요.
하나의 웹페이지는 여러 도메인의 리소스를 불러올 수 있습니다. 메인 페이지는 열리지만 이미지나 로그인이 실패한다면 리소스마다 다른 규칙이 적용되었을 수 있습니다. 주 도메인에 규칙 하나를 추가한 뒤 문제 해결이 끝났다고 판단하지 마세요. 브라우저 캐시와 이미 연결된 세션이 이전 결과를 유지할 수도 있습니다. 규칙을 바꾼 뒤에는 새 요청을 보내고, 필요하면 기존 페이지를 닫았다가 다시 열어 캐시된 페이지를 새 연결의 근거로 오인하지 않도록 합니다.
네트워크 사용량을 확인하려면 Data에서 이용 가능한 통계를 볼 수 있습니다. 하지만 트래픽이 증가했다는 사실만으로 대상 요청이 PROXY 규칙과 일치했다고 볼 수는 없습니다. 작동 여부를 확인할 때는 “현재 서버, Global Routing 모드, 테스트 대상, 실제 결과” 네 가지를 함께 기록하세요. 이 네 가지를 비교한 다음 자동 연결이나 세부 분기 규칙을 검토하면 됩니다. 처음 설정은 여기까지 확인하면 충분합니다.
05 Settings 및 일반적인 실패 원인
문제 해결은 가장 먼저 문제가 발생한 단계부터 시작합니다. 가져오기에 실패하면 구독을 확인하고, 항목은 저장됐지만 테스트에 실패하면 서버를 확인합니다. 스위치가 켜진 상태로 유지되지 않으면 시스템 권한을 확인하고, Proxy는 작동하지만 Config에서 문제가 생기면 규칙을 확인합니다. Settings에서 Test Method / On Demand / Diagnostics / Proxy / TCP / UDP 등의 항목을 확인할 수 있지만, “효과가 있을지도 모른다”는 이유만으로 모든 설정을 차례로 바꾸지 마세요.
구독을 읽을 수 없거나 목록이 비어 있음
Subscribe의 URL이 완전한지, 특히 물음표 뒤의 매개변수와 복사 과정에서 섞인 공백 및 줄바꿈을 다시 확인합니다. 입력한 주소가 웹 관리 콘솔 주소가 아니라 구독 주소인지 확인하세요. 구독에서 빈 콘텐츠가 반환되거나 인증에 실패하거나 형식이 맞지 않는 경우, 반복해서 저장해도 대개 결과는 달라지지 않습니다. 이용 중인 서비스 제공자에게 주소의 유효성, 접근 조건 및 콘텐츠 형식을 확인하세요. 문제를 해결할 때는 오류 문구를 보관하고, 스크린샷을 공유하기 전에 URL, 계정 및 인증 항목을 가리세요.
항목은 있지만 Connectivity Test에 실패함
먼저 Home에서 실제로 선택된 항목을 확인한 뒤 Type, Host, Port 및 해당 프로토콜에 필요한 인증 항목을 비교합니다. Settings에서 Test Method를 확인하고 현재 사용 중인 테스트 방식을 파악하세요. 방식에 따라 테스트 대상과 기능이 다르므로 특정 테스트 하나의 실패를 모든 요청의 실패와 동일하게 보면 안 됩니다. 이미 작동이 확인된 다른 항목이 있다면 나머지 설정을 그대로 둔 채 비교할 수 있습니다. 비교할 항목이 없다면 임의로 다른 포트나 암호화 방식을 시도하지 말고 원래 매개변수를 확인하세요.
스위치가 꺼지거나 끈 뒤 자동으로 다시 연결됨
스위치가 켜진 상태로 유지되지 않으면 시스템 VPN 구성 요청이 완료되었는지, 다른 VPN 연결이 활성화되어 있는지, 기기 관리 정책의 제한이 있는지 확인하세요. 스위치를 끈 뒤 자동으로 다시 연결되면 Settings의 On Demand가 예상한 설정인지 확인합니다. 먼저 자동 연결 조건을 잠시 비활성화한 뒤 수동 연결과 해제를 다시 테스트하고, 필요한 경우 On Demand를 설정하는 것이 좋습니다. On Demand는 유효하지 않은 서버 정보를 수정하지 않습니다.
연결되지만 특정 웹사이트 또는 일부 기능이 작동하지 않음
Proxy와 Config에서 결과를 먼저 비교합니다. Config에서만 문제가 생기면 현재 선택된 파일, Rule 순서 및 FINAL을 확인합니다. 두 모드 모두 실패하면 대상 사이트, DNS, 서버 기능 또는 프로토콜 매개변수 중 무엇이 원인인지 구분합니다. Settings에 TCP와 UDP가 표시된다고 해서 둘 다 반드시 변경해야 하는 것은 아닙니다. 영향을 받는 기능이 해당 전송 방식을 사용한다고 확인된 경우에만 서버 측 지원 여부와 관련 설정이 일치하는지 점검하세요.
다시 확인할 수 있는 진단 기록 보관
추가 확인이 필요하면 Diagnostics에서 적절한 진단 기능을 사용하고, 실패한 단계, 네트워크 유형, 현재 모드 및 재현 가능한 작업을 기록합니다. 설정을 하나 변경할 때마다 4단계를 다시 실행하세요. 효과가 없는 변경은 되돌려 어떤 설정을 신뢰할 수 있는지 알 수 없는 상황을 피합니다. 기록을 보내기 전 서버 주소, 비밀번호, 구독 매개변수 및 개인적인 접근 내용을 확인하고 필요한 민감 정보는 가리세요. 구성 파일 섹션 설명은 .conf 구조 자세히 알아보기를 참고하세요. 문제를 해결하기 위해 구성 전체를 바로 덮어쓰지 마세요.