공식 매뉴얼 · 첫 연결

Shadowrocket 사용법:
가져오기, 연결 및 확인

iPhone / iPad 화면을 기준으로 기존 구독이나 서버 정보를 클라이언트에 추가하고, 다섯 단계에 따라 연결과 규칙이 예상대로 작동하는지 확인합니다. 처음 설정할 때는 연결 하나를 먼저 완료하고, 다른 설정은 확인이 끝난 뒤 조정하세요.

작업 전에 정보 유형을 구분하세요. 구독 링크는 서버 정보 목록을 가져오는 데 사용하고, 개별 서버 링크·QR 코드·매개변수 표는 특정 서버를 추가하는 데 사용합니다. 규칙 설정은 트래픽 처리 방식을 결정합니다. 모두 링크 형태라고 해서 같은 입력란에 넣을 수 있는 것은 아닙니다.

단계 01 · 먼저 Home에 서버 표시하기

서버 추가 / 구독 가져오기

Shadowrocket을 열고 Home으로 이동합니다. 처음 사용할 때는 연결 스위치를 켜지 말고 오른쪽 상단의 더하기 버튼을 눌러 Add Server로 이동합니다. 보유한 정보에 따라 추가 방법 하나를 선택하면 됩니다. 안내를 마치기 위해 같은 정보를 여러 번 가져올 필요는 없습니다. 구독, 개별 서버, 설정 파일은 각각 역할이 다르므로 저장을 반복해서 시도하기보다 올바른 메뉴를 선택하는 것이 중요합니다.

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

  1. Add Server에서 Type을 열고 Subscribe를 선택한 다음 입력 화면으로 돌아옵니다.
  2. URL에 본인의 서비스 제공업체에서 받은 전체 구독 링크를 붙여 넣습니다. Remarks에는 알아보기 쉬운 이름을 입력할 수 있습니다. 비밀번호나 링크의 비공개 정보를 이름에 적지 마세요.
  3. 링크 앞뒤에 공백, 줄 바꿈 또는 채팅 내용이 추가되지 않았는지 확인한 다음 오른쪽 상단의 저장을 누릅니다. Home으로 돌아와 구독 항목이 로드될 때까지 기다립니다. 내용이 표시되지 않으면 해당 구독을 업데이트합니다.
  4. 구독 그룹을 펼쳐 서버 항목이 표시되는지 확인한 다음, 이번 연결에 사용할 항목 하나를 선택합니다.

구독 링크에는 개인 액세스 정보가 포함되는 경우가 많으므로 민감한 정보로 취급해야 합니다. 복사할 때는 화면에서 짧게 표시된 문구가 아니라 전체 링크를 복사하고, 알 수 없는 링크 분석 페이지에 제출하지 마세요. 가져온 뒤 그룹 이름만 보이고 서버가 없다면 사용할 수 있는 항목을 아직 가져오지 못한 것입니다. 이때 연결 스위치를 켜도 누락된 정보는 채워지지 않으므로 구독 내용과 업데이트 결과를 먼저 확인하세요.

개별 서버 정보가 있는 경우: 프로토콜에 맞춰 Add Server 입력

서버 주소, 포트, 인증 매개변수가 있다면 Type에서 정보에 표시된 프로토콜(예: Shadowsocks, VMess, VLESS 또는 Trojan)을 선택한 뒤 항목별로 입력합니다. 주소란에는 호스트 이름이나 IP 주소를, 포트란에는 포트를 입력합니다. 공유 링크 전체를 주소로 입력하지 마세요. 인증 정보, 전송 방식, TLS 관련 옵션은 원본 정보와 일치해야 합니다. 프로토콜 이름이 같다는 이유만으로 다른 서버의 설정을 그대로 사용하면 안 됩니다.

정보에 전송 경로, 호스트 이름 또는 서버 이름도 포함되어 있다면 각각 해당하는 입력란에 입력합니다. 옵션을 켜야 하는지는 서버의 실제 설정에 따라 달라집니다. 안내에 해당 용어가 나오는지 여부와는 관계없습니다. 저장한 뒤 Home으로 돌아와 방금 추가한 항목을 선택합니다. 매개변수를 수정하려면 해당 항목의 편집 메뉴에서 확인하세요. 이름이 비슷한 항목을 계속 새로 만들면 대상을 잘못 선택할 수 있습니다.

QR 코드가 있다면 Scan QR Code로 스캔한 뒤 인식된 프로토콜과 매개변수를 확인하고 저장할 수 있습니다. 어떤 방법을 사용하든 이 단계의 완료 기준은 같습니다. Home에 서버 항목이 있고 이번에 사용할 항목이 선택되어 있어야 합니다. 프로토콜 필드가 확실하지 않다면 용어 빠른 안내를 확인하고, 옵션을 무작위로 바꾸며 시험하지 마세요.

단계 02 · 트래픽 처리 방식 결정

Global Routing 방식 선택

서버를 추가한 뒤에는 어떤 연결에서 서버를 사용할지 결정해야 합니다. Home에서 Global Routing을 열면 설정(Config), 프록시(Proxy), 직접 연결(Direct) 세 가지 방식을 볼 수 있습니다. 여기서 선택하는 것은 트래픽 처리 방식이며, 서버를 다시 선택하는 것이 아닙니다. 앞 단계에서 잘못 입력한 주소나 인증 정보도 자동으로 수정되지 않습니다.

방식기능 및 사용 상황
설정(Config)현재 설정의 규칙에 따라 트래픽을 분배합니다. 연결은 프록시, 직접 연결 또는 다른 설정 정책을 사용할 수 있습니다. 규칙에 따라 트래픽을 처리해야 하는 일상적인 사용에 적합합니다.
프록시(Proxy)프록시를 사용할 수 있는 트래픽을 선택한 프록시 정책으로 전달합니다. 짧은 비교 테스트에 적합하지만, Config의 모든 규칙이 올바르다고 판단하는 근거로 삼을 수는 없습니다.
직접 연결(Direct)선택한 프록시 서버를 거치지 않고 직접 연결합니다. 원래 네트워크의 접속 상태를 확인할 때 적합하지만, 프록시 서버가 작동하는지 확인하는 방식으로는 적절하지 않습니다.

평소 규칙에 따라 사용하려면 설정(Config)을 선택한 다음 하단의 Config 화면으로 이동해 사용할 설정이 활성화되어 있는지 확인합니다. Config 화면과 Global Routing의 같은 이름 옵션은 서로 연관되어 있지만 동일한 메뉴는 아닙니다. 전자는 설정 파일을 관리하고, 후자는 현재 설정에 따라 실행할지 결정합니다.

“구독 가져오기에 성공했다”는 것을 “규칙 설정도 완료됐다”는 뜻으로 이해하지 마세요. 구독은 주로 서버 정보를 업데이트하며, 설정 파일은 규칙, 정책 및 관련 설정을 정의합니다. 현재 설정의 규칙은 일반적으로 순서대로 적용됩니다. 특정 도메인이 직접 연결 규칙에 먼저 해당하면 서버가 선택되어 있어도 해당 연결은 프록시를 통하지 않을 수 있습니다. 따라서 이후 확인 단계에서는 모든 페이지가 똑같이 동작하는지보다 규칙 적중 결과를 함께 살펴봐야 합니다.

이번에는 기존의 신뢰할 수 있고 용도를 이해하는 설정을 유지하고, 첫 연결 과정에서 DNS, 복잡한 정책 그룹, 여러 규칙을 한꺼번에 변경하지 마세요. DOMAIN-SUFFIX, GEOIP, FINAL 등의 키워드를 자세히 알아보려면 프록시 모드 안내를 참고하세요. 이 페이지에서는 먼저 “서버가 선택되어 있고 Global Routing을 확인한 상태”를 만든 뒤 연결 단계로 진행합니다.

단계 03 · 승인하고 연결 설정

Home에서 연결 스위치 켜기

Home으로 돌아와 서버 목록에서 선택 항목이 바뀌지 않았는지 확인하고, Global Routing이 앞서 설정한 방식인지 확인합니다. 그런 다음 상단의 연결 스위치를 켭니다. 처음 활성화할 때 iPhone / iPad에 VPN 구성을 추가하라는 시스템 안내가 표시됩니다. 안내를 읽고 허용을 선택한 뒤 시스템 요구에 따라 기기 암호 또는 생체 인증을 완료합니다. 이 단계는 기기 승인을 요구하는 것이며 서버 비밀번호를 요구하는 것이 아닙니다.

  1. Shadowrocket을 앞에 둔 상태에서 연결 스위치를 켜고 시스템 안내가 나타날 때까지 기다립니다.
  2. 시스템 승인을 마친 뒤 앱으로 돌아와 스위치가 계속 켜져 있는지, 앱에 연결 상태가 표시되는지 확인합니다.
  3. 이전에 승인을 취소했다면 다시 연결을 시도하고 안내에 따라 완료합니다. 기기 관리 정책으로 VPN 구성 추가가 제한되어 있다면 먼저 기기 관리 규칙을 확인합니다.
  4. 연결되면 현재 서버와 방식을 그대로 유지한 채 다음 단계에서 테스트합니다. 추가 자동 연결 설정은 아직 활성화하지 않습니다.

시스템에 VPN 상태가 표시되면 기기에서 해당 네트워크 구성이 활성화되었다는 뜻입니다. 원격 서버에 접속할 수 있거나 모든 트래픽이 프록시를 통한다는 의미는 아닙니다. 스위치가 켜져 있어도 서버 인증 실패, 원격 서버 접속 불가 또는 규칙에 따른 직접 연결이 발생할 수 있습니다. 따라서 이 단계에서는 승인과 로컬 연결 상태만 확인하고, 실제 사용 가능 여부는 다음 단계의 테스트와 실제 접속으로 함께 판단해야 합니다.

스위치를 켠 직후 꺼진다면 앱에 표시된 안내를 기록한 다음 시스템 승인, 현재 설정의 사용 가능 여부, 다른 VPN 연결이 네트워크를 제어하고 있는지 확인합니다. 스위치를 빠르게 연속해서 켜고 끄지 마세요. 전환 후 상태가 바뀔 때까지 기다립니다. 관리되는 기기에서는 용도를 알 수 없는 관리 설정을 임의로 삭제하지 말고 기기 사용 정책을 먼저 확인하세요.

On Demand는 조건에 따라 연결을 시작하는 기능으로, 첫 연결에 꼭 필요한 단계는 아닙니다. 먼저 수동으로 정상 작동하는지 확인한 다음 필요할 때만 조건부 연결을 설정하세요. 첫 확인 단계에서 자동 재연결 조건을 추가하면 점검 도중 연결이 자동으로 복구될 수 있어 수동 조작과 자동 실행 중 무엇이 변화를 일으켰는지 구분하기 어려워집니다.

단계 04 · 응답과 실제 트래픽을 따로 확인

Connectivity Test 및 작동 확인

Home으로 돌아와 Connectivity Test로 목록의 서버를 테스트합니다. 현재 선택한 서버가 결과를 반환하는지, 시간 초과 또는 실패가 표시되는지 확인합니다. 테스트는 현재 네트워크 환경의 응답 상태를 확인하는 데 도움이 되지만, 특정 테스트 방식에서 응답이 있다고 해서 인증, 규칙, DNS 및 모든 대상 웹사이트가 정상이라는 뜻은 아닙니다. 한 번의 시간 초과만으로 매개변수가 잘못됐다고 단정할 수도 없습니다.

그다음 브라우저로 전환해 확인할 페이지를 열고 완전히 로드될 때까지 기다린 뒤 새로고침을 시도합니다. 이전에 열어 둔 페이지만 확인하지 마세요. 페이지가 캐시에서 표시되거나 기존 연결이 전환 전의 처리 방식을 계속 사용할 수 있습니다. 방해 요인을 줄이려면 명확한 대상 몇 개만 테스트하세요. Wi-Fi, 서버, 방식, 브라우저 설정을 동시에 바꾸면 결과 차이의 원인을 찾기 어렵습니다.

설정(Config)의 트래픽 분배를 확인하려면 Data에서 해당 연결 기록을 열고 대상 도메인, 적용된 규칙, 최종 정책을 확인합니다. 필요한 정보가 기록에 아직 표시되지 않는다면 테스트 전에 관련 기록 기능이 활성화되어 있는지 확인하고 요청을 다시 보냅니다. 페이지가 열려도 기록에 직접 연결로 표시된다면 이번 직접 접속이 성공했다는 것만 확인할 수 있으며, 선택한 프록시 서버가 트래픽을 전달했다는 증거는 아닙니다.

비교가 필요하다면 설정(Config)의 결과를 먼저 기록하고 잠시 프록시(Proxy)로 전환한 뒤 같은 대상에 새 요청을 보내 결과를 비교합니다. 확인이 끝나면 원래 사용하려던 방식으로 되돌립니다. 프록시(Proxy)는 작동하지만 설정(Config)에 문제가 있다면 서버를 즉시 삭제하고 다시 추가하기보다 규칙 적중과 설정의 정책 지정을 먼저 점검합니다. 두 방식 모두 실패하면 네트워크와 서버 매개변수를 먼저 확인합니다.

확인이 끝나면 사용한 서버, 네트워크, Global Routing 방식, 성공하거나 실패한 대상을 간단히 기록해 두세요. 이후 문제가 생기면 모든 설정을 처음부터 바꾸기보다 이 정상 상태와 비교하는 편이 달라진 지점을 찾기 쉽습니다.

단계 05 · 가장 먼저 실패한 단계부터 확인

일반적인 문제와 점검 순서

문제가 발생하면 가져오기, 테스트, 승인, 실제 접속 중 어느 단계에서 실패했는지 먼저 확인합니다. 이전 단계가 완료되지 않았다면 그 문제부터 해결하세요. 예를 들어 목록이 비어 있다면 Global Routing을 계속 변경할 필요가 없습니다. 한 번에 조건 하나만 변경하고 같은 테스트를 다시 실행해 결과를 기록한 뒤 변경 사항을 유지할지 결정합니다.

구독을 가져오지 못하거나 업데이트 후 목록이 비어 있는 경우

먼저 복사한 내용이 전체 구독 링크인지, 쿼리 매개변수가 빠지거나 채팅 앱에서 잘리거나 불필요한 문장 부호가 붙지 않았는지 확인합니다. 그런 다음 현재 네트워크에서 구독 내용을 가져올 수 있는지, 본인의 서비스가 여전히 유효한지 확인합니다. 브라우저에서 열리는 계정 관리 페이지가 가져올 수 있는 구독 링크인 것은 아닙니다. 로그인 페이지나 오류 안내가 반환되면 클라이언트는 이를 서버 목록으로 사용할 수 없습니다. 정보의 용도가 불분명하다면 본인의 서비스 제공업체에 링크의 용도를 문의하세요.

업데이트에 실패해도 기존 구독을 바로 삭제하지 마세요. 먼저 기존 항목이 남아 있는지 확인하고 오류를 설명하는 안내 문구를 보관합니다. 같은 구독을 반복해서 새로 만들면 그룹이 중복될 수 있으며, 원본 링크가 잘못된 내용을 반환하는 문제는 해결되지 않습니다. 구독이 정상화된 뒤 다시 업데이트해 새 서버 항목이 제대로 로드되는지 확인하세요.

서버는 표시되지만 Connectivity Test가 시간 초과되는 경우

먼저 프록시 연결을 끈 상태에서 로컬 네트워크가 정상적으로 작동하는지 확인한 뒤 서버 주소, 포트, 프로토콜을 확인합니다. 직접 추가한 항목은 인증 정보가 완전한지, TLS, 전송 방식 및 관련 이름이 원본 정보와 일치하는지 특히 확인해야 합니다. 구독에 사용할 수 있는 다른 항목이 있다면 네트워크와 테스트 방식을 그대로 유지한 채 다른 항목을 테스트해 개별 서버 문제인지 현재 네트워크 전체의 문제인지 구분할 수 있습니다.

테스트 시간 초과는 원격 서버 상태, 네트워크 경로 또는 테스트 대상과 관련이 있을 수 있으므로 한 번의 결과만으로 결론을 내리지 마세요. 잠시 뒤 다시 시도하거나 허용되는 상황에서 로컬 네트워크를 바꿔 비교할 수 있지만, 필요한 보안 확인을 끄는 것을 일반적인 해결 방법으로 삼아서는 안 됩니다.

연결은 켜져 있지만 페이지에 정상적으로 접속할 수 없는 경우

먼저 실수로 직접 연결(Direct)을 선택했는지 확인한 다음 Config에서 활성화된 설정이 예상과 일치하는지 점검합니다. 일부 대상에만 문제가 있다면 해당 대상에 어떤 규칙이 적용되고 어떤 정책으로 분류됐는지 확인합니다. 도메인 접속은 실패하지만 다른 연결은 정상이면 현재 설정의 DNS를 확인하세요. 원래 정상 작동하던 조건을 잃지 않도록 모든 DNS 주소를 처음부터 한꺼번에 바꾸지 마세요.

같은 대상이 프록시(Proxy)에서는 작동하지만 설정(Config)에서 실패한다면 규칙과 정책을 먼저 확인합니다. 모든 대상에 문제가 있다면 서버 상태와 연결 승인을 다시 확인하세요. 특정 브라우저나 앱에서만 문제가 생기는 경우에는 프록시 연결 탓으로 돌리기 전에 해당 앱의 로그인, 캐시, 권한 문제인지도 확인해야 합니다.

문제를 해결한 뒤 다시 확인

매개변수를 변경하고 저장한 뒤 필요한 경우 연결을 끊었다가 다시 연결해 새 요청이 현재 설정을 사용하도록 합니다. 그런 다음 Connectivity Test를 실행하고 이전에 실패한 대상에 다시 접속한 뒤 기록의 정책을 확인합니다. 오류 메시지가 일시적으로 사라졌다는 이유만으로 점검을 끝내지 마세요. 원래 실패했던 상황도 복구되어야 변경이 효과적이었다고 볼 수 있습니다.

여전히 원인을 찾기 어렵다면 기기 시스템, 사용 중인 네트워크, 실패한 단계와 민감한 정보가 제거된 안내 문구를 정리한 뒤 자주 묻는 질문을 확인하세요. 화면 용어와 규칙의 의미는 용어 빠른 안내에서 확인할 수 있습니다. iPhone / iPad의 스토어 지역, 구매 및 구입 항목 복원 문제는 App Store 안내를 참고하세요. 이러한 문제는 서버 매개변수와 다른 단계에 해당하므로 구분해 해결해야 합니다.